package ethermint.evm.v1

Get desktop application:
View/edit binary Protocol Buffers messages

Msg defines the evm Msg service.

• rpc EthereumTx (MsgEthereumTx, MsgEthereumTxResponse)

  tx.proto:15

  EthereumTx defines a method submitting Ethereum transactions.

Query defines the gRPC querier service.

• rpc Account (QueryAccountRequest, QueryAccountResponse)

  query.proto:16

  Account queries an Ethereum account.

  message QueryAccountRequest

  query.proto:77

  QueryAccountRequest is the request type for the Query/Account RPC method.

  • string address = 1

    address is the ethereum hex address to query the account for.

  message QueryAccountResponse

  query.proto:86

  QueryAccountResponse is the response type for the Query/Account RPC method.

  • string balance = 1

    balance is the balance of the EVM denomination.

  • string code_hash = 2

    code hash is the hex-formatted code bytes from the EOA.

  • uint64 nonce = 3

    nonce is the account's sequence number.

• rpc CosmosAccount (QueryCosmosAccountRequest, QueryCosmosAccountResponse)

  query.proto:21

  CosmosAccount queries an Ethereum account's Cosmos Address.

  message QueryCosmosAccountRequest

  query.proto:97

  QueryCosmosAccountRequest is the request type for the Query/CosmosAccount RPC method.

  • string address = 1

    address is the ethereum hex address to query the account for.

  message QueryCosmosAccountResponse

  query.proto:107

  QueryCosmosAccountResponse is the response type for the Query/CosmosAccount RPC method.

  • string cosmos_address = 1

    cosmos_address is the cosmos address of the account.

  • uint64 sequence = 2

    sequence is the account's sequence number.

  • uint64 account_number = 3

    account_number is the account numbert

• rpc ValidatorAccount (QueryValidatorAccountRequest, QueryValidatorAccountResponse)

  query.proto:28

  ValidatorAccount queries an Ethereum account's from a validator consensus Address.

  message QueryValidatorAccountRequest

  query.proto:118

  QueryValidatorAccountRequest is the request type for the Query/ValidatorAccount RPC method.

  • string cons_address = 1

    cons_address is the validator cons address to query the account for.

  message QueryValidatorAccountResponse

  query.proto:128

  QueryValidatorAccountResponse is the response type for the Query/ValidatorAccount RPC method.

  • string account_address = 1

    account_address is the cosmos address of the account in bech32 format.

  • uint64 sequence = 2

    sequence is the account's sequence number.

  • uint64 account_number = 3

    account_number is the account number

• rpc Balance (QueryBalanceRequest, QueryBalanceResponse)

  query.proto:36

  Balance queries the balance of a the EVM denomination for a single EthAccount.

  message QueryBalanceRequest

  query.proto:138

  QueryBalanceRequest is the request type for the Query/Balance RPC method.

  • string address = 1

    address is the ethereum hex address to query the balance for.

  message QueryBalanceResponse

  query.proto:147

  QueryBalanceResponse is the response type for the Query/Balance RPC method.

  • string balance = 1

    balance is the balance of the EVM denomination.

• rpc Storage (QueryStorageRequest, QueryStorageResponse)

  query.proto:41

  Storage queries the balance of all coins for a single account.

  message QueryStorageRequest

  query.proto:153

  QueryStorageRequest is the request type for the Query/Storage RPC method.

  • string address = 1

    / address is the ethereum hex address to query the storage state for.

  • string key = 2

    key defines the key of the storage state

  message QueryStorageResponse

  query.proto:166

  QueryStorageResponse is the response type for the Query/Storage RPC method.

  • string value = 1

    key defines the storage state value hash associated with the given key.

• rpc Code (QueryCodeRequest, QueryCodeResponse)

  query.proto:46

  Code queries the balance of all coins for a single account.

  message QueryCodeRequest

  query.proto:172

  QueryCodeRequest is the request type for the Query/Code RPC method.

  • string address = 1

    address is the ethereum hex address to query the code for.

  message QueryCodeResponse

  query.proto:182

  QueryCodeResponse is the response type for the Query/Code RPC method.

  • bytes code = 1

    code represents the code bytes from an ethereum address.

