tracer

Documentation

Overview

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

Index

• Variables
• type AccessInfo
• type AccessMap
• type BundlerCollectorReturn
• type BundlerExecutionReturn
• type CallFromAiMiddlewareInfo
• type CallInfo
• type ContractSizeInfo
• type ContractSizeMap
• type Counts
• type ExtCodeAccessInfoMap
• type HexMap
• type LogInfo
• type Tracers
  • func NewTracers() (*Tracers, error)

Variables

var (
	// Loaded JS tracers for simulating various AiMiddleware methods using debug_traceCall.
	Loaded, _ = NewTracers()
)

Types

type AccessInfo

type AccessInfo struct {
	Reads  HexMap `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 {
	CallsFromAiMiddleware []CallFromAiMiddlewareInfo `json:"callsFromAiMiddleware"`
	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 BundlerExecutionReturn

type BundlerExecutionReturn struct {
	Reverts           []string `json:"reverts"`
	ValidationOOG     bool     `json:"validationOOG"`
	ExecutionOOG      bool     `json:"executionOOG"`
	ExecutionGasLimit float64  `json:"executionGasLimit"`
	AiOperationEvent  *LogInfo `json:"aiOperationEvent,omitempty"`
	Output            string   `json:"output"`
	Error             string   `json:"error"`
}

BundlerExecutionReturn is the return value from performing an EVM trace with BundlerExecutionTracer.js.

type CallFromAiMiddlewareInfo

type CallFromAiMiddlewareInfo struct {
	TopLevelMethodSig     hexutil.Bytes        `json:"topLevelMethodSig"`
	TopLevelTargetAddress common.Address       `json:"topLevelTargetAddress"`
	Opcodes               Counts               `json:"opcodes"`
	Access                AccessMap            `json:"access"`
	ContractSize          ContractSizeMap      `json:"contractSize"`
	ExtCodeAccessInfo     ExtCodeAccessInfoMap `json:"extCodeAccessInfo"`
	OOG                   bool                 `json:"oog"`
}

CallFromAiMiddleware provides context on opcodes and storage access made via the AiMiddleware to AiOperation entities.

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  string         `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 ContractSizeInfo

type ContractSizeInfo struct {
	ContractSize float64 `json:"contractSize"`
	Opcode       string  `json:"opcode"`
}

ContractSizeInfo provides context on the code size and call type used to access upstream contracts.

type ContractSizeMap

type ContractSizeMap map[common.Address]ContractSizeInfo

type Counts

type Counts = map[string]float64

type ExtCodeAccessInfoMap

type ExtCodeAccessInfoMap map[common.Address]string

ExtCodeAccessInfoMap provides context on potentially illegal use of EXTCODESIZE.

type HexMap

type HexMap = map[string]string

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 Tracers

type Tracers struct {
	BundlerCollectorTracer string
	BundlerExecutionTracer 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.