tracers

Documentation

Overview

Package tracers is a manager for transaction tracing engines.

Index

• func RegisterLookup(wildcard bool, lookup lookupFunc)
• type Context
• type Tracer
  • func New(code string, ctx *Context, cfg json.RawMessage) (Tracer, error)

Functions

func RegisterLookup

func RegisterLookup(wildcard bool, lookup lookupFunc)

RegisterLookup registers a method as a lookup for tracers, meaning that users can invoke a named tracer through that lookup. If 'wildcard' is true, then the lookup will be placed last. This is typically meant for interpreted engines (js) which can evaluate dynamic user-supplied code.

Types

type Context

type Context struct {
	BlockHash libcommon.Hash // Hash of the block the txn is contained within (zero if dangling txn or call)
	TxIndex   int            // Index of the transaction within a block (zero if dangling txn or call)
	TxHash    libcommon.Hash // Hash of the transaction being traced (zero if dangling call)
}

Context contains some contextual infos for a transaction execution that is not available from within the EVM object.

type Tracer

type Tracer interface {
	vm.EVMLogger
	GetResult() (json.RawMessage, error)
	// Stop terminates execution of the tracer at the first opportune moment.
	Stop(err error)
}

Tracer interface extends vm.EVMLogger and additionally allows collecting the tracing result.

func New

func New(code string, ctx *Context, cfg json.RawMessage) (Tracer, error)

New returns a new instance of a tracer, by iterating through the registered lookups.