Ethereum JSON-RPC API

JSON-RPC API methods for the eth_ namespace for Cronos zkEVM.

Cronos zkEVM supports the standard Ethereum JSON-RPC API.

Important Differences for Developers

When working with Cronos zkEVM, there are specific differences you should be aware of:

  1. Block Data Retrieval Methods:

    • Methods that return data about a block, such as eth_getBlockByHash, eth_getBlockByNumber, and Geth’s pubsub API eth_subscribe with the newHeads parameter, do not provide the actual receiptsRoot, transactionsRoot, and stateRoot values.

    • Instead, these fields contain zero values because Cronos zkEVM’s L2 blocks do not include the concept of a state root; only L1 batches have this concept.

  2. Unsupported Method:

    • The method eth_sendTransaction is intentionally not supported in Cronos zkEVM.

eth_chainId

Gets the current chain ID.

Parameters

None

Returns

QUANTITY - hexadecimal representation of the current blockchain network's chain ID.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_chainId",
      "params": []
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x184",
  "id": 1
}

eth_call

Executes a new message call immediately without creating a transaction on the block chain.

Parameters

CallRequest - object

  • from: DATA, 20 bytes - Sender address. Arbitrary if not provided.

  • to: DATA, 20 bytes - Recipient address. Required for eth_call.

  • gas: QUANTITY - Gas limit for the transaction. Defaults if not provided.

  • gas_price: QUANTITY - Gas price for the transaction. Defaults if not provided.

  • max_fee_per_gas: QUANTITY - Maximum fee per unit of gas.

  • max_priority_fee_per_gas: QUANTITY - Maximum priority fee per unit of gas.

  • value: QUANTITY - Value transferred in the transaction. None for no transfer.

  • data / input: DATA - Data sent with the transaction. Empty if not provided.

  • nonce: DATA, 32 bytes - Transaction nonce.

  • transaction_type: QUANTITY, 8 bytes - Type of the transaction.

  • access_list: AccessList - EIP-2930 access list.

  • customData: OBJECT - Extra parameters for EIP712 transactions, like paymasterParams or customSignature.

BlockIdVariant - Optional.

Returns

DATA - The data returned by the smart contract function, encoded in hexadecimal format.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_call",
      "params": [
        {
          "to": "0xc94770007dda54cF92009BFF0dE90c06F603a09f"
        },
        "latest"
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x",
  "id": 1
}

eth_estimateGas

Estimates the amount of gas needed to execute a call. The from field cannot be a smart contract that is not a SmartAccount if so an exception is hit.

Parameters

CallRequest - object

  • from: DATA, 20 bytes - Sender address. Arbitrary if not provided.

  • to: DATA, 20 bytes - Recipient address. Required for eth_call.

  • gas: QUANTITY - Gas limit for the transaction. Defaults if not provided.

  • gas_price: QUANTITY - Gas price for the transaction. Defaults if not provided.

  • max_fee_per_gas: QUANTITY - Maximum fee per unit of gas.

  • max_priority_fee_per_gas: QUANTITY - Maximum priority fee per unit of gas.

  • value: QUANTITY - Value transferred in the transaction. None for no transfer.

  • data / input: DATA - Data sent with the transaction. Empty if not provided.

  • nonce: DATA, 32 bytes - Transaction nonce.

  • transaction_type: QUANTITY, 8 bytes - Type of the transaction.

  • access_list: AccessList - EIP-2930 access list.

  • customData: OBJECT - Extra parameters for EIP712 transactions, like paymasterParams or customSignature.

uint32 - Optional block number.

Returns

QUANTITY - The estimated amount of gas in hexadecimal format.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_estimateGas",
      "params": [
        {
          "from" :"0xf29b18cb786a045178c8ee9131e0ff69567bdd2b",
          "to": "0x415254a14a3369884c2ea93dae8cd92a014a8603"
        }
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x2910c",
  "id": 1
}

eth_gasPrice

Retrieves the current average gas price in the network, expressed in gwei. This value provides an estimate of how much each unit of gas would cost for transactions on the network at the time of the query. It's particularly useful for dynamically adjusting transaction fees to current network conditions.

Parameters

None

Returns

QUANTITY - The current average gas price on the network, represented in gwei and encoded as a hexadecimal string.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_gasPrice",
      "params": []
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x246139ca800",
  "id": 1
}

eth_newFilter

Initiates a new filter for listening to specific events emitted by smart contracts or other blockchain actions. This feature enables applications to react to events and updates in real-time by setting criteria for the events they're interested in.

Remark

Developers may encounter the Filter Not Found error when using filter-related methods due to the system failing to locate the specified filter ID. Common causes include:

  • Filters expire after a period of inactivity (e.g., 5 minutes) and are not permanent.

  • If the chain node is restarted, the filters created before the restart might be lost, leading to errors in subsequent queries.

  • Filters can be manually removed using specific methods like ``. If a filter is uninstalled and then queried, it will naturally result in the error.

  • Some nodes might prune or remove older states including filters. This can also lead to an error when querying a pruned filter.

Identifying the cause of the this error allow developers to take corrective actions such as recreating filters, adjusting filter lifespans, or ensuring node stability.

Parameters

Filter - Object containing various fields to specify the criteria for filtering events

  • fromBlock: QUANTITY | TAG - The starting block (inclusive) to filter events from. Default is "latest".

  • toBlock: QUANTITY | TAG - The ending block (inclusive) to filter events up to. Default is "latest".

  • address: DATA | Array, 20 bytes - The contract address(s) to filter events from.

  • topics: Array of Data - An array of topics to filter events by. Each element can be a topic to match, or null to match any topic in that position.

  • blockHash: DATA, 32 bytes - Filters events from a specific block hash, only allowing a single block to be specified. Note that using blockHash will override any specified fromBlock and toBlock fields.

Returns

QUANTITY - unique identifier of the newly created filter, encoded as a hexadecimal string.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_newFilter",
      "params": [
        {
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
          ]
        }
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x612772db7168e9e1b3af62478e9433d06e05e9861289cace5043644842456ae7",
  "id": 1
}

eth_newBlockFilter

Creates a filter to notify when a new block arrives.

Parameters

None

Returns

QUANTITY - unique identifier of the newly created block filter, encoded as a hexadecimal string.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_newBlockFilter",
      "params": []
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x3f65fa831975663ab121046eca6013ed8eb007c821fa1445998648f3a5d2fee6",
  "id": 1
}

eth_uninstallFilter

Removes a filter that was previously created using eth_newFilter, eth_newBlockFilter, or eth_newPendingTransactionFilter. This method is used to stop receiving updates for the specified filter and to clean up resources associated with it on the node.

Parameters

QUANTITY, 32 bytes - unique identifier of the filter to be removed, originally returned by the filter creation method.

Returns

Boolean - true if the filter was successfully uninstalled; otherwise, false.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_uninstallFilter",
      "params": ["0xb825a38f6350ff4d75d806e6f83a42a31d39fc7ef4fde02b404e8edeef6799b"]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": false,
  "id": 1
}

eth_newPendingTransactionFilter

Sets up a new filter to provide notifications for transactions that enter the pending state, which means they are broadcast to the network but not yet included in a block. This filter is useful for tracking transactions that are awaiting confirmation.

Parameters

None

Returns

QUANTITY, 32 bytes - unique identifier of the new filter for pending transactions, encoded as a hexadecimal string.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_newPendingTransactionFilter",
      "params": []
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0xed2778f35e03a63859f9c7812452bf8ab335afa67299b4c37dcbabea0ce09cdf",
  "id": 1
}

eth_getLogs

Retrieves the logs matching a filter object.

Parameters

Filter - Object containing various fields to specify the criteria for filtering events

  • fromBlock: QUANTITY | TAG - The starting block (inclusive) to filter events from. Default is "latest".

  • toBlock: QUANTITY | TAG - The ending block (inclusive) to filter events up to. Default is "latest".

  • address: DATA | Array, 20 bytes - The contract address(s) to filter events from.

  • topics: Array of Data - An array of topics to filter events by. Each element can be a topic to match, or null to match any topic in that position.

  • blockHash: DATA, 32 bytes - Filters events from a specific block hash, only allowing a single block to be specified. Note that using blockHash will override any specified fromBlock and toBlock fields.

Returns

Array of log objects that match the filter criteria. Each log object contains detailed information about a single log entry.

  • address: Data, 20 bytes - address of the contract that generated the log.

  • topics: Array of Data - Topics are indexed event parameters stored in the log.

  • data: DATA - The data contained in the log.

  • blockHash: DATA, 32 bytes - Hash of the block where this log was in.

  • blockNumber: QUANTITY - block number where this log was in.

  • transactionHash: DATA, 32 bytes - Hash of the transaction that generated this log.

  • transactionIndex: QUANTITY - Integer of the transaction's index position in the block.

  • logIndex: QUANTITY - Integer of the log's index position in the block.

  • transactionIndex: QUANTITY - Integer of the log's index position in the transaction.

  • logType: String - The type of log (can be null).

  • removed: Boolean - Indicates if the log was removed due to a chain reorganization.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_getLogs",
      "params": [
        {
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
          ],
          "fromBlock": "latest"
        }
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": [
    {
      "address": "0x000000000000000000000000000000000000800a",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000f4b5e4e82f425154dc7c2eeaac7cbb3c0b70c43a",
        "0x0000000000000000000000000000000000000000000000000000000000008001"
      ],
      "data": "0x0000000000000000000000000000000000000000000000001bc38f19b1a58000",
      "blockHash": "0x5675b3b9966bc3bc3dd4d275b913dabae3e1a009298caf9ea22fadcdff37a202",
      "blockNumber": "0x24bfd",
      "l1BatchNumber": null,
      "transactionHash": "0xb313c78e59fe3807fe6245ff293435c57887b560779061309f83db576888ccf2",
      "transactionIndex": "0x0",
      "logIndex": "0x0",
      "transactionLogIndex": "0x0",
      "logType": null,
      "removed": false,
      "blockTimestamp": "0x66ceca21"
    },
    ...
    {
      "address": "0x000000000000000000000000000000000000800a",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000000000000000000000000000000000000000008001",
        "0x000000000000000000000000f4b5e4e82f425154dc7c2eeaac7cbb3c0b70c43a"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000ab59a3d7a554800",
      "blockHash": "0x5675b3b9966bc3bc3dd4d275b913dabae3e1a009298caf9ea22fadcdff37a202",
      "blockNumber": "0x24bfd",
      "l1BatchNumber": null,
      "transactionHash": "0xb313c78e59fe3807fe6245ff293435c57887b560779061309f83db576888ccf2",
      "transactionIndex": "0x0",
      "logIndex": "0x5",
      "transactionLogIndex": "0x5",
      "logType": null,
      "removed": false,
      "blockTimestamp": "0x66ceca21"
    }
  ],
  "id": 1
}

