colibri_simulateTransaction

Simulates a Transaction before signing it. The input arguments are the same as eth_call, but the result represents the events created when executing the transaction.

EthSimulationInputParam

Decoded input/output parameter for ABI decoding

The Type is defined in src/chains/eth/ssz/verify_data_types.h.

class EthSimulationInputParam(Container):
    name  : String[256]  # parameter name (e.g. "src","wad")
    type  : String[256]  # parameter type (e.g. "address", "uint256")
    value : String[1024] # parameter value as string (e.g. "0xe2e2...", "299")

EthSimulationLogRaw

Container type for decoded ABI input/output parameters Raw log data (same structure as ETH_RECEIPT_DATA_LOG)

The Type is defined in src/chains/eth/ssz/verify_data_types.h.

class EthSimulationLogRaw(Container):
    address : Address           # contract address that emitted the log
    data    : Bytes[1073741824] # event data
    topics  : List [bytes32, 8] # event topics

EthSimulationLog

Container type for raw log data (without ABI decoding) Enhanced log entry for simulation result (Tenderly format).

The Type is defined in src/chains/eth/ssz/verify_data_types.h.

class EthSimulationLog(Container):
    _optmask  : Uint16                              # optional fields mask for future extensions
    anonymous : Boolean                             # whether the event is anonymous (ABI decoding)
    inputs    : List [EthSimulationInputParam, 256] # decoded event inputs (ABI decoding)
    name      : String[256]                         # event name (ABI decoding)
    raw       : EthSimulationLogRaw                 # raw log data

Referenced Types

• EthSimulationInputParam

• EthSimulationLogRaw

EthSimulationTrace

Container type for enhanced simulation log entries with ABI decoding Trace entry for simulation result (Tenderly format).

The Type is defined in src/chains/eth/ssz/verify_data_types.h.

class EthSimulationTrace(Container):
    _optmask      : Uint32                              # optional fields mask
    decodedInput  : List [EthSimulationInputParam, 256] # decoded input parameters (ABI decoding)
    decodedOutput : List [EthSimulationInputParam, 256] # decoded output parameters (ABI decoding)
    from          : Address                             # caller address
    gas           : Uint64                              # gas limit (will be rendered as hex)
    gasUsed       : Uint64                              # gas used (will be rendered as hex)
    input         : Bytes[1073741824]                   # call input data
    method        : String[256]                         # method name (ABI decoding, e.g. "approve")
    output        : Bytes[1073741824]                   # call output data
    subtraces     : Uint32                              # number of subtraces
    to            : Address                             # target address
    traceAddress  : List [uint32Def, 256]               # trace address path (e.g. [0])
    type          : String[32]                          # trace type ("CALL", "CREATE", etc.)
    value         : Uint256                             # ETH value (will be rendered as hex)

Referenced Types

• EthSimulationInputParam

EthSimulationResult

Container type for execution trace entries in simulation results Main simulation result structure (based on Tenderly format).

The Type is defined in src/chains/eth/ssz/verify_data_types.h.

class EthSimulationResult(Container):
    _optmask          : Uint32                          # optional fields mask
    blockNumber       : Uint64                          # block number where simulation was executed
    cumulativeGasUsed : Uint64                          # cumulative gas used (for simulation: same as gasUsed)
    gasUsed           : Uint64                          # gas used by the transaction
    logs              : List [EthSimulationLog, 1024]   # emitted logs
    logsBloom         : ByteVector [256]                # logs bloom filter (future extension)
    status            : Uint8                           # transaction status (0x1 = success, 0x0 = revert) - Tenderly format
    trace             : List [EthSimulationTrace, 4096] # execution trace (future extension)
    type              : Uint8                           # transaction type
    returnValue       : Bytes[1073741824]               # return value of the call

Referenced Types

• EthSimulationLog

• EthSimulationTrace