ton

package module
v0.0.0-...-be50d8c Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 12, 2024 License: Apache-2.0 Imports: 18 Imported by: 0

README

ton-sdk

Ton SDK is used to interact with the Ton blockchain, it contains various functions can be used to web3 wallet.

Installation

go get

To obtain the latest version, simply require the project using :

go get -u github.com/okx/go-wallet-sdk/coins/ton

Usage

New Address (v4r2 wallet address)
    seedHex := "45d3bd794c5bc6ed91ae41c93c0baed679935703dfac72c48d27f8321b8d3a40"
seed, _ := hex.DecodeString(seedHex)
address, err := NewAddress(seed)
fmt.Println(address)
Transfer TON
seed, _ := hex.DecodeString("45d3bd794c5bc6ed91ae41c93c0baed679935703dfac72c48d27f8321b8d3a40") //your private key
address, err := NewAddress(seed) //generate address
fmt.Println(address)
to := "UQC6QJ31Bv_hjmsoaUjRmpZYqj9NXbBbvufCNycnc0gjReqR" //to ,which address receives the TON.
amount := "100000000" //amount to transfer . 1 TON means 100000000
comment := ""         //your comment .optional.
seqno := uint32(0) //your seqno.
pubKey := ed25519.NewKeyFromSeed(seed).Public().(ed25519.PublicKey)
expireAt := time.Now().Unix() + 600
//false means that now it is  Not a simulative transaction.
simulate := false
signedTx, err := Transfer(seed, pubKey, to, amount, comment, seqno, expireAt, 3, simulate) //3 is recommended pattern. false means that now it is  Not a simulative transaction.
assert.Nil(t, err)
t.Log(signedTx.Tx)
fmt.Println(signedTx.Tx) // the tx is in signedTx.Tx
fmt.Println(signedTx.Hash) //this hash is used to query the transaction in the browser.
Transfer Jetton token
seed, _ := hex.DecodeString("45d3bd794c5bc6ed91ae41c93c0baed679935703dfac72c48d27f8321b8d3a40") //your private key
fromJettonAccount := "UQD7w9qG8Cq0PgX0hnp5nVpHPeDYL0QlhcLtjFMmna43sMxz" //your jetton account
to := "UQC27fdnAFQcQDaXDrR89OKx-lW_Zyxuzcy5CjfPrS9A6vZf"                //to ,which address receives the TON.
amount := "1"      //jetton amount to transfer . Each token has a different precision.1 USDT may means 1000000
seqno := uint32(0) //your seqno.
pubKey := ed25519.NewKeyFromSeed(seed).Public().(ed25519.PublicKey)
//"jetton test",, your comment .optional.
comment :="jetton test"
//recommended value
messageAttachedTons := "50000000"

expireAt := time.Now().Unix() + 600
//recommended value
invokeNotificationFee := "1"
//false means that now it is  Not a simulative transaction.
simulate := false
signedTx, err := TransferJetton(seed, pubKey, fromJettonAccount, to, amount, 9, seqno, messageAttachedTons, invokeNotificationFee, comment, expireAt, 0, simulate)

assert.Nil(t, err)
fmt.Println( signedTx.Tx) // the tx is in signedTx.Tx
fmt.Println( signedTx.Hash) //this hash is used to query the transaction in the browser.
Simulate Transferring TON(Used to estimate gas charges)
    seed, _ := hex.DecodeString("45d3bd794c5bc6ed91ae41c93c0baed679935703dfac72c48d27f8321b8d3a40") //your private key