eth_getFilterLogs

Retrieves the logs for a filter created with eth_newFilter.

Parameters

QUANTITY, 32 bytes - the filter id.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_getFilterLogs",
      "params": [
        "0x612772db7168e9e1b3af62478e9433d06e05e9861289cace5043644842456ae7"
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": [
    {
      "address": "0x000000000000000000000000000000000000800a",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000004c9bd0ce4ed1e0efbaa65dce1e2928841a4406ce",
        "0x0000000000000000000000000000000000000000000000000000000000008001"
      ],
      "data": "0x00000000000000000000000000000000000000000000000011e4e33e49c61400",
      "blockHash": "0x8082e072b41af3ea86555e1b6f7ce05532c4b72bf614cd55a65109830a0ea829",
      "blockNumber": "0x26488",
      "l1BatchNumber": null,
      "transactionHash": "0x442b2272e5b18af5cad6a747e432f4942455947a7ebf997c0c335d952d8e5458",
      "transactionIndex": "0x0",
      "logIndex": "0x0",
      "transactionLogIndex": "0x0",
      "logType": null,
      "removed": false,
      "blockTimestamp": "0x66cf747c"
    },
    ...
    {
      "address": "0x000000000000000000000000000000000000800a",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000000000000000000000000000000000000000008001",
        "0x0000000000000000000000004c9bd0ce4ed1e0efbaa65dce1e2928841a4406ce"
      ],
      "data": "0x00000000000000000000000000000000000000000000000007de5ef2cc6c3000",
      "blockHash": "0x8082e072b41af3ea86555e1b6f7ce05532c4b72bf614cd55a65109830a0ea829",
      "blockNumber": "0x26488",
      "l1BatchNumber": null,
      "transactionHash": "0x442b2272e5b18af5cad6a747e432f4942455947a7ebf997c0c335d952d8e5458",
      "transactionIndex": "0x0",
      "logIndex": "0x8",
      "transactionLogIndex": "0x8",
      "logType": null,
      "removed": false,
      "blockTimestamp": "0x66cf747c"
    }
  ],
  "id": 1
}

eth_getFilterChanges

Retrieves the logs since the last poll for a filter created with eth_newFilter.

Parameters

QUANTITY, 32 bytes - the filter id.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_getFilterChanges",
      "params": [
        "0x612772db7168e9e1b3af62478e9433d06e05e9861289cace5043644842456ae7"
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": [
    {...}
  ],
  "id": 1
}

eth_getBalance

Gets the balance of an account at a specific block.

Parameters

DATA, 20 bytes - address of the account whose balance is being queried.

QUANTITY | TAG - integer block number, or the string "latest", "earliest", "pending", "safe" or "finalized".

Returns

QUANTITY - The balance of the account at the specified block, encoded as a hexadecimal string representing the value in gwei.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_getBalance",
      "params": [
        "0x39D3daeB55FE01b3F10A002DAdaEa6c79B098f1E",
        "latest"
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "id":1,
  "result": "0x47b13063b2c33ef82"
}

eth_getBlockByNumber

Retrieves a block by its number.

Parameters

QUANTITY | TAG - integer block number, or the string "latest", "earliest", "pending", "safe" or "finalized".

Boolean - A boolean flag indicating whether to return full transaction objects (true) or just their hashes (false).

Returns

Object representing the requested block, including various metadata fields and either a list of transaction hashes or full transaction objects, based on the full_transactions parameter.

  • hash: DATA, 32 bytes - hash of the block.

  • parentHash: DATA, 32 bytes - hash of the block's parent.

  • sha3Uncles: DATA, 32 bytes - SHA3 of the uncles data in the block.

  • miner: DATA, 20 bytes - address of the miner who mined the block.

  • stateRoot: DATA, 32 bytes - root of the final state trie of the block.

  • transactionsRoot: DATA, 32 bytes - root of the trie of the transactions in the block.

  • receiptsRoot: Data, 32 bytes - root of the receipts trie of the block.

  • number: QUANTITY - block number.

  • l1BatchNumber: QUANTITY - (Optional) The L1 batch number associated with the block.

  • gasUsed: QUANTITY - total gas used by all transactions in this block.

  • gasLimit: QUANTITY - gas limit of the block.

  • baseFeePerGas: QUANTITY - (Optional) base fee per gas in the block.

  • extraData: DATA - Extra data attached to the block.

  • logsBloom: DATA, 256 bytes - The bloom filter for the logs contained in the block.

  • timestamp: QUANTITY - timestamp for when the block was collated.

  • l1BatchTimestamp: QUANTITY - (Optional) L1 batch timestamp associated with the block.

  • difficulty: QUANTITY - difficulty of the block.

  • totalDifficulty: QUANTITY - total difficulty of the chain up to this block.

  • uncles: Array - An array of uncle hashes.

  • transactions: Array - An array of transaction hashes or transaction objects, depending on the full_transactions parameter.

  • size: QUANTITY - size of the block in bytes.

  • mixHash: DATA - mix hash of the block.

  • nonce: DATA, 8 bytes - nonce of the block.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getBlockByNumber",
    "params": ["0x24C57", false]
  }'

Example Response

{
  "jsonrpc": "2.0",
  "result": {
    "hash": "0x1e59fe199a76acac718e5154de14994837fd95bd9a407f4dca9927ffb2cf59bb",
    "parentHash": "0xad33990c8173b76b93c4cef22a6fef8bad9bce55498a61dcee30d0246d496b52",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "miner": "0x0000000000000000000000000000000000000000",
    "stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "transactionsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "receiptsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "number": "0x24c57",
    "l1BatchNumber": null,
    "gasUsed": "0x2c3d0",
    "gasLimit": "0x4000000000000",
    "baseFeePerGas": "0x246139ca800",
    "extraData": "0x",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "timestamp": "0x66cece0e",
    "l1BatchTimestamp": null,
    "difficulty": "0x0",
    "totalDifficulty": "0x0",
    "sealFields": [],
    "uncles": [],
    "transactions": [
      "0xb775bcd79414a4fbeda71c9e4c55340dfb88156ef42c82d94e9f3680a124d5c9"
    ],
    "size": "0x0",
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "nonce": "0x0000000000000000"
  },
  "id": 1
}

eth_getBlockByHash

Retrieves a block by its hash.

Parameters

DATA, 32 bytes - hexadecimal string representing the hash of the block.

Boolean - A boolean flag indicating whether to return full transaction objects (true) or just their hashes (false).

Returns

Object containing detailed information about the block and its transactions.

  • hash: DATA, 32 bytes - hash of the block.

  • parentHash: DATA, 32 bytes - hash of the block's parent.

  • sha3Uncles: DATA, 32 bytes - SHA3 of the uncles data in the block.

  • miner: DATA, 20 bytes - address of the miner who mined the block.

  • stateRoot: DATA, 32 bytes - root of the final state trie of the block.

  • transactionsRoot: DATA, 32 bytes - root of the trie of the transactions in the block.

  • receiptsRoot: Data, 32 bytes - root of the receipts trie of the block.

  • number: QUANTITY - block number.

  • l1BatchNumber: QUANTITY - (Optional) The L1 batch number associated with the block.

  • gasUsed: QUANTITY - total gas used by all transactions in this block.

  • gasLimit: QUANTITY - gas limit of the block.

  • baseFeePerGas: QUANTITY - (Optional) base fee per gas in the block.

  • extraData: DATA - Extra data attached to the block.

  • logsBloom: DATA, 256 bytes - The bloom filter for the logs contained in the block.

  • timestamp: QUANTITY - timestamp for when the block was collated.

  • l1BatchTimestamp: QUANTITY - (Optional) L1 batch timestamp associated with the block.

  • difficulty: QUANTITY - difficulty of the block.

  • totalDifficulty: QUANTITY - total difficulty of the chain up to this block.

  • uncles: Array - An array of uncle hashes.

  • transactions: Array - An array of transaction hashes or transaction objects, depending on the full_transactions parameter.

  • size: QUANTITY - size of the block in bytes.

  • mixHash: DATA - mix hash of the block.

  • nonce: DATA, 8 bytes - nonce of the block.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_getBlockByHash",
      "params": [
        "0x1e59fe199a76acac718e5154de14994837fd95bd9a407f4dca9927ffb2cf59bb",
        false
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": {
    "hash": "0x1e59fe199a76acac718e5154de14994837fd95bd9a407f4dca9927ffb2cf59bb",
    "parentHash": "0xad33990c8173b76b93c4cef22a6fef8bad9bce55498a61dcee30d0246d496b52",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "miner": "0x0000000000000000000000000000000000000000",
    "stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "transactionsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "receiptsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "number": "0x24c57",
    "l1BatchNumber": null,
    "gasUsed": "0x2c3d0",
    "gasLimit": "0x4000000000000",
    "baseFeePerGas": "0x246139ca800",
    "extraData": "0x",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "timestamp": "0x66cece0e",
    "l1BatchTimestamp": null,
    "difficulty": "0x0",
    "totalDifficulty": "0x0",
    "sealFields": [],
    "uncles": [],
    "transactions": [
      "0xb775bcd79414a4fbeda71c9e4c55340dfb88156ef42c82d94e9f3680a124d5c9"
    ],
    "size": "0x0",
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "nonce": "0x0000000000000000"
  },
  "id": 1
}

