Corn — web3, net, eth (3/3)

API reference for Corn. All methods ->

Part 3 of 3: 1 · 2 · 3

eth_getTransactionReceipt

Returns the receipt of a transaction by transaction hash.

The receipt is not available for pending transactions.

Parameters

• id (integer; required): a request ID (example: 1).

• jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

• method (string; required): a method used for the request.

• params (array; required):

  1. <string> (data, 32 bytes): a hash of the transaction.

Returns

• object: a transaction receipt object, or null when no receipt was found:

  • transactionHash (string; data, 32 bytes): a hash of the transaction.

  • transactionIndex (string; quantity): the transactions index position in the block.

  • blockHash (string; data, 32 bytes): a hash of the block containing the transaction.

  • blockNumber (string; quantity): a number of the block containing the transaction.

  • from (string; data, 20 bytes): an address of the sender.

  • to (string; data, 20 bytes): an address of the receiver; null when it's a contract creation transaction.

  • cumulativeGasUsed (string; quantity): the total amount of gas used when this transaction was executed in the block.

  • effectiveGasPrice (string; quantity): the sum of the base fee and tip paid per unit of gas.

  • gasUsed (string; quantity): the amount of gas used by this specific transaction alone.

  • contractAddress (string; data, 20 bytes): the contract address created, if the transaction was a contract creation, otherwise null.

  • logs (array): an array of log objects, which this transaction generated.

  • logsBloom (string; data, 256 bytes): a bloom filter for light clients to quickly retrieve related logs.

  • type (string; data): the transaction type, 0x00 for legacy transactions, 0x01 for access list types, 0x02 for dynamic fees. It also returns either of the following:

    • root (string; data, 32 bytes): a post-transaction stateroot (pre Byzantium).
    • status (string; quantity): either 1 (success) or 0 (failure).

Request example

curl -X POST https://rpc.ankr.com/corn_maizenet/YOUR_ANKR_API_KEY \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getTransactionReceipt",
      "params": ["0xad06bd8b78bf48f9f3d69e968db30816ed2b60e1220da727d930bbf6d302e262"],
      "id": 1
    }'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "blockHash": "0xc9f7eeb52a2e215f695031412c7db6b8b0c2d6231dbeb2b5027f473f3982a4c8",
        "blockNumber": "0x2091c",
        "contractAddress": null,
        "cumulativeGasUsed": "0x0",
        "effectiveGasPrice": "0x7a120",
        "from": "0x00000000000000000000000000000000000a4b05",
        "gasUsed": "0x0",
        "gasUsedForL1": "0x0",
        "l1BlockNumber": "0x1497c2f",
        "logs": [],
        "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "status": "0x1",
        "to": "0x00000000000000000000000000000000000a4b05",
        "transactionHash": "0xad06bd8b78bf48f9f3d69e968db30816ed2b60e1220da727d930bbf6d302e262",
        "transactionIndex": "0x0",
        "type": "0x6a"
    }
}

---

eth_getUncleByBlockHashAndIndex

Returns information about an uncle of a block by hash and uncle index position.

Parameters

• id (integer; required): a request ID (example: 1).

• jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

• method (string; required): a method used for the request.

• params (array; required):

  1. <string> (data, 32 bytes): the hash of a block.
  2. <string> (quantity): the uncle's index position.

Returns

