txemulator

Documentation

Index

• Variables
• func FindLibraries(cell *boc.Cell) ([]ton.Bits256, error)
• func LibrariesToBase64(libraries map[ton.Bits256]*boc.Cell) (string, error)
• type EmulationResult
• type Emulator
  • func NewEmulator(config *boc.Cell, verbosityLevel VerbosityLevel) (*Emulator, error)
  • func (e *Emulator) Emulate(shardAccount tlb.ShardAccount, message tlb.Message) (EmulationResult, error)
  • func (e *Emulator) SetConfig(config *boc.Cell) error
  • func (e *Emulator) SetIgnoreSignatureCheck(ignore bool) error
  • func (e *Emulator) SetLT(lt uint64) error
  • func (e *Emulator) SetLibs(libs *boc.Cell) error
  • func (e *Emulator) SetRandomSeed(seed [32]byte) error
  • func (e *Emulator) SetUnixtime(utime uint32) error
  • func (e *Emulator) SetVerbosityLevel(level int) error
• type ErrorWithExitCode
  • func (e ErrorWithExitCode) Error() string
  • func (e ErrorWithExitCode) Is(err error) bool
• type TraceOption
  • func WithAccounts(accounts ...tlb.ShardAccount) TraceOption
  • func WithAccountsMap(m map[ton.AccountID]tlb.ShardAccount) TraceOption
  • func WithAccountsSource(b accountGetter) TraceOption
  • func WithConfig(c *boc.Cell) TraceOption
  • func WithConfigBase64(c string) TraceOption
  • func WithLimit(l int) TraceOption
  • func WithSignatureCheck() TraceOption
  • func WithSoftLimit(l int) TraceOption
  • func WithTestnet() TraceOption
  • func WithTime(t int64) TraceOption
• type TraceOptions
• type Tracer
  • func NewTraceBuilder(options ...TraceOption) (*Tracer, error)
  • func (t *Tracer) FinalStates() map[ton.AccountID]tlb.ShardAccount
  • func (t *Tracer) Run(ctx context.Context, message tlb.Message) (*TxTree, error)
• type TxTree
• type VerbosityLevel

Variables

var DefaultConfig = `` /* 1500-byte string literal not displayed */

Functions

func FindLibraries

func FindLibraries(cell *boc.Cell) ([]ton.Bits256, error)

FindLibraries looks for library cells inside the given cell tree and returns a list of hashes of found library cells.

func LibrariesToBase64

func LibrariesToBase64(libraries map[ton.Bits256]*boc.Cell) (string, error)

LibrariesToBase64 converts a map with libraries to a base64 string.

Types

type EmulationResult

type EmulationResult struct {
	Success   bool
	Emulation *struct {
		ShardAccount   tlb.ShardAccount
		Transaction    tlb.Transaction
		RawTransaction string
	}
	Logs  string
	Error *struct {
		ExitCode int
		Text     string
	}
}

type Emulator

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

func NewEmulator

func NewEmulator(config *boc.Cell, verbosityLevel VerbosityLevel) (*Emulator, error)

NewEmulator Verbosity level of VM log. 0 - log truncated to last 256 characters. 1 - unlimited length log. 2 - for each command prints its cell hash and offset. 3 - for each command log prints all stack values.

func (*Emulator) Emulate

func (e *Emulator) Emulate(shardAccount tlb.ShardAccount, message tlb.Message) (EmulationResult, error)

func (*Emulator) SetConfig

func (e *Emulator) SetConfig(config *boc.Cell) error

func (*Emulator) SetIgnoreSignatureCheck

func (e *Emulator) SetIgnoreSignatureCheck(ignore bool) error

func (*Emulator) SetLT

func (e *Emulator) SetLT(lt uint64) error

func (*Emulator) SetLibs

func (e *Emulator) SetLibs(libs *boc.Cell) error

func (*Emulator) SetRandomSeed

func (e *Emulator) SetRandomSeed(seed [32]byte) error

func (*Emulator) SetUnixtime

func (e *Emulator) SetUnixtime(utime uint32) error

func (*Emulator) SetVerbosityLevel

func (e *Emulator) SetVerbosityLevel(level int) error

SetVerbosityLevel verbosity level (0 - never, 1 - error, 2 - warning, 3 - info, 4 - debug)

type ErrorWithExitCode

type ErrorWithExitCode struct {
	Message   string
	Iteration int
	ExitCode  int
}

ErrorWithExitCode is an error returned when emulation failed with exit code.

func (ErrorWithExitCode) Error

func (e ErrorWithExitCode) Error() string

func (ErrorWithExitCode) Is

func (e ErrorWithExitCode) Is(err error) bool

type TraceOption

type TraceOption func(o *TraceOptions) error

func WithAccounts

func WithAccounts(accounts ...tlb.ShardAccount) TraceOption

func WithAccountsMap

func WithAccountsMap(m map[ton.AccountID]tlb.ShardAccount) TraceOption

func WithAccountsSource

func WithAccountsSource(b accountGetter) TraceOption

func WithConfig

func WithConfig(c *boc.Cell) TraceOption

func WithConfigBase64

func WithConfigBase64(c string) TraceOption

func WithLimit

func WithLimit(l int) TraceOption

func WithSignatureCheck

func WithSignatureCheck() TraceOption

func WithSoftLimit

func WithSoftLimit(l int) TraceOption

func WithTestnet

func WithTestnet() TraceOption

func WithTime

func WithTime(t int64) TraceOption

type TraceOptions

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

type Tracer

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

func NewTraceBuilder

func NewTraceBuilder(options ...TraceOption) (*Tracer, error)

func (*Tracer) FinalStates

func (t *Tracer) FinalStates() map[ton.AccountID]tlb.ShardAccount

func (*Tracer) Run

func (t *Tracer) Run(ctx context.Context, message tlb.Message) (*TxTree, error)

type TxTree

type TxTree struct {
	TX       tlb.Transaction
	Children []*TxTree
}

type VerbosityLevel

type VerbosityLevel int

const (
	LogTruncated VerbosityLevel = iota
	LogUnlimited
	CellHashAndOffsetForCommand
	PrintsAllStackValuesForCommand
)