Smart Contracts

Overview

The Smart Contracts endpoints in the Hedera Mirror Node REST API allows developers to query smart contract metadata, execution results, state changes, and logs. These endpoints are essential for tracking contract interactions, retrieving transaction results, and debugging contract executions on the Hedera network.

Endpoints

The following endpoints are available for the Smart Contracts object:

Endpoint	Description
GET /api/v1/contracts	Retrieves a list of smart contract entities on the network.
GET /api/v1/contracts/{contractIdOrAddress}	Fetches details of a specific contract by ID.
GET /api/v1/contracts/results/{transactionIdOrhash}	Retrieves execution results for a specific contract transaction ID.
GET /api/v1/contracts/{contractIdOrAddress}/results	Retrieves execution results for a specific contract.
GET /api/v1/contracts/{id}/state	Fetches the state of a contract.
GET /api/v1/contracts/results	Lists execution results for all contracts.
GET /api/v1/contracts/results/{transactionIdOrHash}/results	Get contract actions by transaction ID or transaction hash.
GET /api/v1/contracts/results/{timestamp}	Retrieves execution results for a contract at a given timestamp.
GET /api/v1/contracts/logs	Lists logs emitted from contracts.
GET /api/v1/contracts/{id}/results/logs	Fetches logs for a specific contract.
GET /api/v1/contracts/{id}/results/opcodes	Get the opcode traces for historical transactions
POST /api/v1/contracts/call	Invokes a smart contract method.

Smart Contracts

List contract entities on network

get

Returns a list of all contract entity items on the network.

Query parameters

contract.idstringoptional

The ID of the smart contract

Example: {"summary":"--","value":""}

Pattern: ^((gte?|lte?|eq|ne)\:)?(\d{1,10}\.\d{1,10}\.)?\d{1,10}|(\d{1,10}\.){0,2}[A-Fa-f0-9]{40}$

limitinteger · int32 · min: 1 · max: 100 · default: 25optional

The maximum number of items to return

Example: 2

orderundefined · enum · default: "desc"optional

The order in which items are listed

Example: asc

Options: asc, desc

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts'

200

400

200

{
  "contracts": [
    {
      "admin_key": {
        "_type": "ProtobufEncoded",
        "key": "15706b229b3ba33d4a5a41ff54ce1cfe0a3d308672a33ff382f81583e02bd743"
      },
      "auto_renew_account": "0.0.2",
      "auto_renew_period": 7776000,
      "contract_id": "0.0.2",
      "created_timestamp": "1586567700.453054000",
      "deleted": false,
      "evm_address": "0000000000000000000000000000000000001f41",
      "expiration_timestamp": "1586567700.453054000",
      "file_id": "0.0.2",
      "max_automatic_token_associations": 1,
      "memo": "contract memo",
      "obtainer_id": "0.0.2",
      "permanent_removal": true,
      "proxy_account_id": "0.0.2",
      "timestamp": {
        "from": null,
        "to": null
      }
    }
  ],
  "links": {
    "next": null
  }
}

OK

Response Item	Description
admin_key	The admin key of the contract, if specified
auto_renew_account	The account paying the auto renew fees, if set
auto_renew_period	The period at which the contract auto renews
bytecode	The bytecode of the contract
contract_id	The contract ID
created_timestamp	The timestamp the contract was created at
deleted	Whether or not the contract is deleted
evm_address	The EVM address of the contract
expiration_timestamp	The timestamp of when the contract is set to expire
file_id	The ID of the file that stored the contract bytecode
max_automatic_token_associations	The number of automatic token association slots
memo	The memo of the contract, if specified
obtainer_id	The ID of the account or contract that will receive any remaining balance when the contract is deleted
permanent_removal	Set to true when the system expires a contract
proxy_account_id	The proxy account ID (disabled)
solidity_address	The solidity address
timestamp	The period for which the attributes are valid for

Get contract by id

get

Return the contract information given an id

Path parameters

contractIdOrAddressstringrequired

The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40})$

Query parameters

timestampstring[]optional

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Example: {"summary":"--","value":""}

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/{contractIdOrAddress}'

200

400

404

200