eth_getBlockTransactionCountByNumber

This method provides the total number of transactions included in a specific block, identified by its block number. It's a useful query for understanding the volume of transactions processed in a particular block.

Parameters

QUANTITY | TAG - integer block number, or the string "latest", "earliest", "pending", "safe" or "finalized".

Returns

QUANTITY - number of transactions in the specified block, encoded as a hexadecimal string.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_getBlockTransactionCountByNumber",
      "params": ["0x24C53"]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x1",
  "id": 2
}

eth_getBlockReceipts

Fetches transaction receipts for all transactions in a specified block, offering comprehensive details such as the transaction status, gas used, and event logs.

Parameters

QUANTITY | TAG - integer block number, or the string "latest", "earliest", "pending", "safe" or "finalized".

Returns

Array of transaction receipt objects, each containing detailed information about a transaction included in the specified block.

  • transactionHash: DATA, 32 bytes - hash of the transaction.

  • transactionIndex: QUANTITY - index of the transaction in the block.

  • blockHash: DATA, 32 bytes - hash of the block containing the transaction.

  • blockNumber: QUANTITY - block number.

  • from: DATA, 20 bytes - address of the sender.

  • to: DATA, 20 bytes - address of the receiver. Can be null for contract creation transactions.

  • cumulativeGasUsed: QUANTITY - total amount of gas used when this transaction was executed in the block.

  • gasUsed: QUANTITY - amount of gas used by this specific transaction.

  • contractAddress: DATA, 20 bytes - contract address created, if the transaction was a contract creation, otherwise null.

  • logs: Array<Log> - An array of log objects generated by this transaction.

  • status: QUANTITY - status of the transaction, where "0x1" indicates success and "0x0" indicates failure.

  • logsBloom: DATA - bloom filter for the logs of the block.

  • type: QUANTITY - type of the transaction.

  • effectiveGasPrice: QUANTITY - effective gas price paid per unit of gas.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_getBlockReceipts",
      "params": ["0x1d1551e"]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": [
    {
      "transactionHash": "0x3326f0dbc0243fad28edcee91a71cc0c095dcc3a3d73f11bfc95a31a67ba9493",
      "transactionIndex": "0x0",
      "blockHash": "0xeba5890696185de9887239fea3aef3798a77a57e69137efbbd32886e2ee878ec",
      "blockNumber": "0x24c53",
      "l1BatchTxIndex": null,
      "l1BatchNumber": null,
      "from": "0x8fd82243f70caf79c5993a1a6d9e5c04b5c688b1",
      "to": "0xbcaa34ff9d5bfd0d948b18cf6bf39a882f4a1cbd",
      "cumulativeGasUsed": "0x0",
      "gasUsed": "0x26a27",
      "contractAddress": null,
      "logs": [
        {
          "address": "0xbcaa34ff9d5bfd0d948b18cf6bf39a882f4a1cbd",
          "topics": [
            "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
            "0x0000000000000000000000008fd82243f70caf79c5993a1a6d9e5c04b5c688b1",
            "0x000000000000000000000000f809566a93cb882e5055a815bebe57f8aa6ed9f9"
          ],
          "data": "0x0000000000000000000000000000000000000000000000000000000000000000",
          "blockHash": "0xeba5890696185de9887239fea3aef3798a77a57e69137efbbd32886e2ee878ec",
          "blockNumber": "0x24c53",
          "l1BatchNumber": null,
          "transactionHash": "0x3326f0dbc0243fad28edcee91a71cc0c095dcc3a3d73f11bfc95a31a67ba9493",
          "transactionIndex": "0x0",
          "logIndex": "0x0",
          "transactionLogIndex": "0x0",
          "logType": null,
          "removed": false,
          "blockTimestamp": "0x66cecdee"
        },
        ...
        {
          "address": "0x000000000000000000000000000000000000800a",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000f809566a93cb882e5055a815bebe57f8aa6ed9f9",
            "0x0000000000000000000000008fd82243f70caf79c5993a1a6d9e5c04b5c688b1"
          ],
          "data": "0x00000000000000000000000000000000000000000000000002e5f9b1d9ba7800",
          "blockHash": "0xeba5890696185de9887239fea3aef3798a77a57e69137efbbd32886e2ee878ec",
          "blockNumber": "0x24c53",
          "l1BatchNumber": null,
          "transactionHash": "0x3326f0dbc0243fad28edcee91a71cc0c095dcc3a3d73f11bfc95a31a67ba9493",
          "transactionIndex": "0x0",
          "logIndex": "0x5",
          "transactionLogIndex": "0x5",
          "logType": null,
          "removed": false,
          "blockTimestamp": "0x66cecdee"
        },
        {
          "address": "0x000000000000000000000000000000000000800a",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000000000000000000000000000000000000000000008001",
            "0x000000000000000000000000000f809566a93cb882e5055a815bebe57f8aa6ed9f9"
          ],
          "data": "0x000000000000000000000000000000000000000000000000000000000000..."

eth_getBlockTransactionCountByHash

This method returns the number of transactions included in a block, identified by the block's hash. It's particularly useful for determining the transaction volume within a specific block without retrieving the transactions themselves.

Parameters

DATA, 32 bytes - hash of the block for which the transaction count is requested. This should be provided as a hexadecimal string.

Returns

QUANTITY - number of transactions in the block, encoded as a hexadecimal string.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_getBlockTransactionCountByHash",
      "params": ["0x8422c3e796bf4aaa157f0881cd30a26281ee842a799b5f88cb8f486c47695025"]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x1",
  "id": 2
}

eth_getCode

Retrieves the code at a specific address at an optional block.

Parameters

DATA, 20 bytes - The Ethereum address in hexadecimal format from which to retrieve the code.

QUANTITY | TAG - integer block number, or the string "latest", "earliest", "pending", "safe" or "finalized".

Returns

