{ "openrpc": "1.2.6", "info": { "title": "Ritual Ethereum JSON-RPC API", "description": "Quicknode Ritual Ethereum JSON-RPC API reference", "version": "1.0.0" }, "methods": [ { "name": "eth_accounts", "summary": "Returns an array of addresses owned by the client.", "description": "Returns an array of addresses owned by the client. Since Quicknode does not store private keys, this will always return an empty response.", "params": [], "result": { "name": "result", "description": "An array of addresses owned by the client", "schema": { "type": "array", "items": {} } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_accounts" }, "examples": [ { "name": "eth_accounts example", "params": [], "result": { "name": "eth_accounts result", "value": [] } } ] }, { "name": "eth_blobBaseFee", "summary": "Returns the expected base fee for blobs in the next block.", "description": "Returns the expected base fee for blobs in the next block.", "params": [], "result": { "name": "result", "description": "The expected base fee in wei, represented in hexadecimal format", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_blobBaseFee" }, "examples": [ { "name": "eth_blobBaseFee example", "params": [], "result": { "name": "eth_blobBaseFee result", "value": "0x1" } } ] }, { "name": "eth_blockNumber", "summary": "Returns the latest block number of the blockchain.", "description": "Returns the latest block number of the blockchain.", "params": [], "result": { "name": "result", "description": "An integer value of the latest block number encoded as hexadecimal", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_blockNumber" }, "examples": [ { "name": "eth_blockNumber example", "params": [], "result": { "name": "eth_blockNumber result", "value": "0x1ecbd6f" } } ] }, { "name": "eth_call", "summary": "Executes a new message call immediately without creating a transaction on the block chain.", "description": "Executes a new message call immediately without creating a transaction on the block chain.", "params": [ { "name": "transaction", "description": "The transaction call object which contains the following fields:", "required": true, "schema": { "type": "object", "properties": { "from": { "type": "string", "description": "The address from which the transaction is sent" }, "to": { "type": "string", "description": "The address to which the transaction is addressed" }, "gas": { "type": "integer", "description": "The integer of gas provided for the transaction execution" }, "gasPrice": { "type": "integer", "description": "The integer of gasPrice used for each paid gas encoded as hexadecimal" }, "value": { "type": "integer", "description": "The integer of value sent with this transaction encoded as hexadecimal" }, "data": { "type": "string", "description": "The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation" } }, "description": "The transaction call object which contains the following fields:" } }, { "name": "blockNumber/tag", "description": "The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized", "required": true, "schema": { "type": "string" } }, { "name": "Object", "description": "The State Override Set option allows you to change the state of a contract before executing the call, which means you can modify the values of variables stored in the contract, such as balances and approvals for that call without actually modifying the contract. Each address maps to an object containing:", "schema": { "type": "object", "properties": { "balance": { "type": "string", "description": "The fake balance to set for the account before executing the call" }, "nonce": { "type": "string", "description": "The fake nonce to set for the account before executing the call" }, "code": { "type": "string", "description": "The fake EVM bytecode to inject into the account before executing the call" }, "state": { "type": "object", "description": "The fake key-value mapping to override all slots in the account storage before executing the call" }, "stateDiff": { "type": "integer", "description": "The fake key-value mapping to override individual slots in the account storage before executing the call" } }, "description": "The State Override Set option allows you to change the state of a contract before executing the call, which means you can modify the values of variables stored in the contract, such as balances and approvals for that call without actually modifying the contract. Each address maps to an object containing:" } } ], "result": { "name": "data", "description": "The return value of the executed contract method", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_call" }, "examples": [ { "name": "eth_call example", "params": [ { "name": "blockNumber/tag", "value": "0x50000" } ], "result": { "name": "eth_call result", "value": "0x" } } ] }, { "name": "eth_chainId", "summary": "Returns the current network/chain ID, used to sign replay-protected transaction introduced in EIP-155.", "description": "Returns the current network/chain ID, used to sign replay-protected transaction introduced in EIP-155.", "params": [], "result": { "name": "chain ID", "description": "It returns a hexadecimal value in string format which represents an integer of the chain ID", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_chainId" }, "examples": [ { "name": "eth_chainId example", "params": [], "result": { "name": "eth_chainId result", "value": "0x310" } } ] }, { "name": "eth_estimateGas", "summary": "Returns an estimation of gas for a given transaction.", "description": "Returns an estimation of gas for a given transaction.", "params": [ { "name": "transaction", "description": "The transaction call object:", "required": true, "schema": { "type": "object", "properties": { "from": { "type": "string", "description": "The address from which the transaction is sent" }, "to": { "type": "string", "description": "The address to which the transaction is addressed" }, "gas": { "type": "integer", "description": "The integer of gas provided for the transaction execution" }, "gasPrice": { "type": "integer", "description": "The integer of gasPrice used for each paid gas encoded as hexadecimal" }, "value": { "type": "integer", "description": "The integer of value sent with this transaction encoded as hexadecimal" }, "data": { "type": "string", "description": "The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation." } }, "description": "The transaction call object:" } }, { "name": "blockNumber", "description": "The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized", "schema": { "type": "string" } } ], "result": { "name": "quantity", "description": "The estimated amount of gas used", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_estimateGas" }, "examples": [ { "name": "eth_estimateGas example", "params": [ { "name": "blockNumber", "value": "0x50000" } ], "result": { "name": "eth_estimateGas result", "value": "0x5208" } } ] }, { "name": "eth_feeHistory", "summary": "Returns the collection of historical gas information.", "description": "Returns the collection of historical gas information.", "params": [ { "name": "blockCount", "description": "The number of blocks in the requested range. Between 1 and 1024 blocks can be requested in a single query. It will return less than the requested range if not all blocks are available", "required": true, "schema": { "type": [ "string", "integer" ] } }, { "name": "newestBlock", "description": "The highest number block of the requested range in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators", "required": true, "schema": { "type": "string" } }, { "name": "rewardPercentiles", "description": "A list of percentile values with a monotonic increase in value. The transactions will be ranked by effective tip per gas for each block in the requested range, and the corresponding effective tip for the percentile will be calculated while taking gas consumption into consideration", "required": true, "schema": { "type": "array", "items": {} } } ], "result": { "name": "object", "description": "Fee history object containing the following fields:", "schema": { "type": "object", "properties": { "oldestBlock": { "type": "string", "description": "The lowest number block of the returned range encoded in hexadecimal" }, "baseFeePerGas": { "type": "array", "items": {}, "description": "An array of block base fees per gas. This includes the next block after the newest of the returned range, because this value can be derived from the newest block. Zeroes are returned for pre-EIP-1559 blocks" }, "baseFeePerBlobGas": { "type": "array", "items": {}, "description": "An array of block base fees per blob gas. Zeroes are returned for pre-EIP-4844 blocks" }, "gasUsedRatio": { "type": "array", "items": {}, "description": "An array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit" }, "blobGasUsedRatio": { "type": "array", "items": {}, "description": "An array of block blob gas used ratios. These are calculated as the ratio of blobGasUsed and the max blob gas per block" }, "reward": { "type": "array", "items": {}, "description": "An array of effective priority fee per gas data points from a single block. All zeroes are returned if the block is empty" } }, "description": "Fee history object containing the following fields:" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_feeHistory" }, "examples": [ { "name": "eth_feeHistory example", "params": [ { "name": "blockCount", "value": "0x4" }, { "name": "newestBlock", "value": "latest" }, { "name": "rewardPercentiles", "value": [ 25, 75 ] } ], "result": { "name": "eth_feeHistory result", "value": { "baseFeePerGas": [ "0x8", "0x8", "0x8", "0x8", "0x8" ], "gasUsedRatio": [ 0.00434582, 0.00434582, 0.00434582, 0.00434582 ], "baseFeePerBlobGas": [ "0x1", "0x1", "0x1", "0x1", "0x1" ], "blobGasUsedRatio": [ 0, 0, 0, 0 ], "oldestBlock": "0x1ecbd6f", "reward": [ [ "0x0", "0x0" ], [ "0x0", "0x0" ], [ "0x0", "0x0" ], [ "0x0", "0x0" ] ] } } } ] }, { "name": "eth_gasPrice", "summary": "Returns the current gas price on the network in wei.", "description": "Returns the current gas price on the network in wei.", "params": [], "result": { "name": "result", "description": "The hexadecimal value of the current gas price in wei", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_gasPrice" }, "examples": [ { "name": "eth_gasPrice example", "params": [], "result": { "name": "eth_gasPrice result", "value": "0x8" } } ] }, { "name": "eth_getBalance", "summary": "Returns the balance of given account address in wei.", "description": "Returns the balance of given account address in wei.", "params": [ { "name": "address", "description": "The address (20 bytes) to check for balance", "required": true, "schema": { "type": "string" } }, { "name": "blockNumber/tag", "description": "The block number in hexadecimal format or the tags (latest, earliest, pending, safe or finalized)", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The ETH balance of the specified address in hexadecimal value, measured in wei", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getBalance" }, "examples": [ { "name": "eth_getBalance example", "params": [ { "name": "address", "value": "0x3f91da51aa4a5c42f3882c5b5a81ed308413e7f0" }, { "name": "blockNumber/tag", "value": "0x50000" } ], "result": { "name": "eth_getBalance result", "value": "0x0" } } ] }, { "name": "eth_getBlockByHash", "summary": "Returns information of the block matching the given block hash.", "description": "Returns information of the block matching the given block hash.", "params": [ { "name": "hash", "description": "The hash (32 bytes) of the block", "required": true, "schema": { "type": "string" } }, { "name": "transaction detail flag", "description": "It returns the full transaction objects when it is true otherwise it returns only the hashes of the transactions", "required": true, "schema": { "type": "boolean" } } ], "result": { "name": "object", "description": "A block object, or null when no block was found:", "schema": { "type": "object", "properties": { "baseFeePerGas": { "type": "string", "description": "(Optional) A string of the base fee encoded in hexadecimal format. Please note that this response field will not be included in a block requested before the EIP-1559 upgrade" }, "blobGasUsed": { "type": "string", "description": "The amount of gas used by the blob" }, "difficulty": { "type": "string", "description": "The integer of the difficulty for this block encoded as a hexadecimal" }, "excessBlobGas": { "type": "string", "description": "The excess gas used by the blob" }, "extraData": { "type": "string", "description": "The “extra data” field of this block" }, "gasLimit": { "type": "string", "description": "The maximum gas allowed in this block encoded as a hexadecimal" }, "gasUsed": { "type": "string", "description": "The total used gas by all transactions in this block encoded as a hexadecimal" }, "hash": { "type": "string", "description": "The block hash of the requested block. null if pending" }, "logsBloom": { "type": "string", "description": "The bloom filter for the logs of the block. null if pending" }, "miner": { "type": "string", "description": "The address of the beneficiary to whom the mining rewards were given" }, "mixHash": { "type": "string", "description": "A string of a 256-bit hash encoded as a hexadecimal" }, "nonce": { "type": "string", "description": "The hash of the generated proof-of-work. null if pending" }, "number": { "type": "string", "description": "The block number of the requested block encoded as a hexadecimal. null if pending" }, "parentBeaconBlockRoot": { "type": "string", "description": "The root of the parent beacon block in hexadecimal format" }, "parentHash": { "type": "string", "description": "The hash of the parent block" }, "receiptsRoot": { "type": "string", "description": "The root of the receipts trie of the block" }, "sha3Uncles": { "type": "string", "description": "The SHA3 of the uncles data in the block" }, "size": { "type": "string", "description": "The size of this block in bytes as an Integer value encoded as hexadecimal" }, "stateRoot": { "type": "string", "description": "The root of the final state trie of the block" }, "timestamp": { "type": "string", "description": "The unix timestamp for when the block was collated" }, "transactions": { "type": "array", "items": {}, "description": "An array of transaction objects" }, "transactionsRoot": { "type": "string", "description": "The root of the transaction trie of the block" }, "uncles": { "type": "array", "items": {}, "description": "An array of uncle hashes" }, "withdrawals": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "string", "description": "The index of the withdrawal to uniquely identify each withdrawal" }, "validatorIndex": { "type": "string", "description": "The index of the validator who initiated the withdrawal" }, "address": { "type": "string", "description": "The address to which the withdrawn amount is sent" }, "amount": { "type": "string", "description": "The amount of ether, provided in hexadecimal format, corresponding to a certain value in gwei" } } }, "description": "A withdrawals object contains information about withdrawals made by validators. Please note that this field will not be included in a block requested before the EIP-4895 upgrade" }, "withdrawalsRoot": { "type": "string", "description": "The Merkle root of withdrawal data. Also, please note that this field will not be included in a block requested before the EIP-4895 upgrade" }, "requestsHash": { "type": "string", "description": "The hash of the requests in the block. Present after the Pectra upgrade" } }, "description": "A block object, or null when no block was found:" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getBlockByHash" }, "examples": [ { "name": "eth_getBlockByHash example", "params": [ { "name": "hash", "value": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b" }, { "name": "transaction detail flag", "value": false } ], "result": { "name": "eth_getBlockByHash result", "value": { "hash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "parentHash": "0x4377b6cc02b83b768faa0d36371b6f6c9a42c300ba50446bf8727b0927b9bf1a", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "miner": "0x514708beda3441cc4e141f8546c096eaab7c8a05", "stateRoot": "0xb513f1d1427a1748379fdc054cf8a7b74ca8e70189014c1ce17f34eee1bed9f9", "transactionsRoot": "0xbe4350d9ffa7f82ad7af33d2b8b7279a5b7167b728107b61487f1ac7f0929c45", "receiptsRoot": "0x558eef27308bc0ae1df25e3c9fa7358206c6eca7591f1990bd6c273aa56fc4cb", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000010000000000000400000000000000800000000008001000000000000000000800080000000000000000000000020000000000000000040800000000000000000002000010000000000004000000000000400000000200000000020000000000000000002000002000000000000000000000000000000000000000000000000000000000000000000001000002000000000000000000000000000000000000000000000000008020000000000000000000000000000000000000000000000000200000000000000000", "difficulty": "0x0", "number": "0x50000", "gasLimit": "0x2faf080", "gasUsed": "0x350cb", "timestamp": "0x6a8e16c4", "extraData": "0x726574682f76322e322e302f6c696e7578", "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000", "nonce": "0x0000000000000000", "baseFeePerGas": "0x8", "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "blobGasUsed": "0x0", "excessBlobGas": "0x0", "parentBeaconBlockRoot": "0x0101010101010101010101010101010101010101010101010101010101010101", "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "size": "0x2d2", "uncles": [], "transactions": [ "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4" ], "withdrawals": [] } } } ] }, { "name": "eth_getBlockByNumber", "summary": "Returns information of the block matching the given block number.", "description": "Returns information of the block matching the given block number.", "params": [ { "name": "blockNumber/tag", "description": "The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized", "required": true, "schema": { "type": "string" } }, { "name": "transaction detail flag", "description": "The method returns the full transaction objects when this value is true otherwise, it returns only the hashes of the transactions", "required": true, "schema": { "type": "boolean" } } ], "result": { "name": "object", "description": "A block object, or null when no block was found:", "schema": { "type": "object", "properties": { "baseFeePerGas": { "type": "string", "description": "(Optional) A string of the base fee encoded in hexadecimal format. Please note that this response field will not be included in a block requested before the EIP-1559 upgrade" }, "blobGasUsed": { "type": "string", "description": "The amount of gas used by the blob" }, "difficulty": { "type": "string", "description": "The integer of the difficulty for this block encoded as a hexadecimal" }, "excessBlobGas": { "type": "string", "description": "The excess gas used by the blob" }, "extraData": { "type": "string", "description": "The “extra data” field of this block" }, "gasLimit": { "type": "string", "description": "The maximum gas allowed in this block encoded as a hexadecimal" }, "gasUsed": { "type": "string", "description": "The total used gas by all transactions in this block encoded as a hexadecimal" }, "hash": { "type": "string", "description": "The block hash of the requested block. null if pending" }, "logsBloom": { "type": "string", "description": "The bloom filter for the logs of the block. null if pending" }, "miner": { "type": "string", "description": "The address of the beneficiary to whom the mining rewards were given" }, "mixHash": { "type": "string", "description": "A string of a 256-bit hash encoded as a hexadecimal" }, "nonce": { "type": "string", "description": "The hash of the generated proof-of-work. null if pending" }, "number": { "type": "string", "description": "The block number of the requested block encoded as a hexadecimal. null if pending" }, "parentBeaconBlockRoot": { "type": "string", "description": "The root of the parent beacon block in hexadecimal format" }, "parentHash": { "type": "string", "description": "The hash of the parent block" }, "receiptsRoot": { "type": "string", "description": "The root of the receipts trie of the block" }, "sha3Uncles": { "type": "string", "description": "The SHA3 of the uncles data in the block" }, "size": { "type": "string", "description": "The size of this block in bytes as an Integer value encoded as hexadecimal" }, "stateRoot": { "type": "string", "description": "The root of the final state trie of the block" }, "timestamp": { "type": "string", "description": "The unix timestamp for when the block was collated" }, "transactions": { "type": "array", "items": {}, "description": "An array of transaction objects" }, "transactionsRoot": { "type": "string", "description": "The root of the transaction trie of the block" }, "uncles": { "type": "array", "items": {}, "description": "An array of uncle hashes" }, "withdrawals": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "string", "description": "The index of the withdrawal to uniquely identify each withdrawal" }, "validatorIndex": { "type": "string", "description": "The index of the validator who initiated the withdrawal" }, "address": { "type": "string", "description": "The address to which the withdrawn amount is sent" }, "amount": { "type": "string", "description": "The amount of ether, provided in hexadecimal format, corresponding to a certain value in gwei" } } }, "description": "A withdrawals object contains information about withdrawals made by validators. Please note that this field will not be included in a block requested before the EIP-4895 upgrade" }, "withdrawalsRoot": { "type": "string", "description": "The Merkle root of withdrawal data. Also, please note that this field will not be included in a block requested before the EIP-4895 upgrade" }, "requestsHash": { "type": "string", "description": "The hash of the requests in the block. Present after the Pectra upgrade" } }, "description": "A block object, or null when no block was found:" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getBlockByNumber" }, "examples": [ { "name": "eth_getBlockByNumber example", "params": [ { "name": "blockNumber/tag", "value": "0x50000" }, { "name": "transaction detail flag", "value": false } ], "result": { "name": "eth_getBlockByNumber result", "value": { "hash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "parentHash": "0x4377b6cc02b83b768faa0d36371b6f6c9a42c300ba50446bf8727b0927b9bf1a", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "miner": "0x514708beda3441cc4e141f8546c096eaab7c8a05", "stateRoot": "0xb513f1d1427a1748379fdc054cf8a7b74ca8e70189014c1ce17f34eee1bed9f9", "transactionsRoot": "0xbe4350d9ffa7f82ad7af33d2b8b7279a5b7167b728107b61487f1ac7f0929c45", "receiptsRoot": "0x558eef27308bc0ae1df25e3c9fa7358206c6eca7591f1990bd6c273aa56fc4cb", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000010000000000000400000000000000800000000008001000000000000000000800080000000000000000000000020000000000000000040800000000000000000002000010000000000004000000000000400000000200000000020000000000000000002000002000000000000000000000000000000000000000000000000000000000000000000001000002000000000000000000000000000000000000000000000000008020000000000000000000000000000000000000000000000000200000000000000000", "difficulty": "0x0", "number": "0x50000", "gasLimit": "0x2faf080", "gasUsed": "0x350cb", "timestamp": "0x6a8e16c4", "extraData": "0x726574682f76322e322e302f6c696e7578", "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000", "nonce": "0x0000000000000000", "baseFeePerGas": "0x8", "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "blobGasUsed": "0x0", "excessBlobGas": "0x0", "parentBeaconBlockRoot": "0x0101010101010101010101010101010101010101010101010101010101010101", "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "size": "0x2d2", "uncles": [], "transactions": [ "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4" ], "withdrawals": [] } } } ] }, { "name": "eth_getBlockReceipts", "summary": "Returns all transaction receipts for a given block.", "description": "Returns all transaction receipts for a given block.", "params": [ { "name": "blockNumber", "description": "The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "An array of transaction receipt objects", "schema": { "type": "array", "items": { "type": "object", "properties": { "blockHash": { "type": "string", "description": "The hash of the block containing this transaction" }, "blockNumber": { "type": "string", "description": "The block number containing this transaction in hexadecimal" }, "contractAddress": { "type": [ "string", "null" ], "description": "The contract address created if the transaction was a contract creation, otherwise null" }, "cumulativeGasUsed": { "type": "string", "description": "The total amount of gas used when this transaction was executed in the block in hexadecimal" }, "blobGasUsed": { "type": "string", "description": "(Conditional) The amount of blob gas used in the transaction in hexadecimal (for EIP-4844 blob transactions)" }, "effectiveGasPrice": { "type": "string", "description": "The actual value per gas deducted from the sender account in hexadecimal" }, "from": { "type": "string", "description": "The address of the sender" }, "gasUsed": { "type": "string", "description": "The amount of gas used by this specific transaction alone in hexadecimal" }, "logs": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log originated" }, "topics": { "type": "array", "items": {}, "description": "Array of 0 to 4 32-byte topics (encoded data - usually event parameters)" }, "data": { "type": "string", "description": "Contains the non-indexed arguments of the log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in hexadecimal, null when pending" }, "transactionHash": { "type": "string", "description": "The hash of the transaction this log was created from, null when pending" }, "transactionIndex": { "type": "string", "description": "The index position of the transaction in the block in hexadecimal" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in, null when pending" }, "blockTimestamp": { "type": "string", "description": "The timestamp of the block where this log was in hexadecimal" }, "logIndex": { "type": "string", "description": "The index position of the log in the block in hexadecimal" }, "removed": { "type": "boolean", "description": "True when the log was removed due to a chain reorganization, false if valid" } } }, "description": "Array of log objects that were generated during the transaction" }, "logsBloom": { "type": "string", "description": "A bloom filter of logs/events generated during this transaction" }, "status": { "type": "string", "description": "The transaction status: 0x1 for success or 0x0 for failure" }, "to": { "type": "string", "description": "The address of the receiver. null when its a contract creation transaction" }, "transactionHash": { "type": "string", "description": "The hash of the transaction" }, "transactionIndex": { "type": "string", "description": "The transaction's index position in the block in hexadecimal" }, "type": { "type": "string", "description": "The transaction type in hexadecimal (e.g., 0x0 for legacy, 0x2 for EIP-1559, 0x7e for deposit transactions)" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getBlockReceipts" }, "examples": [ { "name": "eth_getBlockReceipts example", "params": [ { "name": "blockNumber", "value": "0x50000" } ], "result": { "name": "eth_getBlockReceipts result", "value": [ { "type": "0x13", "status": "0x1", "cumulativeGasUsed": "0x350cb", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000010000000000000400000000000000800000000008001000000000000000000800080000000000000000000000020000000000000000040800000000000000000002000010000000000004000000000000400000000200000000020000000000000000002000002000000000000000000000000000000000000000000000000000000000000000000001000002000000000000000000000000000000000000000000000000008020000000000000000000000000000000000000000000000000200000000000000000", "logs": [ { "address": "0x2804ada1c219e50898e75b2bd052030580f4fbac", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000006afc5949c97c004d7de8deecd4256c018fa58e10" ], "data": "0x0000000000000000000000000000000000000000000000000000604ab6715704", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x0", "removed": false }, { "address": "0x2804ada1c219e50898e75b2bd052030580f4fbac", "topics": [ "0xfb0e1482d62102ab9594f69d4c6d693749e3e2bf1c21af272f5456b2d5a4f6b5" ], "data": "0x0000000000000000000000000000000000000000000000003311fc80a57000000000000000000000000000000000000000000000000000000470de4df8200000", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x1", "removed": false }, { "address": "0x0000000000000000000000000000000000002002", "topics": [ "0xe34918ff1c7084970068b53fd71ad6d8b04e9f15d3886cbf006443e6cdc52ea6", "0x0000000000000000000000006afc5949c97c004d7de8deecd4256c018fa58e10" ], "data": "0x0000000000000000000000000000000000000000000000003782dace9d900000", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x2", "removed": false }, { "address": "0x0000000000000000000000000000000000002005", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000006afc5949c97c004d7de8deecd4256c018fa58e10" ], "data": "0x000000000000000000000000000000000000000000000000352a8e9703dac68e", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x3", "removed": false } ], "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "gasUsed": "0x350cb", "effectiveGasPrice": "0x0", "from": "0xfffffffffffffffffffffffffffffffffffffffe", "to": "0x0000000000000000000000000000000000002002", "contractAddress": null } ] } } ] }, { "name": "eth_getBlockTransactionCountByHash", "summary": "Returns the number of transactions for the block matching the given block hash.", "description": "Returns the number of transactions for the block matching the given block hash.", "params": [ { "name": "hash", "description": "The hash of the block", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The number of transactions associated with a specific block, in hexadecimal value", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getBlockTransactionCountByHash" }, "examples": [ { "name": "eth_getBlockTransactionCountByHash example", "params": [ { "name": "hash", "value": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b" } ], "result": { "name": "eth_getBlockTransactionCountByHash result", "value": "0x1" } } ] }, { "name": "eth_getBlockTransactionCountByNumber", "summary": "Returns the number of transactions for the block matching the given block number.", "description": "Returns the number of transactions for the block matching the given block number.", "params": [ { "name": "blockNumber", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The number of transactions in a specific block represented in hexadecimal format", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getBlockTransactionCountByNumber" }, "examples": [ { "name": "eth_getBlockTransactionCountByNumber example", "params": [ { "name": "blockNumber", "value": "0x50000" } ], "result": { "name": "eth_getBlockTransactionCountByNumber result", "value": "0x1" } } ] }, { "name": "eth_getCode", "summary": "Returns the compiled bytecode of a smart contract.", "description": "Returns the compiled bytecode of a smart contract.", "params": [ { "name": "address", "description": "The address of the smart contract from which the bytecode will be obtained", "required": true, "schema": { "type": "string" } }, { "name": "blockNumber", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The bytecode from a given address returned as a string", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getCode" }, "examples": [ { "name": "eth_getCode example", "params": [ { "name": "address", "value": "0x3f91da51aa4a5c42f3882c5b5a81ed308413e7f0" }, { "name": "blockNumber", "value": "0x50000" } ], "result": { "name": "eth_getCode result", "value": "0x" } } ] }, { "name": "eth_getFilterChanges", "summary": "Polling method for a filter, which returns an array of events that have occurred since the last poll.", "description": "Polling method for a filter, which returns an array of events that have occurred since the last poll.", "params": [ { "name": "filter ID", "description": "The filter id that is returned from eth_newFilter, eth_newBlockFilter Create a filter with eth_newFilter on this endpoint first, then replace YOUR_FILTER_ID with the returned ID before it expires.", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "Changes since the last poll. Log filters return log objects; block and pending-transaction filters return hashes. An empty array means there are no new changes.", "schema": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log originated" }, "topics": { "type": "array", "items": {}, "description": "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)" }, "data": { "type": "string", "description": "It contains one or more 32 Bytes non-indexed arguments of the log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when its pending. Null when it's a pending log" }, "transactionHash": { "type": "string", "description": "The hash of the transaction from which this log was created from. null if the log is pending" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. Null when it's a pending log" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in. Null when it's a pending log" }, "logIndex": { "type": "string", "description": "The integer of the log index position in the block. Null when it's a pending log" }, "removed": { "type": "boolean", "description": "It is true if log was removed, due to a chain reorganization and false if it's a valid log" }, "blockTimestamp": { "type": "string", "description": "Timestamp of the containing block, encoded as hexadecimal." } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getFilterChanges" }, "examples": [ { "name": "eth_getFilterChanges example", "params": [ { "name": "filter ID", "value": "YOUR_FILTER_ID" } ], "result": { "name": "eth_getFilterChanges result", "value": [ { "address": "0x0000000000000000000000000000000000002002", "topics": [ "0xe34918ff1c7084970068b53fd71ad6d8b04e9f15d3886cbf006443e6cdc52ea6", "0x0000000000000000000000006afc5949c97c004d7de8deecd4256c018fa58e10" ], "data": "0x0000000000000000000000000000000000000000000000003782dace9d900000", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x2", "removed": false } ] } } ] }, { "name": "eth_getFilterLogs", "summary": "Returns an array of all logs matching filter with given id.", "description": "Returns an array of all logs matching filter with given id.", "params": [ { "name": "id", "description": "The filter ID Create a filter with eth_newFilter on this endpoint first, then replace YOUR_FILTER_ID with the returned ID before it expires.", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "An array of log objects, or an empty array if nothing has changed since last poll", "schema": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log originated" }, "topics": { "type": "array", "items": {}, "description": "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)" }, "data": { "type": "string", "description": "It contains one or more 32 Bytes non-indexed arguments of the log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when its pending. Null when it's a pending log" }, "transactionHash": { "type": "string", "description": "The hash of the transaction from which this log was created from. null if the log is pending" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. Null when it's a pending log" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in. Null when it's a pending log" }, "logIndex": { "type": "string", "description": "The integer of the log index position in the block. Null when it's a pending log" }, "removed": { "type": "boolean", "description": "It is true if log was removed, due to a chain reorganization and false if it's a valid log" }, "blockTimestamp": { "type": "string", "description": "Timestamp of the containing block, encoded as hexadecimal." } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getFilterLogs" }, "examples": [ { "name": "eth_getFilterLogs example", "params": [ { "name": "id", "value": "YOUR_FILTER_ID" } ], "result": { "name": "eth_getFilterLogs result", "value": [ { "address": "0x0000000000000000000000000000000000002002", "topics": [ "0xe34918ff1c7084970068b53fd71ad6d8b04e9f15d3886cbf006443e6cdc52ea6", "0x0000000000000000000000006afc5949c97c004d7de8deecd4256c018fa58e10" ], "data": "0x0000000000000000000000000000000000000000000000003782dace9d900000", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x2", "removed": false } ] } } ] }, { "name": "eth_getLogs", "summary": "Returns an array of all logs matching a given filter object.", "description": "Returns an array of all logs matching a given filter object.", "params": [ { "name": "object", "description": "The transaction call object which contains the following fields", "required": true, "schema": { "type": "object", "properties": { "fromBlock": { "type": "string", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators" }, "toBlock": { "type": "string", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators" }, "address": { "type": "string", "description": "The contract address or a list of addresses from which logs should originate" }, "topics": { "type": "array", "items": {}, "description": "An array of DATA topics and also, the topics are order-dependent. Visit this official page to learn more about topics" }, "blockHash": { "type": "string", "description": "With the addition of EIP-234, blockHash is a new filter option that restricts the logs returned to the block number referenced in the blockHash. Using the blockHash field is equivalent to setting the fromBlock and toBlock to the block number the blockHash references. If blockHash is present in the filter criteria, neither fromBlock nor toBlock is allowed" } }, "description": "The transaction call object which contains the following fields" } } ], "result": { "name": "result", "description": "An array of log objects, or an empty array if nothing has changed since last poll", "schema": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log originated" }, "topics": { "type": "array", "items": {}, "description": "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)" }, "data": { "type": "string", "description": "It contains one or more 32 Bytes non-indexed arguments of the log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when its pending. Null when it's a pending log" }, "transactionHash": { "type": "string", "description": "The hash of the transaction from which this log was created from. null if the log is pending" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. Null when it's a pending log" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in. Null when it's a pending log" }, "logIndex": { "type": "string", "description": "The integer of the log index position in the block. Null when it's a pending log" }, "removed": { "type": "boolean", "description": "It is true if log was removed, due to a chain reorganization and false if it's a valid log" }, "blockTimestamp": { "type": "string", "description": "The timestamp of the block in which the log was included, encoded as hexadecimal" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getLogs" }, "examples": [ { "name": "eth_getLogs example", "params": [], "result": { "name": "eth_getLogs result", "value": [ { "address": "0x0000000000000000000000000000000000002002", "topics": [ "0xe34918ff1c7084970068b53fd71ad6d8b04e9f15d3886cbf006443e6cdc52ea6", "0x0000000000000000000000006afc5949c97c004d7de8deecd4256c018fa58e10" ], "data": "0x0000000000000000000000000000000000000000000000003782dace9d900000", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x2", "removed": false } ] } } ] }, { "name": "eth_getProof", "summary": "Returns the account and storage values of the specified account including the Merkle-proof.", "description": "Returns the account and storage values of the specified account including the Merkle-proof.", "params": [ { "name": "address", "description": "The address of the account for which the balance is to be checked", "required": true, "schema": { "type": "string" } }, { "name": "storageKeys", "description": "An array of storage-keys that should be proofed and included", "required": true, "schema": { "type": "array", "items": {} } }, { "name": "blockNumber", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. This endpoint limits proofs to the latest 10,000 blocks.", "schema": { "type": "string" } } ], "result": { "name": "result", "description": "eth_getProof result", "schema": { "type": "object", "properties": { "address": { "type": "string", "description": "The address associated with the account" }, "accountProof": { "type": "array", "items": {}, "description": "An array of rlp-serialized MerkleTree-Nodes which starts with the stateRoot-Node and follows the path of the SHA3 address as key" }, "balance": { "type": "string", "description": "The account balance" }, "codeHash": { "type": "string", "description": "A 32 byte hash of the code of the account" }, "nonce": { "type": "string", "description": "Number of transactions sent by the account, encoded as hexadecimal." }, "storageHash": { "type": "string", "description": "A 32 byte SHA3 of the storageRoot. All storage will deliver a MerkleProof starting with this rootHash" }, "storageProof": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The requested storage key" }, "value": { "type": "string", "description": "The storage value" }, "proof": { "type": "array", "items": {}, "description": "An array of rlp-serialized MerkleTree-Nodes which starts with the stateRoot-Node and follows the path of the SHA3 address as key" } } }, "description": "An array of storage-entries as requested. Each entry is an object with the following fields:" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getProof" }, "examples": [ { "name": "eth_getProof example", "params": [ { "name": "address", "value": "0x3f91da51aa4a5c42f3882c5b5a81ed308413e7f0" }, { "name": "storageKeys", "value": [ "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421" ] }, { "name": "blockNumber", "value": "latest" } ], "result": { "name": "eth_getProof result", "value": { "address": "0x3f91da51aa4a5c42f3882c5b5a81ed308413e7f0", "balance": "0x0", "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470", "nonce": "0x0", "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "accountProof": [ "0xf90211a03ccff1849b819c9871b65d3f813c1ea3ed3cb4fe595b9b48b3d1069d647be818a067ffb44f9fc956935f707fd918a4a39302f82b511bb82cfe32c6f2193f7009cca01cbfb6e13655ab55bf74260f303a231ecdf8addb5fec281167260791a7c72483a07142a305abeb31fd96e742614f8a3a9beb69ac4ac7d16c82a9fd72c85ab1ba39a0f2e71b2b4499a7c1e38ae398cd79f949943ffc2338206dc76842c737ebf7b099a03b06751336b2b7238ad4c73083b83789db2ee48b9df2250d0d2a55a1a7a60b3ea02992c3d35db9749c80eb5f3b9d49d4b4a617f601dd130ef564135d9cdfdb431da0c2803a832f18cec21d8f1d2e5f29408124889edcfdbecec47e4476af6b6716ada0c150fd03813ad2c3b5b8bbab40ecb397c2f12b2888cd4ea6de96a235d749b1e9a08acf08ad4b2aa4afddbbed06ee7572bc3a8608f7062f57156b8b01723e8e6ffca0a29198efe10bb4c1a311318be64119f9bdf2ff1aac44134f09403a3428447182a04c62c42a5edf7f3db2f0fed07746f8bfc3477cb4d6f81e8bfb38e08492e7f6dea0ec811634cccf09e418157b0ee22f46f05ac305b140af1087806244c0e3e5e0c5a0f33f3c660e12a14c75f64009411adea0729f16a82141a977187e055ec595e364a0df0bac42823b663c83086119a5c5414e850e64704a8119b5cc33d4bd9d360ea7a0b5b4d3988246a41e05703152a1ea12396c745dfd9b28db1b41944b92c784e0d580", "0xf90211a0a482456af5f988ca08701f4f410c4bc58fbe95efc10667956287a63ba1ce3c22a06dfada04367a9f9115d4bfeee5e1ea1486c8eff5666ec1cf1946c0f5626edd4fa078e4c6e5e813b8285066016eb67a9938d3e52adde0518e2f7e50ba8c55dbac2da05cbd90576b145ff552d244a82d3ff61505674f194fec1aa0d28b3fd7e5a7f040a071caf96643cfa0f63741eb0ef8eee7793ed0c2b44c0729896c54de6157807e44a0c44d7487a63b29d1ed5eaef104702eedfca293c250d4879ad57994849c94f4faa0fd1d8875c04aa425bcd508d611f0784887d1c0ce16ef6005f128f449ef7cf44ba0df6d607fd79d68d3744bfd76739f3fcfec141315db247d01974cf793bee1772fa06f09efd58d3c6be62c528d1b201d0ac78a9fc5b5b9a0edd3e24956d869eb0fb4a03ae9747f181a3692d9523376dba3e16bdaeab3a4dfbbaae02371678fba296898a0196bb1ea97e1ae44025ffe153af00f53f0cf6b8a57dbcb7f65aea401a3db47b1a0fac42d70bdd642ef70542a4b3896dca179c6ab03d1bb713c8913790e6fd9bcc6a02527fde4e727f1850325e77d98c309697b6ea8363ca9c6d72f79d558a71d5c26a0e95d44ba490f41fa69606f74879be2539124a5436d2200802ee5861bc3f7936aa02140341f82081fe261aa0917078f14e48b7017ee79af4131d15ae9e76eaa2c64a0d50000f0046d55bcf83d5dbfc757b123afbf581a9452ab5d28ecf6627c50a10680", "0xf90211a090235e241090a07d2d9dd2994f708525dd7b90dbb86772013a187cbf7c8da374a07500353354fbaf6b88812563375219fb13ecddcad8686353da977741522ef326a0d4969cc3ed2c4505cdf58ab67a32d868f64e37d8396b2f18c7468b71f5a0c159a002f3bb5b6ffacb7ab9fd0d2d5c7a48af05e4840cdaea2ff77480bf919cd0d444a0b8967376477249f3d1bced7faee7d264cabe5ffe677bd16f3bfe46c1b31b330ea0afb1dffc85a4cf03cb724c62deeee0b2ccb0f8c3f3e5cc4d0f0602b2628f14aea0ee5e4614ee57b3484d40d0fc4cce663e94aea9e6b8157454bec57b90a07d2765a02a4f9ae331d20492078caae92f5a39fd01a49be4b7b9f2906e9ad9bb500b61cfa0d88129c25a9148d1ca190078df7e3d74c76854e0c407ca929b71335bea9a3ddda0cbadfddf26dc643adcc1d95822999e858f8d4f30c1f580c39282186cff81a1f2a00d3abd757f33964fca51e1c9f131e53cee3cb5385f9caa0e575ef2be2117956ca0d6c569316334094070f365b8b373eee084ac91b17647f8e94787e0894ee550dfa0db4ca07f9e52259b5ac5f148ca2bfd329891c3ad6d7941b26914b257761792d8a0ecbca2c077b2a032abef1e110dc5ed8a042adf5670ce67368438ac201eea8bcea0dbee5f3570153a0a17ded13c4339e4317cf0cbec5ed168a861c4127411596c14a01b08b75a740f951de2e239c10e65b9d509da3de66b690c02cea7acf3d326fa5a80", "0xf851a06701965d5dd79a9e98a55ece1169be6245c066faa848b7b58d861542d7961f0980a020ce6ca23dd219cfd0115eadff64fa44b8fe11a382ae1c32d3344df4c4bbad9f8080808080808080808080808080" ], "storageProof": [ { "key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "value": "0x0", "proof": [ "0x80" ] } ] } } } ] }, { "name": "eth_getRawTransactionByHash", "summary": "Returns the raw transaction data for a transaction hash.", "description": "Returns the raw transaction data for a transaction hash.", "params": [ { "name": "hash", "description": "The hash of a transaction", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The raw transaction data as a hex string, or null if no transaction is found.", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getRawTransactionByHash" }, "examples": [ { "name": "eth_getRawTransactionByHash example", "params": [ { "name": "hash", "value": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4" } ], "result": { "name": "eth_getRawTransactionByHash result", "value": "0x13f84f8401c9c3808304ffff940000000000000000000000000000000000002002883782dace9d900000a4092193ab000000000000000000000000514708beda3441cc4e141f8546c096eaab7c8a05800102" } } ] }, { "name": "eth_getStorageAt", "summary": "Returns the value from a storage position at a given address.", "description": "Returns the value from a storage position at a given address.", "params": [ { "name": "address", "description": "The address to check for storage", "required": true, "schema": { "type": "string" } }, { "name": "position", "description": "The integer of the position in storage", "required": true, "schema": { "type": "string" } }, { "name": "blockNumber", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators", "schema": { "type": "string" } } ], "result": { "name": "result", "description": "It returns the value from a storage position at a given address", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getStorageAt" }, "examples": [ { "name": "eth_getStorageAt example", "params": [ { "name": "address", "value": "0x3f91da51aa4a5c42f3882c5b5a81ed308413e7f0" }, { "name": "position", "value": "0x0" }, { "name": "blockNumber", "value": "0x50000" } ], "result": { "name": "eth_getStorageAt result", "value": "0x0000000000000000000000000000000000000000000000000000000000000000" } } ] }, { "name": "eth_getTransactionByBlockHashAndIndex", "summary": "Returns information about a transaction given a blockhash and transaction index position.", "description": "Returns information about a transaction given a blockhash and transaction index position.", "params": [ { "name": "blockHash", "description": "The block hash", "required": true, "schema": { "type": "string" } }, { "name": "index", "description": "An integer of the transaction index position encoded as a hexadecimal", "required": true, "schema": { "type": "string" } } ], "result": { "name": "object", "description": "The transaction response object, or null if no transaction is found:", "schema": { "type": "object", "properties": { "blockHash": { "type": "string", "description": "The hash of the block where this log was in. null when it's a pending log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when it's a pending log" }, "from": { "type": "string", "description": "The address of the sender" }, "gas": { "type": "string", "description": "The gas provided by the sender, encoded as hexadecimal" }, "gasPrice": { "type": "string", "description": "(Conditional) The gas price provided by the sender in wei, encoded as hexadecimal" }, "hash": { "type": "string", "description": "The hash of the transaction" }, "input": { "type": "string", "description": "The data sent along with the transaction" }, "nonce": { "type": "string", "description": "The number of transactions made by the sender prior to this one encoded as hexadecimal" }, "to": { "type": "string", "description": "The address of the receiver. null when it's a contract creation transaction" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. null when it's a pending log" }, "value": { "type": "string", "description": "The value transferred in wei encoded as hexadecimal" }, "type": { "type": "string", "description": "The transaction type" }, "v": { "type": "string", "description": "The standardized V field of the signature" }, "r": { "type": "string", "description": "The R field of the signature" }, "s": { "type": "string", "description": "The S field of the signature" }, "chainId": { "type": "string", "description": "(Conditional) The chain ID of the transaction, encoded as hexadecimal" }, "yParity": { "type": "string", "description": "Signature recovery parity, encoded as hexadecimal." }, "blockTimestamp": { "type": "string", "description": "Timestamp of the containing block, encoded as hexadecimal." } }, "description": "The transaction response object, or null if no transaction is found:" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getTransactionByBlockHashAndIndex" }, "examples": [ { "name": "eth_getTransactionByBlockHashAndIndex example", "params": [ { "name": "blockHash", "value": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b" }, { "name": "index", "value": "0x0" } ], "result": { "name": "eth_getTransactionByBlockHashAndIndex result", "value": { "type": "0x13", "gas": "0x1c9c380", "nonce": "0x4ffff", "to": "0x0000000000000000000000000000000000002002", "value": "0x3782dace9d900000", "input": "0x092193ab000000000000000000000000514708beda3441cc4e141f8546c096eaab7c8a05", "r": "0x1", "s": "0x2", "yParity": "0x0", "v": "0x0", "hash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "transactionIndex": "0x0", "from": "0xfffffffffffffffffffffffffffffffffffffffe", "blockTimestamp": "0x6a8e16c4" } } } ] }, { "name": "eth_getTransactionByBlockNumberAndIndex", "summary": "Returns information about a transaction given a block number and transaction index position.", "description": "Returns information about a transaction given a block number and transaction index position.", "params": [ { "name": "blockNumber", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators", "required": true, "schema": { "type": "string" } }, { "name": "index", "description": "An integer of the transaction index position encoded as a hexadecimal", "required": true, "schema": { "type": "string" } } ], "result": { "name": "object", "description": "The transaction response object, or null if no transaction is found:", "schema": { "type": "object", "properties": { "blockHash": { "type": "string", "description": "The hash of the block where this log was in. null when it's a pending log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when it's a pending log" }, "from": { "type": "string", "description": "The address of the sender" }, "gas": { "type": "string", "description": "The gas provided by the sender, encoded as hexadecimal" }, "gasPrice": { "type": "string", "description": "(Conditional) The gas price provided by the sender in wei, encoded as hexadecimal" }, "hash": { "type": "string", "description": "The hash of the transaction" }, "input": { "type": "string", "description": "The data sent along with the transaction" }, "nonce": { "type": "string", "description": "The number of transactions made by the sender prior to this one encoded as hexadecimal" }, "to": { "type": "string", "description": "The address of the receiver. null when it's a contract creation transaction" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. null when it's a pending log" }, "value": { "type": "string", "description": "The value transferred in wei encoded as hexadecimal" }, "type": { "type": "string", "description": "The transaction type" }, "v": { "type": "string", "description": "The standardized V field of the signature" }, "r": { "type": "string", "description": "The R field of the signature" }, "s": { "type": "string", "description": "The S field of the signature" }, "chainId": { "type": "string", "description": "(Conditional) The chain ID of the transaction, encoded as hexadecimal" }, "yParity": { "type": "string", "description": "Signature recovery parity, encoded as hexadecimal." }, "blockTimestamp": { "type": "string", "description": "Timestamp of the containing block, encoded as hexadecimal." } }, "description": "The transaction response object, or null if no transaction is found:" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getTransactionByBlockNumberAndIndex" }, "examples": [ { "name": "eth_getTransactionByBlockNumberAndIndex example", "params": [ { "name": "blockNumber", "value": "0x50000" }, { "name": "index", "value": "0x0" } ], "result": { "name": "eth_getTransactionByBlockNumberAndIndex result", "value": { "type": "0x13", "gas": "0x1c9c380", "nonce": "0x4ffff", "to": "0x0000000000000000000000000000000000002002", "value": "0x3782dace9d900000", "input": "0x092193ab000000000000000000000000514708beda3441cc4e141f8546c096eaab7c8a05", "r": "0x1", "s": "0x2", "yParity": "0x0", "v": "0x0", "hash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "transactionIndex": "0x0", "from": "0xfffffffffffffffffffffffffffffffffffffffe", "blockTimestamp": "0x6a8e16c4" } } } ] }, { "name": "eth_getTransactionByHash", "summary": "Returns the information about a transaction from a transaction hash.", "description": "Returns the information about a transaction from a transaction hash.", "params": [ { "name": "hash", "description": "The hash of a transaction", "required": true, "schema": { "type": "string" } } ], "result": { "name": "object", "description": "The transaction response object, or null if no transaction is found:", "schema": { "type": "object", "properties": { "blockHash": { "type": "string", "description": "The hash of the block where this log was in. null when it's a pending log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when it's a pending log" }, "from": { "type": "string", "description": "The address of the sender" }, "gas": { "type": "string", "description": "The gas provided by the sender, encoded as hexadecimal" }, "gasPrice": { "type": "string", "description": "(Conditional) The gas price provided by the sender in wei, encoded as hexadecimal" }, "hash": { "type": "string", "description": "The hash of the transaction" }, "input": { "type": "string", "description": "The data sent along with the transaction" }, "nonce": { "type": "string", "description": "The number of transactions made by the sender prior to this one encoded as hexadecimal" }, "to": { "type": "string", "description": "The address of the receiver. null when it's a contract creation transaction" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. null when it's a pending log" }, "value": { "type": "string", "description": "The value transferred in wei encoded as hexadecimal" }, "type": { "type": "string", "description": "The transaction type" }, "v": { "type": "string", "description": "The standardized V field of the signature" }, "r": { "type": "string", "description": "The R field of the signature" }, "s": { "type": "string", "description": "The S field of the signature" }, "chainId": { "type": "string", "description": "(Conditional) The chain ID of the transaction, encoded as hexadecimal" }, "yParity": { "type": "string", "description": "Signature recovery parity, encoded as hexadecimal." }, "blockTimestamp": { "type": "string", "description": "Timestamp of the containing block, encoded as hexadecimal." } }, "description": "The transaction response object, or null if no transaction is found:" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getTransactionByHash" }, "examples": [ { "name": "eth_getTransactionByHash example", "params": [ { "name": "hash", "value": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4" } ], "result": { "name": "eth_getTransactionByHash result", "value": { "type": "0x13", "gas": "0x1c9c380", "nonce": "0x4ffff", "to": "0x0000000000000000000000000000000000002002", "value": "0x3782dace9d900000", "input": "0x092193ab000000000000000000000000514708beda3441cc4e141f8546c096eaab7c8a05", "r": "0x1", "s": "0x2", "yParity": "0x0", "v": "0x0", "hash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "transactionIndex": "0x0", "from": "0xfffffffffffffffffffffffffffffffffffffffe", "blockTimestamp": "0x6a8e16c4" } } } ] }, { "name": "eth_getTransactionCount", "summary": "Returns the number of transactions sent from an address.", "description": "Returns the number of transactions sent from an address.", "params": [ { "name": "address", "description": "The address from which the transaction count to be checked", "required": true, "schema": { "type": "string" } }, { "name": "blockNumber", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The integer of the number of transactions sent from an address encoded as hexadecimal", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getTransactionCount" }, "examples": [ { "name": "eth_getTransactionCount example", "params": [ { "name": "address", "value": "0x3f91da51aa4a5c42f3882c5b5a81ed308413e7f0" }, { "name": "blockNumber", "value": "0x50000" } ], "result": { "name": "eth_getTransactionCount result", "value": "0x0" } } ] }, { "name": "eth_getTransactionReceipt", "summary": "Returns the receipt of a transaction by transaction hash.", "description": "Returns the receipt of a transaction by transaction hash.", "params": [ { "name": "hash", "description": "The hash of a transaction", "required": true, "schema": { "type": "string" } } ], "result": { "name": "object", "description": "A transaction receipt object, or null when no receipt was found", "schema": { "type": "object", "properties": { "blockHash": { "type": "string", "description": "The hash of the block where this transaction was in" }, "blockNumber": { "type": "string", "description": "The block number where this transaction was added encoded as a hexadecimal" }, "contractAddress": { "type": [ "string", "null" ], "description": "The contract address created for contract creation, otherwise null" }, "cumulativeGasUsed": { "type": "string", "description": "The total gas used when this transaction was executed in the block" }, "effectiveGasPrice": { "type": "string", "description": "The total base charge plus tip paid for each unit of gas" }, "from": { "type": "string", "description": "The address of the sender" }, "gasUsed": { "type": "string", "description": "The amount of gas used by this specific transaction alone" }, "logs": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log was generated" }, "topics": { "type": "array", "items": {}, "description": "An array of zero to four 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 declare the event with the anonymous specifier" }, "data": { "type": "string", "description": "The 32 byte non-indexed argument of the log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in" }, "transactionHash": { "type": "string", "description": "The hash of the transaction from which this log was created from. null if the log is pending" }, "transactionIndex": { "type": "string", "description": "The transactions index position from which this log was created from. null if the log is pending" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in" }, "logIndex": { "type": "string", "description": "The integer of log index position in the block encoded as hexadecimal. null if the log is pending" }, "removed": { "type": "boolean", "description": "It is true if log was removed, due to a chain reorganization and false if it's a valid log" }, "blockTimestamp": { "type": "string", "description": "Timestamp of the containing block, encoded as hexadecimal." } } }, "description": "An array of log objects that generated this transaction" }, "logsBloom": { "type": "string", "description": "The bloom filter which is used to retrive related logs" }, "status": { "type": "string", "description": "It is either 1 (success) or 0 (failure) encoded as a hexadecimal" }, "to": { "type": "string", "description": "The address of the receiver. Null when its a contract creation transaction" }, "transactionHash": { "type": "string", "description": "The hash of the transaction" }, "transactionIndex": { "type": "string", "description": "The transactions index position in the block encoded as a hexadecimal" }, "type": { "type": "string", "description": "The type of value" }, "blobGasUsed": { "type": "string", "description": "(Conditional) The amount of blob gas used in the transaction (for EIP-4844 blob transactions)" } }, "description": "A transaction receipt object, or null when no receipt was found" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getTransactionReceipt" }, "examples": [ { "name": "eth_getTransactionReceipt example", "params": [ { "name": "hash", "value": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4" } ], "result": { "name": "eth_getTransactionReceipt result", "value": { "type": "0x13", "status": "0x1", "cumulativeGasUsed": "0x350cb", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000010000000000000400000000000000800000000008001000000000000000000800080000000000000000000000020000000000000000040800000000000000000002000010000000000004000000000000400000000200000000020000000000000000002000002000000000000000000000000000000000000000000000000000000000000000000001000002000000000000000000000000000000000000000000000000008020000000000000000000000000000000000000000000000000200000000000000000", "logs": [ { "address": "0x2804ada1c219e50898e75b2bd052030580f4fbac", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000006afc5949c97c004d7de8deecd4256c018fa58e10" ], "data": "0x0000000000000000000000000000000000000000000000000000604ab6715704", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x0", "removed": false }, { "address": "0x2804ada1c219e50898e75b2bd052030580f4fbac", "topics": [ "0xfb0e1482d62102ab9594f69d4c6d693749e3e2bf1c21af272f5456b2d5a4f6b5" ], "data": "0x0000000000000000000000000000000000000000000000003311fc80a57000000000000000000000000000000000000000000000000000000470de4df8200000", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x1", "removed": false }, { "address": "0x0000000000000000000000000000000000002002", "topics": [ "0xe34918ff1c7084970068b53fd71ad6d8b04e9f15d3886cbf006443e6cdc52ea6", "0x0000000000000000000000006afc5949c97c004d7de8deecd4256c018fa58e10" ], "data": "0x0000000000000000000000000000000000000000000000003782dace9d900000", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x2", "removed": false }, { "address": "0x0000000000000000000000000000000000002005", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000006afc5949c97c004d7de8deecd4256c018fa58e10" ], "data": "0x000000000000000000000000000000000000000000000000352a8e9703dac68e", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "blockTimestamp": "0x6a8e16c4", "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "logIndex": "0x3", "removed": false } ], "transactionHash": "0x5d005403489e1bc301344d2b51fa7f403372cf4e7941c2861aa320f1605c9dd4", "transactionIndex": "0x0", "blockHash": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b", "blockNumber": "0x50000", "gasUsed": "0x350cb", "effectiveGasPrice": "0x0", "from": "0xfffffffffffffffffffffffffffffffffffffffe", "to": "0x0000000000000000000000000000000000002002", "contractAddress": null } } } ] }, { "name": "eth_getUncleCountByBlockHash", "summary": "Returns the number of uncles for the block matching the given block hash.", "description": "Returns the number of uncles for the block matching the given block hash.", "params": [ { "name": "hash", "description": "The hash of the block to get uncles for", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The integer value of the number of uncles in the block encoded as hexadecimal", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getUncleCountByBlockHash" }, "examples": [ { "name": "eth_getUncleCountByBlockHash example", "params": [ { "name": "hash", "value": "0x464dc0fc78ef448e18597261ac67ecfdf3c5a6ba0a86d30947ca4d379f0fc46b" } ], "result": { "name": "eth_getUncleCountByBlockHash result", "value": "0x0" } } ] }, { "name": "eth_getUncleCountByBlockNumber", "summary": "Returns the number of uncles for the block matching the given block number.", "description": "Returns the number of uncles for the block matching the given block number.", "params": [ { "name": "blockNumber", "description": "The integer of a block number encoded in hexadecimal format starting with 0x", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The integer value of the number of uncles in the block encoded as hexadecimal", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_getUncleCountByBlockNumber" }, "examples": [ { "name": "eth_getUncleCountByBlockNumber example", "params": [ { "name": "blockNumber", "value": "0x50000" } ], "result": { "name": "eth_getUncleCountByBlockNumber result", "value": "0x0" } } ] }, { "name": "eth_maxPriorityFeePerGas", "summary": "Get the priority fee needed to be included in a block.", "description": "Get the priority fee needed to be included in a block.", "params": [], "result": { "name": "result", "description": "The hex value of the priority fee needed to be included in a block", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_maxPriorityFeePerGas" }, "examples": [ { "name": "eth_maxPriorityFeePerGas example", "params": [], "result": { "name": "eth_maxPriorityFeePerGas result", "value": "0x0" } } ] }, { "name": "eth_newBlockFilter", "summary": "Creates a filter in the node, to notify when a new block arrives.", "description": "Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.", "params": [], "result": { "name": "result", "description": "It returns a filter id to be used when calling eth_getFilterChanges", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_newBlockFilter" }, "examples": [ { "name": "eth_newBlockFilter example", "params": [], "result": { "name": "eth_newBlockFilter result", "value": "0x493e0f9f307e220ca2036387c6860360" } } ] }, { "name": "eth_newFilter", "summary": "Creates a filter object, based on filter options, to notify when the state changes (logs).", "description": "Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.", "params": [ { "name": "object", "description": "The transaction response object which contains the following filter information:", "required": true, "schema": { "type": "object", "properties": { "fromBlock": { "type": "string", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators" }, "toBlock": { "type": "string", "description": "The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators" }, "address": { "type": "string", "description": "The contract address or a list of addresses from which logs should originate" }, "topics": { "type": "array", "items": {}, "description": "An array of DATA topics and also, the topics are order-dependent. Visit here to learn more about topics" } }, "description": "The transaction response object which contains the following filter information:" } } ], "result": { "name": "result", "description": "It returns a filter id to be used when calling eth_getFilterChanges", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_newFilter" }, "examples": [ { "name": "eth_newFilter example", "params": [], "result": { "name": "eth_newFilter result", "value": "0xceb61c4cd786057c26d3c0f5b07b8b13" } } ] }, { "name": "eth_newPendingTransactionFilter", "summary": "Creates a filter in the node to notify when new pending transactions arrive.", "description": "Creates a filter in the node to notify when new pending transactions arrive. To check if the state has changed, call eth_getFilterChanges.", "params": [], "result": { "name": "result", "description": "A filter id to be used when calling eth_getFilterChanges", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_newPendingTransactionFilter" }, "examples": [ { "name": "eth_newPendingTransactionFilter example", "params": [], "result": { "name": "eth_newPendingTransactionFilter result", "value": "0x2ddc35fc00a652569ebfa00ab207c87b" } } ] }, { "name": "eth_sendRawTransaction", "summary": "Creates new message call transaction or a contract creation for signed transactions.", "description": "Creates new message call transaction or a contract creation for signed transactions.", "params": [ { "name": "data", "description": "The signed transaction (typically signed with a library, using your private key)", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The transaction hash, or the zero hash if the transaction is not yet available", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_sendRawTransaction" }, "examples": [ { "name": "eth_sendRawTransaction example", "params": [ { "name": "data", "value": "signed transaction" } ], "result": { "name": "eth_sendRawTransaction result", "value": "0x0" } } ] }, { "name": "eth_simulateV1", "summary": "Simulates a series of transactions at a specific block height with optional state overrides", "description": "Simulates a series of transactions at a specific block height with optional state overrides", "params": [ { "name": "object", "description": "The simulation request object", "required": true, "schema": { "type": "object", "properties": { "blockStateCalls": { "type": "array", "items": { "type": "object", "properties": { "blockOverrides": { "type": "object", "properties": { "baseFeePerGas": { "type": "string", "description": "The base fee per gas for the block, encoded as hexadecimal" } }, "description": "(Optional) An object to override block-level parameters" }, "stateOverrides": { "type": "object", "properties": { "address": { "type": "object", "properties": { "balance": { "type": "string", "description": "(Optional) The balance to set for the account, encoded as hexadecimal" } }, "description": "The address of the account to override" } }, "description": "(Optional) An object to override account states" }, "calls": { "type": "array", "items": { "type": "object", "properties": { "from": { "type": "string", "description": "The address from which the transaction is sent" }, "to": { "type": "string", "description": "The address to which the transaction is directed" }, "maxFeePerGas": { "type": "string", "description": "(Optional) The maximum fee per gas the sender is willing to pay" }, "value": { "type": "string", "description": "(Optional) The value sent with the transaction, encoded as hexadecimal" }, "data": { "type": "string", "description": "(Optional) The data payload of the transaction, encoded as hexadecimal" } } }, "description": "Array of transaction call objects" } } }, "description": "Array of block state call objects" }, "validation": { "type": "boolean", "description": "(Optional) A boolean indicating whether to perform validation checks" }, "traceTransfers": { "type": "boolean", "description": "(Optional) A boolean indicating whether to trace value transfers" } }, "description": "The simulation request object" } }, { "name": "blockParameter", "description": "The block number, hash, or tag (earliest, finalized, latest, pending, safe)", "schema": { "type": "string" } } ], "result": { "name": "result", "description": "Array of simulation results", "schema": { "type": "array", "items": { "type": "object", "properties": { "baseFeePerGas": { "type": "string", "description": "Base fee per gas in hexadecimal" }, "blobGasUsed": { "type": "string", "description": "Amount of blob gas used in hexadecimal" }, "calls": { "type": "array", "items": { "type": "object", "properties": { "returnData": { "type": "string", "description": "Return data from the call in hexadecimal" }, "logs": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Address of the contract that generated the log" }, "topics": { "type": "array", "items": {}, "description": "Array of indexed log parameters" }, "data": { "type": "string", "description": "Contains non-indexed log parameters" }, "blockNumber": { "type": "string", "description": "Block number in hexadecimal" }, "transactionHash": { "type": "string", "description": "Hash of the transaction" }, "transactionIndex": { "type": "string", "description": "Index of the transaction in the block" }, "blockHash": { "type": "string", "description": "Hash of the block" }, "logIndex": { "type": "string", "description": "Index of the log in the block" }, "removed": { "type": "boolean", "description": "Whether the log was removed due to chain reorganization" }, "blockTimestamp": { "type": "string", "description": "Timestamp of the containing block, encoded as hexadecimal." } } }, "description": "Array of logs generated during the call" }, "gasUsed": { "type": "string", "description": "Amount of gas used in hexadecimal" }, "status": { "type": "string", "description": "Status code of the call in hexadecimal" }, "error": { "type": "object", "properties": { "message": { "type": "string", "description": "An error message" }, "code": { "type": "integer", "description": "An error status code" }, "data": { "type": "string", "description": "A data field containing error related information" } }, "description": "(Conditional) Error message when execution fails." } } }, "description": "Array of call results" }, "difficulty": { "type": "string", "description": "Block difficulty in hexadecimal" }, "excessBlobGas": { "type": "string", "description": "Excess blob gas in hexadecimal" }, "extraData": { "type": "string", "description": "Extra data field in hexadecimal" }, "gasLimit": { "type": "string", "description": "Gas limit in hexadecimal" }, "gasUsed": { "type": "string", "description": "Gas used in hexadecimal" }, "hash": { "type": "string", "description": "Block hash" }, "logsBloom": { "type": "string", "description": "Logs bloom filter in hexadecimal" }, "miner": { "type": "string", "description": "Miner/validator address" }, "mixHash": { "type": "string", "description": "Mix hash in hexadecimal" }, "nonce": { "type": "string", "description": "Nonce in hexadecimal" }, "number": { "type": "string", "description": "Block number in hexadecimal" }, "parentBeaconBlockRoot": { "type": "string", "description": "Parent beacon block root in hexadecimal" }, "parentHash": { "type": "string", "description": "Parent block hash" }, "receiptsRoot": { "type": "string", "description": "Receipts trie root in hexadecimal" }, "sha3Uncles": { "type": "string", "description": "Uncle blocks hash in hexadecimal" }, "size": { "type": "string", "description": "Block size in hexadecimal" }, "stateRoot": { "type": "string", "description": "State trie root in hexadecimal" }, "timestamp": { "type": "string", "description": "Block timestamp in hexadecimal" }, "transactions": { "type": "array", "items": {}, "description": "Array of transaction hashes" }, "transactionsRoot": { "type": "string", "description": "Transactions trie root in hexadecimal" }, "uncles": { "type": "array", "items": {}, "description": "Array of uncle block hashes" }, "withdrawals": { "type": "array", "items": {}, "description": "Array of withdrawal objects" }, "withdrawalsRoot": { "type": "string", "description": "Withdrawals trie root in hexadecimal" }, "requestsHash": { "type": "string", "description": "The hash of the requests in the simulated block. Present after the Pectra upgrade" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_simulateV1" }, "examples": [ { "name": "eth_simulateV1 example", "params": [ { "name": "blockParameter", "value": "latest" } ], "result": { "name": "eth_simulateV1 result", "value": [ { "hash": "0xcf8550ded816c6a8e7cbe2e3451d885edfdfabb16a25d6c1e41c6727df0cdedc", "parentHash": "0xb02977f169dd1e283389180c64089415a5b36cee4bea14773a9fe6efb19847f5", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "miner": "0x6779ba5b37fadfd2dc0da0c48c57b756eac4d1ed", "stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000", "transactionsRoot": "0x50d11a2d5d0b5d9d6b42effc8794bd00cfb9e87ae317525a50b08cf3504ca39c", "receiptsRoot": "0x3d6f91953c697868dc8835b72360741988797b4fc2ab9465431756b798e7cbf2", "logsBloom": "0x00000000000000000000000000000000001000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000008000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000011000000000000004000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000002000000000000000000000000000000000000010000000000000000000000000000800000000000000000000000000000000000000000000000000000", "difficulty": "0x0", "number": "0x1ecbd9b", "gasLimit": "0x2faf080", "gasUsed": "0x5208", "timestamp": "0x6adf5ebd", "extraData": "0x726574682f76322e322e302f6c696e7578", "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000", "nonce": "0x0000000000000000", "baseFeePerGas": "0x9", "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "blobGasUsed": "0x0", "excessBlobGas": "0x0", "parentBeaconBlockRoot": "0x0101010101010101010101010101010101010101010101010101010101010101", "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "size": "0x2a4", "uncles": [], "transactions": [ "0xf08f12bb27b3d174987c0d23e84d72840787aced5d0547db311cc833dfcfc0f0" ], "withdrawals": [], "calls": [ { "returnData": "0x", "logs": [ { "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045", "0x000000000000000000000000014d023e954baae7f21e56ed8a5d81b12902684d" ], "data": "0x0000000000000000000000000000000000000000000000000000000000000001", "blockHash": "0xcf8550ded816c6a8e7cbe2e3451d885edfdfabb16a25d6c1e41c6727df0cdedc", "blockNumber": "0x1ecbd9b", "blockTimestamp": "0x6adf5ebd", "transactionHash": "0xf08f12bb27b3d174987c0d23e84d72840787aced5d0547db311cc833dfcfc0f0", "transactionIndex": "0x0", "logIndex": "0x0", "removed": false } ], "gasUsed": "0x5208", "status": "0x1" } ] } ] } } ] }, { "name": "eth_subscribe", "summary": "Starts a subscription to a specific event.", "description": "Starts a subscription to a specific event.", "params": [ { "name": "subscription name", "description": "The type of event you want to subscribe to (i.e., newHeads, logs). This method supports the following subscription types:", "required": true, "schema": { "enum": [ "newHeads", "logs" ] } }, { "name": "data", "description": "The arguments such as an address, multiple addresses, and topics. Note, only logs that are created from these addresses or match the specified topics will return logs", "schema": { "type": "object", "description": "The arguments such as an address, multiple addresses, and topics. Note, only logs that are created from these addresses or match the specified topics will return logs" } } ], "result": { "name": "result", "description": "The hex encoded subscription ID. This ID will be attached to all received events and can also be used to cancel the subscription using eth_unsubscribe", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_subscribe" }, "examples": [ { "name": "eth_subscribe example", "params": [ { "name": "subscription name", "value": "newHeads" } ], "result": { "name": "eth_subscribe result", "value": "0xa53790ed97def78d12a0b3f0782eff12" } } ] }, { "name": "eth_syncing", "summary": "Returns an object with the sync status of the node if the node is out-of-sync and is syncing.", "description": "Returns an object with the sync status of the node if the node is out-of-sync and is syncing. Returns false when the node is already in sync.", "params": [], "result": { "name": "result", "description": "false when the node is synchronized; otherwise an object describing synchronization progress.", "schema": { "oneOf": [ { "type": "boolean" }, { "type": "object", "properties": { "startingBlock": { "type": "string", "description": "The block at which the import started encoded as hexadecimal" }, "currentBlock": { "type": "string", "description": "The current block, same as eth_blockNumber encoded as hexadecimal" }, "highestBlock": { "type": "string", "description": "The estimated highest block encoded as hexadecimal" } } } ] } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_syncing" }, "examples": [ { "name": "eth_syncing example", "params": [], "result": { "name": "eth_syncing result", "value": false } } ] }, { "name": "eth_uninstallFilter", "summary": "It uninstalls a filter with the given filter id.", "description": "It uninstalls a filter with the given filter id.", "params": [ { "name": "filter ID", "description": "The filter ID that needs to be uninstalled. It should always be called when watch is no longer needed. Additionally, Filters timeout when they aren't requested with eth_getFilterChanges for a period of time Create a filter with eth_newFilter on this endpoint first, then replace YOUR_FILTER_ID with the returned ID before it expires.", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "It returns true if the filter was successfully uninstalled, otherwise false", "schema": { "type": "boolean" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_uninstallFilter" }, "examples": [ { "name": "eth_uninstallFilter example", "params": [ { "name": "filter ID", "value": "YOUR_FILTER_ID" } ], "result": { "name": "eth_uninstallFilter result", "value": true } } ] }, { "name": "eth_unsubscribe", "summary": "Cancels an existing subscription so that no further events are sent.", "description": "Cancels an existing subscription so that no further events are sent.", "params": [ { "name": "subscription ID", "description": "A subscription ID that was previously generated in a eth_subscribe RPC request", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "A boolean value indicating if the subscription was canceled successfully", "schema": { "type": "boolean" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/eth_unsubscribe" }, "examples": [ { "name": "eth_unsubscribe example", "params": [ { "name": "subscription ID", "value": "SUBSCRIPTION_ID" } ], "result": { "name": "eth_unsubscribe result", "value": true } } ] }, { "name": "net_listening", "summary": "Returns true if client is actively listening for network connections.", "description": "Returns true if client is actively listening for network connections.", "params": [], "result": { "name": "result", "description": "It's true when the client is actively listening for network connections, otherwise false", "schema": { "type": "boolean" } }, "tags": [ { "name": "net" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/net_listening" }, "examples": [ { "name": "net_listening example", "params": [], "result": { "name": "net_listening result", "value": true } } ] }, { "name": "net_peerCount", "summary": "Returns number of peers currently connected to the client.", "description": "Returns number of peers currently connected to the client.", "params": [], "result": { "name": "result", "description": "The integer of the number of connected peers encoded as hexadecimal", "schema": { "type": "string" } }, "tags": [ { "name": "net" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/net_peerCount" }, "examples": [ { "name": "net_peerCount example", "params": [], "result": { "name": "net_peerCount result", "value": "0x5" } } ] }, { "name": "net_version", "summary": "Returns the current network id.", "description": "Returns the current network id.", "params": [], "result": { "name": "result", "description": "The string value of current network id. The network id for Katana Mainnet is '747474'", "schema": { "type": "string" } }, "tags": [ { "name": "net" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/net_version" }, "examples": [ { "name": "net_version example", "params": [], "result": { "name": "net_version result", "value": "784" } } ] }, { "name": "web3_clientVersion", "summary": "Returns the current version of the chain client.", "description": "Returns the current version of the chain client.", "params": [], "result": { "name": "result", "description": "The current client version in string format", "schema": { "type": "string" } }, "tags": [ { "name": "web3" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/web3_clientVersion" }, "examples": [ { "name": "web3_clientVersion example", "params": [], "result": { "name": "web3_clientVersion result", "value": "reth/v2.2.0-855b3a4/x86_64-unknown-linux-gnu" } } ] }, { "name": "web3_sha3", "summary": "Returns Keccak-256 (not the standardized SHA3-256) hash of the given data.", "description": "Returns Keccak-256 (not the standardized SHA3-256) hash of the given data.", "params": [ { "name": "result", "description": "The data in hexadecimal form to convert into a SHA3 hash", "required": true, "schema": { "type": "string" } } ], "result": { "name": "dATA", "description": "The SHA3 hash of the given string", "schema": { "type": "string" } }, "tags": [ { "name": "web3" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/ritual/web3_sha3" }, "examples": [ { "name": "web3_sha3 example", "params": [ { "name": "result", "value": "0x68656c6c6f20776f726c64" } ], "result": { "name": "web3_sha3 result", "value": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad" } } ] } ], "servers": [ { "name": "Ethereum JSON-RPC API", "url": "https://docs-demo.ritual-mainnet.quiknode.pro" } ] }