Refactor TON network to use testcontainers-go (#1833)

feat: TON network support

Author: skudasov

.github/workflows/framework-golden-tests.yml

@@ -43,6 +43,10 @@ jobs:
             config: smoke_solana.toml
             count: 1
             timeout: 10m
+          - name: TestTonSmoke
+            config: smoke_ton.toml
+            count: 1
+            timeout: 10m
           - name: TestUpgrade
             config: upgrade.toml
             count: 1

book/src/SUMMARY.md

@@ -46,6 +46,7 @@
       - [Sui](framework/components/blockchains/sui.md)
       - [TRON](framework/components/blockchains/tron.md)
       - [ZKSync](framework/components/blockchains/zksync.md)
+      - [Ton](framework/components/blockchains/ton.md)
       - [Optimism Stack]()
       - [Arbitrum Stack]()
     - [Chainlink](framework/components/chainlink.md)

book/src/framework/components/blockchains/ton.md

@@ -0,0 +1,122 @@
+# TON Blockchain Client
+
+TON (The Open Network) support in the framework utilizes MyLocalTon Docker Compose environment to provide a local TON blockchain for testing purposes.
+
+## Configuration
+
+```toml
+[blockchain_a]
+    type = "ton"
+    image = "ghcr.io/neodix42/mylocalton-docker:latest"
+```
+
+## Default Ports
+
+The TON implementation exposes several services:
+
+- TON Lite Server: Port 40004
+- TON HTTP API: Port 8081
+- TON Simple HTTP Server: Port 8000
+- TON Explorer: Port 8080
+
+> **Note**: By default, only the lite client service is exposed externally. Other services may need additional configuration to be accessible outside the Docker network.
+
+## Validator Configuration
+
+By default, the MyLocalTon environment starts with only one validator enabled. If multiple validators are needed (up to 6 are supported), the Docker Compose file must be provided with modified version with corresponding service definition in toml file before starting the environment.
+
+## Usage
+
+```go
+package examples
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"github.com/xssnick/tonutils-go/liteclient"
+	"github.com/xssnick/tonutils-go/ton"
+	"github.com/xssnick/tonutils-go/ton/wallet"
+
+	"github.com/smartcontractkit/chainlink-testing-framework/framework"
+	"github.com/smartcontractkit/chainlink-testing-framework/framework/components/blockchain"
+)
+
+type CfgTon struct {
+	BlockchainA *blockchain.Input `toml:"blockchain_a" validate:"required"`
+}
+
+func TestTonSmoke(t *testing.T) {
+	in, err := framework.Load[CfgTon](t)
+	require.NoError(t, err)
+
+	bc, err := blockchain.NewBlockchainNetwork(in.BlockchainA)
+	require.NoError(t, err)
+
+	var client ton.APIClientWrapped
+
+	t.Run("setup:connect", func(t *testing.T) {
+		// Create a connection pool
+		connectionPool := liteclient.NewConnectionPool()
+		
+		// Get the network configuration from the global config URL
+		cfg, cferr := liteclient.GetConfigFromUrl(t.Context(), fmt.Sprintf("http://%s/localhost.global.config.json", bc.Nodes[0].ExternalHTTPUrl))
+		require.NoError(t, cferr, "Failed to get config from URL")
+		
+		// Add connections from the config
+		caerr := connectionPool.AddConnectionsFromConfig(t.Context(), cfg)
+		require.NoError(t, caerr, "Failed to add connections from config")
+		
+		// Create an API client with retry functionality
+		client = ton.NewAPIClient(connectionPool).WithRetry()
+
+		t.Run("setup:faucet", func(t *testing.T) {
+			// Create a wallet from the pre-funded high-load wallet seed
+			rawHlWallet, err := wallet.FromSeed(client, strings.Fields(blockchain.DefaultTonHlWalletMnemonic), wallet.HighloadV2Verified)
+			require.NoError(t, err, "failed to create highload wallet")
+			
+			// Create a workchain -1 (masterchain) wallet
+			mcFunderWallet, err := wallet.FromPrivateKeyWithOptions(client, rawHlWallet.PrivateKey(), wallet.HighloadV2Verified, wallet.WithWorkchain(-1))
+			require.NoError(t, err, "failed to create highload wallet")
+			
+			// Get subwallet with ID 42
+			funder, err := mcFunderWallet.GetSubwallet(uint32(42))
+			require.NoError(t, err, "failed to get highload subwallet")
+
+			// Verify the funder address matches the expected default
+			require.Equal(t, funder.Address().StringRaw(), blockchain.DefaultTonHlWalletAddress, "funder address mismatch")
+
+			// Check the funder balance
+			master, err := client.GetMasterchainInfo(t.Context())
+			require.NoError(t, err, "failed to get masterchain info for funder balance check")
+			funderBalance, err := funder.GetBalance(t.Context(), master)
+			require.NoError(t, err, "failed to get funder balance")
+			require.Equal(t, funderBalance.Nano().String(), "1000000000000000", "funder balance mismatch")
+		})
+	})
+}
+```
+
+## Test Private Keys
+
+The framework includes a pre-funded high-load wallet for testing purposes. This wallet type can send up to 254 messages per 1 external message, making it efficient for test scenarios.
+
+Default High-Load Wallet:
+```
+Address: -1:5ee77ced0b7ae6ef88ab3f4350d8872c64667ffbe76073455215d3cdfab3294b
+Mnemonic: twenty unfair stay entry during please water april fabric morning length lumber style tomorrow melody similar forum width ride render void rather custom coin
+```
+
+## Available Pre-funded Wallets
+
+MyLocalTon Docker environment comes with several pre-funded wallets that can be used for testing:
+
+1. Genesis Wallet (V3R2, WalletId: 42)
+2. Validator Wallets (1-5) (V3R2, WalletId: 42)
+3. Faucet Wallet (V3R2, WalletId: 42, Balance: 1 million TON)
+4. Faucet Highload Wallet (Highload V2, QueryId: 0, Balance: 1 million TON)
+5. Basechain Faucet Wallet (V3R2, WalletId: 42, Balance: 1 million TON)
+6. Basechain Faucet Highload Wallet (Highload V2, QueryId: 0, Balance: 1 million TON)
+
+For the complete list of addresses and mnemonics, refer to the [MyLocalTon Docker documentation](https://github.com/neodix42/mylocalton-docker).

framework/.changeset/v0.8.2.md

@@ -0,0 +1 @@
+- TON Network support with testcontainers

framework/components/blockchain/blockchain.go

@@ -18,6 +18,7 @@ const (
 	TypeAptos       = "aptos"
 	TypeSui         = "sui"
 	TypeTron        = "tron"
+	TypeTon         = "ton"
 )
 
 // Blockchain node family
@@ -27,12 +28,13 @@ const (
 	FamilyAptos  = "aptos"
 	FamilySui    = "sui"
 	FamilyTron   = "tron"
+	FamilyTon    = "ton"
 )
 
 // Input is a blockchain network configuration params
 type Input struct {
 	// Common EVM fields
-	Type      string `toml:"type" validate:"required,oneof=anvil geth besu solana aptos tron sui" envconfig:"net_type"`
+	Type      string `toml:"type" validate:"required,oneof=anvil geth besu solana aptos tron sui ton" envconfig:"net_type"`
 	Image     string `toml:"image"`
 	PullImage bool   `toml:"pull_image"`
 	Port      string `toml:"port"`
@@ -99,6 +101,8 @@ func NewBlockchainNetwork(in *Input) (*Output, error) {
 		out, err = newTron(in)
 	case TypeAnvilZKSync:
 		out, err = newAnvilZksync(in)
+	case TypeTon:
+		out, err = newTon(in)
 	default:
 		return nil, fmt.Errorf("blockchain type is not supported or empty, must be 'anvil' or 'geth'")
 	}