tracer

Documentation

Overview

Package tracer provides custom tracing capabilities to comply with EIP-4337 specifications for forbidden opcodes.

Index

• type AccessInfo
• type AccessMap
• type BundlerCollectorReturn
• type BundlerErrorReturn
• type CallInfo
• type Counts
• type LogInfo
• type NumberLevelInfo
• type Tracers
  • func NewTracers() (*Tracers, error)

Types

type AccessInfo

type AccessInfo struct {
	Reads  Counts `json:"reads"`
	Writes Counts `json:"writes"`
}

AccessInfo provides context on read and write counts by storage slots.

type AccessMap

type AccessMap = map[common.Address]AccessInfo

type BundlerCollectorReturn

type BundlerCollectorReturn struct {
	NumberLevels []NumberLevelInfo `json:"numberLevels"`
	Keccak       []string          `json:"keccak"`
	Calls        []CallInfo        `json:"calls"`
	Logs         []LogInfo         `json:"logs"`
	Debug        []any             `json:"debug"`
}

BundlerCollectorReturn is the return value from performing an EVM trace with BundlerCollectorTracer.js.

type BundlerErrorReturn

type BundlerErrorReturn struct {
	Reverts            []string `json:"reverts"`
	ValidationOOG      bool     `json:"validationOOG"`
	ExecutionOOG       bool     `json:"executionOOG"`
	UserOperationEvent *LogInfo `json:"userOperationEvent,omitempty"`
	Output             string   `json:"output"`
}

BundlerErrorReturn is the return value from performing an EVM trace with BundlerErrorTracer.js.

type CallInfo

type CallInfo struct {
	// Common
	Type string `json:"type"`

	// Method info
	From   common.Address `json:"from"`
	To     common.Address `json:"to"`
	Method string         `json:"method"`
	Value  any            `json:"value"`
	Gas    float64        `json:"gas"`

	// Exit info
	GasUsed float64 `json:"gasUsed"`
	Data    any     `json:"data"`
}

CallInfo provides context on internal calls made during tracing.

type Counts

type Counts = map[string]float64

type LogInfo

type LogInfo struct {
	Topics []string `json:"topics"`
	Data   string   `json:"data"`
}

LogInfo provides context from LOG opcodes during each step in the EVM trace.

type NumberLevelInfo

type NumberLevelInfo struct {
	Opcodes      Counts    `json:"opcodes"`
	Access       AccessMap `json:"access"`
	ContractSize Counts    `json:"contractSize"`
}

NumberLevelInfo provides context on opcodes and storage access delimited by the use of NUMBER at the EntryPoint.

type Tracers

type Tracers struct {
	BundlerCollectorTracer string
	BundlerErrorTracer     string
}

func NewTracers

func NewTracers() (*Tracers, error)

NewBundlerTracers reads the *Tracer.js files and returns a collection of strings that can be passed to a debug RPC method as a custom tracer.