DATA - The code at the given address in the specified block, returned as a hexadecimal string. If the address is not a contract a 0x is returned.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_getCode",
      "params": [
        "0xdfe68fb100c074c838d6e2c5a2d248308dcf090d"
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": ""0x0004000000000002002600000000000200000000030100190000006003300270000003230430019700030000004103550002000000010355000003230030019d0000000102200190000000900000c13d0000008008000039000000400080043f000000040240008c000007730000413d000000000201043b000000e0052002700000032a0250009c00000024021003700000000403100370000000da0000613d0000032b0650009c000001770000613d0000032c0650009c000001890000613d0000032d0650009c000001980000613d0000032e0650009c000001b70000613d0000032f0650009c000001bf0000613d000003300650009c0000024b0000613d000003310650009c000002580000613d000003320650009c000002610000613d000003330650009c000002740000613d000003340650009c000002790000613d000003350650009c0000028c0000613d000003360650009c0000029f0000613d000003370650009c000002f90000613d000003380650009c000003020000613d000003390650009c0000031e0000613d0000033a0650009c0000032c0000613d0000033b0150009c000003540000613d0000033c0150009c0000036d0000613d0000033d0150009c000003d70000613d0000033e0150009c0000040d0000613d0000033f0150009c000004200000613d000003400150009c000007730000c13d0000000001000416000000440440008c000007730000413d000000000101004b000007730000c13d000000000103043b000e00000001001d000000000202043b000000000102004b0000000001000019000000010100c039001000000002001d000000000112004b000007730000c13d0c880a2d0000040f000000100100006b000004780000c13d000000400200043d0000035a01000041000100550000003d00000c6d0000013d002600000001001d002500000000001d000100590000003d00000c060000013d000000260440008a000000050440021000000344020000410c880ba10000040f000000000201001900000000010004140000032502200197000000040320008c000000670000613d00000024040000390000008006000039000100660000003d00000c680000013d000002ed0000613d0000000105000031000000800250008c00000080050080390000001f02500039000001e00320018f00000010010000290000000002130019000100700000003d00000c600000013d000003410420009c000004720000213d0000000103300190000004720000c13d000000400020043f00000000021500190c8808290000040f0000000e02000029000000000020043500000003020000390001007c0000003d00000c7b0000013d0000032502200197000000000301041a0000032603300197000000000323019f000000000031041b000000400100043d000000000021043500000323020000410000000003000414000003230430009c0000000003028019000003230410009c0001008a0000003d00000c100000013d0000034c011001c70000800d0200003900000002030000390000036a040000410000000e05000029000004db0000013d0000000002000416000000000202004b000007730000c13d0000001f024000390000032402200197000000a002200039000000400020043f0000001f0240018f0000000503400272000000a30000613d00000000050000190000000506500210000000000761034f000000000707043b000000a00660003900000000007604350000000105500039000000000635004b0000009b0000413d000000000502004b000000b20000613d0000000503300210000000000131034f0000000302200210000000a003300039000000000503043300000000052501cf000000000525022f000000000101043b0000010002200089000000000121022f00000000012101cf000000000151019f0000000000130435000000200140008c000007730000413d000000a00100043d001000000001001d000003250110009c000007730000213d000000000200041a00000326012001970000000006000411000000000161019f000000000010041b00000323010000410000000003000414000003230430009c0000000003018019000000c00130021000000327011001c700000325052001970000800d02000039000000030300003900000328040000410c880bbb0000040f0000000101200190000007730000613d0000000101000039000000000011041b0000000202000039000000000302041a000001000400008a000000000343016f000000000032041b0000001002000029000000800020043f00000140000004430000016000200443000000200200003900000100002004430000012000100443000003290100004100000c890001042e0000000001000416000000440440008c000007730000413d000000000101004b000007730000c13d000000000202043b000003250120009c000007730000213d000c00000002001d000000000103043b000100e60000003d00000c820000013d000500000002001d0c880b8c0000040f000000e002000039000000400020043f001000000001001d000000000201041a0000032502200197000000800020043f00000001011000390c88083a0000040f000000a00010043f00000010020000290000000202200039000000000202041a000000c00020043f0000000001010433000000010110003a0000000002000019000000010200603900000001022001900000046c0000c13d000003410210009c000004720000213d00000005041002100000003f024000390000034205200197000000400a00043d00000000025a00190000000003a2004b00000000030000190000000103004039000003410620009c000004720000213d0000000103300190000004720000c13d000000400020043f00000000091a04360000001f0240018f000000000300003100000002033003670000000504400272000001190000613d000000000600001900000005076002100000000008790019000000000773034f000000000707043b00000000007804350000000106600039000000000746004b000001110000413d000000000602004b0000011b0000613d000000400800043d0000000005580019000000000685004b00000000060000190000000106004039000003410750009c000004720000213d0000000106600190000004720000c13d000000400050043f0000000007180436000000000104004b000001310000613d000000000100001900000005051002100000000006570019000000000553034f000000000505043b00000000005604350000000101100039000000000541004b000001290000413d000800000008001d000900000007001d000a0000000a001d000b00000009001d000000000102004b000001370000613d000000400200043d0000034301000041001000000002001d00000000001204350000000001000412001200000001001d001100000000001d000101400000003d00000c060000013d000000120440008a000000050440021000000344020000410c880ba10000040f000000000201001900000000010004140000032502200197000000040320008c0000014e0000613d000000040400003900000020060000390001014d0000003d00000c680000013d000002ed0000613d000101500000003d00000c740000013d00000010070000290000001005300029000000000335004b00000000030000190000000103004039000003410450009c0000000c020000290000000b040000290000000a06000029000004720000213d0000000103300190000004720000c13d000000400050043f000000200110008c000007730000413d0000000001070433000003250310009c000007730000213d0000000003060433000000000303004b000001730000613d00000000001404350000000401000039001000000001001d0000000201100367000000000101043b0c88095a0000040f000000080900002900000009080000290000000a070000290000000b060000290000000c050000290000000002090433000000000202004b000007200000c13d000003460100004100000000001004350000003201000039000004750000013d0000000001000416000000240240008c000007730000413d000000000101004b000007730000c13d000000000103043b00000000001004350000000301000039000000200010043f0000004002000039001000000002001d00000000010000190c880b8c0000040f0000000202100039000000000202041a000000000101041a0000032501100197000003190000013d0000000001000416000000000101004b000007730000c13d0c880a2d0000040f000000400100043d0000000202000039000000000302041a000000ff043001900000043c0000c13d00000044021000390000036903000041000000000032043500000024021000390000001403000039000004b90000013d0000000001000416000000440440008c000007730000413d000000000101004b000007730000c13d000000000102043b000700000001001d000101a10000003d00000be90000013d000600000001001d000000000100001900000010020000290c880b8c0000040f0000000002000411000500000002001d000101a90000003d00000c3f0000013d0000000002010019000000000102041a000000070110006c0000044d0000813d000000400100043d00000064021000390000036603000041000000000032043500000044021000390000036703000041000000000032043500000024021000390000002503000039000004360000013d0000000001000416000000240240008c000007730000413d000000000101004b000007730000c13d000000000103043b0c8808640000040f000004de0000013d0000000001000416000000240240008c000007730000413d000000000101004b000007730000c13d000000000103043b001000000001001d0c880a4e0000040f000000100100002900000000001004350000000301000039000000200010043f0000004002000039000f00000002001d00000000010000190c880b8c0000040f0000000502000039000000200020043f000d00000001001d00000000010000190000000f020000290c880b8c0000040f0000000002000411000e00000002001d0000000000200435000000200010043f00000000010000190000000f020000290c880b8c0000040f000000000301041a000000000001041b0000000101100039000000000001041b0000000201000039000000000101041a000000ff01100190000f00000003001d000006c20000c13d0000000001000412002000000001001d001f00000000001d000101ea0000003d00000c060000013d000000200440008a000000050440021000000344020000410c880ba10000040f0000036102000041000000400300043d0000000000230435000000040230003900000010050000290000000000520435000000000200041000000325042001970000002402300039000b00000004001d0000000000420435000000000201001900000000010004140000032502200197000000040420008c000002080000613d000000440400003900000020060000390000000005030019000c00000002001d000a00000003001d0c8807d90000040f0000000a030000290000000c02000029000000000101004b000002ed0000613d0000000101000031000000200410008c000000000401001900000020040080390000001f04400039000000600640018f0000000004360019000000000664004b00000000060000190000000106004039000003410740009c000004720000213d0000000106600190000004720000c13d000c00000002001d000a00000004001d000000400040043f000000200110008c000007730000413d0000000001030433000900000001001d001e000c0000002d000102200000003d00000c640000013d0000001e0440008a000000050440021000000352020000410c880ba10000040f000000000101004b000007730000613d00000362010000410000000a05000029000000000015043500000024065000390000000f01000029000000000016043500000004075000390000001003000029000000000037043500000000010004140000000c02000029000000040420008c000002400000613d00000044040000390000000003050019000800000006001d0000000006000019000700000007001d0c8807b50000040f000000070700002900000008060000290000000c020000290000000a050000290000001003000029000000000101004b000002ed0000613d000000400050043f0000036301000041000000000015043500000000003704350000000b0100002900000000001604350000000001000414000000040320008c000006540000c13d0000000102000031000006a30000013d0000000001000416000000000101004b000007730000c13d0000000001000412001d00000001001d001c00000000001d000102530000003d00000c060000013d0000001d0440008a000000050440021000000344020000410c880ba10000040f000002fd0000013d0000000001000416000000000101004b000007730000c13d0000000201000039000000000101041a000000ff011001900000000001000019000000010100c039000002fe0000013d0000000001000416000000440440008c000007730000413d000000000101004b000007730000c13d000000000202043b000003250120009c000007730000213d000000000103043b0c88091c0000040f000000400300043d00000020043000390000000000240435000000000101004b0000000001000019000000010100c039000000000013043500000040020000390000041d0000013d0000000001000416000000000101004b000007730000c13d0c88094c0000040f000004de0000013d0000000001000416000000240240008c000007730000413d000000000101004b000007730000c13d000000000103043b0000000402000039000000000202041a000000000221004b000007730000813d0c8807fd0000040f0000000302200210000000000101041a000000000321022f000000ff0120008c0000000003002019000000400100043d0000000000310435000003000000013d0000000001000416000000000101004b000007730000c13d0c880a2d0000040f000000000200041a0000032601200197000000000010041b00000323010000410000000003000414000003230430009c0000000003018019000000c00130021000000327011001c700000325052001970000800d02000039000000030300003900000328040000410000000006000019000004db0000013d0000000001000416000000240240008c000007730000413d000000000101004b000007730000c13d000000000103043b001000000001001d0c880a2d0000040f0000000201000039000f00000001001d000000000101041a000000ff02100190000002c60000c13d000001000200008a000000000121016f000e0001001001c30c880a400000040f0000000f010000290000000e02000029000000000021041b0000000001000411000000400200043d000000000012043500000323010000410000000003000414000003230430009c0000000003018019000003230420009c00000000020180190000004001200210000000c002300210000000000112019f0000034c011001c70000800d0200003900000001030000390000035e040000410c880bbb0000040f0000000101200190000007730000613d0000000001000412001b00000001001d001a00000000001d000102cb0000003d00000c060000013d0000001b0440008a000000050440021000000344020000410c880ba10000040f000f00000001001d001903250010019b000102d30000003d00000c640000013d000000190440008a000000050440021000000352020000410c880ba10000040f0000000f020000290000032502200197000000000101004b000007730000613d000000400500043d0000035f0100004100000000001504350000000401500039000000100300002900000000003104350000000001000414000000040320008c000004700000613d00000024040000390000000003050019000f00000005001d0000000f0500002900000000060000190c8807b50000040f0000000f05000029000000000101004b000004700000c13d000102ef0000003d00000c150000013d000002f40000613d0000000006000019000102f30000003d00000bd30000013d000002f10000413d000000000604004b000002f80000613d000102f80000003d00000bc50000013d0c880b780000040f0000000001000416000000000101004b000007730000c13d000000000100041a0000032501100197000000800010043f000000800100003900000020020000390000041e0000013d0000000001000416000000440440008c000007730000413d000000000101004b000007730000c13d000000000102043b000f00000001001d000003250110009c000007730000213d000000000103043b00000000001004350000000501000039000000200010043f0000004002000039001000000002001d00000000010000190c880b8c0000040f0000000f02000029000103160000003d00000c3f0000013d0000000102100039000000000202041a000000000101041a000000800010043f000000a00020043f000000800100003900000010020000290000041e0000013d0000000001000416000000440440008c000007730000413d000000000101004b000007730000c13d000000000202043b000003250120009c000007730000213d000000000103043b0c88095a0000040f000000400300043d000000000013043500000020020000390000041d0000013d0000000005000416000000640640008c000007730000413d000000000505004b000007730000c13d000000000303043b000e00000003001d000000000202043b000003410320009c000007730000213d0000002303200039000000000343004b000007730000813d0000000403200039000000000331034f000000000303043b000003410530009c000004720000213d00000005053002100000003f065000390000034206600197000003580760009c000004720000213d0000008006600039000000400060043f000000800030043f00000024022000390000000003250019000000000443004b000007730000213d000000a004000039000000000532004b000005620000813d000000000521034f000000000505043b000003250650009c000007730000213d000000000454043600000020022000390000034b0000013d0000000001000416000000440440008c000007730000413d000000000101004b000007730000c13d000000000103043b000a00000001001d000000000102043b000900000001001d000003250110009c000007730000213d0c880a2d0000040f0000000a0100002900000009020000290c88091c0000040f0000000003020019000000000101004b000004840000c13d000000400100043d00000044021000390000035703000041000000000032043500000024021000390000001103000039000004b90000013d0000000001000416000000440440008c000007730000413d000000000101004b000007730000c13d000000000102043b000500000001001d000103760000003d00000be90000013d000700000001001d000000000100001900000010020000290c880b8c0000040f0000000002000411000400000002001d0001037e0000003d00000c3f0000013d000600000001001d0000000e010000290c8808640000040f000000060600002900000007010000290000000207100039000000000307041a000000000106041a00000000421300a9000000000401004b0000038c0000613d00000000541200d9000000000334004b0000046c0000c13d0000034e3220012a0000000105600039000000000305041a000000000432004b0000046c0000413d000000000432004b000300000007001d000200000005001d0000039a0000613d000000000232004900000004010000290c880a5e0000040f0000000606000029000000000106041a000d00050010002d0000000d0110006b0000000001000019000000010100403900000001011001900000046c0000c13d000000070100002900000001011000390c88083a0000040f0000000402000029000803250020019b000c00000001001d000b00200010003d000a80020000003d000900240000003d00000000020000190000000c010000290000000001010433000000000112004b0000053b0000813d000f00000002001d00000005012002100000000b011000290000000001010433001000000001001d001603250010019b0000000004000415000000160440008a00000005044002100000000a01000029000003520200004100000009030000290c880ba10000040f00000010020000290000032502200197000000000101004b000007730000613d000000400500043d00000044015000390000000d0300002900000000003104350000002401500039000000080300002900000000003104350000035501000041000000000015043500000004015000390000000e0300002900000000003104350000000001000414000000040320008c000003d10000613d000103d00000003d00000c260000013d000002ed0000613d000003410150009c000004720000213d000000400050043f0000000f020000290000000102200039000003aa0000013d0000000001000416000000440440008c000007730000413d000000000101004b000007730000c13d000000000103043b001000000001001d000000000102043b000f00000001001d000003250110009c000007730000213d0c880a2d0000040f00000010010000290000000f020000290c88091c0000040f000000000101004b000004b30000c13d0000001001000029000103eb0000003d00000c510000013d000000000201041a000003410320009c000004720000213d0000000103200039000000000031041b0c88080b0000040f0000000302200210000003250320021f000000010400008a000000000343013f000000ff0520008c000000000403a0190000000f0500002900000000022501cf0000000002002019000000000301041a000000000334016f000000000223019f000000000021041b000000400100043d000000000051043500000323020000410000000003000414000003230430009c0000000003028019000003230410009c000104070000003d00000c100000013d0000034c011001c70000800d0200003900000002030000390000034d040000410000001005000029000004db0000013d0000000001000416000000240240008c000007730000413d000000000101004b000007730000c13d000000000103043b000104150000003d00000c510000013d0c88083a0000040f0000002002000039000000400300043d001000000003001d00000000022304360c88081b0000040f00000010030000290000000002310049000000000103001900000000030000190c880b810000040f0000000001000416000000240240008c000007730000413d000000000101004b000007730000c13d000000000103043b001003250010019b000003250110009c000007730000213d0c880a2d0000040f0000001006000029000000000106004b000004bc0000c13d000000400100043d0000006402100039000003480300004100000000003204350000004402100039000003490300004100000000003204350000002402100039000000260300003900000000003204350000034a0200004100000000002104350000000402100039000000200300003900000c5d0000013d000001000400008a000000000343016f000000000032041b0000000002000411000000000021043500000323020000410000000003000414000003230430009c0000000003028019000003230410009c000104480000003d00000c100000013d0000034c011001c70000800d0200003900000001030000390000036804000041000004db0000013d0000000e01000029000400000002001d0c8808640000040f000000040600002900000006050000290000000207500039000000000207041a000000000806041a00000000318200a9000000000308004b0000045b0000613d00000000438100d9000000000223004b0000046c0000c13d0000034e2110012a0000000104600039000000000204041a000000000321004b0000046c0000413d000000000321004b000300000007001d000200000004001d0000046a0000613d000000000221004900000005010000290c880a5e0000040f00000006050000290000000401000029000000000801041a000000070180006c000005020000813d000003460100004100000000001004350000001101000039000004750000013d000003410150009c000004cb0000a13d000003460100004100000000001004350000004101000039000000040010043f000003470100004100000c8a000104300000000401000039000000000101041a000f00000001001d00000000020000190000000f0120006c000000510000813d0000000001020019001000000002001d0c8808640000040f000000100200002900000001022000390000047c0000013d0000000a01000029000104870000003d00000c820000013d001000000003001d0c880b8c0000040f00000010040000290000000103100039000b000100000092000f00000003001d000000000103041a000000000201004b0000046c0000613d000000010210008a000000000124004b000004e00000813d0000000102400039000e00000002001d0000000001030019001000000004001d0c88080b0000040f000d00000002001d000000000101041a000c00000001001d0000000f0100002900000010020000290c88080b0000040f0000000302200210000003250320021f0000000b0330014f000000ff0420008c0000000b030020290000000d0400002900000003044002100000000c0540024f0000032505500197000000ff0440008c000000000500201900000000042501cf000000ff0220008c0000000004002019000000000201041a000000000223016f0000000f03000029000000000242019f000000000021041b0000000e040000290000048d0000013d000000400100043d00000044021000390000034b03000041000000000032043500000024021000390000000e0300003900000000003204350000034a0200004100000c0a0000013d000000000200041a0000032601200197000000000161019f000000000010041b00000323010000410000000003000414000003230430009c0000000003018019000000c00130021000000327011001c700000325052001970000800d0200003900000003030000390000032804000041000004db0000013d000000400050043f0000001001000029000000000015043500000323010000410000000002000414000003230320009c0000000002018019000003230350009c00000000050180190000004001500210000000c002200210000000000112019f0000034c011001c70000800d02000039000000010300003900000360040000410c880bbb0000040f0000000101200190000007730000613d000000000100001900000c890001042e0000000001030019001000000002001d0c88080b0000040f0000000302200210000003250320021f0000000b0330014f000000ff0220008c00000000040300190000000b04002029000000000201041a000000000224016f000000000021041b00000010010000290000000f02000029000000000012041b00000009010000290000032501100197000000400200043d000000000012043500000323010000410000000003000414000003230430009c0000000003018019000003230420009c00000000020180190000004001200210000000c002300210000000000112019f0000034c011001c70000800d02000039000000020300003900000356040000410000000a05000029000004db0000013d0000000101500039001000000008001d0c88083a0000040f000000100300002900090007003000720000000502000029000803250020019b000d00000001001d000c00200010003d000b80020000003d000a00240000003d00000000020000190000000d010000290000000001010433000000000112004b000005bf0000813d000f00000002001d00000005012002100000000c011000290000000001010433001000000001001d002403250010019b0000000004000415000000240440008a00000005044002100000000b0100002900000352020000410000000a030000290c880ba10000040f00000010020000290000032502200197000000000101004b000007730000613d000000400500043d0000004401500039000000090300002900000000003104350000002401500039000000080300002900000000003104350000035501000041000000000015043500000004015000390000000e0300002900000000003104350000000001000414000000040320008c000005350000613d000105340000003d00000c260000013d000002ed0000613d000003410150009c000004720000213d000000400050043f0000000f0200002900000001022000390000050e0000013d0000000505000029000000000105004b000005df0000c13d0000000603000029000000000203041a0000000001520019000000000221004b000000000200001900000001020040390000000102200190000000030200002900000002050000290000046c0000c13d000000000013041b000000000302041a00000000421300a9000000000401004b000005500000613d00000000411200d9000000000131004b0000046c0000c13d0000034e2120012a000000000015041b000000400100043d0000000502000029000000000021043500000323020000410000000003000414000003230430009c0000000003028019000003230410009c0001055c0000003d00000c100000013d0000034c011001c70000800d02000039000000030300003900000354040000410000000405000029000005dd0000013d0000004401100370000000000201043b000000000102004b0000000001000019000000010100c039000d00000002001d000000000112004b000007730000c13d000b00000008001d0c880a2d0000040f0000000e0100002900000000001004350000000301000039000c00000001001d000000200010043f000000400200003900000000010000190c880b8c0000040f000000000101041a0000032501100198000006dd0000c13d0000000d0100006b000006e40000c13d000000400200043d0000035a010000410001057d0000003d00000c6d0000013d001800000001001d001700000000001d000105810000003d00000c060000013d000000180440008a000000050440021000000344020000410c880ba10000040f000000000201001900000000010004140000032502200197000000040320008c0000058f0000613d000000240400003900000080060000390001058e0000003d00000c680000013d000002ed0000613d0000000105000031000000800250008c00000080050080390000001f02500039000001e00320018f0000001002300029000105970000003d00000c600000013d000003410420009c000004720000213d0000000103300190000004720000c13d000000400020043f000000100100002900000000021500190c8808290000040f0000000e0200002900000000002004350000000c02000029000105a40000003d00000c7b0000013d000f03250020019b000000000201041a00000326022001970000000f022001af000000000021041b000000800200043d001000000002001d0000035b0220009c0000071c0000813d0000000102100039000000000302041a0000001001000029000c00000002001d000000000012041b000a00000003001d000000000131004b000006f00000813d0000000c01000029000105b80000003d00000c380000013d00000010021000290000000a01100029000000000312004b000006f00000813d000000000002041b0000000102200039000005ba0000013d000000070100006b000006670000c13d0000000301000029000000000201041a0000000401000029000000000301041a00000000413200a9000000000403004b0000000205000029000005cc0000613d00000000433100d9000000000223004b0000046c0000c13d0000034e2110012a000000000015041b000000400100043d0000000702000029000000000021043500000323020000410000000003000414000003230430009c0000000003028019000003230410009c000105d80000003d00000c100000013d0000034c011001c70000800d020000390000000303000039000003650400004100000005050000290000000e06000029000006d70000013d0000000701000029000000000101041a000000400200043d00000020032000390000034f0400004100000000004304350000006403200039000000000053043500000044032000390000000004000410000000000043043500000024032000390000000404000029000000000043043500000064030000390000000000320435000003500320009c000004720000213d000000a003200039000000400030043f00000325011001970c880ab90000040f0000000701000029000000000101041a000f00000001001d0000000001000412001500000001001d001400000000001d000105fd0000003d00000c060000013d000000150440008a000000050440021000000344020000410c880ba10000040f000000400400043d000000240240003900000005030000290000000000320435000003510200004100000000002404350000032502100197001000000004001d0000000401400039000d00000002001d000000000021043500000000010004140000000f020000290000032502200197000000040320008c000006180000613d00000044040000390000002006000039000000100300002900000000050300190c8807b50000040f000000000101004b000002ed0000613d0000000101000031000000200210008c000000000201001900000020020080390000001f02200039000000600220018f00000010040000290000001003200029000000000223004b00000000020000190000000102004039000f00000003001d000003410330009c000004720000213d0000000102200190000004720000c13d0000000f02000029000000400020043f000000200110008c000007730000413d0000000001040433000000000201004b0000000002000019000000010200c039000000000121004b000007730000c13d0013000d0000002d000106350000003d00000c640000013d000000130440008a000000050440021000000352020000410c880ba10000040f000000000101004b000007730000613d0000000f030000290000002401300039000000050200002900000000002104350000035301000041000000000013043500000004013000390000000e02000029000000000021043500000000010004140000000d02000029000000040220008c000006500000613d00000044040000390000000d020000290000000f03000029000000000503001900000000060000190c8807b50000040f000000000101004b000002ed0000613d0000000f01000029000000400010043f00000005050000290000053e0000013d0000004404000039000000400600003900000000030500190c8807d90000040f0000000102000031000000000101004b000006a20000c13d0001065d0000003d00000c1b0000013d000006620000613d0000000006000019000106610000003d00000bd30000013d0000065f0000413d000000000604004b000006660000613d000106660000003d00000bc50000013d0c880b780000040f0000000403000029000000000103041a000000070210006c0000046c0000413d000000070110006a000000000013041b0000000001000412002300000001001d002200000000001d000106720000003d00000c060000013d000000230440008a000000050440021000000344020000410c880ba10000040f001000000001001d002103250010019b0001067a0000003d00000c640000013d000000210440008a000000050440021000000352020000410c880ba10000040f00000010020000290000032502200197000000000101004b000007730000613d000000400400043d00000024014000390000000703000029000000000031043500000362010000410000000000140435001000000004001d00000004014000390000000e0300002900000000003104350000000001000414000000040320008c000006960000613d00000044040000390000001003000029000000000503001900000000060000190c8807b50000040f000000000101004b000002ed0000613d0000001001000029000003410110009c000004720000213d0000001001000029000000400010043f0000000601000029000000000101041a0000032501100197000000050200002900000007030000290c880aa10000040f000005c10000013d0000000a05000029000106a50000003d00000c200000013d0000000001510019000003410310009c000004720000213d000000400010043f000000400120008c000007730000413d000000090100006b0000000f03000029000006c20000613d0000000a010000290000000001010433000000000201004b000006c20000613d00000009040000290000034e324000d100000000434200d90000034e0330009c0000046c0000c13d00000000121200d90000000d010000290000000201100039000000000301041a0000000002230019000106be0000003d00000c600000013d00000001033001900000046c0000c13d000000000021041b0000000f030000290000000d01000029000000000101041a00000325011001970000000e020000290c880aa10000040f000000400100043d0000000f02000029000000000021043500000323020000410000000003000414000003230430009c0000000003028019000003230410009c000106d10000003d00000c100000013d0000034c011001c70000800d02000039000000030300003900000364040000410000000e0500002900000010060000290c880bbb0000040f0000000101200190000007730000613d0000000101000039000000000011041b000004de0000013d000000400100043d00000044021000390000035903000041000000000032043500000024021000390000001303000039000004b90000013d0000000401000039000000000101041a000f00000001001d00000000020000190000000f0120006c000005790000813d0000000001020019001000000002001d0c8808640000040f00000010020000290000000102200039000006e80000013d0000000c01000029000106f30000003d00000c380000013d000000a00200003900000000030000190000001006000029000000000463004b000006fe0000813d000000000413001900000000250204340000032505500197000000000054041b0000000103300039000006f60000013d0000000402000039000000000102041a000003410310009c0000071c0000213d0000000103100039000000000032041b00000000002004350000035c011000410000000e02000029000000000021041b000000400100043d0000002002100039000000600300003900000000003204350000000f0200002900000000002104350000006002100039000000800300043d000000000032043500000000040000190000000b060000290000002002200039000000000534004b000007740000813d00000020066000390000000005060433000003250550019700000000005204350000000104400039000007130000013d00000346010000410000000000100435000000410100003900000c590000013d0000000000180435000000a00c00043d000000200dc00039000003450e000041000000000f00001900070000000c001d00060000000d001d000000400300043d00000000010c043300000000011f004b000000200b3000390000078a0000813d0000000501f0021000000000011d001900000000020104330000000000e3043500000010010000290000000201100367000000000101043b000000240430003900000000005404350000000404300039000000000014043500000000010004140000032502200197000000040420008c0000073d0000c13d0000000102000031000007520000013d000d0000000f001d000e0000000b001d00000044040000390000004006000039000f00000003001d00000000050300190c8807d90000040f0000000102000031000000000101004b000007a90000613d0000000c050000290000000b060000290000000a07000029000000090800002900000008090000290000000f030000290000000e0b000029000000070c000029000000060d000029000003450e0000410000000d0f000029000000400120008c000000000102001900000040010080390000001f01100039000000e00410018f0000000001340019000000000441004b000000000a000019000000010a004039000003410410009c000004720000213d0000000104a00190000004720000c13d000000400010043f000000400120008c000007730000413d0000000001030433000003250210009c000007730000213d000000010ff0003900000000020704330000000002f2004b000001730000a13d00000000020b04330000000503f002100000000004630019000000000014043500000000010904330000000001f1004b000001730000a13d00000000018300190000000000210435000007270000013d00000c3d0000013d00000040031000390000000d04000029000000000043043500000000021200490000032303000041000003230410009c00000000010380190000004001100210000003230420009c00000000020380190000006002200210000000000112019f0000000002000414000003230420009c0000000002038019000000c002200210000000000112019f00000327011001c70000800d0200003900000002030000390000035d040000410000008e0000013d00000005010000290000000000130435000000000207043300000040013000390000000000210435000000000103001900000060073000390000000003000019000000000423004b000007990000813d0000000064060434000003250440019700000000074704360000000103300039000007920000013d000000000217004900000000002b0435000000080200002900000000020204330000000000270435000000000300001900000009050000290000002007700039000000000423004b000007a70000813d000000005405043400000000004704350000000103300039000007a00000013d00000000021700490000041e0000013d000107ab0000003d00000c1b0000013d000007b00000613d0000000006000019000107af0000003d00000bd30000013d000007ad0000413d000000000604004b000007b40000613d000107b40000003d00000bc50000013d0c880b780000040f0003000000000002000300000006001d000200000005001d0000032305000041000003230630009c00000000030580190000004003300210000003230640009c00000000040580190000006004400210000000000334019f000003230410009c0000000001058019000000c001100210000000000113019f0c880bbb0000040f0000000209000029000000000301001900000060033002700000032303300197000000030430006c000000030500002900000000050340190000001f0450018f0000000505500272000007d30000613d0000000006000019000107d20000003d00000c450000013d000007d00000413d000000010220018f000000000604004b000007d80000613d000107d80000003d00000bf80000013d00000c4d0000013d0003000000000002000300000006001d000200000005001d0000032305000041000003230630009c00000000030580190000004003300210000003230640009c00000000040580190000006004400210000000000334019f000003230410009c0000000001058019000000c001100210000000000113019f0c880bc00000040f0000000209000029000000000301001900000060033002700000032303300197000000030430006c000000030500002900000000050340190000001f0450018f0000000505500272000007f70000613d0000000006000019000107f60000003d00000c450000013d000007f40000413d000000010220018f000000000604004b000007fc0000613d000107fc0000003d00000bf80000013d00000c4d0000013d0000000402000039000000000302041a000000000313004b000008050000a13d00000000002004350000035c011000410000000002000019000000000001042d000003460100004100000000001004350000003201000039000000040010043f000003470100004100000c8a000104300002000000000002000000000301041a000200000002001d000000000223004b000008150000a13d000108120000003d00000c380000013d00000002011000290000000002000019000000000001042d000003460100004100000000001004350000003201000039000000040010043f000003470100004100000c8a000104300000000003010433000000000032043500000000040000190000002002200039000000000534004b000008270000813d000000200110003900000000050104330000032505500197000000000052043500000001044000390000081e0000013d0000000001020019000000000001042d00000000021200490000036b030000410000007f0420008c000000000400001900000000040320190000036b02200197000000000502004b00000000030080190000036b0220009c000000000304c019000000000203004b000008390000613d0000000001010433000003250210009c000008390000213d000000000001042d00000c3d0000013d0003000000000002000000000201041a000200000002001d000000400300043d000300000003001d0000000000230435000108420000003d00000c380000013d0000000206000029000000030500002900000000020500190000000003000019000000000463004b0000084f0000813d0000002002200039000000000401041a0000032504400197000000000042043500000001033000390000000101100039000008460000013d00000000015200490000003f01100039000000200200008a000000000221016f0000000001520019000000000221004b00000000020000190000000102004039000003410310009c0000085e0000213d00000001022001900000085e0000c13d000000400010043f0000000001050019000000000001042d000003460100004100000000001004350000004101000039000000040010043f000003470100004100000c8a000104300009000000000002000600000001001d0000000001000412000900000001001d000800000000001d0001086b0000003d00000c060000013d000000090440008a000000050440021000000344020000410c880ba10000040f0000036302000041000000400300043d00000000002304350000000402300039000000060400002900000000004204350000000002000410000003250420019700000024023000390000000000420435000000000201001900000000010004140000032505200197000000040250008c000500000005001d0000088b0000613d000400000004001d0000004404000039000000400600003900000000020500190000000005030019000300000003001d0c8807d90000040f000000030300002900000004040000290000000505000029000000000101004b000008fc0000613d00000001020000310001088e0000003d00000c200000013d0000000007310019000000000117004b00000000010000190000000101004039000003410670009c000008f40000213d0000000101100190000008f40000c13d000000400070043f0000003f0120008c000008fb0000a13d0000000003030433000000000103004b000008f30000613d000300000003001d00000024017000390000000000410435000003610100004100000000001704350000000401700039000000060300002900000000003104350000000001000414000000040350008c000008b30000613d0000004404000039000000200600003900000000020500190000000003070019000400000007001d00000000050700190c8807d90000040f0000000102000031000000000101004b000009100000613d00000005050000290000000407000029000000200120008c000000000102001900000020010080390000001f01100039000000600110018f0000000003710019000003410130009c000008f40000213d000400000003001d000000400030043f000000200120008c000008f80000413d0000000001070433000200000001001d000700000005001d000108c40000003d00000c640000013d000000070440008a000000050440021000000352020000410c880ba10000040f0000000503000029000000000101004b000008f80000613d000003530100004100000004050000290000000000150435000000040150003900000006020000290000000000210435000000240150003900000000000104350000000001000414000000040230008c000008de0000613d00000044040000390000000002030019000000000305001900000000060000190c8807b50000040f0000000405000029000000000101004b000008fc0000613d000000400050043f0000000601000029000108e20000003d00000c820000013d0c880b8c0000040f00000002040000290000034e324000d1000000000304004b000008ea0000613d00000000434200d90000034e0330009c0000090c0000c13d00000003322000fa0000000201100039000000000301041a0000000002230019000108f00000003d00000c600000013d000000010330008c000009060000613d000000000021041b000000000001042d000003460100004100000000001004350000004101000039000009090000013d000000000100001900000000020000190c880b780000040f00000c3d0000013d000108fe0000003d00000c150000013d000009030000613d0000000006000019000109020000003d00000bd30000013d000009000000413d000000000604004b0000091b0000613d00000bdb0000013d000003460100004100000000001004350000001101000039000000040010043f000003470100004100000c8a0001043000000346010000410000000000100435000000110100003900000c590000013d000109120000003d00000c1b0000013d000009170000613d0000000006000019000109160000003d00000bd30000013d000009140000413d000000000604004b0000091b0000613d0001091b0000003d00000bc50000013d0c880b780000040f0005000000000002000500000002001d000109200000003d00000c2f0000013d0000036c0130009c000009460000813d0000006001300039000000400010043f000000000102041a00000325011001970000000001130436000400000001001d0000000101200039000300000002001d000200000003001d0c88083a0000040f000000040200002900000000001204350000000202000029000000400220003900000003030000290000000203300039000000000303041a000000000032043500000020031000390000000004010433000000010100003900000000020000190000000506000029000000000542004b000009430000813d000000050520021000000000055300190000000005050433000000000565013f0000032505500198000009450000613d0000000102200039000009390000013d00000000010000190000000002000019000000000001042d000003460100004100000000001004350000004101000039000000040010043f000003470100004100000c8a0001043000020000000000020000000401000039000000000101041a000100000001001d0000000002000019000000010120006c000009590000813d0000000001020019000200000002001d0c8808640000040f00000002020000290000000102200039000009510000013d000000000001042d000b000000000002000700000002001d000900000001001d0001095f0000003d00000c2f0000013d0000036c0130009c00000a0c0000813d0000006001300039000000400010043f000000000102041a00000325011001970000000001130436000800000001001d0000000101200039000600000002001d000500000003001d0c88083a0000040f000000080200002900000000001204350000000501000029000000400210003900000006010000290000000201100039000000000101041a000800000002001d0000000000120435000000090100002900000000001004350000000501000039000000200010043f0000004002000039000600000002001d00000000010000190c880b8c0000040f000000070200002900000325022001970000000000200435000000200010043f000000000100001900000006020000290c880b8c0000040f000000400300043d0000036d0230009c00000a0c0000213d0000004002300039000000400020043f000000000201041a000700000003001d00000000022304360000000101100039000000000101041a000500000002001d000000000012043500000008010000290000000001010433000600...",
  "id": 2
}

