ton

Documentation

Index

• Constants
• Variables
• type APIClient
  • func NewAPIClient(client LiteClient) *APIClient
  • func (c *APIClient) Client() LiteClient
  • func (c *APIClient) CurrentMasterchainInfo(ctx context.Context) (_ *tlb.BlockInfo, err error)
  • func (c *APIClient) GetAccount(ctx context.Context, block *tlb.BlockInfo, addr *address.Address) (*tlb.Account, error)
  • func (c *APIClient) GetBlockData(ctx context.Context, block *tlb.BlockInfo) (*tlb.Block, error)
  • func (c *APIClient) GetBlockShardsInfo(ctx context.Context, master *tlb.BlockInfo) ([]*tlb.BlockInfo, error)
  • func (c *APIClient) GetBlockTransactions(ctx context.Context, block *tlb.BlockInfo, count uint32, ...) ([]*tlb.TransactionID, bool, error)
  • func (c *APIClient) GetBlockchainConfig(ctx context.Context, block *tlb.BlockInfo, onlyParams ...int32) (*BlockchainConfig, error)
  • func (c *APIClient) GetMasterchainInfo(ctx context.Context) (*tlb.BlockInfo, error)
  • func (c *APIClient) GetTime(ctx context.Context) (uint32, error)
  • func (c *APIClient) GetTransaction(ctx context.Context, block *tlb.BlockInfo, addr *address.Address, lt uint64) (*tlb.Transaction, error)
  • func (c *APIClient) ListTransactions(ctx context.Context, addr *address.Address, limit uint32, lt uint64, ...) ([]*tlb.Transaction, error)
  • func (c *APIClient) LookupBlock(ctx context.Context, workchain int32, shard int64, seqno uint32) (*tlb.BlockInfo, error)
  • func (c *APIClient) RunGetMethod(ctx context.Context, blockInfo *tlb.BlockInfo, addr *address.Address, ...) (*ExecutionResult, error)
  • func (c *APIClient) SendExternalMessage(ctx context.Context, msg *tlb.ExternalMessage) error
  • func (c *APIClient) WaitNextMasterBlock(ctx context.Context, master *tlb.BlockInfo) (*tlb.BlockInfo, error)
• type BlockchainConfig
  • func (b *BlockchainConfig) All() map[int32]*cell.Cell
  • func (b *BlockchainConfig) Get(id int32) *cell.Cell
• type ContractExecError
  • func (e ContractExecError) Error() string
  • func (e ContractExecError) Is(err error) bool
• type ExecutionResult
  • func NewExecutionResult(data []any) *ExecutionResult
  • func (r ExecutionResult) AsTuple() []any
  • func (r ExecutionResult) Builder(index uint) (*cell.Builder, error)
  • func (r ExecutionResult) Cell(index uint) (*cell.Cell, error)
  • func (r ExecutionResult) Int(index uint) (*big.Int, error)
  • func (r ExecutionResult) IsNil(index uint) (bool, error)
  • func (r ExecutionResult) MustBuilder(index uint) *cell.Builder
  • func (r ExecutionResult) MustCell(index uint) *cell.Cell
  • func (r ExecutionResult) MustInt(index uint) *big.Int
  • func (r ExecutionResult) MustIsNil(index uint) bool
  • func (r ExecutionResult) MustSlice(index uint) *cell.Slice
  • func (r ExecutionResult) MustTuple(index uint) []any
  • func (r ExecutionResult) Slice(index uint) (*cell.Slice, error)
  • func (r ExecutionResult) Tuple(index uint) ([]any, error)
• type LSError
  • func (e LSError) Error() string
  • func (e LSError) Is(err error) bool
  • func (e *LSError) Load(data []byte) ([]byte, error)
• type LiteClient

Constants

const (
	ErrCodeContractNotInitialized = 4294967040
)

Variables

var ErrBlockNotFound = errors.New("block not found")

var ErrIncorrectResultType = errors.New("incorrect result type")

var ErrMessageNotAccepted = errors.New("message was not accepted by the contract")

var ErrNoNewBlocks = errors.New("no new blocks in a given timeout or in 10 seconds")

var ErrResultIndexOutOfRange = errors.New("result index is out of range")

Types

type APIClient

type APIClient struct {
	// contains filtered or unexported fields
}

func NewAPIClient

func NewAPIClient(client LiteClient) *APIClient

func (*APIClient) Client

func (c *APIClient) Client() LiteClient

func (*APIClient) CurrentMasterchainInfo

func (c *APIClient) CurrentMasterchainInfo(ctx context.Context) (_ *tlb.BlockInfo, err error)

CurrentMasterchainInfo - cached version of GetMasterchainInfo to not do it in parallel many times

func (*APIClient) GetAccount

func (c *APIClient) GetAccount(ctx context.Context, block *tlb.BlockInfo, addr *address.Address) (*tlb.Account, error)

func (*APIClient) GetBlockData

func (c *APIClient) GetBlockData(ctx context.Context, block *tlb.BlockInfo) (*tlb.Block, error)