• <object>: a block object, or null when no block was found:
  • number (string; quantity): the block number; null when it's a pending block.
  • hash (string; data, 32 bytes): the hash of the block; null when it's a pending block.
  • parentHash (string; data, 32 bytes): the hash of the parent block.
  • nonce (string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.
  • sha3Uncles (string; data, 32 bytes): SHA3 of the uncles data in the block.
  • logsBloom (string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.
  • transactionsRoot (string; data, 32 bytes): the root of the transaction trie of the block.
  • stateRoot (string; data, 32 bytes): the root of the final state trie of the block.
  • receiptsRoot (string; data, 32 bytes): the root of the receipts trie of the block.
  • miner (string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.
  • difficulty (string; quantity): the difficulty for this block.
  • totalDifficulty (string; quantity): the total difficulty of the chain until this block.
  • extraData (string; data): the extra data field of this block.
  • size (string; quantity): the size of this block in bytes.
  • gasLimit (string; quantity): the maximum gas allowed in this block.
  • gasUsed (string; quantity): the total used gas by all transactions in this block.
  • timestamp (string; quantity): the unix timestamp for when the block was collated.
  • transactions (array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.
  • uncles (array of strings): an array of uncle hashes.

Request example

curl -X POST https://rpc.ankr.com/corn_maizenet/YOUR_ANKR_API_KEY \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getUncleByBlockHashAndIndex",
      "params": ["0xc9f7eeb52a2e215f695031412c7db6b8b0c2d6231dbeb2b5027f473f3982a4c8", "0x0"],
      "id": 1
    }'

Response example

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

---

eth_getUncleByBlockNumberAndIndex

Returns information about an uncle of a block by number and uncle index position.

Parameters

• id (integer; required): a request ID (example: 1).

• jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

• method (string; required): a method used for the request.

• params (array; required):

  1. <string> (quantity|tag): the hex value of a block number.
  2. <string> (quantity): the uncle's index position.

Returns

• <object>: a block object, or null when no block was found:
  • number (string; quantity): the block number; null when it's a pending block.
  • hash (string; data, 32 bytes): the hash of the block; null when it's a pending block.
  • parentHash (string; data, 32 bytes): the hash of the parent block.
  • nonce (string; data, 8 bytes): the hash of the generated proof-of-work; null when it's a pending block.
  • sha3Uncles (string; data, 32 bytes): SHA3 of the uncles data in the block.
  • logsBloom (string; data, 256 bytes): the bloom filter for the logs of the block. null when its pending block.
  • transactionsRoot (string; data, 32 bytes): the root of the transaction trie of the block.
  • stateRoot (string; data, 32 bytes): the root of the final state trie of the block.
  • receiptsRoot (string; data, 32 bytes): the root of the receipts trie of the block.
  • miner (string; data, 20 bytes): the address of the beneficiary to whom the mining rewards were given.
  • difficulty (string; quantity): the difficulty for this block.
  • totalDifficulty (string; quantity): the total difficulty of the chain until this block.
  • extraData (string; data): the extra data field of this block.
  • size (string; quantity): the size of this block in bytes.
  • gasLimit (string; quantity): the maximum gas allowed in this block.
  • gasUsed (string; quantity): the total used gas by all transactions in this block.
  • timestamp (string; quantity): the unix timestamp for when the block was collated.
  • transactions (array of strings): an array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter.
  • uncles (array of strings): an array of uncle hashes.

Request example

curl -X POST https://rpc.ankr.com/corn_maizenet/YOUR_ANKR_API_KEY \
-H 'Content-Type: application/json' \
-d '{
      "jsonrpc": "2.0",
      "method": "eth_getUncleByBlockNumberAndIndex",
      "params": ["0x2091C", "0x0"],
      "id": 1
    }'

Response example

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

---

eth_getLogs

Returns an array of all logs matching a given filter object.

Parameters

• id (integer; required): a request ID (example: 1).

• jsonrpc (string; required): a JSON RPC spec used (example: 2.0).

• method (string; required): a method used for the request.

• params (array; required):

  1. object: the filter options:

     • fromBlock (string; quantity|tag; optional; default: "latest"): either the block number or one of the following block tags:

       • latest: for the last mined block.
       • earliest: for the lowest numbered block available on the client.
       • pending: for not yet mined transactions.

     • toBlock (string; quantity|tag; optional; default: "latest"): either the block number or one of the following block tags:

       • latest: for the last mined block.
       • earliest: for the lowest numbered block available on the client.
       • pending: for not yet mined transactions.

     • address (array of strings; data, 20 bytes; optional): a contract address or a list of addresses from which logs should originate.

     • topics (array of strings; data; optional): an array of 32 bytes data topics. Topics are order-dependent. Each topic can also be an array of data with "or" options.

     • blockhash (string; data, 32 bytes; optional; future): with the addition of EIP-234, blockHash will be a new filter option which restricts the logs returned to the single block with the 32-byte hash blockHash. Using blockHash is equivalent to fromBlock = toBlock = the block number with hash blockHash. If blockHash is present in the filter criteria, then neither fromBlock nor toBlock are allowed.

Returns

• removed (string; tag): true when the log was removed, due to a chain reorganization; false if it's a valid log.
• logIndex (string; quantity): the log index position in the block; null when it's a pending log.
• transactionIndex (string; quantity): the transactions index position log was created from; null when it's a pending log.
• transactionHash (string; data, 32 bytes): a hash of the transactions this log was created from; null when it's a pending log.
• blockHash (string; data, 32 bytes): a hash of the block containing the log; null when it's pending; null when it's a pending log.
• blockNumber (string; quantity): the number of the block containing the log; null when it's pending; null when it's a pending log.
• address (string; data, 20 bytes): an address from which this log originated.
• data (string; data): contains one or more 32 bytes non-indexed arguments of the log.
• topics (array of strings; data): an array of 0 to 4 32 bytes data of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier.)

Request example

curl -X POST https://rpc.ankr.com/corn_maizenet/YOUR_ANKR_API_KEY \
-H 'Content-Type: application/json' \
-d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [{
        "fromBlock": "0x20",
        "toBlock": "0x30"
    }],
    "id": 1
}'

Response example

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": [
        {
            "address": "0x16ae0f42dc414c339b399459c4fdec10beeef975",
            "topics": [
                "0x141df868a6331af528e38c83b7aa03edc19be66e37ae67f9285bf4f8e3c6a1a8",
                "0x000000000000000000000000a6b71e26c5e0845f74c812102ca7114b6a896ab2"
            ],
            "data": "0x000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f48f2b2d2a534e402487b3ee7c18c33aec0fe5e40000000000000000000000000000000000000000000000000000000000000001000000000000000000000000cb416bf9b1c7caaf64aae813d1bb8f5c2a853182",
            "blockNumber": "0x2e",
            "transactionHash": "0x7a24256a4cc7d379b5a83fd4a8713dcd20b566dbe1b340d95d6e81089acb3a2e",
            "transactionIndex": "0x1",
            "blockHash": "0xfcd6d628bad142f1d5331e13a5956d8d1f59561d0a8aa551cca089cc2e348b2c",
            "logIndex": "0x0",
            "removed": false
        },
        {
            "address": "0xa6b71e26c5e0845f74c812102ca7114b6a896ab2",
            "topics": [
                "0x4f51faf6c4561ff95f067657e43439f0f856d97c04d9ec9070a6199ad418e235"
            ],
            "data": "0x00000000000000000000000016ae0f42dc414c339b399459c4fdec10beeef9750000000000000000000000003e5c63644e683549055b9be8653de26e0b4cd36e",
            "blockNumber": "0x2e",
            "transactionHash": "0x7a24256a4cc7d379b5a83fd4a8713dcd20b566dbe1b340d95d6e81089acb3a2e",
            "transactionIndex": "0x1",
            "blockHash": "0xfcd6d628bad142f1d5331e13a5956d8d1f59561d0a8aa551cca089cc2e348b2c",
            "logIndex": "0x1",
            "removed": false
        }
    ]
}