{ "openrpc": "1.2.4", "info": { "title": "The Ethereum JSON-RPC Interface \u2014 API Commons profile", "version": "1.0.0-beta.7", "description": "A **profile**, not a copy. Every method carries `x-tier`, graded by how many public endpoints actually serve it. Vendor-tier methods \u2014 including the whole `engine_` namespace, which no public endpoint should serve \u2014 are graded in `profile.yml` and excluded here.\n\nDerived from https://github.com/ethereum/execution-apis at v1.0.0-beta.7 (CC0-1.0, public domain).", "license": { "name": "CC-BY-NC-SA-4.0", "url": "https://creativecommons.org/licenses/by-nc-sa/4.0/" } }, "methods": [ { "examples": [ { "name": "debug_getBadBlocks example", "params": [], "result": { "name": "Bad block array", "value": [ { "block": { "difficulty": "0x1", "extraData": "0x00000000000000000000000000000000000000000000000000000000000000008c6a091f07e4ba3930f2f5fabbfc5b1c70986319096760ba200a6abc0d30e33c2d501702d1b58d7f75807bdbf981044557628611319121170b96466ec06bb3fd01", "gasLimit": "0xffffffffffff", "gasUsed": "0x1a488", "hash": "0x85c2edc1ca74b4863cab46ff6ed4df514a698aa7c29a9bce58742a33af07d7e6", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "miner": "0x0000000000000000000000000000000000000000", "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000", "nonce": "0x0000000000000000", "number": "0xd", "parentHash": "0x544a2f7a4c8defc0d8da44aa0c0db7c36b56db2605c01ed266e919e936579d31", "receiptsRoot": "0xccd2d33763dc0ac3fe02d4ecbbcd7d2bdc6f57db635ba31007184679303721d7", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x3a0", "stateRoot": "0x861ab7e868e3c23f84b7c4ed86b52a6a4f063633bc45ef29212c33459df84ea5", "timestamp": "0x5f5b6824", "transactions": [ { "blockHash": "0x85c2edc1ca74b4863cab46ff6ed4df514a698aa7c29a9bce58742a33af07d7e6", "blockNumber": "0xd", "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", "gas": "0x1a49e", "gasPrice": "0x3e8", "hash": "0xdd8cf045113754c306ba9ac8ac8786235e33bc5c087678084ef260a2a583f127", "input": "0x608060405234801561001057600080fd5b5060c78061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060325760003560e01c80636057361d146037578063b05784b8146062575b600080fd5b606060048036036020811015604b57600080fd5b8101908080359060200190929190505050607e565b005b60686088565b6040518082815260200191505060405180910390f35b8060008190555050565b6000805490509056fea26469706673582212208dea039245bf78c381278382d7056eef5083f7d243d8958817ef447e0a403bd064736f6c63430006060033", "nonce": "0x0", "r": "0xa7a15050302ca4b7d3842d35cdd3cbf25b2c48c0c37f96d78beb6a6a6bc4f1c7", "s": "0x130d29294b2b6a2b7e89f501eb27772f7abf37bfa28a1ce300daade975589fca", "to": null, "transactionIndex": "0x0", "v": "0xf9d", "value": "0x0" } ], "transactionsRoot": "0x02c387e001cbe2a8296bfa2e18afbc3480d0e49588b05556148b0bf7c17dec41", "uncles": [] }, "hash": "0x85c2edc1ca74b4863cab46ff6ed4df514a698aa7c29a9bce58742a33af07d7e6", "rlp": "0xf9039df9025ca0544a2f7a4c8defc0d8da44aa0c0db7c36b56db2605c01ed266e919e936579d31a01dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347940000000000000000000000000000000000000000a0861ab7e868e3c23f84b7c4ed86b52a6a4f063633bc45ef29212c33459df84ea5a002c387e001cbe2a8296bfa2e18afbc3480d0e49588b05556148b0bf7c17dec41a0ccd2d33763dc0ac3fe02d4ecbbcd7d2bdc6f57db635ba31007184679303721d7b9010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010d86ffffffffffff8301a488845f5b6824b86100000000000000000000000000000000000000000000000000000000000000008c6a091f07e4ba3930f2f5fabbfc5b1c70986319096760ba200a6abc0d30e33c2d501702d1b58d7f75807bdbf981044557628611319121170b96466ec06bb3fd01a00000000000000000000000000000000000000000000000000000000000000000880000000000000000f9013af90137808203e88301a49e8080b8e6608060405234801561001057600080fd5b5060c78061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060325760003560e01c80636057361d146037578063b05784b8146062575b600080fd5b606060048036036020811015604b57600080fd5b8101908080359060200190929190505050607e565b005b60686088565b6040518082815260200191505060405180910390f35b8060008190555050565b6000805490509056fea26469706673582212208dea039245bf78c381278382d7056eef5083f7d243d8958817ef447e0a403bd064736f6c63430006060033820f9da0a7a15050302ca4b7d3842d35cdd3cbf25b2c48c0c37f96d78beb6a6a6bc4f1c7a0130d29294b2b6a2b7e89f501eb27772f7abf37bfa28a1ce300daade975589fcac0" }, { "block": { "difficulty": "0x2", "extraData": "0x00000000000000000000000000000000000000000000000000000000000000004d04551bdd9ae08af1fd661e49d4ab662c98c532c7ec0e4656a27e4de7d330af578ab1e4f5e49e085ff1d78673c7388ed9ccf017fbe89e53066bfa4018142c0701", "gasLimit": "0xffffffffffff", "gasUsed": "0x1a4c9", "hash": "0x601a3ae9b6eceb2476d249e1cffe058ba3ff2c9c1b28b1ec7a0259fdd1d90121", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "miner": "0x0000000000000000000000000000000000000000", "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000", "nonce": "0x0000000000000000", "number": "0x8", "parentHash": "0x98ae440cd7b904d842daa6c263608969a3c8ce6a9acd6bd1f99b394f5f28a207", "receiptsRoot": "0x2b5c77f6e7764d2468178fab7253346b9b8bb6a34b63946f6bdc2f5ad398bfc3", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x3a0", "stateRoot": "0x140a9783291704223eb759e3a0db5471a520d349fc17ac2f77ff8582472e3bac", "timestamp": "0x5f5b6b80", "transactions": [ { "blockHash": "0x601a3ae9b6eceb2476d249e1cffe058ba3ff2c9c1b28b1ec7a0259fdd1d90121", "blockNumber": "0x8", "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", "gas": "0x1a4c9", "gasPrice": "0x3e8", "hash": "0x675e336a4281b29c619dfd4ccfbd2f930f3728b20caf9e0067284aa3224e6758", "input": "0x608060405234801561001057600080fd5b5060c78061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060325760003560e01c80636057361d146037578063b05784b8146062575b600080fd5b606060048036036020811015604b57600080fd5b8101908080359060200190929190505050607e565b005b60686088565b6040518082815260200191505060405180910390f35b8060008190555050565b6000805490509056fea26469706673582212208dea039245bf78c381278382d7056eef5083f7d243d8958817ef447e0a403bd064736f6c63430006060033", "nonce": "0x0", "r": "0x2e30624c0305e64812e1d9e325ba6e50410314634b008edcb50f45be71fa0d4", "s": "0x50e205faed23c219ba15610de2451d458cbd4221207b2168344cfc972a7973c0", "to": null, "transactionIndex": "0x0", "v": "0xf9d", "value": "0x0" } ], "transactionsRoot": "0x8ee998cc699a1f9310a1079458780b3ebee8756f96a0905f5224b89d0eb17486", "uncles": [] }, "hash": "0x601a3ae9b6eceb2476d249e1cffe058ba3ff2c9c1b28b1ec7a0259fdd1d90121", "rlp": "0xf9039df9025ca098ae440cd7b904d842daa6c263608969a3c8ce6a9acd6bd1f99b394f5f28a207a01dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347940000000000000000000000000000000000000000a0140a9783291704223eb759e3a0db5471a520d349fc17ac2f77ff8582472e3baca08ee998cc699a1f9310a1079458780b3ebee8756f96a0905f5224b89d0eb17486a02b5c77f6e7764d2468178fab7253346b9b8bb6a34b63946f6bdc2f5ad398bfc3b9010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020886ffffffffffff8301a4c9845f5b6b80b86100000000000000000000000000000000000000000000000000000000000000004d04551bdd9ae08af1fd661e49d4ab662c98c532c7ec0e4656a27e4de7d330af578ab1e4f5e49e085ff1d78673c7388ed9ccf017fbe89e53066bfa4018142c0701a00000000000000000000000000000000000000000000000000000000000000000880000000000000000f9013af90137808203e88301a4c98080b8e6608060405234801561001057600080fd5b5060c78061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060325760003560e01c80636057361d146037578063b05784b8146062575b600080fd5b606060048036036020811015604b57600080fd5b8101908080359060200190929190505050607e565b005b60686088565b6040518082815260200191505060405180910390f35b8060008190555050565b6000805490509056fea26469706673582212208dea039245bf78c381278382d7056eef5083f7d243d8958817ef447e0a403bd064736f6c63430006060033820f9da002e30624c0305e64812e1d9e325ba6e50410314634b008edcb50f45be71fa0d4a050e205faed23c219ba15610de2451d458cbd4221207b2168344cfc972a7973c0c0" } ] } } ], "name": "debug_getBadBlocks", "params": [], "result": { "name": "Blocks", "schema": { "items": { "additionalProperties": false, "properties": { "block": { "properties": { "baseFeePerGas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Base fee per gas", "type": "string" }, "blobGasUsed": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Blob gas used", "type": "string" }, "blockAccessListHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "EIP-7928 block access list hash", "type": "string" }, "difficulty": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Difficulty", "type": "string" }, "excessBlobGas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Excess blob gas", "type": "string" }, "extraData": { "pattern": "^0x[0-9a-f]*$", "title": "Extra data", "type": "string" }, "gasLimit": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Gas limit", "type": "string" }, "gasUsed": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Gas used", "type": "string" }, "hash": { "pattern": "^0x[0-9a-f]{64}$", "title": "Hash", "type": "string" }, "logsBloom": { "pattern": "^0x[0-9a-f]{512}$", "title": "Bloom filter", "type": "string" }, "miner": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Coinbase", "type": "string" }, "mixHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "Mix hash", "type": "string" }, "nonce": { "pattern": "^0x[0-9a-f]{16}$", "title": "Nonce", "type": "string" }, "number": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Number", "type": "string" }, "parentBeaconBlockRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "Parent Beacon Block Root", "type": "string" }, "parentHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "Parent block hash", "type": "string" }, "receiptsRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "Receipts root", "type": "string" }, "requestsHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "EIP-7685 requests hash", "type": "string" }, "sha3Uncles": { "pattern": "^0x[0-9a-f]{64}$", "title": "Ommers hash", "type": "string" }, "size": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block size", "type": "string" }, "stateRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "State root", "type": "string" }, "timestamp": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Timestamp", "type": "string" }, "transactions": { "anyOf": [ { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "Transaction hashes", "type": "array" }, { "items": { "oneOf": [ { "properties": { "accessList": { "description": "EIP-2930 access lists", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "authorizationList": { "description": "List of authorizations for the transaction", "items": { "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "chainId": { "description": "Chain ID on which this transaction is valid", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "s", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "chainId", "nonce", "address", "yParity", "r", "s" ], "type": "object" }, "title": "authorizationList", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "maxFeePerGas": { "description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per gas", "type": "string" }, "maxPriorityFeePerGas": { "description": "Maximum fee per gas the sender is willing to pay to miners in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max priority fee per gas", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "to address", "type": "string" }, "type": { "pattern": "^0x4$", "title": "type", "type": "string" }, "v": { "description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "accessList", "authorizationList", "chainId", "gas", "input", "maxFeePerGas", "maxPriorityFeePerGas", "nonce", "r", "s", "to", "type", "value", "yParity" ], "title": "Signed 7702 Transaction", "type": "object" }, { "properties": { "accessList": { "description": "EIP-2930 access list", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "blobVersionedHashes": { "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs", "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "blobVersionedHashes", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "maxFeePerBlobGas": { "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per blob gas", "type": "string" }, "maxFeePerGas": { "description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per gas", "type": "string" }, "maxPriorityFeePerGas": { "description": "Maximum fee per gas the sender is willing to pay to miners in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max priority fee per gas", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "to address", "type": "string" }, "type": { "pattern": "^0x3$", "title": "type", "type": "string" }, "v": { "description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "accessList", "blobVersionedHashes", "chainId", "gas", "input", "maxFeePerBlobGas", "maxFeePerGas", "maxPriorityFeePerGas", "nonce", "r", "s", "to", "type", "value", "yParity" ], "title": "Signed 4844 Transaction", "type": "object" }, { "properties": { "accessList": { "description": "EIP-2930 access list", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "maxFeePerGas": { "description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per gas", "type": "string" }, "maxPriorityFeePerGas": { "description": "Maximum fee per gas the sender is willing to pay to miners in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max priority fee per gas", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "oneOf": [ { "title": "Contract Creation (null)", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" } ], "title": "to address" }, "type": { "pattern": "^0x2$", "title": "type", "type": "string" }, "v": { "description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "accessList", "chainId", "gas", "gasPrice", "input", "maxFeePerGas", "maxPriorityFeePerGas", "nonce", "r", "s", "type", "value", "yParity" ], "title": "Signed 1559 Transaction", "type": "object" }, { "properties": { "accessList": { "description": "EIP-2930 access list", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The gas price willing to be paid by the sender in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "oneOf": [ { "title": "Contract Creation (null)", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" } ], "title": "to address" }, "type": { "pattern": "^0x1$", "title": "type", "type": "string" }, "v": { "description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "accessList", "chainId", "gas", "gasPrice", "input", "nonce", "r", "s", "type", "value", "yParity" ], "title": "Signed 2930 Transaction", "type": "object" }, { "properties": { "chainId": { "description": "Chain ID that this transaction is valid on.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The gas price willing to be paid by the sender in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "oneOf": [ { "title": "Contract Creation (null)", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" } ], "title": "to address" }, "type": { "pattern": "^0x0$", "title": "type", "type": "string" }, "v": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" } }, "required": [ "gas", "gasPrice", "input", "nonce", "r", "s", "type", "v", "value" ], "title": "Signed Legacy Transaction", "type": "object" } ], "properties": { "blockHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "block hash", "type": "string" }, "blockNumber": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "block number", "type": "string" }, "blockTimestamp": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "block timestamp", "type": "string" }, "from": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "from address", "type": "string" }, "hash": { "pattern": "^0x[0-9a-f]{64}$", "title": "transaction hash", "type": "string" }, "transactionIndex": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "transaction index", "type": "string" } }, "required": [ "blockHash", "blockNumber", "blockTimestamp", "from", "hash", "transactionIndex" ], "title": "Transaction information", "type": "object" }, "title": "Full transactions", "type": "array" } ] }, "transactionsRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "Transactions root", "type": "string" }, "uncles": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "Uncles", "type": "array" }, "withdrawals": { "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "recipient address for withdrawal value", "type": "string" }, "amount": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "value contained in withdrawal", "type": "string" }, "index": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$", "title": "index of withdrawal", "type": "string" }, "validatorIndex": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$", "title": "index of validator that generated withdrawal", "type": "string" } }, "required": [ "index", "validatorIndex", "address", "amount" ], "title": "Validator withdrawal", "type": "object" }, "title": "Withdrawals", "type": "array" }, "withdrawalsRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "Withdrawals root", "type": "string" } }, "required": [ "hash", "parentHash", "sha3Uncles", "miner", "stateRoot", "transactionsRoot", "receiptsRoot", "logsBloom", "number", "gasLimit", "gasUsed", "timestamp", "extraData", "mixHash", "nonce", "size", "transactions", "uncles" ], "title": "Block", "type": "object" }, "hash": { "pattern": "^0x[0-9a-f]{64}$", "title": "Hash", "type": "string" }, "rlp": { "pattern": "^0x[0-9a-f]*$", "title": "RLP", "type": "string" } }, "required": [ "block", "hash", "rlp" ], "title": "Bad block", "type": "object" }, "title": "Bad block array", "type": "array" } }, "summary": "Returns an array of recent bad blocks that the client has seen on the network.", "x-tier": "extended" }, { "errors": [ { "code": 4444, "message": "Pruned history unavailable" } ], "examples": [ { "name": "debug_getRawHeader example", "params": [ { "name": "Block", "value": "0x32026E" } ], "result": { "name": "Header RLP", "value": "0xf90236a09f73691f6dabca4f0a99b05d0a701995506aa311dcaa9ce9833d6f4ca474c162a01dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d4934794c6e2459991bfe27cca6d86722f35da23a1e4cb97a078103ea8c47231886481d72ec1afae6eeb06c3773ce24a91323d5c9eed69d4cca0008992da2531db404f07b0871dd620a94ba346963e1b1c6dc7b00748e8593a1ea0b6c3890d9604434fc52f722848c84d1770add20cd75bbc28cdedff42940dbb56b90100200800000400000002000e0000000401000000440100000000c0400600000002000801000000040480020840048000000000400000000000000020004220000011002000000000000204000800000010010002000002000000000040a000000000000400020000010885000000000808000000008800001004002010020300005000000010002110410402000000000000000890000008000000000000000000020040000002000000000000810400000040006000004000004080020000000000000022001000000000000840400000000220250000000000080402000420000418000000000000000400040000004080040010200000000000108020020000808332026e8401c9c380833e3c3c846436f93899d883010b05846765746888676f312e32302e32856c696e7578a0112d8f15793e7df7f8dcdb21c891cff78c0d1839cb5b6dcd06116cdbb99536ae88000000000000000008a0cdb97712af6685bb9650d21d609525913293c48adda7c45990926daada335c9b" } } ], "name": "debug_getRawHeader", "params": [ { "name": "Block", "required": true, "schema": { "oneOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" } ], "title": "Block number or tag" } } ], "result": { "name": "Header RLP", "schema": { "pattern": "^0x[0-9a-f]*$", "title": "hex encoded bytes", "type": "string" } }, "summary": "Returns an RLP-encoded header.", "x-tier": "extended" }, { "examples": [ { "name": "eth_accounts example", "params": [], "result": { "name": "Accounts", "value": [ "0xd1f5279be4b4dd94133a23dee1b23f5bfc0db1d0" ] } } ], "name": "eth_accounts", "params": [], "result": { "name": "Accounts", "schema": { "items": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "title": "Accounts", "type": "array" } }, "summary": "Returns a list of addresses owned by client.", "x-tier": "core" }, { "examples": [ { "name": "eth_blobBaseFee example", "params": [], "result": { "name": "Blob gas base fee", "value": "0x3f5694c1f" } } ], "name": "eth_blobBaseFee", "params": [], "result": { "name": "Blob gas base fee", "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Blob gas base fee", "type": "string" } }, "summary": "Returns the base fee per blob gas in wei.", "x-tier": "core" }, { "examples": [ { "name": "eth_blockNumber example", "params": [], "result": { "name": "Block number", "value": "0x2377" } } ], "name": "eth_blockNumber", "params": [], "result": { "name": "Block number", "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "summary": "Returns the number of most recent block.", "x-tier": "core" }, { "errors": [ { "code": 3, "data": { "pattern": "^0x[0-9a-f]*$", "title": "raw EVM revert data", "type": "string" }, "message": "execution reverted" } ], "examples": [ { "name": "eth_call example", "params": [ { "name": "Transaction", "value": { "to": "0x69498dd54bd25aa0c886cf1f8b8ae0856d55ff13", "value": "0x1" } }, { "name": "Block", "value": "latest" } ], "result": { "name": "Return data", "value": "0x" } } ], "name": "eth_call", "params": [ { "name": "Transaction", "required": true, "schema": { "additionalProperties": false, "properties": { "accessList": { "description": "EIP-2930 access list", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "authorizationList": { "description": "EIP-7702 authorization list", "items": { "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "chainId": { "description": "Chain ID on which this transaction is valid", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "s", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "chainId", "nonce", "address", "yParity", "r", "s" ], "type": "object" }, "title": "authorizationList", "type": "array" }, "blobVersionedHashes": { "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "blobVersionedHashes", "type": "array" }, "blobs": { "description": "Raw blob data.", "items": { "pattern": "^0x[0-9a-f]*$", "title": "hex encoded bytes", "type": "string" }, "title": "blobs", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "from": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "from address", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The gas price willing to be paid by the sender in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "maxFeePerBlobGas": { "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per blob gas", "type": "string" }, "maxFeePerGas": { "description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per gas", "type": "string" }, "maxPriorityFeePerGas": { "description": "Maximum fee per gas the sender is willing to pay to miners in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max priority fee per gas", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "to": { "oneOf": [ { "title": "Contract Creation (null)", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" } ], "title": "to address" }, "type": { "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "type", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" } }, "title": "Transaction object generic to all types", "type": "object" } }, { "name": "Block", "required": false, "schema": { "anyOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" }, { "pattern": "^0x[0-9a-f]{64}$", "title": "Block hash", "type": "string" } ], "title": "Block number, tag, or block hash" } } ], "result": { "name": "Return data", "schema": { "pattern": "^0x[0-9a-f]*$", "title": "hex encoded bytes", "type": "string" } }, "summary": "Executes a new message call immediately without creating a transaction on the block chain.", "x-tier": "core" }, { "description": "Returns information about the data available on this node, including the\ncurrent head block and retention policies for each resource type. This is\nuseful for RPC routers to determine which historical queries a node can serve.\n", "examples": [ { "name": "eth_capabilities example", "params": [], "result": { "name": "Capabilities", "value": { "blocks": { "disabled": false, "oldestBlock": "0x0" }, "head": { "hash": "0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3", "number": "0x13f8e3a" }, "logs": { "deleteStrategy": { "retentionBlocks": "0x23dbb0", "type": "window" }, "disabled": false, "oldestBlock": "0x11b340a" }, "receipts": { "deleteStrategy": { "retentionBlocks": "0x23dbb0", "type": "window" }, "disabled": false, "oldestBlock": "0x11b340a" }, "state": { "deleteStrategy": { "retentionBlocks": "0x15f90", "type": "window" }, "disabled": false, "oldestBlock": "0x13e022a" }, "stateproofs": { "deleteStrategy": { "retentionBlocks": "0x15f90", "type": "window" }, "disabled": false, "oldestBlock": "0x13e022a" }, "tx": { "deleteStrategy": { "retentionBlocks": "0x23dbb0", "type": "window" }, "disabled": false, "oldestBlock": "0x11b340a" } } } } ], "name": "eth_capabilities", "params": [], "result": { "name": "Capabilities", "schema": { "additionalProperties": false, "description": "Describes the data available on the node. Each resource reports the oldest available block and the deletion strategy, allowing RPC routers to determine which historical queries a node can serve.", "properties": { "blocks": { "additionalProperties": false, "description": "Block headers and bodies including transactions and uncles. Determines the available range for block retrieval. Affects: eth_getBlockByHash, eth_getBlockByNumber, eth_getBlockTransactionCountByHash, eth_getBlockTransactionCountByNumber, eth_getUncleCountByBlockHash, eth_getUncleCountByBlockNumber.", "properties": { "deleteStrategy": { "oneOf": [ { "additionalProperties": false, "properties": { "retentionBlocks": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" }, "type": { "enum": [ "window" ], "type": "string" } }, "required": [ "type", "retentionBlocks" ], "title": "Sliding window deletion", "type": "object" } ], "title": "Delete strategy" }, "disabled": { "type": "boolean" }, "oldestBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "required": [ "disabled" ], "title": "Effective resource capability", "type": "object" }, "head": { "additionalProperties": false, "description": "The latest block known to the node, useful for determining sync status.", "properties": { "hash": { "pattern": "^0x[0-9a-f]{64}$", "title": "Head block hash", "type": "string" }, "number": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Head block number", "type": "string" } }, "required": [ "number", "hash" ], "title": "Current head block", "type": "object" }, "logs": { "additionalProperties": false, "description": "Event logs emitted by smart contracts. Determines the available block range for log queries and filters. Affects: eth_getLogs, eth_getFilterLogs, eth_getFilterChanges, eth_newFilter.", "properties": { "deleteStrategy": { "oneOf": [ { "additionalProperties": false, "properties": { "retentionBlocks": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" }, "type": { "enum": [ "window" ], "type": "string" } }, "required": [ "type", "retentionBlocks" ], "title": "Sliding window deletion", "type": "object" } ], "title": "Delete strategy" }, "disabled": { "type": "boolean" }, "oldestBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "required": [ "disabled" ], "title": "Effective resource capability", "type": "object" }, "receipts": { "additionalProperties": false, "description": "Transaction execution receipts including status, gas used, and logs bloom. Determines the available range for receipt lookups. Affects: eth_getTransactionReceipt, eth_getBlockReceipts.", "properties": { "deleteStrategy": { "oneOf": [ { "additionalProperties": false, "properties": { "retentionBlocks": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" }, "type": { "enum": [ "window" ], "type": "string" } }, "required": [ "type", "retentionBlocks" ], "title": "Sliding window deletion", "type": "object" } ], "title": "Delete strategy" }, "disabled": { "type": "boolean" }, "oldestBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "required": [ "disabled" ], "title": "Effective resource capability", "type": "object" }, "state": { "additionalProperties": false, "description": "Account and contract state including balances, nonces, code, and storage. Determines the available range for historical state queries. Affects: eth_getBalance, eth_getCode, eth_getStorageAt, eth_getTransactionCount, eth_call, eth_estimateGas, eth_createAccessList.", "properties": { "deleteStrategy": { "oneOf": [ { "additionalProperties": false, "properties": { "retentionBlocks": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" }, "type": { "enum": [ "window" ], "type": "string" } }, "required": [ "type", "retentionBlocks" ], "title": "Sliding window deletion", "type": "object" } ], "title": "Delete strategy" }, "disabled": { "type": "boolean" }, "oldestBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "required": [ "disabled" ], "title": "Effective resource capability", "type": "object" }, "stateproofs": { "additionalProperties": false, "description": "Merkle proofs for account and storage state. Determines the available range for proof generation. Affects: eth_getProof.", "properties": { "deleteStrategy": { "oneOf": [ { "additionalProperties": false, "properties": { "retentionBlocks": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" }, "type": { "enum": [ "window" ], "type": "string" } }, "required": [ "type", "retentionBlocks" ], "title": "Sliding window deletion", "type": "object" } ], "title": "Delete strategy" }, "disabled": { "type": "boolean" }, "oldestBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "required": [ "disabled" ], "title": "Effective resource capability", "type": "object" }, "tx": { "additionalProperties": false, "description": "Transaction data and lookup indices. Determines the available range for transaction lookups by hash or block position. Affects: eth_getTransactionByHash, eth_getTransactionByBlockHashAndIndex, eth_getTransactionByBlockNumberAndIndex.", "properties": { "deleteStrategy": { "oneOf": [ { "additionalProperties": false, "properties": { "retentionBlocks": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" }, "type": { "enum": [ "window" ], "type": "string" } }, "required": [ "type", "retentionBlocks" ], "title": "Sliding window deletion", "type": "object" } ], "title": "Delete strategy" }, "disabled": { "type": "boolean" }, "oldestBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "required": [ "disabled" ], "title": "Effective resource capability", "type": "object" } }, "required": [ "head", "state", "tx", "logs", "receipts", "blocks", "stateproofs" ], "title": "Effective routing capabilities", "type": "object" } }, "summary": "Returns effective capabilities for routing decisions.", "x-tier": "extended" }, { "examples": [ { "name": "eth_chainId example", "params": [], "result": { "name": "Chain ID", "value": "0x1" } } ], "name": "eth_chainId", "params": [], "result": { "name": "Chain ID", "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "summary": "Returns the chain ID of the current network.", "x-tier": "core" }, { "examples": [ { "name": "eth_coinbase example", "params": [], "result": { "name": "Coinbase address", "value": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73" } } ], "name": "eth_coinbase", "params": [], "result": { "name": "Coinbase address", "schema": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" } }, "summary": "Returns the client coinbase address.", "x-tier": "extended" }, { "examples": [ { "name": "eth_config example with no future fork scheduled", "params": [], "result": { "name": "Configuration", "value": { "current": { "activationTime": 1746612311, "blobSchedule": { "baseFeeUpdateFraction": 5007716, "max": 9, "target": 6 }, "chainId": "0x1", "forkId": "0x3ff0e375", "precompiles": { "BLAKE2F": "0x0000000000000000000000000000000000000009", "BLS12_G1ADD": "0x000000000000000000000000000000000000000b", "BLS12_G1MSM": "0x000000000000000000000000000000000000000c", "BLS12_G2ADD": "0x000000000000000000000000000000000000000d", "BLS12_G2MSM": "0x000000000000000000000000000000000000000e", "BLS12_MAP_FP2_TO_G2": "0x0000000000000000000000000000000000000011", "BLS12_MAP_FP_TO_G1": "0x0000000000000000000000000000000000000010", "BLS12_PAIRING_CHECK": "0x000000000000000000000000000000000000000f", "BN254_ADD": "0x0000000000000000000000000000000000000006", "BN254_MUL": "0x0000000000000000000000000000000000000007", "BN254_PAIRING": "0x0000000000000000000000000000000000000008", "ECREC": "0x0000000000000000000000000000000000000001", "ID": "0x0000000000000000000000000000000000000004", "KZG_POINT_EVALUATION": "0x000000000000000000000000000000000000000a", "MODEXP": "0x0000000000000000000000000000000000000005", "RIPEMD160": "0x0000000000000000000000000000000000000003", "SHA256": "0x0000000000000000000000000000000000000002" }, "systemContracts": { "BEACON_ROOTS_ADDRESS": "0x000f3df6d732807ef1319fb7b8bb8522d0beac02", "CONSOLIDATION_REQUEST_PREDEPLOY_ADDRESS": "0x0000bbddc7ce488642fb579f8b00f3a590007251", "DEPOSIT_CONTRACT_ADDRESS": "0x00000000219ab540356cbb839cbe05303d7705fa", "HISTORY_STORAGE_ADDRESS": "0x0000f90827f1c53a10cb7a02335b175320002935", "WITHDRAWAL_REQUEST_PREDEPLOY_ADDRESS": "0x00000961ef480eb55e80d19ad83579a64c007002" } }, "last": null, "next": null } } } ], "externalDocs": { "description": "EIP-7910 specification", "url": "https://eips.ethereum.org/EIPS/eip-7910" }, "name": "eth_config", "params": [], "result": { "name": "Configuration", "schema": { "additionalProperties": false, "description": "Response object for eth_config method containing current, next, and last fork configurations", "properties": { "current": { "additionalProperties": false, "description": "Represents a specific fork configuration", "properties": { "activationTime": { "description": "Unix timestamp when this configuration becomes active", "title": "Activation time", "type": "number" }, "blobSchedule": { "additionalProperties": false, "description": "Configuration for blob fee schedule", "properties": { "baseFeeUpdateFraction": { "description": "Fraction used for updating blob base fees", "minimum": 0, "title": "Base fee update fraction", "type": "integer" }, "max": { "description": "Maximum number of blobs per block", "minimum": 0, "title": "Maximum blobs", "type": "integer" }, "target": { "description": "Target number of blobs per block", "minimum": 0, "title": "Target blobs", "type": "integer" } }, "required": [ "baseFeeUpdateFraction", "max", "target" ], "title": "Blob schedule", "type": "object" }, "chainId": { "description": "The chain ID for this configuration", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Chain ID", "type": "string" }, "forkId": { "description": "The FORK_HASH value as specified in EIP-6122 of the specific fork", "pattern": "^0x[0-9a-f]{8}$", "title": "Fork ID", "type": "string" }, "precompiles": { "additionalProperties": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "description": "Mapping of precompile names to their addresses", "title": "Precompiles", "type": "object" }, "systemContracts": { "additionalProperties": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "description": "Mapping of system contract names to their addresses", "title": "System contracts", "type": "object" } }, "required": [ "activationTime", "blobSchedule", "chainId", "forkId", "precompiles", "systemContracts" ], "title": "Current configuration", "type": "object" }, "last": { "description": "Configuration for the last configured fork, null if no future forks scheduled", "oneOf": [ { "additionalProperties": false, "description": "Represents a specific fork configuration", "properties": { "activationTime": { "description": "Unix timestamp when this configuration becomes active", "title": "Activation time", "type": "number" }, "blobSchedule": { "additionalProperties": false, "description": "Configuration for blob fee schedule", "properties": { "baseFeeUpdateFraction": { "description": "Fraction used for updating blob base fees", "minimum": 0, "title": "Base fee update fraction", "type": "integer" }, "max": { "description": "Maximum number of blobs per block", "minimum": 0, "title": "Maximum blobs", "type": "integer" }, "target": { "description": "Target number of blobs per block", "minimum": 0, "title": "Target blobs", "type": "integer" } }, "required": [ "baseFeeUpdateFraction", "max", "target" ], "title": "Blob schedule", "type": "object" }, "chainId": { "description": "The chain ID for this configuration", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Chain ID", "type": "string" }, "forkId": { "description": "The FORK_HASH value as specified in EIP-6122 of the specific fork", "pattern": "^0x[0-9a-f]{8}$", "title": "Fork ID", "type": "string" }, "precompiles": { "additionalProperties": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "description": "Mapping of precompile names to their addresses", "title": "Precompiles", "type": "object" }, "systemContracts": { "additionalProperties": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "description": "Mapping of system contract names to their addresses", "title": "System contracts", "type": "object" } }, "required": [ "activationTime", "blobSchedule", "chainId", "forkId", "precompiles", "systemContracts" ], "title": "Configuration object", "type": "object" }, { "type": "null" } ], "title": "Last configuration" }, "next": { "description": "Configuration for the next scheduled fork, null if no future forks scheduled", "oneOf": [ { "additionalProperties": false, "description": "Represents a specific fork configuration", "properties": { "activationTime": { "description": "Unix timestamp when this configuration becomes active", "title": "Activation time", "type": "number" }, "blobSchedule": { "additionalProperties": false, "description": "Configuration for blob fee schedule", "properties": { "baseFeeUpdateFraction": { "description": "Fraction used for updating blob base fees", "minimum": 0, "title": "Base fee update fraction", "type": "integer" }, "max": { "description": "Maximum number of blobs per block", "minimum": 0, "title": "Maximum blobs", "type": "integer" }, "target": { "description": "Target number of blobs per block", "minimum": 0, "title": "Target blobs", "type": "integer" } }, "required": [ "baseFeeUpdateFraction", "max", "target" ], "title": "Blob schedule", "type": "object" }, "chainId": { "description": "The chain ID for this configuration", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Chain ID", "type": "string" }, "forkId": { "description": "The FORK_HASH value as specified in EIP-6122 of the specific fork", "pattern": "^0x[0-9a-f]{8}$", "title": "Fork ID", "type": "string" }, "precompiles": { "additionalProperties": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "description": "Mapping of precompile names to their addresses", "title": "Precompiles", "type": "object" }, "systemContracts": { "additionalProperties": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "description": "Mapping of system contract names to their addresses", "title": "System contracts", "type": "object" } }, "required": [ "activationTime", "blobSchedule", "chainId", "forkId", "precompiles", "systemContracts" ], "title": "Configuration object", "type": "object" }, { "type": "null" } ], "title": "Next configuration" } }, "required": [ "current", "next", "last" ], "title": "Configuration response", "type": "object" } }, "summary": "Returns the client's current configuration including fork information.", "x-tier": "extended" }, { "examples": [ { "name": "eth_createAccessList example", "params": [ { "name": "Transaction", "value": { "data": "0x608060806080608155", "from": "0xaea8f8f781326bfe6a7683c2bd48dd6aa4d3ba63" } }, { "name": "Block", "value": "latest" } ], "result": { "name": "Gas used", "value": { "accessList": [ { "address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000081" ] } ], "gasUsed": "0x125f8" } } } ], "name": "eth_createAccessList", "params": [ { "name": "Transaction", "required": true, "schema": { "additionalProperties": false, "properties": { "accessList": { "description": "EIP-2930 access list", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "authorizationList": { "description": "EIP-7702 authorization list", "items": { "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "chainId": { "description": "Chain ID on which this transaction is valid", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "s", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "chainId", "nonce", "address", "yParity", "r", "s" ], "type": "object" }, "title": "authorizationList", "type": "array" }, "blobVersionedHashes": { "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "blobVersionedHashes", "type": "array" }, "blobs": { "description": "Raw blob data.", "items": { "pattern": "^0x[0-9a-f]*$", "title": "hex encoded bytes", "type": "string" }, "title": "blobs", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "from": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "from address", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The gas price willing to be paid by the sender in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "maxFeePerBlobGas": { "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per blob gas", "type": "string" }, "maxFeePerGas": { "description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per gas", "type": "string" }, "maxPriorityFeePerGas": { "description": "Maximum fee per gas the sender is willing to pay to miners in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max priority fee per gas", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "to": { "oneOf": [ { "title": "Contract Creation (null)", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" } ], "title": "to address" }, "type": { "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "type", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" } }, "title": "Transaction object generic to all types", "type": "object" } }, { "name": "Block", "required": false, "schema": { "oneOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" } ], "title": "Block number or tag" } } ], "result": { "name": "Gas used", "schema": { "additionalProperties": false, "properties": { "accessList": { "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "error": { "title": "error", "type": "string" }, "gasUsed": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Gas used", "type": "string" } }, "title": "Access list result", "type": "object" } }, "summary": "Generates an access list for a transaction.", "x-tier": "core" }, { "errors": [ { "code": 3, "data": { "pattern": "^0x[0-9a-f]*$", "title": "raw EVM revert data", "type": "string" }, "message": "execution reverted" } ], "examples": [ { "name": "eth_estimateGas example", "params": [ { "name": "Transaction", "value": { "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", "to": "0x44aa93095d6749a706051658b970b941c72c1d53", "value": "0x1" } } ], "result": { "name": "Gas used", "value": "0x5208" } } ], "name": "eth_estimateGas", "params": [ { "name": "Transaction", "required": true, "schema": { "additionalProperties": false, "properties": { "accessList": { "description": "EIP-2930 access list", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "authorizationList": { "description": "EIP-7702 authorization list", "items": { "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "chainId": { "description": "Chain ID on which this transaction is valid", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "s", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "chainId", "nonce", "address", "yParity", "r", "s" ], "type": "object" }, "title": "authorizationList", "type": "array" }, "blobVersionedHashes": { "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "blobVersionedHashes", "type": "array" }, "blobs": { "description": "Raw blob data.", "items": { "pattern": "^0x[0-9a-f]*$", "title": "hex encoded bytes", "type": "string" }, "title": "blobs", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "from": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "from address", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The gas price willing to be paid by the sender in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "maxFeePerBlobGas": { "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per blob gas", "type": "string" }, "maxFeePerGas": { "description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per gas", "type": "string" }, "maxPriorityFeePerGas": { "description": "Maximum fee per gas the sender is willing to pay to miners in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max priority fee per gas", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "to": { "oneOf": [ { "title": "Contract Creation (null)", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" } ], "title": "to address" }, "type": { "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "type", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" } }, "title": "Transaction object generic to all types", "type": "object" } }, { "name": "Block", "required": false, "schema": { "oneOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" } ], "title": "Block number or tag" } } ], "result": { "name": "Gas used", "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "summary": "Generates and returns an estimate of how much gas is necessary to allow the transaction to complete.", "x-tier": "core" }, { "description": "Returns transaction base fee per gas and effective priority fee per gas for the requested/supported block range.", "examples": [ { "name": "eth_feeHistory example", "params": [ { "name": "blockCount", "value": "0x5" }, { "name": "newestblock", "value": "latest" }, { "name": "rewardPercentiles", "value": [ 20, 30 ] } ], "result": { "name": "Fee history result", "value": { "baseFeePerBlobGas": [ "0x7b7609c19", "0x6dbe41789", "0x7223341d4", "0x6574a002c", "0x7223341d4", "0x6574a002c" ], "baseFeePerGas": [ "0x3fa63a3f", "0x37f999ee", "0x3e36f20a", "0x4099f79a", "0x430d532d", "0x46fcd4a4" ], "blobGasUsedRatio": [ 0, 0.6666666666666666, 0, 1, 0 ], "gasUsedRatio": [ 0.017712333333333333, 0.9458865666666667, 0.6534561, 0.6517375666666667, 0.7347769666666667 ], "oldestblock": "0x10b52f", "reward": [ [ "0x3b9aca00", "0x59682f00" ], [ "0x3a13012", "0x3a13012" ], [ "0x3a13012", "0x3a13012" ], [ "0xf4240", "0xf4240" ], [ "0xf4240", "0xf4240" ] ] } } } ], "name": "eth_feeHistory", "params": [ { "description": "Requested range of blocks. Clients will return less than the requested range if not all blocks are available.", "name": "blockCount", "required": true, "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, { "description": "Highest block of the requested range.", "name": "newestBlock", "required": true, "schema": { "oneOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" } ], "title": "Block number or tag" } }, { "description": "A monotonically increasing list of percentile values. For each block in the requested range, the transactions will be sorted in ascending order by effective tip per gas and the corresponding effective tip for the percentile will be determined, accounting for gas consumed.", "name": "rewardPercentiles", "required": true, "schema": { "items": { "description": "Floating point value between 0 and 100.", "title": "rewardPercentile", "type": "number" }, "title": "rewardPercentiles", "type": "array" } } ], "result": { "description": "Fee history for the returned block range. This can be a subsection of the requested range if not all blocks are available.", "name": "Fee history result", "schema": { "additionalProperties": false, "description": "Fee history results.", "properties": { "baseFeePerBlobGas": { "description": "An array of block base fees per blob 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-4844 blocks.", "items": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" }, "title": "baseFeePerBlobGasArray", "type": "array" }, "baseFeePerGas": { "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.", "items": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" }, "title": "baseFeePerGasArray", "type": "array" }, "blobGasUsedRatio": { "description": "An array of block blob gas used ratios. These are calculated as the ratio of blobGasUsed and the max blob gas per block.", "items": { "maximum": 1, "minimum": 0, "title": "normalized ratio", "type": "number" }, "title": "blobGasUsedRatio", "type": "array" }, "gasUsedRatio": { "description": "An array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit.", "items": { "maximum": 1, "minimum": 0, "title": "normalized ratio", "type": "number" }, "title": "gasUsedRatio", "type": "array" }, "oldestBlock": { "description": "Lowest number block of returned range.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "oldestBlock", "type": "string" }, "reward": { "description": "A two-dimensional array of effective priority fees per gas at the requested block percentiles.", "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.", "items": { "description": "A given percentile sample of effective priority fees per gas from a single block in ascending order, weighted by gas used. Zeroes are returned if the block is empty.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "rewardPercentile", "type": "string" }, "title": "rewardPercentile", "type": "array" }, "title": "rewardArray", "type": "array" } }, "required": [ "oldestBlock", "baseFeePerGas", "gasUsedRatio" ], "title": "feeHistoryResults", "type": "object" } }, "summary": "Transaction fee history", "x-tier": "core" }, { "examples": [ { "name": "eth_gasPrice example", "params": [], "result": { "name": "Gas price", "value": "0x3e8" } } ], "name": "eth_gasPrice", "params": [], "result": { "name": "Gas price", "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Gas price", "type": "string" } }, "summary": "Returns the current price per gas in wei.", "x-tier": "core" }, { "examples": [ { "name": "eth_getBalance example", "params": [ { "name": "Address", "value": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73" }, { "name": "Block", "value": "latest" } ], "result": { "name": "Balance", "value": "0x1cfe56f3795885980000" } } ], "name": "eth_getBalance", "params": [ { "name": "Address", "required": true, "schema": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" } }, { "name": "Block", "required": true, "schema": { "anyOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" }, { "pattern": "^0x[0-9a-f]{64}$", "title": "Block hash", "type": "string" } ], "title": "Block number, tag, or block hash" } } ], "result": { "name": "Balance", "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "summary": "Returns the balance of the account of given address.", "x-tier": "core" }, { "errors": [ { "code": 4444, "message": "Pruned history unavailable" } ], "examples": [ { "name": "eth_getBlockByNumber example", "params": [ { "name": "block", "value": "0x68b3" }, { "name": "Hydrated transactions", "value": false } ], "result": { "name": "Block information", "value": { "baseFeePerGas": "0x7", "blobGasUsed": "0x0", "difficulty": "0x66e619a", "excessBlobGas": "0x0", "extraData": "0xd583010502846765746885676f312e37856c696e7578", "gasLimit": "0x47e7c4", "gasUsed": "0x37993", "hash": "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c", "logsBloom": "0x00000000000000100000004080000000000500000000000000020000100000000800001000000004000001000000000000000800040010000020100000000400000010000000000000000040000000000000040000000000000000000000000000000400002400000000000000000000000000000004000004000000000000840000000800000080010004000000001000000800000000000000000000000000000000000800000000000040000000020000000000000000000800000400000000000000000000000600000400000000002000000000000000000000004000000000000000100000000000000000000000000000000000040000900010000000", "miner": "0xb42b6c4a95406c78ff892d270ad20b22642e102d", "mixHash": "0x24900fb3da77674a861c428429dce0762707ecb6052325bbd9b3c64e74b5af9d", "nonce": "0x378da40ff335b070", "number": "0x68b3", "parentBeaconBlockRoot": "0x95c4dbd5b19f6fe3cbc3183be85ff4e85ebe75c5b4fc911f1c91e5b7a554a685", "parentHash": "0x1f68ac259155e2f38211ddad0f0a15394d55417b185a93923e2abe71bb7a4d6d", "receiptsRoot": "0x68461ab700003503a305083630a8fb8d14927238f0bc8b6b3d246c0c64f21f4a", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x334", "stateRoot": "0x91309efa7e42c1f137f31fe9edbe88ae087e6620d0d59031324da3e2f4f93233", "timestamp": "0x5835c54d", "transactions": [ "0xa0807e117a8dd124ab949f460f08c36c72b710188f01609595223b325e58e0fc", "0xeae6d797af50cb62a596ec3939114d63967c374fa57de9bc0f4e2b576ed6639d" ], "transactionsRoot": "0x4d0c8e91e16bdff538c03211c5c73632ed054d00a7e210c0eb25146c20048126", "uncles": [], "withdrawals": [ { "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f", "amount": "0x11a33e3760", "index": "0x0", "validatorIndex": "0x9d8c0" } ], "withdrawalsRoot": "0x7a4ecf19774d15cf9c15adf0dd8e8a250c128b26c9e2ab2a08d6c9c8ffbd104f" } } } ], "name": "eth_getBlockByNumber", "params": [ { "name": "Block", "required": true, "schema": { "oneOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" } ], "title": "Block number or tag" } }, { "name": "Hydrated transactions", "required": true, "schema": { "title": "hydrated", "type": "boolean" } } ], "result": { "name": "Block information", "schema": { "oneOf": [ { "title": "Not Found (null)", "type": "null" }, { "properties": { "baseFeePerGas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Base fee per gas", "type": "string" }, "blobGasUsed": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Blob gas used", "type": "string" }, "blockAccessListHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "EIP-7928 block access list hash", "type": "string" }, "difficulty": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Difficulty", "type": "string" }, "excessBlobGas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Excess blob gas", "type": "string" }, "extraData": { "pattern": "^0x[0-9a-f]*$", "title": "Extra data", "type": "string" }, "gasLimit": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Gas limit", "type": "string" }, "gasUsed": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Gas used", "type": "string" }, "hash": { "pattern": "^0x[0-9a-f]{64}$", "title": "Hash", "type": "string" }, "logsBloom": { "pattern": "^0x[0-9a-f]{512}$", "title": "Bloom filter", "type": "string" }, "miner": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Coinbase", "type": "string" }, "mixHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "Mix hash", "type": "string" }, "nonce": { "pattern": "^0x[0-9a-f]{16}$", "title": "Nonce", "type": "string" }, "number": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Number", "type": "string" }, "parentBeaconBlockRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "Parent Beacon Block Root", "type": "string" }, "parentHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "Parent block hash", "type": "string" }, "receiptsRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "Receipts root", "type": "string" }, "requestsHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "EIP-7685 requests hash", "type": "string" }, "sha3Uncles": { "pattern": "^0x[0-9a-f]{64}$", "title": "Ommers hash", "type": "string" }, "size": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block size", "type": "string" }, "stateRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "State root", "type": "string" }, "timestamp": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Timestamp", "type": "string" }, "transactions": { "anyOf": [ { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "Transaction hashes", "type": "array" }, { "items": { "oneOf": [ { "properties": { "accessList": { "description": "EIP-2930 access lists", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "authorizationList": { "description": "List of authorizations for the transaction", "items": { "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "chainId": { "description": "Chain ID on which this transaction is valid", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "s", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "chainId", "nonce", "address", "yParity", "r", "s" ], "type": "object" }, "title": "authorizationList", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "maxFeePerGas": { "description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per gas", "type": "string" }, "maxPriorityFeePerGas": { "description": "Maximum fee per gas the sender is willing to pay to miners in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max priority fee per gas", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "to address", "type": "string" }, "type": { "pattern": "^0x4$", "title": "type", "type": "string" }, "v": { "description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "accessList", "authorizationList", "chainId", "gas", "input", "maxFeePerGas", "maxPriorityFeePerGas", "nonce", "r", "s", "to", "type", "value", "yParity" ], "title": "Signed 7702 Transaction", "type": "object" }, { "properties": { "accessList": { "description": "EIP-2930 access list", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "blobVersionedHashes": { "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs", "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "blobVersionedHashes", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "maxFeePerBlobGas": { "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per blob gas", "type": "string" }, "maxFeePerGas": { "description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per gas", "type": "string" }, "maxPriorityFeePerGas": { "description": "Maximum fee per gas the sender is willing to pay to miners in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max priority fee per gas", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "to address", "type": "string" }, "type": { "pattern": "^0x3$", "title": "type", "type": "string" }, "v": { "description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "accessList", "blobVersionedHashes", "chainId", "gas", "input", "maxFeePerBlobGas", "maxFeePerGas", "maxPriorityFeePerGas", "nonce", "r", "s", "to", "type", "value", "yParity" ], "title": "Signed 4844 Transaction", "type": "object" }, { "properties": { "accessList": { "description": "EIP-2930 access list", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "maxFeePerGas": { "description": "The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max fee per gas", "type": "string" }, "maxPriorityFeePerGas": { "description": "Maximum fee per gas the sender is willing to pay to miners in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "max priority fee per gas", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "oneOf": [ { "title": "Contract Creation (null)", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" } ], "title": "to address" }, "type": { "pattern": "^0x2$", "title": "type", "type": "string" }, "v": { "description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "accessList", "chainId", "gas", "gasPrice", "input", "maxFeePerGas", "maxPriorityFeePerGas", "nonce", "r", "s", "type", "value", "yParity" ], "title": "Signed 1559 Transaction", "type": "object" }, { "properties": { "accessList": { "description": "EIP-2930 access list", "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "storageKeys": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "type": "array" } }, "required": [ "address", "storageKeys" ], "title": "Access list entry", "type": "object" }, "title": "accessList", "type": "array" }, "chainId": { "description": "Chain ID that this transaction is valid on.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The gas price willing to be paid by the sender in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "oneOf": [ { "title": "Contract Creation (null)", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" } ], "title": "to address" }, "type": { "pattern": "^0x1$", "title": "type", "type": "string" }, "v": { "description": "For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" }, "yParity": { "description": "The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", "pattern": "^0x([0-9a-fA-F]?){1,2}$", "title": "yParity", "type": "string" } }, "required": [ "accessList", "chainId", "gas", "gasPrice", "input", "nonce", "r", "s", "type", "value", "yParity" ], "title": "Signed 2930 Transaction", "type": "object" }, { "properties": { "chainId": { "description": "Chain ID that this transaction is valid on.", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "chainId", "type": "string" }, "gas": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas limit", "type": "string" }, "gasPrice": { "description": "The gas price willing to be paid by the sender in wei", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "gas price", "type": "string" }, "input": { "pattern": "^0x[0-9a-f]*$", "title": "input data", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "nonce", "type": "string" }, "r": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "r", "type": "string" }, "s": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "s", "type": "string" }, "to": { "oneOf": [ { "title": "Contract Creation (null)", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" } ], "title": "to address" }, "type": { "pattern": "^0x0$", "title": "type", "type": "string" }, "v": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "v", "type": "string" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "value", "type": "string" } }, "required": [ "gas", "gasPrice", "input", "nonce", "r", "s", "type", "v", "value" ], "title": "Signed Legacy Transaction", "type": "object" } ], "properties": { "blockHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "block hash", "type": "string" }, "blockNumber": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "block number", "type": "string" }, "blockTimestamp": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "block timestamp", "type": "string" }, "from": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "from address", "type": "string" }, "hash": { "pattern": "^0x[0-9a-f]{64}$", "title": "transaction hash", "type": "string" }, "transactionIndex": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "transaction index", "type": "string" } }, "required": [ "blockHash", "blockNumber", "blockTimestamp", "from", "hash", "transactionIndex" ], "title": "Transaction information", "type": "object" }, "title": "Full transactions", "type": "array" } ] }, "transactionsRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "Transactions root", "type": "string" }, "uncles": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "Uncles", "type": "array" }, "withdrawals": { "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "recipient address for withdrawal value", "type": "string" }, "amount": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "value contained in withdrawal", "type": "string" }, "index": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$", "title": "index of withdrawal", "type": "string" }, "validatorIndex": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$", "title": "index of validator that generated withdrawal", "type": "string" } }, "required": [ "index", "validatorIndex", "address", "amount" ], "title": "Validator withdrawal", "type": "object" }, "title": "Withdrawals", "type": "array" }, "withdrawalsRoot": { "pattern": "^0x[0-9a-f]{64}$", "title": "Withdrawals root", "type": "string" } }, "required": [ "hash", "parentHash", "sha3Uncles", "miner", "stateRoot", "transactionsRoot", "receiptsRoot", "logsBloom", "number", "gasLimit", "gasUsed", "timestamp", "extraData", "mixHash", "nonce", "size", "transactions", "uncles" ], "title": "Block object", "type": "object" } ] } }, "summary": "Returns information about a block by number.", "x-tier": "core" }, { "errors": [ { "code": 4444, "message": "Pruned history unavailable" } ], "examples": [ { "name": "eth_getBlockTransactionCountByNumber example", "params": [ { "name": "Block", "value": "0xe8" } ], "result": { "name": "Transaction count", "value": "0x8" } } ], "name": "eth_getBlockTransactionCountByNumber", "params": [ { "name": "Block", "schema": { "oneOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" } ], "title": "Block number or tag" } } ], "result": { "name": "Transaction count", "schema": { "oneOf": [ { "title": "Not Found (null)", "type": "null" }, { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Transaction count", "type": "string" } ] } }, "summary": "Returns the number of transactions in a block matching the given block number.", "x-tier": "core" }, { "examples": [ { "name": "eth_getCode example", "params": [ { "name": "Address", "value": "0xa50a51c09a5c451c52bb714527e1974b686d8e77" }, { "name": "Block", "value": "latest" } ], "result": { "name": "Bytecode", "value": "0x60806040526004361060485763ffffffff7c01000000000000000000000000000000000000000000000000000000006000350416633fa4f2458114604d57806355241077146071575b600080fd5b348015605857600080fd5b50605f6088565b60408051918252519081900360200190f35b348015607c57600080fd5b506086600435608e565b005b60005481565b60008190556040805182815290517f199cd93e851e4c78c437891155e2112093f8f15394aa89dab09e38d6ca0727879181900360200190a1505600a165627a7a723058209d8929142720a69bde2ab3bfa2da6217674b984899b62753979743c0470a2ea70029" } } ], "name": "eth_getCode", "params": [ { "name": "Address", "required": true, "schema": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" } }, { "name": "Block", "required": true, "schema": { "anyOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" }, { "pattern": "^0x[0-9a-f]{64}$", "title": "Block hash", "type": "string" } ], "title": "Block number, tag, or block hash" } } ], "result": { "name": "Bytecode", "schema": { "pattern": "^0x[0-9a-f]*$", "title": "hex encoded bytes", "type": "string" } }, "summary": "Returns code at a given address.", "x-tier": "core" }, { "examples": [ { "name": "eth_getFilterChanges example", "params": [ { "name": "Filter identifier", "value": "0x01" } ], "result": { "name": "Log objects", "value": [ { "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5", "blockNumber": "0x233", "blockTimestamp": "0x11", "data": "0x0000000000000000000000000000000000000000000000000000000000000004", "logIndex": "0x0", "removed": false, "topics": [ "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" ], "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d", "transactionIndex": "0x0" }, { "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed", "blockNumber": "0x238", "blockTimestamp": "0x22", "data": "0x0000000000000000000000000000000000000000000000000000000000000007", "logIndex": "0x0", "removed": false, "topics": [ "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" ], "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058", "transactionIndex": "0x0" } ] } } ], "name": "eth_getFilterChanges", "params": [ { "name": "Filter identifier", "required": true, "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } } ], "result": { "name": "Log objects", "schema": { "oneOf": [ { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "new block or transaction hashes", "type": "array" }, { "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "address", "type": "string" }, "blockHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "block hash", "type": "string" }, "blockNumber": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "block number", "type": "string" }, "blockTimestamp": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "block timestamp", "type": "string" }, "data": { "pattern": "^0x[0-9a-f]*$", "title": "data", "type": "string" }, "logIndex": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "log index", "type": "string" }, "removed": { "title": "removed", "type": "boolean" }, "topics": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 hex encoded bytes", "type": "string" }, "title": "topics", "type": "array" }, "transactionHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "transaction hash", "type": "string" }, "transactionIndex": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "transaction index", "type": "string" } }, "required": [ "transactionHash" ], "title": "log", "type": "object" }, "title": "new logs", "type": "array" } ], "title": "Filter results" } }, "summary": "Polling method for the filter with the given ID (created using `eth_newFilter`). Returns an array of logs, block hashes, or transaction hashes since last poll, depending on the installed filter.", "x-tier": "core" }, { "errors": [ { "code": 4444, "message": "Pruned history unavailable" } ], "examples": [ { "name": "eth_getLogs example", "params": [ { "name": "Filter", "value": { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "fromBlock": "0x137d3c2", "toBlock": "0x137d3c3", "topics": [] } } ], "result": { "name": "Log objects", "value": [ { "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5", "blockNumber": "0x233", "blockTimestamp": "0x11", "data": "0x0000000000000000000000000000000000000000000000000000000000000004", "logIndex": "0x0", "removed": false, "topics": [ "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" ], "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d", "transactionIndex": "0x0" }, { "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed", "blockNumber": "0x238", "blockTimestamp": "0x22", "data": "0x0000000000000000000000000000000000000000000000000000000000000007", "logIndex": "0x0", "removed": false, "topics": [ "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" ], "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058", "transactionIndex": "0x0" } ] } } ], "name": "eth_getLogs", "params": [ { "name": "Filter", "required": true, "schema": { "oneOf": [ { "not": { "required": [ "blockHash" ] }, "properties": { "address": { "oneOf": [ { "title": "Any Address", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" }, { "items": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "title": "Addresses", "type": "array" } ], "title": "Address(es)" }, "fromBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "from block", "type": "string" }, "toBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "to block", "type": "string" }, "topics": { "oneOf": [ { "title": "Any Topic Match", "type": "null" }, { "items": { "oneOf": [ { "pattern": "^0x[0-9a-f]{64}$", "title": "Single Topic Match", "type": "string" }, { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 hex encoded bytes", "type": "string" }, "title": "Multiple Topic Match", "type": "array" } ], "title": "Filter Topic List Entry" }, "title": "Specified Filter Topics", "type": "array" } ], "title": "Topics" } }, "title": "Filter by block range", "type": "object" }, { "properties": { "address": { "oneOf": [ { "title": "Any Address", "type": "null" }, { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "Address", "type": "string" }, { "items": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" }, "title": "Addresses", "type": "array" } ], "title": "Address(es)" }, "blockHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "block hash", "type": "string" }, "topics": { "oneOf": [ { "title": "Any Topic Match", "type": "null" }, { "items": { "oneOf": [ { "pattern": "^0x[0-9a-f]{64}$", "title": "Single Topic Match", "type": "string" }, { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 hex encoded bytes", "type": "string" }, "title": "Multiple Topic Match", "type": "array" } ], "title": "Filter Topic List Entry" }, "title": "Specified Filter Topics", "type": "array" } ], "title": "Topics" } }, "required": [ "blockHash" ], "title": "Filter by block hash", "type": "object" } ], "title": "filter" } } ], "result": { "name": "Log objects", "schema": { "oneOf": [ { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 byte hex value", "type": "string" }, "title": "new block or transaction hashes", "type": "array" }, { "items": { "additionalProperties": false, "properties": { "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "address", "type": "string" }, "blockHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "block hash", "type": "string" }, "blockNumber": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "block number", "type": "string" }, "blockTimestamp": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "block timestamp", "type": "string" }, "data": { "pattern": "^0x[0-9a-f]*$", "title": "data", "type": "string" }, "logIndex": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "log index", "type": "string" }, "removed": { "title": "removed", "type": "boolean" }, "topics": { "items": { "pattern": "^0x[0-9a-f]{64}$", "title": "32 hex encoded bytes", "type": "string" }, "title": "topics", "type": "array" }, "transactionHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "transaction hash", "type": "string" }, "transactionIndex": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "transaction index", "type": "string" } }, "required": [ "transactionHash" ], "title": "log", "type": "object" }, "title": "new logs", "type": "array" } ], "title": "Filter results" } }, "summary": "Returns an array of all logs matching the specified filter.", "x-tier": "core" }, { "examples": [ { "name": "eth_getProof example", "params": [ { "name": "Address", "value": "0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8" }, { "name": "StorageKeys", "value": [ "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421" ] }, { "name": "Block", "value": "latest" } ], "result": { "name": "Account", "value": { "accountProof": [ "0xf90211a06a718c2c9da77c253b12d7b2569657901e37bb691718f5dda1b86157ab1dd5eda0e7f19ed5e21bccc8d3260236b24f80ad88b3634f5d005f37b838881f0e12f1bda0abb301291704e4d92686c0f5f8ebb1734185321559b8d717ffdca95c99591976a0d0c2026bfab65c3b95276bfa82af9dec860b485f8857f293c148d63a2182128fa0c98044ec9a1273a218bed58b478277dd39173ad7b8edb95c200423a6bc8fc25fa056e5a55d9ddccdbf49362857200bbb1f042d61187c9f5f9ddcff5d2f1fc984a2a02a5b7200af424114f99a4b5f0a21c19aac82209e431ed80bfde177adb1004bdfa0026e4374f0518ff44a80fa374838ecb86cc64ac93bb710fea6dff4198f947b27a03fea341d87984673ad523177ed52f278bf4d8f97e6531c8ece932aeede4802f4a0bfe2f4a7fcb78f7e9f080dea7b6977fb1d88c441696e4456dad92b9d34ff0f43a02a3eb5c0edb14626c9c629601027bd60178bb2b688a67cea4d179fc432436615a0747355b8e02f3b884b4ffe5cea1619e32515fea064cca98208591af8c744e894a0874253737bae37f020ad3bb7e3292c7c4a63cdc158af6b33aaa4deaef016dccba03d8192bc1fc6aa1548912e763a0b5013a94399cefad7b47cf388873b2b794068a09b67f9737c6028d796bfd1c5da57a6f45824dc891f848ea0e1f8019d1fb5fba8a0aa871f9de8da85960fcd8a22cdf21c27f11e3966c14a6737ffd414b98dda00b280", "0xf90211a0d360be1e1da1a0c32bc4c105833bd531e59d110684007b7c50fb2709002973eca0cf6dd1e350a7031b4e2ab49c899fd8bd47551c8565d8fd8d1d7796c83820c3b1a0eb0a88c29bb33989a589156f7bf07d9efc74034dd9d3f5b73385c3b45c3249bea02783c25f97a6ddb8dc07adf4b176991836d39184b1f678adeda832fff15e3664a00a4e288060045e587774d8a64993a7add73068b16863145e1e8eeb4602e18e19a0340851f4046ad1298962d6e47d05c66329549c839c158748aaad7ae00b943aefa085b127bc2a3bd17604283de21b2b3c9aa8f1d4b7b85c94d8105a46fe32c77688a00f531d62b3c5435324c01009c284fe31277e8d38302b75ea01be89f09e205969a00011c8351c0e3d639ac54b9d3a59de630b16a67de8270d7d6064d0a67e93f9cca048780d32b7f2db88650b51c46f46fd0a68795edee1fd5ecee6eb3595741d9669a0c91afd74eaf8e08a997061a62b354e2516fdc494e8e26cc50ceeb8f4a175608ba0e2c07f1b48fab80eecb340f5882e8c7b32ee416e4045c61f1df646a133487303a01a1eff78435a7a29a29463bdc3486ae81364b00bea82ba0fdf67a110770f2261a04f2eb440ba71c72da5fd7f0e439018d6671dc809f747213a1ea755848124e994a074ff9f37fce99daa3ed01dd763076450022996fc729be2cc43c61ec5182c2366a0b80b36b7b621112592f52390b89748d422e9b1517c4b0203b8176a53f89d4a6680", "0xf90211a0b25f283bd01a8c8b2418049f9585bc37ff2c1e2e12eab4b7f64ae1f26647389aa02ad96c150d7c3c9c194d30315456852cf6a0a940e0191ae5d04007454823d4e9a0b220cf7a855e2dbcc0b973134e2e119b982d7d40dbb1b27d99816c41f40e829aa049224431da84cbf1b7ae813abcc9ef4c1dfc1760f6ddc5d57f7354bf3cbf6cc4a015191f879ac115b362f0257fd3eedb789537e836574a5b1abf1c9982ebe3bdfea07913c1b6e7282569d2d421e9fa2257f5d1698e93303bc49b941704287d7aaefea0a526576981ce6fd9f2bd48dd2ca6d5272f2fbdc85f0ee35a295f6ccd97ae8765a0313fad407f0c737c29024c02a890c4ecc12d7771c05ab7b435e5087a7cdef4d9a0d2044603cba9d4afdaf6fd2470e729ef3a65242de71276f20d59accfa6b53a7ca0457caacb9370c09b15f7d904adefd2308be94e23669ba5f43241ffff5f438a0aa09fb2dd45a383a0cc088a72b14117e1e9b7d6889218f3ac7631e8de644c5cb76da0c675dcd4d3fb692b514851c6106e2b09e6f5661d56a0a32ae02e2efc1515c235a074949a59ff1bdba87548510d6e404ec4532f4456dfdec8e753d92fda11a3088ba0a328c6ab1ab8f70db4d23e95bb163c13ba0c508f063a5b1393a4efd7ff375f05a0c722fe3ce796998269373cbb2fc229b2bdf2c43c6c2df003309422e043ce6c03a024e69343286eec44fa4744f6907209116e5383cff3fa98fe81ba06e7e8d4366680", "0xf90211a00e99ba2198124b8241ea304551fe973215829e2fbc0438d67922707a2a847432a0bb9ce24fd527879c5fe6dbbec1ef5a05ed9d1ca88e921d140bafbec1112f6a6aa099787fd6c7a1989229c4291ef5267335e66152ce417daea46e66d19cb6f81d1ca0e430ff4b8d5621baa5978673344e78b4d8b4df51431b6e63785267c98a24ce18a0bb3e91a825fe3d42ed270a93e9ad1aabd566c40cb28e622f7f1d7ee967c8afd6a0aa364b0056870c6507bc3262a5f851ecb13684088bdb13996d3cb2db401ce3ffa0a3732eba4c7a6e062665ab5be08acb986c3db87556fb138548cc900ff1e56995a026b088e90c9738b8ce16e853107a937a50d52726a24f9f6ce60f587762eb45a2a006c9d5bc3c064b5c1fb565bff91cace9161c64ae653a329610c1dcf34d434429a06c16df2edc70656d322d0c2403bad7d45bc790ffc3e7adeef856d98ea6afc91ba0ae05ed5d6c34b5da29c2e94d7880aeba0906f95f4ec10b132a1d4766a0701c98a01470a86aa350d1ada0c082eac75de828a851f9c8c7c4aa49b1556fe3a5574966a0334eef025100a6da1033710dd98e0475f29d3d7e397caf618ca71c336c5f4f49a0ef0b3abbebcff34d6a8a8f5cdbfbd154ab3452b58dcb09de58ec983644963675a041857e865ec38e200a13bc1a3cb71c7d69aeef7ffdee8be515c9a5b691ce091fa059edd0eb3bbec36bbf38a19802d4646c00ba821ab55fdeea12e15bab62c4e1e580", "0xf90211a0af0c7fa65ffcb84c31e68c1cf00e1a20bf8bb497c39883e19b66a99975b03431a0c492cab3623eb7926069794c3c718733e16c5fd0d4a13fb7c752ee9809aac7ada05003cea7132aa70d6f36731d60640a90bcd8f4fd493e4540d5ab1b4943679c0ca0fd700683405b1d2306b586dd3b5b2f92f1692fae20d17cd8b8e59d09b9c6670da01db8683910e46e56e8afeb9fe2b7c35382e5a0914d7b0dd8f0e8cb9981ba7435a0fa7f75d73aa73c35824387bec81388315caa4aee3f4f5562f971beb256c62d49a0ee478e420d83f413e8568dacfd5d83f83a5dd7c45f494b504828e5dc962f0e3ea094b95444a917ac94a675681f6bf851172ad0969801a783a63a71edafed45e7a7a0a0c46586e109abe80fe50361dd582e3f143cb416828239faa43bb2b890869501a0ae051d5d43634c68bf9c97823256cc68580f194dfdbd0c301140c7ca5853430ca0660b9365bb77ec9cdc6eb95516c162dca20727c6f828dbbeb1ae110dde4d3134a09feb1b75e84ff6722e4d837bfb6d207b6ee3b21b86844a01140ce293813b49a1a0ed58a70b04efa3bdc0babe2abfa20824a75d61d52291bfdb5cf08597800764d6a020a2d5d3a83f9e35ad9fd1c448626d90af0eb3efefaa4f2f93207b4096ef5507a0fc8efc4484dcf0a54f0574de9aaade0dcff6ec3599edb9f82efb26b6566dcaeaa032f7e79856db3fd984f72bb2c93d4dab328198d355a61c975fab1f08bdb2046580" ], "address": "0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8", "balance": "0x0", "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470", "nonce": "0x0", "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "storageProof": [ { "key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "proof": [ "0xf90211a0c87222cccea2bf32759fcee9dbaacbe3ea4165dd6184af6773651c5e00e34a8ba0be90e6e5d1a67ab5587779c60ac136d6a96db62b84c04998a5f03a367346abd6a05344aa1c9ca2e3e56bf98fd718ec43728578d148e1967fbaf8bf17a2a073a0bda011a2f9312c3308640a0d6ceeae218747290f23806067456da1d444c65abae437a0b3097a108bfce79af6699da4ae3003cd4929f0b4576aad655c31cb725bde84c7a0c133d3c637e174f36a73c22b1039eb003da6374bc0929321241badb3efa3c4a9a0f13059f2301ad9862ce02e3f7f3f2c9ab78eb30583764d73654f7f1f8b1e86fda06544e3915748b18204e09df75ff20d2fa6bd8121e2e669699012d54590383d6fa070e3a8e093691581d58fadb560b510262a758037632cd8670d3a36df828976b7a062a88a2900544dc76a32255a6b2b2a2eef8fa68279700c00adc7508286702552a0a474aeebd5603dfce46a6ecd1ecd519068dc034a544fde03ac42d4018e60a334a0b7d528fc41c8fdc8ea18c6e7d0099270c777ec1403cf879d1f5134bdc12a6c6ca04440f1242e42c5bfa7c536591ab89c8e84bea417435871c32eef1e25295b20daa06a5dcfe3cc84cff9d3e3c3ae868cfba8f0dd111a90c3f85869dab5b893f96643a026b2fb9dd7d08b0ed2f1c44fbf875011412a384f86f751c92e1013248d4aa371a0c75597b2b789fc4e939b71937390ce9d7d53159431328ac52180eef08ef200f280", "0xf90191a0f0c5b800b542001597f2b7a8e106ac0e2849d2cc1df1727ac35c4ea3965f1c9180a08537f2e248702a6ae2a57e9110a5740f5772c876389739ac90debd6a0692713ea00b3a26a05b5494fb3ff6f0b3897688a5581066b20b07ebab9252d169d928717fa0a9a54d84976d134d6dba06a65064c7f3a964a75947d452db6f6bb4b6c47b43aaa01e2a1ed3d1572b872bbf09ee44d2ed737da31f01de3c0f4b4e1f046740066461a076f251d160b9a02eb0b5c1d83b61c9cdd4f37361705e79a45529bf49801fb824a0774a01a624cb14a50d17f2fe4b7ae6af8a67bbb029177ccc3dd729a734484d3ea05921b8a19aebe4fff5a36071e311778f9b93459183fdf7f6d870b401fa25dcbba0c8d71dd13d2806e2865a5c2cfa447f626471bf0b66182a8fd07230434e1cad2680a0e9864fdfaf3693b2602f56cd938ccd494b8634b1f91800ef02203a3609ca4c21a0c69d174ad6b6e58b0bd05914352839ec60915cd066dd2bee2a48016139687f21a0513dd5514fd6bad56871711441d38de2821cc6913cb192416b0385f025650731808080" ], "value": "0x1" } ] } } } ], "name": "eth_getProof", "params": [ { "name": "Address", "required": true, "schema": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" } }, { "name": "StorageKeys", "required": true, "schema": { "items": { "pattern": "^0x[0-9a-f]{0,64}$", "title": "32 hex encoded bytes", "type": "string" }, "title": "Storage keys", "type": "array" } }, { "name": "Block", "required": true, "schema": { "anyOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" }, { "pattern": "^0x[0-9a-f]{64}$", "title": "Block hash", "type": "string" } ], "title": "Block number, tag, or block hash" } } ], "result": { "name": "Account", "schema": { "additionalProperties": false, "properties": { "accountProof": { "items": { "pattern": "^0x[0-9a-f]*$", "title": "hex encoded bytes", "type": "string" }, "title": "accountProof", "type": "array" }, "address": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "address", "type": "string" }, "balance": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "balance", "type": "string" }, "codeHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "codeHash", "type": "string" }, "nonce": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,15})$", "title": "nonce", "type": "string" }, "storageHash": { "pattern": "^0x[0-9a-f]{64}$", "title": "storageHash", "type": "string" }, "storageProof": { "items": { "additionalProperties": false, "properties": { "key": { "pattern": "^0x[0-9a-f]{0,64}$", "title": "key", "type": "string" }, "proof": { "items": { "pattern": "^0x[0-9a-f]*$", "title": "hex encoded bytes", "type": "string" }, "title": "proof", "type": "array" }, "value": { "pattern": "^0x(0|[1-9a-f][0-9a-f]{0,63})$", "title": "value", "type": "string" } }, "required": [ "key", "value", "proof" ], "title": "Storage proof", "type": "object" }, "title": "Storage proofs", "type": "array" } }, "required": [ "address", "accountProof", "balance", "codeHash", "nonce", "storageHash", "storageProof" ], "title": "Account proof", "type": "object" } }, "summary": "Returns the merkle proof for a given account and optionally some storage keys.", "x-tier": "core" }, { "examples": [ { "name": "eth_getTransactionCount example", "params": [ { "name": "Address", "value": "0xc94770007dda54cF92009BFF0dE90c06F603a09f" }, { "name": "Block", "value": "latest" } ], "result": { "name": "Transaction count", "value": "0x1" } } ], "name": "eth_getTransactionCount", "params": [ { "name": "Address", "required": true, "schema": { "pattern": "^0x[0-9a-fA-F]{40}$", "title": "hex encoded address", "type": "string" } }, { "name": "Block", "required": true, "schema": { "anyOf": [ { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Block number", "type": "string" }, { "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error", "enum": [ "earliest", "finalized", "safe", "latest", "pending" ], "title": "Block tag", "type": "string" }, { "pattern": "^0x[0-9a-f]{64}$", "title": "Block hash", "type": "string" } ], "title": "Block number, tag, or block hash" } } ], "result": { "name": "Account nonce", "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "summary": "Returns the nonce of an account in the state. NOTE: The name eth_getTransactionCount reflects the historical fact that an account's nonce and sent transaction count were the same. After the Pectra fork, with the inclusion of EIP-7702, this is no longer true.", "x-tier": "core" }, { "examples": [ { "name": "eth_maxPriorityFeePerGas example", "params": [], "result": { "name": "Max priority fee per gas", "value": "0x773c23ba" } } ], "name": "eth_maxPriorityFeePerGas", "params": [], "result": { "name": "Max priority fee per gas", "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Max priority fee per gas", "type": "string" } }, "summary": "Returns the current maxPriorityFeePerGas per gas in wei.", "x-tier": "core" }, { "examples": [ { "name": "eth_newBlockFilter example", "params": [], "result": { "name": "Filter identifier", "value": "0x01" } } ], "name": "eth_newBlockFilter", "params": [], "result": { "name": "Filter identifier", "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } }, "summary": "Creates a filter in the node, allowing for later polling. Registers client interest in new blocks, and returns an identifier.", "x-tier": "core" }, { "examples": [ { "name": "eth_syncing example", "params": [], "result": { "name": "Syncing status", "value": { "currentBlock": "0x1518", "highestBlock": "0x9567a3", "startingBlock": "0x0" } } } ], "name": "eth_syncing", "params": [], "result": { "name": "Syncing status", "schema": { "oneOf": [ { "additionalProperties": false, "properties": { "currentBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Current block", "type": "string" }, "highestBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Highest block", "type": "string" }, "startingBlock": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "Starting block", "type": "string" } }, "title": "Syncing progress", "type": "object" }, { "description": "Should always return false if not syncing.", "title": "Not syncing", "type": "boolean" } ], "title": "Syncing status" } }, "summary": "Returns an object with data about the sync status or false.", "x-tier": "core" }, { "examples": [ { "name": "eth_uninstallFilter example", "params": [ { "name": "Filter identifier", "value": "0x01" } ], "result": { "name": "Success", "value": true } } ], "name": "eth_uninstallFilter", "params": [ { "name": "Filter identifier", "required": true, "schema": { "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "hex encoded unsigned integer", "type": "string" } } ], "result": { "name": "Success", "schema": { "type": "boolean" } }, "summary": "Uninstalls a filter with given id.", "x-tier": "core" }, { "examples": [ { "name": "net_version example", "params": [], "result": { "name": "Network ID", "value": "1" } } ], "name": "net_version", "params": [], "result": { "name": "Network ID", "schema": { "pattern": "^[1-9][0-9]*$", "title": "decimal unsigned integer string", "type": "string" } }, "summary": "Returns the current network ID. This is usually equivalent to the chainID, but may differ from it for some legacy networks or special testnets.", "x-tier": "core" }, { "description": "Returns an object containing the count of transactions currently pending for\ninclusion in the next block(s), as well as ones that are scheduled for future\nexecution (transactions with nonce gaps).\n", "examples": [ { "name": "txpool_status example", "params": [], "result": { "name": "Transaction pool status", "value": { "pending": "0xa", "queued": "0x7" } } } ], "name": "txpool_status", "params": [], "result": { "name": "Transaction pool status", "schema": { "description": "The number of pending and queued transactions in the pool.", "properties": { "pending": { "description": "Number of transactions ready for inclusion in the next block(s)", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "pending count", "type": "string" }, "queued": { "description": "Number of transactions with nonce gaps awaiting preceding transactions before they can be executed", "pattern": "^0x(0|[1-9a-f][0-9a-f]*)$", "title": "queued count", "type": "string" } }, "required": [ "pending", "queued" ], "title": "Transaction pool status", "type": "object" } }, "summary": "Returns the number of pending and queued transactions in the pool.", "x-tier": "extended" } ] }