eth_getStorageAt

Retrieves the value from a storage position at a given address.

Parameters

DATA, 20 bytes - address

QUANTITY - index position of the storage slot in hexadecimal format, starting from 0x0.

QUANTITY | TAG - integer block number, or the string "latest", "earliest", "pending", "safe" or "finalized".

Returns

DATA - the value at this storage position.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_getStorageAt",
      "params": ["0xdfe68fb100c074c838d6e2c5a2d248308dcf090d", "0x0", "latest"]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x00000000000000000000000035dd7b546b18aba0ec2a3e8d197c943745598385",
  "id": 2
}

eth_getTransactionCount

Gets the number of transactions sent from an address.

Parameters

DATA, 20 bytes - address

QUANTITY | TAG - integer block number, or the string "latest", "earliest", "pending", "safe" or "finalized".

Returns

QUANTITY - integer of the number of transactions sent from this address.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_getTransactionCount",
      "params": [
        "0x22b758c7fada124b429f1b971e4c84e417ca6f58",
        "latest"
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x1b",
  "id": 2
}

eth_getTransactionByHash

Retrieves a transaction by its hash.

Parameters

DATA, 32 bytes - hash of a transaction.

Returns

Object - A transaction object, or null when no transaction was found:

  • blockHash: DATA, 32 Bytes - hash of the block where this transaction was in. null when its pending.

  • blockNumber: QUANTITY - block number where this transaction was in. null when its pending.

  • from: DATA, 20 Bytes - address of the sender.

  • gas: QUANTITY - gas provided by the sender.

  • gasPrice: QUANTITY - gas price provided by the sender in Wei.

  • hash: DATA, 32 Bytes - hash of the transaction.

  • input: DATA - the data send along with the transaction.

  • nonce: QUANTITY - the number of transactions made by the sender prior to this one.

  • to: DATA, 20 Bytes - address of the receiver. null when its a contract creation transaction.

  • transactionIndex: QUANTITY - integer of the transactions index position in the block. null when its pending. value: QUANTITY - value transferred in Wei.

  • v: QUANTITY - ECDSA recovery id

  • r: QUANTITY - ECDSA signature r

  • s: QUANTITY - ECDSA signature s

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_getTransactionByHash",
      "params": [
        "0xba8058c4fc73f488d7fcaaa6b3d8c71290458d1d9fd3091204547eb50cd71a4d"
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": {
    "hash": "0xba8058c4fc73f488d7fcaaa6b3d8c71290458d1d9fd3091204547eb50cd71a4d",
    "nonce": "0x1a",
    "blockHash": "0x5f86ad83c06d90c0922f9c829c9f8642fc37466eae84ef64c19d8392451a0276",
    "blockNumber": "0x24ce3",
    "transactionIndex": "0x0",
    "from": "0x22b758c7fada124b429f1b971e4c84e417ca6f58",
    "to": "0x4e792b8c9bcb9e200c3713810c4d6ea8c4230e7c",
    "value": "0x0",
    "gasPrice": "0x246139ca800",
    "gas": "0x9c47d",
    "input": "0x5ae401dc0000000000000000000000000000000000000000000000000000000066cedb6c0000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000104472b43f3000000000000000000000000000000000000000000003ad8396379db5620e0000000000000000000000000000000000000000000000001a3e8310b01b9384000000000000000000000000000000000000000000000000000000000000008000000000000000000000000022b758c7fada124b429f1b971e4c84e417ca6f580000000000000000000000000000000000000000000000000000000000000003000000000000000000000000caf2fd3f47e7f46e99f74be579b2cc2233f33ef800000000000000000000000c1bf55ee54e16229d9b369a5502bfe5fc9f20b6d0000000000000000000000005b91e29ae5a71d9052620acb813d5ac25ec7a4a200000000000000000000000000000000000000000000000000000000",
    "v": "0x32b",
    "r": "0x1a525b1f2a322be504a9c317892573a9f6640512d6de9c97ed860777a8063449",
    "s": "0x58344160546fe590a8d7305f26504ae99d534bd0cc778f380008658127f62c97",
    "type": "0x0",
    "maxFeePerGas": "0x2464f377200",
    "maxPriorityFeePerGas": "0x2464f377200",
    "chainId": "0x184"
  },
  "id": 2
}

