tracers

README

based on github.com/ethereum/go-ethereum/eth/tracers v1.8.14 tag

2020-10-16(rebase to v1.9.23)

• merge commit https://github.com/ethereum/go-ethereum/commit/e8ff318205be2d3e9f793ee876726bf0fbaf579e (eth/tracer: extend create2)
• merge commit https://github.com/ethereum/go-ethereum/commit/dfa16a3e4e0e0b5b20bfda7b7e89ebd07ea0a1a5 (eth/tracers: fixed incorrect storage from prestate_tracer)
• merge commit https://github.com/ethereum/go-ethereum/commit/71c37d82adaa2b69ea98ce0c5505489d6b711c1e (js/tracers: make call tracer report value in selfdestructs)
• merge commit https://github.com/ethereum/go-ethereum/commit/05280a7ae3f47adc8aeb9130c7f5404a42fb3a55 (eth/tracers: revert reason in call_tracer + error for failed internal calls)

Documentation

Overview

Package tracers is a collection of JavaScript transaction tracers.

Index

• func CodeByName(name string) (string, bool)
• type Tracer
  • func New(code string) (*Tracer, error)
  • func (jst *Tracer) CaptureEnd(output []byte, gasUsed uint64, t time.Duration, err error) error
  • func (jst *Tracer) CaptureFault(env *vm.EVM, pc uint64, op vm.OpCode, gas, cost uint64, memory *vm.Memory, ...) error
  • func (jst *Tracer) CaptureStart(from common.Address, to common.Address, create bool, input []byte, gas uint64, ...) error
  • func (jst *Tracer) CaptureState(env *vm.EVM, pc uint64, op vm.OpCode, gas, cost uint64, memory *vm.Memory, ...) error
  • func (jst *Tracer) GetResult() (json.RawMessage, error)
  • func (jst *Tracer) Stop(err error)

Functions

func CodeByName

func CodeByName(name string) (string, bool)

CodeByName returns code by tracer name

Types

type Tracer

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

Tracer provides an implementation of Tracer that evaluates a Javascript function for each VM execution step.

func New

func New(code string) (*Tracer, error)

New instantiates a new tracer instance. code specifies a Javascript snippet, which must evaluate to an expression returning an object with 'step', 'fault' and 'result' functions.

func (*Tracer) CaptureEnd

func (jst *Tracer) CaptureEnd(output []byte, gasUsed uint64, t time.Duration, err error) error

CaptureEnd is called after the call finishes to finalize the tracing.

func (*Tracer) CaptureFault

func (jst *Tracer) CaptureFault(env *vm.EVM, pc uint64, op vm.OpCode, gas, cost uint64, memory *vm.Memory, stack *vm.Stack, contract *vm.Contract, depth int, err error) error

CaptureFault implements the Tracer interface to trace an execution fault while running an opcode.

func (*Tracer) CaptureStart

func (jst *Tracer) CaptureStart(from common.Address, to common.Address, create bool, input []byte, gas uint64, value *big.Int) error

CaptureStart implements the Tracer interface to initialize the tracing operation.

func (*Tracer) CaptureState

func (jst *Tracer) CaptureState(env *vm.EVM, pc uint64, op vm.OpCode, gas, cost uint64, memory *vm.Memory, stack *vm.Stack, contract *vm.Contract, depth int, err error) error

CaptureState implements the Tracer interface to trace a single step of VM execution.

func (*Tracer) GetResult

func (jst *Tracer) GetResult() (json.RawMessage, error)

GetResult calls the Javascript 'result' function and returns its value, or any accumulated error

func (*Tracer) Stop

func (jst *Tracer) Stop(err error)

Stop terminates execution of the tracer at the first opportune moment.