package ethermint.evm.v1
Get desktop application:
View/edit binary Protocol Buffers messages
service Msg
tx.proto:14Msg defines the evm Msg service.
rpc EthereumTx (, )
tx.proto:16EthereumTx defines a method submitting Ethereum transactions.
rpc UpdateParams (, )
tx.proto:21UpdateParams defined a governance operation for updating the x/evm module parameters. The authority is hard-coded to the Cosmos SDK x/gov module account
message
tx.proto:167MsgUpdateParams defines a Msg for updating the x/evm module parameters.
string authority = 1
authority is the address of the governance account.
optional params = 2
params defines the x/evm parameters to update. NOTE: All parameters must be supplied.
message
tx.proto:180MsgUpdateParamsResponse defines the response structure for executing a MsgUpdateParams message.
(message has no fields)
service Query
query.proto:14Query defines the gRPC querier service.
rpc Account (, )
query.proto:16Account queries an Ethereum account.
message
query.proto:80QueryAccountRequest 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
query.proto:89QueryAccountResponse 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 (, )
query.proto:21CosmosAccount queries an Ethereum account's Cosmos Address.
message
query.proto:100QueryCosmosAccountRequest 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
query.proto:110QueryCosmosAccountResponse 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 number
rpc ValidatorAccount (, )
query.proto:27ValidatorAccount queries an Ethereum account's from a validator consensus Address.
message
query.proto:121QueryValidatorAccountRequest 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
query.proto:131QueryValidatorAccountResponse 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 (, )
query.proto:33Balance queries the balance of a the EVM denomination for a single EthAccount.
message
query.proto:141QueryBalanceRequest 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
query.proto:150QueryBalanceResponse is the response type for the Query/Balance RPC method.
string balance = 1
balance is the balance of the EVM denomination.
rpc Storage (, )
query.proto:38Storage queries the balance of all coins for a single account.
message
query.proto:156QueryStorageRequest 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
query.proto:169QueryStorageResponse is the response type for the Query/Storage RPC method.
string value = 1
value defines the storage state value hash associated with the given key.
rpc Code (, )
query.proto:43Code queries the balance of all coins for a single account.
message
query.proto:175QueryCodeRequest 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
query.proto:185QueryCodeResponse is the response type for the Query/Code RPC method.
bytes code = 1
code represents the code bytes from an ethereum address.
rpc Params (, )
query.proto:48Params queries the parameters of x/evm module.
message
query.proto:210QueryParamsRequest defines the request type for querying x/evm parameters.
(message has no fields)
message
query.proto:213QueryParamsResponse defines the response type for querying x/evm parameters.
optional params = 1
params define the evm module parameters.
rpc EthCall (, )
query.proto:53EthCall implements the `eth_call` rpc api
rpc EstimateGas (, )
query.proto:58EstimateGas implements the `eth_estimateGas` rpc api
message
query.proto:231EstimateGasResponse defines EstimateGas response
uint64 gas = 1
gas returns the estimated gas
rpc TraceTx (, )
query.proto:63TraceTx implements the `debug_traceTransaction` rpc api
message
query.proto:237QueryTraceTxRequest defines TraceTx request
optional msg = 1
msg is the MsgEthereumTx for the requested transaction
optional trace_config = 3
trace_config holds extra parameters to trace functions.
repeated predecessors = 4
predecessors is an array of 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_hash of requested transaction
optional block_time = 7
block_time of requested transaction
bytes proposer_address = 8
proposer_address is the proposer of the requested block
int64 chain_id = 9
chain_id is the the eip155 chain id parsed from the requested block header
message
query.proto:261QueryTraceTxResponse defines TraceTx response
bytes data = 1
data is the response serialized in bytes
rpc TraceBlock (, )
query.proto:68TraceBlock implements the `debug_traceBlockByNumber` and `debug_traceBlockByHash` rpc api
message
query.proto:267QueryTraceBlockRequest defines TraceTx request
repeated txs = 1
txs is an array of messages in the block
optional trace_config = 3
trace_config holds extra parameters to trace functions.
int64 block_number = 5
block_number of the traced block
string block_hash = 6
block_hash (hex) of the traced block
optional block_time = 7
block_time of the traced block
bytes proposer_address = 8
proposer_address is the address of the requested block
int64 chain_id = 9
chain_id is the eip155 chain id parsed from the requested block header
message
query.proto:285QueryTraceBlockResponse defines TraceBlock response
bytes data = 1
data is the response serialized in bytes
rpc BaseFee (, )
query.proto:74BaseFee queries the base fee of the parent block of the current block, it's similar to feemarket module's method, but also checks london hardfork status.
message
query.proto:292QueryBaseFeeRequest defines the request type for querying the EIP1559 base fee.
(message has no fields)
message
query.proto:295QueryBaseFeeResponse returns the EIP1559 base fee.
string base_fee = 1
base_fee is the EIP1559 base fee
message
tx.proto:70AccessListTx is the data of EIP-2930 access list transactions.
string chain_id = 1
chain_id of the destination EVM chain
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
to is the recipient address in hex format
string value = 6
value defines the unsigned integer value of the transaction amount.
bytes data = 7
data is the data payload bytes of the transaction.
repeated accesses = 8
accesses is an array of access tuples
bytes v = 9
v defines the signature value
bytes r = 10
r defines the signature value
bytes s = 11
s define the signature value
message
evm.proto:211AccessTuple is the element type of an access list.
Used in: ,
string address = 1
address is a hex formatted ethereum address
repeated string storage_keys = 2
storage_keys are hex formatted hashes of the storage keys
message
evm.proto:36ChainConfig defines the Ethereum ChainConfig parameters using *sdk.Int values instead of *big.Int.
Used in: ,
string homestead_block = 1
homestead_block switch (nil no fork, 0 = already homestead)
string dao_fork_block = 2
dao_fork_block corresponds to TheDAO hard-fork switch block (nil no fork)
bool dao_fork_support = 3
dao_fork_support defines whether the nodes supports or opposes the DAO hard-fork
string eip150_block = 4
eip150_block: EIP150 implements the Gas price changes (https://github.com/ethereum/EIPs/issues/150) EIP150 HF block (nil no fork)
string eip150_hash = 5
eip150_hash: EIP150 HF hash (needed for header only clients as only gas pricing changed)
string eip155_block = 6
eip155_block: EIP155Block HF block
string eip158_block = 7
eip158_block: EIP158 HF block
string byzantium_block = 8
byzantium_block: Byzantium switch block (nil no fork, 0 = already on byzantium)
string constantinople_block = 9
constantinople_block: Constantinople switch block (nil no fork, 0 = already activated)
string petersburg_block = 10
petersburg_block: Petersburg switch block (nil same as Constantinople)
string istanbul_block = 11
istanbul_block: Istanbul switch block (nil no fork, 0 = already on istanbul)
string muir_glacier_block = 12
muir_glacier_block: Eip-2384 (bomb delay) switch block (nil no fork, 0 = already activated)
string berlin_block = 13
berlin_block: Berlin switch block (nil = no fork, 0 = already on berlin)
string london_block = 17
london_block: London switch block (nil = no fork, 0 = already on london)
string arrow_glacier_block = 18
arrow_glacier_block: Eip-4345 (bomb delay) switch block (nil = no fork, 0 = already activated)
string gray_glacier_block = 20
gray_glacier_block: EIP-5133 (bomb delay) switch block (nil = no fork, 0 = already activated)
string merge_netsplit_block = 21
merge_netsplit_block: Virtual fork after The Merge to use as a network splitter
string shanghai_block = 22
shanghai_block switch block (nil = no fork, 0 = already on shanghai)
string cancun_block = 23
cancun_block switch block (nil = no fork, 0 = already on cancun)
message
tx.proto:105DynamicFeeTx is the data of EIP-1559 dinamic fee transactions.
string chain_id = 1
chain_id of the destination EVM chain
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
to is the hex formatted address of the recipient
string value = 7
value defines the the transaction amount.
bytes data = 8
data is the data payload bytes of the transaction.
repeated accesses = 9
accesses is an array of access tuples
bytes v = 10
v defines the signature value
bytes r = 11
r defines the signature value
bytes s = 12
s define the signature value
message
evm.proto:253EIP712AllowedMsg stores an allowed legacy msg and its eip712 type.
Used in:
string msg_type_url = 1
msg_type_url is a msg's proto type name. ie "/cosmos.bank.v1beta1.MsgSend"
string msg_value_type_name = 2
msg_value_type_name is a name of the eip712 value type. ie "MsgValueSend"
repeated value_types = 3
value_types is a list of msg value types
repeated nested_types = 4
nested_types is a list of msg value nested types
message
evm.proto:277EIP712MsgAttrType is the eip712 type of a single message attribute.
Used in: ,
string name = 1
name
string type = 2
type
message
evm.proto:268EIP712NestedMsgType is the eip712 type of a single message.
Used in:
string name = 1
name of the nested type. ie "Fee", "Coin"
repeated attrs = 2
attrs of the nested type
message
query.proto:219EthCallRequest defines EthCall request
Used as request type in: Query.EstimateGas, Query.EthCall
bytes args = 1
args uses the same json format as the json rpc api.
uint64 gas_cap = 2
gas_cap defines the default gas cap to be used
bytes proposer_address = 3
proposer_address of the requested block in hex format
int64 chain_id = 4
chain_id is the eip155 chain id parsed from the requested block header
message
events.proto:41EventBlockBloom defines an Ethereum block bloom filter event
string bloom = 1
bloom is the bloom filter of the block
message
events.proto:7EventEthereumTx defines the event for an Ethereum transaction
string amount = 1
amount
string eth_hash = 2
eth_hash is the Ethereum hash of the transaction
string index = 3
index of the transaction in the block
string gas_used = 4
gas_used is the amount of gas used by the transaction
string hash = 5
hash is the Tendermint hash of the transaction
string recipient = 6
recipient of the transaction
string eth_tx_failed = 7
eth_tx_failed contains a VM error should it occur
message
events.proto:31EventMessage
string module = 1
module which emits the event
string sender = 2
sender of the message
string tx_type = 3
tx_type is the type of the message
message
events.proto:25EventTxLog defines the event for an Ethereum transaction log
repeated string tx_logs = 1
tx_logs is an array of transaction logs
message
tx.proto:142ExtensionOptionsEthereumTx is an extension option for ethereum transactions
(message has no fields)
message
genesis.proto:20GenesisAccount 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:
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 storage = 3
storage defines the set of state key values for the account.
message
genesis.proto:10GenesisState defines the evm module's genesis state.
repeated accounts = 1
accounts is an array containing the ethereum genesis accounts.
optional params = 2
params defines all the parameters of the module.
message
tx.proto:44LegacyTx is the transaction data of regular Ethereum transactions. NOTE: All non-protected transactions (i.e non EIP155 signed) will fail if the AllowUnprotectedTxs parameter is disabled.
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
to is the hex formatted address of the recipient
string value = 5
value defines the unsigned integer value of the transaction amount.
bytes data = 6
data is 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
message
evm.proto:164Log 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. NOTE: address, topics and data are consensus fields. The rest of the fields are derived, i.e. filled in by the nodes, but not secured by consensus.
Used in: , ,
string address = 1
address of the contract that generated the event
repeated string topics = 2
topics is a list of topics provided by the contract.
bytes data = 3
data which is supplied by the contract, usually ABI-encoded
uint64 block_number = 4
block_number of the block in which the transaction was included
string tx_hash = 5
tx_hash is the transaction hash
uint64 tx_index = 6
tx_index of the transaction in the block
string block_hash = 7
block_hash of the block in which the transaction was included
uint64 index = 8
index of the log in the block
bool removed = 9
removed 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.
message
tx.proto:25MsgEthereumTx encapsulates an Ethereum transaction as an SDK message.
Used as request type in: Msg.EthereumTx
Used as field type in: ,
optional data = 1
data is inner transaction data of the Ethereum transaction
double size = 2
size is the encoded storage size of the transaction (DEPRECATED)
string hash = 3
hash of the transaction in hex format
string from = 4
from is the 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
message
tx.proto:147MsgEthereumTxResponse defines the Msg/EthereumTx response type.
Used as response type in: Msg.EthereumTx, Query.EthCall
string hash = 1
hash of the ethereum transaction 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 logs = 2
logs contains the transaction hash and the proto-compatible ethereum logs.
bytes ret = 3
ret is the 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_used specifies how much gas was consumed by the transaction
message
evm.proto:9Params defines the EVM module parameters
Used in: , ,
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 chain_config = 5
chain_config defines the EVM chain configuration parameters
repeated eip712_allowed_msgs = 6
eip712_allowed_msgs contains list of allowed eip712 msgs and their types
bool allow_unprotected_txs = 7
allow_unprotected_txs defines if replay-protected (i.e non EIP155 signed) transactions can be executed on the state machine.
repeated string enabled_precompiles = 8
enabled_precompiles contains list of hex-encoded evm addresses of enabled precompiled contracts. Precompile must be registered before it can be enabled. enabled_precompiles should be sorted in ascending order and unique. sorting and uniqueness are checked against bytes representation of addresses
message
query.proto:191QueryTxLogsRequest 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 pagination = 2
pagination defines an optional pagination for the request.
message
query.proto:202QueryTxLogsResponse is the response type for the Query/TxLogs RPC method.
repeated logs = 1
logs represents the ethereum logs generated from the given transaction.
optional pagination = 2
pagination defines the pagination in the response.
message
evm.proto:141State represents a single Storage key value pair item.
Used in:
string key = 1
key is the stored key
string value = 2
value is the stored value for the given key
message
evm.proto:221TraceConfig holds extra parameters to trace functions.
Used in: ,
string tracer = 1
tracer is a custom javascript tracer
string timeout = 2
timeout overrides the default timeout of 5 seconds for JavaScript-based tracing calls
uint64 reexec = 3
reexec defines the number of blocks the tracer is willing to go back
bool disable_stack = 5
disable_stack switches stack capture
bool disable_storage = 6
disable_storage switches storage capture
bool debug = 8
debug can be used to print output during capture end
int32 limit = 9
limit defines the maximum length of output, but zero means unlimited
optional overrides = 10
overrides can be used to execute a trace using future fork rules
bool enable_memory = 11
enable_memory switches memory capture
bool enable_return_data = 12
enable_return_data switches the capture of return data
string tracer_json_config = 13
tracer_json_config configures the tracer using a JSON string
message
evm.proto:151TransactionLogs 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:
string hash = 1
hash of the transaction
repeated logs = 2
logs is an array of Logs for the given transaction hash
message
evm.proto:190TxResult 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 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