address, err := NewAddress(seed) //generate address
fmt.Println(address)
to := "UQC6QJ31Bv_hjmsoaUjRmpZYqj9NXbBbvufCNycnc0gjReqR" //to ,which address receives the TON.
amount := "100000000" //amount to transfer . 1 TON means 100000000
comment := ""         //your comment .optional.
seqno := uint32(0) //your seqno.
expireAt := time.Now().Unix() + 600
//true means that now it IS  a simulative transaction.
simulate := true
pubKey := ed25519.NewKeyFromSeed(seed).Public().(ed25519.PublicKey)
signedTx, err := Transfer(nil, pubKey, to, amount, comment, seqno, expireAt, 3, simulate) //3 is recommended pattern. 
assert.Nil(t, err)
fmt.Println( signedTx.Tx) // the tx is in signedTx.Tx Used to estimate gas charges
Simulate Transferring Jetton token(Used to estimate gas charges)
seed, _ := hex.DecodeString("45d3bd794c5bc6ed91ae41c93c0baed679935703dfac72c48d27f8321b8d3a40") //your private key
fromJettonAccount := "UQD7w9qG8Cq0PgX0hnp5nVpHPeDYL0QlhcLtjFMmna43sMxz" //your jetton account
to := "UQC27fdnAFQcQDaXDrR89OKx-lW_Zyxuzcy5CjfPrS9A6vZf"                //to ,which address receives the TON.
amount := "1"      //jetton amount to transfer . Each token has a different precision.1 USDT may means 1000000
seqno := uint32(0) //your seqno.
pubKey := ed25519.NewKeyFromSeed(seed).Public().(ed25519.PublicKey)
//"jetton test",, your comment .optional.
comment :="jetton test"
//recommended value
messageAttachedTons := "50000000"
expireAt := time.Now().Unix() + 600
//recommended value
invokeNotificationFee := "1"
//false means that now it IS  a simulative transaction.
simulate := true
signedTx, err := TransferJetton(nil, pubKey, fromJettonAccount, to, amount, 9, seqno, messageAttachedTons, invokeNotificationFee, comment, expireAt, 0, simulate)
assert.Nil(t, err)
fmt.Println( signedTx.Tx) // the tx is in signedTx.Tx Used to estimate gas charges
Sign proof
seed, err := hex.DecodeString("45d3bd794c5bc6ed91ae41c93c0baed679935703dfac72c48d27f8321b8d3a40")
assert.NoError(t, err)
addr := "EQA3_JIJKDC0qauDUEQe2KjQj1iLwQRtrEREzmfDxbCKw9Kr"
proof := &ProofData{
Timestamp: 1719309177,    // timestamp 
Domain:    "ton.org.com", //domain
Payload:   "123", //comment or something
}
r, err := SignProof(addr, seed, proof)
assert.NoError(t, err)
pub := ed25519.NewKeyFromSeed(seed).Public().(ed25519.PublicKey)
sign, err := base64.StdEncoding.DecodeString(r) //sign of proof 
assert.NoError(t, err)
expect := "V1ImmDgpt4DtZYYeGeZz38w7J+dXtYbBf/Hl7DLcWLEad23TOexKCSTO1f+N7i3UDreGVfycaVNbOspJnr9aDw=="
assert.Equal(t, r, expect)
assert.NoError(t, VerifySignProof(addr, pub, sign, proof))
Verify proof
seed, err := hex.DecodeString("45d3bd794c5bc6ed91ae41c93c0baed679935703dfac72c48d27f8321b8d3a40")
assert.NoError(t, err)
addr := "EQA3_JIJKDC0qauDUEQe2KjQj1iLwQRtrEREzmfDxbCKw9Kr"
proof := &ProofData{
Timestamp: 1719309177,    // timestamp 
Domain:    "ton.org.com", //domain
Payload:   "123", //comment or something
}
r, err := SignProof(addr, seed, proof)
assert.NoError(t, err)
pub := ed25519.NewKeyFromSeed(seed).Public().(ed25519.PublicKey)
expect := "V1ImmDgpt4DtZYYeGeZz38w7J+dXtYbBf/Hl7DLcWLEad23TOexKCSTO1f+N7i3UDreGVfycaVNbOspJnr9aDw=="
assert.Equal(t, r, expect)
assert.NoError(t, VerifySignProofStr(addr, hex.EncodeToString(pub), r, proof))
Dapp sign request

var r MultiRequest
//code is the data from dapp on TON chain.
code := `{
        "messages":[{
	"address": "EQARULUYsmJq1RiZ-YiH-IJLcAZUVkVff-KBPwEmmaQGH6aC",
	"amount": "195000000",
	"payload":"te6cckEBAgEAigABaw+KfqUAAABqOXlveTmJaAgA7zuZAqJxsqAciTilI8/iTnGEeq62piAAHtRKd6wOcJwQLBuBAwEAnSWThWGAHIXiG4S2uBKfvTnDWV0CiqXAwDzv4KIacQogkCmsj0NuCxykPOZl3QAo0GtsbOJdNcL0J61peOgcvbzLsvXBsnC6HO6YLfLMvtDoIHzZ"
	}],
        "from": "0:a341adb1b38974d70bd09eb5a5e3a072f6f32ecbd706c9c2e873ba60b7cb32fb",
 "valid_until": 1730335778,
        "network": "-239"
}`
//your nonce or seqno
nonce := uint32(180)
err := json.Unmarshal([]byte(code), &r)
assert.NoError(t, err)
//your private key seed 
seed, _ := hex.DecodeString("45d3bd794c5bc6ed91ae41c93c0baed679935703dfac72c48d27f8321b8d3a40")
address, err := NewAddress(seed)
fmt.Println(address)
assert.NoError(t, err)
assert.NoError(t, r.Check())
//simulate means that now it IS  a simulative transaction.and false means that now it is NOT a simulative transaction.
//whie simulate is true,the result is  Used to estimate gas charges
simulate := true
s, err := SignMultiTransfer(seed, nil, nonce, &r, simulate)
assert.NoError(t, err)
fmt.Println(s.Tx)
tt := &testSignedTx{
Address:      s.Address,
Body:         s.Tx,
InitData:     s.Data,
InitCode:     s.Code,
IgnoreChksig: true,
}
fmt.Println(tt.Str())