GetBlockData - get block detailed information

func (*APIClient) GetBlockShardsInfo

func (c *APIClient) GetBlockShardsInfo(ctx context.Context, master *tlb.BlockInfo) ([]*tlb.BlockInfo, error)

GetBlockShardsInfo - gets the information about workchains and its shards at given masterchain state

func (*APIClient) GetBlockTransactions

func (c *APIClient) GetBlockTransactions(ctx context.Context, block *tlb.BlockInfo, count uint32, after ...*tlb.TransactionID) ([]*tlb.TransactionID, bool, error)

GetBlockTransactions - list of block transactions

func (*APIClient) GetBlockchainConfig

func (c *APIClient) GetBlockchainConfig(ctx context.Context, block *tlb.BlockInfo, onlyParams ...int32) (*BlockchainConfig, error)

func (*APIClient) GetMasterchainInfo

func (c *APIClient) GetMasterchainInfo(ctx context.Context) (*tlb.BlockInfo, error)

GetMasterchainInfo - gets the latest state of master chain

func (*APIClient) GetTime

func (c *APIClient) GetTime(ctx context.Context) (uint32, error)

func (*APIClient) GetTransaction

func (c *APIClient) GetTransaction(ctx context.Context, block *tlb.BlockInfo, addr *address.Address, lt uint64) (*tlb.Transaction, error)

func (*APIClient) ListTransactions

func (c *APIClient) ListTransactions(ctx context.Context, addr *address.Address, limit uint32, lt uint64, txHash []byte) ([]*tlb.Transaction, error)

ListTransactions - returns list of transactions before (including) passed lt and hash, the oldest one is first in result slice

func (*APIClient) LookupBlock

func (c *APIClient) LookupBlock(ctx context.Context, workchain int32, shard int64, seqno uint32) (*tlb.BlockInfo, error)

LookupBlock - find block information by seqno, shard and chain

func (*APIClient) RunGetMethod

func (c *APIClient) RunGetMethod(ctx context.Context, blockInfo *tlb.BlockInfo, addr *address.Address, method string, params ...any) (*ExecutionResult, error)

func (*APIClient) SendExternalMessage

func (c *APIClient) SendExternalMessage(ctx context.Context, msg *tlb.ExternalMessage) error

func (*APIClient) WaitNextMasterBlock

func (c *APIClient) WaitNextMasterBlock(ctx context.Context, master *tlb.BlockInfo) (*tlb.BlockInfo, error)

type BlockchainConfig

type BlockchainConfig struct {
	// contains filtered or unexported fields
}

func (*BlockchainConfig) All

func (b *BlockchainConfig) All() map[int32]*cell.Cell

func (*BlockchainConfig) Get

func (b *BlockchainConfig) Get(id int32) *cell.Cell

type ContractExecError

type ContractExecError struct {
	Code uint32
}

func (ContractExecError) Error

func (e ContractExecError) Error() string

func (ContractExecError) Is

func (e ContractExecError) Is(err error) bool

type ExecutionResult

type ExecutionResult struct {
	// contains filtered or unexported fields
}

func NewExecutionResult

func NewExecutionResult(data []any) *ExecutionResult

func (ExecutionResult) AsTuple

func (r ExecutionResult) AsTuple() []any

func (ExecutionResult) Builder

func (r ExecutionResult) Builder(index uint) (*cell.Builder, error)

func (ExecutionResult) Cell

func (r ExecutionResult) Cell(index uint) (*cell.Cell, error)

func (ExecutionResult) Int

func (r ExecutionResult) Int(index uint) (*big.Int, error)

func (ExecutionResult) IsNil

func (r ExecutionResult) IsNil(index uint) (bool, error)

func (ExecutionResult) MustBuilder

func (r ExecutionResult) MustBuilder(index uint) *cell.Builder

func (ExecutionResult) MustCell

func (r ExecutionResult) MustCell(index uint) *cell.Cell

func (ExecutionResult) MustInt

func (r ExecutionResult) MustInt(index uint) *big.Int

func (ExecutionResult) MustIsNil

func (r ExecutionResult) MustIsNil(index uint) bool

func (ExecutionResult) MustSlice

func (r ExecutionResult) MustSlice(index uint) *cell.Slice

func (ExecutionResult) MustTuple

func (r ExecutionResult) MustTuple(index uint) []any

func (ExecutionResult) Slice

func (r ExecutionResult) Slice(index uint) (*cell.Slice, error)

func (ExecutionResult) Tuple

func (r ExecutionResult) Tuple(index uint) ([]any, error)

type LSError

type LSError struct {
	Code int32
	Text string
}

func (LSError) Error

func (e LSError) Error() string

func (LSError) Is

func (e LSError) Is(err error) bool

func (*LSError) Load

func (e *LSError) Load(data []byte) ([]byte, error)

type LiteClient

type LiteClient interface {
	Do(ctx context.Context, typeID int32, payload []byte) (*liteclient.LiteResponse, error)
	StickyContext(ctx context.Context) context.Context
}