{
  "admin_key": {
    "_type": "ProtobufEncoded",
    "key": "15706b229b3ba33d4a5a41ff54ce1cfe0a3d308672a33ff382f81583e02bd743"
  },
  "auto_renew_account": "0.0.2",
  "auto_renew_period": 7776000,
  "contract_id": "0.0.2",
  "created_timestamp": "1586567700.453054000",
  "deleted": false,
  "evm_address": "0000000000000000000000000000000000001f41",
  "expiration_timestamp": "1586567700.453054000",
  "file_id": "0.0.2",
  "max_automatic_token_associations": 1,
  "memo": "contract memo",
  "obtainer_id": "0.0.2",
  "permanent_removal": true,
  "proxy_account_id": "0.0.2",
  "timestamp": {
    "from": null,
    "to": null
  },
  "bytecode": "0x01021a1fdc9b",
  "runtime_bytecode": "0x0302fa1ad39c"
}

OK

Get the contract result from a contract on the network for a given transactionId or ethereum transaction hash

get

Returns a single ContractResult for a contract's function executions for a given transactionId or ethereum transaction hash.

Path parameters

transactionIdOrHashstringrequired

Transaction Id or a 32 byte hash with optional 0x prefix

Example: {"value":"0.0.10-1234567890-000000000"}

Pattern: ^(0x)?[A-Fa-f0-9]{64}|(\d{1,10})\.(\d{1,10})\.(\d{1,10})-(\d{1,19})-(\d{1,9})$

Query parameters

nonceinteger · int32 · default: 0optional

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.

Example: 1

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/results/{transactionIdOrHash}'

200

206

400

404

200

{
  "access_list": "0xabcd",
  "address": "0x25fe26adc577cc89172e6156c9e24f7b9751b762",
  "amount": 10,
  "block_gas_used": 2000,
  "block_hash": "0x6ceecd8bb224da491",
  "block_number": 10,
  "bloom": null,
  "call_result": "0x2b048531b38d2882e86044bc972e940ee0a01938",
  "chain_id": "0x0127",
  "contract_id": "0.0.2",
  "created_contract_ids": [
    "0.0.2"
  ],
  "error_message": "Out of gas",
  "failed_initcode": "0x856739",
  "from": "0x0000000000000000000000000000000000001f41",
  "function_parameters": "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b",
  "gas_consumed": 35000,
  "gas_limit": 100000,
  "gas_price": "0x4a817c800",
  "gas_used": 80000,
  "hash": "0x3531396130303866616264653464",
  "max_fee_per_gas": "0x5",
  "max_priority_fee_per_gas": "0x100",
  "nonce": 1,
  "r": "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043",
  "result": "SUCCESS",
  "s": "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355",
  "status": 1,
  "timestamp": "1586567700.453054000",
  "to": "0x0000000000000000000000000000000000001f41",
  "transaction_index": 1,
  "type": 2,
  "v": 1,
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "bloom": null,
      "contract_id": "0.0.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "index": 0,
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ]
    }
  ],
  "state_changes": [
    {
      "address": "0000000000000000000000000000000000001f41",
      "contract_id": "0.0.2",
      "slot": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "value_read": "0x97c1fc0a6ed5551bc831571325e9bdb365d06803100dc20648640ba24ce69750",
      "value_written": "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
    }
  ]
}

OK

List contract results from a contract on the network

get

Returns a list of all ContractResults for a contract's function executions.

Path parameters

contractIdOrAddressstringrequired

The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40})$

Query parameters

block.hashstringoptional

The block's hash. If multiple values are provided the last value will be the only value used.

Example: {"summary":"--","value":""}

Pattern: ^(eq:)?(0x)?([0-9A-Fa-f]{64}|[0-9A-Fa-f]{96})$

block.numberstringoptional

The block's number

Example: {"summary":"--","value":""}

Pattern: ^(eq:)?(\d{1,19}|0x[a-fA-f0-9]+)$

fromstringoptional

Account ID or EVM address executing the contract

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}|(0x)?[A-Fa-f0-9]{40}$

internalboolean · default: falseoptional

Whether to include child transactions or not

Example: true

limitinteger · int32 · min: 1 · max: 100 · default: 25optional

The maximum number of items to return

Example: 2