eth_getTransactionByBlockHashAndIndex

Retrieves a transaction by block hash and transaction index position.

Parameters

DATA, 32 bytes - hash of a block.

QUANTITY - integer of the transaction index position, starting from 0x0.

Returns

The response contains detailed information about the transaction, see eth_getTransactionByHash.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_getTransactionByBlockHashAndIndex",
      "params": [
        "0x5f86ad83c06d90c0922f9c829c9f8642fc37466eae84ef64c19d8392451a0276",
        "0x0"
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": {
    "hash": "0xba8058c4fc73f488d7fcaaa6b3d8c71290458d1d9fd3091204547eb50cd71a4d",
    "nonce": "0x1a",
    "blockHash": "0x5f86ad83c06d90c0922f9c829c9f8642fc37466eae84ef64c19d8392451a0276",
    "blockNumber": "0x24ce3",
    "transactionIndex": "0x0",
    "from": "0x22b758c7fada124b429f1b971e4c84e417ca6f58",
    "to": "0x4e792b8c9bcb9e200c3713810c4d6ea8c4230e7c",
    "value": "0x0",
    "gasPrice": "0x246139ca800",
    "gas": "0x9c47d",
    "input": "0x5ae401dc0000000000000000000000000000000000000000000000000000000066cedb6c0000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000104472b43f3000000000000000000000000000000000000000000003ad8396379db5620e0000000000000000000000000000000000000000000000001a3e8310b01b9384000000000000000000000000000000000000000000000000000000000000008000000000000000000000000022b758c7fada124b429f1b971e4c84e417ca6f580000000000000000000000000000000000000000000000000000000000000003000000000000000000000000caf2fd3f47e7f46e99f74be579b2cc2233f33ef800000000000000000000000c1bf55ee54e16229d9b369a5502bfe5fc9f20b6d0000000000000000000000005b91e29ae5a71d9052620acb813d5ac25ec7a4a200000000000000000000000000000000000000000000000000000000",
    "v": "0x32b",
    "r": "0x1a525b1f2a322be504a9c317892573a9f6640512d6de9c97ed860777a8063449",
    "s": "0x58344160546fe590a8d7305f26504ae99d534bd0cc778f380008658127f62c97",
    "type": "0x0",
    "maxFeePerGas": "0x2464f377200",
    "maxPriorityFeePerGas": "0x2464f377200",
    "chainId": "0x184"
  },
  "id": 2
}

