Sending transaction in TON blockchain(Golang)

In this small recipe you can see how to send a transaction through the TON blockchain using tonutils-go. Our goal in this tutorial is to be able to send the transaction and receive the transaction hash.

Requirements

1. Golang installed.

Recipe

Importing the wallet

package main

import (
	"context"
	"encoding/base64"
	"errors"
	"log"
	"strings"

	"github.com/xssnick/tonutils-go/address"
	"github.com/xssnick/tonutils-go/liteclient"
	"github.com/xssnick/tonutils-go/tlb"
	"github.com/xssnick/tonutils-go/ton"
	"github.com/xssnick/tonutils-go/ton/wallet"
	tonwallet "github.com/xssnick/tonutils-go/ton/wallet"
)

func main() {
	// initialize connection pool.
	testnetConfigURL := "https://ton-blockchain.github.io/testnet-global.config.json"
	conn := liteclient.NewConnectionPool()
	ctx := context.Background()
	err := conn.AddConnectionsFromConfigUrl(ctx, testnetConfigURL)
	if err != nil {
		panic(err)
	}

	// initialize api client.
	api := ton.NewAPIClient(conn)

	// // importing wallet.
	seedStr := "<WALLET_SEED>" // if you don't have one you can generate it with tonwallet.NewSeed().
	seed := strings.Split(seedStr, " ")

	wallet, err := tonwallet.FromSeed(api, seed, wallet.V4R2)
	if err != nil {
		panic(err)
	}

	log.Println("WALLET ADDRESS: ", wallet.Address().String())
	
	// preparing for transaction...

}

In order to receive testnet tons you can use the Telegram Bot: @testgiver_ton_bot, where you will be requested to provide the wallet address.

Preparing transaction

	  
	 // previous part
	// preparing for transaction...
  
  	// getting latest master chain.
	block, err := api.CurrentMasterchainInfo(ctx)
	if err != nil {
		panic(err)
	}

	// amount of transaction to be made.
	var (
		amount        uint64 = 1e9                                                // 1e9 Nano TONs = 1TON.
		walletAddress string = "EQC9n6aFb2oxQPMTPrHOnZDFcvvC2YLYIgBUms2yAB_LcAtv" // wallet address to which we are goin to make the transaction.
		comment       string = "Payment"
	)

	balance, err := wallet.GetBalance(ctx, block)
	if err != nil {
		panic(err)
	}

	log.Println("AVAILABLE BALANCE", balance)

	// check if we have enough balance.
	if balance.NanoTON().Uint64() < amount {
		panic(errors.New("insufficient balance"))
	}

	// parse address, in case we receive an invalid address.
	addr, err := address.ParseAddr(walletAddress)
	if err != nil {
		panic(err)
	}

	// Now we can use the method Transfer that the library provides.
	// Which absolutely fine, the problem is that we WANT to retrieve the hash of the transaction.
	// Currently the Transfer method doesn't not return the hash of the transaction, because it gives you
	// the option to not wait for the transaction to finish. This is my assumption of course.
	// So let's try to wait for the transaction and to retrieve the hash of the transaction.
	// For that purpose the library provides us with a method called SendManyWaitTxHash.

	// creating cell for comment.
	body, err := tonwallet.CreateCommentCell(comment)
	if err != nil {
		panic(err)
	}

	txn, err := wallet.SendManyWaitTxHash(ctx, []*tonwallet.Message{
		{
			Mode: 1,
			InternalMessage: &tlb.InternalMessage{
				IHRDisabled: true,
				Bounce:      false, // we don't want the transaction to bounce, but you can change it to true if you want.
				DstAddr:     addr,  // destination address.
				Amount:      tlb.FromNanoTONU(amount),
				Body:        body,
			},
		},
	})
	if err != nil {
		panic(err)
	}

	// now we can use this transaction hash to search
	// the transaction in tonscan explorer.
	txnHash := base64.StdEncoding.EncodeToString(txn)
	log.Println("TXN HASH: ", txnHash)

Now with this transaction hash we can go into testnet tonscan and search for it.

All the code

package main

import (
	"context"
	"encoding/base64"
	"errors"
	"log"
	"strings"

	"github.com/xssnick/tonutils-go/address"
	"github.com/xssnick/tonutils-go/liteclient"
	"github.com/xssnick/tonutils-go/tlb"
	"github.com/xssnick/tonutils-go/ton"
	"github.com/xssnick/tonutils-go/ton/wallet"
	tonwallet "github.com/xssnick/tonutils-go/ton/wallet"
)

func main() {
	// initialize connection pool.
	testnetConfigURL := "https://ton-blockchain.github.io/testnet-global.config.json"
	conn := liteclient.NewConnectionPool()
	ctx := context.Background()
	err := conn.AddConnectionsFromConfigUrl(ctx, testnetConfigURL)
	if err != nil {
		panic(err)
	}

	// initialize api client.
	api := ton.NewAPIClient(conn)

	// // importing wallet.
	seedStr := "<WALLET_SEED>" // if you don't have one you can generate it with tonwallet.NewSeed().
	seed := strings.Split(seedStr, " ")

	wallet, err := tonwallet.FromSeed(api, seed, wallet.V4R2)
	if err != nil {
		panic(err)
	}

	log.Println("WALLET ADDRESS: ", wallet.Address().String())

	// getting latest master chain.
	block, err := api.CurrentMasterchainInfo(ctx)
	if err != nil {
		panic(err)
	}

	// amount of transaction to be made.
	var (
		amount        uint64 = 1e9                                                // 1e9 Nano TONs = 1TON.
		walletAddress string = "EQC9n6aFb2oxQPMTPrHOnZDFcvvC2YLYIgBUms2yAB_LcAtv" // wallet address to which we are goin to make the transaction.
		comment       string = "Payment"
	)

	balance, err := wallet.GetBalance(ctx, block)
	if err != nil {
		panic(err)
	}

	log.Println("AVAILABLE BALANCE", balance)

	// check if we have enough balance.
	if balance.NanoTON().Uint64() < amount {
		panic(errors.New("insufficient balance"))
	}

	// parse address, in case we receive an invalid address.
	addr, err := address.ParseAddr(walletAddress)
	if err != nil {
		panic(err)
	}

	// Now we can use the method Transfer that the library provides.
	// Which absolutely fine, the problem is that we WANT to retrieve the hash of the transaction.
	// Currently the Transfer method doesn't not return the hash of the transaction, because it gives you
	// the option to not wait for the transaction to finish. This is my assumption of course.
	// So let's try to wait for the transaction and to retrieve the hash of the transaction.
	// For that purpose the library provides us with a method called SendManyWaitTxHash.

	// creating cell for comment.
	body, err := tonwallet.CreateCommentCell(comment)
	if err != nil {
		panic(err)
	}

	txn, err := wallet.SendManyWaitTxHash(ctx, []*tonwallet.Message{
		{
			Mode: 1,
			InternalMessage: &tlb.InternalMessage{
				IHRDisabled: true,
				Bounce:      false, // we don't want the transaction to bounce, but you can change it to true if you want.
				DstAddr:     addr,  // destination address.
				Amount:      tlb.FromNanoTONU(amount),
				Body:        body,
			},
		},
	})
	if err != nil {
		panic(err)
	}

	// now we can use this transaction hash to search
	// the transaction in tonscan explorer.
	txnHash := base64.StdEncoding.EncodeToString(txn)
	log.Println("TXN HASH: ", txnHash)
}

That’s all :)!!