orderundefined · enum · default: "desc"optional

The order in which items are listed

Example: asc

Options: asc, desc

timestampstring[]optional

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Example: {"summary":"--","value":""}

transaction.indexinteger · int32optional

The transaction index in the block

Example: 1

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/{contractIdOrAddress}/results'

200

400

404

200

{
  "results": [
    {
      "access_list": "0xabcd",
      "address": "0x25fe26adc577cc89172e6156c9e24f7b9751b762",
      "amount": 10,
      "block_gas_used": 2000,
      "block_hash": "0x6ceecd8bb224da491",
      "block_number": 10,
      "bloom": null,
      "call_result": "0x2b048531b38d2882e86044bc972e940ee0a01938",
      "chain_id": "0x0127",
      "contract_id": "0.0.2",
      "created_contract_ids": [
        "0.0.2"
      ],
      "error_message": "Out of gas",
      "failed_initcode": "0x856739",
      "from": "0x0000000000000000000000000000000000001f41",
      "function_parameters": "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b",
      "gas_consumed": 35000,
      "gas_limit": 100000,
      "gas_price": "0x4a817c800",
      "gas_used": 80000,
      "hash": "0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1",
      "max_fee_per_gas": "0x5",
      "max_priority_fee_per_gas": "0x100",
      "nonce": 1,
      "r": "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043",
      "result": "SUCCESS",
      "s": "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355",
      "status": 1,
      "timestamp": "1586567700.453054000",
      "to": "0x0000000000000000000000000000000000001f41",
      "transaction_index": 1,
      "type": 2,
      "v": 1
    }
  ],
  "links": {
    "next": null
  }
}

OK

The contract state from a contract on the network

get

Returns a list of all contract's slots. If no timestamp is provided, returns the current state.

Path parameters

contractIdOrAddressstringrequired

The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40})$

Query parameters

limitinteger · int32 · min: 1 · max: 100 · default: 25optional

The maximum number of items to return

Example: 2

orderundefined · enum · default: "asc"optional

The order in which items are listed

Example: desc

Options: asc, desc

slotstringoptional

The slot's number

Example: {"summary":"--","value":""}

Pattern: ^((eq|gte?|lte?)\:)?(0x)?[0-9A-Fa-f]{1,64}$

timestampstring[]optional

The consensus timestamp of the contract state as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Example: {"summary":"--","value":""}

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/{contractIdOrAddress}/state'

200

400

404

200

{
  "state": [
    {
      "address": "0000000000000000000000000000000000001f41",
      "contract_id": "0.0.2",
      "timestamp": "1586567700.453054000",
      "slot": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "value": "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
    }
  ],
  "links": {
    "next": null
  }
}

OK

List contract results from all contracts on the network

get

Returns a list of all ContractResults for all contract's function executions.

Query parameters

fromstringoptional

Account ID or EVM address executing the contract

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}|(0x)?[A-Fa-f0-9]{40}$

block.hashstringoptional

The block's hash. If multiple values are provided the last value will be the only value used.

Example: {"summary":"--","value":""}

Pattern: ^(eq:)?(0x)?([0-9A-Fa-f]{64}|[0-9A-Fa-f]{96})$

block.numberstringoptional

The block's number

Example: {"summary":"--","value":""}

Pattern: ^(eq:)?(\d{1,19}|0x[a-fA-f0-9]+)$

internalboolean · default: falseoptional

Whether to include child transactions or not

Example: true

limitinteger · int32 · min: 1 · max: 100 · default: 25optional

The maximum number of items to return

Example: 2

orderundefined · enum · default: "desc"optional

The order in which items are listed

Example: asc

Options: asc, desc

timestampstring[]optional

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Example: {"summary":"--","value":""}

transaction.indexinteger · int32optional

The transaction index in the block

Example: 1

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/results'

200

400

200

