From 84a74c4989af4ea1a298ed1cc9aa71badd3a2dc9 Mon Sep 17 00:00:00 2001 From: bgravenorst Date: Tue, 3 Feb 2026 13:21:57 +1000 Subject: [PATCH] Test parser for base/ethereum. Signed-off-by: bgravenorst --- .../base/json-rpc-methods/eth_accounts.mdx | 46 +- .../base/json-rpc-methods/eth_blocknumber.mdx | 46 +- .../base/json-rpc-methods/eth_call.mdx | 46 +- .../base/json-rpc-methods/eth_chainid.mdx | 46 +- .../base/json-rpc-methods/eth_estimategas.mdx | 46 +- .../base/json-rpc-methods/eth_feehistory.mdx | 46 +- .../base/json-rpc-methods/eth_gasprice.mdx | 46 +- .../base/json-rpc-methods/eth_getbalance.mdx | 46 +- .../json-rpc-methods/eth_getblockbyhash.mdx | 46 +- .../json-rpc-methods/eth_getblockbynumber.mdx | 46 +- .../eth_getblocktransactioncountbyhash.mdx | 46 +- .../eth_getblocktransactioncountbynumber.mdx | 46 +- .../base/json-rpc-methods/eth_getcode.mdx | 46 +- .../base/json-rpc-methods/eth_getlogs.mdx | 46 +- .../base/json-rpc-methods/eth_getproof.mdx | 46 +- .../json-rpc-methods/eth_getstorageat.mdx | 46 +- .../eth_gettransactionbyblockhashandindex.mdx | 46 +- ...th_gettransactionbyblocknumberandindex.mdx | 46 +- .../eth_gettransactionbyhash.mdx | 46 +- .../eth_gettransactioncount.mdx | 46 +- .../eth_gettransactionreceipt.mdx | 46 +- .../eth_getunclebyblockhashandindex.mdx | 46 +- .../eth_getunclebyblocknumberandindex.mdx | 46 +- .../eth_getunclecountbyblockhash.mdx | 46 +- .../eth_getunclecountbyblocknumber.mdx | 46 +- .../eth_maxpriorityfeepergas.mdx | 46 +- .../json-rpc-methods/eth_protocolversion.mdx | 46 +- .../eth_sendrawtransaction.mdx | 46 +- .../base/json-rpc-methods/eth_syncing.mdx | 46 +- .../filter-methods/eth_getfilterchanges.mdx | 46 +- .../filter-methods/eth_getfilterlogs.mdx | 46 +- .../filter-methods/eth_newblockfilter.mdx | 46 +- .../filter-methods/eth_newfilter.mdx | 46 +- .../filter-methods/eth_uninstallfilter.mdx | 46 +- .../base/json-rpc-methods/net_peercount.mdx | 46 +- .../base/json-rpc-methods/net_version.mdx | 46 +- .../subscription-methods/eth_subscribe.mdx | 46 +- .../subscription-methods/eth_unsubscribe.mdx | 46 +- .../json-rpc-methods/web3_clientversion.mdx | 46 +- .../bundler/eth_estimateuseroperationgas.mdx | 46 +- .../bundler/eth_getuseroperationbyhash.mdx | 46 +- .../bundler/eth_getuseroperationreceipt.mdx | 46 +- .../bundler/eth_senduseroperation.mdx | 46 +- .../bundler/eth_supportedentrypoints.mdx | 46 +- .../pimlico_getuseroperationgasprice.mdx | 46 +- .../pimlico_getuseroperationstatus.mdx | 46 +- .../bundler/pimlico_simulateassetchanges.mdx | 52 +- .../json-rpc-methods/eth_accounts.mdx | 43 +- .../json-rpc-methods/eth_blobbasefee.mdx | 46 +- .../json-rpc-methods/eth_blocknumber.mdx | 46 +- .../ethereum/json-rpc-methods/eth_call.mdx | 46 +- .../ethereum/json-rpc-methods/eth_chainid.mdx | 46 +- .../json-rpc-methods/eth_createaccesslist.mdx | 46 +- .../json-rpc-methods/eth_estimategas.mdx | 46 +- .../json-rpc-methods/eth_feehistory.mdx | 46 +- .../json-rpc-methods/eth_gasprice.mdx | 46 +- .../json-rpc-methods/eth_getbalance.mdx | 46 +- .../json-rpc-methods/eth_getblockbyhash.mdx | 46 +- .../json-rpc-methods/eth_getblockbynumber.mdx | 46 +- .../json-rpc-methods/eth_getblockreceipts.mdx | 46 +- .../eth_getblocktransactioncountbyhash.mdx | 46 +- .../eth_getblocktransactioncountbynumber.mdx | 46 +- .../ethereum/json-rpc-methods/eth_getcode.mdx | 46 +- .../ethereum/json-rpc-methods/eth_getlogs.mdx | 46 +- .../json-rpc-methods/eth_getproof.mdx | 46 +- .../json-rpc-methods/eth_getstorageat.mdx | 46 +- .../eth_gettransactionbyblockhashandindex.mdx | 46 +- ...th_gettransactionbyblocknumberandindex.mdx | 46 +- .../eth_gettransactionbyhash.mdx | 52 +- .../eth_gettransactioncount.mdx | 46 +- .../eth_gettransactionreceipt.mdx | 46 +- .../eth_getunclebyblockhashandindex.mdx | 46 +- .../eth_getunclebyblocknumberandindex.mdx | 46 +- .../eth_getunclecountbyblockhash.mdx | 46 +- .../eth_getunclecountbyblocknumber.mdx | 46 +- .../ethereum/json-rpc-methods/eth_getwork.mdx | 46 +- .../json-rpc-methods/eth_hashrate.mdx | 46 +- .../eth_maxpriorityfeepergas.mdx | 46 +- .../ethereum/json-rpc-methods/eth_mining.mdx | 46 +- .../json-rpc-methods/eth_protocolversion.mdx | 46 +- .../eth_sendrawtransaction.mdx | 52 +- .../json-rpc-methods/eth_simulatev1.mdx | 267 +- .../json-rpc-methods/eth_submitwork.mdx | 46 +- .../ethereum/json-rpc-methods/eth_syncing.mdx | 46 +- .../filter-methods/eth_getfilterchanges.mdx | 46 +- .../filter-methods/eth_getfilterlogs.mdx | 46 +- .../filter-methods/eth_newblockfilter.mdx | 46 +- .../filter-methods/eth_newfilter.mdx | 46 +- .../filter-methods/eth_uninstallfilter.mdx | 46 +- .../json-rpc-methods/net_listening.mdx | 46 +- .../json-rpc-methods/net_peercount.mdx | 46 +- .../ethereum/json-rpc-methods/net_version.mdx | 46 +- .../subscription-methods/eth_subscribe.mdx | 46 +- .../subscription-methods/eth_unsubscribe.mdx | 46 +- .../trace-methods/trace_block.mdx | 46 +- .../trace-methods/trace_call.mdx | 46 +- .../trace-methods/trace_callmany.mdx | 46 +- .../trace-methods/trace_filter.mdx | 46 +- .../trace-methods/trace_transaction.mdx | 46 +- .../json-rpc-methods/web3_clientversion.mdx | 46 +- src/components/ParserOpenRPC/index.tsx | 28 +- src/lib/constants.ts | 2 + src/plugins/plugin-json-rpc.ts | 2 + src/specs/base/openrpc.json | 13295 ++++++++++ src/specs/ethereum/openrpc.json | 21290 ++++++++++++++++ 105 files changed, 35512 insertions(+), 3941 deletions(-) create mode 100644 src/specs/base/openrpc.json create mode 100644 src/specs/ethereum/openrpc.json diff --git a/services/reference/base/json-rpc-methods/eth_accounts.mdx b/services/reference/base/json-rpc-methods/eth_accounts.mdx index 2713815ef3f..2b7545fabfa 100644 --- a/services/reference/base/json-rpc-methods/eth_accounts.mdx +++ b/services/reference/base/json-rpc-methods/eth_accounts.mdx @@ -2,43 +2,15 @@ title: Base eth_accounts sidebar_label: eth_accounts description: Returns a list of Base accounts. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_accounts-description.mdx" - -# `eth_accounts` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_accounts-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_accounts-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_accounts-example.mdx" - - - -### Request - -import Request from "./_eth_accounts-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_accounts-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_blocknumber.mdx b/services/reference/base/json-rpc-methods/eth_blocknumber.mdx index a3eb3227792..a3488371eeb 100644 --- a/services/reference/base/json-rpc-methods/eth_blocknumber.mdx +++ b/services/reference/base/json-rpc-methods/eth_blocknumber.mdx @@ -2,43 +2,15 @@ title: Base eth_blockNumber sidebar_label: eth_blockNumber description: Returns the latest Base block number. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_blocknumber-description.mdx" - -# `eth_blockNumber` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_blocknumber-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_blocknumber-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_blocknumber-example.mdx" - - - -### Request - -import Request from "./_eth_blocknumber-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_blocknumber-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_call.mdx b/services/reference/base/json-rpc-methods/eth_call.mdx index 46d81e0739e..9512ddfa0f1 100644 --- a/services/reference/base/json-rpc-methods/eth_call.mdx +++ b/services/reference/base/json-rpc-methods/eth_call.mdx @@ -2,43 +2,15 @@ title: Base eth_call sidebar_label: eth_call description: Executes a Base call without creating a transaction. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_call-description.mdx" - -# `eth_call` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_call-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_call-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_call-example.mdx" - - - -### Request - -import Request from "./_eth_call-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_call-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_chainid.mdx b/services/reference/base/json-rpc-methods/eth_chainid.mdx index df1049ea6c7..bff5ee0181a 100644 --- a/services/reference/base/json-rpc-methods/eth_chainid.mdx +++ b/services/reference/base/json-rpc-methods/eth_chainid.mdx @@ -2,43 +2,15 @@ title: Base eth_chainId sidebar_label: eth_chainId description: Returns the Base chain ID. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_chainid-description.mdx" - -# `eth_chainId` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_chainid-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_chainid-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_chainid-example.mdx" - - - -### Request - -import Request from "./_eth_chainid-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_chainid-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_estimategas.mdx b/services/reference/base/json-rpc-methods/eth_estimategas.mdx index 7ed57ed3827..3b25b5d7788 100644 --- a/services/reference/base/json-rpc-methods/eth_estimategas.mdx +++ b/services/reference/base/json-rpc-methods/eth_estimategas.mdx @@ -2,43 +2,15 @@ title: Base eth_estimateGas sidebar_label: eth_estimateGas description: Estimates gas required for a Base transaction. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_estimategas-description.mdx" - -# `eth_estimateGas` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_estimategas-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_estimategas-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_estimategas-example.mdx" - - - -### Request - -import Request from "./_eth_estimategas-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_estimategas-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_feehistory.mdx b/services/reference/base/json-rpc-methods/eth_feehistory.mdx index 99b6a45b673..b3fd7cbd7a6 100644 --- a/services/reference/base/json-rpc-methods/eth_feehistory.mdx +++ b/services/reference/base/json-rpc-methods/eth_feehistory.mdx @@ -2,43 +2,15 @@ title: Base eth_feeHistory sidebar_label: eth_feeHistory description: Returns historical Base gas information. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_feehistory-description.mdx" - -# `eth_feeHistory` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_feehistory-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_feehistory-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_feehistory-example.mdx" - - - -### Request - -import Request from "./_eth_feehistory-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_feehistory-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_gasprice.mdx b/services/reference/base/json-rpc-methods/eth_gasprice.mdx index 9a0c0890d02..77010a78292 100644 --- a/services/reference/base/json-rpc-methods/eth_gasprice.mdx +++ b/services/reference/base/json-rpc-methods/eth_gasprice.mdx @@ -2,43 +2,15 @@ title: Base eth_gasPrice sidebar_label: eth_gasPrice description: Returns the current Base gas price. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gasprice-description.mdx" - -# `eth_gasPrice` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gasprice-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gasprice-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gasprice-example.mdx" - - - -### Request - -import Request from "./_eth_gasprice-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gasprice-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getbalance.mdx b/services/reference/base/json-rpc-methods/eth_getbalance.mdx index ecd537783b8..67914e05956 100644 --- a/services/reference/base/json-rpc-methods/eth_getbalance.mdx +++ b/services/reference/base/json-rpc-methods/eth_getbalance.mdx @@ -2,43 +2,15 @@ title: Base eth_getBalance sidebar_label: eth_getBalance description: Returns the balance of a Base address. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getbalance-description.mdx" - -# `eth_getBalance` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getbalance-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getbalance-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getbalance-example.mdx" - - - -### Request - -import Request from "./_eth_getbalance-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getbalance-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getblockbyhash.mdx b/services/reference/base/json-rpc-methods/eth_getblockbyhash.mdx index 2bbc2153232..fa2becbd3f8 100644 --- a/services/reference/base/json-rpc-methods/eth_getblockbyhash.mdx +++ b/services/reference/base/json-rpc-methods/eth_getblockbyhash.mdx @@ -2,43 +2,15 @@ title: Base eth_getBlockByHash sidebar_label: eth_getBlockByHash description: Returns Base block information by hash. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getblockbyhash-description.mdx" - -# `eth_getBlockByHash` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getblockbyhash-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getblockbyhash-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getblockbyhash-example.mdx" - - - -### Request - -import Request from "./_eth_getblockbyhash-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getblockbyhash-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getblockbynumber.mdx b/services/reference/base/json-rpc-methods/eth_getblockbynumber.mdx index 871dd1fd830..0407fdad20d 100644 --- a/services/reference/base/json-rpc-methods/eth_getblockbynumber.mdx +++ b/services/reference/base/json-rpc-methods/eth_getblockbynumber.mdx @@ -2,43 +2,15 @@ title: Base eth_getBlockByNumber sidebar_label: eth_getBlockByNumber description: Returns Base block information by number. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getblockbynumber-description.mdx" - -# `eth_getBlockByNumber` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getblockbynumber-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getblockbynumber-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getblockbynumber-example.mdx" - - - -### Request - -import Request from "./_eth_getblockbynumber-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getblockbynumber-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getblocktransactioncountbyhash.mdx b/services/reference/base/json-rpc-methods/eth_getblocktransactioncountbyhash.mdx index 32daebfffac..64e1ed2e771 100644 --- a/services/reference/base/json-rpc-methods/eth_getblocktransactioncountbyhash.mdx +++ b/services/reference/base/json-rpc-methods/eth_getblocktransactioncountbyhash.mdx @@ -2,43 +2,15 @@ title: Base eth_getBlockTransactionCountByHash sidebar_label: eth_getBlockTransactionCountByHash description: Returns transaction count by block hash on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-description.mdx" - -# `eth_getBlockTransactionCountByHash` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-example.mdx" - - - -### Request - -import Request from "./_eth_getblocktransactioncountbyhash-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getblocktransactioncountbynumber.mdx b/services/reference/base/json-rpc-methods/eth_getblocktransactioncountbynumber.mdx index 30ce70e262a..530a4eaf375 100644 --- a/services/reference/base/json-rpc-methods/eth_getblocktransactioncountbynumber.mdx +++ b/services/reference/base/json-rpc-methods/eth_getblocktransactioncountbynumber.mdx @@ -2,43 +2,15 @@ title: Base eth_getBlockTransactionCountByNumber sidebar_label: eth_getBlockTransactionCountByNumber description: Returns transaction count by block number on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-description.mdx" - -# `eth_getBlockTransactionCountByNumber` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-example.mdx" - - - -### Request - -import Request from "./_eth_getblocktransactioncountbynumber-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getcode.mdx b/services/reference/base/json-rpc-methods/eth_getcode.mdx index cf436fae1e6..262350575ec 100644 --- a/services/reference/base/json-rpc-methods/eth_getcode.mdx +++ b/services/reference/base/json-rpc-methods/eth_getcode.mdx @@ -2,43 +2,15 @@ title: Base eth_getCode sidebar_label: eth_getCode description: Returns byte code of a smart contract on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getcode-description.mdx" - -# `eth_getCode` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getcode-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getcode-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getcode-example.mdx" - - - -### Request - -import Request from "./_eth_getcode-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getcode-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getlogs.mdx b/services/reference/base/json-rpc-methods/eth_getlogs.mdx index e8a61e74e76..520cc11dfcf 100644 --- a/services/reference/base/json-rpc-methods/eth_getlogs.mdx +++ b/services/reference/base/json-rpc-methods/eth_getlogs.mdx @@ -2,43 +2,15 @@ title: Base eth_getLogs sidebar_label: eth_getLogs description: Returns filtered logs on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getlogs-description.mdx" - -# `eth_getLogs` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getlogs-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getlogs-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getlogs-example.mdx" - - - -### Request - -import Request from "./_eth_getlogs-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getlogs-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getproof.mdx b/services/reference/base/json-rpc-methods/eth_getproof.mdx index 359b2713ccc..3a9e82da2be 100644 --- a/services/reference/base/json-rpc-methods/eth_getproof.mdx +++ b/services/reference/base/json-rpc-methods/eth_getproof.mdx @@ -2,43 +2,15 @@ title: Base eth_getProof sidebar_label: eth_getProof description: Returns account and storage proofs on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getproof-description.mdx" - -# `eth_getProof` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getproof-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getproof-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getproof-example.mdx" - - - -### Request - -import Request from "./_eth_getproof-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getproof-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getstorageat.mdx b/services/reference/base/json-rpc-methods/eth_getstorageat.mdx index 07b1704caac..3da490de018 100644 --- a/services/reference/base/json-rpc-methods/eth_getstorageat.mdx +++ b/services/reference/base/json-rpc-methods/eth_getstorageat.mdx @@ -2,43 +2,15 @@ title: Base eth_getStorageAt sidebar_label: eth_getStorageAt description: Gets storage value for an address on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getstorageat-description.mdx" - -# `eth_getStorageAt` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getstorageat-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getstorageat-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getstorageat-example.mdx" - - - -### Request - -import Request from "./_eth_getstorageat-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getstorageat-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_gettransactionbyblockhashandindex.mdx b/services/reference/base/json-rpc-methods/eth_gettransactionbyblockhashandindex.mdx index d8a3510728f..b75af7d9114 100644 --- a/services/reference/base/json-rpc-methods/eth_gettransactionbyblockhashandindex.mdx +++ b/services/reference/base/json-rpc-methods/eth_gettransactionbyblockhashandindex.mdx @@ -2,43 +2,15 @@ title: Base eth_getTransactionByBlockHashAndIndex sidebar_label: eth_getTransactionByBlockHashAndIndex description: Gets a transaction by block hash on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-description.mdx" - -# `eth_getTransactionByBlockHashAndIndex` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-example.mdx" - - - -### Request - -import Request from "./_eth_gettransactionbyblockhashandindex-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_gettransactionbyblocknumberandindex.mdx b/services/reference/base/json-rpc-methods/eth_gettransactionbyblocknumberandindex.mdx index 7c7c8743452..e06f591c543 100644 --- a/services/reference/base/json-rpc-methods/eth_gettransactionbyblocknumberandindex.mdx +++ b/services/reference/base/json-rpc-methods/eth_gettransactionbyblocknumberandindex.mdx @@ -2,43 +2,15 @@ title: Base eth_getTransactionByBlockNumberAndIndex sidebar_label: eth_getTransactionByBlockNumberAndIndex description: Gets a transaction by block number on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-description.mdx" - -# `eth_getTransactionByBlockNumberAndIndex` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-example.mdx" - - - -### Request - -import Request from "./_eth_gettransactionbyblocknumberandindex-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_gettransactionbyhash.mdx b/services/reference/base/json-rpc-methods/eth_gettransactionbyhash.mdx index 5b225ad699a..aa819b7f5f8 100644 --- a/services/reference/base/json-rpc-methods/eth_gettransactionbyhash.mdx +++ b/services/reference/base/json-rpc-methods/eth_gettransactionbyhash.mdx @@ -2,43 +2,15 @@ title: Base eth_getTransactionByHash sidebar_label: eth_getTransactionByHash description: Gets a transaction by hash on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactionbyhash-description.mdx" - -# `eth_getTransactionByHash` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactionbyhash-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactionbyhash-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactionbyhash-example.mdx" - - - -### Request - -import Request from "./_eth_gettransactionbyhash-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactionbyhash-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_gettransactioncount.mdx b/services/reference/base/json-rpc-methods/eth_gettransactioncount.mdx index 4eb38446adb..dffb474e130 100644 --- a/services/reference/base/json-rpc-methods/eth_gettransactioncount.mdx +++ b/services/reference/base/json-rpc-methods/eth_gettransactioncount.mdx @@ -2,43 +2,15 @@ title: Base eth_getTransactionCount sidebar_label: eth_getTransactionCount description: Gets transaction count for an address on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactioncount-description.mdx" - -# `eth_getTransactionCount` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactioncount-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactioncount-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactioncount-example.mdx" - - - -### Request - -import Request from "./_eth_gettransactioncount-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactioncount-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_gettransactionreceipt.mdx b/services/reference/base/json-rpc-methods/eth_gettransactionreceipt.mdx index 8dc4efa3570..2f9404fbbe3 100644 --- a/services/reference/base/json-rpc-methods/eth_gettransactionreceipt.mdx +++ b/services/reference/base/json-rpc-methods/eth_gettransactionreceipt.mdx @@ -2,43 +2,15 @@ title: Base eth_getTransactionReceipt sidebar_label: eth_getTransactionReceipt description: Gets transaction receipt by transaction hash on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactionreceipt-description.mdx" - -# `eth_getTransactionReceipt` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactionreceipt-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactionreceipt-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactionreceipt-example.mdx" - - - -### Request - -import Request from "./_eth_gettransactionreceipt-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactionreceipt-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getunclebyblockhashandindex.mdx b/services/reference/base/json-rpc-methods/eth_getunclebyblockhashandindex.mdx index 5d288bc04be..ad4d2b78c63 100644 --- a/services/reference/base/json-rpc-methods/eth_getunclebyblockhashandindex.mdx +++ b/services/reference/base/json-rpc-methods/eth_getunclebyblockhashandindex.mdx @@ -2,43 +2,15 @@ title: Base eth_getUncleByBlockHashAndIndex sidebar_label: eth_getUncleByBlockHashAndIndex description: Gets uncle by block hash on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getunclebyblockhashandindex-description.mdx" - -# `eth_getUncleByBlockHashAndIndex` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getunclebyblockhashandindex-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getunclebyblockhashandindex-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getunclebyblockhashandindex-example.mdx" - - - -### Request - -import Request from "./_eth_getunclebyblockhashandindex-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getunclebyblockhashandindex-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getunclebyblocknumberandindex.mdx b/services/reference/base/json-rpc-methods/eth_getunclebyblocknumberandindex.mdx index d135ebd8eeb..d2b7d5ebefa 100644 --- a/services/reference/base/json-rpc-methods/eth_getunclebyblocknumberandindex.mdx +++ b/services/reference/base/json-rpc-methods/eth_getunclebyblocknumberandindex.mdx @@ -2,43 +2,15 @@ title: Base eth_getUncleByBlockNumberAndIndex sidebar_label: eth_getUncleByBlockNumberAndIndex description: Gets uncle by block number on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-description.mdx" - -# `eth_getUncleByBlockNumberAndIndex` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-example.mdx" - - - -### Request - -import Request from "./_eth_getunclebyblocknumberandindex-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getunclecountbyblockhash.mdx b/services/reference/base/json-rpc-methods/eth_getunclecountbyblockhash.mdx index c94cb817361..1a350047a48 100644 --- a/services/reference/base/json-rpc-methods/eth_getunclecountbyblockhash.mdx +++ b/services/reference/base/json-rpc-methods/eth_getunclecountbyblockhash.mdx @@ -2,43 +2,15 @@ title: Base eth_getUncleCountByBlockHash sidebar_label: eth_getUncleCountByBlockHash description: Gets uncle count by block hash on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getunclecountbyblockhash-description.mdx" - -# `eth_getUncleCountByBlockHash` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getunclecountbyblockhash-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getunclecountbyblockhash-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getunclecountbyblockhash-example.mdx" - - - -### Request - -import Request from "./_eth_getunclecountbyblockhash-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getunclecountbyblockhash-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_getunclecountbyblocknumber.mdx b/services/reference/base/json-rpc-methods/eth_getunclecountbyblocknumber.mdx index 6f07bfd075b..f97a01a53f6 100644 --- a/services/reference/base/json-rpc-methods/eth_getunclecountbyblocknumber.mdx +++ b/services/reference/base/json-rpc-methods/eth_getunclecountbyblocknumber.mdx @@ -2,43 +2,15 @@ title: Base eth_getUncleCountByBlockNumber sidebar_label: eth_getUncleCountByBlockNumber description: Gets uncle count by block number on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getunclecountbyblocknumber-description.mdx" - -# `eth_getUncleCountByBlockNumber` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getunclecountbyblocknumber-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getunclecountbyblocknumber-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getunclecountbyblocknumber-example.mdx" - - - -### Request - -import Request from "./_eth_getunclecountbyblocknumber-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getunclecountbyblocknumber-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_maxpriorityfeepergas.mdx b/services/reference/base/json-rpc-methods/eth_maxpriorityfeepergas.mdx index f68034f8a52..67ddfda02a3 100644 --- a/services/reference/base/json-rpc-methods/eth_maxpriorityfeepergas.mdx +++ b/services/reference/base/json-rpc-methods/eth_maxpriorityfeepergas.mdx @@ -2,43 +2,15 @@ title: Base eth_maxPriorityFeePerGas sidebar_label: eth_maxPriorityFeePerGas description: Estimates max priority fee on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_maxpriorityfeepergas-description.mdx" - -# `eth_maxPriorityFeePerGas` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_maxpriorityfeepergas-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_maxpriorityfeepergas-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_maxpriorityfeepergas-example.mdx" - - - -### Request - -import Request from "./_eth_maxpriorityfeepergas-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_maxpriorityfeepergas-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_protocolversion.mdx b/services/reference/base/json-rpc-methods/eth_protocolversion.mdx index 7b77aad83bd..761f4fcb101 100644 --- a/services/reference/base/json-rpc-methods/eth_protocolversion.mdx +++ b/services/reference/base/json-rpc-methods/eth_protocolversion.mdx @@ -2,43 +2,15 @@ title: Base eth_protocolVersion sidebar_label: eth_protocolVersion description: Returns protocol version on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_protocolversion-description.mdx" - -# `eth_protocolVersion` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_protocolversion-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_protocolversion-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_protocolversion-example.mdx" - - - -### Request - -import Request from "./_eth_protocolversion-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_protocolversion-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_sendrawtransaction.mdx b/services/reference/base/json-rpc-methods/eth_sendrawtransaction.mdx index 90514554c1b..9eaed60cc9c 100644 --- a/services/reference/base/json-rpc-methods/eth_sendrawtransaction.mdx +++ b/services/reference/base/json-rpc-methods/eth_sendrawtransaction.mdx @@ -2,43 +2,15 @@ title: Base eth_sendRawTransaction sidebar_label: eth_sendRawTransaction description: Submits pre-signed transaction on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_sendrawtransaction-description.mdx" - -# `eth_sendRawTransaction` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_sendrawtransaction-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_sendrawtransaction-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_sendrawtransaction-example.mdx" - - - -### Request - -import Request from "./_eth_sendrawtransaction-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_sendrawtransaction-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/eth_syncing.mdx b/services/reference/base/json-rpc-methods/eth_syncing.mdx index 15991c1e1a9..b1baf26f894 100644 --- a/services/reference/base/json-rpc-methods/eth_syncing.mdx +++ b/services/reference/base/json-rpc-methods/eth_syncing.mdx @@ -2,43 +2,15 @@ title: Base eth_syncing sidebar_label: eth_syncing description: Indicates whether client is syncing on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_syncing-description.mdx" - -# `eth_syncing` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_syncing-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_syncing-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_syncing-example.mdx" - - - -### Request - -import Request from "./_eth_syncing-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_syncing-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/filter-methods/eth_getfilterchanges.mdx b/services/reference/base/json-rpc-methods/filter-methods/eth_getfilterchanges.mdx index 5649815f944..a181ff67c24 100644 --- a/services/reference/base/json-rpc-methods/filter-methods/eth_getfilterchanges.mdx +++ b/services/reference/base/json-rpc-methods/filter-methods/eth_getfilterchanges.mdx @@ -2,43 +2,15 @@ title: Base eth_getFilterChanges sidebar_label: eth_getFilterChanges description: Returns Base logs since last poll. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-description.mdx" - -# `eth_getFilterChanges` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-example.mdx" - - - -### Request - -import Request from "./_eth_getfilterchanges-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/filter-methods/eth_getfilterlogs.mdx b/services/reference/base/json-rpc-methods/filter-methods/eth_getfilterlogs.mdx index 6b98e9ef0e2..352f3b70902 100644 --- a/services/reference/base/json-rpc-methods/filter-methods/eth_getfilterlogs.mdx +++ b/services/reference/base/json-rpc-methods/filter-methods/eth_getfilterlogs.mdx @@ -2,43 +2,15 @@ title: Base eth_getFilterLogs sidebar_label: eth_getFilterLogs description: Returns logs by filter ID on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-description.mdx" - -# `eth_getFilterLogs` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-example.mdx" - - - -### Request - -import Request from "./_eth_getfilterlogs-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/filter-methods/eth_newblockfilter.mdx b/services/reference/base/json-rpc-methods/filter-methods/eth_newblockfilter.mdx index cdc03cce97c..815f2dd0a86 100644 --- a/services/reference/base/json-rpc-methods/filter-methods/eth_newblockfilter.mdx +++ b/services/reference/base/json-rpc-methods/filter-methods/eth_newblockfilter.mdx @@ -2,43 +2,15 @@ title: Base eth_newBlockFilter sidebar_label: eth_newBlockFilter description: Creates filter to notify of new blocks on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_newblockfilter-description.mdx" - -# `eth_newBlockFilter` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_newblockfilter-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_newblockfilter-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_newblockfilter-example.mdx" - - - -### Request - -import Request from "./_eth_newblockfilter-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_newblockfilter-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/filter-methods/eth_newfilter.mdx b/services/reference/base/json-rpc-methods/filter-methods/eth_newfilter.mdx index fa5c3763e80..cf2b3350482 100644 --- a/services/reference/base/json-rpc-methods/filter-methods/eth_newfilter.mdx +++ b/services/reference/base/json-rpc-methods/filter-methods/eth_newfilter.mdx @@ -2,43 +2,15 @@ title: Base eth_newFilter sidebar_label: eth_newFilter description: Creates filter to notify of state changes on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_newfilter-description.mdx" - -# `eth_newFilter` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_newfilter-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_newfilter-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_newfilter-example.mdx" - - - -### Request - -import Request from "./_eth_newfilter-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_newfilter-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/filter-methods/eth_uninstallfilter.mdx b/services/reference/base/json-rpc-methods/filter-methods/eth_uninstallfilter.mdx index a41da5a09c9..746fad8d17a 100644 --- a/services/reference/base/json-rpc-methods/filter-methods/eth_uninstallfilter.mdx +++ b/services/reference/base/json-rpc-methods/filter-methods/eth_uninstallfilter.mdx @@ -2,43 +2,15 @@ title: Base eth_uninstallFilter sidebar_label: eth_uninstallFilter description: Uninstalls filter on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-description.mdx" - -# `eth_uninstallFilter` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-example.mdx" - - - -### Request - -import Request from "./_eth_uninstallfilter-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/net_peercount.mdx b/services/reference/base/json-rpc-methods/net_peercount.mdx index aa3ae939781..3b71750a6d7 100644 --- a/services/reference/base/json-rpc-methods/net_peercount.mdx +++ b/services/reference/base/json-rpc-methods/net_peercount.mdx @@ -2,43 +2,15 @@ title: Base net_peerCount sidebar_label: net_peerCount description: Returns peer count on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_net_peercount-description.mdx" - -# `net_peerCount` - - - -## Parameters - -import Params from "/services/reference/_partials/_net_peercount-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_net_peercount-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_net_peercount-example.mdx" - - - -### Request - -import Request from "./_net_peercount-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_net_peercount-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/net_version.mdx b/services/reference/base/json-rpc-methods/net_version.mdx index acd66c9b403..7ec8f713607 100644 --- a/services/reference/base/json-rpc-methods/net_version.mdx +++ b/services/reference/base/json-rpc-methods/net_version.mdx @@ -2,43 +2,15 @@ title: Base net_version sidebar_label: net_version description: Returns network ID on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_net_version-description.mdx" - -# `net_version` - - - -## Parameters - -import Params from "/services/reference/_partials/_net_version-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_net_version-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_net_version-example.mdx" - - - -### Request - -import Request from "./_net_version-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_net_version-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/subscription-methods/eth_subscribe.mdx b/services/reference/base/json-rpc-methods/subscription-methods/eth_subscribe.mdx index 203741924f7..0917be7db6d 100644 --- a/services/reference/base/json-rpc-methods/subscription-methods/eth_subscribe.mdx +++ b/services/reference/base/json-rpc-methods/subscription-methods/eth_subscribe.mdx @@ -2,43 +2,15 @@ title: Base eth_subscribe sidebar_label: eth_subscribe description: Creates new subscription on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/subscription-methods/_eth_subscribe-description.mdx" - -# `eth_subscribe` - - - -## Parameters - -import Params from "/services/reference/_partials/subscription-methods/_eth_subscribe-parameters-no-pending.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/subscription-methods/_eth_subscribe-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/subscription-methods/_eth_subscribe-example.mdx" - - - -### Request - -import Request from "./_eth_subscribe-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/subscription-methods/_eth_subscribe-response-no-pending.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/subscription-methods/eth_unsubscribe.mdx b/services/reference/base/json-rpc-methods/subscription-methods/eth_unsubscribe.mdx index eda5c4a840b..2a64f0bf712 100644 --- a/services/reference/base/json-rpc-methods/subscription-methods/eth_unsubscribe.mdx +++ b/services/reference/base/json-rpc-methods/subscription-methods/eth_unsubscribe.mdx @@ -2,43 +2,15 @@ title: Base eth_unsubscribe sidebar_label: eth_unsubscribe description: Cancels subscription on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-description.mdx" - -# `eth_unsubscribe` - - - -## Parameters - -import Params from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-example.mdx" - - - -### Request - -import Request from "./_eth_unsubscribe-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-response.mdx" - - + diff --git a/services/reference/base/json-rpc-methods/web3_clientversion.mdx b/services/reference/base/json-rpc-methods/web3_clientversion.mdx index c7059dac73d..3c94dabe12a 100644 --- a/services/reference/base/json-rpc-methods/web3_clientversion.mdx +++ b/services/reference/base/json-rpc-methods/web3_clientversion.mdx @@ -2,43 +2,15 @@ title: Base web3_clientVersion sidebar_label: web3_clientVersion description: Returns client version on Base. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_web3_clientversion-description.mdx" - -# `web3_clientVersion` - - - -## Parameters - -import Params from "/services/reference/_partials/_web3_clientversion-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_web3_clientversion-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_web3_clientversion-example.mdx" - - - -### Request - -import Request from "./_web3_clientversion-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_web3_clientversion-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/bundler/eth_estimateuseroperationgas.mdx b/services/reference/ethereum/json-rpc-methods/bundler/eth_estimateuseroperationgas.mdx index 0af2180c553..723f3670a28 100644 --- a/services/reference/ethereum/json-rpc-methods/bundler/eth_estimateuseroperationgas.mdx +++ b/services/reference/ethereum/json-rpc-methods/bundler/eth_estimateuseroperationgas.mdx @@ -2,43 +2,15 @@ title: eth_estimateUserOperationGas sidebar_label: eth_estimateUserOperationGas description: Simulate and estimate gas limits for a user operation before submission. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/bundler/_eth_estimateuseroperationgas-description.mdx" - -# `eth_estimateUserOperationGas` - - - -## Parameters - -import Params from "/services/reference/_partials/bundler/_eth_estimateuseroperationgas-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/bundler/_eth_estimateuseroperationgas-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/bundler/_eth_estimateuseroperationgas-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/bundler/_eth_estimateuseroperationgas-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/bundler/_eth_estimateuseroperationgas-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/bundler/eth_getuseroperationbyhash.mdx b/services/reference/ethereum/json-rpc-methods/bundler/eth_getuseroperationbyhash.mdx index adce4cbe6e3..0dd2e6b74dc 100644 --- a/services/reference/ethereum/json-rpc-methods/bundler/eth_getuseroperationbyhash.mdx +++ b/services/reference/ethereum/json-rpc-methods/bundler/eth_getuseroperationbyhash.mdx @@ -2,43 +2,15 @@ title: eth_getUserOperationByHash sidebar_label: eth_getUserOperationByHash description: Fetch user operation details by its hash. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/bundler/_eth_getuseroperationbyhash-description.mdx" - -# `eth_getUserOperationByHash` - - - -## Parameters - -import Params from "/services/reference/_partials/bundler/_eth_getuseroperationbyhash-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/bundler/_eth_getuseroperationbyhash-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/bundler/_eth_getuseroperationbyhash-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/bundler/_eth_getuseroperationbyhash-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/bundler/_eth_getuseroperationbyhash-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/bundler/eth_getuseroperationreceipt.mdx b/services/reference/ethereum/json-rpc-methods/bundler/eth_getuseroperationreceipt.mdx index a9426e1d552..b14467810c8 100644 --- a/services/reference/ethereum/json-rpc-methods/bundler/eth_getuseroperationreceipt.mdx +++ b/services/reference/ethereum/json-rpc-methods/bundler/eth_getuseroperationreceipt.mdx @@ -2,43 +2,15 @@ title: eth_getUserOperationReceipt sidebar_label: eth_getUserOperationReceipt description: Fetch the receipt of a user operation by its hash. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/bundler/_eth_getuseroperationreceipt-description.mdx" - -# `eth_getUserOperationReceipt` - - - -## Parameters - -import Params from "/services/reference/_partials/bundler/_eth_getuseroperationreceipt-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/bundler/_eth_getuseroperationreceipt-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/bundler/_eth_getuseroperationreceipt-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/bundler/_eth_getuseroperationreceipt-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/bundler/_eth_getuseroperationreceipt-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/bundler/eth_senduseroperation.mdx b/services/reference/ethereum/json-rpc-methods/bundler/eth_senduseroperation.mdx index 7b2c4cdb4c1..56bf0c97ca9 100644 --- a/services/reference/ethereum/json-rpc-methods/bundler/eth_senduseroperation.mdx +++ b/services/reference/ethereum/json-rpc-methods/bundler/eth_senduseroperation.mdx @@ -2,43 +2,15 @@ title: eth_sendUserOperation sidebar_label: eth_sendUserOperation description: Submit a user operation to the mempool for bundling and execution. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/bundler/_eth_senduseroperation-description.mdx" - -# `eth_sendUserOperation` - - - -## Parameters - -import Params from "/services/reference/_partials/bundler/_eth_senduseroperation-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/bundler/_eth_senduseroperation-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/bundler/_eth_senduseroperation-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/bundler/_eth_senduseroperation-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/bundler/_eth_senduseroperation-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/bundler/eth_supportedentrypoints.mdx b/services/reference/ethereum/json-rpc-methods/bundler/eth_supportedentrypoints.mdx index fc88a6fc9e3..c1dd3670dbe 100644 --- a/services/reference/ethereum/json-rpc-methods/bundler/eth_supportedentrypoints.mdx +++ b/services/reference/ethereum/json-rpc-methods/bundler/eth_supportedentrypoints.mdx @@ -2,43 +2,15 @@ title: eth_supportedEntryPoints sidebar_label: eth_supportedEntryPoints description: Get the list of EntryPoint addresses supported by the bundler. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/bundler/_eth_supportedentrypoints-description.mdx" - -# `eth_supportedEntryPoints` - - - -## Parameters - -import Params from "/services/reference/_partials/bundler/_eth_supportedentrypoints-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/bundler/_eth_supportedentrypoints-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/bundler/_eth_supportedentrypoints-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/bundler/_eth_supportedentrypoints-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/bundler/_eth_supportedentrypoints-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/bundler/pimlico_getuseroperationgasprice.mdx b/services/reference/ethereum/json-rpc-methods/bundler/pimlico_getuseroperationgasprice.mdx index 70897d7e524..38ace55ce80 100644 --- a/services/reference/ethereum/json-rpc-methods/bundler/pimlico_getuseroperationgasprice.mdx +++ b/services/reference/ethereum/json-rpc-methods/bundler/pimlico_getuseroperationgasprice.mdx @@ -2,43 +2,15 @@ title: pimlico_getUserOperationGasPrice sidebar_label: pimlico_getUserOperationGasPrice description: Get recommended gas prices for user operations on Pimlico bundlers. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/bundler/_pimlico_getuseroperationgasprice-description.mdx" - -# `pimlico_getUserOperationGasPrice` - - - -## Parameters - -import Params from "/services/reference/_partials/bundler/_pimlico_getuseroperationgasprice-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/bundler/_pimlico_getuseroperationgasprice-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/bundler/_pimlico_getuseroperationgasprice-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/bundler/_pimlico_getuseroperationgasprice-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/bundler/_pimlico_getuseroperationgasprice-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/bundler/pimlico_getuseroperationstatus.mdx b/services/reference/ethereum/json-rpc-methods/bundler/pimlico_getuseroperationstatus.mdx index 24c4e50da7e..1eaed571558 100644 --- a/services/reference/ethereum/json-rpc-methods/bundler/pimlico_getuseroperationstatus.mdx +++ b/services/reference/ethereum/json-rpc-methods/bundler/pimlico_getuseroperationstatus.mdx @@ -2,43 +2,15 @@ title: pimlico_getUserOperationStatus sidebar_label: pimlico_getUserOperationStatus description: Get the current status of a user operation by its hash. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/bundler/_pimlico_getuseroperationstatus-description.mdx" - -# `pimlico_getUserOperationStatus` - - - -## Parameters - -import Params from "/services/reference/_partials/bundler/_pimlico_getuseroperationstatus-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/bundler/_pimlico_getuseroperationstatus-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/bundler/_pimlico_getuseroperationstatus-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/bundler/_pimlico_getuseroperationstatus-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/bundler/_pimlico_getuseroperationstatus-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/bundler/pimlico_simulateassetchanges.mdx b/services/reference/ethereum/json-rpc-methods/bundler/pimlico_simulateassetchanges.mdx index 019d0050b4c..f1a75e14e76 100644 --- a/services/reference/ethereum/json-rpc-methods/bundler/pimlico_simulateassetchanges.mdx +++ b/services/reference/ethereum/json-rpc-methods/bundler/pimlico_simulateassetchanges.mdx @@ -2,49 +2,15 @@ title: pimlico_simulateAssetChanges sidebar_label: pimlico_simulateAssetChanges description: Simulate a user operation and return predicted asset changes. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/bundler/_pimlico_simulateassetchanges-description.mdx" - -# `pimlico_simulateAssetChanges` - - - -## Parameters - -import Params from "/services/reference/_partials/bundler/_pimlico_simulateassetchanges-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/bundler/_pimlico_simulateassetchanges-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/bundler/_pimlico_simulateassetchanges-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/bundler/_pimlico_simulateassetchanges-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/bundler/_pimlico_simulateassetchanges-response.mdx" - - - -## Errors - -import Errors from "/services/reference/_partials/bundler/_pimlico_simulateassetchanges-errors.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_accounts.mdx b/services/reference/ethereum/json-rpc-methods/eth_accounts.mdx index fad008f70b3..9c1fae83c2a 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_accounts.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_accounts.mdx @@ -2,40 +2,15 @@ title: Ethereum eth_accounts sidebar_label: eth_accounts description: Returns a list of Ethereum accounts. +hide_title: true +hide_table_of_contents: true --- -import Description from "/services/reference/_partials/_eth_accounts-description.mdx" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -# `eth_accounts` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_accounts-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_accounts-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_accounts-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_accounts-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_accounts-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_blobbasefee.mdx b/services/reference/ethereum/json-rpc-methods/eth_blobbasefee.mdx index 0d76138f97f..adf20ac533d 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_blobbasefee.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_blobbasefee.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_blobBaseFee sidebar_label: eth_blobBaseFee description: Returns the expected blob base fee for the next Ethereum block. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_blobbasefee-description.mdx" - -# `eth_blobBaseFee` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_blobbasefee-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_blobbasefee-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_blobbasefee-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_blobbasefee-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_blobbasefee-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_blocknumber.mdx b/services/reference/ethereum/json-rpc-methods/eth_blocknumber.mdx index 3d904a5a277..e8c3b32ab9d 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_blocknumber.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_blocknumber.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_blockNumber sidebar_label: eth_blockNumber description: Returns the latest Ethereum block number. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_blocknumber-description.mdx" - -# `eth_blockNumber` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_blocknumber-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_blocknumber-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_blocknumber-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_blocknumber-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_blocknumber-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_call.mdx b/services/reference/ethereum/json-rpc-methods/eth_call.mdx index 86c9eb8cf50..8bdfb175a18 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_call.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_call.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_call sidebar_label: eth_call description: Executes a Ethereum call without creating a transaction. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_call-description.mdx" - -# `eth_call` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_call-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_call-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_call-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_call-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_call-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_chainid.mdx b/services/reference/ethereum/json-rpc-methods/eth_chainid.mdx index 4f288166966..4d8e9e564e3 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_chainid.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_chainid.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_chainId sidebar_label: eth_chainId description: Returns the Ethereum chain ID. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_chainid-description.mdx" - -# `eth_chainId` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_chainid-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_chainid-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_chainid-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_chainid-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_chainid-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_createaccesslist.mdx b/services/reference/ethereum/json-rpc-methods/eth_createaccesslist.mdx index bb79d2cab5c..185618616b3 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_createaccesslist.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_createaccesslist.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_createAccessList sidebar_label: eth_createAccessList description: Creates an access list to include in a Ethereum transaction. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_createaccesslist-description.mdx" - -# `eth_createAccessList` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_createaccesslist-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_createaccesslist-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_createaccesslist-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_createaccesslist-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_createaccesslist-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_estimategas.mdx b/services/reference/ethereum/json-rpc-methods/eth_estimategas.mdx index eb28cacefb9..ec037c6a148 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_estimategas.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_estimategas.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_estimateGas sidebar_label: eth_estimateGas description: Estimates gas required for a Ethereum transaction. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_estimategas-description.mdx" - -# `eth_estimateGas` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_estimategas-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_estimategas-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_estimategas-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_estimategas-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_estimategas-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_feehistory.mdx b/services/reference/ethereum/json-rpc-methods/eth_feehistory.mdx index 22fc25cfd69..2c68437c373 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_feehistory.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_feehistory.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_feeHistory sidebar_label: eth_feeHistory description: Returns historical Ethereum gas information. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_feehistory-description.mdx" - -# `eth_feeHistory` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_feehistory-parameters.mdx" - - - -## Returns - -import Returns from "./_eth_feehistory-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_feehistory-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_feehistory-request.mdx" - - - -### Response - -import Response from "./_eth_feehistory-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_gasprice.mdx b/services/reference/ethereum/json-rpc-methods/eth_gasprice.mdx index db5fe435ea5..741e4ced03b 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_gasprice.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_gasprice.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_gasPrice sidebar_label: eth_gasPrice description: Returns the current Ethereum gas price. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gasprice-description.mdx" - -# `eth_gasPrice` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gasprice-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gasprice-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gasprice-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_gasprice-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gasprice-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getbalance.mdx b/services/reference/ethereum/json-rpc-methods/eth_getbalance.mdx index 8fc408e87b1..65f1dee7c80 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getbalance.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getbalance.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getBalance sidebar_label: eth_getBalance description: Returns the balance of a Ethereum address. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getbalance-description.mdx" - -# `eth_getBalance` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getbalance-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getbalance-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getbalance-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getbalance-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getbalance-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getblockbyhash.mdx b/services/reference/ethereum/json-rpc-methods/eth_getblockbyhash.mdx index 637861ecaf7..a0fc362dd65 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getblockbyhash.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getblockbyhash.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getBlockByHash sidebar_label: eth_getBlockByHash description: Returns Ethereum block information by hash. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getblockbyhash-description.mdx" - -# `eth_getBlockByHash` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getblockbyhash-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getblockbyhash-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getblockbyhash-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getblockbyhash-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getblockbyhash-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getblockbynumber.mdx b/services/reference/ethereum/json-rpc-methods/eth_getblockbynumber.mdx index 4680855e8d7..7dccd4860c7 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getblockbynumber.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getblockbynumber.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getBlockByNumber sidebar_label: eth_getBlockByNumber description: Returns Ethereum block information by number. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getblockbynumber-description.mdx" - -# `eth_getBlockByNumber` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getblockbynumber-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getblockbynumber-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getblockbynumber-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getblockbynumber-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getblockbynumber-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getblockreceipts.mdx b/services/reference/ethereum/json-rpc-methods/eth_getblockreceipts.mdx index 8ebe0177067..5f20bcb667d 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getblockreceipts.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getblockreceipts.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getBlockReceipts sidebar_label: eth_getBlockReceipts description: Returns receipts for a block on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs"; -import TabItem from "@theme/TabItem"; +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getblockreceipts-description.mdx"; - -# `eth_getBlockReceipts` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getblockreceipts-parameters.mdx"; - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getblockreceipts-returns.mdx"; - - - -## Example - -import Example from "/services/reference/_partials/_eth_getblockreceipts-example.mdx"; - - - -### Request - -import Request from "/services/reference/_partials/_eth_getblockreceipts-request.mdx"; - - - -### Response - -import Response from "/services/reference/_partials/_eth_getblockreceipts-response.mdx"; - - \ No newline at end of file + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getblocktransactioncountbyhash.mdx b/services/reference/ethereum/json-rpc-methods/eth_getblocktransactioncountbyhash.mdx index c931db587dc..2036acf5421 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getblocktransactioncountbyhash.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getblocktransactioncountbyhash.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getBlockTransactionCountByHash sidebar_label: eth_getBlockTransactionCountByHash description: Returns transaction count by block hash on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-description.mdx" - -# `eth_getBlockTransactionCountByHash` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getblocktransactioncountbyhash-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getblocktransactioncountbynumber.mdx b/services/reference/ethereum/json-rpc-methods/eth_getblocktransactioncountbynumber.mdx index 0b86aefae46..58c0ee0c7ad 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getblocktransactioncountbynumber.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getblocktransactioncountbynumber.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getBlockTransactionCountByNumber sidebar_label: eth_getBlockTransactionCountByNumber description: Returns transaction count by block number on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-description.mdx" - -# `eth_getBlockTransactionCountByNumber` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getblocktransactioncountbynumber-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getcode.mdx b/services/reference/ethereum/json-rpc-methods/eth_getcode.mdx index c831aa303c4..ab8036a6303 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getcode.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getcode.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getCode sidebar_label: eth_getCode description: Returns byte code of a smart contract on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getcode-description.mdx" - -# `eth_getCode` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getcode-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getcode-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getcode-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getcode-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getcode-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getlogs.mdx b/services/reference/ethereum/json-rpc-methods/eth_getlogs.mdx index 0f8e8b4cecf..488adbdf2e7 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getlogs.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getlogs.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getLogs sidebar_label: eth_getLogs description: Returns filtered logs on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getlogs-description.mdx" - -# `eth_getLogs` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getlogs-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getlogs-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getlogs-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getlogs-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getlogs-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getproof.mdx b/services/reference/ethereum/json-rpc-methods/eth_getproof.mdx index e616d8d128f..bac19e06736 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getproof.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getproof.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getProof sidebar_label: eth_getProof description: Returns account and storage proofs on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getproof-description.mdx" - -# `eth_getProof` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getproof-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getproof-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getproof-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getproof-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getproof-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getstorageat.mdx b/services/reference/ethereum/json-rpc-methods/eth_getstorageat.mdx index a9d771fd2f7..7448d8a71af 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getstorageat.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getstorageat.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getStorageAt sidebar_label: eth_getStorageAt description: Gets storage value for an address on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getstorageat-description.mdx" - -# `eth_getStorageAt` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getstorageat-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getstorageat-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getstorageat-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getstorageat-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getstorageat-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyblockhashandindex.mdx b/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyblockhashandindex.mdx index ce8fc4b2c70..c93a03477de 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyblockhashandindex.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyblockhashandindex.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getTransactionByBlockHashAndIndex sidebar_label: eth_getTransactionByBlockHashAndIndex description: Gets a transaction by block hash on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-description.mdx" - -# `eth_getTransactionByBlockHashAndIndex` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-returns-yparity.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactionbyblockhashandindex-response-yparity.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyblocknumberandindex.mdx b/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyblocknumberandindex.mdx index 86bddfc90c3..8865b4aaec7 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyblocknumberandindex.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyblocknumberandindex.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getTransactionByBlockNumberAndIndex sidebar_label: eth_getTransactionByBlockNumberAndIndex description: Gets a transaction by block number on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-description.mdx" - -# `eth_getTransactionByBlockNumberAndIndex` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-returns-yparity.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactionbyblocknumberandindex-response-yparity.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyhash.mdx b/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyhash.mdx index a5b0f28c266..5eb1c7abac1 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyhash.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_gettransactionbyhash.mdx @@ -2,49 +2,15 @@ title: Ethereum eth_getTransactionByHash sidebar_label: eth_getTransactionByHash description: Gets a transaction by hash on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactionbyhash-description.mdx" - -# `eth_getTransactionByHash` - - - -:::tip MEV protection -Maximal Extractable Value (MEV) protection is available for all Infura customers on Mainnet. -This means `r`, `s`, and `v` signature fields might return empty hex values (`0x0`) -while the transaction is pending on Mainnet. -::: - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactionbyhash-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactionbyhash-returns-yparity.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactionbyhash-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_gettransactionbyhash-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactionbyhash-response-yparity.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_gettransactioncount.mdx b/services/reference/ethereum/json-rpc-methods/eth_gettransactioncount.mdx index bf672c933b9..0cffed61eb6 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_gettransactioncount.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_gettransactioncount.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getTransactionCount sidebar_label: eth_getTransactionCount description: Gets transaction count for an address on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactioncount-description.mdx" - -# `eth_getTransactionCount` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactioncount-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactioncount-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactioncount-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_gettransactioncount-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactioncount-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_gettransactionreceipt.mdx b/services/reference/ethereum/json-rpc-methods/eth_gettransactionreceipt.mdx index 6a617976669..f82a4860510 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_gettransactionreceipt.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_gettransactionreceipt.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getTransactionReceipt sidebar_label: eth_getTransactionReceipt description: Gets transaction receipt by transaction hash on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_gettransactionreceipt-description.mdx" - -# `eth_getTransactionReceipt` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_gettransactionreceipt-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_gettransactionreceipt-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_gettransactionreceipt-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_gettransactionreceipt-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_gettransactionreceipt-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getunclebyblockhashandindex.mdx b/services/reference/ethereum/json-rpc-methods/eth_getunclebyblockhashandindex.mdx index 6e8ccf5e03b..7593e583459 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getunclebyblockhashandindex.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getunclebyblockhashandindex.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getUncleByBlockHashAndIndex sidebar_label: eth_getUncleByBlockHashAndIndex description: Gets uncle by block hash on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getunclebyblockhashandindex-description.mdx" - -# `eth_getUncleByBlockHashAndIndex` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getunclebyblockhashandindex-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getunclebyblockhashandindex-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getunclebyblockhashandindex-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getunclebyblockhashandindex-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getunclebyblockhashandindex-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getunclebyblocknumberandindex.mdx b/services/reference/ethereum/json-rpc-methods/eth_getunclebyblocknumberandindex.mdx index e3116cd1d47..9a8703ff0df 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getunclebyblocknumberandindex.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getunclebyblocknumberandindex.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getUncleByBlockNumberAndIndex sidebar_label: eth_getUncleByBlockNumberAndIndex description: Gets uncle by block number on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-description.mdx" - -# `eth_getUncleByBlockNumberAndIndex` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getunclebyblocknumberandindex-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getunclecountbyblockhash.mdx b/services/reference/ethereum/json-rpc-methods/eth_getunclecountbyblockhash.mdx index 79278b08e5b..5ece849e4f9 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getunclecountbyblockhash.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getunclecountbyblockhash.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getUncleCountByBlockHash sidebar_label: eth_getUncleCountByBlockHash description: Gets uncle count by block hash on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getunclecountbyblockhash-description.mdx" - -# `eth_getUncleCountByBlockHash` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getunclecountbyblockhash-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getunclecountbyblockhash-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getunclecountbyblockhash-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getunclecountbyblockhash-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getunclecountbyblockhash-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getunclecountbyblocknumber.mdx b/services/reference/ethereum/json-rpc-methods/eth_getunclecountbyblocknumber.mdx index 619e79f6286..23bd4ca582f 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getunclecountbyblocknumber.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getunclecountbyblocknumber.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getUncleCountByBlockNumber sidebar_label: eth_getUncleCountByBlockNumber description: Gets uncle count by block number on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getunclecountbyblocknumber-description.mdx" - -# `eth_getUncleCountByBlockNumber` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getunclecountbyblocknumber-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getunclecountbyblocknumber-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getunclecountbyblocknumber-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getunclecountbyblocknumber-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getunclecountbyblocknumber-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_getwork.mdx b/services/reference/ethereum/json-rpc-methods/eth_getwork.mdx index 96a576cee04..0f84c37a4bf 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_getwork.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_getwork.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getWork sidebar_label: eth_getWork description: Return current block and seed hash on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_getwork-description.mdx" - -# `eth_getWork` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_getwork-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_getwork-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_getwork-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_getwork-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_getwork-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_hashrate.mdx b/services/reference/ethereum/json-rpc-methods/eth_hashrate.mdx index 64a609021bb..2ba50aab148 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_hashrate.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_hashrate.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_hashrate sidebar_label: eth_hashrate description: Return hashes per second on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_hashrate-description.mdx" - -# `eth_hashrate` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_hashrate-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_hashrate-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_hashrate-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_hashrate-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_hashrate-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_maxpriorityfeepergas.mdx b/services/reference/ethereum/json-rpc-methods/eth_maxpriorityfeepergas.mdx index 6de76e4a4a3..748897f5cc8 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_maxpriorityfeepergas.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_maxpriorityfeepergas.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_maxPriorityFeePerGas sidebar_label: eth_maxPriorityFeePerGas description: Estimates max priority fee on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_maxpriorityfeepergas-description.mdx" - -# `eth_maxPriorityFeePerGas` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_maxpriorityfeepergas-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_maxpriorityfeepergas-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_maxpriorityfeepergas-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_maxpriorityfeepergas-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_maxpriorityfeepergas-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_mining.mdx b/services/reference/ethereum/json-rpc-methods/eth_mining.mdx index 0e73d011238..fd0b5a57765 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_mining.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_mining.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_mining sidebar_label: eth_mining description: Indicates whether client is mining on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_mining-description.mdx" - -# `eth_mining` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_mining-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_mining-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_mining-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_mining-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_mining-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_protocolversion.mdx b/services/reference/ethereum/json-rpc-methods/eth_protocolversion.mdx index cf62516047c..f10fe875105 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_protocolversion.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_protocolversion.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_protocolVersion sidebar_label: eth_protocolVersion description: Returns protocol version on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_protocolversion-description.mdx" - -# `eth_protocolVersion` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_protocolversion-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_protocolversion-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_protocolversion-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_protocolversion-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_protocolversion-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_sendrawtransaction.mdx b/services/reference/ethereum/json-rpc-methods/eth_sendrawtransaction.mdx index 975f2120cad..b1fe1ea11f0 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_sendrawtransaction.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_sendrawtransaction.mdx @@ -2,49 +2,15 @@ title: Ethereum eth_sendRawTransaction sidebar_label: eth_sendRawTransaction description: Submits pre-signed transaction on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_sendrawtransaction-description.mdx" - -# `eth_sendRawTransaction` - - - -:::tip MEV protection -Maximal Extractable Value (MEV) protection is available for all Infura customers on Mainnet. -This means `r`, `s`, and `v` signature fields might return empty hex values (`0x0`) -while the transaction is pending on Mainnet. -::: - -## Parameters - -import Params from "/services/reference/_partials/_eth_sendrawtransaction-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_sendrawtransaction-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_sendrawtransaction-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_sendrawtransaction-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_sendrawtransaction-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_simulatev1.mdx b/services/reference/ethereum/json-rpc-methods/eth_simulatev1.mdx index 75a72282def..ab0941ca168 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_simulatev1.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_simulatev1.mdx @@ -2,264 +2,15 @@ title: Ethereum eth_simulateV1 sidebar_label: eth_simulateV1 description: Simulate transactions across multiple blocks on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -# `eth_simulateV1` - -Simulates transactions across multiple blocks. Allows you to test transactions with custom state and -block parameters without submitting them to the network. - -:::info important -This method is only supported on Mainnet and Sepolia. - -A maximum of 16 block state calls can be simulated in a single request. This is determined by -assessing the `blockStateCalls` array of objects. -::: - -## Parameters - -- `BLOCK STATE CALL OBJECT`: - - `blockStateCalls`: _\[required]_ Array of block, state, and call objects: - - `blockOverrides`: _\[optional]_ Object to override block parameters: - - `baseFeePerGas`: (string) Hexadecimal value for the base fee per gas for the block. - - `blobBaseFee`: (string) Hexadecimal value for the base fee per unit of blob gas. - - `feeRecipient`: (string) Address of the fee recipient for the block proposal. - - `gasLimit`: (string) Hexadecimal value that represents the maximum amount of gas that transactions - are allowed to consume. - - `number`: (string) Hexadecimal block number. - - `prevRandao`: (string) The previous value of randomness, which is - used as a source of randomness for various protocol operations. - - `time`: (string) Hexadecimal value representing the Unix epoch time in seconds. - - `stateOverrides`: _\[optional]_ Object to override account states: - - `balance`: (string) Hexadecimal value representing the account balance. - - `nonce`: (string) Hexadecimal temporary nonce value for the call execution. - - `code`: (string) Bytecode to inject into the account. - - `state`: Object of key-value mappings to override all slots in the account storage - before executing the call. - - `stateDiff`: Object of key-value mappings to override individual slots in the account - storage before executing the call. - - `movePrecompileToAddress`: (string) Moves the precompile to the supplied address. - - `calls`: _\[required]_ Array of transaction call objects: - - `from`: _\[optional]_ 20 bytes - The address the transaction is sent from. - - `to`: _\[optional]_ 20 bytes - The address the transaction is directed to. - - `gas`: _\[optional]_ Hexadecimal value of the gas provided for the transaction execution. - - `gasPrice`: _\[optional]_ Hexadecimal value of the gas price used for each paid gas. - - `maxPriorityFeePerGas`: _\[optional]_ Maximum fee, in wei, the sender is willing to pay per gas above the base fee. - - `maxFeePerGas`: _\[optional]_ Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. - - `value`: _\[optional]_ Hexadecimal value of the value sent with this transaction. - - `data`: _\[optional]_ Hash of the method signature and encoded parameters. See the - [Ethereum contract ABI specification](https://docs.soliditylang.org/en/latest/abi-spec.html). - - `returnFullTransactionObjects`: _\[optional]_ Boolean value which when `true`, returns full transaction - objects, otherwise, just hashes are returned. The default is `false`. - - `traceTransfers`: _\[optional]_ Boolean value which when `true`, adds ETH transfers as ERC20 transfer - events to the logs, allowing you to trace value transfers. The default is `false`. - - `validation`: _\[optional]_ Boolean value which when `true`, does all the validation that a - normal EVM would do, except contract sender and signature checks. When `false`, `eth_simulateV1` behaves like `eth_call`. - The default is `false`. - - `blockParameter`: (string) [_optional_] A hexadecimal block number, or one of the tags `latest`, `earliest`, `pending` or `finalized`. See the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block). - -## Returns - -An array of simulation result objects: - -- `baseFeePerGas`: Hexadecimal value for the base fee per gas for the block. -- `blobGasUsed`: Hexadecimal value for the amount of blob gas used. -- `calls`: Array of call results: - - `returnData`: Data returned for the call. - - `logs`: Array of logs generated during the call. - - `address`: Address of the contract that generated the log. - - `blockHash`: Hash of the block. - - `blockNumber`: Hexadecimal block number. - - `data`: Non-indexed log parameters. - - `logIndex`: Index of the log in the block. - - `removed`: Whether the log was removed due to chain reorganization. - - `topics`: Array of indexed log parameters. - - `transactionHash`: Hash of the transaction. - - `transactionIndex`: Index of the transaction in the block. - - `error`: Object containing error information: - - `message`: The error message. - - `code`: The error status code. - - `data`: Error-related information. - - `gasUsed`: Hexadecimal value representing the amount of gas used. - - `status`: Status indicating whether the transaction succeeded (`0x1`). `0x0` indicates that a transaction has failed. -- `difficulty`: A hexadecimal of the difficulty for this block. -- `excessBlobGas`: A hexadecimal of the excess blob gas. -- `extraData`: The "extra data" field of this block. -- `gasLimit`: Maximum gas allowed in this block. -- `gasUsed`: Total used gas by all transactions in this block. -- `hash`: Hash of the block. `Null` when the returned block is the pending block. -- `logsBloom`: The bloom filter for the logs of the block. `Null` when the returned block is the pending block. -- `miner`: Address of the beneficiary to whom the mining rewards were given. -- `mixHash`: Hexadecimal mix hash. -- `nonce`: Hash of the generated proof-of-work. `Null` when the returned block is the pending block. -- `number`: Block number. `Null` when the returned block is the pending block. -- `parentBeaconBlockRoot`: Parent beacon block root. -- `parentHash`: Hash of the parent block. -- `receiptsRoot`: The root of the receipts trie of the block. Also see [Tries in Ethereum](https://ethereum.org/en/developers/docs/data-structures-and-encoding/patricia-merkle-trie/#tries-in-ethereum). -- `sha3Uncles`: The SHA3 of the uncles data in the block. -- `size`: A hexadecimal of the size of this block in bytes. -- `stateRoot`: The root of the final state trie of the block. -- `timestamp`: The unix timestamp for when the block was collated. -- `totalDifficulty`: A hexadecimal of the total difficulty of the chain until this block. -- `transactions`: (Array) An array of transaction objects, or 32 bytes transaction hashes depending on the last given parameter. -- `transactionsRoot`: The root of the transaction trie of the block. -- `uncles`: (Array) An array of uncle hashes. -- `withdrawals`: (Array) Withdrawal objects. -- `withdrawalsRoot`: Withdrawals trie root. - -## Example - -Replace `` with an API key from your [MetaMask Developer dashboard](https://developer.metamask.io/). - -### Request - - - - - ```bash - curl https://mainnet.infura.io/v3/ \ - -X POST \ - -H "Content-Type: application/json" \ - -d '{ - "jsonrpc": "2.0", - "id": 1, - "method": "eth_simulateV1", - "params": [ - { - "blockStateCalls": [ - { - "blockOverrides": { - "baseFeePerGas": "0x9" - }, - "stateOverrides": { - "0xc000000000000000000000000000000000000000": { - "balance": "0x4a817c800" - } - }, - "calls": [ - { - "from": "0xc000000000000000000000000000000000000000", - "to": "0xc000000000000000000000000000000000000001", - "maxFeePerGas": "0xf", - "value": "0x1" - }, - { - "from": "0xc000000000000000000000000000000000000000", - "to": "0xc000000000000000000000000000000000000002", - "maxFeePerGas": "0xf", - "value": "0x1" - } - ] - } - ], - "validation": true, - "traceTransfers": true - }, - "latest" - ] - }' - ``` - - - - - ```bash - wscat -c wss://mainnet.infura.io/ws/v3/ -x '{"jsonrpc":"2.0","id":1,"method":"eth_simulateV1","params":[{"blockStateCalls":[{"blockOverrides":{"baseFeePerGas":"0x9"},"stateOverrides":{"0xc000000000000000000000000000000000000000":{"balance":"0x4a817c800"}},"calls":[{"from":"0xc000000000000000000000000000000000000000","to":"0xc000000000000000000000000000000000000001","maxFeePerGas":"0xf","value":"0x1"},{"from":"0xc000000000000000000000000000000000000000","to":"0xc000000000000000000000000000000000000002","maxFeePerGas":"0xf","value":"0x1"}]}],"validation":true,"traceTransfers":true},"latest"]}' - ``` - - - - -### Response - - - - -```JSON -{ - "jsonrpc": "2.0", - "id": 1, - "result": [ - { - "baseFeePerGas": "0x9", - "blobGasUsed": "0x0", - "calls": [ - { - "gasUsed": "0x5208", - "logs": [ - { - "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", - "blockHash": "0xc98388385b0dbfc15ad5c6a0f4b19f7abd94efb4618ced05e3eb320ee30b1e7f", - "blockNumber": "0x1496e50", - "data": "0x0000000000000000000000000000000000000000000000000000000000000001", - "logIndex": "0x0", - "removed": false, - "topics": [ - "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", - "0x000000000000000000000000c000000000000000000000000000000000000000", - "0x000000000000000000000000c000000000000000000000000000000000000001" - ], - "transactionHash": "0xe7217784e0c3f7b35d39303b1165046e9b7e8af9b9cf80d5d5f96c3163de8f51", - "transactionIndex": "0x0" - } - ], - "returnData": "0x", - "status": "0x1" - }, - { - "gasUsed": "0x5208", - "logs": [ - { - "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", - "blockHash": "0xc98388385b0dbfc15ad5c6a0f4b19f7abd94efb4618ced05e3eb320ee30b1e7f", - "blockNumber": "0x1496e50", - "data": "0x0000000000000000000000000000000000000000000000000000000000000001", - "logIndex": "0x1", - "removed": false, - "topics": [ - "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", - "0x000000000000000000000000c000000000000000000000000000000000000000", - "0x000000000000000000000000c000000000000000000000000000000000000002" - ], - "transactionHash": "0xf0182201606ec03701ba3a07d965fabdb4b7d06b424f226ea7ec3581802fc6fa", - "transactionIndex": "0x1" - } - ], - "returnData": "0x", - "status": "0x1" - } - ], - "difficulty": "0x0", - "excessBlobGas": "0x4920000", - "extraData": "0x", - "gasLimit": "0x1c9c380", - "gasUsed": "0xa410", - "hash": "0xc98388385b0dbfc15ad5c6a0f4b19f7abd94efb4618ced05e3eb320ee30b1e7f", - "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", - "miner": "0x7e2a2fa2a064f693f0a55c5639476d913ff12d05", - "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000", - "nonce": "0x0000000000000000", - "number": "0x1496e50", - "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000", - "parentHash": "0xddd47e7383c8ced495e85e053f898d7a333feb0432fa9098306f6f563cde4984", - "receiptsRoot": "0x75308898d571eafb5cd8cde8278bf5b3d13c5f6ec074926de3bb895b519264e1", - "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", - "size": "0x29c", - "stateRoot": "0xd6da11fae4ab94ddba2c4c71206962f7c6eaec6e5fabf00f3f7540c4ed7ad8f1", - "timestamp": "0x67803e64", - "transactions": [ - "0xe7217784e0c3f7b35d39303b1165046e9b7e8af9b9cf80d5d5f96c3163de8f51", - "0xf0182201606ec03701ba3a07d965fabdb4b7d06b424f226ea7ec3581802fc6fa" - ], - "transactionsRoot": "0x9bdb74f3ce41f5893a02a631e904ae0d21ae8c4e416786d8dbd9cb5c54f1dc0f", - "uncles": [], - "withdrawals": [], - "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421" - } -``` - - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_submitwork.mdx b/services/reference/ethereum/json-rpc-methods/eth_submitwork.mdx index ce5c760b5aa..7b043302a28 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_submitwork.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_submitwork.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_submitWork sidebar_label: eth_submitWork description: Submits PoW solution on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_submitwork-description.mdx" - -# `eth_submitWork` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_submitwork-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_submitwork-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_submitwork-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_submitwork-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_submitwork-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/eth_syncing.mdx b/services/reference/ethereum/json-rpc-methods/eth_syncing.mdx index e8d7773c3cb..8dcfe17bc8a 100644 --- a/services/reference/ethereum/json-rpc-methods/eth_syncing.mdx +++ b/services/reference/ethereum/json-rpc-methods/eth_syncing.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_syncing sidebar_label: eth_syncing description: Indicates whether client is syncing on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_eth_syncing-description.mdx" - -# `eth_syncing` - - - -## Parameters - -import Params from "/services/reference/_partials/_eth_syncing-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_eth_syncing-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_eth_syncing-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_eth_syncing-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_eth_syncing-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_getfilterchanges.mdx b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_getfilterchanges.mdx index 0a2ce3525c3..5a21e1b25a4 100644 --- a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_getfilterchanges.mdx +++ b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_getfilterchanges.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getFilterChanges sidebar_label: eth_getFilterChanges description: Returns Ethereum logs since last poll. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-description.mdx" - -# `eth_getFilterChanges` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_getfilterchanges-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_getfilterlogs.mdx b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_getfilterlogs.mdx index 7fd9b6ba22c..7d966ff8345 100644 --- a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_getfilterlogs.mdx +++ b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_getfilterlogs.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_getFilterLogs sidebar_label: eth_getFilterLogs description: Returns logs by filter ID on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-description.mdx" - -# `eth_getFilterLogs` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_getfilterlogs-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_newblockfilter.mdx b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_newblockfilter.mdx index 838ecf936cc..82de2e0a976 100644 --- a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_newblockfilter.mdx +++ b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_newblockfilter.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_newBlockFilter sidebar_label: eth_newBlockFilter description: Creates filter to notify of new blocks on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_newblockfilter-description.mdx" - -# `eth_newBlockFilter` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_newblockfilter-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_newblockfilter-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_newblockfilter-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/filter-methods/_eth_newblockfilter-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_newblockfilter-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_newfilter.mdx b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_newfilter.mdx index f661cbf5550..71fea207fdb 100644 --- a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_newfilter.mdx +++ b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_newfilter.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_newFilter sidebar_label: eth_newFilter description: Creates filter to notify of state changes on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_newfilter-description.mdx" - -# `eth_newFilter` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_newfilter-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_newfilter-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_newfilter-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/filter-methods/_eth_newfilter-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_newfilter-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_uninstallfilter.mdx b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_uninstallfilter.mdx index 9f36a2ca760..b56cae8b999 100644 --- a/services/reference/ethereum/json-rpc-methods/filter-methods/eth_uninstallfilter.mdx +++ b/services/reference/ethereum/json-rpc-methods/filter-methods/eth_uninstallfilter.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_uninstallFilter sidebar_label: eth_uninstallFilter description: Uninstalls filter on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-description.mdx" - -# `eth_uninstallFilter` - - - -## Parameters - -import Params from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/filter-methods/_eth_uninstallfilter-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/net_listening.mdx b/services/reference/ethereum/json-rpc-methods/net_listening.mdx index 89c9221ce54..e74ba60ff26 100644 --- a/services/reference/ethereum/json-rpc-methods/net_listening.mdx +++ b/services/reference/ethereum/json-rpc-methods/net_listening.mdx @@ -2,43 +2,15 @@ title: Ethereum net_listening sidebar_label: net_listening description: Indicates whether client listening for network connections on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_net_listening-description.mdx" - -# `net_listening` - - - -## Parameters - -import Params from "/services/reference/_partials/_net_listening-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_net_listening-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_net_listening-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_net_listening-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_net_listening-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/net_peercount.mdx b/services/reference/ethereum/json-rpc-methods/net_peercount.mdx index 77a71b7da66..e0f389aaa0b 100644 --- a/services/reference/ethereum/json-rpc-methods/net_peercount.mdx +++ b/services/reference/ethereum/json-rpc-methods/net_peercount.mdx @@ -2,43 +2,15 @@ title: Ethereum net_peerCount sidebar_label: net_peerCount description: Returns peer count on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_net_peercount-description.mdx" - -# `net_peerCount` - - - -## Parameters - -import Params from "/services/reference/_partials/_net_peercount-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_net_peercount-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_net_peercount-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_net_peercount-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_net_peercount-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/net_version.mdx b/services/reference/ethereum/json-rpc-methods/net_version.mdx index 4f149217cb4..61f32f8f83c 100644 --- a/services/reference/ethereum/json-rpc-methods/net_version.mdx +++ b/services/reference/ethereum/json-rpc-methods/net_version.mdx @@ -2,43 +2,15 @@ title: Ethereum net_version sidebar_label: net_version description: Returns network ID on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_net_version-description.mdx" - -# `net_version` - - - -## Parameters - -import Params from "/services/reference/_partials/_net_version-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_net_version-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_net_version-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_net_version-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_net_version-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/subscription-methods/eth_subscribe.mdx b/services/reference/ethereum/json-rpc-methods/subscription-methods/eth_subscribe.mdx index d78a802c8b3..9f0f7e12929 100644 --- a/services/reference/ethereum/json-rpc-methods/subscription-methods/eth_subscribe.mdx +++ b/services/reference/ethereum/json-rpc-methods/subscription-methods/eth_subscribe.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_subscribe sidebar_label: eth_subscribe description: Creates new subscription on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/subscription-methods/_eth_subscribe-description.mdx" - -# `eth_subscribe` - - - -## Parameters - -import Params from "/services/reference/_partials/subscription-methods/_eth_subscribe-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/subscription-methods/_eth_subscribe-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/subscription-methods/_eth_subscribe-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/subscription-methods/_eth_subscribe-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/subscription-methods/_eth_subscribe-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/subscription-methods/eth_unsubscribe.mdx b/services/reference/ethereum/json-rpc-methods/subscription-methods/eth_unsubscribe.mdx index 070c1c8b81d..69d41cddddf 100644 --- a/services/reference/ethereum/json-rpc-methods/subscription-methods/eth_unsubscribe.mdx +++ b/services/reference/ethereum/json-rpc-methods/subscription-methods/eth_unsubscribe.mdx @@ -2,43 +2,15 @@ title: Ethereum eth_unsubscribe sidebar_label: eth_unsubscribe description: Cancels subscription on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-description.mdx" - -# `eth_unsubscribe` - - - -## Parameters - -import Params from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/subscription-methods/_eth_unsubscribe-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_block.mdx b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_block.mdx index 913921cb5cf..faab34c7f21 100644 --- a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_block.mdx +++ b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_block.mdx @@ -2,43 +2,15 @@ title: Ethereum trace_block sidebar_label: trace_block description: Gets trace information for transactions in a block on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/trace-methods/_trace_block-description.mdx" - -# `trace_block` - - - -## Parameters - -import Params from "/services/reference/_partials/trace-methods/_trace_block-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/trace-methods/_trace_block-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/trace-methods/_trace_block-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/trace-methods/_trace_block-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/trace-methods/_trace_block-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_call.mdx b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_call.mdx index 9a9f1062ca7..2d902019360 100644 --- a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_call.mdx +++ b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_call.mdx @@ -2,43 +2,15 @@ title: Ethereum trace_call sidebar_label: trace_call description: Executes a call on Ethereum and returns possible traces. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/trace-methods/_trace_call-description.mdx" - -# `trace_call` - - - -## Parameters - -import Params from "/services/reference/_partials/trace-methods/_trace_call-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/trace-methods/_trace_call-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/trace-methods/_trace_call-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/trace-methods/_trace_call-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/trace-methods/_trace_call-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_callmany.mdx b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_callmany.mdx index bf7a8b8ff0f..75f7c98d31a 100644 --- a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_callmany.mdx +++ b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_callmany.mdx @@ -2,43 +2,15 @@ title: Ethereum trace_callMany sidebar_label: trace_callMany description: Executes multiple calls on Ethereum and returns possible traces. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/trace-methods/_trace_callmany-description.mdx" - -# `trace_callMany` - - - -## Parameters - -import Params from "/services/reference/_partials/trace-methods/_trace_callmany-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/trace-methods/_trace_callmany-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/trace-methods/_trace_callmany-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/trace-methods/_trace_callmany-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/trace-methods/_trace_callmany-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_filter.mdx b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_filter.mdx index d2e60b435b9..cc17f3b7572 100644 --- a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_filter.mdx +++ b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_filter.mdx @@ -2,43 +2,15 @@ title: Ethereum trace_filter sidebar_label: trace_filter description: Returns filtered traces on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/trace-methods/_trace_filter-description.mdx" - -# `trace_filter` - - - -## Parameters - -import Params from "/services/reference/_partials/trace-methods/_trace_filter-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/trace-methods/_trace_filter-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/trace-methods/_trace_filter-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/trace-methods/_trace_filter-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/trace-methods/_trace_filter-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_transaction.mdx b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_transaction.mdx index 4fb27939abf..345f60d3d81 100644 --- a/services/reference/ethereum/json-rpc-methods/trace-methods/trace_transaction.mdx +++ b/services/reference/ethereum/json-rpc-methods/trace-methods/trace_transaction.mdx @@ -2,43 +2,15 @@ title: Ethereum trace_transaction sidebar_label: trace_transaction description: Returns traces for a transaction on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/trace-methods/_trace_transaction-description.mdx" - -# `trace_transaction` - - - -## Parameters - -import Params from "/services/reference/_partials/trace-methods/_trace_transaction-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/trace-methods/_trace_transaction-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/trace-methods/_trace_transaction-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/trace-methods/_trace_transaction-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/trace-methods/_trace_transaction-response.mdx" - - + diff --git a/services/reference/ethereum/json-rpc-methods/web3_clientversion.mdx b/services/reference/ethereum/json-rpc-methods/web3_clientversion.mdx index 08552eb581c..fd49700b663 100644 --- a/services/reference/ethereum/json-rpc-methods/web3_clientversion.mdx +++ b/services/reference/ethereum/json-rpc-methods/web3_clientversion.mdx @@ -2,43 +2,15 @@ title: Ethereum web3_clientVersion sidebar_label: web3_clientVersion description: Returns client version on Ethereum. +hide_title: true +hide_table_of_contents: true --- -import Tabs from "@theme/Tabs" -import TabItem from "@theme/TabItem" +import ParserOpenRPC from "@site/src/components/ParserOpenRPC" +import { NETWORK_NAMES } from "@site/src/plugins/plugin-json-rpc" -import Description from "/services/reference/_partials/_web3_clientversion-description.mdx" - -# `web3_clientVersion` - - - -## Parameters - -import Params from "/services/reference/_partials/_web3_clientversion-parameters.mdx" - - - -## Returns - -import Returns from "/services/reference/_partials/_web3_clientversion-returns.mdx" - - - -## Example - -import Example from "/services/reference/_partials/_web3_clientversion-example.mdx" - - - -### Request - -import Request from "/services/reference/_partials/_web3_clientversion-request.mdx" - - - -### Response - -import Response from "/services/reference/_partials/_web3_clientversion-response.mdx" - - + diff --git a/src/components/ParserOpenRPC/index.tsx b/src/components/ParserOpenRPC/index.tsx index bdb13872034..a88c0b33ba4 100644 --- a/src/components/ParserOpenRPC/index.tsx +++ b/src/components/ParserOpenRPC/index.tsx @@ -15,13 +15,15 @@ import { trackClickForSegment, trackInputChangeForSegment } from '@site/src/lib/ import { AuthBox } from '@site/src/components/ParserOpenRPC/AuthBox' import { MetamaskProviderContext } from '@site/src/theme/Root' import ProjectsBox from '@site/src/components/ParserOpenRPC/ProjectsBox' -import { LINEA_REQUEST_URL } from '@site/src/lib/constants' +import { BASE_PROD_URL, ETHEREUM_PROD_URL, LINEA_REQUEST_URL } from '@site/src/lib/constants' import useIsBrowser from '@docusaurus/useIsBrowser' import { encrypt } from '@metamask/eth-sig-util' import { hexlify } from 'ethers' // Import local specs import localLineaSpec from '@site/src/specs/linea/openrpc.json' +import localBaseSpec from '@site/src/specs/base/openrpc.json' +import localEthereumSpec from '@site/src/specs/ethereum/openrpc.json' interface ParserProps { network: NETWORK_NAMES @@ -106,8 +108,15 @@ export default function ParserOpenRPC({ src === 'local' ? { name: network, - data: network === NETWORK_NAMES.linea ? localLineaSpec : null, - error: network !== NETWORK_NAMES.linea, // Error if local spec not available for this network + data: + network === NETWORK_NAMES.linea + ? localLineaSpec + : network === NETWORK_NAMES.base + ? localBaseSpec + : network === NETWORK_NAMES.ethereum + ? localEthereumSpec + : null, + error: ![NETWORK_NAMES.linea, NETWORK_NAMES.base, NETWORK_NAMES.ethereum].includes(network), // Error if local spec not available for this network } : netData?.find(net => net.name === network) @@ -164,7 +173,10 @@ export default function ParserOpenRPC({ paramStructure: currentMethod?.paramStructure || null, errors, tags, - servers: currentNetwork.data?.servers?.[0]?.url || null, + servers: + currentNetwork.data?.servers?.[0]?.url || + currentNetwork.data?.info?.servers?.[0]?.url || + null, } }, [currentNetwork, method, src]) @@ -233,8 +245,14 @@ export default function ParserOpenRPC({ } } + const defaultRequestUrl = + network === NETWORK_NAMES.base + ? BASE_PROD_URL + : network === NETWORK_NAMES.ethereum + ? ETHEREUM_PROD_URL + : LINEA_REQUEST_URL const INIT_URL = - currentMethodData.servers !== null ? currentMethodData.servers : `${LINEA_REQUEST_URL}/v3/` + currentMethodData.servers !== null ? currentMethodData.servers : `${defaultRequestUrl}/v3/` const handleServiceRequest = async () => { const URL = `${INIT_URL}${userAPIKey}` diff --git a/src/lib/constants.ts b/src/lib/constants.ts index b9b2a957019..2ac88138ccf 100644 --- a/src/lib/constants.ts +++ b/src/lib/constants.ts @@ -466,3 +466,5 @@ export const REQUEST_PARAMS = (method = 'POST', headers = {}) => ({ export const LINEA_PROD_URL = 'https://linea-mainnet.infura.io' export const LINEA_DEV_URL = 'https://linea-mainnet.dev.infura.org' export const LINEA_REQUEST_URL = LINEA_PROD_URL +export const BASE_PROD_URL = 'https://base-mainnet.infura.io' +export const BASE_REQUEST_URL = BASE_PROD_URL diff --git a/src/plugins/plugin-json-rpc.ts b/src/plugins/plugin-json-rpc.ts index bdebb103024..8041018daad 100644 --- a/src/plugins/plugin-json-rpc.ts +++ b/src/plugins/plugin-json-rpc.ts @@ -84,6 +84,8 @@ export const MM_RPC_URL = 'https://metamask.github.io/api-specs/latest/openrpc.j export const MM_REF_PATH = 'wallet/reference/json-rpc-methods' export enum NETWORK_NAMES { + base = 'base', + ethereum = 'ethereum', linea = 'linea', metamask = 'metamask', } diff --git a/src/specs/base/openrpc.json b/src/specs/base/openrpc.json new file mode 100644 index 00000000000..3c3342f0083 --- /dev/null +++ b/src/specs/base/openrpc.json @@ -0,0 +1,13295 @@ +{ + "openrpc": "1.2.4", + "info": { + "title": "Base JSON-RPC Specification", + "description": "Supported standard Ethereum JSON-RPC methods on the Base network.", + "version": "0.0.0", + "license": { + "name": "CC0-1.0", + "url": "https://creativecommons.org/publicdomain/zero/1.0/legalcode" + } + }, + "methods": [ + { + "name": "eth_accounts", + "summary": "Returns a list of addresses owned by client.", + "description": "Returns a list of addresses owned by the client.", + "params": [], + "result": { + "name": "Accounts", + "description": "Array of hexadecimal address strings owned by the client.", + "schema": { + "title": "Accounts", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + } + }, + "examples": [ + { + "name": "eth_accounts example", + "params": [], + "result": { + "name": "Accounts", + "value": [] + } + } + ] + }, + { + "name": "eth_blockNumber", + "summary": "Returns the number of most recent block.", + "description": "Returns the current latest block number.", + "params": [], + "result": { + "name": "Block number", + "description": "Hexadecimal integer of the most recent block number.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_blockNumber example", + "params": [], + "result": { + "name": "Block number", + "value": "0x65a8db" + } + } + ] + }, + { + "name": "eth_call", + "summary": "Execute a new message call", + "description": "This request executes a new message call without creating a transaction on the blockchain. It allows you to invoke a contract function locally to interact with smart contracts and query data without modifying the blockchain state or consuming gas. `eth_call` is ideal for retrieving data, simulating transactions, or testing contract interactions. \nYou may (optionally) specify a block identifier to simulate the transaction on, or estimate gas usage based on the state of the blockchain at that block.\nIf the execution continues beyond the gas cap (10x the block gas limit), the node stops the simulation and returns an error. This prevents demand for excessive computational resource use or API abuse.\n", + "params": [ + { + "name": "transaction", + "required": true, + "description": "Transaction object generic to all Linea-supported transactions. All transaction call object parameters are optional.", + "schema": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + }, + { + "name": "block", + "required": false, + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "eth_callResponse", + "description": "Note that, an `execution reverted` message suggests that the transaction would fail on-chain or that the contract logic has conditions that aren't met when simulating the transaction.", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "examples": [ + { + "name": "eth_call example", + "params": [ + { + "name": "Transaction", + "value": { + "from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155", + "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", + "gas": "0x76c0", + "gasPrice": "0x9184e72a000", + "value": "0x9184e72a", + "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675" + } + }, + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Return data", + "value": "0x" + } + } + ] + }, + { + "name": "eth_chainId", + "summary": "Returns the chain ID of the current network.", + "description": "Returns the currently configured chain ID, a value used in replay-protected transaction signing as introduced by [EIP-155](https://eips.ethereum.org/EIPS/eip-155).", + "params": [], + "result": { + "name": "Chain ID", + "description": "Hexadecimal of the current chain ID.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_chainId example", + "params": [], + "result": { + "name": "Chain ID", + "value": "0x1" + } + } + ] + }, + { + "name": "eth_estimateGas", + "summary": "Generates and returns an estimate of how much gas is necessary to allow the transaction to complete.", + "description": "Generates and returns an estimate of how much gas is necessary to allow the transaction to complete. The transaction will not be added to the blockchain. Note that the estimate may be significantly more than the amount of gas actually used by the transaction, for a variety of reasons including EVM mechanics and node performance.\n\nTo prevent abuse of the API, the `gas` parameter in this `eth_estimateGas` method and in `eth_call` is capped at 10x (1000%) the current block gas limit. You can recreate this behavior in your local test environment (Besu, geth, or other client) using the [`rpc.gascap`](https://geth.ethereum.org/docs/fundamentals/command-line-options#commands) command line option.\n", + "params": [ + { + "name": "Transaction", + "required": true, + "schema": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "description": "Transaction call object." + }, + { + "name": "Block", + "required": false, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "description": "Block number or tag (`latest`, `earliest`, `pending`, `safe`, `finalized`)." + } + ], + "result": { + "name": "Gas used", + "description": "Hexadecimal estimate of gas for the given transaction.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_estimateGas example", + "params": [ + { + "name": "Transaction", + "value": { + "from": "0x9cE564c7d09f88E7d8233Cdd3A4d7AC42aBFf3aC", + "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", + "value": "0x9184e72a" + } + } + ], + "result": { + "name": "Gas used", + "value": "0x5cec" + } + } + ] + }, + { + "name": "eth_feeHistory", + "summary": "Transaction fee history", + "description": "Returns historical gas information, allowing you to track trends over time.", + "params": [ + { + "name": "blockCount", + "description": "Requested range of blocks. Clients will return less than the requested range if not all blocks are available.", + "required": true, + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + { + "name": "newestBlock", + "description": "Highest block of the requested range.", + "required": true, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + }, + { + "name": "rewardPercentiles", + "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 coresponding effective tip for the percentile will be determined, accounting for gas consumed.", + "required": true, + "schema": { + "title": "rewardPercentiles", + "type": "array", + "items": { + "title": "rewardPercentile", + "description": "Floating point value between 0 and 100.", + "type": "number" + } + } + } + ], + "result": { + "name": "Fee history result", + "description": "Fee history for the returned block range. This can be a subsection of the requested range if not all blocks are available.", + "schema": { + "title": "feeHistoryResults", + "description": "Fee history results.", + "type": "object", + "required": [ + "oldestBlock", + "baseFeePerGas", + "gasUsedRatio" + ], + "additionalProperties": false, + "properties": { + "oldestBlock": { + "description": "Lowest number block of returned range.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "oldestBlock" + }, + "baseFeePerGas": { + "title": "baseFeePerGasArray", + "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.", + "type": "array", + "items": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "baseFeePerBlobGas": { + "title": "baseFeePerBlobGasArray", + "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.", + "type": "array", + "items": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "gasUsedRatio": { + "title": "gasUsedRatio", + "description": "An array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit.", + "type": "array", + "items": { + "title": "ratio", + "description": "Decimal value between 0 and 1.", + "type": "number", + "minimum": 0, + "maximum": 1 + } + }, + "blobGasUsedRatio": { + "title": "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.", + "type": "array", + "items": { + "title": "ratio", + "description": "Decimal value between 0 and 1.", + "type": "number", + "minimum": 0, + "maximum": 1 + } + }, + "reward": { + "title": "rewardArray", + "description": "A two-dimensional array of effective priority fees per gas at the requested block percentiles.", + "type": "array", + "items": { + "title": "rewardPercentile", + "description": "An array of effective priority fee per gas data points from a single block. All zeroes are returned if the block is empty.", + "type": "array", + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "rewardPercentile" + } + } + } + } + } + }, + "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": { + "baseFeePerGas": [ + "0x3da8e7618", + "0x3e1ba3b1b", + "0x3dfd72b90", + "0x3d64eee76", + "0x3d4da2da0", + "0x3ccbcac6b" + ], + "gasUsedRatio": [ + 0.5290747666666666, + 0.49240453333333334, + 0.4615576, + 0.49407083333333335, + 0.4669053 + ], + "oldestBlock": "0xfab8ac", + "reward": [ + [ + "0x59682f00", + "0x59682f00" + ], + [ + "0x59682f00", + "0x59682f00" + ], + [ + "0x3b9aca00", + "0x59682f00" + ], + [ + "0x510b0870", + "0x59682f00" + ], + [ + "0x3b9aca00", + "0x59682f00" + ] + ] + } + } + } + ] + }, + { + "name": "eth_gasPrice", + "description": "Returns the current gas price in wei.", + "summary": "Returns the current price per gas in wei.", + "params": [], + "result": { + "name": "Gas price", + "description": "Current gas price, in wei, represented as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Gas price" + } + }, + "examples": [ + { + "name": "eth_gasPrice example", + "params": [], + "result": { + "name": "Gas price", + "value": "0x6bcc886e7" + } + } + ] + }, + { + "name": "eth_getBalance", + "description": "Returns the balance of the account of a given address.", + "summary": "Returns the balance of the account of given address.", + "params": [ + { + "name": "Address", + "required": true, + "description": "20-byte account address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Balance", + "description": "Current account balance (wei) as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_getBalance example", + "params": [ + { + "name": "Address", + "value": "0xc94770007dda54cF92009BFF0dE90c06F603a09f" + }, + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Balance", + "value": "0x7c2562030800" + } + } + ] + }, + { + "name": "eth_getBlockByHash", + "summary": "Returns information about a block by hash.", + "description": "Returns information about a block given its block hash.", + "params": [ + { + "name": "Block hash", + "required": true, + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "name": "Hydrated transactions", + "required": true, + "schema": { + "title": "hydrated", + "type": "boolean", + "description": "If `true`, returns full transaction objects; if `false`, returns only transaction hashes." + } + } + ], + "result": { + "name": "Block information", + "description": "Block object matching the given hash, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getBlockByHash example", + "params": [ + { + "name": "Block hash", + "value": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35" + }, + { + "name": "Hydrated transactions", + "value": false + } + ], + "result": { + "name": "Block information", + "value": { + "difficulty": "0xbfabcdbd93dda", + "extraData": "0x737061726b706f6f6c2d636e2d6e6f64652d3132", + "gasLimit": "0x79f39e", + "gasUsed": "0x79ccd3", + "hash": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", + "logsBloom": "0x4848112002a2020aaa0812180045840210020005281600c80104264300080008000491220144461026015300100000128005018401002090a824a4150015410020140400d808440106689b29d0280b1005200007480ca950b15b010908814e01911000054202a020b05880b914642a0000300003010044044082075290283516be82504082003008c4d8d14462a8800c2990c88002a030140180036c220205201860402001014040180002006860810ec0a1100a14144148408118608200060461821802c081000042d0810104a8004510020211c088200420822a082040e10104c00d010064004c122692020c408a1aa2348020445403814002c800888208b1", + "miner": "0x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c", + "mixHash": "0x3d1fdd16f15aeab72e7db1013b9f034ee33641d92f71c0736beab4e67d34c7a7", + "nonce": "0x4db7a1c01d8a8072", + "number": "0x5bad55", + "parentHash": "0x61a8ad530a8a43e3583f8ec163f773ad370329b2375d66433eb82f005e1d6202", + "receiptsRoot": "0x5eced534b3d84d3d732ddbc714f5fd51d98a941b28182b6efe6df3a0fe90004b", + "sha3Uncles": "0x8a562e7634774d3e3a36698ac4915e37fc84a2cd0044cb84fa5d80263d2af4f6", + "size": "0x41c7", + "stateRoot": "0xf5208fffa2ba5a3f3a2f64ebd5ca3d098978bedd75f335f56b705d8715ee2305", + "timestamp": "0x5b541449", + "totalDifficulty": "0x12ac11391a2f3872fcd", + "transactions": [ + "0x8784d99762bccd03b2086eabccee0d77f14d05463281e121a62abfebcf0d2d5f", + "0x311be6a9b58748717ac0f70eb801d29973661aaf1365960d159e4ec4f4aa2d7f", + "0xe42b0256058b7cad8a14b136a0364acda0b4c36f5b02dea7e69bfd82cef252a2", + "0x4eb05376055c6456ed883fc843bc43df1dcf739c321ba431d518aecd7f98ca11", + "0x994dd9e72b212b7dc5fd0466ab75adf7d391cf4f206a65b7ad2a1fd032bb06d7", + "0xf6feecbb9ab0ac58591a4bc287059b1133089c499517e91a274e6a1f5e7dce53", + "0x7e537d687a5525259480440c6ea2e1a8469cd98906eaff8597f3d2a44422ff97", + "0xa762220e92bed6d77a2c19ffc60dad77d71bd5028c5230c896ab4b9552a39b50", + "0xf1fa677edda7e5add8e794732c7554cd5459a5c12781dc71de73c7937dfb2775", + "0x241d89f7888fbcfadfd415ee967882fec6fdd67c07ca8a00f2ca4c910a84c7dd" + ] + } + } + } + ] + }, + { + "name": "eth_getBlockByNumber", + "summary": "Returns information about a block by number.", + "description": "Returns information about a block given its block number.", + "params": [ + { + "name": "Block", + "required": true, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + }, + { + "name": "Hydrated transactions", + "required": true, + "schema": { + "title": "hydrated", + "type": "boolean", + "description": "If `true`, returns full transaction objects; if `false`, returns only transaction hashes." + } + } + ], + "result": { + "name": "Block information", + "description": "Block object matching the given block number, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getBlockByNumber example", + "params": [ + { + "name": "block", + "value": "0x5BAD55" + }, + { + "name": "Hydrated transactions", + "value": false + } + ], + "result": { + "name": "Block information", + "value": { + "difficulty": "0xbfabcdbd93dda", + "extraData": "0x737061726b706f6f6c2d636e2d6e6f64652d3132", + "gasLimit": "0x79f39e", + "gasUsed": "0x79ccd3", + "hash": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", + "logsBloom": "0x4848112002a2020aaa0812180045840210020005281600c80104264300080008000491220144461026015300100000128005018401002090a824a4150015410020140400d808440106689b29d0280b1005200007480ca950b15b010908814e01911000054202a020b05880b914642a0000300003010044044082075290283516be82504082003008c4d8d14462a8800c2990c88002a030140180036c220205201860402001014040180002006860810ec0a1100a14144148408118608200060461821802c081000042d0810104a8004510020211c088200420822a082040e10104c00d010064004c122692020c408a1aa2348020445403814002c800888208b1", + "miner": "0x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c", + "mixHash": "0x3d1fdd16f15aeab72e7db1013b9f034ee33641d92f71c0736beab4e67d34c7a7", + "nonce": "0x4db7a1c01d8a8072", + "number": "0x5bad55", + "parentHash": "0x61a8ad530a8a43e3583f8ec163f773ad370329b2375d66433eb82f005e1d6202", + "receiptsRoot": "0x5eced534b3d84d3d732ddbc714f5fd51d98a941b28182b6efe6df3a0fe90004b", + "sha3Uncles": "0x8a562e7634774d3e3a36698ac4915e37fc84a2cd0044cb84fa5d80263d2af4f6", + "size": "0x41c7", + "stateRoot": "0xf5208fffa2ba5a3f3a2f64ebd5ca3d098978bedd75f335f56b705d8715ee2305", + "timestamp": "0x5b541449", + "totalDifficulty": "0x12ac11391a2f3872fcd", + "transactions": [ + "0x8784d99762bccd03b2086eabccee0d77f14d05463281e121a62abfebcf0d2d5f", + "0x311be6a9b58748717ac0f70eb801d29973661aaf1365960d159e4ec4f4aa2d7f", + "0xe42b0256058b7cad8a14b136a0364acda0b4c36f5b02dea7e69bfd82cef252a2", + "0x4eb05376055c6456ed883fc843bc43df1dcf739c321ba431d518aecd7f98ca11", + "0x994dd9e72b212b7dc5fd0466ab75adf7d391cf4f206a65b7ad2a1fd032bb06d7", + "0xf6feecbb9ab0ac58591a4bc287059b1133089c499517e91a274e6a1f5e7dce53", + "0x7e537d687a5525259480440c6ea2e1a8469cd98906eaff8597f3d2a44422ff97", + "0xa762220e92bed6d77a2c19ffc60dad77d71bd5028c5230c896ab4b9552a39b50", + "0xf1fa677edda7e5add8e794732c7554cd5459a5c12781dc71de73c7937dfb2775", + "0x241d89f7888fbcfadfd415ee967882fec6fdd67c07ca8a00f2ca4c910a84c7dd" + ], + "transactionsRoot": "0xf98631e290e88f58a46b7032f025969039aa9b5696498efc76baf436fa69b262", + "uncles": [ + "0x824cce7c7c2ec6874b9fa9a9a898eb5f27cbaf3991dfa81084c3af60d1db618c" + ] + } + } + } + ] + }, + { + "name": "eth_getBlockTransactionCountByHash", + "summary": "Returns the number of transactions in a block from a block matching the given block hash.", + "description": "Returns the number of transactions in the block with the given block hash.", + "params": [ + { + "name": "Block hash", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Transaction count", + "description": "Hexadecimal transaction count in the block, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Transaction count" + } + ] + } + }, + "examples": [ + { + "name": "eth_getBlockTransactionCountByHash example", + "params": [ + { + "name": "Block hash", + "value": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35" + } + ], + "result": { + "name": "Transaction count", + "value": "0x50" + } + } + ] + }, + { + "name": "eth_getBlockTransactionCountByNumber", + "summary": "Returns the number of transactions in a block matching the given block number.", + "description": "Returns the number of transactions in the block with the given block number.", + "params": [ + { + "name": "Block", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Transaction count", + "description": "Hexadecimal transaction count in the block, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Transaction count" + } + ] + } + }, + "examples": [ + { + "name": "eth_getBlockTransactionCountByNumber example", + "params": [ + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Transaction count", + "value": "0xa0" + } + } + ] + }, + { + "name": "eth_getCode", + "description": "Returns the compiled byte code of a smart contract, if any, at a given address.", + "summary": "Returns code at a given address.", + "params": [ + { + "name": "Address", + "required": true, + "description": "Account or contract address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Bytecode", + "description": "Hex-encoded contract bytecode, or `0x` if the address contains no code.", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "examples": [ + { + "name": "eth_getCode example", + "params": [ + { + "name": "Address", + "value": "0x06012c8cf97bead5deae237070f9587f8e7a266d" + }, + { + "name": "Block", + "value": "0x65a8db" + } + ], + "result": { + "name": "Bytecode", + "value": "0x60606040..." + } + } + ] + }, + { + "name": "eth_getFilterChanges", + "summary": "Polling method for the filter with the given ID (created using `eth_newFilter`). Returns an array of logs which occurred since last poll.", + "description": "Polls the specified filter and returns changes since the last call. Depending on filter type, the result is an array of log objects, block hashes, or transaction hashes.", + "params": [ + { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` to poll.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Log objects", + "description": "Array of items matching the filter (log objects, block hashes, or transaction hashes).", + "schema": { + "oneOf": [ + { + "title": "New block or transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "New logs", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getFilterChanges example", + "params": [ + { + "name": "Filter identifier", + "value": "0x10ff0bfbedb01f0dbd4106d14eb719ec38b6eb5b821c" + } + ], + "result": { + "name": "Log objects", + "value": [ + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x233", + "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5", + "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000004", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + }, + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x238", + "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed", + "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000007", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + } + ] + } + } + ] + }, + { + "name": "eth_getFilterLogs", + "summary": "Returns an array of all logs matching the filter with the given ID (created using `eth_newFilter`).", + "description": "Retrieves all logs that match the specified filter ID, without resetting the filter's internal state.", + "params": [ + { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` to query.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Log objects", + "description": "Array of log objects that matched the filter since its creation.", + "schema": { + "oneOf": [ + { + "title": "New block or transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "New logs", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getFilterLogs example", + "params": [ + { + "name": "Filter identifier", + "value": "0x10ff0bfbedb01f0dbd4106d14eb719ec38b6eb5b821c" + } + ], + "result": { + "name": "Log objects", + "value": [ + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x233", + "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5", + "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000004", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + }, + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x238", + "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed", + "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000007", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + } + ] + } + } + ] + }, + { + "name": "eth_getLogs", + "summary": "Returns an array of all logs matching the specified filter.", + "description": "Returns an array of all the logs matching the given filter object. See also the below [Constraints](#constraints) section.", + "params": [ + { + "name": "Filter", + "description": "Filter object defining log criteria.", + "schema": { + "type": "object", + "additionalProperties": false, + "properties": { + "fromBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "toBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "address": { + "description": "A contract address or a list of addresses from which logs should originate.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "address": null, + "title": "Single address" + }, + { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "addresses": null, + "title": "List of addresses" + } + ] + }, + "topics": { + "description": "An array of 32 bytes DATA topics. Topics are order-dependent. `null` (empty array) provides any topic match.", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ], + "result": { + "name": "Log objects", + "description": "Array of log objects that satisfy the filter.", + "schema": { + "oneOf": [ + { + "title": "New block or transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "New logs", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getLogs example", + "params": [ + { + "name": "Filter", + "value": { + "blockHash": "0x7c5a35e9cb3e8ae0e221ab470abae9d446c3a5626ce6689fc777dcffcab52c70", + "topics": [ + "0x241ea03ca20251805084d27d4440371c34a0b85ff108f6bb5611248f73818b80" + ] + } + } + ], + "result": { + "name": "Log objects", + "value": [ + { + "address": "0x1a94fce7ef36bc90959e206ba569a12afbc91ca1", + "blockHash": "0x7c5a35e9cb3e8ae0e221ab470abae9d446c3a5626ce6689fc777dcffcab52c70", + "blockNumber": "0x5c29fb", + "data": "0x0000000000000000000000003e3310720058c51f0de456e273c626cdd35065700000000000000000000000000000000000000000000000000000000000003185000000000000000000000000000000000000000000000000000000000000318200000000000000000000000000000000000000000000000000000000005c2a23", + "logIndex": "0x1d", + "removed": false, + "topics": [ + "0x241ea03ca20251805084d27d4440371c34a0b85ff108f6bb5611248f73818b80" + ], + "transactionHash": "0x3dc91b98249fa9f2c5c37486a2427a3a7825be240c1c84961dfb3063d9c04d50", + "transactionIndex": "0x1d" + }, + { + "address": "0x06012c8cf97bead5deae237070f9587f8e7a266d", + "blockHash": "0x7c5a35e9cb3e8ae0e221ab470abae9d446c3a5626ce6689fc777dcffcab52c70", + "blockNumber": "0x5c29fb", + "data": "0x00000000000000000000000077ea137625739598666ded665953d26b3d8e374400000000000000000000000000000000000000000000000000000000000749ff00000000000000000000000000000000000000000000000000000000000a749d00000000000000000000000000000000000000000000000000000000005c2a0f", + "logIndex": "0x57", + "removed": false, + "topics": [ + "0x241ea03ca20251805084d27d4440371c34a0b85ff108f6bb5611248f73818b80" + ], + "transactionHash": "0x788b1442414cb9c9a36dba2abe250763161a6f6395788a2e808f1b34e92beec1", + "transactionIndex": "0x54" + } + ] + } + } + ] + }, + { + "name": "eth_getProof", + "description": "Returns the account and storage values, including the Merkle proof, of the specified account.", + "summary": "Returns the merkle proof for a given account and optionally some storage keys.", + "params": [ + { + "name": "Address", + "required": true, + "description": "A string identifier for the contract or EOA address (20 bytes).", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "StorageKeys", + "required": true, + "description": "Storage keys may be specified to retrieve the storage proofs for particular slots in a smart contract's storage. If not required, pass empty array.", + "schema": { + "title": "Storage keys", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + } + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Account", + "description": "Account proof object containing account and storage proofs.", + "schema": { + "type": "object", + "required": [ + "address", + "accountProof", + "balanceeth_getBalance", + "codeHash", + "nonce", + "storageHash", + "storageProof" + ], + "additionalProperties": false, + "properties": { + "address": { + "description": "The account address for which the Merkle proof is retrieved. This is an echo of the address passed in the request.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "accountProof": { + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `stateRoot`-Node, following the path of the address as key.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "balance": { + "description": "Hexadecimal of the balance in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "codeHash": { + "description": "The 32-byte hash of the account's code. For EOAs, this will be the hash of an empty string. For contract accounts, it represents the hash of the deployed contract code.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "storageHash": { + "description": "32-byte SHA3 hash of the storage root. All storage will deliver a Merkle proof starting with this root hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "storageProof": { + "description": "An array of requested storage-entries.", + "type": "array", + "items": { + "type": "object", + "required": [ + "key", + "value", + "proof" + ], + "additionalProperties": false, + "properties": { + "key": { + "description": "The requested storage key.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + }, + "value": { + "description": "The storage value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "proof": { + "type": "array", + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `storageHash` node and following the path of the key.", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + } + } + } + } + } + }, + "examples": [ + { + "name": "eth_getProof example", + "params": [ + { + "name": "Address", + "value": "0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842" + }, + { + "name": "StorageKeys", + "value": [ + "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421" + ] + }, + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Account", + "value": { + "accountProof": [ + "0xf90211a...0701bc80", + "0xf90211a...0d832380", + "0xf90211a...5fb20c80", + "0xf90211a...0675b80", + "0xf90151a0...ca08080" + ], + "address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842", + "balance": "0x0", + "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470", + "nonce": "0x0", + "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "storageProof": [ + { + "key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "proof": [], + "value": "0x0" + } + ] + } + } + } + ] + }, + { + "name": "eth_getStorageAt", + "description": "Returns the value from a storage position at a given address.", + "summary": "Returns the value from a storage position at a given address.", + "params": [ + { + "name": "Address", + "required": true, + "description": "Contract or account address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "Storage slot", + "required": true, + "description": "32-byte storage slot index (hex).", + "schema": { + "description": "Hex-encoded 256 bit unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Value", + "description": "Hex-encoded value stored at the given slot.", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "examples": [ + { + "name": "eth_getStorageAt example", + "params": [ + { + "name": "Address", + "value": "0x295a70b2de5e3953354a6a8344e616ed314d7251" + }, + { + "name": "Storage slot", + "value": "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9" + }, + { + "name": "Block", + "value": "0x65a8db" + } + ], + "result": { + "name": "Value", + "value": "0x0000000000000000000000000000000000000000000000000000000000000000" + } + } + ] + }, + { + "name": "eth_getTransactionByBlockHashAndIndex", + "summary": "Returns information about a transaction by block hash and transaction index position.", + "description": "Returns information about a transaction given block hash and transaction index position.", + "params": [ + { + "name": "Block hash", + "required": true, + "description": "32-byte block hash.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "name": "Transaction index", + "required": true, + "description": "Hexadecimal index of the transaction in the block.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Transaction information", + "description": "Transaction object, or `null` when no transaction was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getTransactionByBlockHashAndIndex example", + "params": [ + { + "name": "Block hash", + "value": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35" + }, + { + "name": "Transaction index", + "value": "0x0" + } + ], + "result": { + "name": "Transaction information", + "value": { + "blockHash": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", + "blockNumber": "0x5bad55", + "chainId": "0x1", + "from": "0xfbb1b73c4f0bda4f67dca266ce6ef42f520fbb98", + "gas": "0x249f0", + "gasPrice": "0x174876e800", + "hash": "0x8784d99762bccd03b2086eabccee0d77f14d05463281e121a62abfebcf0d2d5f", + "input": "0x6ea056a9000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000bd8d7fa6f8cc00", + "nonce": "0x5e4724", + "r": "0xd1556332df97e3bd911068651cfad6f975a30381f4ff3a55df7ab3512c78b9ec", + "s": "0x66b51cbb10cd1b2a09aaff137d9f6d4255bf73cb7702b666ebd5af502ffa4410", + "to": "0x4b9c25ca0224aef6a7522cabdbc3b2e125b7ca50", + "transactionIndex": "0x0", + "type": "0x0", + "v": "0x25", + "value": "0x0" + } + } + } + ] + }, + { + "name": "eth_getTransactionByBlockNumberAndIndex", + "summary": "Returns information about a transaction by block number and transaction index position.", + "description": "Returns information about a transaction given block number and transaction index position.", + "params": [ + { + "name": "Block", + "required": true, + "description": "Hexadecimal block number or tag (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + }, + { + "name": "Transaction index", + "required": true, + "description": "Hexadecimal index of the transaction in the block.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Transaction information", + "description": "Transaction object, or `null` when no transaction was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getTransactionByBlockNumberAndIndex example", + "params": [ + { + "name": "Block", + "value": "0x5BAD55" + }, + { + "name": "Transaction index", + "value": "0x0" + } + ], + "result": { + "name": "Transaction information", + "value": { + "blockHash": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", + "blockNumber": "0x5bad55", + "chainId": "0x1", + "from": "0xfbb1b73c4f0bda4f67dca266ce6ef42f520fbb98", + "gas": "0x249f0", + "gasPrice": "0x174876e800", + "hash": "0x8784d99762bccd03b2086eabccee0d77f14d05463281e121a62abfebcf0d2d5f", + "input": "0x6ea056a9000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000bd8d7fa6f8cc00", + "nonce": "0x5e4724", + "r": "0xd1556332df97e3bd911068651cfad6f975a30381f4ff3a55df7ab3512c78b9ec", + "s": "0x66b51cbb10cd1b2a09aaff137d9f6d4255bf73cb7702b666ebd5af502ffa4410", + "to": "0x4b9c25ca0224aef6a7522cabdbc3b2e125b7ca50", + "transactionIndex": "0x0", + "type": "0x0", + "v": "0x25", + "value": "0x0" + } + } + } + ] + }, + { + "name": "eth_getTransactionByHash", + "summary": "Returns the information about a transaction requested by transaction hash.", + "description": "Returns information about a transaction for a given hash.", + "params": [ + { + "name": "Transaction hash", + "required": true, + "description": "32-byte transaction hash.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Transaction information", + "description": "Transaction object, or `null` when no transaction was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getTransactionByHash example", + "params": [ + { + "name": "Transaction hash", + "value": "0xbb3a336e3f823ec18197f1e13ee875700f08f03e2cab75f0d0b118dabb44cba0" + } + ], + "result": { + "name": "Transaction information", + "value": { + "blockHash": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35", + "blockNumber": "0x5bad55", + "chainId": "0x1", + "from": "0x398137383b3d25c92898c656696e41950e47316b", + "gas": "0x1d45e", + "gasPrice": "0xfa56ea00", + "hash": "0xbb3a336e3f823ec18197f1e13ee875700f08f03e2cab75f0d0b118dabb44cba0", + "input": "0xf7d8c88300000000000000000000000000000000000000000000000000000000000cee6100000000000000000000000000000000000000000000000000000000000ac3e1", + "nonce": "0x18", + "r": "0x2a378831cf81d99a3f06a18ae1b6ca366817ab4d88a70053c41d7a8f0368e031", + "s": "0x450d831a05b6e418724436c05c155e0a1b7b921015d0fbc2f667aed709ac4fb5", + "to": "0x06012c8cf97bead5deae237070f9587f8e7a266d", + "transactionIndex": "0x11", + "type": "0x0", + "v": "0x25", + "value": "0x1c6bf526340000" + } + } + } + ] + }, + { + "name": "eth_getTransactionCount", + "description": "Returns the number of transactions sent from an address.", + "summary": "Returns the number of transactions sent from an address.", + "params": [ + { + "name": "Address", + "required": true, + "description": "20-byte account address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Transaction count", + "description": "Number of transactions (nonce) as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_getTransactionCount example", + "params": [ + { + "name": "Address", + "value": "0xc94770007dda54cF92009BFF0dE90c06F603a09f" + }, + { + "name": "Block", + "value": "0x5bad55" + } + ], + "result": { + "name": "Transaction count", + "value": "0x1a" + } + } + ] + }, + { + "name": "eth_getTransactionReceipt", + "summary": "Returns the receipt of a transaction by transaction hash.", + "description": "Returns the receipt of a transaction given transaction hash. Note that the receipt is not available for pending transactions.", + "params": [ + { + "name": "Transaction hash", + "required": true, + "description": "32-byte transaction hash.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Receipt information", + "description": "Receipt object, or `null` if the receipt is not yet available.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "type": "object", + "required": [ + "blockHash", + "blockNumber", + "from", + "cumulativeGasUsed", + "gasUsed", + "logs", + "logsBloom", + "transactionHash", + "transactionIndex", + "effectiveGasPrice" + ], + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte.", + "type": "string", + "pattern": "^0x([0-9a-fA-F]?){1,2}$" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Address of the call initiator.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "Address of the receiver or null in a contract creation transaction.", + "oneOf": [ + { + "title": "Contract Creation (null)", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Recipient Address" + } + ] + }, + "cumulativeGasUsed": { + "description": "The sum of gas used by this transaction and all preceding transactions in the same block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "The amount of gas used for this specific transaction alone.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasUsed": { + "description": "The amount of blob gas used for this specific transaction. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "contractAddress": { + "description": "The contract address created, if the transaction was a contract creation, otherwise null.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + }, + { + "title": "No data", + "type": "null" + } + ] + }, + "logs": { + "description": "Logs.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "logsBloom": { + "description": "Logs bloom.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "root": { + "description": "The post-transaction state root. Only specified for transactions included before the Byzantium upgrade.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "status": { + "description": "Either 1 (success) or 0 (failure). Only specified for transactions included after the Byzantium upgrade.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "enum": [ + "0x0", + "0x1" + ] + }, + "effectiveGasPrice": { + "description": "The actual value per gas deducted from the sender's account. Before EIP-1559, this is equal to the transaction's gas price. After, it is equal to baseFeePerGas + min(maxFeePerGas - baseFeePerGas, maxPriorityFeePerGas).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasPrice": { + "description": "The actual value per gas deducted from the sender's account for blob gas. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getTransactionReceipt example", + "params": [ + { + "name": "Transaction hash", + "value": "0xbb3a336e3f823ec18197f1e13ee875700f08f03e2cab75f0d0b118dabb44cba0" + } + ], + "result": { + "name": "Receipt information", + "value": { + "blockHash": "0x0a79eca9f5ca58a1d5d5030a0fabfdd8e815b8b77a9f223f74d59aa39596e1c7", + "blockNumber": "0x11e5883", + "contractAddress": null, + "cumulativeGasUsed": "0xc5f3e7", + "effectiveGasPrice": "0xa45b9a444", + "from": "0x690b9a9e9aa1c9db991c7721a92d351db4fac990", + "gasUsed": "0x565f", + "logs": [ + { + "address": "0x388c818ca8b9251b393131c08a736a67ccb19297", + "blockHash": "0x0a79eca9f5ca58a1d5d5030a0fabfdd8e815b8b77a9f223f74d59aa39596e1c7", + "blockNumber": "0x11e5883", + "data": "0x00000000000000000000000000000000000000000000000011b6b79503fb875d", + "logIndex": "0x187", + "removed": false, + "topics": [ + "0x27f12abfe35860a9a927b465bb3d4a9c23c8428174b83f278fe45ed7b4da2662" + ], + "transactionHash": "0x7114b4da1a6ed391d5d781447ed443733dcf2b508c515b81c17379dea8a3c9af", + "transactionIndex": "0x76" + } + ], + "logsBloom": "0x00000000000000000000000000000000000100004000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000", + "status": "0x1", + "to": "0x388c818ca8b9251b393131c08a736a67ccb19297", + "transactionHash": "0x7114b4da1a6ed391d5d781447ed443733dcf2b508c515b81c17379dea8a3c9af", + "transactionIndex": "0x76", + "type": "0x2" + } + } + } + ] + }, + { + "name": "eth_getUncleByBlockHashAndIndex", + "summary": "Returns information about an uncle of a block by block hash and index.", + "description": "Returns information about an uncle of a block given the block hash and the uncle index position.", + "params": [ + { + "name": "Block hash", + "required": true, + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "name": "Uncle index position", + "required": true, + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Uncle block information", + "description": "Uncle block object matching the given hash and index, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getUncleByBlockHashAndIndex example", + "params": [ + { + "name": "Block hash", + "value": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35" + }, + { + "name": "Uncle index position", + "value": "0x0" + } + ], + "result": { + "name": "Uncle block information", + "value": { + "difficulty": "0x57f117f5c", + "extraData": "0x476574682f76312e302e302f77696e646f77732f676f312e342e32", + "gasLimit": "0x1388", + "gasUsed": "0x0", + "hash": "0x932bdf904546a2287a2c9b2ede37925f698a7657484b172d4e5184f80bdd464d", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "miner": "0x5bf5e9cf9b456d6591073513de7fd69a9bef04bc", + "mixHash": "0x4500aa4ee2b3044a155252e35273770edeb2ab6f8cb19ca8e732771484462169", + "nonce": "0x24732773618192ac", + "number": "0x299", + "parentHash": "0xa779859b1ee558258b7008bbabff272280136c5dd3eb3ea3bfa8f6ae03bf91e5", + "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "size": "0x21d", + "stateRoot": "0x2604fbf5183f5360da249b51f1b9f1e0f315d2ff3ffa1a4143ff221ad9ca1fec", + "timestamp": "0x55ba4827", + "totalDifficulty": null, + "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "uncles": [] + } + } + } + ] + }, + { + "name": "eth_getUncleByBlockNumberAndIndex", + "summary": "Returns information about an uncle of a block by block number and index.", + "description": "Returns information about an uncle of a block given the block number and the uncle index position.", + "params": [ + { + "name": "Block", + "required": true, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + }, + { + "name": "Uncle index position", + "required": true, + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Uncle block information", + "description": "Uncle block object matching the given block number and index, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getUncleByBlockNumberAndIndex example", + "params": [ + { + "name": "Block", + "value": "0x29c" + }, + { + "name": "Uncle index position", + "value": "0x0" + } + ], + "result": { + "name": "Uncle block information", + "value": { + "difficulty": "0x57f117f5c", + "extraData": "0x476574682f76312e302e302f77696e646f77732f676f312e342e32", + "gasLimit": "0x1388", + "gasUsed": "0x0", + "hash": "0x932bdf904546a2287a2c9b2ede37925f698a7657484b172d4e5184f80bdd464d", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "miner": "0x5bf5e9cf9b456d6591073513de7fd69a9bef04bc", + "mixHash": "0x4500aa4ee2b3044a155252e35273770edeb2ab6f8cb19ca8e732771484462169", + "nonce": "0x24732773618192ac", + "number": "0x299", + "parentHash": "0xa779859b1ee558258b7008bbabff272280136c5dd3eb3ea3bfa8f6ae03bf91e5", + "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "size": "0x21d", + "stateRoot": "0x2604fbf5183f5360da249b51f1b9f1e0f315d2ff3ffa1a4143ff221ad9ca1fec", + "timestamp": "0x55ba4827", + "totalDifficulty": null, + "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "uncles": [] + } + } + } + ] + }, + { + "name": "eth_getUncleCountByBlockHash", + "summary": "Returns the number of uncles in a block by block hash.", + "description": "Returns the number of uncles in a block from a block matching the given block hash.", + "params": [ + { + "name": "Block hash", + "required": true, + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Uncle count", + "description": "Hexadecimal uncle count in the block, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Uncle count" + } + ] + } + }, + "examples": [ + { + "name": "eth_getUncleCountByBlockHash example", + "params": [ + { + "name": "Block hash", + "value": "0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35" + } + ], + "result": { + "name": "Uncle count", + "value": "0x1" + } + } + ] + }, + { + "name": "eth_getUncleCountByBlockNumber", + "summary": "Returns the number of uncles in a block by block number.", + "description": "Returns the number of uncles in a block from a block matching the given block number.", + "params": [ + { + "name": "Block", + "required": true, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Uncle count", + "description": "Hexadecimal uncle count in the block, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Uncle count" + } + ] + } + }, + "examples": [ + { + "name": "eth_getUncleCountByBlockNumber example", + "params": [ + { + "name": "Block", + "value": "0x5bad55" + } + ], + "result": { + "name": "Uncle count", + "value": "0x1" + } + } + ] + }, + { + "name": "eth_maxPriorityFeePerGas", + "description": "Returns an estimate of how much priority fee, in wei, you need to be included in a block.", + "summary": "Returns the current maxPriorityFeePerGas per gas in wei.", + "params": [], + "result": { + "name": "Max priority fee per gas", + "description": "Estimated priority fee per gas, in wei, represented as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Max priority fee per gas" + } + }, + "examples": [ + { + "name": "eth_maxPriorityFeePerGas example", + "params": [], + "result": { + "name": "Max priority fee per gas", + "value": "0x55d4a80" + } + } + ] + }, + { + "name": "eth_newBlockFilter", + "summary": "Creates a filter in the node, to notify when a new block arrives.", + "description": "Creates a filter that triggers when a new block is added to the chain. Use `eth_getFilterChanges` to poll; filters expire after 15 minutes of inactivity.", + "params": [], + "result": { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` of the newly created filter.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_newBlockFilter example", + "params": [], + "result": { + "name": "Filter identifier", + "value": "0x01" + } + } + ] + }, + { + "name": "eth_newFilter", + "summary": "Creates a filter object, based on filter options, to notify when the state changes (logs).", + "description": "Creates a filter object with configurable options (`address`, `fromBlock`, `toBlock`, `topics`) that notifies when matching logs are produced. Filters that are not polled using `eth_getFilterChanges` automatically expire after 15 minutes of inactivity. Filter IDs can be polled by any connection using the same API key.", + "params": [ + { + "name": "Filter", + "description": "Filter object defining log criteria (address, block range, topics).", + "schema": { + "type": "object", + "additionalProperties": false, + "properties": { + "fromBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "toBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "address": { + "description": "A contract address or a list of addresses from which logs should originate.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "address": null, + "title": "Single address" + }, + { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "addresses": null, + "title": "List of addresses" + } + ] + }, + "topics": { + "description": "An array of 32 bytes DATA topics. Topics are order-dependent. `null` (empty array) provides any topic match.", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ], + "result": { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` of the newly created filter.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_newFilter example", + "params": [ + { + "name": "Filter", + "value": { + "topics": [ + "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef" + ] + } + } + ], + "result": { + "name": "Filter identifier", + "value": "0x01" + } + } + ] + }, + { + "name": "eth_protocolVersion", + "summary": "Returns the current Ethereum protocol version.", + "description": "Returns the current Ethereum protocol version.", + "params": [], + "result": { + "name": "Protocol version", + "description": "Hexadecimal representation of the current protocol version.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_protocolVersion example", + "params": [], + "result": { + "name": "Protocol version", + "value": "0x41" + } + } + ] + }, + { + "name": "eth_sendRawTransaction", + "summary": "Submits a raw transaction.", + "description": "You can create and sign a transaction externally using a library such as [web3.js](https://web3js.readthedocs.io/) or [ethers.js](https://docs.ethers.org/).\nFor [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844) transactions, the raw form must be the network form. This means it includes the blobs, KZG commitments, and KZG proofs.\nSubmits a pre-signed transaction for broadcast to the Ethereum network.\n", + "params": [ + { + "name": "Transaction", + "description": "Signed transaction data.", + "required": true, + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + ], + "result": { + "name": "Transaction hash", + "description": "32-byte hash of the broadcast transaction, or the zero hash if not yet available.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "examples": [ + { + "name": "eth_sendRawTransaction example", + "params": [ + { + "name": "Transaction", + "value": "0xf869018203e882520894f17f52151ebef6c7334fad080c5704d77216b732881bc16d674ec80000801ba02da1c48b670996dcb1f447ef9ef00b33033c48a4fe938f420bec3e56bfd24071a062e0aa78a81bf0290afbc3a9d8e9a068e6d74caa66c5e0fa8a46deaae96b0833" + } + ], + "result": { + "name": "Transaction hash", + "value": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331" + } + } + ] + }, + { + "name": "eth_subscribe", + "summary": "Creates a new subscription.", + "description": "Creates a new subscription for particular events. The node returns a subscription ID. For each event that matches the subscription, a notification with relevant data is sent together with the subscription ID.\nWe strongly recommend specifying a filter (`address` or `topics` or both) when subscribing to the `logs` event.\n", + "params": [ + { + "name": "Event", + "required": true, + "schema": { + "oneOf": [ + { + "title": "newHeads", + "type": "string", + "const": "newHeads", + "description": "Subscribing to this returns a notification each time a new header is appended to the chain, including chain reorganizations. In a chain reorganization, the subscription emits all new headers for the new chain. Therefore the subscription can emit multiple headers at the same height." + }, + { + "title": "logs", + "type": "object", + "description": "Returns logs that are included in new imported blocks and match the given filter criteria. In case of a chain reorganization, previously sent logs that are on the old chain are resent with the removed property set to true. Logs from transactions that ended up in the new chain are emitted. Therefore a subscription can emit logs for the same transaction multiple times. This parameter has the following fields.", + "additionalProperties": false, + "properties": { + "address": { + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Single address" + }, + { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "title": "Addresses" + } + ], + "description": "Either an address or an array of addresses. Only logs that are created from these addresses are returned." + }, + "topics": { + "description": "Only logs which match the specified topics (optional).", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + { + "title": "newPendingTransactions", + "type": "string", + "const": "newPendingTransactions", + "description": "Returns the hash for all transactions that are added to the pending state and are signed with a key that's available in the node. When a transaction that was previously part of the canonical chain isn't part of the new canonical chain after a reorganization, it's emitted again." + } + ] + } + } + ], + "result": { + "name": "Subscription ID", + "description": "The ID of the newly created subscription on the node.", + "schema": { + "type": "string" + } + }, + "examples": [ + { + "name": "eth_subscribe example", + "params": [ + { + "name": "Event", + "value": "newHeads" + } + ], + "result": { + "name": "Subscription ID", + "value": "0x9cef478923ff08bf67fde6c64013158d" + } + } + ] + }, + { + "name": "eth_syncing", + "summary": "Returns an object with data about the sync status or false.", + "description": "Returns an object with data about the sync status or `false`.", + "params": [], + "result": { + "name": "Syncing status", + "description": "`false` when not syncing, or an object describing the current sync progress.", + "schema": { + "oneOf": [ + { + "title": "Syncing disabled", + "description": "Client is fully synced.", + "type": "boolean", + "const": false + }, + { + "title": "Sync progress", + "type": "object", + "required": [ + "startingBlock", + "currentBlock", + "highestBlock" + ], + "additionalProperties": false, + "properties": { + "startingBlock": { + "description": "Hexadecimal block number at which the sync started.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "currentBlock": { + "description": "Hexadecimal current block, same as `eth_blockNumber`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "highestBlock": { + "description": "Hexadecimal highest block the client is aware of.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_syncing example", + "params": [], + "result": { + "name": "Syncing status", + "value": false + } + } + ] + }, + { + "name": "eth_uninstallFilter", + "summary": "Uninstalls a filter with given id.", + "description": "Removes the filter referenced by the given identifier and frees associated resources.", + "params": [ + { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` previously returned by a filter-creation method.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Success", + "description": "`true` if the filter was successfully uninstalled; otherwise `false`.", + "schema": { + "type": "boolean" + } + }, + "examples": [ + { + "name": "eth_uninstallFilter example", + "params": [ + { + "name": "Filter identifier", + "value": "0x10ff0bfba9472c87932c56632eef8f5cc70910e8e71d" + } + ], + "result": { + "name": "Success", + "value": true + } + } + ] + }, + { + "name": "eth_unsubscribe", + "summary": "Cancels a subscription.", + "description": "Cancel subscriptions by calling this method with the subscription ID. It returns a boolean indicating that the subscription was canceled successfully.", + "params": [ + { + "name": "Subscription ID", + "required": true, + "schema": { + "type": "string" + } + } + ], + "result": { + "name": "Unsubscribed flag", + "description": "`true` if the subscription is canceled successfully.", + "schema": { + "type": "boolean" + } + }, + "examples": [ + { + "name": "eth_unsubscribe example", + "params": [ + { + "name": "Subscription ID", + "value": "0x9cef478923ff08bf67fde6c64013158d" + } + ], + "result": { + "name": "Unsubscribed flag", + "value": true + } + } + ] + }, + { + "name": "net_peerCount", + "summary": "Returns the number of peers currently connected to the client.", + "description": "Returns the number of peers currently connected to the client.", + "params": [], + "result": { + "name": "Peer count", + "description": "Number of peers currently connected, as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "net_peerCount example", + "params": [], + "result": { + "name": "Peer count", + "value": "0x64" + } + } + ] + }, + { + "name": "net_version", + "summary": "Returns the current network ID.", + "description": "Returns the current network ID.", + "params": [], + "result": { + "name": "Network ID", + "description": "Network ID as a decimal string.", + "schema": { + "type": "string" + } + }, + "examples": [ + { + "name": "net_version example", + "params": [], + "result": { + "name": "Network ID", + "value": "1" + } + } + ] + }, + { + "name": "web3_clientVersion", + "summary": "Returns the current client version.", + "description": "Returns the current client version.", + "params": [], + "result": { + "name": "Client version", + "description": "Client version string including the software name and version.", + "schema": { + "type": "string" + } + }, + "examples": [ + { + "name": "web3_clientVersion example", + "params": [], + "result": { + "name": "Client version", + "value": "Geth/v1.11.6-omnibus-f83e1598/linux-.mdx64/go1.20.3" + } + } + ] + } + ], + "components": { + "schemas": { + "JsonRpc": { + "value": "2.0", + "description": "The JSON-RPC protocol version." + }, + "Id": { + "description": "Your identifier for the request, echoed back in the response.", + "example": 1 + }, + "Method": { + "description": "Identifier for the RPC request, pass method name.", + "type": "string" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "addresses": { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + "byte": { + "description": "Hex-encoded byte.", + "type": "string", + "pattern": "^0x([0-9a-fA-F]?){1,2}$" + }, + "bytes": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "bytesMax32": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + }, + "bytes8": { + "description": "8 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "bytes32": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "bytes48": { + "description": "48 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{96}$" + }, + "bytes96": { + "description": "96 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{192}$" + }, + "bytes256": { + "description": "256 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "bytes65": { + "description": "65 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{130}$" + }, + "hash32": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "notFound": { + "description": "Not Found (null).", + "type": "null" + }, + "ratio": { + "description": "Normalized ratio.", + "type": "number", + "minimum": 0, + "maximum": 1 + }, + "uint": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "uint64": { + "description": "Hex-encoded 64 bit unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "uint256": { + "description": "Hex-encoded 256 bit unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "BadBlock": { + "description": "Bad block.", + "type": "object", + "required": [ + "block", + "hash", + "rlp" + ], + "additionalProperties": false, + "properties": { + "block": { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "allOf": [ + { + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + ], + "title": "Signed transaction" + } + ] + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "hash": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "rlp": { + "description": "RLP (Recursive Length Prefix); method used to serialize blocks, transactions, and other data in a compact, hex- and byte-encoded format.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "Block": { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "allOf": [ + { + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + ], + "title": "Signed transaction" + } + ] + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "BlockNumberOrTag": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "BlockNumberOrTagOrHash": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + }, + "BlockTag": { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Descriptor of block by status. See the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block).\n - `earliest`: The lowest numbered block the client has available.\n - `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination. \n - `safe`: The most recent block that's safe from re-orgs under honest majority and certain synchronicity assumptions. \n - `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the\n canonical chain even under healthy/normal conditions. \n - `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. \n" + }, + "SyncingStatus": { + "oneOf": [ + { + "title": "Syncing", + "description": "Syncing progress.", + "type": "object", + "additionalProperties": false, + "properties": { + "startingBlock": { + "description": "A hexadecimal equivalent of the integer indicating the block at which the import started (will only be reset after the sync reaches the head).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "currentBlock": { + "description": "Block number as hex-encoded unsigned integer indicating the current block syncing data, same as `eth_blockNumber`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "highestBlock": { + "description": "Block number as hex-encoded unsigned integer indicating the highest block syncing data.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "title": "Not syncing", + "description": "Should always return false if not syncing.", + "type": "boolean", + "example": true + } + ] + }, + "FilterResults": { + "oneOf": [ + { + "title": "New block or transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "New logs", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ] + }, + "Filter": { + "type": "object", + "additionalProperties": false, + "properties": { + "fromBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "toBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "address": { + "description": "A contract address or a list of addresses from which logs should originate.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "address": null, + "title": "Single address" + }, + { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "addresses": null, + "title": "List of addresses" + } + ] + }, + "topics": { + "description": "An array of 32 bytes DATA topics. Topics are order-dependent. `null` (empty array) provides any topic match.", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "Log": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "ReceiptInfo": { + "type": "object", + "required": [ + "blockHash", + "blockNumber", + "from", + "cumulativeGasUsed", + "gasUsed", + "logs", + "logsBloom", + "transactionHash", + "transactionIndex", + "effectiveGasPrice" + ], + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte.", + "type": "string", + "pattern": "^0x([0-9a-fA-F]?){1,2}$" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Address of the call initiator.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "Address of the receiver or null in a contract creation transaction.", + "oneOf": [ + { + "title": "Contract Creation (null)", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Recipient Address" + } + ] + }, + "cumulativeGasUsed": { + "description": "The sum of gas used by this transaction and all preceding transactions in the same block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "The amount of gas used for this specific transaction alone.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasUsed": { + "description": "The amount of blob gas used for this specific transaction. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "contractAddress": { + "description": "The contract address created, if the transaction was a contract creation, otherwise null.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + }, + { + "title": "No data", + "type": "null" + } + ] + }, + "logs": { + "description": "Logs.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "logsBloom": { + "description": "Logs bloom.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "root": { + "description": "The post-transaction state root. Only specified for transactions included before the Byzantium upgrade.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "status": { + "description": "Either 1 (success) or 0 (failure). Only specified for transactions included after the Byzantium upgrade.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "enum": [ + "0x0", + "0x1" + ] + }, + "effectiveGasPrice": { + "description": "The actual value per gas deducted from the sender's account. Before EIP-1559, this is equal to the transaction's gas price. After, it is equal to baseFeePerGas + min(maxFeePerGas - baseFeePerGas, maxPriorityFeePerGas).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasPrice": { + "description": "The actual value per gas deducted from the sender's account for blob gas. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "AccountProof": { + "type": "object", + "required": [ + "address", + "accountProof", + "balanceeth_getBalance", + "codeHash", + "nonce", + "storageHash", + "storageProof" + ], + "additionalProperties": false, + "properties": { + "address": { + "description": "The account address for which the Merkle proof is retrieved. This is an echo of the address passed in the request.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "accountProof": { + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `stateRoot`-Node, following the path of the address as key.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "balance": { + "description": "Hexadecimal of the balance in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "codeHash": { + "description": "The 32-byte hash of the account's code. For EOAs, this will be the hash of an empty string. For contract accounts, it represents the hash of the deployed contract code.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "storageHash": { + "description": "32-byte SHA3 hash of the storage root. All storage will deliver a Merkle proof starting with this root hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "storageProof": { + "description": "An array of requested storage-entries.", + "type": "array", + "items": { + "type": "object", + "required": [ + "key", + "value", + "proof" + ], + "additionalProperties": false, + "properties": { + "key": { + "description": "The requested storage key.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + }, + "value": { + "description": "The storage value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "proof": { + "type": "array", + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `storageHash` node and following the path of the key.", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + } + } + } + } + }, + "StorageProof": { + "type": "object", + "required": [ + "key", + "value", + "proof" + ], + "additionalProperties": false, + "properties": { + "key": { + "description": "The requested storage key.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + }, + "value": { + "description": "The storage value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "proof": { + "type": "array", + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `storageHash` node and following the path of the key.", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + } + }, + "Transaction4844Unsigned": { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "AccessListEntry": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "AccessList": { + "description": "Access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "GenericTransaction": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "Transaction1559Unsigned": { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "Transaction2930Unsigned": { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "TransactionLegacyUnsigned": { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "TransactionUnsigned": { + "oneOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 transaction" + }, + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned legacy transaction" + } + ] + }, + "Transaction4844Signed": { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + "Transaction1559Signed": { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + "Transaction2930Signed": { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + "TransactionLegacySigned": { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + "TransactionSigned": { + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + ] + }, + "TransactionInfo": { + "type": "object", + "description": "Transaction information.", + "allOf": [ + { + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + ], + "title": "Signed transaction" + } + ] + }, + "TxType": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "Withdrawal": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "tags": { + "Archive": { + "name": "Archive", + "description": "Served by an archive node." + }, + "Bespoke": { + "name": "Bespoke", + "description": "Custom APIs built for specific clients or highly specialized use cases or clients; not available as standard EVM or MetaMask methods.\n" + }, + "Besu": { + "name": "Besu", + "description": "Served by a Besu node." + }, + "OpenBeta": { + "name": "Beta", + "description": "Available as a beta version; use at your own risk." + }, + "CustomPlan": { + "name": "Custom plan", + "description": "Infura's advanced API methods offered through custom arrangements." + }, + "Deprecated": { + "name": "Deprecated", + "description": "Deprecated methods." + }, + "DINParther": { + "name": "DIN", + "description": "Infura's DIN partners support the network." + }, + "Ethereum": { + "name": "EVM", + "description": "Ethereum execution API methods. These methods cover basic transaction calls, block information, and account management available in Ethereum's [`execution-apis`](https://github.com/ethereum/execution-apis/) repository.\nThese are standard Ethereum JSON-RPC API methods. See the [Ethereum wiki](https://eth.wiki/json-rpc/API#json-rpc-methods) for more information about these methods.\"\n" + }, + "Experimental": { + "name": "Experimental", + "description": "Publicly available but may not be stable or fully supported; experimental. Methods may have limited support and could change or be deprecated. Users are advised to use these at their own risk." + }, + "Geth": { + "name": "Geth", + "description": "Served by a Geth node." + }, + "Internal": { + "name": "Internal", + "description": "Not available to public." + }, + "MetaMask": { + "name": "MetaMask", + "description": "MetaMask-specific methods." + }, + "PaidPlan": { + "name": "Paid plan", + "description": "Infura's paid plans giving access to advanced API methods that offer extended functionality such as access to archive data, IPFS gateway, and specialized performance optimizations." + }, + "WSS": { + "name": "WebSocket", + "description": "WebSocket requests are supported in Linea via a virtualization service. An alternative, dedicated URL must be applied." + } + } + } +} \ No newline at end of file diff --git a/src/specs/ethereum/openrpc.json b/src/specs/ethereum/openrpc.json new file mode 100644 index 00000000000..a9f81d9bcb1 --- /dev/null +++ b/src/specs/ethereum/openrpc.json @@ -0,0 +1,21290 @@ +{ + "openrpc": "1.2.4", + "info": { + "title": "Ethereum JSON-RPC Specification", + "description": "A specification of the standard interface for Ethereum clients.", + "version": "0.0.0", + "license": { + "name": "CC0-1.0", + "url": "https://creativecommons.org/publicdomain/zero/1.0/legalcode" + } + }, + "servers": [ + { + "url": "https://mainnet.infura.io/v3/", + "name": "Ethereum mainnet" + } + ], + "methods": [ + { + "name": "debug_getBadBlocks", + "summary": "Returns an array of recent bad blocks that the client has seen on the network.", + "params": [], + "result": { + "name": "Blocks", + "schema": { + "title": "Bad block array", + "type": "array", + "items": { + "description": "Bad block.", + "type": "object", + "required": [ + "block", + "hash", + "rlp" + ], + "additionalProperties": false, + "properties": { + "block": { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "hash": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "rlp": { + "description": "RLP (Recursive Length Prefix); method used to serialize blocks, transactions, and other data in a compact, hex- and byte-encoded format.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + } + } + }, + "examples": [ + { + "name": "debug_getBadBlocks example", + "params": [], + "result": { + "name": "Bad block array", + "value": [ + { + "block": { + "number": "0xd", + "hash": "0x85c2edc1ca74b4863cab46ff6ed4df514a698aa7c29a9bce58742a33af07d7e6", + "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000", + "parentHash": "0x544a2f7a4c8defc0d8da44aa0c0db7c36b56db2605c01ed266e919e936579d31", + "nonce": "0x0000000000000000", + "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "transactionsRoot": "0x02c387e001cbe2a8296bfa2e18afbc3480d0e49588b05556148b0bf7c17dec41", + "stateRoot": "0x861ab7e868e3c23f84b7c4ed86b52a6a4f063633bc45ef29212c33459df84ea5", + "receiptsRoot": "0xccd2d33763dc0ac3fe02d4ecbbcd7d2bdc6f57db635ba31007184679303721d7", + "miner": "0x0000000000000000000000000000000000000000", + "difficulty": "0x1", + "totalDifficulty": "0x1", + "extraData": "0x00000000000000000000000000000000000000000000000000000000000000008c6a091f07e4ba3930f2f5fabbfc5b1c70986319096760ba200a6abc0d30e33c2d501702d1b58d7f75807bdbf981044557628611319121170b96466ec06bb3fd01", + "size": "0x3a0", + "gasLimit": "0xffffffffffff", + "gasUsed": "0x1a488", + "timestamp": "0x5f5b6824", + "uncles": [], + "transactions": [ + { + "blockHash": "0x85c2edc1ca74b4863cab46ff6ed4df514a698aa7c29a9bce58742a33af07d7e6", + "blockNumber": "0xd", + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0x1a49e", + "gasPrice": "0x3e8", + "hash": "0xdd8cf045113754c306ba9ac8ac8786235e33bc5c087678084ef260a2a583f127", + "input": "0x608060405234801561001057600080fd5b5060c78061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060325760003560e01c80636057361d146037578063b05784b8146062575b600080fd5b606060048036036020811015604b57600080fd5b8101908080359060200190929190505050607e565b005b60686088565b6040518082815260200191505060405180910390f35b8060008190555050565b6000805490509056fea26469706673582212208dea039245bf78c381278382d7056eef5083f7d243d8958817ef447e0a403bd064736f6c63430006060033", + "nonce": "0x0", + "to": null, + "transactionIndex": "0x0", + "value": "0x0", + "v": "0xf9d", + "r": "0xa7a15050302ca4b7d3842d35cdd3cbf25b2c48c0c37f96d78beb6a6a6bc4f1c7", + "s": "0x130d29294b2b6a2b7e89f501eb27772f7abf37bfa28a1ce300daade975589fca" + } + ] + }, + "hash": "0x85c2edc1ca74b4863cab46ff6ed4df514a698aa7c29a9bce58742a33af07d7e6", + "rlp": "0xf9039df9025ca0544a2f7a4c8defc0d8da44aa0c0db7c36b56db2605c01ed266e919e936579d31a01dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347940000000000000000000000000000000000000000a0861ab7e868e3c23f84b7c4ed86b52a6a4f063633bc45ef29212c33459df84ea5a002c387e001cbe2a8296bfa2e18afbc3480d0e49588b05556148b0bf7c17dec41a0ccd2d33763dc0ac3fe02d4ecbbcd7d2bdc6f57db635ba31007184679303721d7b9010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010d86ffffffffffff8301a488845f5b6824b86100000000000000000000000000000000000000000000000000000000000000008c6a091f07e4ba3930f2f5fabbfc5b1c70986319096760ba200a6abc0d30e33c2d501702d1b58d7f75807bdbf981044557628611319121170b96466ec06bb3fd01a00000000000000000000000000000000000000000000000000000000000000000880000000000000000f9013af90137808203e88301a49e8080b8e6608060405234801561001057600080fd5b5060c78061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060325760003560e01c80636057361d146037578063b05784b8146062575b600080fd5b606060048036036020811015604b57600080fd5b8101908080359060200190929190505050607e565b005b60686088565b6040518082815260200191505060405180910390f35b8060008190555050565b6000805490509056fea26469706673582212208dea039245bf78c381278382d7056eef5083f7d243d8958817ef447e0a403bd064736f6c63430006060033820f9da0a7a15050302ca4b7d3842d35cdd3cbf25b2c48c0c37f96d78beb6a6a6bc4f1c7a0130d29294b2b6a2b7e89f501eb27772f7abf37bfa28a1ce300daade975589fcac0" + }, + { + "block": { + "number": "0x8", + "hash": "0x601a3ae9b6eceb2476d249e1cffe058ba3ff2c9c1b28b1ec7a0259fdd1d90121", + "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000", + "parentHash": "0x98ae440cd7b904d842daa6c263608969a3c8ce6a9acd6bd1f99b394f5f28a207", + "nonce": "0x0000000000000000", + "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "transactionsRoot": "0x8ee998cc699a1f9310a1079458780b3ebee8756f96a0905f5224b89d0eb17486", + "stateRoot": "0x140a9783291704223eb759e3a0db5471a520d349fc17ac2f77ff8582472e3bac", + "receiptsRoot": "0x2b5c77f6e7764d2468178fab7253346b9b8bb6a34b63946f6bdc2f5ad398bfc3", + "miner": "0x0000000000000000000000000000000000000000", + "difficulty": "0x2", + "totalDifficulty": "0x2", + "extraData": "0x00000000000000000000000000000000000000000000000000000000000000004d04551bdd9ae08af1fd661e49d4ab662c98c532c7ec0e4656a27e4de7d330af578ab1e4f5e49e085ff1d78673c7388ed9ccf017fbe89e53066bfa4018142c0701", + "size": "0x3a0", + "gasLimit": "0xffffffffffff", + "gasUsed": "0x1a4c9", + "timestamp": "0x5f5b6b80", + "uncles": [], + "transactions": [ + { + "blockHash": "0x601a3ae9b6eceb2476d249e1cffe058ba3ff2c9c1b28b1ec7a0259fdd1d90121", + "blockNumber": "0x8", + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0x1a4c9", + "gasPrice": "0x3e8", + "hash": "0x675e336a4281b29c619dfd4ccfbd2f930f3728b20caf9e0067284aa3224e6758", + "input": "0x608060405234801561001057600080fd5b5060c78061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060325760003560e01c80636057361d146037578063b05784b8146062575b600080fd5b606060048036036020811015604b57600080fd5b8101908080359060200190929190505050607e565b005b60686088565b6040518082815260200191505060405180910390f35b8060008190555050565b6000805490509056fea26469706673582212208dea039245bf78c381278382d7056eef5083f7d243d8958817ef447e0a403bd064736f6c63430006060033", + "nonce": "0x0", + "to": null, + "transactionIndex": "0x0", + "value": "0x0", + "v": "0xf9d", + "r": "0x2e30624c0305e64812e1d9e325ba6e50410314634b008edcb50f45be71fa0d4", + "s": "0x50e205faed23c219ba15610de2451d458cbd4221207b2168344cfc972a7973c0" + } + ] + }, + "hash": "0x601a3ae9b6eceb2476d249e1cffe058ba3ff2c9c1b28b1ec7a0259fdd1d90121", + "rlp": "0xf9039df9025ca098ae440cd7b904d842daa6c263608969a3c8ce6a9acd6bd1f99b394f5f28a207a01dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347940000000000000000000000000000000000000000a0140a9783291704223eb759e3a0db5471a520d349fc17ac2f77ff8582472e3baca08ee998cc699a1f9310a1079458780b3ebee8756f96a0905f5224b89d0eb17486a02b5c77f6e7764d2468178fab7253346b9b8bb6a34b63946f6bdc2f5ad398bfc3b9010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020886ffffffffffff8301a4c9845f5b6b80b86100000000000000000000000000000000000000000000000000000000000000004d04551bdd9ae08af1fd661e49d4ab662c98c532c7ec0e4656a27e4de7d330af578ab1e4f5e49e085ff1d78673c7388ed9ccf017fbe89e53066bfa4018142c0701a00000000000000000000000000000000000000000000000000000000000000000880000000000000000f9013af90137808203e88301a4c98080b8e6608060405234801561001057600080fd5b5060c78061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060325760003560e01c80636057361d146037578063b05784b8146062575b600080fd5b606060048036036020811015604b57600080fd5b8101908080359060200190929190505050607e565b005b60686088565b6040518082815260200191505060405180910390f35b8060008190555050565b6000805490509056fea26469706673582212208dea039245bf78c381278382d7056eef5083f7d243d8958817ef447e0a403bd064736f6c63430006060033820f9da002e30624c0305e64812e1d9e325ba6e50410314634b008edcb50f45be71fa0d4a050e205faed23c219ba15610de2451d458cbd4221207b2168344cfc972a7973c0c0" + } + ] + } + } + ] + }, + { + "name": "debug_getRawBlock", + "summary": "Returns an RLP-encoded block.", + "params": [ + { + "name": "Block", + "required": true, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Block RLP", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "examples": [ + { + "name": "debug_getRawBlock example", + "params": [ + { + "name": "Block", + "value": "0x32026E" + } + ], + "result": { + "name": "Block RLP", + "value": "0xf96096f90236a09f73691f6dabca4f0a99b05d0a701995506aa311dcaa9ce9833d6f4ca474c162a01dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d4934794c6e2459991bfe27cca6d86722f35da23a1e4cb97a078103ea8c47231886481d72ec1afae6eeb06c3773ce24a91323d5c9eed69d4cca0008992da2531db404f07b0871dd620a94ba346963e1b1c6dc7b00748e8593a1ea0b6c3890d9604434fc52f722848c84d1770add20cd75bbc28cdedff42940dbb56b90100200800000400000002000e0000000401000000440100000000c0400600000002000801000000040480020840048000000000400000000000000020004220000011002000000000000204000800000010010002000002000000000040a000000000000400020000010885000000000808000000008800001004002010020300005000000010002110410402000000000000000890000008000000000000000000020040000002000000000000810400000040006000004000004080020000000000000022001000000000000840400000000220250000000000080402000420000418000000000000000400040000004080040010200000000000108020020000808332026e8401c9c380833e3c3c846436f93899d883010b05846765746888676f312e32302e32856c696e7578a0112d8f15793e7df7f8dcdb21c891cff78c0d1839cb5b6dcd06116cdbb99536ae88000000000000000008a0cdb97712af6685bb9650d21d609525913293c48adda7c45990926daada335c9bf95c56f8ac82d51f8502540be4008303c9e294a68d4c1e3de1b721ad1356bbf827d6bc8cef304f80b844b1bb4d351300dbc7e12342566318001b83aefc9f20080000f3ef25472407fe9c9c69a1470000000242692bb4cd506c409651ab80eb3acfa54551d3dbc9af4493605d79871ba01e474fb147b16b9538d7a59a57738e406158d9cc306a9062b1b7a9f544c35abfa061aabb714c760f2243a16a024811679d402c8822e8b25dfd0038d84298fb5205b87502f87283aa36a754849502f900849502f9108302222794102554afa6b5dbccc86176faef2b2d854201756e8084e2bc7b43c001a04f2398f24bc950db1f5439de3cf6431ea277236595ae8dc5815c0cc671c9f97ca029898786a59c56f086fc0f7a16859f366cf46084add999fe137cbf43693712e8b87c02f87983aa36a7830293748459682f00850165a0bc008255f094fafb56bb5b37c3b0b0ee9d7c31f018aac91dfb778806f05b59d3b2000080c080a0b069dd8967533a773e592c26b1b36df0793d0b9f6eceba34da246f602c2fae58a002009dab32ab63a25b705d9a00e311f7cd5d85e73f9b2c03ffd0e5135c0bb2c6b89502f89283aa36a7018459682f008459682f0983011fec945b9fedd37f0b92e7e282b19cebcf06f57b77c60480a46a62784200000000000000000000000019a1fcc6fcc5832cd2db7704d75efbc800f5a742c001a0c65eb0e48090a8f8830de47f430b9ad11071a62a5db9555619a990d7e9b81738a05a6e826610a5b2ee529a22942ebcd3abd2a8a10228098c8158380e8fcceb962fb9028002f9027c83aa36a7178459682f008459682f0983017ac9942ab7c0ab9ab47fcf370d13058bfee28f2ec0940c880169964394fc8860b9020496e17852000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000010000000000000000000000003aa4d7eb55ec2539f5305eb27ea42f6f90f168270000000000000000000000000000000000000000000000000000000000aa36a70000000000000000000000000000000000000000000000000000000000028c5c0000000000000000000000003aa4d7eb55ec2539f5305eb27ea42f6f90f168270000000000000000000000003aa4d7eb55ec2539f5305eb27ea42f6f90f168270000000000000000000000003aa4d7eb55ec2539f5305eb27ea42f6f90f16827000000000000000000000000000000000000000000000000016345785d8a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000650cb3772886000000000000000000000000000000000000000000000000000000000000222e000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000001c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c080a004f8666c8e5d0f3c7110994f624d24aa47a1327814289698c3e2777284a5cfdca04ff05f1b8c5beb58972d40e5a7b894d5e28ad2f15a3429c7d2bee6b6a9633730b9019f02f9019b83aa36a70b8459682f008459682f098303644f944284890d4acd0bcb017ece481b96fd4cb457cac88715c0f4db6e0ea0b90124ee1490b20000000000000000000000000000000000000000000000000000000000028c5c0000000000000000000000007847f2e0262512206333ffb200f6d9df2da319d40000000000000000000000001e8c104d068f22d351859cdbfe41a697a98e6ea20000000000000000000000000000000000000000000000000de0b6b3a764000000000000000000000000000000000000000000000000000000000000000222e00000000000000000000000000000000000000000000000000015c0f4db6e0ea00000000000000000000000007847f2e0262512206333ffb200f6d9df2da319d400000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000c080a0e5270f6291acc162885656bedf64fbcb904c41951221dc0cbbbdca03bb33ce43a01f08c7ed3c231403b55f37a157d80e121b653baa810add8c02aea722631450dcb87c02f87983aa36a7830293758459682f00850165a0bc008255f0948d247f4fbbe81429d3d164a5c9ae0063210edbdc8806f05b59d3b2000080c080a0bb83dd6181c9a7ae3069af3bdf1820b5e556eaf99e385b8d7b3571321fb2966ba02ac193773704524adcd02824796df83407a42cdd81e786b591eba43c4ffc6c40b9028002f9027c83aa36a7048459682f008459682f0983017ac9942ab7c0ab9ab47fcf370d13058bfee28f2ec0940c880169964394fc8860b9020496e178520000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000062d23ed77d0e5d0205edabe4ce3a27adc49ac6790000000000000000000000000000000000000000000000000000000000aa36a70000000000000000000000000000000000000000000000000000000000028c5c00000000000000000000000062d23ed77d0e5d0205edabe4ce3a27adc49ac67900000000000000000000000062d23ed77d0e5d0205edabe4ce3a27adc49ac67900000000000000000000000062d23ed77d0e5d0205edabe4ce3a27adc49ac679000000000000000000000000000000000000000000000000016345785d8a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000650cb3772886000000000000000000000000000000000000000000000000000000000000222e000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000001c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c001a0fc882968005f717a74a2c2fb345f691091cab084f4bd3934358741807bd5a66ea03f81c68d05d06bf851a6ef5ea6874557a221cbadde24f3fa51f777699b5d2804b8d802f8d583aa36a7822c0b8459682f008459682f098303534f943367dfa11e3148a07c2da773e1f65b155b0abe5680b864ad58bdd100000000000000000000000053844f9577c2334e541aec7df7174ece5df1fcf0000000000000000000000000e9e12c660e77a732940bab3c2cf385c843b834b800000000000000000000000000000000000000000006015d637c177581800000c001a0a292e7723d3c950aa8a557bd91dece34ec527d9efe2cc413d582dcd9fc6bf6eba03386ce6f58e862f329946bf32897f7df5d1c8f818fecfafc1223052fb251d97eb8b602f8b383aa36a7138459682f008459682f09832dc6c094ba175fdab00e7fcf603f43be8f68db7f4de9f3a980b844095ea7b300000000000000000000000084a0cc1ab353da6b7817947f7b116b8ea982c3d20000000000000000000000000000000000000000000000068f365aea1e440000c001a0968ed0274829918071d9cef28e1adbf1fd15ec76e5a4f809971e887b4c9f34b6a001ce26485bc7e3ea71fb99866bd43002b264b2ed80e10850203c2f07b78856bdb87c02f87983aa36a7830293768459682f00850165a0bc008255f0946d3b93db4e4078cf6541a68532d00705d9a4da618806f05b59d3b2000080c080a083c831630788e7ee57c87128d18582e29aa51f1f233e91d916c06d0750578156a0549b5a00477f3fb4d8fbf95ba3a636c3a14ff011c1bbf3a717e00d61735cbf34b87c02f87983aa36a7830293778459682f00850165a0bc008255f0940d3a7d69859a0dd6971d39703b15379e05ae2ec48806f05b59d3b2000080c001a0082660b5db2d3a8a58c0b863673ab27f7cfe4c049dcc52c76a00ab45b0358db5a05a7519a2d399cb534480383ac21262fbde2dd85241495d7832dee8bb02c49c87b87c02f87983aa36a7830293788459682f00850165a0bc008255f0941be13f64a2463fc7a76b4092c53328cc965a77fb8806f05b59d3b2000080c001a0e6ee9b85c3b729518524fdaeb25d47f89f6fc6c4d2c4df707187bef74d73f958a0756bbf4ab119805b77466957b5895c1d5bf422c5f65d8a06f7efd37dcb2c87afb87c02f87983aa36a7830293798459682f00850165a0bc008255f094a90b28fd6f8e46ac668fcb688414184a163e2cd28806f05b59d3b2000080c080a0d394dd43c58591e5dda8a7f3a2f4eae1bfd65655b9e9eec5facc6dcb39aa77baa002eeabf3fe9c0a56eae476d2f6452ea72e63a9c9b1180290b792883258f939f5b8f802f8f583aa36a7830283818459682f008459682f1082962494d0f723c6b2226df56fe41e63b9eaa66eb540bcb880b884abac047b000000000000000000000000000000000000000000000000000000000103e9f0f3471dc445d8f209ef546e0d20eaccc12ed0a5b4100007f57d9bc8638dacaf6480000000000000000000000000000000000000000000000000000000001d209b1ea11d77d1ab457eb3e2954cb2b98e77b5b07e2a4f48507af0adc61329ddc210c001a0efa10ab60f3bd1e7c4a8d52a275a568fbe2f5edc9e1eaf386299577ff9ddbd6ba06e62cf2f66b58f655ddd3eae47ce40408445b086f6ea858edb7bd847ee206207f86f82e6e582014482f618949ebf6b12e7e33b8672788e7b2b3330356f6f2c41880de0b6b3a7640000808401546d72a008d6be7aa21be0a43e08e960620f4c40c44010a743ead9919ef9423863c08b12a06a63a7caae4504ee5528e50387ca09974f7124035328a62d1085da2fee6618f9f86f82e1c382014482f618949c68eb31c4d00b94c3e3d4c2887946f8b076b24c880de0b6b3a7640000808401546d72a0c22d48d72c70ccf0a44d0950daf16741838f9333ee0bc5e05ff02b058da1e010a06a20c9f74cbc14c0d5bf3b3c38d3c33a5ace9194cddc2c533afb16459eaa7647f86f82e4cb82014482f61894d531e7aa3c0bee832aaff22642c7a3128d48a81a880de0b6b3a7640000808401546d72a01dbaeffc8e11964c06a722bae73e35bb5de55b8f959592868f2ff5fc13b69bd3a002acadc04665570a2032cdb616de15bdca79127f21302d62db5baf96ae4734e6f86e830176e381d882520894ad346e81c5b26fe563ab1ba2aa4ff811655882ca872386f26fc10000808401546d72a0b6de11598824e338100d5ebe70c0b0f4d6893fbb36f11ad55cf74b2f43afc5dda05101e65e7e84ea9edba6e5bf1a1e07028ae3fa5213240e812e57cf6b29080726b9235302f9234f83aa36a7830137d564748315f52194ac9251ee97ed8bef31706354310c6b020c35d87b80b922e48ed7b3be000000000000000000000000000000000000000000000000000000000001edc00000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000001fe000000000000000000000000000000000000000000000000000000000000020c00000000000000000000000000000000000000000000000000000000000001f60000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000002200000000000000000000000009d69394bd71906a235f9113cc04321f573958d3e00000000000000000000000000000000000000000000000000000000000005200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001edc00000000000000000000000000000000000000000000000000000000000320266d6b1b655f66cf8f99d35432492f8fbedfa97a2a48f0efaae65de6738e2594aa5000000000000000000000000000077770000000000000000000000000000000191c15235c348207e935e72b9151056a9661d73631d1e2c3f89ffddf8e74efe8a42ab8767076a555a049372055c846097c99e69c26ab0a24553d21c15de29ea900000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000030ef2c000000000000000000000000000000000000000000000000000000006436f8d800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004d65822107fcfd520000000000000000000000000000000000000000000000000000000000000000ec15abee257256da1a964434000f59ddd45b1ce67d5df44f1c82fd5bfe95c3b31dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d493470000000000000000000000000000777700000000000000000000000000000001d4b5b35d93f51c8143f6a4cc3d7b320d37ce03989cd88c28601f4ea94cd6554249cff83e4dd8e99a8ef9004b2ac7518996f4784af1f9e52debb6223a697e9652530feda219f333e01f8cd0b31ee83b9c250ee51fde9718ef5fa305cbcd01901200200100002020000400000280000006004000c0020000000000000000000100000000029000000000000000090000000000008000200040000012004020000800000000240002400008000800000020000000001040000000000040824000000000000002040000400000002000080000000000000804000000001001000c84000208000000000180020000014000000000210100510008000082c0000000001200002000000024000008400000000220001800400000008010000052000200000200028000000000800000040200000110000010000010000001020000210004100002000000000900280000010008001000000018004000000020000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001edc0000000000000000000000000000000000000000000000000000000000034bfbc00000000000000000000000000000000000000000000000000000000002ddb24000000000000000000000000000000000000000000000000000000006436f8d800000000000000000000000000000000000000000000000000000000000002e042ab8767076a555a049372055c846097c99e69c26ab0a24553d21c15de29ea900000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000016a000000000000000000000000000000000000000000000000000000000000017e000000000000000000000000000000000000000000000000000000000000016202bf20ff78727f38ef16e03bfb3d4895f35cc626f97ede7cc99f48aeff8661fe32015ea8d62ec7a79e01cd398e85867bafdcf55cb6a7121b6fef097f5f5656a5d11ddf336b6879926ea2ae425e91c748a553c9a496cbe2ab556a91689f75ee2b01ad3c43aa774b50a9d8411a9f65be42d6cde781db1a1949a1e886f868917997b2a7122720155935f15da0807d0054f1a4c3db2a92ec4124bf590ce7a16594f3f1812f260acb049d01ad534a937840a80c0f56fd9a54ca5a8628ed896d14a5f8b2570f5813e35c990656f6300a1a1849429135ada6337646248f6ea03a7f70ac426c1d805216d154ea5a8e5ff953bc04b71b049b4b5bd549b6b0cfa7f8b21dba72a3805c7093d8589f2d4c55b6211441041e8bd7916daed5093fcebd377c31e810a6499e6e26840e3afadc9b339c6abc86b7f89fc3559f4242d373a71389db20219195f6e13069701f6d539dcf63a049726cdd8cadc412d1c43cf3fc0095ae5e2157dc668bdb924d7d7afc2b4632ab8a0e4ef71941a0a6a65645f6cd8570302f90b98bbdd01be238dc07780ee9b93e22ab87f26170d7fc5531347fb9fadcb65dc2ca20442a70be9e785292d533fa9496308a7b1588b50b45c17ea765de525259f036edd3984782399b46793acd5abb9f49e38b309c2363aead57264ac1a44e6432b81127a0bfdc29f01bd04e7db2b2545ed8426d2fe9b3e561793ec8fc875f2a71f31c13d11b94f892bb9f96bd2931b66ffa5e22b104c549e7c0d5010e4e70e271d48c0bd6e4be68c920ea77af85d12eb155d9b25703eabbd0ede1909565a55f11fcba848e01c60438611958101321898e95c8fdc936d31389bdba8073b382e5b1e2cd25993ad31586d7525f165fb25a1cf8c22623f983c025d21f0e52ecfec5f0232a753addaad88340ca39f00e9722f35dd25fbe8fdd8846bfc0288215d0638004009396bfcd5e6eb0c587797ae8297decbca48b02407219b910ce163552ed230438292cec430007886beabe7cdf5c6f9c3740a3dd6c52ba88e6d652ce43f90044193c4a42335291795c2cc160dc68b6225edb425a88d27cae159f77df3a2241fbe809c8f1122d245bf439df0761bec97358b96d6653bc83702b559bde5a2d12f771a2a11bc9dc32580bc3ccf9dfacd0a5379587ac5160b45d333a85cde46810ad2875b406f00438aee245ecc63815528a185e9e2a029147db7fcffcb8875e5259f15c3e467de02e035891b131bc715e54e7e27a7acc437bb9f6f84fa4456aa016b3578a73ed8a4706efb935be8b6abe0697e46d878d9c74e274f2816d2fd88146b316731719e125d227e002af95aa13f468a9bae4ff41a4a6036ee7fc321b3249aed4dfb6e75089ec0656ee4e87e1fffefbd74edf55a20d752a85caccf583c0d9e2ef1040b4d36a8e992ad50ce1c4bd2b300b344ca881725c164886a5f8f18035f6e75e67a3eaa2064fc24ff79897edb624e1a67f34deb414d5efaf4c55d482da108aa2ab7504fd5d7f78d91da5c20230380ec013b910b01a26b8bed8a05a004d52db30b7fb01f16347692e9f19f303f48ea8cbbed2d3a3eb277ddf4e9ed8026af5ce92a618c8942caf28b3249044347e14e5c3c2ed5ec0f9cccf1d11a5b290c00773e12c25feafbcceeb8ae6c25a88c9657c627187af6fe0bfea0b3cc36c908a76f90e965bc4135c8596534f444c91aaaaaa6277985e36248bd53ef0f74f103eeac98ba92c5350e4a0c586c851ad25df982e16b2d408de37c687efc6915a41197df379614aa657ab5100627c47896b51b000cb95505bac77e4e440ecd1fe50252fc98f15ee41cafbf717e144da35f424e141639de04ebe5d333e9df8c06821c689d1ef2abbfd12e8a1edc059a9279db7ff44bac1962b5f7297da5c989528229e98a91a3a2e351f371dfa34d4c3676725baa5fa4696f67f4239b5fe1e3fa351d66aa5a2df992426d94ba049bbb4eea0ab22e3b9a7409f2b6719ede64353f4112e4da3919adc16dcd99c545966256493d2699ae529e365c20515d95c013ba2627576fb75a030ffd25b85ed3fc40dbbedbca54427f8dc2255c16b742b3e2b82e1bb634ae73a402927e6dc424d1908942b9b0f2cc17909ed050defe85d24a1986291facbb4ecf9b7ff66c27f8e771d28ec6866e3d24bc97e7be388013df8ba8f407b9147ed9b3581784003a22eeada55656d2be271afce06ef3fca32ac9b77b4f2420d60e892c95418b2a1b7d3dae2738a073ef105e66c08488e8a91e8ebdb5a10e979611bd29245c13cc4c0f5b33eedc5263edd6c27666e0c3f02161114120230511406f9f82102fd8c37c36d4e383e445df4afc6e7dbaa570cfe05b3f6038ec1b7932b70e7b068a2656173d241e8f20bb6be3a3a3767111aa6f459f84be961c2337f6e03ed3cc6c847a3683894288b471504cbdc43a78f856801a10a87c77322e36e0ca426ec67ad3a2a3b79bc5cb81928a79a67a0fb46bb967cbab73fd36022f92d920204de61717dde6a85b7bcf57584c11ce54ac92998f856bf042a01c5006f155ac97d6757728caceba5530eb745e72277723ad34268b34008a97a27c370e9bc006aeaca4ac36414f35aa41ff400f698623a447c949f7f004f3c3fdb09f2af3c96042e215f0d4bbb23fda72d4f01dd9a55dbdec930919715a23e2cd772a260e2b91324c244d88ce1b83c92dce1aa0e0c255b80ed9325dec0e677563984a1c559ddb4a544eadeb2a38e8ed7736174a30d2bee6e0b65f3766e0b7a4e4d8022dd9f82493a9b1fadd1907147ac29edeb8cf8c7c58fbfa9b82ed3d9f9f05bfc900e52e29a05ca8d445b5245b16928dd61800ebb63933d9c471c2fb38776459641e9debdc606abf6ccfdf8fb41da88ba0745d96fd4557a879fee82e33df32d18b18d7360529f89f3dea680a5cb0c6a7652ee38589e1997f3e64ce4db1d3c04cd628fc0fd6e7ef1944108d48eb742a28467fa4bca693dbc8f923945256da2a83222d172286c82b1949803c54409de4653f258d0cf4266c83d5675ca9b5b3a3fb322b9c493ed7bff0a6165babb19c94d9e2014b13b099f09894fbcf32959b9d4ce71ddf9d24dee8bc40d6be92ee6e1220d84d68ecf1a0424132315c0612802b477b0acabcf346b0ad5ea329ea72f4de7524530bc00ad36baeee835908655faecd350463484d31623127c09c6cec446a9ac9a53cb6841ca2a097ceef88e537e209880ffdcfd5033bc3f5a885c271e41ee332366345fa867780beb3c1d5eaa496ea0908c560e84b404afb45f69169d28348ca20bb4f5693db19304d154f60a91ec4e9255be05739f5dc7e0b420d4bde4b188a8520bf39202f81dd3e2f4adcc6f4b4be16880103e0ab232f509729c91ddf0006d6a099a769b38affb89d7489b3bf261106aec362c77acdbb0a71c3da369067eb0f2ee9866a0bbdc4ee41ae81a88d860f1784565b7b1cdd350e8e12241103ff9d57c86c368775530773bafc058cbcea6309bd6d9c144cf6657cac5084ac5fe63ef038a71b3d79e6b7a32cc70039e182052f5cd5e415128e9ab1f553f13c165ea122d089975c1daf617766e12d9f3abb2501571eefde182b767e4b63568d37a8c553671adcee2ee4c7c6d77493e4599cd70d002a718fe0d7c31b7df3893f8b9993c90d7d55eea1c38292f1eae3a7887cfd182977403d5c029a42809f2c6fb8d04aff1c60106ba36367ecca0699866e5ec922ebaeffc4e624d0cc2c748f9c446da0c293d8ba7a28125145ce0936a2dd47172c4502ccf050145fc0584ad8608ee8f6c34c3e718fa5ca616722c5b3549ddb5e2f6a96e82c3d706bf255afda0272c199da51f9a4a869ce8b164694f6ef7593ce08b4bb0afda822eed4a0a7863f532fc0a22de9de5d3456574021b711c42eb1c9190de35ea592568f8ba5528c0f5fadc38e10b14a89a1e49fba9a76ca2478dcca20f8a3c78bb3e1b9869b7375d0deb87819ce7209ad4d73d84a92d08d23649bb50ecb4a1763050b7860afb055461b3158647b453d7977bddde0fac9415327e7eb2ea373fc8abd6793f576e72a47c92d6f6e19fadfdf2c6912365b74929d9b483c19f5146ac5a8dd943caf50b2e0a95fb19066a63a71862a540b2e41731ea66697094e51d309589ce9d25a37c06c9a12839c4c08a050a3ff9e502514f20d573c610466ac5399e11b0153954428f25d16958ab48614d34f768991f84411c401e6900fb0dfaab4108db0ad42fc9ae0a255e60fa4d92747ddda47d07de9f847e7a2be289798c5d34924aae419abdc41d30fb095c6ccabe5c5d5be73ec6197371ea74e08f0583b21901bd748db5348282cabaf57d883f5c55311f1304d7fcd30a9f0b22f810b1a7f089860e4ca0f23ddce9a23d7167762734b10b995d5bd2cf3b31f8f24b18d0a2f7ce1101d3a32d18988f162e91ac94b0f521f24fa287b0d2b97c408079336b89af9e842cf31886c701018ba98d5b0eb0e6d41b67b499f4c466cb1412db0e5937f7ffa83426c9234c713096444d0fc65d1b45f166e54d2a54bc103de110669fbc34555a6d16714ca37651e976b06a7ee96d80af9ff50162016a998451e2ce5819f3346b1fcdf6fe9ff3ec8420d4860a9980ce28fd8c55660983a3fb02cbedb5c638a49e5cdf0b69b71d78e071f1200608e235e6ed0ee8fea5567be12018bcd026412db0538c28bcd4a9afe799d5c677298646943c4200a039d2fced71d985d188f84dfd3132b6a015c50b8a60d712a97c89e0cd7d3a1740244c1522b117dad1220463f5d4af1004c1a2ad6b5708d7d6b28f8ae1e1e7dd1b2d3798b8c2e27a3559c7202aa268099eb3bbdf7c42d0d20b47e5623dba8e6aa1392ff532113c32bd836f4160abb287aefe648aaff6bb0a23928f580347046b64babf354790704538c6ce83f117ac7e83e1e0f54054466cc82b2144cf135be31f24f1b224e2a956827c303b0d82964e284b968c5ebe97688e49ca793a4aba81a3d36eefd8c12e3ce9409be63c3a308636a7b296b804d8125b4f29068ef44d3f2a3c9eb13e61d6365bb96d6973e88a70757b1d9213511d357d252df58d1e848d534d9517165263e803855e8caf387579f1ff0e7e9c3c8e532a2025d8016b70a45c24a546f0b21acf38d16b27eae6466e22396097090291184a7719beb4a55beb89275c6893e01f2075d3b73e165c39335d34a5aa7b280386e30a6df9ba917e1dc6774e2edaa0c87e8f5fcf89306a6fdbcf8cf52cf25f5df473fe350325d510421546765acd00b34ef53e56b01445deea042282e7d6ce20c8f967204c26bda9f2596fa378dc611091ab6db9e1e8d4e9b5c1cc4c4d6ee2ad82b32d08f8cb5a9dd9b03f7aa754f2738ddf2dc0c3318974ff3810765917c251c74ce3d7132c26b5f2ede12a6f62f2e8ddecd5e0d02f99f2ed8ac15641c586d68e093fbe80cefd6a7dbdac6d43e261160807eb82fc2aea870a22b25148d256a083325a5b97bcf0187f748b6c0a1691867344efdd53809fb9edea57669c33780a4aa9e65149937817d3d845d9fccae1876575d5383d06adeacd0f3371209a30e1a9c98446174b0b98560652d0643f120bdabd5484435871b42ad0ce36aa8330c7edd26e64e89eb84e0c72a2c6e49fb24088ae2bdaf7ef07af9bfe381dd6a9ed430a553de1bad4dcefd5239b389090925a69e44e25800d9fccda11ff4e1e4d3049386397f1145c3595ab5115255bc1c1eabb379a37504eda27b1a103b88ae8f174e1d182e3dfbb0b8317d05d6e08c191661b04537421fd84057a9ff5a6eceb68c5bf1f0e356df6e93d936bb6bdccb42127cba43e7615d522242df13f08e5fa162a641430c1431a7d7181dec65202fb618a690c2bf3361d7dc689d5e4a97a550a9b17c8a5ada8f32db3f774e9ed047c02eb7d1ba7add29fa07ab90f290e77bd91ee9b5208b1fb19a37f29dd1a492fa32156a7d43146a336fe6144d19228f975c54ab304565269124e069e864873c0eef23f2e7b012e84ad0c71d76e1b23b8b9a0a66edcd59f4b203a9773ce26baee206254b49efb10cc48bad814b2e299bd478fd4bd8b1ae2c8bd99070b259a9e204e42fc5f65f9e25cb4e4a1a3b67872314fcaeede2abbbc6978660c3e685f6dccb53160d1f7517bbda54177495c23fcf45cdd66363a70a84f2699e239b5071c9e6cb19069f3e0be9f4390c8028ae9960851e34ea18ff88d36ee826c0a4db4e33e94f0ec6651a728a1a2b0c15b30a1783ad4b1d224d87264779a817d107d40c75b77c25addd7b7d6a8b73b2d551f125daed95786920c4130d2061178604f9604a0e2f1c6cdbf3066fd28bf276ee0aee379bc049bc8eba361f4052bd2a698da312c991015c0fbc43ea1d2e72426279fc5181851a15a2f4883018ab01ff8745625f388f05f5fa9abc5d87a710a1227322626115b60f781f4ddd91e205c1cca582a5e37e005396703375846be4f36fdb76c277dc1a2ff1f183cbafc6db485a562f4d08262a207844a3d12261fa0ac479abca76f417df42b037e611b1b6acfda94d5dacc620c3edf5744db24bcc41ef1722dc0e620f8a35c50585a7cecfc97f05bfec21f919420e62a9c4f28ea9585cc056aee08ed8891d077a9647d9c0b5c3141f8c517f13b05bf0a18b99111d2d6e7b4892e78fab35d882e4e153060f0c44cb946d20ad0897a34d2a24d3800b54acd68fdd797aa362560dcede6d12909948bd6f4726a20142eec9c6b78d224b2c24885490bfb492217c6809e0628164579d2c2c16a90f28aa5393ad44c45d4e1500fccdcc684023d7cac4e2cca889333f048cd9a29de018e958d00553c77c74ab50d974df5f654233fb923e809ef6ceabe6a860386603003cc376e90b8bee74f2477343a5ae923aea4ffe99a91b9d9289ddcc3ca316b026b3d369aca474b7941588fc6e9cb062528b10f13b90dd55afd64f7b0ab79163163ce02aed379af25740ac5e37c5628c0b868b7ccfed0ae521c964846f0287d3006952539b2dffaf891bd01fe98a1685e71536d7f33ae85775d11545eb379e0916be616206968605e5033267f6f79cc651c2ce71a790ae5cef19fea7604e479c0793f82db1f8e85bec40d8c6a2dbc9bf76d02a616aced611ae1a7a3756d87dab2855ca585d0048e1e4222ed9d6fa24e3e13677256fbb9959b965727c192696a11474a7f6a6b6c8efb649b1f601c76576f36996ec7a20eee84208232c20e8502903d4e303e4ad7139c654b7e5d2aa262d75672cbb4f653e62ed8e4d28835f7d6d0efb3f39c40558d9cbf19f250681a5c8a59143fec80d6a69d8a265835d6562ef248fa4ac508bd60c9283f6e731baa786828d0f7a635e1d14a448383c8b0243570df4a42799afe03143c227e3fcf0b1393bdf8bacbd26f1041d5e3112c84755942fac77981fe16f048cd882243a8787b09bdc38847a5a9cc9aaf4d30544181ff014dca8b2892c00a933333df6d8ef79041483f2d8c6416897ae7897ca1da85e8f0a493be4520595cd0dd7d32c87999e703704ba0ac7d8b444dba807746123100e2cf7573843a0a755eebad6045d2970a0ef8c9adddff093e79731d5e506f1c43318fb25144ff5fb63041574e89216ebe0ac75d7dcffc35d095691723493c94dcc11d4480bf3fe7b76ba53cae5b409c002f2d1bb5eab08ac993054ec297543798700fe3e2877a4a0cce53599a66eb4f1fef5cafc774277f0e694ebd7f8748fb5140735282e5e0b9bb35b8aeb098775a33820c9b8decad3ad6ce36f79c347dcc2c60a5442d2eab4368827acae1f0ccd52f0475fab95ac57c3c9d7c2649d355756140d5a1e8c6eab8b67a5c169cb899230c4be1dc702323f2b07ee1fcf5657361e250ccbe93bb403abd857eee4335e454e8485a3b055c908c957dca3f9a288299729216103089910386fb994285602ce12b04be1819a2c80394b2410767d9aabdb591e4c4dcd08d1d5bc1bcb532496ff1fc968ac3ff59bc7266d8ecbb67f34b681331685a99b781c9752dfe83d145bd4f3c8ec634f028e850e246aa81f1d03aef40d000000000000000000000000000000000000000000000000000000000000010cf90109b853f851a0bf32b9037b600aae3ecd3dd1838bc9f18ae1661f615cf3d70bc270b6c31f55fb80808080808080a0a2381991afea644ece5cba0d8d69f838f7b123d2e0057a54509e0c61e8b293028080808080808080b8b2f8b030b8adf8ab8301edbf808303d09094000077770000000000000000000000000000000180b844a0ca2d080000000000000000000000000000000000000000000000000000000000320266d6b1b655f66cf8f99d35432492f8fbedfa97a2a48f0efaae65de6738e2594aa5830518dca079be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798a05f3b41e975b46e86d5365943cfe25ae960fc2c7c1bb4eb0025eac5eb0bc6639c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001ebf901e8b853f851a0529f2d89256fc038782a4d70b40bf127de906cbe211e7acaa3e928e0fd5cf11d80808080808080a0b4f4d0be01c65da5308bab41d52d8a7c93a1693c170c44d1f619b8364d40e3428080808080808080b90190f9018d30b90189f901860183039445b9010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000001000000000000000000000000000000000000000000800000000000000000000000000000000000200000000000000000000000000000000000000001000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000f87cf87a940000777700000000000000000000000000000001f842a058313b60ec6c5bfc381e52f0de3ede0faac3cdffea26f7d6bcc3d09b61018691a00000000000000000000000000000000000000000000000000000000000320266a0d6b1b655f66cf8f99d35432492f8fbedfa97a2a48f0efaae65de6738e2594aa500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000adf8ab8301edbf808303d09094000077770000000000000000000000000000000180b844a0ca2d080000000000000000000000000000000000000000000000000000000000320266d6b1b655f66cf8f99d35432492f8fbedfa97a2a48f0efaae65de6738e2594aa5830518dca079be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798a05f3b41e975b46e86d5365943cfe25ae960fc2c7c1bb4eb0025eac5eb0bc6639c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000189f901860183039445b9010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000001000000000000000000000000000000000000000000800000000000000000000000000000000000200000000000000000000000000000000000000001000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000f87cf87a940000777700000000000000000000000000000001f842a058313b60ec6c5bfc381e52f0de3ede0faac3cdffea26f7d6bcc3d09b61018691a00000000000000000000000000000000000000000000000000000000000320266a0d6b1b655f66cf8f99d35432492f8fbedfa97a2a48f0efaae65de6738e2594aa50000000000000000000000000000000000000000000000c080a0ae5e67673b90f2d6802e8dba26aadb2e8b81e059d1611afd1908e743e3c0b75da004886b0ac3a810519aa2395bffdd94fbcfe4a2de989ec95d1aea0fcd09afd931b9235302f9234f83aa36a7830137d664748315f42594ac9251ee97ed8bef31706354310c6b020c35d87b80b922e48ed7b3be000000000000000000000000000000000000000000000000000000000001edc10000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000001fe000000000000000000000000000000000000000000000000000000000000020c00000000000000000000000000000000000000000000000000000000000001f60000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000002200000000000000000000000009d69394bd71906a235f9113cc04321f573958d3e00000000000000000000000000000000000000000000000000000000000005200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001edc10000000000000000000000000000000000000000000000000000000000320267dbfbf2c535ffc52117d4cc616b8d97bd07cdd8585ab67d9095c067e9de6d674400000000000000000000000000007777000000000000000000000000000000010012f20d5ba20a09e185d452c999c129d712b83c75480e2e029fc895986d361a781b2045b8b5226f9c1fd712d8b1a5f1faca84f5fcee87a7d1dd2b57f55617df000000000000000000000000000000000000000000000000000000000000016000000000000000000000000000000000000000000000000000000000004f9456000000000000000000000000000000000000000000000000000000006436f8e400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004d65822107fcfd520000000000000000000000000000000000000000000000000000000000000000bbe20eedcc0216c615d3a0550a5507bdb2f9912eba7b608300486e871a4e42491dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d4934700000000000000000000000000007777000000000000000000000000000000014852ab81d236f35c396d4836a6f82239f5672a4b6136ab9ebdd8669a9f9e831b87a26944e5c04f16b79426135ac11b155922c14178bf3d1ecbb1fb12ccc8119a22df5003de2d5956c745f9e825a8f0ca1bb1e265d4d431781b00765e0fe37280000000000004a00000000000800000020400004002001000000000000000010000000002800000000000100009000000000000a000000050000010004020000000000000000412000008002900000000000000000000000000000000820000000000000002000000400000000000080000000000000800000000001000040c0400000000000000010000000001400000000081000001800800008280000000001200002000000000000008440000000000001000000000004000000000000200200040028000000000000000000200000000000000000010000000020200290004100000000000000902080400010000001000000008000000000020000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001edc100000000000000000000000000000000000000000000000000000000005364e600000000000000000000000000000000000000000000000000000000004456ed000000000000000000000000000000000000000000000000000000006436f8e400000000000000000000000000000000000000000000000000000000000002e0781b2045b8b5226f9c1fd712d8b1a5f1faca84f5fcee87a7d1dd2b57f55617df0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000016a000000000000000000000000000000000000000000000000000000000000017e000000000000000000000000000000000000000000000000000000000000016202bf20ff78727f38ef16e03bfb3d4895f35cc626f97ede7cc99f48aeff8661fe32015ea8d62ec7a79e01cd398e85867bafdcf55cb6a7121b6fef097f5f5656a5d11ddf336b6879926ea2ae425e91c748a553c9a496cbe2ab556a91689f75ee2b01ad3c43aa774b50a9d8411a9f65be42d6cde781db1a1949a1e886f868917997b21ad05b7c1eb0d208d17426c52831c6347a8db75b12bfeb2970c4dc6666e4eba0492d2ec318089b11ee7ec6087ab6a3df335770526cc0c1679b764d847b4ec1e303d400c12e690aa26a3771e5676e7ac95e2dc7a1b33be698f077c598f880d4203defa26ad36b84573e923af347475c7c7671be245e9859ca1db3c047faeee4b1c0e81d8a92915c2b94ff300e18f77f70ffec15631161e0bc3cdc9143c43422c208187652c1ec83c5d282e10587216eaf56689e5fe236f72c13eb9574afabc622a739cefbbe11aaa4e2e3d4c5415818914fe554a07be374f565d9bcebc0134940e8921b87bd4f6b42a6432e6e176be5ec82bb8eb6bdb7e4acc1f1e99725bd3ab2e3fa52e02c2741dfe6eddf5a3846dfd57f6a72e834faa048cb007826a293d9e163d47f9ea635871b25afcc3561dfce77b3a2604b3c8de90aa24916f41aed62d2e0c0d18f9c259bf614f1321c5b7cf7b5bd73cec408dd85f046bf36302e20f3603b7832071796022e893386de4e3b170135a591b1a44117240ba85876dba586b1f31c13d11b94f892bb9f96bd2931b66ffa5e22b104c549e7c0d5010e4e70e271d48c0bd6e4be68c920ea77af85d12eb155d9b25703eabbd0ede1909565a55f12f7e30e74b0329222f6067cad3b4324a80f570506985d729f7780955333f40e615f065023fb607d975d7a2b9f234137e72260d8f6b586baecf42819f8328dfb3304441f2c9e97d1fab9a3625073ac3d2bff6ba2f8d659cbc6f66e8d9afde1ef229ff39bac1ecd65eddc4953e2726a72daefa76f00d58e11c9a9ba3448fbe0d3a03db78d70ed9c574ddc45de5c73efdf3113ee70a4b42cea9884f85c1b995516912800abeb70f3022d5de6d9f49469161a36a6a309099ca43e388908635ed4ae825a14b7cf5213454a1f345497008ed417e5d33ef84c4934368b36f27606072192a1b43396f89647f0541dd25f55b42c5295d3ab2a22355664608b8dfec3c9d76045b27d8c2bdba7f376a44826bbf4044aed0d57068489fd32a2bf52f8613aa150185aafe655d2b86bf8867a6f7728c4133fb95776545b19767a0d7144f60f5ef038eac390d1cac6f9882211d7302137efc82b93b8f9c55db629f47a2c61931c21d01d5ad967c9dc6c1abfd496a74df2ac4714cfb027bc4d8c0153543ca663ded2af64f7396ed3b2ebd1976386814e94b7f7fcc3a19a4dd876288b905c381bc8f008de145083d6404890a863e1af1dd897aeef2516b20df50befb6c708c9728a22cb31d80b0e953aa71230d2462bb0668dd8701e11bc5240d85184f9298e2c5a3257b5dcc3e138df8b7d4162d6253fb5c21a65e952600c8764c613c6f43d22c861d4380cd688c286e9ffad6bb8582421fcab96b075769cf48b3160f056dfac4041b08287533a769bed0f08fdee9a16c5c8f414eb35830793c7b64341fef79dbc529a7b99f85d4e2e88b64954be967c5ee6386f9131b80b454ce70209f78f2101d0ca71da273735bcbcdc5ea5d3d54b607820b9bc852abb1b733cb7bb5018276d30c4c0a7f9ffcd318499a2041043494b82456ca8ac6f07678a8b770329b7c00f31e70e97ce48bc796570be27577e8986ee4c7fa51da44bdecfddfcf18686cbddc02ca206d9132d451ab55cce8069f631412ad2ae02b1a8245d31c0a65854d07370259f632fe253b2412c5a785148248d660d7cb6bef5240749d6ac4a4ac59384b27e7019c6cae15ef7c82e5a952f4da079b6205f9e16f3d3c84e94b490530c5b602d4bf5e9d34f2a785cdb7f7755d6d467a9d88071bbdf8c79195730db7d0b7872cbdcdabab02bd4b8487b726c5ce6492344ae7e900a21893e7b840b46380ba99278ce95322dc23daa97995d1149d425952913428c8ef8659dd2cc2895f12b08e0532a254fd5674fcac1b0992472ef75337d8d77f6fef3720d4b7b17302478c7d2e3b8dec7af4c681aba5e25d8aa3f4382b0082066c3f7a0b4e42c4637df90d9a1e2f3fd1cffa7e0d5577f5da89353521ed02cb1c39eb5746cef10ceb74c3fdba13199b42516ebfe29af40da64ad81b46b7bf04bf25994255c7a51f6839848810025bb52fe7500cf1ef628a07747894e3b73d53e6b2997d0654f1ffd0c070455400fd7e9d670984ac807a0f8131977ed1806fd3c0927c34b7b4dabf011d31e86b1b7932b70e7b068a2656173d241e8f20bb6be3a3a3767111aa6f459f84be961c2337f6e03ed3cc6c847a3683894288b471504cbdc43a78f856801a10a87c77322e36e0ca426ec67ad3a2a3b79bc5cb81928a79a67a0fb46bb967cbab73fd36022f92d920204de61717dde6a85b7bcf57584c11ce54ac92998f856bf042a01c5020d266b1ccea774955484405f58ad161251d879a87c43d5dbaecd976ac5d04dd2586d70031a86b0dcade14028f36a04508494c7a20e98b3b21f7765e7b3ef68f10960709e63eea35a26ff47424e18df8cc271ff3049262c855d6a131695a395f2ba2f1b039012ac8a2abdf6d9f6b0c432f0ae78b9bccb99f89759434477257ce1f44cc61e95b9c9843ec8efb17c640fc4c837ec125fb25323d3f0644615d21721607fee4d68e2dc9bd29f5b13fafe39b0710d0365dccda35e3c937aed1b6949b2a0a7523011eb706357b85e174376ea7cadbd01ed0dd1bc6a8e5a5a11bc6131f0661dd6365b13c6e2de50b98cba1cde58a921d19936c711424eb625b7c35cba01a0f7dfa8d6f86a2a02425ab48e2c28f8f2f61adbb744c221b9c4f35b16c749c227bcee1202e87537c7441f421c855ce87d858a679f09dcf814bfa1f26f7d9ce18f723d2f84d4b25ec60adbb6367e92270836d03c71ed43413767342a4fb8d6801b8755bf65e7947ed4459ad6486fc1cca1f1cc89df3d307f01d8ac68aa1d08d18aa35a46bf245589c599eddc6337e764c36426f7b7f5d2afde0a76fd3aa536d1a165f9f23cfc65866f574f2289aa5be056dd32c72a204ba8328dd9b0b4643790463484d31623127c09c6cec446a9ac9a53cb6841ca2a097ceef88e537e209880ffdcfd5033bc3f5a885c271e41ee332366345fa867780beb3c1d5eaa496ea09160db3fa7477a2fff436ecee95aa2d51ff42ca9d4fcf021b6e501410fd41098a1a8f6021636ece98c27bd74740b7280d3a5e13d9850fcf7f2118c4c91572ba5826fcc4b0837d0b394f6683cba38fa35a5e2bd242041533bd25939cc873d1f5852a2f57cb172eb17c2e3c351240a0b2b334978b90ac18041b09aead26649b1c1c019e41731e77c6b2211d7da94630507bad027561dc625b7e84094378e599a57b09eb32c2a67cf5f2f0bf9250e6da07b165f97dca10517e9f3fe3561d02ec83a722b544bd6e25ef27d9825d13651443c4d984d7e5d0fd70c2a7f983b3ae8c698d27a2a0bf2d35655f477adc99c56f48773922831746f8af58de941a020986ad7c23fb7d31c2f17f305174db26b40447e64c66216dce98e7a8316dd91dee468e602206a4d1d18fa7827f733037fa87dfc9c74c9df0960867087c776382b94db9420a19e5338e17e8a68cb7621f0b56984610bedd3d9b77dc5447cdb129ecc33596079cf206e93904368cae07f0d449e2095f8abd95f26603d2db047647babc8342200be0095aa5489fd18cd00a52f59b70ff04c4b1e572db76d08bad419abbabb00b9e485e3f017807c12b427b5e0e648cf7b16065e313c1c073ce354a5fc6812c02b8d4b6aa1168c575dad9875087fe9f61702309febfb99b895387cc1104c35e123b713019b5e51c320fc2521cdb5cfca20f617773fd46d3872128b87df6f66a21fb3fa16711245ab65eef629c5e6073efaff5b707657f4442f2eb2637fa71000f14fc691a71aacf902c0c1a1a5d7d8d351b8b3cad57acd0a9e47a1abdcaf2b70aed8b7370a6bb2bb4f3d679c4f9793e4b256deefaef1e6dbcdbb648b917e34822d833d2ac1614aebcf360d328d9271f27c52c93de4a9455ce6cd8d2140ebf6b21c9b172cf47556efc5dff9afb913e328a708292bfb65c96d668f4d0b3a9a21b222039156cba9980d6bf11efbd8dd893378e5dc1b323c57d8f702076c22d125d1489bab2553c5521631c35f7b5236007ce8f37012cace78d6eb39718904b5dc31ddcb6f4f175e52bcf6c6008f6f5a572925600194b9af7ae074dbf85119e3afd141b2ff2652a58f043e97f11b77997a9da1c96c18b5254a107f24e997a3ea61c2069b9d04d49bd1bcd2495b19bc71848f28bfb4f0346b682a1b474e040b056e60a32b5e8aa532103101cb45ca41c6a690c8688523b8566d507f29eb44fe2d2490e81f4343ca61c8783b83e40e3ce66532f186e9d09bd2667cf974a763072a910121aa5e86e151d92a868508b680f795bc30b4502769f41e3afef5f321be9ce2f1cff3eb3308d65aa0ed780cc889f605f35eb5e02ba772d08db2579f8561c61fa09a8e23ea1416fb95ca0c7e139ddd16f04b0c872499e44cb5a03868d6c5fa1300c19a96b8586b8f33bd760c6350713696b7d3236acb0eb35bde2e6378e9ef9b117b02290ead7824d42452e332f6ec95a7f871da9ebdf6ad02c959a1a36ba33ff0089a4f5217b7bfa5379a507b1e994fb7b8fef489f1f2cf6fdedf0e530635ef31faaa1a37457c445836376dc5cdefc7770fbbad8c326955655efe4ecde89bd2f1dc62a2551a45206fd7d42605aa1c0fc80476b741bd7df1f0f2db0fc387614240e78427bb3a8cbbaf9bb112da06ea6942335f88c65d42d17816136509ec39b51079b5eb2a8cd15c3d1fbc56dd72c3499c101e2fc9126e8f194c6c8006faef30917c5e535439c6b0d78be52a4d17a3a25d0878649b668db027eecbbafcfac7a612138c77d1511f9cc5e763eaddbad6d9d8770705ef7b4d062b4c6dc72f30d1d272dca8700ae03a4c6d2cc6a0a03f9bfb2615b2b294515ca80827ec9cbaa7746112530f5e70f236a641c05bbc8647dd130f02db3561f9dfaa1d687235bccb0498202af478a6070dfa49df99785a61eb5fe5f18777569c18b08d2042ae8639abbc225b832a2fbcd95ff43a3fee4fb2962983af8304ef995716110a7ad35c538697c109c01c427ca6cefef3a842fcf74b1c49a3f2da88b85fdb1d05e20cd567538942fa2f0ffbb5d2ff73d60d562d9a0a6894bec3d85a709b43e42ab64e2306cb96919e078b899f3155af56390d06ddc662afe8d2c91fc091e2c5cbbfab3fdb3f49423a5a5f7741f2d70c6736adc66e7c2caa89c6bbc678bb4b445a8a63d120867f01f164dc87adc853633ca7bd4b9d585c2a637d1469da612b5210476fc8d66f90029bdbf7fa5eddc8335cd23deb4bb47e1582e64a03dd021292d34435419af80af178cdfab0fb9374fa0fade48108cd3a571b814231784ac37c9f6071fc6ac0bb018595c9d8afbfcd6f31832b2581f7f7ce7c45d22817aab8ac6df0e0995e12dbd1595c3377b707b816c96ceb1893b9e7c747a577bb7540b89eb3ff7cac878a7a121a37b38fcd3248abfd24b50e25948dcaeff8c1c7ab8b745a93adb87cd54fca223dd940ef4d7eca9dd69243c74ea128ed624e52c7a2257f3950d0c7409d665d912495f8a8a2cf2482c1d51cd7793d3d31f32ffc24374d8606daa2a423931d97019ba2fd3ba773645b7fd01cf75e8201dd29f694a72136b585d940bff8867654223c28d0603d85fe4472d93ee30e35f46e27b8f40f9a9ad03992d9ff23305fc062c7d95971baae1ab074df88d41e09ec9752efff012c482e0cf9aea2b78cc26db146a278d584575ed615f5d168e6df7a832322da093f0aea706cee594207427d3005fd910843f3dc54b14f8b187e3b495b7474792743fc2e43f62bbc7fd50a76513f1fa4073b15a42d1e78a708134238f2521c749d086deeef512823b514aa64122b365efd51e11415de40826971c234d571c3e2a0507226c6ccc540e43a9aa32244b29784ac824c20d3d1b72dc7262f61cce4eefbe9a4ea4cb1061e4a71925aa13f31d6ce80bb7c56bf47b91cf107ab17168dd4fb60614757d7c7f4ebe0320692235fb502621ed9b15b9b3fa23aa1bf266a2a2c3f2386b52625e42e0cd85c37319e3266185419bcf6dea997e52ec8fca5887a68530002fcc5b3619e88d4dc9a918cc36bac2416ffa9b9734ac4e67a93a800f36d7aba4ecfed8d65f62cf6ad13d184a8c6406e3ba17b8aee6af0721ed091e1d225d044629a4ef5153c294a3e87e243e03bdcf6eaf7ee56d9d969a1f054d5774a7e2c363b160386b909c89717aa7015385f4ab8b6c97805c12c37d981ca945134cb1306d39a4d136b42c36d8aacd2c37575a11b17fa50ede8072d667f64bb55e3b54aff2c3c61782e442e088db7c1ce62287477132bef00c17e9992dd42f35b5e098eb97724fc4e697d75812635203abe8f96000d9553012be065980fb16d6d1c0c80457585c6eb699b0e8a6e36c1cd518dd1ffc517afcb9114a4ff629d06cd2f0be1495c4ee09243e96529e6c3a228c923ca2a703930ea94f7a5803645324ba9ea1a08e6c3241fe57a80bd24f780566342561189baed15e85ba9257b701d651754ff534e51279961ff379974e34010d80773b169a140e0ee7c5e2c0312c9dee46fb7b309710d448a43805c7eab513e84e346411b7145f77ff4ced7b32eb641528f78d88af0fe88e0840e9c16f2210e18c1da605bb04a4c963441c06fa839f722b0c67345168bc0fbb1c826f20472c7551a1327eae9eddbc24e63814fb81320cbc6f03488d64587f3e5f53c03db02cb15412e622f9ec9944643d4b5530b0cd4d577489d8ee499ecf2b74fb72423412aca8530fe53c3fc584ed8e39f900843ac73e36fb113c343cc197cd689a09e12f29203c1dfe839630f6932f3a29de81ba787f6044e70dff8981b71fe82f8a4d01f45770a53b090026a003b3e639eca0e6a1e5bdd0aad456e89d83012ea1f53e1a5fe848b33528f7195a7b0c36d4315f1b96b62d5603e87a13e12a97ec335e3922d4339d9575cb26d5691da78a738aa5c84aecc22a93033a6912f84360d13e2e23b0185bdc2cd331bd26ababcc91894935db5c7e1800b8a10db884a7614ceea91f38bbf623c5e7e7238eef06cd9fc9e43507c56e8d6212b7d03ef2db0dfceb040c0b206e1b7eee6ae564b15e4c02e9c3e4179d78bc68a9fbc2166cb8458342f218dc631705602b2ef1c6716dbc08f30810c9e2ab3ac7a03e300e9c21cd2a0240025ed5eda13e6daa246241669acfae65302dbca5c579d3b5c3a4c16a976209e22845337f9ca033329f849f3ccebc69ff01b301d99dbe9e79058fade67bf881c70283f41eaca130d1423e733ccd520f26ebbe8d304cbb8fa2f4bf67e2e041e5e90e840d5510d33a9f700219fbead699901ea3b3f8aa3d5ff0c028ceee5b5e711c29e7740bc98f4b78f15f2aa1e01449f1f15e68023861f540d2ae0541273c641914ea0e6abadbb2f11618bb678c8b7abff1f6d4e9f789706cdbd8dcc1acd4bbd506e42e928d134366d3f32d8caa4b86736bb065b1a3f89354835b7ba5ae1e53cc1bd9f5dfa3e0d49c0a0a8d32670c382712e30f8f4cb8fc980785fb6012df752e02c923d3f56f5764a41629646f9fd7641c8365f0917f85a64d0ba36179e2c2b3045d7b3c6ccfdb60cd5c365c43d88e231465c6616f7d2cab0db88cd79268e5ba0cecb98875958ee3827af7842e35d9cc89c3776e5640f2433a6afccf0e6fff9321e31802746639bf2bf77f375dd6799baa184b48815f24d3fca5d534dfe61d1306d15e97d3a320457ddd2239cc52fb31dbf98709cf090ae59afabbda6da75f4e1373a28bcadc2405e0a7f6dbf9a3e26511fc600a496b4623593213283a1fd33f000000000000000000000000000000000000000000000000000000000000010cf90109b853f851a04dd5a916917c46969db2e2093e73972daa52d5582e183eb0bd08362e7aca1dc280808080808080a03605d0d2c4765be29883abb71f1c4b162f9d6786835ccabb068a243ff819909f8080808080808080b8b2f8b030b8adf8ab8301edc0808303d09094000077770000000000000000000000000000000180b844a0ca2d080000000000000000000000000000000000000000000000000000000000320267dbfbf2c535ffc52117d4cc616b8d97bd07cdd8585ab67d9095c067e9de6d6744830518dba079be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798a05a4ba290d849b719839872aa1e6999ee672fff37d450956de85fe07c96f172d2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001ebf901e8b853f851a087eef6c6fab228bc280138441d870592a3910f042806b16f257faf5f1542f9a280808080808080a00ac60a3a5bafa4560edb7bd978a6b8980fa818c5edea7c010986328de4d9b4ba8080808080808080b90190f9018d30b90189f901860183039445b9010000000000000400000000000000000000040000000000000000000000000000000000000000000000000000000100000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000080000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000f87cf87a940000777700000000000000000000000000000001f842a058313b60ec6c5bfc381e52f0de3ede0faac3cdffea26f7d6bcc3d09b61018691a00000000000000000000000000000000000000000000000000000000000320267a0dbfbf2c535ffc52117d4cc616b8d97bd07cdd8585ab67d9095c067e9de6d674400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000adf8ab8301edc0808303d09094000077770000000000000000000000000000000180b844a0ca2d080000000000000000000000000000000000000000000000000000000000320267dbfbf2c535ffc52117d4cc616b8d97bd07cdd8585ab67d9095c067e9de6d6744830518dba079be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798a05a4ba290d849b719839872aa1e6999ee672fff37d450956de85fe07c96f172d2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000189f901860183039445b9010000000000000400000000000000000000040000000000000000000000000000000000000000000000000000000100000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000080000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000f87cf87a940000777700000000000000000000000000000001f842a058313b60ec6c5bfc381e52f0de3ede0faac3cdffea26f7d6bcc3d09b61018691a00000000000000000000000000000000000000000000000000000000000320267a0dbfbf2c535ffc52117d4cc616b8d97bd07cdd8585ab67d9095c067e9de6d67440000000000000000000000000000000000000000000000c080a0d86a71e8e531bae3b2a2e70d98e516ccf31b6583d936ffa31c3772ac265db828a0420f5a8067c7eec5214117647da149eaa4e7c78a10d8ee6fa62001ee1b680f9fb9060002f905fc83aa36a7823d3f647482a9c494bac000000000000000000000000000000000000380b905930001536cb8da3dd105e94414690798c7f100000000057b78da8ccffb3bd38b03c0f12199bb964b426dd6b091efd7dc3ad1a9d321d1713b2ea1189d39280b4791c5c858729090c3b6182ac75951eef74b38191686b35c4669656ca9dc5a0ce7e9399f7efffc03afe7fd6e7485887f6264e97e9856a6978b65c5db3b4ce57cf4812abeba0de10d0d6ee5a2cbc9885a2163a58d1895524adbfd86d795eac74ec74d783b599861bf4b7b3e6daf70b3ae0e5740c88a4dc15b893f76fe074a718bcead52fb2a06d6e5f1cf3ca344ad05dcf5ca10bd9bc2809cd8ecd40a2dd0e03200dadd8f921f0e9953a7e6d8c7dc99e60cf6fe81465175e0cf99b702ac6a13706e64ac349a1119796eb0b6e7d5ae48ad74a5c997d679ef9c637c619587cb98ecf88e620dacdc57701500c74e087533f978831a78bf3857cb6044a8c66e41645cdee74ac7cdac69a8484083eb003827ccfd6b92c77b7097a15f38a419f6f0578f3568465e6fb639f1a8d6e52e9d17a0413100ca8d08b210a2e5adb2bead3dfaada14b2513113802f3996daccac89014dafd1368700300053ad7daeea2a4d4d9e8502aa44337c6ff91165a25de84fe5273b2e5b7f4dda3a0410900125e7778d5c2a59a2ca2ce36bacc9e95812ae1b69a478fc7ecf5ded14b68a80a010d6e03e07137d5de8082773f8a422390cd0a592d81e6e623a42bc69547e6b343e1d9a14e64ac3486116e29a8315486a2324d93d3e33a8344ffdbc2655b76dbf72077e43c13961a6a52f0565f2000881576c7a113e7aa6e9a6ed4679014533f8d1bf80ff44ae5599813e80d2c1f2fd0a03400864952137916724a4504bb118ccaf9236f217a1e43c97e471397a3f86672226dd0e02e00d4dcbfe4dd250a97d0c830b3d93213fd048fed38ea8378018c726be68728e22c687037000e3bb6d2858fba82db877c2e28fa1e2cca4ce57b6bdfdba7513dcd2649da93544083d06f85c8f4d21559e8e7651dcaa0c3aafc4a691fdfb27f2f39ea08ea62feff43cf0d80061500b0b00cb246f3641d83f5c934c477ca641a5c545da8aa0e4662c4c5f26ee70525a04125006cf268fbdcaddb151168bf24d3fa2e09f7445d859ff9e5ba2fe71e7ef8861ba61834a80280ebddf1bc99e8d00ae5d2a0893d64774d4cea1bad7146fc964526b6c4617cd70a68500d00f7e8131b976b9537ab4e2b9c9cf086fcfd82e235cf6c6eabbf8030cc3fd1e395071a840120bfbd7fd4a54397eca0c0f7adc1231dd539950f508f92e237e3aeb91468c38d4083ea0068a89abd38178e2e9f67559758419b6908d48d58967547c9edfe98ba016e050734a809807957936c079272b238748593ee3a73f5c7647d0ece20a5c208769c484474aa2f192b6dcc780a770c9b40b42348219a34a746cb495f3f1efb710a816ac142121461c6f7bf82fb00b0dec5bfbcaa2e32983075c84989e439154bfc7df1d0549680a6c1a4999c18aa010dee074028fcade2995b7daec4562449ccbced0caf7a660f49ac4ea07d485b22348948a0415d001ce8e16f70ca5813141f7f7544586da1364d2f77dd8fbb7cc937c6d46136f93d68f000009a72d59e5a9bdf1de5e60bbb17358bc65e8ff1566fabad6d6eb42ef2781f6d6d40837000bce21c64847942319b4ac1c92b2ee02fe2bfbf43b685908b92a0c3cd25f21641a0417d0084138599419cf73489312bda0d53e1fa748e1f7927380961470ec9fda73b36978c953661c8065aaafe09fb847fb54e35b3c68f771b6953941b2b4e619b486d81761ee187bf828700301cd34529763c60738c12e1ccce6ddff8b8338cda8fda245e5d8d5613d20734408306df96bd65c7b8d5c27299269dd9335ef7cb1f3357145983f365ec2f933686fc6d77d0a01100ca3a3773d3f0a52559ee691776b714fedc8c7b2cd672c7065c295693d0616d37408318007c18e9a9f6e4929e20d8efd4c2428065720ed1938af8e5348c14b373b0a845d1063468d2f96f000000ffff86f9aa5001c001a08f785a1c8e4c549c415dd948da80f86e3aaabc4e7a784604b6362208e0fb6b85a011d366d57b6ad95cda2eb6b618704859b4d433ad7557cad177eff6f6bae578cbc0f90200df8345de7e8203e494e276bc378a527a8792b353cdca5b5e53263dfb9e82168cdf8345de7f8203e594e276bc378a527a8792b353cdca5b5e53263dfb9e82168cdf8345de8082062294388ea662ef2c223ec0b047d41bf3c0f362142ad58212cadf8345de8182062394388ea662ef2c223ec0b047d41bf3c0f362142ad58212cadf8345de828201949425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b8212cadf8345de838201979425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b8212cadf8345de848201999425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b8212cadf8345de8582019a9425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b8212cadf8345de8682019b9425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b8212cadf8345de8782019e9425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b820f08df8345de888201a29425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b820f08df8345de898201a59425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b820f08df8345de8a8201a89425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b820f08df8345de8b8201a99425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b820f08df8345de8c8201aa9425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b820f08df8345de8d8201ac9425c4a76e7d118705e7ea2e9b7d8c59930d8acd3b820f08" + } + } + ] + }, + { + "name": "debug_getRawHeader", + "summary": "Returns an RLP-encoded header.", + "params": [ + { + "name": "Block", + "required": true, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Header RLP", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "examples": [ + { + "name": "debug_getRawHeader example", + "params": [ + { + "name": "Block", + "value": "0x32026E" + } + ], + "result": { + "name": "Header RLP", + "value": "0xf90236a09f73691f6dabca4f0a99b05d0a701995506aa311dcaa9ce9833d6f4ca474c162a01dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d4934794c6e2459991bfe27cca6d86722f35da23a1e4cb97a078103ea8c47231886481d72ec1afae6eeb06c3773ce24a91323d5c9eed69d4cca0008992da2531db404f07b0871dd620a94ba346963e1b1c6dc7b00748e8593a1ea0b6c3890d9604434fc52f722848c84d1770add20cd75bbc28cdedff42940dbb56b90100200800000400000002000e0000000401000000440100000000c0400600000002000801000000040480020840048000000000400000000000000020004220000011002000000000000204000800000010010002000002000000000040a000000000000400020000010885000000000808000000008800001004002010020300005000000010002110410402000000000000000890000008000000000000000000020040000002000000000000810400000040006000004000004080020000000000000022001000000000000840400000000220250000000000080402000420000418000000000000000400040000004080040010200000000000108020020000808332026e8401c9c380833e3c3c846436f93899d883010b05846765746888676f312e32302e32856c696e7578a0112d8f15793e7df7f8dcdb21c891cff78c0d1839cb5b6dcd06116cdbb99536ae88000000000000000008a0cdb97712af6685bb9650d21d609525913293c48adda7c45990926daada335c9b" + } + } + ] + }, + { + "name": "debug_getRawReceipts", + "summary": "Returns an array of EIP-2718 binary-encoded receipts.", + "params": [ + { + "name": "Block", + "required": true, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Receipts", + "schema": { + "title": "Receipt array", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "examples": [ + { + "name": "debug_getRawReceipts example", + "params": [ + { + "name": "Block", + "value": "0x32026E" + } + ], + "result": { + "name": "Receipts", + "value": [ + "0xf901a60182c70eb9010000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000002000000000000000000000008000000000000000000000000000000000040000000001000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000100000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000002000000000100000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000020000000000000000f89df89b947753cfad258efbc52a9a1452e42ffbce9be486cbf863a0ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa00000000000000000000000000828d0386c1122e565f07dd28c7d1340ed5b3315a000000000000000000000000021849e99c31e3113a489d7eb0fd4d8c0edbe47afa00000000000000000000000000000000000000000000000000000000029b92700", + "0xf901a70183018e1cb9010000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000002000000000000000000000008000000000000000000000000000000000040000000001000000000000000000000000000000000000000000000000010000000000000000000000000000000008000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000002000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000020000000000000000f89df89b947753cfad258efbc52a9a1452e42ffbce9be486cbf863a0ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa00000000000000000000000000828d0386c1122e565f07dd28c7d1340ed5b3315a000000000000000000000000069cda9d6cc6ce05982d0b4fdf9480f2991f39b5aa00000000000000000000000000000000000000000000000000000000029b92700" + ] + } + } + ] + }, + { + "name": "debug_getRawTransaction", + "summary": "Returns an array of EIP-2718 binary-encoded transactions.", + "params": [ + { + "name": "Transaction hash", + "required": true, + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "EIP-2718 binary-encoded transaction", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "examples": [ + { + "name": "debug_getRawTransaction example", + "params": [ + { + "name": "Transaction hash", + "value": "0x3a2fd1a5ea9ffee477f449be53a49398533d2c006a5815023920d1c397298df3" + } + ], + "result": { + "name": "EIP-2718 binary-encoded transaction", + "value": "0xf8678084342770c182520894658bdf435d810c91414ec09147daa6db624063798203e880820a95a0af5fc351b9e457a31f37c84e5cd99dd3c5de60af3de33c6f4160177a2c786a60a0201da7a21046af55837330a2c52fc1543cd4d9ead00ddf178dd96935b607ff9b" + } + } + ] + }, + { + "name": "eth_accounts", + "summary": "Returns a list of addresses owned by client.", + "description": "Typically, this request returns a list of addresses owned by a user. However, as Infura doesn't support \"unlocking\" of accounts, consider sending a pre-signed raw transactions using `eth_sendRawTransaction`.", + "params": [], + "result": { + "name": "Accounts", + "description": "Array of hexadecimal address strings owned by the client.", + "schema": { + "title": "Accounts", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + } + }, + "examples": [ + { + "name": "eth_accounts example", + "params": [], + "result": { + "name": "Accounts", + "value": [ + "0xd1f5279be4b4dd94133a23dee1b23f5bfc0db1d0" + ] + } + } + ] + }, + { + "name": "eth_blobBaseFee", + "description": "Returns the expected base fee for blob gas in the next block, in wei.", + "summary": "Returns the base fee per blob gas in wei.", + "params": [], + "result": { + "name": "Blob gas base fee", + "description": "Expected blob gas base fee, in wei, represented as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Blob gas base fee" + } + }, + "examples": [ + { + "name": "eth_blobBaseFee example", + "params": [], + "result": { + "name": "Blob gas base fee", + "value": "0x3f5694c1f" + } + } + ] + }, + { + "name": "eth_blockNumber", + "summary": "Returns the number of most recent block.", + "description": "Returns the current latest block number.", + "params": [], + "result": { + "name": "Block number", + "description": "Hexadecimal integer of the most recent block number.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_blockNumber example", + "params": [], + "result": { + "name": "Block number", + "value": "0x2377" + } + } + ] + }, + { + "name": "eth_call", + "summary": "Execute a new message call", + "description": "This request executes a new message call without creating a transaction on the blockchain. It allows you to invoke a contract function locally to interact with smart contracts and query data without modifying the blockchain state or consuming gas. `eth_call` is ideal for retrieving data, simulating transactions, or testing contract interactions. \nYou may (optionally) specify a block identifier to simulate the transaction on, or estimate gas usage based on the state of the blockchain at that block.\nIf the execution continues beyond the gas cap (10x the block gas limit), the node stops the simulation and returns an error. This prevents demand for excessive computational resource use or API abuse.\n", + "params": [ + { + "name": "transaction", + "required": true, + "description": "Transaction object generic to all Linea-supported transactions. All transaction call object parameters are optional.", + "schema": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + }, + { + "name": "block", + "required": false, + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "eth_callResponse", + "description": "Note that, an `execution reverted` message suggests that the transaction would fail on-chain or that the contract logic has conditions that aren't met when simulating the transaction.", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "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_chainId", + "summary": "Returns the chain ID of the current network.", + "description": "Returns the currently configured chain ID, a value used in replay-protected transaction signing as introduced by EIP-155.", + "params": [], + "result": { + "name": "Chain ID", + "description": "Hexadecimal of the current chain ID.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_chainId example", + "params": [], + "result": { + "name": "Chain ID", + "value": "0x1" + } + } + ] + }, + { + "name": "eth_coinbase", + "summary": "Returns the client coinbase address.", + "description": "Returns the coinbase (mining reward) address of the client.", + "params": [], + "result": { + "name": "Coinbase address", + "description": "20-byte address of the client's coinbase account.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + "examples": [ + { + "name": "eth_coinbase example", + "params": [], + "result": { + "name": "Coinbase address", + "value": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73" + } + } + ] + }, + { + "name": "eth_createAccessList", + "summary": "Generates an access list for a transaction.", + "description": "Creates an EIP-2930 access list to optimize smart-contract interactions by pre-declaring addresses and storage keys a transaction will touch.", + "params": [ + { + "name": "Transaction", + "required": true, + "schema": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "description": "Transaction call object." + }, + { + "name": "Block", + "required": false, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "description": "Block number or tag (`latest`, `earliest`, `pending`, `safe`, `finalized`)." + } + ], + "result": { + "name": "Gas used", + "description": "Object containing the generated `accessList` and `gasUsed` estimate.", + "schema": { + "title": "Access list result", + "type": "object", + "additionalProperties": false, + "properties": { + "accessList": { + "description": "Access list.", + "type": "array", + "title": "accessList", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "error": { + "title": "error", + "type": "string" + }, + "gasUsed": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Gas used" + } + } + } + }, + "examples": [ + { + "name": "eth_createAccessList example", + "params": [ + { + "name": "Transaction", + "value": { + "from": "0xaea8f8f781326bfe6a7683c2bd48dd6aa4d3ba63", + "data": "0x608060806080608155" + } + }, + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Gas used", + "value": { + "accessList": [ + { + "address": "0xa02457e5dfd32bda5fc7e1f1b008aa5979568150", + "storageKeys": [ + "0x0000000000000000000000000000000000000000000000000000000000000081" + ] + } + ], + "gasUsed": "0x125f8" + } + } + } + ] + }, + { + "name": "eth_estimateGas", + "summary": "Generates and returns an estimate of how much gas is necessary to allow the transaction to complete.", + "description": "Generates and returns an estimate of how much gas is necessary to allow the transaction to complete. The transaction will not be added to the blockchain. Note that the estimate may be significantly more than the amount of gas actually used by the transaction, for a variety of reasons including EVM mechanics and node performance.\n\nTo prevent abuse of the API, the `gas` parameter in this `eth_estimateGas` method and in `eth_call` is capped at 10x (1000%) the current block gas limit. You can recreate this behavior in your local test environment (Besu, geth, or other client) using the [`rpc.gascap`](https://geth.ethereum.org/docs/fundamentals/command-line-options#commands) command line option.\n", + "params": [ + { + "name": "Transaction", + "required": true, + "schema": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "description": "Transaction call object." + }, + { + "name": "Block", + "required": false, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "description": "Block number or tag (`latest`, `earliest`, `pending`, `safe`, `finalized`)." + } + ], + "result": { + "name": "Gas used", + "description": "Hexadecimal estimate of gas for the given transaction.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_estimateGas example", + "params": [ + { + "name": "Transaction", + "value": { + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "to": "0x44aa93095d6749a706051658b970b941c72c1d53", + "value": "0x1" + } + } + ], + "result": { + "name": "Gas used", + "value": "0x5208" + } + } + ] + }, + { + "name": "eth_estimateUserOperationGas", + "summary": "Simulates the user operation and estimates the appropriate gas limits.", + "description": "Simulates the user operation and estimates the appropriate gas limits. Returns an error if the operation is unsuccessful. You can use stateOverrides to estimate the gas cost even if the sender has no funds. You can include a dummy signature for the signature field to estimate the gas cost.\n", + "params": [ + { + "name": "userOperation", + "required": true, + "description": "The user operation object.", + "schema": { + "oneOf": [ + { + "type": "object", + "title": "v0.7/v0.8 User Operation", + "required": [ + "sender", + "nonce", + "callGasLimit", + "verificationGasLimit", + "preVerificationGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "signature" + ], + "properties": { + "sender": { + "description": "The address of the account making the operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "Nonce for the request from this sender. Includes the key and sequence number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "factory": { + "description": "The factory contract address that will deploy the smart account if it doesn't exist yet.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "factoryData": { + "description": "The data passed to the factory contract to deploy the smart account.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callData": { + "description": "The data to pass to the sender during the main execution call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum fee per gas, in wei, the sender is willing to pay per gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymaster": { + "description": "Address of paymaster sponsoring the transaction, or null if none.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "paymasterVerificationGasLimit": { + "description": "The amount of gas to allocate for the verification step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterPostOpGasLimit": { + "description": "The amount of gas to allocate for the post-operation step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterData": { + "description": "The data to pass to the paymaster during the verification step.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "signature": { + "description": "The signature data.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "eip7702Auth": { + "type": "object", + "title": "EIP-7702 Authorization", + "description": "EIP-7702 authorization data.", + "properties": { + "address": { + "description": "The contract address for the authorization.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "chainId": { + "description": "The chain ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "The nonce.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "The r component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "s": { + "description": "The s component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "v": { + "description": "The v component of the signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The y-parity value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + }, + { + "type": "object", + "title": "v0.6 User Operation", + "required": [ + "sender", + "nonce", + "initCode", + "callGasLimit", + "verificationGasLimit", + "preVerificationGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "paymasterAndData", + "signature" + ], + "properties": { + "sender": { + "description": "The address of the account making the operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "Nonce for the request from this sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "initCode": { + "description": "The initialization code for the smart account if it doesn't exist yet.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callData": { + "description": "The data to pass to the sender during the main execution call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum fee per gas, in wei, the sender is willing to pay per gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterAndData": { + "description": "The address of the paymaster contract and the data that will be passed to it.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "signature": { + "description": "The signature data.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "eip7702Auth": { + "type": "object", + "title": "EIP-7702 Authorization", + "description": "EIP-7702 authorization data.", + "properties": { + "address": { + "description": "The contract address for the authorization.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "chainId": { + "description": "The chain ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "The nonce.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "The r component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "s": { + "description": "The s component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "v": { + "description": "The v component of the signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The y-parity value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + } + ] + } + }, + { + "name": "entryPoint", + "required": true, + "description": "The EntryPoint contract address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "stateOverrides", + "required": false, + "description": "State overrides to apply for the simulation. Each key is an address, and each value is an object containing optional balance, nonce, code, state, or stateDiff.", + "schema": { + "type": "object", + "title": "State Override", + "properties": { + "balance": { + "description": "The balance to set for the address.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "The nonce to set for the address.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "code": { + "description": "The code to set for the address.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "state": { + "description": "Complete state to set (32-byte storage slots to 32-byte values).", + "type": "object", + "additionalProperties": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "stateDiff": { + "description": "State differences to apply (32-byte storage slots to 32-byte values).", + "type": "object", + "additionalProperties": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ], + "result": { + "name": "gasEstimation", + "description": "An object containing the estimated gas values for the user operation.", + "schema": { + "oneOf": [ + { + "type": "object", + "title": "v0.7/v0.8 Gas Estimation", + "properties": { + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterVerificationGasLimit": { + "description": "The amount of gas to allocate for the verification step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterPostOpGasLimit": { + "description": "The amount of gas to allocate for the post-operation step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "type": "object", + "title": "v0.6 Gas Estimation", + "properties": { + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGas": { + "description": "The amount of gas used for verification (legacy field from v0.6).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_estimateUserOperationGas example", + "params": [ + { + "name": "userOperation", + "value": { + "sender": "0x5a6b47F4131bf1feAFA56A05573314BcF44C9149", + "nonce": "0x845adb2c711129d4f3966735ed98a9f09fc4ce5700000000000000000000", + "factory": "0xd703aaE79538628d27099B8c4f621bE4CCd142d5", + "factoryData": "0xc5265d5d000000000000000000000000aac5d4240af87249b3f71bc8e4a2cae074a3e419", + "callData": "0xe9ae5c5300000000000000000000000000000000000000000000000000000000000000000000000000", + "callGasLimit": "0x0", + "verificationGasLimit": "0x0", + "preVerificationGas": "0x0", + "maxFeePerGas": "0x7a5cf70d5", + "maxPriorityFeePerGas": "0x3b9aca00", + "paymaster": null, + "paymasterVerificationGasLimit": null, + "paymasterPostOpGasLimit": null, + "paymasterData": null, + "signature": "0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c" + } + }, + { + "name": "entryPoint", + "value": "0x0000000071727De22E5E9d8BAf0edAc6f37da032" + } + ], + "jsonrpc": "2.0", + "method": "eth_estimateUserOperationGas", + "id": 1, + "result": { + "name": "gasEstimation", + "value": { + "preVerificationGas": "0xd3e3", + "verificationGasLimit": "0x60b01", + "callGasLimit": "0x13880", + "paymasterVerificationGasLimit": "0x0", + "paymasterPostOpGasLimit": "0x0" + } + } + } + ] + }, + { + "name": "eth_feeHistory", + "summary": "Transaction fee history", + "description": "Returns transaction base fee per gas and effective priority fee per gas for the requested/supported block range.", + "params": [ + { + "name": "blockCount", + "description": "Hexadecimal or decimal integer of the number of blocks for which historical fee data is required; up to maximum of 1024 blocks. Clients will return less than the requested range if not all blocks are available.", + "required": true, + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + { + "name": "newestBlock", + "description": "Hexadecimal or decimal integer representing the highest number block of the requested range, or one of the string tags. Defines the starting point for fetching fee history information. The history will go from this point backward to the provided blockCount, if that data is available.", + "required": true, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + }, + { + "name": "rewardPercentiles", + "description": "Pass empty array if this request is not required. An ordered array of integers of reward percentile values; from smallest to largest as floating point value between 0 and 100. For each block in the requested range, the transactions are sorted in ascending order by effective tip per gas and the corresponding effective tip for the percentile then determined, accounting for gas consumed.", + "required": true, + "schema": { + "title": "rewardPercentiles", + "type": "array", + "items": { + "title": "rewardPercentile", + "description": "Floating point value between 0 and 100.", + "type": "number" + } + } + } + ], + "result": { + "name": "Fee history result", + "description": "Fee history for the returned block range. This can be a subsection of the requested range if not all blocks are available.", + "schema": { + "title": "feeHistoryResults", + "description": "Fee history results.", + "type": "object", + "required": [ + "oldestBlock", + "baseFeePerGas", + "gasUsedRatio" + ], + "additionalProperties": false, + "properties": { + "oldestBlock": { + "description": "Lowest number block of returned range.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "oldestBlock" + }, + "baseFeePerGas": { + "title": "baseFeePerGasArray", + "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.", + "type": "array", + "items": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "baseFeePerBlobGas": { + "title": "baseFeePerBlobGasArray", + "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.", + "type": "array", + "items": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "gasUsedRatio": { + "title": "gasUsedRatio", + "description": "An array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit.", + "type": "array", + "items": { + "title": "ratio", + "description": "Decimal value between 0 and 1.", + "type": "number", + "minimum": 0, + "maximum": 1 + } + }, + "blobGasUsedRatio": { + "title": "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.", + "type": "array", + "items": { + "title": "ratio", + "description": "Decimal value between 0 and 1.", + "type": "number", + "minimum": 0, + "maximum": 1 + } + }, + "reward": { + "title": "rewardArray", + "description": "A two-dimensional array of effective priority fees per gas at the requested block percentiles.", + "type": "array", + "items": { + "title": "rewardPercentile", + "description": "An array of effective priority fee per gas data points from a single block. All zeroes are returned if the block is empty.", + "type": "array", + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "rewardPercentile" + } + } + } + } + } + }, + "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": { + "oldestblock": "0x10b52f", + "baseFeePerGas": [ + "0x3fa63a3f", + "0x37f999ee", + "0x3e36f20a", + "0x4099f79a", + "0x430d532d", + "0x46fcd4a4" + ], + "baseFeePerBlobGas": [ + "0x7b7609c19", + "0x6dbe41789", + "0x7223341d4", + "0x6574a002c", + "0x7223341d4", + "0x6574a002c" + ], + "gasUsedRatio": [ + 0.017712333333333333, + 0.9458865666666667, + 0.6534561, + 0.6517375666666667, + 0.7347769666666667 + ], + "blobGasUsedRatio": [ + 0, + 0.6666666666666666, + 0, + 1, + 0 + ], + "reward": [ + [ + "0x3b9aca00", + "0x59682f00" + ], + [ + "0x3a13012", + "0x3a13012" + ], + [ + "0x3a13012", + "0x3a13012" + ], + [ + "0xf4240", + "0xf4240" + ], + [ + "0xf4240", + "0xf4240" + ] + ] + } + } + } + ] + }, + { + "name": "eth_gasPrice", + "description": "Returns the current gas price in wei.", + "summary": "Returns the current price per gas in wei.", + "params": [], + "result": { + "name": "Gas price", + "description": "Current gas price, in wei, represented as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Gas price" + } + }, + "examples": [ + { + "name": "eth_gasPrice example", + "params": [], + "result": { + "name": "Gas price", + "value": "0x3e8" + } + } + ] + }, + { + "name": "eth_getBalance", + "description": "Returns the balance of an address at a specific block.", + "summary": "Returns the balance of the account of given address.", + "params": [ + { + "name": "Address", + "required": true, + "description": "20-byte account address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Balance", + "description": "Current account balance (wei) as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_getBalance example", + "params": [ + { + "name": "Address", + "value": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73" + }, + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Balance", + "value": "0x1cfe56f3795885980000" + } + } + ] + }, + { + "name": "eth_getBlockByHash", + "summary": "Get block by block hash", + "description": "This request returns block data for the given block hash. You can use this method to view the transactions in a block, or the transaction hashes.", + "params": [ + { + "name": "Block hash", + "required": true, + "schema": { + "description": "A string representing the hash (32 bytes) of a block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "name": "Hydrated transactions", + "description": "For hashes pass `false`, for detailed transaction objects, pass `true`.", + "required": true, + "schema": { + "title": "hydrated", + "type": "boolean" + } + } + ], + "result": { + "name": "Block information", + "description": "Block object matching the given hash, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getBlockByHash example", + "params": [ + { + "name": "Block hash", + "value": "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c" + }, + { + "name": "Hydrated transactions", + "value": false + } + ], + "result": { + "name": "Block information", + "value": { + "number": "0x68b3", + "hash": "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c", + "mixHash": "0x24900fb3da77674a861c428429dce0762707ecb6052325bbd9b3c64e74b5af9d", + "parentHash": "0x1f68ac259155e2f38211ddad0f0a15394d55417b185a93923e2abe71bb7a4d6d", + "nonce": "0x378da40ff335b070", + "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "logsBloom": "0x00000000000000100000004080000000000500000000000000020000100000000800001000000004000001000000000000000800040010000020100000000400000010000000000000000040000000000000040000000000000000000000000000000400002400000000000000000000000000000004000004000000000000840000000800000080010004000000001000000800000000000000000000000000000000000800000000000040000000020000000000000000000800000400000000000000000000000600000400000000002000000000000000000000004000000000000000100000000000000000000000000000000000040000900010000000", + "transactionsRoot": "0x4d0c8e91e16bdff538c03211c5c73632ed054d00a7e210c0eb25146c20048126", + "stateRoot": "0x91309efa7e42c1f137f31fe9edbe88ae087e6620d0d59031324da3e2f4f93233", + "receiptsRoot": "0x68461ab700003503a305083630a8fb8d14927238f0bc8b6b3d246c0c64f21f4a", + "miner": "0xb42b6c4a95406c78ff892d270ad20b22642e102d", + "difficulty": "0x66e619a", + "totalDifficulty": "0x1e875d746ae", + "extraData": "0xd583010502846765746885676f312e37856c696e7578", + "size": "0x334", + "gasLimit": "0x47e7c4", + "gasUsed": "0x37993", + "timestamp": "0x5835c54d", + "uncles": [], + "transactions": [ + "0xa0807e117a8dd124ab949f460f08c36c72b710188f01609595223b325e58e0fc", + "0xeae6d797af50cb62a596ec3939114d63967c374fa57de9bc0f4e2b576ed6639d" + ], + "baseFeePerGas": "0x7", + "withdrawalsRoot": "0x7a4ecf19774d15cf9c15adf0dd8e8a250c128b26c9e2ab2a08d6c9c8ffbd104f", + "withdrawals": [ + { + "index": "0x0", + "validatorIndex": "0x9d8c0", + "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f", + "amount": "0x11a33e3760" + } + ], + "blobGasUsed": "0x0", + "excessBlobGas": "0x0", + "parentBeaconBlockRoot": "0x95c4dbd5b19f6fe3cbc3183be85ff4e85ebe75c5b4fc911f1c91e5b7a554a685" + } + } + } + ] + }, + { + "name": "eth_getBlockByNumber", + "summary": "Returns information about a block by number.", + "description": "Returns information about a block given its block number.", + "params": [ + { + "name": "Block", + "required": true, + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + }, + { + "name": "Hydrated transactions", + "required": true, + "schema": { + "title": "hydrated", + "type": "boolean", + "description": "If `true`, returns full transaction objects; if `false`, returns only transaction hashes." + } + } + ], + "result": { + "name": "Block information", + "description": "Block object matching the given block number, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getBlockByNumber example", + "params": [ + { + "name": "block", + "value": "0x68B3" + }, + { + "name": "Hydrated transactions", + "value": false + } + ], + "result": { + "name": "Block information", + "value": { + "number": "0x68b3", + "hash": "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c", + "mixHash": "0x24900fb3da77674a861c428429dce0762707ecb6052325bbd9b3c64e74b5af9d", + "parentHash": "0x1f68ac259155e2f38211ddad0f0a15394d55417b185a93923e2abe71bb7a4d6d", + "nonce": "0x378da40ff335b070", + "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "logsBloom": "0x00000000000000100000004080000000000500000000000000020000100000000800001000000004000001000000000000000800040010000020100000000400000010000000000000000040000000000000040000000000000000000000000000000400002400000000000000000000000000000004000004000000000000840000000800000080010004000000001000000800000000000000000000000000000000000800000000000040000000020000000000000000000800000400000000000000000000000600000400000000002000000000000000000000004000000000000000100000000000000000000000000000000000040000900010000000", + "transactionsRoot": "0x4d0c8e91e16bdff538c03211c5c73632ed054d00a7e210c0eb25146c20048126", + "stateRoot": "0x91309efa7e42c1f137f31fe9edbe88ae087e6620d0d59031324da3e2f4f93233", + "receiptsRoot": "0x68461ab700003503a305083630a8fb8d14927238f0bc8b6b3d246c0c64f21f4a", + "miner": "0xb42b6c4a95406c78ff892d270ad20b22642e102d", + "difficulty": "0x66e619a", + "totalDifficulty": "0x1e875d746ae", + "extraData": "0xd583010502846765746885676f312e37856c696e7578", + "size": "0x334", + "gasLimit": "0x47e7c4", + "gasUsed": "0x37993", + "timestamp": "0x5835c54d", + "uncles": [], + "transactions": [ + "0xa0807e117a8dd124ab949f460f08c36c72b710188f01609595223b325e58e0fc", + "0xeae6d797af50cb62a596ec3939114d63967c374fa57de9bc0f4e2b576ed6639d" + ], + "baseFeePerGas": "0x7", + "withdrawalsRoot": "0x7a4ecf19774d15cf9c15adf0dd8e8a250c128b26c9e2ab2a08d6c9c8ffbd104f", + "withdrawals": [ + { + "index": "0x0", + "validatorIndex": "0x9d8c0", + "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f", + "amount": "0x11a33e3760" + } + ], + "blobGasUsed": "0x0", + "excessBlobGas": "0x0", + "parentBeaconBlockRoot": "0x95c4dbd5b19f6fe3cbc3183be85ff4e85ebe75c5b4fc911f1c91e5b7a554a685" + } + } + } + ] + }, + { + "name": "eth_getBlockReceipts", + "summary": "Returns the receipts of a block by number or hash.", + "description": "Returns all transaction receipts for a given block, the amount of gas used, and any event logs that might have been produced by a smart contract during the transactions.", + "params": [ + { + "name": "Block", + "required": true, + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Receipts information", + "description": "Array of receipt objects for the specified block, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "title": "Receipts information", + "type": "array", + "items": { + "type": "object", + "required": [ + "blockHash", + "blockNumber", + "from", + "cumulativeGasUsed", + "gasUsed", + "logs", + "logsBloom", + "transactionHash", + "transactionIndex", + "effectiveGasPrice" + ], + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte.", + "type": "string", + "pattern": "^0x([0-9a-fA-F]?){1,2}$" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Address of the call initiator.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "Address of the receiver or null in a contract creation transaction.", + "oneOf": [ + { + "title": "Contract Creation (null)", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Recipient Address" + } + ] + }, + "cumulativeGasUsed": { + "description": "The sum of gas used by this transaction and all preceding transactions in the same block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "The amount of gas used for this specific transaction alone.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasUsed": { + "description": "The amount of blob gas used for this specific transaction. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "contractAddress": { + "description": "The contract address created, if the transaction was a contract creation, otherwise null.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + }, + { + "title": "No data", + "type": "null" + } + ] + }, + "logs": { + "description": "Logs.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "logsBloom": { + "description": "Logs bloom.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "root": { + "description": "The post-transaction state root. Only specified for transactions included before the Byzantium upgrade.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "status": { + "description": "Either 1 (success) or 0 (failure). Only specified for transactions included after the Byzantium upgrade.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "enum": [ + "0x0", + "0x1" + ] + }, + "effectiveGasPrice": { + "description": "The actual value per gas deducted from the sender's account. Before EIP-1559, this is equal to the transaction's gas price. After, it is equal to baseFeePerGas + min(maxFeePerGas - baseFeePerGas, maxPriorityFeePerGas).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasPrice": { + "description": "The actual value per gas deducted from the sender's account for blob gas. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getBlockReceipts example", + "params": [ + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Receipts information", + "value": [ + { + "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182", + "blockNumber": "0x6f55", + "contractAddress": null, + "cumulativeGasUsed": "0x18c36", + "from": "0x22896bfc68814bfd855b1a167255ee497006e730", + "gasUsed": "0x18c36", + "blobGasUsed": "0x20000", + "effectiveGasPrice": "0x9502f907", + "blobGasPrice": "0x32", + "logs": [ + { + "address": "0xfd584430cafa2f451b4e2ebcf3986a21fff04350", + "topics": [ + "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d", + "0x4be29e0e4eb91f98f709d98803cba271592782e293b84a625e025cbb40197ba8", + "0x000000000000000000000000835281a2563db4ebf1b626172e085dc406bfc7d2", + "0x00000000000000000000000022896bfc68814bfd855b1a167255ee497006e730" + ], + "data": "0x", + "blockNumber": "0x6f55", + "transactionHash": "0x4a481e4649da999d92db0585c36cba94c18a33747e95dc235330e6c737c6f975", + "transactionIndex": "0x0", + "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182", + "logIndex": "0x0", + "removed": false + } + ], + "logsBloom": "0x00000004000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000080020000000000000200010000000000000000000001000000800000000000000000000000000000000000000000000000000000100100000000000000000000008000000000000000000000000000000002000000000000000000000", + "status": "0x1", + "to": "0xfd584430cafa2f451b4e2ebcf3986a21fff04350", + "transactionHash": "0x4a481e4649da999d92db0585c36cba94c18a33747e95dc235330e6c737c6f975", + "transactionIndex": "0x0", + "type": "0x0" + }, + { + "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182", + "blockNumber": "0x6f55", + "contractAddress": null, + "cumulativeGasUsed": "0x1de3e", + "from": "0x712e3a792c974b3e3dbe41229ad4290791c75a82", + "gasUsed": "0x5208", + "blobGasUsed": "0x20000", + "effectiveGasPrice": "0x9502f907", + "blobGasPrice": "0x32", + "logs": [], + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "status": "0x1", + "to": "0xd42e2b1c14d02f1df5369a9827cb8e6f3f75f338", + "transactionHash": "0xefb83b4e3f1c317e8da0f8e2fbb2fe964f34ee184466032aeecac79f20eacaf6", + "transactionIndex": "0x1", + "type": "0x2" + } + ] + } + } + ] + }, + { + "name": "eth_getBlockTransactionCountByHash", + "summary": "Returns the number of transactions in a block from a block matching the given block hash.", + "description": "Returns the number of transactions in the block with the given block hash.", + "params": [ + { + "name": "Block hash", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Transaction count", + "description": "Hexadecimal transaction count in the block, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Transaction count" + } + ] + } + }, + "examples": [ + { + "name": "eth_getBlockTransactionCountByHash example", + "params": [ + { + "name": "Block hash", + "value": "0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238" + } + ], + "result": { + "name": "Transaction count", + "value": "0x8" + } + } + ] + }, + { + "name": "eth_getBlockTransactionCountByNumber", + "summary": "Returns the number of transactions in a block matching the given block number.", + "description": "Returns the number of transactions in the block with the given block number.", + "params": [ + { + "name": "Block", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Transaction count", + "description": "Hexadecimal transaction count in the block, or `null` when no block was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Transaction count" + } + ] + } + }, + "examples": [ + { + "name": "eth_getBlockTransactionCountByNumber example", + "params": [ + { + "name": "Block", + "value": "0xe8" + } + ], + "result": { + "name": "Transaction count", + "value": "0x8" + } + } + ] + }, + { + "name": "eth_getCode", + "description": "Returns the runtime bytecode stored at an address.", + "summary": "Returns code at a given address.", + "params": [ + { + "name": "Address", + "required": true, + "description": "Account or contract address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Bytecode", + "description": "Hex-encoded contract bytecode, or `0x` if the address contains no code.", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "examples": [ + { + "name": "eth_getCode example", + "params": [ + { + "name": "Address", + "value": "0xa50a51c09a5c451c52bb714527e1974b686d8e77" + }, + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Bytecode", + "value": "0x60806040526004361060485763ffffffff7c01000000000000000000000000000000000000000000000000000000006000350416633fa4f2458114604d57806355241077146071575b600080fd5b348015605857600080fd5b50605f6088565b60408051918252519081900360200190f35b348015607c57600080fd5b506086600435608e565b005b60005481565b60008190556040805182815290517f199cd93e851e4c78c437891155e2112093f8f15394aa89dab09e38d6ca0727879181900360200190a1505600a165627a7a723058209d8929142720a69bde2ab3bfa2da6217674b984899b62753979743c0470a2ea70029" + } + } + ] + }, + { + "name": "eth_getFilterChanges", + "summary": "Polling method for the filter with the given ID (created using `eth_newFilter`). Returns an array of logs which occurred since last poll.", + "description": "Polls the specified filter and returns changes since the last call. Depending on filter type, the result is an array of log objects, block hashes, or transaction hashes.", + "params": [ + { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` to poll.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Log objects", + "description": "Array of items matching the filter (log objects, block hashes, or transaction hashes).", + "schema": { + "oneOf": [ + { + "title": "New block or transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "New logs", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getFilterChanges example", + "params": [ + { + "name": "Filter identifier", + "value": "0x01" + } + ], + "result": { + "name": "Log objects", + "value": [ + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x233", + "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5", + "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000004", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + }, + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x238", + "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed", + "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000007", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + } + ] + } + } + ] + }, + { + "name": "eth_getFilterLogs", + "summary": "Returns an array of all logs matching the filter with the given ID (created using `eth_newFilter`).", + "description": "Retrieves all logs that match the specified filter ID, without resetting the filter's internal state.", + "params": [ + { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` to query.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Log objects", + "description": "Array of log objects that matched the filter since its creation.", + "schema": { + "oneOf": [ + { + "title": "New block or transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "New logs", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getFilterLogs example", + "params": [ + { + "name": "Filter identifier", + "value": "0x01" + } + ], + "result": { + "name": "Log objects", + "value": [ + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x233", + "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5", + "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000004", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + }, + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x238", + "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed", + "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000007", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + } + ] + } + } + ] + }, + { + "name": "eth_getLogs", + "summary": "Returns an array of all logs matching the specified filter.", + "description": "Returns logs that match the provided filter object parameters (`address`, `fromBlock`, `toBlock`, `topics`).", + "params": [ + { + "name": "Filter", + "description": "Filter object defining log criteria.", + "schema": { + "type": "object", + "additionalProperties": false, + "properties": { + "fromBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "toBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "address": { + "description": "A contract address or a list of addresses from which logs should originate.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "address": null, + "title": "Single address" + }, + { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "addresses": null, + "title": "List of addresses" + } + ] + }, + "topics": { + "description": "An array of 32 bytes DATA topics. Topics are order-dependent. `null` (empty array) provides any topic match.", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ], + "result": { + "name": "Log objects", + "description": "Array of log objects that satisfy the filter.", + "schema": { + "oneOf": [ + { + "title": "New block or transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "New logs", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getLogs example", + "params": [ + { + "name": "Filter", + "value": { + "fromBlock": "0x137d3c2", + "toBlock": "0x137d3c3", + "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", + "topics": [] + } + } + ], + "result": { + "name": "Log objects", + "value": [ + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x233", + "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5", + "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000004", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + }, + { + "logIndex": "0x0", + "removed": false, + "blockNumber": "0x238", + "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed", + "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058", + "transactionIndex": "0x0", + "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", + "data": "0x0000000000000000000000000000000000000000000000000000000000000007", + "topics": [ + "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" + ] + } + ] + } + } + ] + }, + { + "name": "eth_getProof", + "description": "Returns the Merkle proof for an account and optional storage keys per EIP-1186.", + "summary": "Returns the merkle proof for a given account and optionally some storage keys.", + "params": [ + { + "name": "Address", + "required": true, + "description": "A string identifier for the contract or EOA address (20 bytes).", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "StorageKeys", + "required": true, + "description": "Storage keys may be specified to retrieve the storage proofs for particular slots in a smart contract's storage. If not required, pass empty array.", + "schema": { + "title": "Storage keys", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + } + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Account", + "description": "Account proof object containing account and storage proofs.", + "schema": { + "type": "object", + "required": [ + "address", + "accountProof", + "balanceeth_getBalance", + "codeHash", + "nonce", + "storageHash", + "storageProof" + ], + "additionalProperties": false, + "properties": { + "address": { + "description": "The account address for which the Merkle proof is retrieved. This is an echo of the address passed in the request.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "accountProof": { + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `stateRoot`-Node, following the path of the address as key.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "balance": { + "description": "Hexadecimal of the balance in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "codeHash": { + "description": "The 32-byte hash of the account's code. For EOAs, this will be the hash of an empty string. For contract accounts, it represents the hash of the deployed contract code.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "storageHash": { + "description": "32-byte SHA3 hash of the storage root. All storage will deliver a Merkle proof starting with this root hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "storageProof": { + "description": "An array of requested storage-entries.", + "type": "array", + "items": { + "type": "object", + "required": [ + "key", + "value", + "proof" + ], + "additionalProperties": false, + "properties": { + "key": { + "description": "The requested storage key.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + }, + "value": { + "description": "The storage value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "proof": { + "type": "array", + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `storageHash` node and following the path of the key.", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + } + } + } + } + } + }, + "examples": [ + { + "name": "eth_getProof example", + "params": [ + { + "name": "Address", + "value": "0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8" + }, + { + "name": "StorageKeys", + "value": [ + "0x56e81f", + "0x283s34" + ] + }, + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Account", + "value": { + "accountProof": [ + "0xf90211a06a718c2c9da77c253b12d7b2569657901e37bb691718f5dda1b86157ab1dd5eda0e7f19ed5e21bccc8d3260236b24f80ad88b3634f5d005f37b838881f0e12f1bda0abb301291704e4d92686c0f5f8ebb1734185321559b8d717ffdca95c99591976a0d0c2026bfab65c3b95276bfa82af9dec860b485f8857f293c148d63a2182128fa0c98044ec9a1273a218bed58b478277dd39173ad7b8edb95c200423a6bc8fc25fa056e5a55d9ddccdbf49362857200bbb1f042d61187c9f5f9ddcff5d2f1fc984a2a02a5b7200af424114f99a4b5f0a21c19aac82209e431ed80bfde177adb1004bdfa0026e4374f0518ff44a80fa374838ecb86cc64ac93bb710fea6dff4198f947b27a03fea341d87984673ad523177ed52f278bf4d8f97e6531c8ece932aeede4802f4a0bfe2f4a7fcb78f7e9f080dea7b6977fb1d88c441696e4456dad92b9d34ff0f43a02a3eb5c0edb14626c9c629601027bd60178bb2b688a67cea4d179fc432436615a0747355b8e02f3b884b4ffe5cea1619e32515fea064cca98208591af8c744e894a0874253737bae37f020ad3bb7e3292c7c4a63cdc158af6b33aaa4deaef016dccba03d8192bc1fc6aa1548912e763a0b5013a94399cefad7b47cf388873b2b794068a09b67f9737c6028d796bfd1c5da57a6f45824dc891f848ea0e1f8019d1fb5fba8a0aa871f9de8da85960fcd8a22cdf21c27f11e3966c14a6737ffd414b98dda00b280", + "0xf90211a0d360be1e1da1a0c32bc4c105833bd531e59d110684007b7c50fb2709002973eca0cf6dd1e350a7031b4e2ab49c899fd8bd47551c8565d8fd8d1d7796c83820c3b1a0eb0a88c29bb33989a589156f7bf07d9efc74034dd9d3f5b73385c3b45c3249bea02783c25f97a6ddb8dc07adf4b176991836d39184b1f678adeda832fff15e3664a00a4e288060045e587774d8a64993a7add73068b16863145e1e8eeb4602e18e19a0340851f4046ad1298962d6e47d05c66329549c839c158748aaad7ae00b943aefa085b127bc2a3bd17604283de21b2b3c9aa8f1d4b7b85c94d8105a46fe32c77688a00f531d62b3c5435324c01009c284fe31277e8d38302b75ea01be89f09e205969a00011c8351c0e3d639ac54b9d3a59de630b16a67de8270d7d6064d0a67e93f9cca048780d32b7f2db88650b51c46f46fd0a68795edee1fd5ecee6eb3595741d9669a0c91afd74eaf8e08a997061a62b354e2516fdc494e8e26cc50ceeb8f4a175608ba0e2c07f1b48fab80eecb340f5882e8c7b32ee416e4045c61f1df646a133487303a01a1eff78435a7a29a29463bdc3486ae81364b00bea82ba0fdf67a110770f2261a04f2eb440ba71c72da5fd7f0e439018d6671dc809f747213a1ea755848124e994a074ff9f37fce99daa3ed01dd763076450022996fc729be2cc43c61ec5182c2366a0b80b36b7b621112592f52390b89748d422e9b1517c4b0203b8176a53f89d4a6680", + "0xf90211a0b25f283bd01a8c8b2418049f9585bc37ff2c1e2e12eab4b7f64ae1f26647389aa02ad96c150d7c3c9c194d30315456852cf6a0a940e0191ae5d04007454823d4e9a0b220cf7a855e2dbcc0b973134e2e119b982d7d40dbb1b27d99816c41f40e829aa049224431da84cbf1b7ae813abcc9ef4c1dfc1760f6ddc5d57f7354bf3cbf6cc4a015191f879ac115b362f0257fd3eedb789537e836574a5b1abf1c9982ebe3bdfea07913c1b6e7282569d2d421e9fa2257f5d1698e93303bc49b941704287d7aaefea0a526576981ce6fd9f2bd48dd2ca6d5272f2fbdc85f0ee35a295f6ccd97ae8765a0313fad407f0c737c29024c02a890c4ecc12d7771c05ab7b435e5087a7cdef4d9a0d2044603cba9d4afdaf6fd2470e729ef3a65242de71276f20d59accfa6b53a7ca0457caacb9370c09b15f7d904adefd2308be94e23669ba5f43241ffff5f438a0aa09fb2dd45a383a0cc088a72b14117e1e9b7d6889218f3ac7631e8de644c5cb76da0c675dcd4d3fb692b514851c6106e2b09e6f5661d56a0a32ae02e2efc1515c235a074949a59ff1bdba87548510d6e404ec4532f4456dfdec8e753d92fda11a3088ba0a328c6ab1ab8f70db4d23e95bb163c13ba0c508f063a5b1393a4efd7ff375f05a0c722fe3ce796998269373cbb2fc229b2bdf2c43c6c2df003309422e043ce6c03a024e69343286eec44fa4744f6907209116e5383cff3fa98fe81ba06e7e8d4366680", + "0xf90211a00e99ba2198124b8241ea304551fe973215829e2fbc0438d67922707a2a847432a0bb9ce24fd527879c5fe6dbbec1ef5a05ed9d1ca88e921d140bafbec1112f6a6aa099787fd6c7a1989229c4291ef5267335e66152ce417daea46e66d19cb6f81d1ca0e430ff4b8d5621baa5978673344e78b4d8b4df51431b6e63785267c98a24ce18a0bb3e91a825fe3d42ed270a93e9ad1aabd566c40cb28e622f7f1d7ee967c8afd6a0aa364b0056870c6507bc3262a5f851ecb13684088bdb13996d3cb2db401ce3ffa0a3732eba4c7a6e062665ab5be08acb986c3db87556fb138548cc900ff1e56995a026b088e90c9738b8ce16e853107a937a50d52726a24f9f6ce60f587762eb45a2a006c9d5bc3c064b5c1fb565bff91cace9161c64ae653a329610c1dcf34d434429a06c16df2edc70656d322d0c2403bad7d45bc790ffc3e7adeef856d98ea6afc91ba0ae05ed5d6c34b5da29c2e94d7880aeba0906f95f4ec10b132a1d4766a0701c98a01470a86aa350d1ada0c082eac75de828a851f9c8c7c4aa49b1556fe3a5574966a0334eef025100a6da1033710dd98e0475f29d3d7e397caf618ca71c336c5f4f49a0ef0b3abbebcff34d6a8a8f5cdbfbd154ab3452b58dcb09de58ec983644963675a041857e865ec38e200a13bc1a3cb71c7d69aeef7ffdee8be515c9a5b691ce091fa059edd0eb3bbec36bbf38a19802d4646c00ba821ab55fdeea12e15bab62c4e1e580", + "0xf90211a0af0c7fa65ffcb84c31e68c1cf00e1a20bf8bb497c39883e19b66a99975b03431a0c492cab3623eb7926069794c3c718733e16c5fd0d4a13fb7c752ee9809aac7ada05003cea7132aa70d6f36731d60640a90bcd8f4fd493e4540d5ab1b4943679c0ca0fd700683405b1d2306b586dd3b5b2f92f1692fae20d17cd8b8e59d09b9c6670da01db8683910e46e56e8afeb9fe2b7c35382e5a0914d7b0dd8f0e8cb9981ba7435a0fa7f75d73aa73c35824387bec81388315caa4aee3f4f5562f971beb256c62d49a0ee478e420d83f413e8568dacfd5d83f83a5dd7c45f494b504828e5dc962f0e3ea094b95444a917ac94a675681f6bf851172ad0969801a783a63a71edafed45e7a7a0a0c46586e109abe80fe50361dd582e3f143cb416828239faa43bb2b890869501a0ae051d5d43634c68bf9c97823256cc68580f194dfdbd0c301140c7ca5853430ca0660b9365bb77ec9cdc6eb95516c162dca20727c6f828dbbeb1ae110dde4d3134a09feb1b75e84ff6722e4d837bfb6d207b6ee3b21b86844a01140ce293813b49a1a0ed58a70b04efa3bdc0babe2abfa20824a75d61d52291bfdb5cf08597800764d6a020a2d5d3a83f9e35ad9fd1c448626d90af0eb3efefaa4f2f93207b4096ef5507a0fc8efc4484dcf0a54f0574de9aaade0dcff6ec3599edb9f82efb26b6566dcaeaa032f7e79856db3fd984f72bb2c93d4dab328198d355a61c975fab1f08bdb2046580" + ], + "balance": "0x0", + "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470", + "nonce": "0x0", + "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "storageProof": [ + { + "key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "proof": [ + "0xf90211a0c87222cccea2bf32759fcee9dbaacbe3ea4165dd6184af6773651c5e00e34a8ba0be90e6e5d1a67ab5587779c60ac136d6a96db62b84c04998a5f03a367346abd6a05344aa1c9ca2e3e56bf98fd718ec43728578d148e1967fbaf8bf17a2a073a0bda011a2f9312c3308640a0d6ceeae218747290f23806067456da1d444c65abae437a0b3097a108bfce79af6699da4ae3003cd4929f0b4576aad655c31cb725bde84c7a0c133d3c637e174f36a73c22b1039eb003da6374bc0929321241badb3efa3c4a9a0f13059f2301ad9862ce02e3f7f3f2c9ab78eb30583764d73654f7f1f8b1e86fda06544e3915748b18204e09df75ff20d2fa6bd8121e2e669699012d54590383d6fa070e3a8e093691581d58fadb560b510262a758037632cd8670d3a36df828976b7a062a88a2900544dc76a32255a6b2b2a2eef8fa68279700c00adc7508286702552a0a474aeebd5603dfce46a6ecd1ecd519068dc034a544fde03ac42d4018e60a334a0b7d528fc41c8fdc8ea18c6e7d0099270c777ec1403cf879d1f5134bdc12a6c6ca04440f1242e42c5bfa7c536591ab89c8e84bea417435871c32eef1e25295b20daa06a5dcfe3cc84cff9d3e3c3ae868cfba8f0dd111a90c3f85869dab5b893f96643a026b2fb9dd7d08b0ed2f1c44fbf875011412a384f86f751c92e1013248d4aa371a0c75597b2b789fc4e939b71937390ce9d7d53159431328ac52180eef08ef200f280", + "0xf90191a0f0c5b800b542001597f2b7a8e106ac0e2849d2cc1df1727ac35c4ea3965f1c9180a08537f2e248702a6ae2a57e9110a5740f5772c876389739ac90debd6a0692713ea00b3a26a05b5494fb3ff6f0b3897688a5581066b20b07ebab9252d169d928717fa0a9a54d84976d134d6dba06a65064c7f3a964a75947d452db6f6bb4b6c47b43aaa01e2a1ed3d1572b872bbf09ee44d2ed737da31f01de3c0f4b4e1f046740066461a076f251d160b9a02eb0b5c1d83b61c9cdd4f37361705e79a45529bf49801fb824a0774a01a624cb14a50d17f2fe4b7ae6af8a67bbb029177ccc3dd729a734484d3ea05921b8a19aebe4fff5a36071e311778f9b93459183fdf7f6d870b401fa25dcbba0c8d71dd13d2806e2865a5c2cfa447f626471bf0b66182a8fd07230434e1cad2680a0e9864fdfaf3693b2602f56cd938ccd494b8634b1f91800ef02203a3609ca4c21a0c69d174ad6b6e58b0bd05914352839ec60915cd066dd2bee2a48016139687f21a0513dd5514fd6bad56871711441d38de2821cc6913cb192416b0385f025650731808080" + ], + "value": "0x1" + } + ] + } + } + } + ] + }, + { + "name": "eth_getStorageAt", + "description": "Returns the value stored at a given storage slot for an address.", + "summary": "Returns the value from a storage position at a given address.", + "params": [ + { + "name": "Address", + "required": true, + "description": "Contract or account address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "Storage slot", + "required": true, + "description": "32-byte storage slot index (hex).", + "schema": { + "description": "Hex-encoded 256 bit unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Value", + "description": "Hex-encoded value stored at the given slot.", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "examples": [ + { + "name": "eth_getStorageAt example", + "params": [ + { + "name": "Address", + "value": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73" + }, + { + "name": "Storage slot", + "value": "0x0" + }, + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Value", + "value": "0x0000000000000000000000000000000000000000000000000000000000000000" + } + } + ] + }, + { + "name": "eth_getTransactionByBlockHashAndIndex", + "summary": "Returns information about a transaction by block hash and transaction index position.", + "description": "Returns a transaction from a specific block, queried by block hash and transaction index.", + "params": [ + { + "name": "Block hash", + "required": true, + "description": "32-byte block hash.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "name": "Transaction index", + "required": true, + "description": "Hexadecimal index of the transaction in the block.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Transaction information", + "description": "Transaction object, or `null` when no transaction was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getTransactionByBlockHashAndIndex example", + "params": [ + { + "name": "Block hash", + "value": "0xbf137c3a7a1ebdfac21252765e5d7f40d115c2757e4a4abee929be88c624fdb7" + }, + { + "name": "Transaction index", + "value": "0x2" + } + ], + "result": { + "name": "Transaction information", + "value": { + "blockHash": "0x510efccf44a192e6e34bcb439a1947e24b86244280762cbb006858c237093fda", + "blockNumber": "0x422", + "chainId": 2018, + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0x5208", + "gasPrice": "0x3b9aca00", + "hash": "0xa52be92809541220ee0aaaede6047d9a6c5d0cd96a517c854d944ee70a0ebb44", + "input": "0x", + "nonce": "0x1", + "to": "0x627306090abab3a6e1400e9345bc60c78a8bef57", + "transactionIndex": "0x0", + "value": "0x4e1003b28d9280000", + "v": "0xfe7", + "r": "0x84caf09aefbd5e539295acc67217563438a4efb224879b6855f56857fa2037d3", + "s": "0x5e863be3829812c81439f0ae9d8ecb832b531d651fb234c848d1bf45e62be8b9" + } + } + } + ] + }, + { + "name": "eth_getTransactionByBlockNumberAndIndex", + "summary": "Returns information about a transaction by block number and transaction index position.", + "description": "Returns a transaction from a specific block number (or tag) and transaction index.", + "params": [ + { + "name": "Block", + "required": true, + "description": "Hexadecimal block number or tag (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + }, + { + "name": "Transaction index", + "required": true, + "description": "Hexadecimal index of the transaction in the block.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Transaction information", + "description": "Transaction object, or `null` when no transaction was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getTransactionByBlockNumberAndIndex example", + "params": [ + { + "name": "Block", + "value": "0x1442e" + }, + { + "name": "Transaction index", + "value": "0x2" + } + ], + "result": { + "name": "Transaction information", + "value": { + "blockHash": "0x510efccf44a192e6e34bcb439a1947e24b86244280762cbb006858c237093fda", + "blockNumber": "0x422", + "chainId": 2018, + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0x5208", + "gasPrice": "0x3b9aca00", + "hash": "0xa52be92809541220ee0aaaede6047d9a6c5d0cd96a517c854d944ee70a0ebb44", + "input": "0x", + "nonce": "0x1", + "to": "0x627306090abab3a6e1400e9345bc60c78a8bef57", + "transactionIndex": "0x0", + "value": "0x4e1003b28d9280000", + "v": "0xfe7", + "r": "0x84caf09aefbd5e539295acc67217563438a4efb224879b6855f56857fa2037d3", + "s": "0x5e863be3829812c81439f0ae9d8ecb832b531d651fb234c848d1bf45e62be8b9" + } + } + } + ] + }, + { + "name": "eth_getTransactionByHash", + "summary": "Returns the information about a transaction requested by transaction hash.", + "description": "Returns information about a transaction given its transaction hash. Maximal Extractable Value (MEV) protection is available for all Infura customers on Mainnet. This means `r`, `s`, and `v` signature fields might return empty hex values (0x0) while the transaction is pending on Mainnet.", + "params": [ + { + "name": "Transaction hash", + "required": true, + "description": "32-byte transaction hash.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Transaction information", + "description": "Transaction object, or `null` when no transaction was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getTransactionByHash example", + "params": [ + { + "name": "Transaction hash", + "value": "0xa52be92809541220ee0aaaede6047d9a6c5d0cd96a517c854d944ee70a0ebb44" + } + ], + "result": { + "name": "Transaction information", + "value": { + "blockHash": "0x510efccf44a192e6e34bcb439a1947e24b86244280762cbb006858c237093fda", + "blockNumber": "0x422", + "chainId": 2018, + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0x5208", + "gasPrice": "0x3b9aca00", + "hash": "0xa52be92809541220ee0aaaede6047d9a6c5d0cd96a517c854d944ee70a0ebb44", + "input": "0x", + "nonce": "0x1", + "to": "0x627306090abab3a6e1400e9345bc60c78a8bef57", + "transactionIndex": "0x0", + "value": "0x4e1003b28d9280000", + "v": "0xfe7", + "r": "0x84caf09aefbd5e539295acc67217563438a4efb224879b6855f56857fa2037d3", + "s": "0x5e863be3829812c81439f0ae9d8ecb832b531d651fb234c848d1bf45e62be8b9" + } + } + } + ] + }, + { + "name": "eth_getTransactionCount", + "description": "Returns the number of transactions (nonce) sent from an address at a given block.", + "summary": "Returns the number of transactions sent from an address.", + "params": [ + { + "name": "Address", + "required": true, + "description": "20-byte account address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "Block", + "required": true, + "description": "Block number, tag, or hash (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + } + } + ], + "result": { + "name": "Transaction count", + "description": "Number of transactions (nonce) as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_getTransactionCount example", + "params": [ + { + "name": "Address", + "value": "0xc94770007dda54cF92009BFF0dE90c06F603a09f" + }, + { + "name": "Block", + "value": "latest" + } + ], + "result": { + "name": "Transaction count", + "value": "0x1" + } + } + ] + }, + { + "name": "eth_getTransactionReceipt", + "summary": "Returns the receipt of a transaction by transaction hash.", + "description": "Returns the transaction receipt, which includes logs and status, given a transaction hash.", + "params": [ + { + "name": "Transaction hash", + "required": true, + "description": "32-byte transaction hash.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Receipt information", + "description": "Receipt object, or `null` if the receipt is not yet available.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "type": "object", + "required": [ + "blockHash", + "blockNumber", + "from", + "cumulativeGasUsed", + "gasUsed", + "logs", + "logsBloom", + "transactionHash", + "transactionIndex", + "effectiveGasPrice" + ], + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte.", + "type": "string", + "pattern": "^0x([0-9a-fA-F]?){1,2}$" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Address of the call initiator.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "Address of the receiver or null in a contract creation transaction.", + "oneOf": [ + { + "title": "Contract Creation (null)", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Recipient Address" + } + ] + }, + "cumulativeGasUsed": { + "description": "The sum of gas used by this transaction and all preceding transactions in the same block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "The amount of gas used for this specific transaction alone.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasUsed": { + "description": "The amount of blob gas used for this specific transaction. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "contractAddress": { + "description": "The contract address created, if the transaction was a contract creation, otherwise null.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + }, + { + "title": "No data", + "type": "null" + } + ] + }, + "logs": { + "description": "Logs.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "logsBloom": { + "description": "Logs bloom.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "root": { + "description": "The post-transaction state root. Only specified for transactions included before the Byzantium upgrade.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "status": { + "description": "Either 1 (success) or 0 (failure). Only specified for transactions included after the Byzantium upgrade.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "enum": [ + "0x0", + "0x1" + ] + }, + "effectiveGasPrice": { + "description": "The actual value per gas deducted from the sender's account. Before EIP-1559, this is equal to the transaction's gas price. After, it is equal to baseFeePerGas + min(maxFeePerGas - baseFeePerGas, maxPriorityFeePerGas).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasPrice": { + "description": "The actual value per gas deducted from the sender's account for blob gas. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getTransactionReceipt example", + "params": [ + { + "name": "Transaction hash", + "value": "0x504ce587a65bdbdb6414a0c6c16d86a04dd79bfcc4f2950eec9634b30ce5370f" + } + ], + "result": { + "name": "Receipt information", + "value": { + "blockHash": "0xe7212a92cfb9b06addc80dec2a0dfae9ea94fd344efeb157c41e12994fcad60a", + "blockNumber": "0x50", + "contractAddress": null, + "cumulativeGasUsed": "0x5208", + "from": "0x627306090abab3a6e1400e9345bc60c78a8bef57", + "gasUsed": "0x5208", + "blobGasUsed": "0x20000", + "effectiveGasPrice": "0x1", + "blobGasPrice": "0x3", + "logs": [], + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "status": "0x1", + "to": "0xf17f52151ebef6c7334fad080c5704d77216b732", + "transactionHash": "0xc00e97af59c6f88de163306935f7682af1a34c67245e414537d02e422815efc3", + "transactionIndex": "0x0" + } + } + } + ] + }, + { + "name": "eth_getUncleByBlockHashAndIndex", + "summary": "Returns information about an uncle of a block by hash and uncle index position.", + "description": "Returns information about an uncle of a block given the block hash and the uncle index position.", + "params": [ + { + "name": "Block hash", + "required": true, + "description": "32-byte hash of a block.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "name": "Uncle index", + "required": true, + "description": "Hexadecimal of the uncle's index position in the block.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Uncle block", + "description": "A block object, or null when no uncle was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getUncleByBlockHashAndIndex example", + "params": [ + { + "name": "Block hash", + "value": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b" + }, + { + "name": "Uncle index", + "value": "0x0" + } + ], + "result": { + "name": "Uncle block", + "value": { + "difficulty": "0x57f117f5c", + "extraData": "0x476574682f76312e302e302f77696e646f77732f676f312e342e32", + "gasLimit": "0x1388", + "gasUsed": "0x0", + "hash": "0x932bdf904546a2287a2c9b2ede37925f698a7657484b172d4e5184f80bdd464d", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "miner": "0x5bf5e9cf9b456d6591073513de7fd69a9bef04bc", + "mixHash": "0x4500aa4ee2b3044a155252e35273770edeb2ab6f8cb19ca8e732771484462169", + "nonce": "0x24732773618192ac", + "number": "0x299", + "parentHash": "0xa779859b1ee558258b7008bbabff272280136c5dd3eb3ea3bfa8f6ae03bf91e5", + "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "size": "0x21d", + "stateRoot": "0x2604fbf5183f5360da249b51f1b9f1e0f315d2ff3ffa1a4143ff221ad9ca1fec", + "timestamp": "0x55ba4827", + "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "uncles": [] + } + } + } + ] + }, + { + "name": "eth_getUncleByBlockNumberAndIndex", + "summary": "Returns information about an uncle of a block by number and uncle index position.", + "description": "Returns information about an uncle of a block given the block number and the uncle index position.", + "params": [ + { + "name": "Block", + "required": true, + "description": "Block number or tag (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + }, + { + "name": "Uncle index", + "required": true, + "description": "Hexadecimal of the uncle's index position in the block.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Uncle block", + "description": "A block object, or null when no uncle was found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_getUncleByBlockNumberAndIndex example", + "params": [ + { + "name": "Block", + "value": "0x29c" + }, + { + "name": "Uncle index", + "value": "0x0" + } + ], + "result": { + "name": "Uncle block", + "value": { + "difficulty": "0x57f117f5c", + "extraData": "0x476574682f76312e302e302f77696e646f77732f676f312e342e32", + "gasLimit": "0x1388", + "gasUsed": "0x0", + "hash": "0x932bdf904546a2287a2c9b2ede37925f698a7657484b172d4e5184f80bdd464d", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "miner": "0x5bf5e9cf9b456d6591073513de7fd69a9bef04bc", + "mixHash": "0x4500aa4ee2b3044a155252e35273770edeb2ab6f8cb19ca8e732771484462169", + "nonce": "0x24732773618192ac", + "number": "0x299", + "parentHash": "0xa779859b1ee558258b7008bbabff272280136c5dd3eb3ea3bfa8f6ae03bf91e5", + "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", + "size": "0x21d", + "stateRoot": "0x2604fbf5183f5360da249b51f1b9f1e0f315d2ff3ffa1a4143ff221ad9ca1fec", + "timestamp": "0x55ba4827", + "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", + "uncles": [] + } + } + } + ] + }, + { + "name": "eth_getUncleCountByBlockHash", + "summary": "Returns the number of uncles in a block from a block matching the given block hash.", + "description": "Returns the number of uncles in a block from a block matching the given block hash.", + "params": [ + { + "name": "Block hash", + "required": true, + "description": "32-byte hash of a block.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Uncle count", + "description": "Hexadecimal of the number of uncles in the block, or null if block not found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Uncle count" + } + ] + } + }, + "examples": [ + { + "name": "eth_getUncleCountByBlockHash example", + "params": [ + { + "name": "Block hash", + "value": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b" + } + ], + "result": { + "name": "Uncle count", + "value": "0x1" + } + } + ] + }, + { + "name": "eth_getUncleCountByBlockNumber", + "summary": "Returns the number of uncles in a block from a block matching the given block number.", + "description": "Returns the number of uncles in a block from a block matching the given block number.", + "params": [ + { + "name": "Block", + "required": true, + "description": "Block number or tag (`latest`, `earliest`, `pending`, `safe`, `finalized`).", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Uncle count", + "description": "Hexadecimal of the number of uncles in the block, or null if block not found.", + "schema": { + "oneOf": [ + { + "description": "Not Found (null).", + "type": "null" + }, + { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Uncle count" + } + ] + } + }, + "examples": [ + { + "name": "eth_getUncleCountByBlockNumber example", + "params": [ + { + "name": "Block", + "value": "0xe8" + } + ], + "result": { + "name": "Uncle count", + "value": "0x1" + } + } + ] + }, + { + "name": "eth_getUserOperationByHash", + "summary": "Fetches user operation details by its hash.", + "description": "Fetches user operation details by providing its hash. If the user operation is not available, it will return null.\n", + "params": [ + { + "name": "userOpHash", + "required": true, + "description": "The 32-byte hash of the user operation to retrieve.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "userOperationResult", + "description": "An object containing the user operation information and transaction details, or null if the user operation is not available.", + "schema": { + "oneOf": [ + { + "type": "object", + "title": "User Operation Result", + "properties": { + "userOperation": { + "description": "The user operation object.", + "type": "object", + "properties": { + "sender": { + "description": "The address of the account that initiated the user operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "The nonce used for the user operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "initCode": { + "description": "The initialization code for account creation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callData": { + "description": "The data to pass to the sender during the main execution call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callGasLimit": { + "description": "The amount of gas allocated for the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas allocated for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "preVerificationGas": { + "description": "The amount of gas to compensate the bundler for pre-verification execution.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum fee per gas, in wei, the sender is willing to pay per gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterAndData": { + "description": "The paymaster address and data.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "signature": { + "description": "The signature data for the user operation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "entryPoint": { + "description": "The EntryPoint contract address used.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "transactionHash": { + "description": "The hash of the transaction that included this user operation.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "The hash of the block containing the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "The number of the block containing the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "title": "Not Found", + "type": "null" + } + ] + } + }, + "examples": [ + { + "name": "eth_getUserOperationByHash example", + "params": [ + { + "name": "userOpHash", + "value": "0xa5a579c6fd86c2d8a4d27f5bb22796614d3a31bbccaba8f3019ec001e001b95f" + } + ], + "jsonrpc": "2.0", + "method": "eth_getUserOperationByHash", + "id": 1, + "result": { + "name": "userOperationResult", + "value": { + "userOperation": { + "sender": "0x5a6b47F4131bf1feAFA56A05573314BcF44C9149", + "nonce": "0x845adb2c711129d4f3966735ed98a9f09fc4ce5700000000000000000000", + "initCode": "0x", + "callData": "0xe9ae5c5300000000000000000000000000000000000000000000000000000000000000000000000000", + "callGasLimit": "0x13880", + "verificationGasLimit": "0x60b01", + "preVerificationGas": "0xd3e3", + "maxFeePerGas": "0x7a5cf70d5", + "maxPriorityFeePerGas": "0x3b9aca00", + "paymasterAndData": "0x", + "signature": "0xa6cc6589c8bd561cfd68d7b6b0757ef6f208e7438782939938498eee7d703260137856c840c491b3d415956265e81bf5c2184a725be2abfc365f7536b6af525e1c" + }, + "entryPoint": "0x0000000071727De22E5E9d8BAf0edAc6f37da032", + "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", + "blockHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890", + "blockNumber": "0x1234567" + } + } + } + ] + }, + { + "name": "eth_getUserOperationReceipt", + "summary": "Fetches the receipt of a user operation by its hash.", + "description": "Fetches the receipt of a user operation by providing its hash. If the receipt is not available, it will return null.\n", + "params": [ + { + "name": "userOpHash", + "required": true, + "description": "The 32-byte hash of the user operation for which to retrieve the receipt.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "userOperationReceipt", + "description": "An object containing the user operation receipt information, or null if the receipt is not available.", + "schema": { + "oneOf": [ + { + "type": "object", + "title": "User Operation Receipt", + "properties": { + "entryPoint": { + "description": "The EntryPoint contract address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "userOpHash": { + "description": "The hash of the user operation.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sender": { + "description": "The address of the account that initiated the user operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "The nonce used for the user operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "actualGasUsed": { + "description": "The actual amount of gas used during execution.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "actualGasCost": { + "description": "The actual cost of gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "success": { + "description": "Whether the user operation was successful.", + "type": "boolean" + }, + "logs": { + "description": "Array of log entries generated during execution.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "receipt": { + "type": "object", + "title": "Transaction Receipt", + "description": "The underlying transaction receipt.", + "properties": { + "transactionHash": { + "description": "The hash of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "The index of the transaction in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blockHash": { + "description": "The hash of the block containing the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "The number of the block containing the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "The address that initiated the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "The address that received the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "cumulativeGasUsed": { + "description": "The total gas used by all transactions in the block up to this one.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "The amount of gas used by this transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "contractAddress": { + "description": "The contract address created, if any.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "logs": { + "description": "Array of log entries for this transaction.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "logsBloom": { + "description": "The bloom filter for the logs.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "status": { + "description": "The status of the transaction (0x1 for success, 0x0 for failure).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "effectiveGasPrice": { + "description": "The effective gas price used for the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + }, + { + "title": "Not Found", + "type": "null" + } + ] + } + }, + "examples": [ + { + "name": "eth_getUserOperationReceipt example", + "params": [ + { + "name": "userOpHash", + "value": "0xa5a579c6fd86c2d8a4d27f5bb22796614d3a31bbccaba8f3019ec001e001b95f" + } + ], + "jsonrpc": "2.0", + "method": "eth_getUserOperationReceipt", + "id": 1, + "result": { + "name": "userOperationReceipt", + "value": { + "entryPoint": "0x0000000071727De22E5E9d8BAf0edAc6f37da032", + "userOpHash": "0xa5a579c6fd86c2d8a4d27f5bb22796614d3a31bbccaba8f3019ec001e001b95f", + "sender": "0x5a6b47F4131bf1feAFA56A05573314BcF44C9149", + "nonce": "0x845adb2c711129d4f3966735ed98a9f09fc4ce5700000000000000000000", + "actualGasUsed": "0x1a4c0", + "actualGasCost": "0x1bc16d674ec80000", + "success": true, + "logs": [], + "receipt": { + "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", + "transactionIndex": "0x0", + "blockHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890", + "blockNumber": "0x1234567", + "from": "0x7e2a2fa2a064f693f0a55c5639476d913ff12d05", + "to": "0x0000000071727De22E5E9d8BAf0edAc6f37da032", + "cumulativeGasUsed": "0x1a4c0", + "gasUsed": "0x1a4c0", + "logs": [], + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "status": "0x1", + "effectiveGasPrice": "0x3b9aca00" + } + } + } + } + ] + }, + { + "name": "eth_getWork", + "summary": "Returns the hash of the current block, the seed hash, and the boundary condition to be met.", + "description": "Returns the hash of the current block, the seed hash, and the boundary condition to be met (\"target\").", + "params": [], + "result": { + "name": "Work", + "description": "Array containing the current block header PoW-hash, the seed hash, and the boundary condition.", + "schema": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + }, + "examples": [ + { + "name": "eth_getWork example", + "params": [], + "jsonrpc": "2.0", + "method": "eth_getWork", + "id": 1, + "result": { + "name": "Work", + "value": [ + "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", + "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890", + "0x0000000000000000000000000000000000000000000000000000000000000001" + ] + } + } + ] + }, + { + "name": "eth_hashrate", + "summary": "Returns the number of hashes per second that the node is mining with.", + "description": "Returns the number of hashes per second that the node is mining with. Only applicable when the node is mining.", + "params": [], + "result": { + "name": "Hashrate", + "description": "Hexadecimal of the number of hashes per second.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_hashrate example", + "params": [], + "jsonrpc": "2.0", + "method": "eth_hashrate", + "id": 1, + "result": { + "name": "Hashrate", + "value": "0x0" + } + } + ] + }, + { + "name": "eth_maxPriorityFeePerGas", + "description": "Returns an estimate of the priority fee per gas (in wei) needed for inclusion in a block.", + "summary": "Returns the current maxPriorityFeePerGas per gas in wei.", + "params": [], + "result": { + "name": "Max priority fee per gas", + "description": "Estimated priority fee per gas, in wei, represented as a hexadecimal.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Max priority fee per gas" + } + }, + "examples": [ + { + "name": "eth_maxPriorityFeePerGas example", + "params": [], + "result": { + "name": "Max priority fee per gas", + "value": "0x773c23ba" + } + } + ] + }, + { + "name": "eth_mining", + "summary": "Returns true if client is actively mining new blocks.", + "description": "Returns true if client is actively mining new blocks.", + "params": [], + "result": { + "name": "Is mining", + "description": "Boolean indicating if the client is mining.", + "schema": { + "type": "boolean" + } + }, + "examples": [ + { + "name": "eth_mining example", + "params": [], + "jsonrpc": "2.0", + "method": "eth_mining", + "id": 1, + "result": { + "name": "Is mining", + "value": false + } + } + ] + }, + { + "name": "eth_newBlockFilter", + "summary": "Creates a filter in the node, to notify when a new block arrives.", + "description": "Creates a filter that triggers when a new block is added to the chain. Use `eth_getFilterChanges` to poll; filters expire after 15 minutes of inactivity.", + "params": [], + "result": { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` of the newly created filter.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_newBlockFilter example", + "params": [], + "result": { + "name": "Filter identifier", + "value": "0x01" + } + } + ] + }, + { + "name": "eth_newFilter", + "summary": "Creates a filter object, based on filter options, to notify when the state changes (logs).", + "description": "Creates a filter object with configurable options (`address`, `fromBlock`, `toBlock`, `topics`) that notifies when matching logs are produced. Filters that are not polled using `eth_getFilterChanges` automatically expire after 15 minutes of inactivity. Filter IDs can be polled by any connection using the same API key.", + "params": [ + { + "name": "Filter", + "description": "Filter object defining log criteria (address, block range, topics).", + "schema": { + "type": "object", + "additionalProperties": false, + "properties": { + "fromBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "toBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "address": { + "description": "A contract address or a list of addresses from which logs should originate.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "address": null, + "title": "Single address" + }, + { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "addresses": null, + "title": "List of addresses" + } + ] + }, + "topics": { + "description": "An array of 32 bytes DATA topics. Topics are order-dependent. `null` (empty array) provides any topic match.", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ], + "result": { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` of the newly created filter.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_newFilter example", + "params": [ + { + "name": "Filter", + "value": { + "fromBlock": "0x137d3c2", + "toBlock": "0x137d3c3", + "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", + "topics": [] + } + } + ], + "result": { + "name": "Filter identifier", + "value": "0x01" + } + } + ] + }, + { + "name": "eth_newPendingTransactionFilter", + "summary": "Creates a filter in the node, to notify when new pending transactions arrive.", + "description": "Creates a filter that notifies when new pending transaction hashes enter the mempool.", + "params": [], + "result": { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` of the newly created filter.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_newPendingTransactionFilter example", + "params": [], + "result": { + "name": "Filter identifier", + "value": "0x01" + } + } + ] + }, + { + "name": "eth_protocolVersion", + "summary": "Returns the current Ethereum protocol version.", + "description": "Returns the current Ethereum protocol version.", + "params": [], + "result": { + "name": "Protocol version", + "description": "Hexadecimal indicating the current Ethereum protocol version.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "eth_protocolVersion example", + "params": [], + "result": { + "name": "Protocol version", + "value": "0x41" + } + } + ] + }, + { + "name": "eth_sendRawTransaction", + "summary": "Submits a raw transaction.", + "description": "You can create and sign a transaction externally using a library such as [web3.js](https://web3js.readthedocs.io/) or [ethers.js](https://docs.ethers.org/).\nFor [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844) transactions, the raw form must be the network form. This means it includes the blobs, KZG commitments, and KZG proofs.\nSubmits a pre-signed transaction for broadcast to the Ethereum network.\nMaximal Extractable Value (MEV) protection is available for all Infura customers on Mainnet. This means `r`, `s`, and `v` signature fields might return empty hex values (0x0) while the transaction is pending on Mainnet.\n", + "params": [ + { + "name": "Transaction", + "description": "Signed transaction data.", + "required": true, + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + ], + "result": { + "name": "Transaction hash", + "description": "32-byte hash of the broadcast transaction, or the zero hash if not yet available.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "examples": [ + { + "name": "eth_sendRawTransaction example", + "params": [ + { + "name": "Transaction", + "value": "0xf869018203e882520894f17f52151ebef6c7334fad080c5704d77216b732881bc16d674ec80000801ba02da1c48b670996dcb1f447ef9ef00b33033c48a4fe938f420bec3e56bfd24071a062e0aa78a81bf0290afbc3a9d8e9a068e6d74caa66c5e0fa8a46deaae96b0833" + } + ], + "result": { + "name": "Transaction hash", + "value": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331" + } + } + ] + }, + { + "name": "eth_sendTransaction", + "summary": "Signs and submits a transaction.", + "description": "Signs a transaction with an unlocked account on the client and broadcasts it to the network.", + "params": [ + { + "name": "Transaction", + "description": "Transaction call object to be signed and sent.", + "required": true, + "schema": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ], + "result": { + "name": "Transaction hash", + "description": "32-byte hash of the broadcast transaction.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "examples": [ + { + "name": "eth_sendTransaction example", + "params": [ + { + "name": "Transaction", + "value": { + "from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155", + "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", + "gas": "0x76c0", + "gasPrice": "0x9184e72a000", + "value": "0x9184e72a", + "input": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675" + } + } + ], + "result": { + "name": "Transaction hash", + "value": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331" + } + } + ] + }, + { + "name": "eth_sendUserOperation", + "summary": "Submits a user operation to be included onchain.", + "description": "Submits a user operation to be included onchain and returns the user operation hash if successful or queued. If the operation is not successful, it will return an error.\n", + "params": [ + { + "name": "userOperation", + "required": true, + "description": "The user operation object.", + "schema": { + "oneOf": [ + { + "type": "object", + "title": "v0.7/v0.8 User Operation", + "required": [ + "sender", + "nonce", + "callGasLimit", + "verificationGasLimit", + "preVerificationGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "signature" + ], + "properties": { + "sender": { + "description": "The address of the account making the operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "Nonce for the request from this sender. Includes the key and sequence number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "factory": { + "description": "The factory contract address that will deploy the smart account if it doesn't exist yet.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "factoryData": { + "description": "The data passed to the factory contract to deploy the smart account.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callData": { + "description": "The data to pass to the sender during the main execution call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum fee per gas, in wei, the sender is willing to pay per gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymaster": { + "description": "Address of paymaster sponsoring the transaction, or null if none.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "paymasterVerificationGasLimit": { + "description": "The amount of gas to allocate for the verification step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterPostOpGasLimit": { + "description": "The amount of gas to allocate for the post-operation step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterData": { + "description": "The data to pass to the paymaster during the verification step.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "signature": { + "description": "The signature data.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "eip7702Auth": { + "type": "object", + "title": "EIP-7702 Authorization", + "description": "EIP-7702 authorization data.", + "properties": { + "address": { + "description": "The contract address for the authorization.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "chainId": { + "description": "The chain ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "The nonce.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "The r component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "s": { + "description": "The s component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "v": { + "description": "The v component of the signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The y-parity value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + }, + { + "type": "object", + "title": "v0.6 User Operation", + "required": [ + "sender", + "nonce", + "initCode", + "callGasLimit", + "verificationGasLimit", + "preVerificationGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "paymasterAndData", + "signature" + ], + "properties": { + "sender": { + "description": "The address of the account making the operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "Nonce for the request from this sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "initCode": { + "description": "The initialization code for the smart account if it doesn't exist yet.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callData": { + "description": "The data to pass to the sender during the main execution call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum fee per gas, in wei, the sender is willing to pay per gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterAndData": { + "description": "The address of the paymaster contract and the data that will be passed to it.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "signature": { + "description": "The signature data.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "eip7702Auth": { + "type": "object", + "title": "EIP-7702 Authorization", + "description": "EIP-7702 authorization data.", + "properties": { + "address": { + "description": "The contract address for the authorization.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "chainId": { + "description": "The chain ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "The nonce.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "The r component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "s": { + "description": "The s component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "v": { + "description": "The v component of the signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The y-parity value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + } + ] + } + }, + { + "name": "entryPoint", + "required": true, + "description": "The EntryPoint contract address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + } + ], + "result": { + "name": "userOpHash", + "description": "The 32-byte hash of the user operation. This hash uniquely identifies the user operation and can be used to track its status.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "examples": [ + { + "name": "eth_sendUserOperation example", + "params": [ + { + "name": "userOperation", + "value": { + "sender": "0x5a6b47F4131bf1feAFA56A05573314BcF44C9149", + "nonce": "0x845ADB2C711129D4F3966735ED98A9F09FC4CE5700000000000000000000", + "factory": "0xd703aaE79538628d27099B8c4f621bE4CCd142d5", + "factoryData": "0xc5265d5d000000000000000000000000aac5d4240af87249b3f71bc8e4a2cae074a3e419", + "callData": "0xe9ae5c5300000000000000000000000000000000000000000000000000000000000000000000000000", + "callGasLimit": "0x13880", + "verificationGasLimit": "0x60B01", + "preVerificationGas": "0xD3E3", + "maxPriorityFeePerGas": "0x3B9ACA00", + "maxFeePerGas": "0x7A5CF70D5", + "paymaster": "0x", + "paymasterVerificationGasLimit": "0x0", + "paymasterPostOpGasLimit": "0x0", + "paymasterData": null, + "signature": "0xa6cc6589c8bd561cfd68d7b6b0757ef6f208e7438782939938498eee7d703260137856c840c491b3d415956265e81bf5c2184a725be2abfc365f7536b6af525e1c" + } + }, + { + "name": "entryPoint", + "value": "0x0000000071727De22E5E9d8BAf0edAc6f37da032" + } + ], + "jsonrpc": "2.0", + "method": "eth_sendUserOperation", + "id": 1, + "result": { + "name": "userOpHash", + "value": "0x4c31ae84205a9c862dd8d0822f427fb516448451850ee6f65351951f6a2b2154" + } + } + ] + }, + { + "name": "eth_sign", + "summary": "Returns an EIP-191 signature over the provided data.", + "params": [ + { + "name": "Address", + "required": true, + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "Message", + "required": true, + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + ], + "result": { + "name": "Signature", + "schema": { + "description": "65 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{130}$" + } + }, + "examples": [ + { + "name": "eth_sign example", + "params": [ + { + "name": "Address", + "value": "0x9b2055d370f73ec7d8a03e965129118dc8f5bf83" + }, + { + "name": "Message", + "value": "0xdeadbeaf" + } + ], + "result": { + "name": "Signature", + "value": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b" + } + } + ] + }, + { + "name": "eth_signTransaction", + "summary": "Returns an RLP encoded transaction signed by the specified account.", + "params": [ + { + "name": "Transaction", + "required": true, + "schema": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ], + "result": { + "name": "Encoded transaction", + "schema": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "examples": [ + { + "name": "eth_signTransaction example", + "params": [ + { + "name": "Transaction", + "value": { + "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675", + "from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155", + "gas": "0x76c0", + "gasPrice": "0x9184e72a000", + "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", + "value": "0x9184e72a" + } + } + ], + "result": { + "name": "Encoded transaction", + "value": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b" + } + } + ] + }, + { + "name": "eth_simulateV1", + "summary": "Simulates transactions across multiple blocks.", + "description": "Simulates transactions across multiple blocks. Allows you to test transactions with custom state and block parameters without submitting them to the network.\nThis method is only supported on Mainnet and Sepolia.\nA maximum of 16 block state calls can be simulated in a single request.\n", + "params": [ + { + "name": "Block state call object", + "required": true, + "description": "Object containing block state calls configuration.", + "schema": { + "type": "object", + "properties": { + "blockStateCalls": { + "description": "Array of block, state, and call objects.", + "type": "array", + "items": { + "type": "object", + "properties": { + "blockOverrides": { + "description": "Object to override block parameters.", + "type": "object", + "properties": { + "baseFeePerGas": { + "description": "Hexadecimal value for the base fee per gas for the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobBaseFee": { + "description": "Hexadecimal value for the base fee per unit of blob gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "feeRecipient": { + "description": "Address of the fee recipient for the block proposal.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gasLimit": { + "description": "Hexadecimal value that represents the maximum amount of gas that transactions are allowed to consume.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Hexadecimal block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "prevRandao": { + "description": "The previous value of randomness, which is used as a source of randomness for various protocol operations.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "time": { + "description": "Hexadecimal value representing the Unix epoch time in seconds.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "stateOverrides": { + "description": "Object to override account states (keyed by address).", + "type": "object", + "properties": { + "balance": { + "description": "Hexadecimal value representing the account balance.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "Hexadecimal temporary nonce value for the call execution.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "code": { + "description": "Bytecode to inject into the account.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "state": { + "description": "Object of key-value mappings to override all slots in the account storage before executing the call.", + "type": "object" + }, + "stateDiff": { + "description": "Object of key-value mappings to override individual slots in the account storage before executing the call.", + "type": "object" + }, + "movePrecompileToAddress": { + "description": "Moves the precompile to the supplied address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + } + }, + "calls": { + "description": "Array of transaction call objects.", + "type": "array", + "items": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + } + } + }, + "returnFullTransactionObjects": { + "description": "When true, returns full transaction objects; otherwise just hashes.", + "type": "boolean" + }, + "traceTransfers": { + "description": "When true, adds ETH transfers as ERC20 transfer events to the logs.", + "type": "boolean" + }, + "validation": { + "description": "When true, does full EVM validation except sender and signature checks.", + "type": "boolean" + } + } + } + }, + { + "name": "Block", + "required": false, + "description": "Block number or tag (`latest`, `earliest`, `pending`, `finalized`).", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Simulation results", + "description": "Array of simulation result objects containing block and call results.", + "schema": { + "type": "array", + "items": { + "type": "object", + "properties": { + "baseFeePerGas": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasUsed": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "calls": { + "type": "array", + "items": { + "type": "object", + "properties": { + "returnData": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "logs": { + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "error": { + "type": "object", + "properties": { + "message": { + "description": "The error message.", + "type": "string" + }, + "code": { + "description": "The error status code.", + "type": "integer" + }, + "data": { + "description": "Error-related information.", + "type": "string" + } + } + }, + "gasUsed": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "status": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + }, + "difficulty": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasLimit": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "hash": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "256 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "miner": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "mixHash": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "8 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "number": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "stateRoot": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "timestamp": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "description": "Array of transaction objects or hashes depending on returnFullTransactionObjects.", + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "required": [ + "accessList", + "blobVersionedHashes", + "chainId", + "gas", + "input", + "maxFeePerBlobGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "to", + "type", + "value", + "yParity" + ], + "title": "Unsigned 4844 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 1559 Transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "required": [ + "accessList", + "chainId", + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "value", + "yParity" + ], + "title": "Unsigned 2930 transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "required": [ + "gas", + "gasPrice", + "input", + "nonce", + "r", + "s", + "type", + "v", + "value" + ], + "title": "Unsigned Legacy transaction", + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ], + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + ] + }, + "transactionsRoot": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "uncles": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "withdrawalsRoot": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "examples": [ + { + "name": "eth_simulateV1 example", + "params": [ + { + "name": "Block state call object", + "value": { + "blockStateCalls": [ + { + "blockOverrides": { + "baseFeePerGas": "0x9" + }, + "stateOverrides": { + "0xc000000000000000000000000000000000000000": { + "balance": "0x4a817c800" + } + }, + "calls": [ + { + "from": "0xc000000000000000000000000000000000000000", + "to": "0xc000000000000000000000000000000000000001", + "maxFeePerGas": "0xf", + "value": "0x1" + }, + { + "from": "0xc000000000000000000000000000000000000000", + "to": "0xc000000000000000000000000000000000000002", + "maxFeePerGas": "0xf", + "value": "0x1" + } + ] + } + ], + "validation": true, + "traceTransfers": true + } + }, + { + "name": "Block", + "value": "latest" + } + ], + "jsonrpc": "2.0", + "method": "eth_simulateV1", + "id": 1, + "result": { + "name": "Simulation results", + "value": [ + { + "baseFeePerGas": "0x9", + "blobGasUsed": "0x0", + "calls": [ + { + "gasUsed": "0x5208", + "logs": [], + "returnData": "0x", + "status": "0x1" + }, + { + "gasUsed": "0x5208", + "logs": [], + "returnData": "0x", + "status": "0x1" + } + ], + "difficulty": "0x0", + "excessBlobGas": "0x4920000", + "extraData": "0x", + "gasLimit": "0x1c9c380", + "gasUsed": "0xa410", + "hash": "0xc98388385b0dbfc15ad5c6a0f4b19f7abd94efb4618ced05e3eb320ee30b1e7f", + "miner": "0x7e2a2fa2a064f693f0a55c5639476d913ff12d05", + "number": "0x1496e50", + "parentHash": "0xddd47e7383c8ced495e85e053f898d7a333feb0432fa9098306f6f563cde4984", + "timestamp": "0x67803e64", + "transactions": [ + "0xe7217784e0c3f7b35d39303b1165046e9b7e8af9b9cf80d5d5f96c3163de8f51", + "0xf0182201606ec03701ba3a07d965fabdb4b7d06b424f226ea7ec3581802fc6fa" + ], + "uncles": [], + "withdrawals": [] + } + ] + } + } + ] + }, + { + "name": "eth_submitWork", + "summary": "Used for submitting a proof-of-work solution.", + "description": "Used for submitting a proof-of-work solution.", + "params": [ + { + "name": "Nonce", + "required": true, + "description": "8-byte nonce found (64 bits).", + "schema": { + "description": "8 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + } + }, + { + "name": "PoW hash", + "required": true, + "description": "32-byte header's PoW-hash (256 bits).", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "name": "Mix digest", + "required": true, + "description": "32-byte mix digest (256 bits).", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Is valid", + "description": "Boolean indicating if the provided solution is valid.", + "schema": { + "type": "boolean" + } + }, + "examples": [ + { + "name": "eth_submitWork example", + "params": [ + { + "name": "Nonce", + "value": "0x0000000000000001" + }, + { + "name": "PoW hash", + "value": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef" + }, + { + "name": "Mix digest", + "value": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890" + } + ], + "jsonrpc": "2.0", + "method": "eth_submitWork", + "id": 1, + "result": { + "name": "Is valid", + "value": false + } + } + ] + }, + { + "name": "eth_subscribe", + "summary": "Creates a new subscription.", + "description": "Creates a new subscription for particular events. The node returns a subscription ID. For each event that matches the subscription, a notification with relevant data is sent together with the subscription ID.\nWe strongly recommend specifying a filter (`address` or `topics` or both) when subscribing to the `logs` event.\n", + "params": [ + { + "name": "Event", + "required": true, + "schema": { + "oneOf": [ + { + "title": "newHeads", + "type": "string", + "const": "newHeads", + "description": "Subscribing to this returns a notification each time a new header is appended to the chain, including chain reorganizations. In a chain reorganization, the subscription emits all new headers for the new chain. Therefore the subscription can emit multiple headers at the same height." + }, + { + "title": "logs", + "type": "object", + "description": "Returns logs that are included in new imported blocks and match the given filter criteria. In case of a chain reorganization, previously sent logs that are on the old chain are resent with the removed property set to true. Logs from transactions that ended up in the new chain are emitted. Therefore a subscription can emit logs for the same transaction multiple times. This parameter has the following fields.", + "additionalProperties": false, + "properties": { + "address": { + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Single address" + }, + { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "title": "Addresses" + } + ], + "description": "Either an address or an array of addresses. Only logs that are created from these addresses are returned." + }, + "topics": { + "description": "Only logs which match the specified topics (optional).", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + { + "title": "newPendingTransactions", + "type": "string", + "const": "newPendingTransactions", + "description": "Returns the hash for all transactions that are added to the pending state and are signed with a key that's available in the node. When a transaction that was previously part of the canonical chain isn't part of the new canonical chain after a reorganization, it's emitted again." + } + ] + } + } + ], + "result": { + "name": "Subscription ID", + "description": "The ID of the newly created subscription on the node.", + "schema": { + "type": "string" + } + }, + "examples": [ + { + "name": "eth_subscribe example", + "params": [ + { + "name": "Event", + "value": "newHeads" + } + ], + "result": { + "name": "Subscription ID", + "value": "0x9cef478923ff08bf67fde6c64013158d" + } + } + ] + }, + { + "name": "eth_supportedEntryPoints", + "summary": "Fetches the EntryPoint addresses supported by the bundler.", + "description": "Fetches the EntryPoint addresses supported by the bundler. The first address is the one preferred by the bundler to use.\n", + "params": [], + "result": { + "name": "entryPoints", + "description": "An array of supported EntryPoint addresses. The first address in the array is the preferred EntryPoint that the bundler recommends using.", + "schema": { + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + } + }, + "examples": [ + { + "name": "eth_supportedEntryPoints example", + "params": [], + "jsonrpc": "2.0", + "method": "eth_supportedEntryPoints", + "id": 1, + "result": { + "name": "entryPoints", + "value": [ + "0x0000000071727De22E5E9d8BAf0edAc6f37da032", + "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789" + ] + } + } + ] + }, + { + "name": "eth_syncing", + "summary": "Returns an object with data about the sync status or false.", + "description": "Returns the sync status of the client. If the client is not syncing, returns `false`; otherwise returns an object with information about the current sync progress.", + "params": [], + "result": { + "name": "Syncing status", + "description": "`false` when not syncing, or an object describing the current sync progress.", + "schema": { + "oneOf": [ + { + "title": "Syncing disabled", + "description": "Client is fully synced.", + "type": "boolean", + "const": false + }, + { + "title": "Sync progress", + "type": "object", + "required": [ + "startingBlock", + "currentBlock", + "highestBlock" + ], + "additionalProperties": false, + "properties": { + "startingBlock": { + "description": "Hexadecimal block number at which the sync started.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "currentBlock": { + "description": "Hexadecimal current block, same as `eth_blockNumber`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "highestBlock": { + "description": "Hexadecimal highest block the client is aware of.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + }, + "examples": [ + { + "name": "eth_syncing example", + "params": [], + "result": { + "name": "Syncing status", + "value": { + "startingBlock": "0x0", + "currentBlock": "0x1518", + "highestBlock": "0x9567a3" + } + } + } + ] + }, + { + "name": "eth_uninstallFilter", + "summary": "Uninstalls a filter with given id.", + "description": "Removes the filter referenced by the given identifier and frees associated resources.", + "params": [ + { + "name": "Filter identifier", + "description": "Hexadecimal `filter ID` previously returned by a filter-creation method.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "Success", + "description": "`true` if the filter was successfully uninstalled; otherwise `false`.", + "schema": { + "type": "boolean" + } + }, + "examples": [ + { + "name": "eth_uninstallFilter example", + "params": [ + { + "name": "Filter identifier", + "value": "0x01" + } + ], + "result": { + "name": "Success", + "value": true + } + } + ] + }, + { + "name": "eth_unsubscribe", + "summary": "Cancels a subscription.", + "description": "Cancel subscriptions by calling this method with the subscription ID. It returns a boolean indicating that the subscription was canceled successfully.", + "params": [ + { + "name": "Subscription ID", + "required": true, + "schema": { + "type": "string" + } + } + ], + "result": { + "name": "Unsubscribed flag", + "description": "`true` if the subscription is canceled successfully.", + "schema": { + "type": "boolean" + } + }, + "examples": [ + { + "name": "eth_unsubscribe example", + "params": [ + { + "name": "Subscription ID", + "value": "0x9cef478923ff08bf67fde6c64013158d" + } + ], + "result": { + "name": "Unsubscribed flag", + "value": true + } + } + ] + }, + { + "name": "net_listening", + "summary": "Returns true if client is actively listening for network connections.", + "description": "Returns true if the client is actively listening for network connections.", + "params": [], + "result": { + "name": "Listening", + "description": "Boolean indicating whether the client is actively listening for network connections.", + "schema": { + "type": "boolean" + } + }, + "examples": [ + { + "name": "net_listening example", + "params": [], + "jsonrpc": "2.0", + "method": "net_listening", + "id": 1, + "result": { + "name": "Listening", + "value": true + } + } + ] + }, + { + "name": "net_peerCount", + "summary": "Returns the number of peers currently connected to the client.", + "description": "Returns the number of peers currently connected to the client.", + "params": [], + "result": { + "name": "Peer count", + "description": "Hexadecimal of the number of connected peers.", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "examples": [ + { + "name": "net_peerCount example", + "params": [], + "jsonrpc": "2.0", + "method": "net_peerCount", + "id": 1, + "result": { + "name": "Peer count", + "value": "0x64" + } + } + ] + }, + { + "name": "net_version", + "summary": "Returns the current network ID.", + "description": "Returns the current network ID.", + "params": [], + "result": { + "name": "Network ID", + "description": "A string representing the current network ID.", + "schema": { + "type": "string" + } + }, + "examples": [ + { + "name": "net_version example", + "params": [], + "jsonrpc": "2.0", + "method": "net_version", + "id": 1, + "result": { + "name": "Network ID", + "value": "1" + } + } + ] + }, + { + "name": "pimlico_getUserOperationGasPrice", + "summary": "Returns the gas prices that must be used for user operations.", + "description": "Returns the gas prices that must be used for the user operation you are bundling with Pimlico bundlers. Provides recommendations for slow, standard, and fast priority levels.\n", + "params": [], + "result": { + "name": "gasPrices", + "description": "An object containing gas price recommendations for different priority levels.", + "schema": { + "type": "object", + "title": "Gas Price Recommendation", + "properties": { + "slow": { + "type": "object", + "title": "Gas Price Tier", + "description": "Lower gas prices for non-urgent transactions.", + "properties": { + "maxFeePerGas": { + "description": "Maximum fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum priority fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "standard": { + "type": "object", + "title": "Gas Price Tier", + "description": "Standard gas prices for normal transactions.", + "properties": { + "maxFeePerGas": { + "description": "Maximum fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum priority fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "fast": { + "type": "object", + "title": "Gas Price Tier", + "description": "Higher gas prices for urgent transactions.", + "properties": { + "maxFeePerGas": { + "description": "Maximum fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum priority fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + } + }, + "examples": [ + { + "name": "pimlico_getUserOperationGasPrice example", + "params": [], + "jsonrpc": "2.0", + "method": "pimlico_getUserOperationGasPrice", + "id": 1, + "result": { + "name": "gasPrices", + "value": { + "slow": { + "maxFeePerGas": "0x5a817c800", + "maxPriorityFeePerGas": "0x3b9aca00" + }, + "standard": { + "maxFeePerGas": "0x6fc23ac00", + "maxPriorityFeePerGas": "0x77359400" + }, + "fast": { + "maxFeePerGas": "0x8bb2c9700", + "maxPriorityFeePerGas": "0xb2d05e00" + } + } + } + } + ] + }, + { + "name": "pimlico_getUserOperationStatus", + "summary": "Returns the user operation status.", + "description": "Returns the user operation status and, optionally, the transaction hash that the bundler is using to bundle the user operation onchain. The transaction hash returned when the result is submitted can change if the bundler resubmits the user operation inside a different transaction.\n", + "params": [ + { + "name": "userOpHash", + "required": true, + "description": "The 32-byte hash of the user operation to check the status for.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "status", + "description": "An object containing the status information.", + "schema": { + "type": "object", + "title": "User Operation Status", + "properties": { + "status": { + "description": "The current status of the user operation:\n- not_found: Unknown to the bundler or rejected during validation\n- not_submitted: In mempool but not yet bundled\n- submitted: Bundled into a pending transaction\n- rejected: Re-simulation failed during bundling\n- included: Successfully included onchain\n- failed: Transaction reverted\n- queued: Waiting due to high nonce\n", + "type": "string", + "enum": [ + "not_found", + "not_submitted", + "submitted", + "rejected", + "included", + "failed", + "queued" + ] + }, + "transactionHash": { + "description": "The transaction hash bundling the user operation, or null if not applicable.", + "oneOf": [ + { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + { + "type": "null" + } + ] + } + } + } + }, + "examples": [ + { + "name": "pimlico_getUserOperationStatus included example", + "params": [ + { + "name": "userOpHash", + "value": "0x9bd004b8240da8eba3a02190a72be8a70ade8ef4c581b6e59789643c5e642ac3" + } + ], + "jsonrpc": "2.0", + "method": "pimlico_getUserOperationStatus", + "id": 1, + "result": { + "name": "status", + "value": { + "status": "included", + "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef" + } + } + }, + { + "name": "pimlico_getUserOperationStatus pending example", + "params": [ + { + "name": "userOpHash", + "value": "0x9bd004b8240da8eba3a02190a72be8a70ade8ef4c581b6e59789643c5e642ac3" + } + ], + "jsonrpc": "2.0", + "method": "pimlico_getUserOperationStatus", + "id": 1, + "result": { + "name": "status", + "value": { + "status": "not_submitted", + "transactionHash": null + } + } + } + ] + }, + { + "name": "pimlico_simulateAssetChanges", + "summary": "Simulates a user operation to predict asset changes.", + "description": "Simulates a user operation to predict the asset changes it will cause. Shows all balance changes including native currency, ERC-20, ERC-1155, and ERC-721 tokens. This method does not support v0.6 user operations.\n", + "params": [ + { + "name": "userOperation", + "required": true, + "description": "The user operation object (v0.7/v0.8 format only).", + "schema": { + "type": "object", + "properties": { + "sender": { + "description": "The address of the account making the operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "The account nonce.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "callData": { + "description": "The data to pass to the sender during the main execution call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum fee per gas, in wei, the sender is willing to pay per gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum priority fee per gas above the base fee.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterVerificationGasLimit": { + "description": "Gas for paymaster verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterPostOpGasLimit": { + "description": "Gas for paymaster post-operation step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "signature": { + "description": "Must be a valid dummy signature for simulation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + } + }, + { + "name": "entryPoint", + "required": true, + "description": "The EntryPoint contract address.", + "schema": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + { + "name": "blockNumber", + "required": false, + "description": "Hex encoded block number to run the simulation at (defaults to latest).", + "schema": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + ], + "result": { + "name": "assetChanges", + "description": "An object containing asset changes that would occur from executing the user operation.", + "schema": { + "type": "object", + "title": "Asset Changes Result", + "properties": { + "assetChanges": { + "description": "Array of asset changes.", + "type": "array", + "items": { + "type": "object", + "title": "Asset Change", + "properties": { + "token": { + "description": "Token information (varies by token type).", + "type": "object", + "properties": { + "type": { + "description": "The type of token (native, ERC-20, ERC-721, ERC-1155).", + "type": "string" + }, + "address": { + "description": "The token contract address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "name": { + "description": "The token name (optional in token standards).", + "type": "string" + }, + "symbol": { + "description": "The token symbol (optional in token standards).", + "type": "string" + }, + "decimals": { + "description": "The number of decimals for the token.", + "type": "integer" + } + } + }, + "value": { + "description": "The value changes for the token.", + "type": "object", + "properties": { + "diff": { + "description": "The difference between pre and post.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "pre": { + "description": "The value before the operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "post": { + "description": "The value after the operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + } + } + } + } + }, + "examples": [ + { + "name": "pimlico_simulateAssetChanges example", + "params": [ + { + "name": "userOperation", + "value": { + "sender": "0x5a6b47F4131bf1feAFA56A05573314BcF44C9149", + "nonce": "0x1", + "callData": "0x9faf00f4d9c8df66a69fd6242d468aa8a31a439d14fc6c7af3868a06ed392233bc7e39475df25ad2b52bd5e19e1d438277207a415cb4d4ce8ad192464c55ddf1a9559ff900000000000000000000000073da77f0f2daaa88b908413495d3d0e37458212e", + "callGasLimit": "0x0", + "verificationGasLimit": "0x0", + "preVerificationGas": "0x0", + "maxFeePerGas": "0x7a5cf70d5", + "maxPriorityFeePerGas": "0x3b9aca00", + "paymasterVerificationGasLimit": "0x0", + "paymasterPostOpGasLimit": "0x0", + "signature": "0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c" + } + }, + { + "name": "entryPoint", + "value": "0x0000000071727De22E5E9d8BAf0edAc6f37da032" + } + ], + "jsonrpc": "2.0", + "method": "pimlico_simulateAssetChanges", + "id": 4337, + "result": { + "name": "assetChanges", + "value": { + "assetChanges": [ + { + "token": { + "type": "native", + "name": "Ether", + "symbol": "ETH", + "decimals": 18 + }, + "value": { + "diff": "-0x2386f26fc10000", + "pre": "0xde0b6b3a7640000", + "post": "0xbc7c5e9baa30000" + } + }, + { + "token": { + "type": "ERC-20", + "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", + "name": "USD Coin", + "symbol": "USDC", + "decimals": 6 + }, + "value": { + "diff": "0x989680", + "pre": "0x0", + "post": "0x989680" + } + } + ] + } + } + } + ] + }, + { + "name": "trace_block", + "summary": "Returns trace information for all transactions in a block.", + "description": "Returns trace information about all the transactions in a given block. This can be useful for debugging purposes or for analyzing the behavior of a blockchain.\n", + "params": [ + { + "name": "Block", + "required": true, + "description": "Block number or tag (`latest`, `earliest`, `pending`).", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Traces", + "description": "An array of trace objects containing one object per call, in transaction execution order.", + "schema": { + "type": "array", + "items": { + "description": "Trace object representing a call or operation during transaction execution.", + "type": "object", + "properties": { + "action": { + "description": "Transaction action details.", + "type": "object", + "properties": { + "callType": { + "description": "Type of call (`call`, `staticcall`, `delegatecall`).", + "type": "string" + }, + "creationMethod": { + "description": "Opcode used during contract creation (`create` or `create2`).", + "type": "string" + }, + "from": { + "description": "Address of the transaction sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "init": { + "description": "Contract initialization code (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "input": { + "description": "Transaction data (for call operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "to": { + "description": "Target address of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "value": { + "description": "Value transferred in the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Address involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "balance": { + "description": "Balance involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "refundAddress": { + "description": "Refund address for selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "author": { + "description": "Author of the block reward.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "rewardType": { + "description": "Type of reward (`block` or `uncle`).", + "type": "string" + } + } + }, + "blockHash": { + "description": "Hash of the block containing this trace.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number containing this trace.", + "type": "integer" + }, + "result": { + "description": "Transaction result.", + "type": "object", + "properties": { + "address": { + "description": "Address of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "code": { + "description": "Bytecode of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasUsed": { + "description": "Gas used by the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "output": { + "description": "Return value of the contract call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "subtraces": { + "description": "Number of sub-traces (nested contract calls).", + "type": "integer" + }, + "traceAddress": { + "description": "Tree list address of where the call occurred.", + "type": "array", + "items": { + "type": "integer" + } + }, + "transactionHash": { + "description": "Hash of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionPosition": { + "description": "Transaction position within the block.", + "type": "integer" + }, + "type": { + "description": "Type of operation (`call`, `create`, `selfdestruct`, `reward`).", + "type": "string" + } + } + } + } + }, + "examples": [ + { + "name": "trace_block example", + "params": [ + { + "name": "Block", + "value": "0x6" + } + ], + "jsonrpc": "2.0", + "method": "trace_block", + "id": 1, + "result": { + "name": "Traces", + "value": [ + { + "action": { + "callType": "call", + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0xffad82", + "input": "0x0000000000000000000000000000000000000999", + "to": "0x0020000000000000000000000000000000000000", + "value": "0x0" + }, + "blockHash": "0x71512d31e18f828cef069a87bc2c7514a8ca334f9ee72625efdf5cc2d43768dd", + "blockNumber": 6, + "result": { + "gasUsed": "0x7536", + "output": "0x" + }, + "subtraces": 1, + "traceAddress": [], + "transactionHash": "0x91eeabc671e2dd2b1c8ddebb46ba59e8cb3e7d189f80bcc868a9787728c6e59e", + "transactionPosition": 0, + "type": "call" + } + ] + } + } + ] + }, + { + "name": "trace_call", + "summary": "Executes a call and returns possible traces.", + "description": "Executes the given call and returns a number of possible traces for it. Use this method to retrieve detailed information about the transaction execution, including state changes and logs generated during the process.\n", + "params": [ + { + "name": "Transaction", + "required": true, + "description": "Transaction call object.", + "schema": { + "type": "object", + "properties": { + "from": { + "description": "20-byte address the transaction is sent from.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "20-byte address the transaction is directed to.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided for the transaction execution (hex).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasPrice": { + "description": "Gas price used for each paid gas (hex).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay above the base fee (wei).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee) per gas (wei).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction (hex).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "data": { + "description": "Hash of the method signature and encoded parameters.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + } + }, + { + "name": "Block", + "required": true, + "description": "Block number or tag (`latest`, `earliest`, `pending`).", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + }, + { + "name": "Options", + "required": false, + "description": "Array of tracing options (`trace`, `stateDiff`).", + "schema": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "trace", + "stateDiff" + ] + } + } + } + ], + "result": { + "name": "Trace result", + "description": "A trace object containing the trace and optional stateDiff.", + "schema": { + "type": "object", + "properties": { + "output": { + "description": "Output of the call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "stateDiff": { + "description": "State changes made during execution.", + "type": "object" + }, + "trace": { + "description": "Array of trace objects.", + "type": "array", + "items": { + "description": "Trace object representing a call or operation during transaction execution.", + "type": "object", + "properties": { + "action": { + "description": "Transaction action details.", + "type": "object", + "properties": { + "callType": { + "description": "Type of call (`call`, `staticcall`, `delegatecall`).", + "type": "string" + }, + "creationMethod": { + "description": "Opcode used during contract creation (`create` or `create2`).", + "type": "string" + }, + "from": { + "description": "Address of the transaction sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "init": { + "description": "Contract initialization code (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "input": { + "description": "Transaction data (for call operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "to": { + "description": "Target address of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "value": { + "description": "Value transferred in the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Address involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "balance": { + "description": "Balance involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "refundAddress": { + "description": "Refund address for selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "author": { + "description": "Author of the block reward.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "rewardType": { + "description": "Type of reward (`block` or `uncle`).", + "type": "string" + } + } + }, + "blockHash": { + "description": "Hash of the block containing this trace.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number containing this trace.", + "type": "integer" + }, + "result": { + "description": "Transaction result.", + "type": "object", + "properties": { + "address": { + "description": "Address of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "code": { + "description": "Bytecode of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasUsed": { + "description": "Gas used by the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "output": { + "description": "Return value of the contract call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "subtraces": { + "description": "Number of sub-traces (nested contract calls).", + "type": "integer" + }, + "traceAddress": { + "description": "Tree list address of where the call occurred.", + "type": "array", + "items": { + "type": "integer" + } + }, + "transactionHash": { + "description": "Hash of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionPosition": { + "description": "Transaction position within the block.", + "type": "integer" + }, + "type": { + "description": "Type of operation (`call`, `create`, `selfdestruct`, `reward`).", + "type": "string" + } + } + } + }, + "vmTrace": { + "description": "VM trace (if requested).", + "type": "object" + } + } + } + }, + "examples": [ + { + "name": "trace_call example", + "params": [ + { + "name": "Transaction", + "value": { + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "to": "0x0010000000000000000000000000000000000000", + "gas": "0xfffff2", + "gasPrice": "0xef", + "value": "0x0", + "data": "0x0000000000000000000000000000000000000000000000000000000000000001" + } + }, + { + "name": "Block", + "value": "latest" + }, + { + "name": "Options", + "value": [ + "trace" + ] + } + ], + "jsonrpc": "2.0", + "method": "trace_call", + "id": 1, + "result": { + "name": "Trace result", + "value": { + "output": "0x", + "stateDiff": null, + "trace": [ + { + "action": { + "callType": "call", + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0xffabba", + "input": "0x0000000000000000000000000000000000000000000000000000000000000001", + "to": "0x0010000000000000000000000000000000000000", + "value": "0x0" + }, + "result": { + "gasUsed": "0x9c58", + "output": "0x" + }, + "subtraces": 0, + "traceAddress": [], + "type": "call" + } + ], + "vmTrace": null + } + } + } + ] + }, + { + "name": "trace_callMany", + "summary": "Performs multiple call traces on the same block.", + "description": "Performs multiple call-traces on top of the same block. You can analyze the interactions between different transactions and contracts.\n", + "params": [ + { + "name": "Trace call parameters", + "required": true, + "description": "Array of trace call parameters. Each element is an array containing a transaction call object and optional tracing options.", + "schema": { + "type": "array", + "items": { + "type": "object", + "required": [ + "transaction" + ], + "properties": { + "transaction": { + "description": "Transaction call object containing the same data as in the `trace_call` parameter.", + "type": "object", + "properties": { + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "data": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "options": { + "description": "An array of tracing options. Tracing options are `trace` and `stateDiff`. Specify both options or none.", + "type": "array", + "items": { + "type": "string", + "enum": [ + "trace", + "stateDiff" + ] + } + } + } + } + } + }, + { + "name": "Block", + "required": true, + "description": "Block number or tag (`latest`, `earliest`, `pending`).", + "schema": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + } + } + ], + "result": { + "name": "Trace results", + "description": "Array of trace result objects, one for each call.", + "schema": { + "type": "array", + "items": { + "type": "object", + "properties": { + "output": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "stateDiff": { + "description": "State changes made during execution.", + "type": "object" + }, + "trace": { + "description": "Array of trace objects.", + "type": "array", + "items": { + "description": "Trace object representing a call or operation during transaction execution.", + "type": "object", + "properties": { + "action": { + "description": "Transaction action details.", + "type": "object", + "properties": { + "callType": { + "description": "Type of call (`call`, `staticcall`, `delegatecall`).", + "type": "string" + }, + "creationMethod": { + "description": "Opcode used during contract creation (`create` or `create2`).", + "type": "string" + }, + "from": { + "description": "Address of the transaction sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "init": { + "description": "Contract initialization code (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "input": { + "description": "Transaction data (for call operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "to": { + "description": "Target address of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "value": { + "description": "Value transferred in the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Address involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "balance": { + "description": "Balance involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "refundAddress": { + "description": "Refund address for selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "author": { + "description": "Author of the block reward.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "rewardType": { + "description": "Type of reward (`block` or `uncle`).", + "type": "string" + } + } + }, + "blockHash": { + "description": "Hash of the block containing this trace.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number containing this trace.", + "type": "integer" + }, + "result": { + "description": "Transaction result.", + "type": "object", + "properties": { + "address": { + "description": "Address of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "code": { + "description": "Bytecode of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasUsed": { + "description": "Gas used by the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "output": { + "description": "Return value of the contract call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "subtraces": { + "description": "Number of sub-traces (nested contract calls).", + "type": "integer" + }, + "traceAddress": { + "description": "Tree list address of where the call occurred.", + "type": "array", + "items": { + "type": "integer" + } + }, + "transactionHash": { + "description": "Hash of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionPosition": { + "description": "Transaction position within the block.", + "type": "integer" + }, + "type": { + "description": "Type of operation (`call`, `create`, `selfdestruct`, `reward`).", + "type": "string" + } + } + } + }, + "vmTrace": { + "type": "object" + } + } + } + } + }, + "examples": [ + { + "name": "trace_callMany example", + "params": [ + { + "name": "Trace call parameters", + "value": [ + [ + { + "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1", + "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", + "value": "0x186a0" + }, + [ + "trace" + ] + ], + [ + { + "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1", + "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", + "value": "0x186a0" + }, + [ + "trace" + ] + ] + ] + }, + { + "name": "Block", + "value": "latest" + } + ], + "jsonrpc": "2.0", + "method": "trace_callMany", + "id": 1, + "result": { + "name": "Trace results", + "value": [ + { + "output": "0x", + "stateDiff": null, + "trace": [ + { + "action": { + "callType": "call", + "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1", + "gas": "0x1dcd12f8", + "input": "0x", + "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", + "value": "0x186a0" + }, + "result": { + "gasUsed": "0x0", + "output": "0x" + }, + "subtraces": 0, + "traceAddress": [], + "type": "call" + } + ], + "vmTrace": null + }, + { + "output": "0x", + "stateDiff": null, + "trace": [ + { + "action": { + "callType": "call", + "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1", + "gas": "0x1dcd12f8", + "input": "0x", + "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", + "value": "0x186a0" + }, + "result": { + "gasUsed": "0x0", + "output": "0x" + }, + "subtraces": 0, + "traceAddress": [], + "type": "call" + } + ], + "vmTrace": null + } + ] + } + } + ] + }, + { + "name": "trace_filter", + "summary": "Returns traces matching the specified filter.", + "description": "Returns traces matching the specified filter. The block range is limited to 100 blocks per query (the difference between `fromBlock` and `toBlock`).\n", + "params": [ + { + "name": "Filter", + "required": true, + "description": "Filter object to specify which traces to return.", + "schema": { + "type": "object", + "properties": { + "fromBlock": { + "description": "Trace starts at this block (hex or tag).", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "toBlock": { + "description": "Trace stops at this block (hex or tag).", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "fromAddress": { + "description": "Include only traces sent from these addresses.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + "toAddress": { + "description": "Include only traces with these destination addresses.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + "after": { + "description": "The offset trace number.", + "type": "integer" + }, + "count": { + "description": "Number of traces to display in a batch.", + "type": "integer" + } + } + } + } + ], + "result": { + "name": "Traces", + "description": "Array of trace objects matching the filter.", + "schema": { + "type": "array", + "items": { + "description": "Trace object representing a call or operation during transaction execution.", + "type": "object", + "properties": { + "action": { + "description": "Transaction action details.", + "type": "object", + "properties": { + "callType": { + "description": "Type of call (`call`, `staticcall`, `delegatecall`).", + "type": "string" + }, + "creationMethod": { + "description": "Opcode used during contract creation (`create` or `create2`).", + "type": "string" + }, + "from": { + "description": "Address of the transaction sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "init": { + "description": "Contract initialization code (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "input": { + "description": "Transaction data (for call operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "to": { + "description": "Target address of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "value": { + "description": "Value transferred in the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Address involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "balance": { + "description": "Balance involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "refundAddress": { + "description": "Refund address for selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "author": { + "description": "Author of the block reward.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "rewardType": { + "description": "Type of reward (`block` or `uncle`).", + "type": "string" + } + } + }, + "blockHash": { + "description": "Hash of the block containing this trace.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number containing this trace.", + "type": "integer" + }, + "result": { + "description": "Transaction result.", + "type": "object", + "properties": { + "address": { + "description": "Address of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "code": { + "description": "Bytecode of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasUsed": { + "description": "Gas used by the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "output": { + "description": "Return value of the contract call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "subtraces": { + "description": "Number of sub-traces (nested contract calls).", + "type": "integer" + }, + "traceAddress": { + "description": "Tree list address of where the call occurred.", + "type": "array", + "items": { + "type": "integer" + } + }, + "transactionHash": { + "description": "Hash of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionPosition": { + "description": "Transaction position within the block.", + "type": "integer" + }, + "type": { + "description": "Type of operation (`call`, `create`, `selfdestruct`, `reward`).", + "type": "string" + } + } + } + } + }, + "examples": [ + { + "name": "trace_filter example", + "params": [ + { + "name": "Filter", + "value": { + "fromBlock": "0x1", + "toBlock": "0x21", + "after": 2, + "count": 2, + "fromAddress": [ + "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73" + ] + } + } + ], + "jsonrpc": "2.0", + "method": "trace_filter", + "id": 415, + "result": { + "name": "Traces", + "value": [ + { + "action": { + "callType": "call", + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0xffad82", + "input": "0x0000000000000000000000000000000000000999", + "to": "0x0020000000000000000000000000000000000000", + "value": "0x0" + }, + "blockHash": "0xcd5d9c7acdcbd3fb4b24a39e05a38e32235751bb0c9e4f1aa16dc598a2c2a9e4", + "blockNumber": 6, + "result": { + "gasUsed": "0x7536", + "output": "0x" + }, + "subtraces": 1, + "traceAddress": [], + "transactionHash": "0x91eeabc671e2dd2b1c8ddebb46ba59e8cb3e7d189f80bcc868a9787728c6e59e", + "transactionPosition": 0, + "type": "call" + }, + { + "action": { + "callType": "call", + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0xffad52", + "input": "0xf000000000000000000000000000000000000000000000000000000000000001", + "to": "0x0030000000000000000000000000000000000000", + "value": "0x0" + }, + "blockHash": "0xeed85fe57db751442c826cfe4fdf43b10a5c2bc8b6fd3a8ccced48eb3fb35885", + "blockNumber": 7, + "result": { + "gasUsed": "0x1b", + "output": "0xf000000000000000000000000000000000000000000000000000000000000002" + }, + "subtraces": 0, + "traceAddress": [], + "transactionHash": "0x47f4d445ea1812cb1ddd3464ab23d2bfc6ed408a8a9db1c497f94e8e06e85286", + "transactionPosition": 0, + "type": "call" + } + ] + } + } + ] + }, + { + "name": "trace_transaction", + "summary": "Returns trace information for a transaction.", + "description": "Returns transaction processing trace information for the specified transaction. Use this method to improve smart contract performance by analyzing its internal transactions and execution steps. You can use this information to identify bottlenecks and optimize the contract for better performance.\n", + "params": [ + { + "name": "Transaction hash", + "required": true, + "description": "The 32-byte transaction hash.", + "schema": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + ], + "result": { + "name": "Traces", + "description": "Array of trace objects in the order called by the transaction.", + "schema": { + "type": "array", + "items": { + "description": "Trace object representing a call or operation during transaction execution.", + "type": "object", + "properties": { + "action": { + "description": "Transaction action details.", + "type": "object", + "properties": { + "callType": { + "description": "Type of call (`call`, `staticcall`, `delegatecall`).", + "type": "string" + }, + "creationMethod": { + "description": "Opcode used during contract creation (`create` or `create2`).", + "type": "string" + }, + "from": { + "description": "Address of the transaction sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "init": { + "description": "Contract initialization code (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "input": { + "description": "Transaction data (for call operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "to": { + "description": "Target address of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "value": { + "description": "Value transferred in the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Address involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "balance": { + "description": "Balance involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "refundAddress": { + "description": "Refund address for selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "author": { + "description": "Author of the block reward.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "rewardType": { + "description": "Type of reward (`block` or `uncle`).", + "type": "string" + } + } + }, + "blockHash": { + "description": "Hash of the block containing this trace.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number containing this trace.", + "type": "integer" + }, + "result": { + "description": "Transaction result.", + "type": "object", + "properties": { + "address": { + "description": "Address of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "code": { + "description": "Bytecode of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasUsed": { + "description": "Gas used by the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "output": { + "description": "Return value of the contract call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "subtraces": { + "description": "Number of sub-traces (nested contract calls).", + "type": "integer" + }, + "traceAddress": { + "description": "Tree list address of where the call occurred.", + "type": "array", + "items": { + "type": "integer" + } + }, + "transactionHash": { + "description": "Hash of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionPosition": { + "description": "Transaction position within the block.", + "type": "integer" + }, + "type": { + "description": "Type of operation (`call`, `create`, `selfdestruct`, `reward`).", + "type": "string" + } + } + } + } + }, + "examples": [ + { + "name": "trace_transaction example", + "params": [ + { + "name": "Transaction hash", + "value": "0x4c253746668dca6ac3f7b9bc18248b558a95b5fc881d140872c2dff984d344a7" + } + ], + "jsonrpc": "2.0", + "method": "trace_transaction", + "id": 1, + "result": { + "name": "Traces", + "value": [ + { + "action": { + "callType": "call", + "from": "0xfe3b557e8fb62b89f4916b721be55ceb828dbd73", + "gas": "0xffad82", + "input": "0x0000000000000000000000000000000000000999", + "to": "0x0020000000000000000000000000000000000000", + "value": "0x0" + }, + "blockHash": "0x71512d31e18f828cef069a87bc2c7514a8ca334f9ee72625efdf5cc2d43768dd", + "blockNumber": 6, + "result": { + "gasUsed": "0x7536", + "output": "0x" + }, + "subtraces": 1, + "traceAddress": [], + "transactionHash": "0x91eeabc671e2dd2b1c8ddebb46ba59e8cb3e7d189f80bcc868a9787728c6e59e", + "transactionPosition": 0, + "type": "call" + } + ] + } + } + ] + }, + { + "name": "web3_clientVersion", + "summary": "Returns the current client version.", + "description": "Returns the current client version.", + "params": [], + "result": { + "name": "Client version", + "description": "A string representing the current client version.", + "schema": { + "type": "string" + } + }, + "examples": [ + { + "name": "web3_clientVersion example", + "params": [], + "result": { + "name": "Client version", + "value": "Geth/v1.11.6-omnibus-f83e1598/linux-amd64/go1.20.3" + } + } + ] + } + ], + "components": { + "schemas": { + "JsonRpc": { + "value": "2.0", + "description": "The JSON-RPC protocol version." + }, + "Id": { + "description": "Your identifier for the request, echoed back in the response.", + "example": 1 + }, + "Method": { + "description": "Identifier for the RPC request, pass method name.", + "type": "string" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "addresses": { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + } + }, + "byte": { + "description": "Hex-encoded byte.", + "type": "string", + "pattern": "^0x([0-9a-fA-F]?){1,2}$" + }, + "bytes": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "bytesMax32": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + }, + "bytes8": { + "description": "8 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "bytes32": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "bytes48": { + "description": "48 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{96}$" + }, + "bytes96": { + "description": "96 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{192}$" + }, + "bytes256": { + "description": "256 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "bytes65": { + "description": "65 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{130}$" + }, + "hash32": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "notFound": { + "description": "Not Found (null).", + "type": "null" + }, + "ratio": { + "description": "Normalized ratio.", + "type": "number", + "minimum": 0, + "maximum": 1 + }, + "uint": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "uint64": { + "description": "Hex-encoded 64 bit unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "uint256": { + "description": "Hex-encoded 256 bit unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "BadBlock": { + "description": "Bad block.", + "type": "object", + "required": [ + "block", + "hash", + "rlp" + ], + "additionalProperties": false, + "properties": { + "block": { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "allOf": [ + { + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + ], + "title": "Signed transaction" + } + ] + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "hash": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "rlp": { + "description": "RLP (Recursive Length Prefix); method used to serialize blocks, transactions, and other data in a compact, hex- and byte-encoded format.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "Block": { + "description": "Block object.", + "type": "object", + "required": [ + "hash", + "parentHash", + "sha3Uncles", + "miner", + "stateRoot", + "transactionsRoot", + "receiptsRoot", + "logsBloom", + "number", + "gasLimit", + "gasUsed", + "timestamp", + "extraData", + "mixHash", + "nonce", + "size", + "transactions", + "uncles" + ], + "additionalProperties": false, + "properties": { + "hash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "parentHash": { + "description": "32 byte hex value of the hash of the parent block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sha3Uncles": { + "description": "SHA3 of the uncle's data in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "miner": { + "description": "Not relevant to Proof of Stake. Applied to Proof of Work. Address to pay mining rewards to the coinbase transaction that rewarded the miner for their work.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "stateRoot": { + "description": "Root of the final state trie for the block as 32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionsRoot": { + "description": "Root of the transaction trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "receiptsRoot": { + "description": "Root of the receipts trie for the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "logsBloom": { + "description": "Bloom filter for the block logs; `null` when block is pending.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "difficulty": { + "description": "Not relevant to Proof of Stake. Difficulty for this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "number": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasLimit": { + "description": "Maximum gas allowed in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "Total gas used by all transactions in this block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "timestamp": { + "description": "Unix timestamp (milliseconds) for block assembly.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "extraData": { + "description": "Extra data field for this block.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "mixHash": { + "description": "Not relevant to Proof of Stake. Hash used in the Proof of Work process.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Proof of Work nonce; not relevant to Proof of Stake. Hash of the generated Proof of Work.", + "type": "string", + "pattern": "^0x[0-9a-f]{16}$" + }, + "totalDifficulty": { + "description": "Not relevant to Proof of Stake. Total difficulty of the chain until this block. This value will always be `0` for an uncle block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "baseFeePerGas": { + "description": "The block's base fee per gas; empty for blocks created before [EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "withdrawalsRoot": { + "description": "Root of the trie containing withdrawal receipts in the block.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blobGasUsed": { + "description": "Total blob gas used in the block. Relevant to data availability and EIP-4844 (blob transactions).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "excessBlobGas": { + "description": "Excess blob gas that's carried over to the next block. Relevant for managing the blob gas market introduced in EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "parentBeaconBlockRoot": { + "description": "Root of the parent Beacon Chain block. This ties the execution layer to the consensus layer in Proof of Stake.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "size": { + "description": "Array of transaction objects, or 32 byte transaction hashes depending on the specified parameter.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactions": { + "anyOf": [ + { + "title": "Transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "Full transactions", + "type": "array", + "items": { + "type": "object", + "description": "Transaction information.", + "allOf": [ + { + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + ], + "title": "Signed transaction" + } + ] + } + } + ] + }, + "withdrawals": { + "type": "array", + "items": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "uncles": { + "description": "Array of uncle hashes.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "BlockNumberOrTag": { + "description": "Block number or tag.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "BlockNumberOrTagOrHash": { + "description": "Block number, tag, or block hash.", + "anyOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag." + }, + { + "description": "Block hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + ] + }, + "BlockTag": { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Descriptor of block by status. See the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block).\n - `earliest`: The lowest numbered block the client has available.\n - `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination. \n - `safe`: The most recent block that's safe from re-orgs under honest majority and certain synchronicity assumptions. \n - `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the\n canonical chain even under healthy/normal conditions. \n - `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. \n" + }, + "UserOperationV07": { + "type": "object", + "title": "User Operation (v0.7/v0.8)", + "required": [ + "sender", + "nonce", + "callGasLimit", + "verificationGasLimit", + "preVerificationGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "signature" + ], + "properties": { + "sender": { + "description": "The address of the account making the operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "Nonce for the request from this sender. Includes the key and sequence number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "factory": { + "description": "The factory contract address that will deploy the smart account if it doesn't exist yet.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "factoryData": { + "description": "The data passed to the factory contract to deploy the smart account.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callData": { + "description": "The data to pass to the sender during the main execution call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum fee per gas, in wei, the sender is willing to pay per gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymaster": { + "description": "Address of paymaster sponsoring the transaction, or null if none.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "paymasterVerificationGasLimit": { + "description": "The amount of gas to allocate for the verification step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterPostOpGasLimit": { + "description": "The amount of gas to allocate for the post-operation step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterData": { + "description": "The data to pass to the paymaster during the verification step.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "signature": { + "description": "The signature data.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "eip7702Auth": { + "type": "object", + "title": "EIP-7702 Authorization", + "properties": { + "address": { + "description": "The contract address for the authorization.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "chainId": { + "description": "The chain ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "The nonce.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "The r component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "s": { + "description": "The s component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "v": { + "description": "The v component of the signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The y-parity value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "description": "EIP-7702 authorization data." + } + } + }, + "UserOperationV06": { + "type": "object", + "title": "User Operation (v0.6)", + "required": [ + "sender", + "nonce", + "initCode", + "callGasLimit", + "verificationGasLimit", + "preVerificationGas", + "maxFeePerGas", + "maxPriorityFeePerGas", + "paymasterAndData", + "signature" + ], + "properties": { + "sender": { + "description": "The address of the account making the operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "Nonce for the request from this sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "initCode": { + "description": "The initialization code for the smart account if it doesn't exist yet.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callData": { + "description": "The data to pass to the sender during the main execution call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum fee per gas, in wei, the sender is willing to pay per gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterAndData": { + "description": "The address of the paymaster contract and the data that will be passed to it.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "signature": { + "description": "The signature data.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "eip7702Auth": { + "type": "object", + "title": "EIP-7702 Authorization", + "properties": { + "address": { + "description": "The contract address for the authorization.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "chainId": { + "description": "The chain ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "The nonce.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "The r component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "s": { + "description": "The s component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "v": { + "description": "The v component of the signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The y-parity value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "description": "EIP-7702 authorization data." + } + } + }, + "EIP7702Auth": { + "type": "object", + "title": "EIP-7702 Authorization", + "properties": { + "address": { + "description": "The contract address for the authorization.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "chainId": { + "description": "The chain ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "The nonce.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "The r component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "s": { + "description": "The s component of the signature.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "v": { + "description": "The v component of the signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "yParity": { + "description": "The y-parity value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "StateOverride": { + "type": "object", + "title": "State Override", + "properties": { + "balance": { + "description": "The balance to set for the address.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "nonce": { + "description": "The nonce to set for the address.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "code": { + "description": "The code to set for the address.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "state": { + "description": "Complete state to set (32-byte storage slots to 32-byte values).", + "type": "object", + "additionalProperties": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "stateDiff": { + "description": "State differences to apply (32-byte storage slots to 32-byte values).", + "type": "object", + "additionalProperties": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "GasEstimationResultV07": { + "type": "object", + "title": "Gas Estimation Result (v0.7/v0.8)", + "properties": { + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterVerificationGasLimit": { + "description": "The amount of gas to allocate for the verification step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterPostOpGasLimit": { + "description": "The amount of gas to allocate for the post-operation step of the paymaster.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "GasEstimationResultV06": { + "type": "object", + "title": "Gas Estimation Result (v0.6)", + "properties": { + "preVerificationGas": { + "description": "The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGas": { + "description": "The amount of gas used for verification (legacy field from v0.6).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas to allocate for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "callGasLimit": { + "description": "The amount of gas to allocate the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "UserOperationResult": { + "type": "object", + "title": "User Operation Result", + "properties": { + "userOperation": { + "description": "The user operation object.", + "type": "object", + "properties": { + "sender": { + "description": "The address of the account that initiated the user operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "The nonce used for the user operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "initCode": { + "description": "The initialization code for account creation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callData": { + "description": "The data to pass to the sender during the main execution call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "callGasLimit": { + "description": "The amount of gas allocated for the main execution call.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "verificationGasLimit": { + "description": "The amount of gas allocated for the verification step.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "preVerificationGas": { + "description": "The amount of gas to compensate the bundler for pre-verification execution.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum fee per gas, in wei, the sender is willing to pay per gas.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "paymasterAndData": { + "description": "The paymaster address and data.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "signature": { + "description": "The signature data for the user operation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "entryPoint": { + "description": "The EntryPoint contract address used.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "transactionHash": { + "description": "The hash of the transaction that included this user operation.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "The hash of the block containing the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "The number of the block containing the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "UserOperationReceipt": { + "type": "object", + "title": "User Operation Receipt", + "properties": { + "entryPoint": { + "description": "The EntryPoint contract address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "userOpHash": { + "description": "The hash of the user operation.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "sender": { + "description": "The address of the account that initiated the user operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "nonce": { + "description": "The nonce used for the user operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "actualGasUsed": { + "description": "The actual amount of gas used during execution.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "actualGasCost": { + "description": "The actual cost of gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "success": { + "description": "Whether the user operation was successful.", + "type": "boolean" + }, + "logs": { + "description": "Array of log entries generated during execution.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "receipt": { + "type": "object", + "title": "Transaction Receipt", + "properties": { + "transactionHash": { + "description": "The hash of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "The index of the transaction in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blockHash": { + "description": "The hash of the block containing the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "The number of the block containing the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "The address that initiated the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "The address that received the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "cumulativeGasUsed": { + "description": "The total gas used by all transactions in the block up to this one.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "The amount of gas used by this transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "contractAddress": { + "description": "The contract address created, if any.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "logs": { + "description": "Array of log entries for this transaction.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "logsBloom": { + "description": "The bloom filter for the logs.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "status": { + "description": "The status of the transaction (0x1 for success, 0x0 for failure).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "effectiveGasPrice": { + "description": "The effective gas price used for the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "description": "The underlying transaction receipt." + } + } + }, + "BundlerTransactionReceipt": { + "type": "object", + "title": "Transaction Receipt", + "properties": { + "transactionHash": { + "description": "The hash of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "The index of the transaction in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blockHash": { + "description": "The hash of the block containing the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "The number of the block containing the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "The address that initiated the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "The address that received the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "cumulativeGasUsed": { + "description": "The total gas used by all transactions in the block up to this one.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "The amount of gas used by this transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "contractAddress": { + "description": "The contract address created, if any.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "logs": { + "description": "Array of log entries for this transaction.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "logsBloom": { + "description": "The bloom filter for the logs.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "status": { + "description": "The status of the transaction (0x1 for success, 0x0 for failure).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "effectiveGasPrice": { + "description": "The effective gas price used for the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "GasPriceRecommendation": { + "type": "object", + "title": "Gas Price Recommendation", + "properties": { + "slow": { + "type": "object", + "title": "Gas Price Tier", + "properties": { + "maxFeePerGas": { + "description": "Maximum fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum priority fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "description": "Lower gas prices for non-urgent transactions." + }, + "standard": { + "type": "object", + "title": "Gas Price Tier", + "properties": { + "maxFeePerGas": { + "description": "Maximum fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum priority fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "description": "Standard gas prices for normal transactions." + }, + "fast": { + "type": "object", + "title": "Gas Price Tier", + "properties": { + "maxFeePerGas": { + "description": "Maximum fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum priority fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "description": "Higher gas prices for urgent transactions." + } + } + }, + "GasPriceTier": { + "type": "object", + "title": "Gas Price Tier", + "properties": { + "maxFeePerGas": { + "description": "Maximum fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxPriorityFeePerGas": { + "description": "Maximum priority fee per gas for this priority level.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "UserOperationStatus": { + "type": "object", + "title": "User Operation Status", + "properties": { + "status": { + "description": "The current status of the user operation:\n- not_found: Unknown to the bundler or rejected during validation\n- not_submitted: In mempool but not yet bundled\n- submitted: Bundled into a pending transaction\n- rejected: Re-simulation failed during bundling\n- included: Successfully included onchain\n- failed: Transaction reverted\n- queued: Waiting due to high nonce\n", + "type": "string", + "enum": [ + "not_found", + "not_submitted", + "submitted", + "rejected", + "included", + "failed", + "queued" + ] + }, + "transactionHash": { + "description": "The transaction hash bundling the user operation, or null if not applicable.", + "oneOf": [ + { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + { + "type": "null" + } + ] + } + } + }, + "AssetChange": { + "type": "object", + "title": "Asset Change", + "properties": { + "token": { + "description": "Token information (varies by token type).", + "type": "object", + "properties": { + "type": { + "description": "The type of token (native, ERC-20, ERC-721, ERC-1155).", + "type": "string" + }, + "address": { + "description": "The token contract address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "name": { + "description": "The token name (optional in token standards).", + "type": "string" + }, + "symbol": { + "description": "The token symbol (optional in token standards).", + "type": "string" + }, + "decimals": { + "description": "The number of decimals for the token.", + "type": "integer" + } + } + }, + "value": { + "description": "The value changes for the token.", + "type": "object", + "properties": { + "diff": { + "description": "The difference between pre and post.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "pre": { + "description": "The value before the operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "post": { + "description": "The value after the operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + }, + "AssetChangesResult": { + "type": "object", + "title": "Asset Changes Result", + "properties": { + "assetChanges": { + "description": "Array of asset changes.", + "type": "array", + "items": { + "type": "object", + "title": "Asset Change", + "properties": { + "token": { + "description": "Token information (varies by token type).", + "type": "object", + "properties": { + "type": { + "description": "The type of token (native, ERC-20, ERC-721, ERC-1155).", + "type": "string" + }, + "address": { + "description": "The token contract address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "name": { + "description": "The token name (optional in token standards).", + "type": "string" + }, + "symbol": { + "description": "The token symbol (optional in token standards).", + "type": "string" + }, + "decimals": { + "description": "The number of decimals for the token.", + "type": "integer" + } + } + }, + "value": { + "description": "The value changes for the token.", + "type": "object", + "properties": { + "diff": { + "description": "The difference between pre and post.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "pre": { + "description": "The value before the operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "post": { + "description": "The value after the operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + } + } + } + } + }, + "SyncingStatus": { + "oneOf": [ + { + "title": "Syncing", + "description": "Syncing progress.", + "type": "object", + "additionalProperties": false, + "properties": { + "startingBlock": { + "description": "A hexadecimal equivalent of the integer indicating the block at which the import started (will only be reset after the sync reaches the head).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "currentBlock": { + "description": "Block number as hex-encoded unsigned integer indicating the current block syncing data, same as `eth_blockNumber`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "highestBlock": { + "description": "Block number as hex-encoded unsigned integer indicating the highest block syncing data.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "title": "Not syncing", + "description": "Should always return false if not syncing.", + "type": "boolean", + "example": true + } + ] + }, + "FilterResults": { + "oneOf": [ + { + "title": "New block or transaction hashes", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + { + "title": "New logs", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + } + ] + }, + "Filter": { + "type": "object", + "additionalProperties": false, + "properties": { + "fromBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "toBlock": { + "description": "A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized.", + "oneOf": [ + { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "title": "Block number" + }, + { + "type": "string", + "enum": [ + "earliest", + "finalized", + "safe", + "latest", + "pending" + ], + "description": "Block tag.", + "title": "Block tag" + } + ] + }, + "address": { + "description": "A contract address or a list of addresses from which logs should originate.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "address": null, + "title": "Single address" + }, + { + "description": "Hex-encoded address.", + "type": "array", + "items": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "addresses": null, + "title": "List of addresses" + } + ] + }, + "topics": { + "description": "An array of 32 bytes DATA topics. Topics are order-dependent. `null` (empty array) provides any topic match.", + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "Log": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "ReceiptInfo": { + "type": "object", + "required": [ + "blockHash", + "blockNumber", + "from", + "cumulativeGasUsed", + "gasUsed", + "logs", + "logsBloom", + "transactionHash", + "transactionIndex", + "effectiveGasPrice" + ], + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte.", + "type": "string", + "pattern": "^0x([0-9a-fA-F]?){1,2}$" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Address of the call initiator.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "to": { + "description": "Address of the receiver or null in a contract creation transaction.", + "oneOf": [ + { + "title": "Contract Creation (null)", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Recipient Address" + } + ] + }, + "cumulativeGasUsed": { + "description": "The sum of gas used by this transaction and all preceding transactions in the same block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "gasUsed": { + "description": "The amount of gas used for this specific transaction alone.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasUsed": { + "description": "The amount of blob gas used for this specific transaction. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "contractAddress": { + "description": "The contract address created, if the transaction was a contract creation, otherwise null.", + "oneOf": [ + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + }, + { + "title": "No data", + "type": "null" + } + ] + }, + "logs": { + "description": "Logs.", + "type": "array", + "items": { + "type": "object", + "required": [ + "transactionHash" + ], + "additionalProperties": false, + "properties": { + "removed": { + "type": "boolean" + }, + "logIndex": { + "description": "Hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionIndex": { + "description": "A hexadecimal of the integer representing the position in the block.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "transactionHash": { + "description": "The transaction hash in which the call was made.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockHash": { + "description": "Block hash; 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number as hex-encoded unsigned integer.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "data": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "topics": { + "type": "array", + "items": { + "description": "32 Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "logsBloom": { + "description": "Logs bloom.", + "type": "string", + "pattern": "^0x[0-9a-f]{512}$" + }, + "root": { + "description": "The post-transaction state root. Only specified for transactions included before the Byzantium upgrade.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "status": { + "description": "Either 1 (success) or 0 (failure). Only specified for transactions included after the Byzantium upgrade.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "enum": [ + "0x0", + "0x1" + ] + }, + "effectiveGasPrice": { + "description": "The actual value per gas deducted from the sender's account. Before EIP-1559, this is equal to the transaction's gas price. After, it is equal to baseFeePerGas + min(maxFeePerGas - baseFeePerGas, maxPriorityFeePerGas).", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "blobGasPrice": { + "description": "The actual value per gas deducted from the sender's account for blob gas. Only specified for blob transactions as defined by EIP-4844.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "AccountProof": { + "type": "object", + "required": [ + "address", + "accountProof", + "balanceeth_getBalance", + "codeHash", + "nonce", + "storageHash", + "storageProof" + ], + "additionalProperties": false, + "properties": { + "address": { + "description": "The account address for which the Merkle proof is retrieved. This is an echo of the address passed in the request.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "accountProof": { + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `stateRoot`-Node, following the path of the address as key.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "balance": { + "description": "Hexadecimal of the balance in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "codeHash": { + "description": "The 32-byte hash of the account's code. For EOAs, this will be the hash of an empty string. For contract accounts, it represents the hash of the deployed contract code.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "storageHash": { + "description": "32-byte SHA3 hash of the storage root. All storage will deliver a Merkle proof starting with this root hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "storageProof": { + "description": "An array of requested storage-entries.", + "type": "array", + "items": { + "type": "object", + "required": [ + "key", + "value", + "proof" + ], + "additionalProperties": false, + "properties": { + "key": { + "description": "The requested storage key.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + }, + "value": { + "description": "The storage value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "proof": { + "type": "array", + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `storageHash` node and following the path of the key.", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + } + } + } + } + }, + "StorageProof": { + "type": "object", + "required": [ + "key", + "value", + "proof" + ], + "additionalProperties": false, + "properties": { + "key": { + "description": "The requested storage key.", + "type": "string", + "pattern": "^0x[0-9a-f]{0,64}$" + }, + "value": { + "description": "The storage value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + }, + "proof": { + "type": "array", + "description": "An array of RLP-serialized MerkleTree-Nodes, starting with the `storageHash` node and following the path of the key.", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + } + }, + "Trace": { + "description": "Trace object representing a call or operation during transaction execution.", + "type": "object", + "properties": { + "action": { + "description": "Transaction action details.", + "type": "object", + "properties": { + "callType": { + "description": "Type of call (`call`, `staticcall`, `delegatecall`).", + "type": "string" + }, + "creationMethod": { + "description": "Opcode used during contract creation (`create` or `create2`).", + "type": "string" + }, + "from": { + "description": "Address of the transaction sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "init": { + "description": "Contract initialization code (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "input": { + "description": "Transaction data (for call operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "to": { + "description": "Target address of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "value": { + "description": "Value transferred in the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "address": { + "description": "Address involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "balance": { + "description": "Balance involved in selfdestruct operation.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "refundAddress": { + "description": "Refund address for selfdestruct operation.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "author": { + "description": "Author of the block reward.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "rewardType": { + "description": "Type of reward (`block` or `uncle`).", + "type": "string" + } + } + }, + "blockHash": { + "description": "Hash of the block containing this trace.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number containing this trace.", + "type": "integer" + }, + "result": { + "description": "Transaction result.", + "type": "object", + "properties": { + "address": { + "description": "Address of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "code": { + "description": "Bytecode of the newly created contract (for create operations).", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasUsed": { + "description": "Gas used by the transaction.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "output": { + "description": "Return value of the contract call.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + } + }, + "subtraces": { + "description": "Number of sub-traces (nested contract calls).", + "type": "integer" + }, + "traceAddress": { + "description": "Tree list address of where the call occurred.", + "type": "array", + "items": { + "type": "integer" + } + }, + "transactionHash": { + "description": "Hash of the transaction.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionPosition": { + "description": "Transaction position within the block.", + "type": "integer" + }, + "type": { + "description": "Type of operation (`call`, `create`, `selfdestruct`, `reward`).", + "type": "string" + } + } + }, + "Transaction4844Unsigned": { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "AccessListEntry": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + }, + "AccessList": { + "description": "Access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "GenericTransaction": { + "type": "object", + "description": "Transaction object generic to all supported transactions. All transaction call object parameters are optional.", + "additionalProperties": false, + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "Account nonce; counter for the number of transactions sent from the account; for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "from": { + "description": "Address of the sender.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender. `eth_call` consumes zero gas, but this schema supports other executions that might need this parameter. `eth_estimateGas` ignores this value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value sent with this transaction in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei. Used only in non-[EIP-1559](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md) transactions.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1", + "default": "0x0" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee, in wei, the sender is willing to pay per gas above the base fee. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerGas": { + "description": "Maximum total fee (base fee + priority fee), in wei, the sender is willing to pay per gas. Can be used only in [EIP-1559 transactions](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md). If used, must specify `maxPriorityFeePerGas`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list; a list of addresses and storage keys that the transaction plans to access.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.\n", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "blobs": { + "description": "Raw blob data.", + "type": "array", + "items": { + "description": "Hex-encoded bytes.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "Transaction1559Unsigned": { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "Transaction2930Unsigned": { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "TransactionLegacyUnsigned": { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + "TransactionUnsigned": { + "oneOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 transaction" + }, + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned legacy transaction" + } + ] + }, + "Transaction4844Signed": { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + "Transaction1559Signed": { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + "Transaction2930Signed": { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + "TransactionLegacySigned": { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + "TransactionSigned": { + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + ] + }, + "TransactionInfo": { + "type": "object", + "description": "Transaction information.", + "allOf": [ + { + "title": "Contextual information", + "required": [ + "blockHash", + "blockNumber", + "from", + "hash", + "transactionIndex" + ], + "unevaluatedProperties": false, + "properties": { + "blockHash": { + "description": "Block hash, 32 byte hex identifier for the block derived from the block header.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "blockNumber": { + "description": "Block number.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "from": { + "description": "Sender's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "hash": { + "description": "32 byte hex identifier for the transaction hash.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + }, + "transactionIndex": { + "description": "Transaction index.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + }, + { + "oneOf": [ + { + "description": "Signed 4844 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-4844 transaction.", + "required": [ + "type", + "nonce", + "to", + "gas", + "value", + "input", + "maxPriorityFeePerGas", + "maxFeePerGas", + "maxFeePerBlobGas", + "accessList", + "blobVersionedHashes", + "chainId" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "gas": { + "description": "Gas provided by the sender.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value to transfer in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "maxFeePerBlobGas": { + "description": "The maximum total fee per gas the sender is willing to pay for blob gas in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "blobVersionedHashes": { + "description": "List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.", + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 4844 transaction" + }, + { + "title": "EIP-4844 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "R.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "S.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 1559 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-1559 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "maxFeePerGas", + "maxPriorityFeePerGas", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection..", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "maxPriorityFeePerGas": { + "description": "Maximum fee per gas the sender is willing to pay to miners in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "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.\n", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 1559 Transaction" + }, + { + "title": "EIP-1559 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed 2930 Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "EIP-2930 transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice", + "chainId", + "accessList" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to be paid in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "accessList": { + "description": "EIP-2930 access list.", + "type": "array", + "items": { + "description": "Access list entry.", + "type": "object", + "additionalProperties": false, + "properties": { + "address": { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "storageKeys": { + "type": "array", + "items": { + "description": "32 byte hex value.", + "type": "string", + "pattern": "^0x[0-9a-f]{64}$" + } + } + } + } + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned 2930 transaction" + }, + { + "title": "EIP-2930 transaction signature properties", + "required": [ + "yParity", + "r", + "s" + ], + "properties": { + "yParity": { + "description": "The YParity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "v": { + "description": "ECDSA Recovery ID. 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`.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + }, + { + "description": "Signed Legacy Transaction.", + "type": "object", + "allOf": [ + { + "type": "object", + "description": "Legacy transaction.", + "required": [ + "type", + "nonce", + "gas", + "value", + "input", + "gasPrice" + ], + "properties": { + "type": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "nonce": { + "description": "A counter for the number of transactions sent from the account; used for replay protection.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "to": { + "description": "The recipient's address. `null` when it's a contract creation transaction.", + "oneOf": [ + { + "title": "Contract creation", + "type": "null" + }, + { + "description": "Hex-encoded address.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$", + "title": "Address" + } + ] + }, + "gas": { + "description": "Gas limit.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "value": { + "description": "Value.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "input": { + "description": "Alternative term for `data`. The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.", + "type": "string", + "pattern": "^0x[0-9a-f]*$" + }, + "gasPrice": { + "description": "The gas price the sender is willing to pay in wei.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "chainId": { + "description": "Chain ID that this transaction is valid on.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + }, + "title": "Unsigned Legacy transaction" + }, + { + "title": "Legacy transaction signature properties", + "required": [ + "v", + "r", + "s" + ], + "properties": { + "v": { + "description": "ECDSA Recovery ID.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "r": { + "description": "ECDSA signature r.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + }, + "s": { + "description": "ECDSA signature s.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$", + "example": "0x1" + } + } + } + ] + } + ], + "title": "Signed transaction" + } + ] + }, + "TxType": { + "description": "Hex-encoded byte for transaction type as introduced in EIP-2718. Use:\n- 0x00 for LegacyTxType\n- 0x01 for AccessListTxType\n- 0x02 for DynamicFeeTxType\n- 0x03 for BlobTxType\n", + "type": "string", + "enum": [ + 0, + 1, + 2, + 3 + ] + }, + "Withdrawal": { + "type": "object", + "description": "Validator withdrawal.", + "required": [ + "index", + "validatorIndex", + "address", + "amount" + ], + "additionalProperties": false, + "properties": { + "index": { + "description": "Index of withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "validatorIndex": { + "description": "Index of validator that generated withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$" + }, + "address": { + "description": "Recipient address for withdrawal value.", + "type": "string", + "pattern": "^0x[0-9a-fA-F]{40}$" + }, + "amount": { + "description": "Value contained in withdrawal.", + "type": "string", + "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$" + } + } + } + }, + "tags": { + "Archive": { + "name": "Archive", + "description": "Served by an archive node." + }, + "Bespoke": { + "name": "Bespoke", + "description": "Custom APIs built for specific clients or highly specialized use cases or clients; not available as standard EVM or MetaMask methods.\n" + }, + "Besu": { + "name": "Besu", + "description": "Served by a Besu node." + }, + "OpenBeta": { + "name": "Beta", + "description": "Available as a beta version; use at your own risk." + }, + "CustomPlan": { + "name": "Custom plan", + "description": "Infura's advanced API methods offered through custom arrangements." + }, + "Deprecated": { + "name": "Deprecated", + "description": "Deprecated methods." + }, + "DINParther": { + "name": "DIN", + "description": "Infura's DIN partners support the network." + }, + "Ethereum": { + "name": "EVM", + "description": "Ethereum execution API methods. These methods cover basic transaction calls, block information, and account management available in Ethereum's [`execution-apis`](https://github.com/ethereum/execution-apis/) repository.\nThese are standard Ethereum JSON-RPC API methods. See the [Ethereum wiki](https://eth.wiki/json-rpc/API#json-rpc-methods) for more information about these methods.\"\n" + }, + "Experimental": { + "name": "Experimental", + "description": "Publicly available but may not be stable or fully supported; experimental. Methods may have limited support and could change or be deprecated. Users are advised to use these at their own risk." + }, + "Geth": { + "name": "Geth", + "description": "Served by a Geth node." + }, + "Internal": { + "name": "Internal", + "description": "Not available to public." + }, + "MetaMask": { + "name": "MetaMask", + "description": "MetaMask-specific methods." + }, + "PaidPlan": { + "name": "Paid plan", + "description": "Infura's paid plans giving access to advanced API methods that offer extended functionality such as access to archive data, IPFS gateway, and specialized performance optimizations." + }, + "WSS": { + "name": "WebSocket", + "description": "WebSocket requests are supported in Linea via a virtualization service. An alternative, dedicated URL must be applied." + } + } + } +} \ No newline at end of file