eth_getTransactionReceipt

Retrieves the receipt of a transaction by transaction hash.

Parameters

DATA, 32 bytes - unique hash of the transaction.

Returns

Object - A transaction receipt object, or null when no receipt was found:

  • transactionHash : DATA, 32 Bytes - hash of the transaction.

  • transactionIndex: QUANTITY - integer of the transactions index position in the block.

  • blockHash: DATA, 32 Bytes - hash of the block where this transaction was in.

  • blockNumber: QUANTITY - block number where this transaction was in.

  • from: DATA, 20 Bytes - address of the sender.

  • to: DATA, 20 Bytes - address of the receiver. null when its a contract creation transaction.

  • cumulativeGasUsed : QUANTITY - The total amount of gas used when this transaction was executed in the block.

  • effectiveGasPrice : QUANTITY - The sum of the base fee and tip paid per unit of gas.

  • gasUsed : QUANTITY - The amount of gas used by this specific transaction alone. contractAddress : DATA, 20 Bytes - The contract address created, if the transaction was a contract creation, otherwise null.

  • logs: Array - Array of log objects, which this transaction generated.

  • logsBloom: DATA, 256 Bytes - Bloom filter for light clients to quickly retrieve related logs.

  • type: QUANTITY - integer of the transaction type, 0x0 for legacy transactions, 0x1 for access list types, 0x2 for dynamic fees.