{
  "results": [
    {
      "access_list": "0xabcd",
      "address": "0x25fe26adc577cc89172e6156c9e24f7b9751b762",
      "amount": 10,
      "block_gas_used": 2000,
      "block_hash": "0x6ceecd8bb224da491",
      "block_number": 10,
      "bloom": null,
      "call_result": "0x2b048531b38d2882e86044bc972e940ee0a01938",
      "chain_id": "0x0127",
      "contract_id": "0.0.2",
      "created_contract_ids": [
        "0.0.2"
      ],
      "error_message": "Out of gas",
      "failed_initcode": "0x856739",
      "from": "0x0000000000000000000000000000000000001f41",
      "function_parameters": "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b",
      "gas_consumed": 35000,
      "gas_limit": 100000,
      "gas_price": "0x4a817c800",
      "gas_used": 80000,
      "hash": "0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1",
      "max_fee_per_gas": "0x5",
      "max_priority_fee_per_gas": "0x100",
      "nonce": 1,
      "r": "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043",
      "result": "SUCCESS",
      "s": "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355",
      "status": 1,
      "timestamp": "1586567700.453054000",
      "to": "0x0000000000000000000000000000000000001f41",
      "transaction_index": 1,
      "type": 2,
      "v": 1
    }
  ],
  "links": {
    "next": null
  }
}

OK

Get the contract actions from a contract on the network for a given transactionId or ethereum transaction hash

get

Returns a list of ContractActions for a contract's function executions for a given transactionId or ethereum transaction hash.

Path parameters

transactionIdOrHashstringrequired

Transaction Id or a 32 byte hash with optional 0x prefix

Example: {"value":"0.0.10-1234567890-000000000"}

Pattern: ^(0x)?[A-Fa-f0-9]{64}|(\d{1,10})\.(\d{1,10})\.(\d{1,10})-(\d{1,19})-(\d{1,9})$

Query parameters

indexstringoptional

The index of a contract action

Example: {"summary":"--","value":""}

Pattern: ^((gte?|lte?|eq|ne)\:)?\d{1,10}$

limitinteger · int32 · min: 1 · max: 100 · default: 25optional

The maximum number of items to return

Example: 2

orderundefined · enum · default: "asc"optional

The order in which items are listed

Example: desc

Options: asc, desc

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/results/{transactionIdOrHash}/actions'

200

400

404

200

{
  "actions": [
    {
      "call_depth": 1,
      "call_operation_type": "CALL",
      "call_type": "CALL",
      "caller": "0.0.2",
      "caller_type": "ACCOUNT",
      "from": "0x0000000000000000000000000000000000000065",
      "gas": 50000,
      "gas_used": 50000,
      "index": 0,
      "input": "0x123456",
      "recipient": "0.0.2",
      "recipient_type": "ACCOUNT",
      "result_data": "0x123456",
      "result_data_type": "OUTPUT",
      "timestamp": "1586567700.453054000",
      "to": "0x0000000000000000000000000000000000001f41",
      "value": 50000
    }
  ],
  "links": {
    "next": null
  }
}

OK

Get the contract result from a contract on the network executed at a given timestamp

get

Returns a single ContractResult for a contract's function executions at a specific timestamp.

Path parameters

contractIdOrAddressstringrequired

The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40})$

timestampstringrequired

The Unix timestamp in seconds.nanoseconds format, the timestamp at which the associated transaction reached consensus. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Example: 1234567890.0000007

Pattern: ^\d{1,10}(.\d{1,9})?$

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}'

200

206

400

404

200

{
  "access_list": "0xabcd",
  "address": "0x25fe26adc577cc89172e6156c9e24f7b9751b762",
  "amount": 10,
  "block_gas_used": 2000,
  "block_hash": "0x6ceecd8bb224da491",
  "block_number": 10,
  "bloom": null,
  "call_result": "0x2b048531b38d2882e86044bc972e940ee0a01938",
  "chain_id": "0x0127",
  "contract_id": "0.0.2",
  "created_contract_ids": [
    "0.0.2"
  ],
  "error_message": "Out of gas",
  "failed_initcode": "0x856739",
  "from": "0x0000000000000000000000000000000000001f41",
  "function_parameters": "0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b",
  "gas_consumed": 35000,
  "gas_limit": 100000,
  "gas_price": "0x4a817c800",
  "gas_used": 80000,
  "hash": "0x3531396130303866616264653464",
  "max_fee_per_gas": "0x5",
  "max_priority_fee_per_gas": "0x100",
  "nonce": 1,
  "r": "0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043",
  "result": "SUCCESS",
  "s": "0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355",
  "status": 1,
  "timestamp": "1586567700.453054000",
  "to": "0x0000000000000000000000000000000000001f41",
  "transaction_index": 1,
  "type": 2,
  "v": 1,
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "bloom": null,
      "contract_id": "0.0.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "index": 0,
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ]
    }
  ],
  "state_changes": [
    {
      "address": "0000000000000000000000000000000000001f41",
      "contract_id": "0.0.2",
      "slot": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "value_read": "0x97c1fc0a6ed5551bc831571325e9bdb365d06803100dc20648640ba24ce69750",
      "value_written": "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
    }
  ]
}

