README
¶
tongo
Go implementation of libraries for TON blockchain.
Library structure
- ADNL - low level adnl protocol implementation
- Lite client - interaction with TON node as lite client
- BOC - cells and bag-of-cells methods and primitives
- TL - interaction with binary data described by TL (Type Language) schemas
- TLB - interaction with binary data (in Cells) described by TL-B (Typed Language - Binary) schemas
- TVM - interaction with TVM (TON Virtual Machine)
- Wallet - tools to simplify the deployment and interaction with the wallet smart contract
- Contract - tools to simplify the interaction with the smart contracts like Jettons and NFT
- Examples
Dependencies
Libraries
For TVM executor you need a libraries from lib/darwin (MAC) or lib/linux
Connection to TON node
For connect to TON node you need to know public key and ip:port. In most cases you can use public config files.
Download global-config.json (mainnet) or testnet-global.config.json (testnet) file from ton.org
Lite client supports auto-download mainnet config from ton.org.
Package installation
go get github.com/ice-hermes/tongo
Basic types
Tongo operates with TON blockchain structures described in block.tlb
and some types described in lite_api.tl.
Go definitions of these types you can find in files: ton/account.go, ton/transactions.go, ton/models.go ...
Chat
You can join to our chat in telegram - https://t.me/tongo_lib
Don't be afraid if you see only russians - we welcome any english speakers too.
Documentation
¶
Index ¶
- Constants
- Variables
- func CreateExternalMessage(address AccountID, body *boc.Cell, init *tlb.StateInit, ...) (tlb.Message, error)
- func DefaultAddressParser() *addressParser
- func MustParseAddress(a string) ton.Address
- func NewAccountAddressParser(resolver dnsResolver) *addressParser
- func ParseAddress(a string) (ton.Address, error)
- func SetDefaultExecutor(executor abi.Executor, opts ...ParserOption)
- type AccountID
- type Bits256
- type BlockID
- type BlockIDExt
- type JettonMetadata
- type ParserOption
- type ParserOptions
- type ShardID
- type Transaction
Constants ¶
const (
// DefaultRoot is the default DNS root address used by the addressParser.
DefaultRoot = "-1:e56754f83426f69b09267bd876ac97c44821345b7e266bd956a7bfbfb98df35c"
)
Variables ¶
var AccountIDFromTlb = ton.AccountIDFromTlb
var BlockchainInterfaceIsNil = errors.New("blockchain interface is nil")
var MustParseAccountID = ton.MustParseAccountID
Deprecated: use MustParseAddress instead.
var NewAccountId = ton.NewAccountID
Deprecated use ton.NewAccountID instead
var ParseAccountID = ton.ParseAccountID
Deprecated: use ParseAddress instead.
Functions ¶
func CreateExternalMessage ¶
func DefaultAddressParser ¶
func DefaultAddressParser() *addressParser
DefaultAddressParser returns a default address parser that works in the mainnet. For other networks, use SetDefaultExecutor(testnetLiteapiClient). Take a look at NewAccountAddressParser to create a parser for a different network or with a different root address.
func MustParseAddress ¶
func NewAccountAddressParser ¶
func NewAccountAddressParser(resolver dnsResolver) *addressParser
func ParseAddress ¶
ParseAddress parses a string of different formats to a ton.Address.
func SetDefaultExecutor ¶
func SetDefaultExecutor(executor abi.Executor, opts ...ParserOption)
SetDefaultExecutor sets the default executor for the default address parser. The executor is used to resolve DNS records.
Types ¶
type Bits256 ¶
func MustParseHash ¶
type BlockID ¶
func MustParseBlockID ¶
func ParseBlockID ¶
ParseBlockID tries to construct BlockID from the given string.
type BlockIDExt ¶
type BlockIDExt = ton.BlockIDExt
func GetParents ¶
func GetParents(i tlb.BlockInfo) ([]BlockIDExt, error)
func NewTonBlockId ¶
func NewTonBlockId(fileHash, rootHash Bits256, seqno uint32, shard uint64, workchain int32) *BlockIDExt
func ShardIDs ¶
func ShardIDs(blk *tlb.Block) []BlockIDExt
ShardIDs returns a list of IDs of shard blocks this block refers to.
type JettonMetadata ¶
type ParserOption ¶
type ParserOption func(options *ParserOptions)
func WithRootDNS ¶
func WithRootDNS(root AccountID) ParserOption
type ParserOptions ¶
type Transaction ¶
type Transaction = ton.Transaction
Source Files
Directories