• rpc Params (QueryParamsRequest, QueryParamsResponse)

  query.proto:51

  Params queries the parameters of x/evm module.

  message QueryParamsRequest

  query.proto:207

  QueryParamsRequest defines the request type for querying x/evm parameters.

  (message has no fields)

  message QueryParamsResponse

  query.proto:210

  QueryParamsResponse defines the response type for querying x/evm parameters.

  • optional Params params = 1

    params define the evm module parameters.

• rpc EthCall (EthCallRequest, MsgEthereumTxResponse)

  query.proto:56

  EthCall implements the `eth_call` rpc api

• rpc EstimateGas (EthCallRequest, EstimateGasResponse)

  query.proto:61

  EstimateGas implements the `eth_estimateGas` rpc api

  message EstimateGasResponse

  query.proto:224

  EstimateGasResponse defines EstimateGas response

  • uint64 gas = 1

    the estimated gas

• rpc TraceTx (QueryTraceTxRequest, QueryTraceTxResponse)

  query.proto:66

  TraceTx implements the `debug_traceTransaction` rpc api

  message QueryTraceTxRequest

  query.proto:230

  QueryTraceTxRequest defines TraceTx request

  • optional MsgEthereumTx msg = 1

    msgEthereumTx for the requested transaction

  • uint64 tx_index = 2

    transaction index

  • optional TraceConfig trace_config = 3

    TraceConfig holds extra parameters to trace functions.

  • repeated MsgEthereumTx predecessors = 4

    the predecessor transactions included in the same block need to be replayed first to get correct context for tracing.

  • int64 block_number = 5

    block number of requested transaction

  • string block_hash = 6

    block hex hash of requested transaction

  • optional google.protobuf.Timestamp block_time = 7

    block time of requested transaction

  message QueryTraceTxResponse

  query.proto:249

  QueryTraceTxResponse defines TraceTx response

  • bytes data = 1

    response serialized in bytes

• rpc TraceBlock (QueryTraceBlockRequest, QueryTraceBlockResponse)

  query.proto:71

  TraceBlock implements the `debug_traceBlockByNumber` and `debug_traceBlockByHash` rpc api

  message QueryTraceBlockRequest

  query.proto:255

  QueryTraceBlockRequest defines TraceTx request

  • repeated MsgEthereumTx txs = 1

    txs messages in the block

  • optional TraceConfig trace_config = 3

    TraceConfig holds extra parameters to trace functions.

  • int64 block_number = 5

    block number

  • string block_hash = 6

    block hex hash

  • optional google.protobuf.Timestamp block_time = 7

    block time

  message QueryTraceBlockResponse

  query.proto:269

  QueryTraceBlockResponse defines TraceBlock response

  • bytes data = 1

AccessListTx is the data of EIP-2930 access list transactions.

• string chain_id = 1

  destination EVM chain ID

• uint64 nonce = 2

  nonce corresponds to the account nonce (transaction sequence).

• string gas_price = 3

  gas price defines the value for each gas unit

• uint64 gas = 4

  gas defines the gas limit defined for the transaction.

• string to = 5

  hex formatted address of the recipient

• string value = 6

  value defines the unsigned integer value of the transaction amount.

• bytes data = 7

  input defines the data payload bytes of the transaction.

• repeated AccessTuple accesses = 8

• bytes v = 9

  v defines the signature value

• bytes r = 10

  r defines the signature value

• bytes s = 11

  s define the signature value

AccessTuple is the element type of an access list.

Used in: AccessListTx, DynamicFeeTx

• string address = 1

  hex formatted ethereum address

• repeated string storage_keys = 2

  hex formatted hashes of the storage keys

ChainConfig defines the Ethereum ChainConfig parameters using *sdk.Int values instead of *big.Int.

Used in: Params, TraceConfig

• string homestead_block = 1

  Homestead switch block (nil no fork, 0 = already homestead)

• string dao_fork_block = 2

  TheDAO hard-fork switch block (nil no fork)