OK

List contract logs from a contract on the network

get

Search the logs of a specific contract across 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.

Ordering

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

Filtering

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.

Path parameters

contractIdOrAddressstringrequired

The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40})$

Query parameters

indexstringoptional

Contract log index

Example: {"summary":"--","value":""}

Pattern: ^((eq|gt|gte|lt|lte):)?\d{1,10}$

limitinteger · int32 · min: 1 · max: 100 · default: 25optional

The maximum number of items to return

Example: 2

orderundefined · enum · default: "desc"optional

The order in which items are listed

Example: asc

Options: asc, desc

timestampstring[]optional

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Example: {"summary":"--","value":""}

topic0string[]optional

The first topic associated with a contract log. Requires a timestamp range also be populated.

topic1string[]optional

The second topic associated with a contract log. Requires a timestamp range also be populated.

topic2string[]optional

The third topic associated with a contract log. Requires a timestamp range also be populated.

topic3string[]optional

The fourth topic associated with a contract log. Requires a timestamp range also be populated.

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/{contractIdOrAddress}/results/logs'

200

400

404

200

{
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "bloom": null,
      "contract_id": "0.0.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "index": 0,
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ],
      "block_hash": "0x553f9311833391c0a3b2f9ed64540a89f2190a511986cd94889f1c0cf7fa63e898b1c6730f14a61755d1fb4ca05fb073",
      "block_number": 10,
      "root_contract_id": null,
      "timestamp": "1586567700.453054000",
      "transaction_hash": "0x397022d1e5baeb89d0ab66e6bf602640610e6fb7e55d78638db861e2c6339aa9",
      "transaction_index": 1
    }
  ],
  "links": {
    "next": null
  }
}

OK

List contracts logs across many contracts on the network

get

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.

Ordering

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

Filtering

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.

Query parameters

indexstringoptional

Contract log index

Example: {"summary":"--","value":""}

Pattern: ^((eq|gt|gte|lt|lte):)?\d{1,10}$

limitinteger · int32 · min: 1 · max: 100 · default: 25optional

The maximum number of items to return

Example: 2

orderundefined · enum · default: "desc"optional

The order in which items are listed

Example: asc

Options: asc, desc

timestampstring[]optional

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Example: {"summary":"--","value":""}

topic0string[]optional

The first topic associated with a contract log. Requires a timestamp range also be populated.

topic1string[]optional

The second topic associated with a contract log. Requires a timestamp range also be populated.

topic2string[]optional

The third topic associated with a contract log. Requires a timestamp range also be populated.

topic3string[]optional

The fourth topic associated with a contract log. Requires a timestamp range also be populated.

transaction.hashstringoptional

A hex encoded 32-byte ethereum transaction hash or 48-byte hedera transaction hash.

Example: {"value":"ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"}

Pattern: ^(eq:)?(0x)?([0-9A-Fa-f]{64}|[0-9A-Fa-f]{96})$

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/results/logs'

200

400

200

{
  "logs": [
    {
      "address": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "bloom": null,
      "contract_id": "0.0.2",
      "data": "0x00000000000000000000000000000000000000000000000000000000000000fa",
      "index": 0,
      "topics": [
        "0xf4757a49b326036464bec6fe419a4ae38c8a02ce3e68bf0809674f6aab8ad300"
      ],
      "block_hash": "0x553f9311833391c0a3b2f9ed64540a89f2190a511986cd94889f1c0cf7fa63e898b1c6730f14a61755d1fb4ca05fb073",
      "block_number": 10,
      "root_contract_id": null,
      "timestamp": "1586567700.453054000",
      "transaction_hash": "0x397022d1e5baeb89d0ab66e6bf602640610e6fb7e55d78638db861e2c6339aa9",
      "transaction_index": 1
    }
  ],
  "links": {
    "next": null
  }
}

