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
- 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 :)!!
Top comments (0)