• bool dao_fork_support = 3

  Whether the nodes supports or opposes the DAO hard-fork

• string eip150_block = 4

  EIP150 implements the Gas price changes (https://github.com/ethereum/EIPs/issues/150) EIP150 HF block (nil no fork)

• string eip150_hash = 5

  EIP150 HF hash (needed for header only clients as only gas pricing changed)

• string eip155_block = 6

  EIP155Block HF block

• string eip158_block = 7

  EIP158 HF block

• string byzantium_block = 8

  Byzantium switch block (nil no fork, 0 = already on byzantium)

• string constantinople_block = 9

  Constantinople switch block (nil no fork, 0 = already activated)

• string petersburg_block = 10

  Petersburg switch block (nil same as Constantinople)

• string istanbul_block = 11

  Istanbul switch block (nil no fork, 0 = already on istanbul)

• string muir_glacier_block = 12

  Eip-2384 (bomb delay) switch block (nil no fork, 0 = already activated)

• string berlin_block = 13

  Berlin switch block (nil = no fork, 0 = already on berlin)

• string london_block = 17

  London switch block (nil = no fork, 0 = already on london)

DynamicFeeTx is the data of EIP-1559 dinamic fee transactions.

• string chain_id = 1

  destination EVM chain ID

• uint64 nonce = 2

  nonce corresponds to the account nonce (transaction sequence).

• string gas_tip_cap = 3

  gas tip cap defines the max value for the gas tip

• string gas_fee_cap = 4

  gas fee cap defines the max value for the gas fee

• uint64 gas = 5

  gas defines the gas limit defined for the transaction.

• string to = 6

  hex formatted address of the recipient

• string value = 7

  value defines the the transaction amount.

• bytes data = 8

  input defines the data payload bytes of the transaction.

• repeated AccessTuple accesses = 9

• bytes v = 10

  v defines the signature value

• bytes r = 11

  r defines the signature value

• bytes s = 12

  s define the signature value

EthCallRequest defines EthCall request

Used as request type in: Query.EstimateGas, Query.EthCall

• bytes args = 1

  same json format as the json rpc api.

• uint64 gas_cap = 2

  the default gas cap to be used

(message has no fields)

GenesisAccount defines an account to be initialized in the genesis state. Its main difference between with Geth's GenesisAccount is that it uses a custom storage type and that it doesn't contain the private key field.

Used in: GenesisState

• string address = 1

  address defines an ethereum hex formated address of an account

• string code = 2

  code defines the hex bytes of the account code.

• repeated State storage = 3

  storage defines the set of state key values for the account.

GenesisState defines the evm module's genesis state.

• repeated GenesisAccount accounts = 1

  accounts is an array containing the ethereum genesis accounts.

• optional Params params = 2

  params defines all the parameters of the module.

LegacyTx is the transaction data of regular Ethereum transactions.

• uint64 nonce = 1

  nonce corresponds to the account nonce (transaction sequence).

• string gas_price = 2

  gas price defines the value for each gas unit

• uint64 gas = 3

  gas defines the gas limit defined for the transaction.

• string to = 4

  hex formatted address of the recipient

• string value = 5

  value defines the unsigned integer value of the transaction amount.

• bytes data = 6

  input defines the data payload bytes of the transaction.

• bytes v = 7

  v defines the signature value

• bytes r = 8

  r defines the signature value

• bytes s = 9

  s define the signature value

Log represents an protobuf compatible Ethereum Log that defines a contract log event. These events are generated by the LOG opcode and stored/indexed by the node.

Consensus fields:

Used in: MsgEthereumTxResponse, QueryTxLogsResponse, TransactionLogs

• string address = 1

  address of the contract that generated the event

• repeated string topics = 2

  list of topics provided by the contract.

• bytes data = 3

  supplied by the contract, usually ABI-encoded

• uint64 block_number = 4

  block in which the transaction was included

• string tx_hash = 5

  hash of the transaction

• uint64 tx_index = 6

  index of the transaction in the block

• string block_hash = 7

  hash of the block in which the transaction was included

• uint64 index = 8

  index of the log in the block

• bool removed = 9

  The Removed field is true if this log was reverted due to a chain reorganisation. You must pay attention to this field if you receive logs through a filter query.

MsgEthereumTx encapsulates an Ethereum transaction as an SDK message.

Used as request type in: Msg.EthereumTx

Used as field type in: QueryTraceBlockRequest, QueryTraceTxRequest

• optional google.protobuf.Any data = 1

  inner transaction data

  caches

• double size = 2

  encoded storage size of the transaction

• string hash = 3

  transaction hash in hex format

• string from = 4

  ethereum signer address in hex format. This address value is checked against the address derived from the signature (V, R, S) using the secp256k1 elliptic curve

MsgEthereumTxResponse defines the Msg/EthereumTx response type.

Used as response type in: Msg.EthereumTx, Query.EthCall

• string hash = 1

  ethereum transaction hash in hex format. This hash differs from the Tendermint sha256 hash of the transaction bytes. See https://github.com/tendermint/tendermint/issues/6539 for reference

• repeated Log logs = 2

  logs contains the transaction hash and the proto-compatible ethereum logs.

• bytes ret = 3

  returned data from evm function (result or data supplied with revert opcode)

• string vm_error = 4

  vm error is the error returned by vm execution

• uint64 gas_used = 5

  gas consumed by the transaction

Params defines the EVM module parameters

Used in: GenesisState, QueryParamsResponse

• string evm_denom = 1

  evm denom represents the token denomination used to run the EVM state transitions.

• bool enable_create = 2

  enable create toggles state transitions that use the vm.Create function

• bool enable_call = 3

  enable call toggles state transitions that use the vm.Call function

• repeated int64 extra_eips = 4

  extra eips defines the additional EIPs for the vm.Config

• optional ChainConfig chain_config = 5

  chain config defines the EVM chain configuration parameters

QueryTxLogsRequest is the request type for the Query/TxLogs RPC method.

• string hash = 1

  hash is the ethereum transaction hex hash to query the logs for.

• optional cosmos.base.query.v1beta1.PageRequest pagination = 2

  pagination defines an optional pagination for the request.

QueryTxLogs is the response type for the Query/TxLogs RPC method.

• repeated Log logs = 1

  logs represents the ethereum logs generated from the given transaction.

• optional cosmos.base.query.v1beta1.PageResponse pagination = 2

  pagination defines the pagination in the response.

State represents a single Storage key value pair item.

Used in: GenesisAccount

• string key = 1

• string value = 2

TraceConfig holds extra parameters to trace functions.

Used in: QueryTraceBlockRequest, QueryTraceTxRequest

• string tracer = 1

  custom javascript tracer

• string timeout = 2

  overrides the default timeout of 5 seconds for JavaScript-based tracing calls

• uint64 reexec = 3

  number of blocks the tracer is willing to go back

• bool disable_stack = 5

  disable stack capture

• bool disable_storage = 6

  disable storage capture

• bool debug = 8

  print output during capture end

• int32 limit = 9

  maximum length of output, but zero means unlimited

• optional ChainConfig overrides = 10

  Chain overrides, can be used to execute a trace using future fork rules

• bool enable_memory = 11

  enable memory capture

• bool enable_return_data = 12

  enable return data capture

TransactionLogs define the logs generated from a transaction execution with a given hash. It it used for import/export data as transactions are not persisted on blockchain state after an upgrade.

Used in: TxResult

• string hash = 1

• repeated Log logs = 2

TxResult stores results of Tx execution.

• string contract_address = 1

  contract_address contains the ethereum address of the created contract (if any). If the state transition is an evm.Call, the contract address will be empty.

• bytes bloom = 2

  bloom represents the bloom filter bytes

• optional TransactionLogs tx_logs = 3

  tx_logs contains the transaction hash and the proto-compatible ethereum logs.

• bytes ret = 4

  ret defines the bytes from the execution.

• bool reverted = 5

  reverted flag is set to true when the call has been reverted

• uint64 gas_used = 6

  gas_used notes the amount of gas consumed while execution