OK

Get the opcode traces for a historical transaction on the network with the given transaction ID or hash

get

Re-executes a transaction and returns a result containing detailed information for the execution, including all values from the {@code stack}, {@code memory} and {@code storage} and the entire trace of opcodes that were executed during the replay.

Note that to provide the output, the transaction needs to be re-executed on the EVM, which may take a significant amount of time to complete if stack and memory information is requested.

Path parameters

transactionIdOrHashstringrequired

Transaction Id or a 32 byte hash with optional 0x prefix

Example: {"value":"0.0.10-1234567890-000000000"}

Pattern: ^(0x)?[A-Fa-f0-9]{64}|(\d{1,10})\.(\d{1,10})\.(\d{1,10})-(\d{1,19})-(\d{1,9})$

Query parameters

stackboolean · default: trueoptional

If provided and set to false, stack information will not be included in the response

Example: true

memoryboolean · default: falseoptional

If provided and set to true, memory information will be included in the response

Example: false

storageboolean · default: falseoptional

If provided and set to true, storage information will be included in the response

Example: false

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/contracts/results/{transactionIdOrHash}/opcodes'

200

400

404

429

200

{
  "address": "binary",
  "contract_id": "0.0.2",
  "failed": true,
  "gas": 1,
  "opcodes": [
    {
      "depth": 1,
      "gas": 1,
      "gas_cost": 1,
      "memory": [
        "binary"
      ],
      "op": "text",
      "pc": 1,
      "reason": "binary",
      "stack": [
        "binary"
      ],
      "storage": {
        "ANY_ADDITIONAL_PROPERTY": "binary"
      }
    }
  ],
  "return_value": "binary"
}

OK

Invoke a smart contract

post

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 the estimate field is set to true gas estimation is executed. However, gas estimation only supports the latest block. When estimate is false, it can process calls against the earliest block and specific historical blocks when a hexadecimal or decimal block number is provided in the block field for eth_call operations. Link to Supported/Unsupported Operations Table The operations types which are not currently supported should return 501 error status.

Body

blockstring | nullableoptional

Hexadecimal block number or the string "latest", "pending", "earliest". Defaults to "latest".

Example: latest

Pattern: ^((0x)?[0-9a-fA-F]+|(earliest|pending|latest))$

datastring · binary | nullableoptional

Hexadecimal method signature and encoded parameters. Up to 24656 bytes as at most 49152 hexidecimal digits plus optional leading 0x.

Example: 0x47f1aae7

Pattern: ^(0x)?[0-9a-fA-F]+$

estimateboolean | nullableoptional

Whether gas estimation is called. Defaults to false.

Example: true

fromstring · binary | nullableoptional

The 20-byte hexadecimal EVM address the transaction is sent from.

Example: 00000000000000000000000000000000000004e2

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

gasinteger · int64 | nullableoptional

Gas provided for the transaction execution. Defaults to 15000000.

Example: 15000000

gasPriceinteger · int64 | nullableoptional

Gas price used for each paid gas.

Example: 100000000

tostring · binary · min: 40 · max: 42required

The 20-byte hexadecimal EVM address the transaction is directed to.

Example: 0xd9d0c5c0ff85758bdf05a7636f8036d4d065f5b6

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

valueinteger · int64 | nullableoptional

Value sent with this transaction. Defaults to 0.

Example: 0

Responses

application/json

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/contracts/call' \
  --header 'Content-Type: application/json' \
  --data '{
    "block": "latest",
    "data": "0x47f1aae7",
    "estimate": true,
    "from": "00000000000000000000000000000000000004e2",
    "gas": 15000000,
    "gasPrice": 100000000,
    "to": "0xd9d0c5c0ff85758bdf05a7636f8036d4d065f5b6",
    "value": 0
  }'

200

400

404

415

429

500

501

200

{
  "result": "0x0000000000006d8d"
}

OK