License

Most packages or folder are MIT licensed, see package or folder for the respective license.

Documentation

Index

Constants

View Source 
const (
	TransferTimeoutSec = 600
)

Variables

View Source 
var (
	ErrInvalidParam = errors.New("invalid param")
	ErrInvalidSign  = errors.New("invalid sign")
)
View Source 
var (
	ErrInvalidMnemonic = errors.New("invalid mnemonic")
)
View Source 
var (
	ErrInvalidMultiRequest = errors.New("invalid multi request content")
)

Functions

func AddressStrings 

func AddressStrings(a string) ([]*address.AddrWithType, error)

func CalTxHash 

func CalTxHash(boc string) (string, error)

func FromSeedV4R2 

func FromSeedV4R2(mnemonic, password string) (ed25519.PrivateKey, error)

func NewAddress 

func NewAddress(seed []byte) (string, error)

func SignProof 

func SignProof(addr string, seed []byte, payload *ProofData) (string, error)

func ValidateAddress 

func ValidateAddress(addr string) bool

func VenomNewAddress 

func VenomNewAddress(seed []byte) (string, error)

func VenomTransfer 

func VenomTransfer(seed []byte, to, amount, comment string, seqno uint32, bounce bool, globalID uint32, expireAt int64, mode uint8) (string, error)

VenomTransfer venom chain use v3 til now

func VerifySignProof 

func VerifySignProof(addr string, pub, sign []byte, payload *ProofData) error

func VerifySignProofStr 

func VerifySignProofStr(addr string, pubHex, signBase64 string, payload *ProofData) error

Types

type AccontInfo 

type AccontInfo struct {
	InitCode        string `json:"initCode"`
	InitData        string `json:"initData"`
	WalletStateInit string `json:"walletStateInit"`
	WalletAddress   string `json:"walletAddress"`
}

func GetWalletInformation 

func GetWalletInformation(seed, pubKey []byte) (*AccontInfo, error)

func (*AccontInfo) Str 

func (s *AccontInfo) Str() (string, error)

type Msg 

type Msg struct {
	Address   string `json:"address"`
	Amount    string `json:"amount"`
	Payload   string `json:"payload"`
	StateInit string `json:"stateInit"`
}

func (*Msg) Check 

func (s *Msg) Check() error

type MultiRequest 

type MultiRequest struct {
	Messages   []*Msg `json:"messages"`
	ValidUntil int64  `json:"valid_until"`
	From       string `json:"from"`
	Network    string `json:"network"`
}

func (*MultiRequest) Check 

func (s *MultiRequest) Check() error

type ProofData 

type ProofData struct {
	Timestamp uint64 `json:"timestamp"`
	Domain    string `json:"domain"`
	Payload   string `json:"payload"`
}

type SignedTx 

type SignedTx struct {
	Code    string `json:"code"`
	Data    string `json:"data"`
	Tx      string `json:"tx"`
	Hash    string `json:"hash"`
	Address string `json:"address"`
}

func SignMultiTransfer 

func SignMultiTransfer(seed, pub []byte, seqno uint32, request *MultiRequest, simulate bool) (*SignedTx, error)

func Transfer 

func Transfer(seed, pubKey []byte, to, amount, comment string, seqno uint32, expireAt int64, mode uint8, simulate bool) (*SignedTx, error)

func TransferJetton 

func TransferJetton(seed, pubKey []byte, from, to, amount string, decimals int, seqno uint32, messageAttachedTons string, invokeNotificationFee string, comment string, expireAt int64, rnd uint64, simulate bool) (*SignedTx, error)

func (*SignedTx) FillTx 

func (s *SignedTx) FillTx(tx string)

func (*SignedTx) Str 

func (s *SignedTx) Str() (string, error)

Source Files

View all Source files

Directories

Path Synopsis
Package crc16 implements the 16-bit cyclic redundancy check, or CRC-16, checksum.
 Package crc16 implements the 16-bit cyclic redundancy check, or CRC-16, checksum.
ton
jetton
wallet
tvm
cell

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.