It also returns either:

  • root: DATA 32 - bytes of post-transaction stateroot (pre Byzantium)

  • status: QUANTITY - either 0x1 (success) or 0x0 (failure)

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_getTransactionReceipt",
      "params": ["0xba8058c4fc73f488d7fcaaa6b3d8c71290458d1d9fd3091204547eb50cd71a4d"]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": {
    "transactionHash": "0xba8058c4fc73f488d7fcaaa6b3d8c71290458d1d9fd3091204547eb50cd71a4d",
    "transactionIndex": "0x0",
    "blockHash": "0x5f86ad83c06d90c0922f9c829c9f8642fc37466eae84ef64c19d8392451a0276",
    "blockNumber": "0x24ce3",
    "l1BatchTxIndex": null,
    "l1BatchNumber": null,
    "from": "0x22b758c7fada124b429f1b971e4c84e417ca6f58",
    "to": "0x4e792b8c9bcb9e200c3713810c4d6ea8c4230e7c",
    "cumulativeGasUsed": "0x0",
    "gasUsed": "0x2da41",
    "contractAddress": null,
    "logs": [
      {
        "address": "0x000000000000000000000000000000000000800a",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "0x00000000000000000000000022b758c7fada124b429f1b971e4c84e417ca6f58",
          "0x0000000000000000000000000000000000000000000000000000000000008001"
        ],
        "data": "0x0000000000000000000000000000000000000000000000001637b9ee235aaa00",
        "blockHash": "0x5f86ad83c06d90c0922f9c829c9f8642fc37466eae84ef64c19d8392451a0276",
        "blockNumber": "0x24ce3",
        "l1BatchNumber": null,
        "transactionHash": "0xba8058c4fc73f488d7fcaaa6b3d8c71290458d1d9fd3091204547eb50cd71a4d",
        "transactionIndex": "0x0",
        "logIndex": "0x0",
        "transactionLogIndex": "0x0",
        "logType": null,
        "removed": false,
        "blockTimestamp": "0x66ced6ec"
      },
      ...
    ],
    "l2ToL1Logs": [],
    "status": "0x1",
    "root": "0x5f86ad83c06d90c0922f9c829c9f8642fc37466eae84ef64c19d8392451a0276",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "type": "0x0",
    "effectiveGasPrice": "0x246139ca800"
  },
  "id": 2
}

eth_protocolVersion

Returns the current Ethereum protocol version.

Parameters

None

Returns

String - A single string indicating the protocol version. The version is prefixed with an identifier (e.g. "zks" for ZKsync) followed by a version number.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_protocolVersion",
      "params": []
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "zks/1",
  "id": 2
}

eth_sendRawTransaction

Submits a pre-signed transaction for broadcast to the network.

Parameters

DATA - The complete, signed transaction data.

Returns

DATA, 32 bytes - A single string that is the hash of the transaction if it has been successfully submitted to the network. This hash can be used to track the transaction's inclusion in a block and subsequent execution status.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_sendRawTransaction",
      "params": ["0xf86c808504a817c80082520894095e7baea6a6c7c4c2dfeb977efac326af552d870a868e8..."]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "0x2f5d6a8af654c249bc487e7c7b926a3f3f165b575a6485a487f12c7a9e3c8e45",
  "id": 2
}

eth_accounts

Returns a list of addresses owned by the client.

Parameters

None

Returns

Array of DATA, 20 bytes - An array of account addresses owned by the client.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "eth_accounts",
      "params": []
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": [],
  "id": 2
}

eth_feeHistory

Retrieves the fee history for the requested blocks.

Parameters

uint64 - the number of the blocks to check.

QUANTITY - the latest block number.

Array of float32 - The percentiles of transaction fees to return.

Returns

Object containing the following fields:

  • oldestBlock: QUANTITY - block number in hex of the oldest block queried.

  • baseFeePerGas: Array of QUANTITY - An array of base fees per gas, represented in hex, for each block.

  • gasUsedRatio: Array of Float - An array of ratios of gas used by each block, represented as floats.

  • reward: Array of Array<QUANTITY> - An array of arrays containing the transaction fee rewards at specified percentiles, each represented in hex.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "eth_feeHistory",
      "params": [
          "10",
          "0x24D9D",
          [25.0, 50.0, 75.0]
      ]
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": {
    "oldestBlock": "0x24d8e",
    "baseFeePerGas": [
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800",
      "0x246139ca800"
    ],
    "gasUsedRatio": [
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0
    ],
    "reward": [
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"],
      ["0x0", "0x0", "0x0"]
    ],
    "baseFeePerBlobGas": [
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0",
      "0x0"
    ],
    "blobGasUsedRatio": [
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0,
      0.0
    ]
  },
  "id": 1
}

web3_clientVersion

Note: The sha3 method is intentionally omitted from the main server implementation, as it can be readily implemented on the client side if necessary.

Retrieves the version of the client software.

Parameters

None

Returns

String - The client version supported by the node. The version is prefixed with an identifier (e.g. "ZKsync" for ZKsync) followed by a version number.

Example Request

curl --request POST \
  --url https://mainnet.zkevm.cronos.org \
  --header 'Content-Type: application/json' \
  --data '{
      "id": 1,
      "jsonrpc": "2.0",
      "method": "web3_clientVersion",
      "params": []
    }'

Example Response

{
  "jsonrpc": "2.0",
  "result": "ZKsync/v2.0",
  "id": 1
}

Last updated