Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
The contracts objects represents the information associated with contract entities.
Returns a list of contract entities on the network.
Return the contract information given an id
Returns a single ContractResult for a contract's function executions at a specific timestamp.
List contract logs from a contract on the network.
The Contract state from a contract on the network
List contracts logs across many contracts on the network
Get the contract actions from a contract on the network for a given transactionId or ethereum transaction hash
Invoke a smart contract
Search the logs across many contracts with multiple contract calls. Chained logs are not
included but can be found by calling /api/v1/contracts/{contractId}/results/{timestamp}
or /api/v1/contracts/results/{transactionId}
. When searching by topic a timestamp parameter must be supplied
and span a time range of at most seven days.
The order is governed by the combination of timestamp and index values. If the index param is omitted, the order is determined by the timestamp only.
Note: The default order for this API is currently DESC
When filtering there are some restrictions enforced to ensure correctness and scalability.
The table below defines the restrictions and support for the endpoint
Query Param | Comparison Operator | Support | Description | Example |
---|---|---|---|---|
index | eq | Y | Single occurrence only. Requires the presence of timestamp | ?index=X |
ne | N | |||
lt(e) | Y | Single occurrence only. Requires the presence of timestamp | ?index=lte:X | |
gt(e) | Y | Single occurrence only. Requires the presence of timestamp | ?index=gte:X | |
timestamp | eq | Y | Single occurrence only. | ?timestamp=Y |
ne | N | |||
lt(e) | Y | Single occurrence only. Optional second timestamp gt(e) | ?timestamp=lte:Y | |
gt(e) | Y | Single occurrence only. Optional second timestamp lt(e) | ?timestamp=gte:Y |
Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.
Contract log index
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The first topic associated with a contract log. Requires a timestamp range also be populated.
The second topic associated with a contract log. Requires a timestamp range also be populated.
The third topic associated with a contract log. Requires a timestamp range also be populated.
The fourth topic associated with a contract log. Requires a timestamp range also be populated.
OK
The hex encoded EVM address of the contract
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
The hex encoded data of the contract log
The index of the contract log in the chain of logs for an execution
A list of hex encoded topics associated with this log event
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
Network entity ID in the format of shard.realm.num
The executed contract that created this contract log
A hex encoded transaction hash
The position of the transaction in the block
Search the logs across many contracts with multiple contract calls. Chained logs are not
included but can be found by calling /api/v1/contracts/{contractId}/results/{timestamp}
or /api/v1/contracts/results/{transactionId}
. When searching by topic a timestamp parameter must be supplied
and span a time range of at most seven days.
The order is governed by the combination of timestamp and index values. If the index param is omitted, the order is determined by the timestamp only.
Note: The default order for this API is currently DESC
When filtering there are some restrictions enforced to ensure correctness and scalability.
The table below defines the restrictions and support for the endpoint
Query Param | Comparison Operator | Support | Description | Example |
---|---|---|---|---|
index | eq | Y | Single occurrence only. Requires the presence of timestamp | ?index=X |
ne | N | |||
lt(e) | Y | Single occurrence only. Requires the presence of timestamp | ?index=lte:X | |
gt(e) | Y | Single occurrence only. Requires the presence of timestamp | ?index=gte:X | |
timestamp | eq | Y | Single occurrence only. | ?timestamp=Y |
ne | N | |||
lt(e) | Y | Single occurrence only. Optional second timestamp gt(e) | ?timestamp=lte:Y | |
gt(e) | Y | Single occurrence only. Optional second timestamp lt(e) | ?timestamp=gte:Y |
Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.
Contract log index
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The first topic associated with a contract log. Requires a timestamp range also be populated.
The second topic associated with a contract log. Requires a timestamp range also be populated.
The third topic associated with a contract log. Requires a timestamp range also be populated.
The fourth topic associated with a contract log. Requires a timestamp range also be populated.
OK
The hex encoded EVM address of the contract
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
The hex encoded data of the contract log
The index of the contract log in the chain of logs for an execution
A list of hex encoded topics associated with this log event
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
Network entity ID in the format of shard.realm.num
The executed contract that created this contract log
A hex encoded transaction hash
The position of the transaction in the block
Returns a list of all contract's slots. If no timestamp is provided, returns the current state.
The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.
The maximum number of items to return
The order in which items are listed
The slot's number
The timestamp at which the contract state is
OK
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
The hex encoded storage slot.
The hex encoded value to the slot. 0x
implies no value written.
Returns a list of all contract entity items on the network.
The ID of the smart contract
The maximum number of items to return
The order in which items are listed
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
Returns a result from EVM execution such as cost-free execution of read-only smart contract queries, gas estimation, and transient simulation of read-write operations. If estimate
field is set to true gas estimation is executed. Currently we support only latest
block.
The table below defines the restrictions and support for the endpoint
Estimate | Operation Type | Mirror Node Version |
---|---|---|
false | static contract state reads for non precompile functions | 0.78+ |
static contract state reads for precompile functions except allowance/isApprovedForAll | 0.78+ | |
static contract state reads for precompile functions with allowance | 0.79+ | |
static contract state reads for precompile functions with isApprovedForAll | 0.81+ | |
non-static contract state reads for non precompile functions | 0.83+ | |
non-static contract state reads for precompile read only functions | 0.83+ | |
true | non-static contract state reads and modifications for non precompile functions except lazy account creation | 0.83+ |
non-static contract state reads and modifications for associate precompile functions | 0.83+ | |
non-static contract state reads and modifications for non precompile functions with lazy account creation | 0.84+ | |
non-static contract state reads and modifications for precompile functions except associate | Not supported |
The operations types which are not currently supported should return 501 error status.
Hexadecimal block number or the string "latest", "pending", "earliest". Defaults to "latest".
Hexadecimal method signature and encoded parameters.
Whether gas estimation is called. Defaults to false.
The 20-byte hexadecimal EVM address the transaction is sent from.
Gas provided for the transaction execution. Defaults to 120000000.
Gas price used for each paid gas.
The 20-byte hexadecimal EVM address the transaction is directed to.
Value sent with this transaction. Defaults to 0.
OK
Result in hexadecimal from executed contract call.
Return the contract information given an id
The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
The contract bytecode in hex during deployment
The contract bytecode in hex after deployment
Returns a list of ContractActions for a contract's function executions for a given transactionId or ethereum transaction hash.
Transaction Id or a 32 byte hash with optional 0x prefix
The index of a contract action
The maximum number of items to return
The order in which items are listed
OK
The nesting depth of the call
The type of the call operation
The type of the call
Network entity ID in the format of shard.realm.num
The entity type of the caller
The EVM address of the caller
Gas cost in tinybars
Gas used in tinybars
The position of the action within the ordered list of actions
The hex encoded input data
Network entity ID in the format of shard.realm.num
The entity type of the recipient
The hex encoded result data
The type of the result data
A network entity encoded as an EVM address in hex.
The value of the transaction in tinybars
Returns a single ContractResult for a contract's function executions at a specific timestamp.
The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.
The timestamp at which the associated transaction reached consensus
OK
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The number of tinybars sent to the function
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
The hex encoded chain_id of the wrapped ethereum transaction
Network entity ID in the format of shard.realm.num
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
The message when an error occurs during smart contract execution
The hex encoded initcode of a failed contract create transaction
A network entity encoded as an EVM address in hex.
The hex encoded parameters passed to the function
The maximum units of gas allowed for contract execution
The hex encoded gas_price of the wrapped ethereum transaction
The units of gas used to execute contract
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The result of the transaction
The hex encoded signature_s of the wrapped ethereum transaction
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
A network entity encoded as an EVM address in hex.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded chain_id of the wrapped ethereum transaction
The hex encoded initcode of a failed contract create transaction
The hex encoded gas_price of the wrapped ethereum transaction
The hex encoded transaction hash
The hex encoded EVM address of the contract
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
The hex encoded data of the contract log
The index of the contract log in the chain of logs for an execution
A list of hex encoded topics associated with this log event
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The hex encoded signature_s of the wrapped ethereum transaction
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
The hex encoded storage slot changed.
The hex encoded value read from the storage slot.
The hex encoded value written to the slot. null
implies no value written.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
List contract results from all contracts on the network
Get the contract result from a contract on the network for a given transactionId or ethereum transaction hash
Returns a list of all ContractResults for a contract's function executions.
Returns a list of all ContractResults for all contract's function executions.
Account ID or EVM address executing the contract
The block's hash
The block's number
Whether to include child transactions or not
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The transaction index in the block
OK
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The number of tinybars sent to the function
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
The hex encoded chain_id of the wrapped ethereum transaction
Network entity ID in the format of shard.realm.num
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
The message when an error occurs during smart contract execution
The hex encoded initcode of a failed contract create transaction
A network entity encoded as an EVM address in hex.
The hex encoded parameters passed to the function
The maximum units of gas allowed for contract execution
The hex encoded gas_price of the wrapped ethereum transaction
The units of gas used to execute contract
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The result of the transaction
The hex encoded signature_s of the wrapped ethereum transaction
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
A network entity encoded as an EVM address in hex.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
Returns a list of all ContractResults for a contract's function executions.
The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.
The block's hash
The block's number
Account ID or EVM address executing the contract
Whether to include child transactions or not
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The transaction index in the block
OK
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The number of tinybars sent to the function
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
The hex encoded chain_id of the wrapped ethereum transaction
Network entity ID in the format of shard.realm.num
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
The message when an error occurs during smart contract execution
The hex encoded initcode of a failed contract create transaction
A network entity encoded as an EVM address in hex.
The hex encoded parameters passed to the function
The maximum units of gas allowed for contract execution
The hex encoded gas_price of the wrapped ethereum transaction
The units of gas used to execute contract
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The result of the transaction
The hex encoded signature_s of the wrapped ethereum transaction
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
A network entity encoded as an EVM address in hex.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
Returns a single ContractResult for a contract's function executions for a given transactionId or ethereum transaction hash.
Transaction Id or a 32 byte hash with optional 0x prefix
Filter the query result by the nonce of the transaction. A zero nonce represents user submitted transactions while a non-zero nonce is generated by main nodes. The filter honors the last value. Default is 0 when not specified.
OK
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The number of tinybars sent to the function
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
The hex encoded chain_id of the wrapped ethereum transaction
Network entity ID in the format of shard.realm.num
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
The message when an error occurs during smart contract execution
The hex encoded initcode of a failed contract create transaction
A network entity encoded as an EVM address in hex.
The hex encoded parameters passed to the function
The maximum units of gas allowed for contract execution
The hex encoded gas_price of the wrapped ethereum transaction
The units of gas used to execute contract
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The result of the transaction
The hex encoded signature_s of the wrapped ethereum transaction
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
A network entity encoded as an EVM address in hex.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded chain_id of the wrapped ethereum transaction
The hex encoded initcode of a failed contract create transaction
The hex encoded gas_price of the wrapped ethereum transaction
The hex encoded transaction hash
The hex encoded EVM address of the contract
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
The hex encoded data of the contract log
The index of the contract log in the chain of logs for an execution
A list of hex encoded topics associated with this log event
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The hex encoded signature_s of the wrapped ethereum transaction
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
The hex encoded storage slot changed.
The hex encoded value read from the storage slot.
The hex encoded value written to the slot. null
implies no value written.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction