{ "openrpc": "1.2.6", "info": { "title": "Base Flashblocks API", "description": "Quicknode Base Flashblocks API reference", "version": "1.0.0" }, "methods": [ { "name": "eth_call", "summary": "Executes a new message call immediately without creating a transaction on the block chain.", "description": "Executes a new message call immediately without creating a transaction on the block chain.", "params": [ { "name": "transaction", "description": "The transaction call object which contains the following fields:", "required": true, "schema": { "type": "object", "properties": { "from": { "type": "string", "description": "The address from which the transaction is sent" }, "to": { "type": "string", "description": "The address to which the transaction is addressed" }, "gas": { "type": "integer", "description": "The integer of gas provided for the transaction execution" }, "gasPrice": { "type": "integer", "description": "The integer of gasPrice used for each paid gas encoded as hexadecimal" }, "value": { "type": "integer", "description": "The integer of value sent with this transaction encoded as hexadecimal" }, "data": { "type": "string", "description": "The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation" } } } }, { "name": "blockNumber/tag", "description": "Use 'pending' to execute against the most recent Base Flashblock. Other valid tags are 'latest', 'earliest', 'safe', and 'finalized'", "required": true, "schema": { "type": "string" } }, { "name": "Object", "description": "The State Override Set option allows you to change the state of a contract before executing the call, which means you can modify the values of variables stored in the contract, such as balances and approvals for that call without actually modifying the contract. Each address maps to an object containing:", "schema": { "type": "object", "properties": { "balance": { "type": "string", "description": "The fake balance to set for the account before executing the call" }, "nonce": { "type": "string", "description": "The fake nonce to set for the account before executing the call" }, "code": { "type": "string", "description": "The fake EVM bytecode to inject into the account before executing the call" }, "state": { "type": "object", "description": "The fake key-value mapping to override all slots in the account storage before executing the call" }, "stateDiff": { "type": "integer", "description": "The fake key-value mapping to override individual slots in the account storage before executing the call" } } } } ], "result": { "name": "result", "description": "The return value of the executed contract method", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_call" }, "examples": [ { "name": "eth_call example", "params": [ { "name": "blockNumber/tag", "value": "pending" } ], "result": { "name": "eth_call result", "value": "0x" } } ] }, { "name": "eth_estimateGas", "summary": "Returns an estimation of gas for a given transaction.", "description": "Returns an estimation of gas for a given transaction.", "params": [ { "name": "transaction", "description": "The transaction call object:", "required": true, "schema": { "type": "object", "properties": { "from": { "type": "string", "description": "The address from which the transaction is sent" }, "to": { "type": "string", "description": "The address to which the transaction is addressed" }, "gas": { "type": "integer", "description": "The integer of gas provided for the transaction execution" }, "gasPrice": { "type": "integer", "description": "The integer of gasPrice used for each paid gas encoded as hexadecimal" }, "value": { "type": "integer", "description": "The integer of value sent with this transaction encoded as hexadecimal" }, "data": { "type": "string", "description": "The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation." } } } }, { "name": "blockNumber", "description": "Use 'pending' to execute against the most recent Base Flashblock. Other valid tags are 'latest', 'earliest', 'safe', and 'finalized'", "schema": { "type": "string" } } ], "result": { "name": "quantity", "description": "The estimated amount of gas used", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_estimateGas" }, "examples": [ { "name": "eth_estimateGas example", "params": [ { "name": "blockNumber", "value": "pending" } ], "result": { "name": "eth_estimateGas result", "value": "0x5208" } } ] }, { "name": "eth_getBalance", "summary": "Returns the balance of given account address in wei.", "description": "Returns the balance of given account address in wei.", "params": [ { "name": "address", "description": "The address (20 bytes) to check for balance", "required": true, "schema": { "type": "string" } }, { "name": "tag", "description": "Use the `pending` tag to get the address balance in the latest Flashblock", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The ETH balance of the specified address in hexadecimal value, measured in wei", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_getBalance" }, "examples": [ { "name": "eth_getBalance example", "params": [ { "name": "address", "value": "0x622Fbe99b3A378FAC736bf29d7e23B85E18816eB" }, { "name": "tag", "value": "pending" } ], "result": { "name": "eth_getBalance result", "value": "0x0" } } ] }, { "name": "eth_getBlockByNumber", "summary": "Returns information of the block matching the given block number.", "description": "Returns information of the block matching the given block number.", "params": [ { "name": "tag", "description": "Use the `pending` tag to retrieve the latest Flashblock", "required": true, "schema": { "type": "string" } }, { "name": "transaction detail flag", "description": "The method returns the full transaction objects when this value is true otherwise, it returns only the hashes of the transactions", "required": true, "schema": { "type": "boolean" } } ], "result": { "name": "object", "description": "A block object, or null when no block was found. The block object contains the following fields:", "schema": { "type": "object", "properties": { "hash": { "type": "string", "description": "The block hash of the requested block. null if pending" }, "parentHash": { "type": "string", "description": "The hash of the parent block" }, "parentBeaconBlockRoot": { "type": "string", "description": "The parent beacon block root for this block." }, "sha3Uncles": { "type": "string", "description": "The SHA3 of the uncles data in the block" }, "miner": { "type": "string", "description": "The address of the beneficiary to whom the mining rewards were given" }, "stateRoot": { "type": "string", "description": "The root of the final state trie of the block" }, "transactionsRoot": { "type": "string", "description": "The root of the transaction trie of the block" }, "receiptsRoot": { "type": "string", "description": "The root of the receipts trie of the block" }, "requestsHash": { "type": "string", "description": "The hash of the execution requests for this block." }, "logsBloom": { "type": "string", "description": "The bloom filter for the logs of the block. null if pending" }, "difficulty": { "type": "string", "description": "The integer of the difficulty for this block encoded as a hexadecimal" }, "number": { "type": "string", "description": "The block number of the requested block encoded as hexadecimal. null if pending" }, "gasLimit": { "type": "string", "description": "The maximum gas allowed in this block encoded as a hexadecimal" }, "gasUsed": { "type": "string", "description": "The total used gas by all transactions in this block encoded as a hexadecimal" }, "timestamp": { "type": "string", "description": "The UNIX timestamp for when the block was collated" }, "extraData": { "type": "string", "description": "The “extra data” field of this block" }, "mixHash": { "type": "string", "description": "A string of a 256-bit hash encoded as a hexadecimal" }, "nonce": { "type": "string", "description": "The hash of the generated proof-of-work. null if pending" }, "baseFeePerGas": { "type": "string", "description": "(Optional) A string of the base fee encoded in hexadecimal format. This field is omitted for blocks before the EIP-1559 upgrade" }, "withdrawalsRoot": { "type": "string", "description": "The root hash of the withdrawals data for the block" }, "withdrawals": { "type": "array", "items": {}, "description": "An array of withdrawal objects for this block." }, "blobGasUsed": { "type": "string", "description": "The amount of blob gas used in the block (EIP-4844)" }, "excessBlobGas": { "type": "string", "description": "The excess blob gas carried over from the previous block (EIP-4844)" }, "uncles": { "type": "array", "items": {}, "description": "An array of uncle hashes" }, "transactions": { "type": "array", "items": {}, "description": "An array of transaction objects or transaction hashes" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_getBlockByNumber" }, "examples": [ { "name": "eth_getBlockByNumber example", "params": [ { "name": "tag", "value": "pending" }, { "name": "transaction detail flag", "value": false } ], "result": { "name": "eth_getBlockByNumber result", "value": { "baseFeePerGas": "0x32", "difficulty": "0x0", "extraData": "0x", "gasLimit": "0x1c9c380", "gasUsed": "0xb741", "hash": "0x8125d2cdb126d1eb9c40bd3a3a1c00633d5698c0af4dfa90ef2ad32ba81b6f52", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "miner": "0x4200000000000000000000000000000000000011", "mixHash": "0x0cd96a684fdaa2d0b9baf184419526ad720e701bae1855f34b7d535b1f65f9f5", "nonce": "0x0000000000000000", "number": "0x5f4e6", "parentHash": "0xd3014621a2c99724341184e6c32fe641d54b174353cd2bc8c83a0372171f0ef0", "receiptsRoot": "0x3f71ebd8822765e8146170b0f930f55f753dbb867f55e4e605894016cd32f1e2", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x365", "stateRoot": "0x3151cd56c2daaa3adb8f61bc91071dbe245ee5082da3c158f9326d21f929d0df", "timestamp": "0x649646af", "transactions": [ "0x2d3750f7944818e1a4e6b897b6f6ea4d975fcf46720990eb4eda0c00d926a8fd" ], "transactionsRoot": "0xde72c21eee913cab906890d872c55c8a37845fb6a593760936e8a5204667f9a3", "uncles": [] } } } ] }, { "name": "eth_getLogs", "summary": "Returns an array of all logs matching a given filter object.", "description": "Returns an array of all logs matching a given filter object.", "params": [ { "name": "object", "description": "The transaction call object which contains the following fields", "schema": { "type": "object", "properties": { "fromBlock": { "type": "string", "description": "The block number as a string in hexadecimal format or tags. The `pending` tag is not supported for this field" }, "toBlock": { "type": "string", "description": "The block number as a string in hexadecimal format or tags. Use `pending` to query logs from the latest Flashblock" }, "address": { "type": "string", "description": "The contract address or a list of addresses from which logs should originate" }, "topics": { "type": "array", "items": {}, "description": "An array of DATA topics and also, the topics are order-dependent. Visit this official page to learn more about topics" }, "blockHash": { "type": "string", "description": "With the addition of EIP-234, blockHash is a new filter option that restricts the logs returned to the block number referenced in the blockHash. Using the blockHash field is equivalent to setting the fromBlock and toBlock to the block number the blockHash references. If blockHash is present in the filter criteria, neither fromBlock nor toBlock is allowed" } } } } ], "result": { "name": "result", "description": "An array of log objects, or an empty array if nothing has changed since last poll", "schema": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log originated" }, "topics": { "type": "array", "items": {}, "description": "An array of (0 to 4) 32 Bytes DATA of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier)" }, "data": { "type": "string", "description": "It contains one or more 32 Bytes non-indexed arguments of the log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in. null when its pending. Null when it's a pending log" }, "blockTimestamp": { "type": "string", "description": "The timestamp of the block where this log was included, in hexadecimal format" }, "transactionHash": { "type": "string", "description": "The hash of the transaction from which this log was created from. null if the log is pending" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. Null when it's a pending log" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in. Null when it's a pending log" }, "logIndex": { "type": "string", "description": "The integer of the log index position in the block. Null when it's a pending log" }, "removed": { "type": "boolean", "description": "It is true if log was removed, due to a chain reorganization and false if it's a valid log" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_getLogs" }, "examples": [ { "name": "eth_getLogs example", "params": [], "result": { "name": "eth_getLogs result", "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_getTransactionByHash", "summary": "Returns the information about a transaction from a transaction hash.", "description": "Returns the information about a transaction from a transaction hash.", "params": [ { "name": "hash", "description": "The hash of a transaction", "required": true, "schema": { "type": "string" } } ], "result": { "name": "object", "description": "The transaction response object, or null if no transaction is found:", "schema": { "type": "object", "properties": { "type": { "type": "string", "description": "The transaction type" }, "sourceHash": { "type": "string", "description": "The hash of the source transaction that created this transaction" }, "from": { "type": "string", "description": "The address of the sender" }, "to": { "type": "string", "description": "The address of the receiver. Null when it's a contract creation transaction" }, "mint": { "type": "string", "description": "The minting event associated with the transaction" }, "value": { "type": "string", "description": "The value transferred in wei encoded as hexadecimal" }, "gas": { "type": "string", "description": "The gas provided by the sender, encoded as hexadecimal" }, "input": { "type": "string", "description": "The data sent along with the transaction" }, "hash": { "type": "string", "description": "The hash of the transaction" }, "r": { "type": "string", "description": "The R field of the signature" }, "s": { "type": "string", "description": "The S field of the signature" }, "yParity": { "type": "string", "description": "The parity bit used in signature recovery" }, "v": { "type": "string", "description": "The standardized V field of the signature" }, "blockHash": { "type": "string", "description": "The hash of the block where this transaction was in. Null when it's a pending log" }, "blockNumber": { "type": "string", "description": "The block number where this transaction was in. Null when it's a pending log" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. Null when it's a pending log" }, "depositReceiptVersion": { "type": "string", "description": "The version of a deposit receipt" }, "gasPrice": { "type": "string", "description": "The gas price provided by the sender in wei encoded as hexadecimal" }, "nonce": { "type": "string", "description": "The number of transactions made by the sender prior to this one encoded as hexadecimal" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_getTransactionByHash" }, "examples": [ { "name": "eth_getTransactionByHash example", "params": [ { "name": "hash", "value": "0xb53e931671b869a1cc2971a827dc6b70c164ffff26d407e6c9ce947d677c74c8" } ], "result": { "name": "eth_getTransactionByHash result", "value": { "blockHash": "0x24ccba7a44a5ebb81249e9c2c86438218fde5146e609c646e5e57bbbdb9fc11a", "blockNumber": "0x9764c4", "from": "0xdeaddeaddeaddeaddeaddeaddeaddeaddead0001", "gas": "0xf4240", "gasPrice": "0x0", "hash": "0xb53e931671b869a1cc2971a827dc6b70c164ffff26d407e6c9ce947d677c74c8", "input": "0x015d8eb9000000000000000000000000000000000000000000000000000000000123c1b10000000000000000000000000000000000000000000000000000000065b925b70000000000000000000000000000000000000000000000000000000c15c8cf0e45ce1265fc82b3134025d94979f379c353dd8dc205e92def67102e3c14e2074b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000005050f69a9786f081509234f1a7f4684b5e5b76c900000000000000000000000000000000000000000000000000000000000000bc00000000000000000000000000000000000000000000000000000000000a6fe0", "nonce": "0x9764c3", "to": "0x4200000000000000000000000000000000000015", "transactionIndex": "0x0", "value": "0x0", "type": "0x7e", "v": "0x0", "r": "0x0", "s": "0x0", "sourceHash": "0x9ae82271b4dcf8e6cadf8b11bd2e7d6a9e2b5d9e2238d9eec43ab2a5873e305e", "mint": "0x0", "depositReceiptVersion": "0x1" } } } ] }, { "name": "eth_getTransactionCount", "summary": "Returns the number of transactions sent from an address.", "description": "Returns the number of transactions sent from an address.", "params": [ { "name": "address", "description": "The address from which the transaction count to be checked", "required": true, "schema": { "type": "string" } }, { "name": "tag", "description": "Use the `pending` tag to get the address nonce in the latest Flashblock", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "The integer of the number of transactions sent from an address encoded as hexadecimal", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_getTransactionCount" }, "examples": [ { "name": "eth_getTransactionCount example", "params": [ { "name": "address", "value": "0xDeaDDEaDDeAdDeAdDEAdDEaddeAddEAdDEAd0001" }, { "name": "tag", "value": "pending" } ], "result": { "name": "eth_getTransactionCount result", "value": "0x27221c4" } } ] }, { "name": "eth_getTransactionReceipt", "summary": "Returns the receipt of a transaction by transaction hash.", "description": "Returns the receipt of a transaction by transaction hash.", "params": [ { "name": "hash", "description": "The transaction hash, You can use the existing receipt RPC to get preconfirmed receipts", "required": true, "schema": { "type": "string" } } ], "result": { "name": "object", "description": "A transaction receipt object, or null when no receipt was found", "schema": { "type": "object", "properties": { "blockHash": { "type": "string", "description": "The hash of the block where this transaction was in" }, "blockNumber": { "type": "string", "description": "The block number where this transaction was added encoded as a hexadecimal" }, "contractAddress": { "type": "string", "description": "The contract address created for contract creation, otherwise null" }, "cumulativeGasUsed": { "type": "string", "description": "The total gas used when this transaction was executed in the block" }, "effectiveGasPrice": { "type": "string", "description": "The total base charge plus tip paid for each unit of gas" }, "from": { "type": "string", "description": "The address of the sender" }, "gasUsed": { "type": "string", "description": "The amount of gas used by this specific transaction alone" }, "l1BaseFeeScalar": { "type": "string", "description": "The L1 base fee scalar used to calculate the L1 fee" }, "l1BlobBaseFee": { "type": "string", "description": "The base fee for blobs on L1 (used with EIP-4844)" }, "l1BlobBaseFeeScalar": { "type": "string", "description": "The scalar applied to the L1 blob base fee" }, "l1Fee": { "type": "string", "description": "The estimated total L1 fee for this transaction" }, "l1GasPrice": { "type": "string", "description": "The L1 gas price used to compute the fee" }, "l1GasUsed": { "type": "string", "description": "The amount of L1 gas used for the transaction" }, "logs": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log was generated" }, "topics": { "type": "array", "items": {}, "description": "An array of zero to four 32 Bytes DATA of indexed log arguments" }, "data": { "type": "string", "description": "The 32 byte non-indexed argument of the log" }, "blockNumber": { "type": "string", "description": "The block number where this log was in" }, "transactionHash": { "type": "string", "description": "The hash of the transaction from which this log was created from. null if the log is pending" }, "transactionIndex": { "type": "string", "description": "The transaction's index position from which this log was created. null if pending" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in" }, "logIndex": { "type": "string", "description": "The integer of log index position in the block encoded as hexadecimal. null if the log is pending" }, "removed": { "type": "boolean", "description": "True if the log was removed due to a chain reorganization; false if it’s a valid log" } } }, "description": "An array of log objects that generated this transaction" }, "logsBloom": { "type": "string", "description": "The bloom filter which is used to retrieve related logs" }, "status": { "type": "string", "description": "It is either 1 (success) or 0 (failure) encoded as a hexadecimal" }, "to": { "type": "string", "description": "The address of the receiver. Null when it's a contract creation transaction" }, "transactionHash": { "type": "string", "description": "The hash of the transaction" }, "transactionIndex": { "type": "string", "description": "The transaction's index position in the block encoded as a hexadecimal" }, "type": { "type": "string", "description": "The transaction type. '0x2' indicates an EIP-1559 transaction" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_getTransactionReceipt" }, "examples": [ { "name": "eth_getTransactionReceipt example", "params": [ { "name": "hash", "value": "0x83feda69c42870b3f1a402921f2fb9bdd91fbdcce87922dbcd915a33d135916d" } ], "result": { "name": "eth_getTransactionReceipt result", "value": { "blockHash": "0x24ccba7a44a5ebb81249e9c2c86438218fde5146e609c646e5e57bbbdb9fc11a", "blockNumber": "0x9764c4", "contractAddress": null, "cumulativeGasUsed": "0xc545", "depositNonce": "0x9764c3", "depositReceiptVersion": "0x1", "effectiveGasPrice": "0x0", "from": "0xdeaddeaddeaddeaddeaddeaddeaddeaddead0001", "gasUsed": "0xc545", "logs": [], "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "status": "0x1", "to": "0x4200000000000000000000000000000000000015", "transactionHash": "0xb53e931671b869a1cc2971a827dc6b70c164ffff26d407e6c9ce947d677c74c8", "transactionIndex": "0x0", "type": "0x7e" } } } ] }, { "name": "eth_simulateV1", "summary": "Simulates a series of transactions at a specific block height with optional state overrides", "description": "Simulates a series of transactions at a specific block height with optional state overrides", "params": [ { "name": "object", "description": "The simulation request object", "required": true, "schema": { "type": "object", "properties": { "blockStateCalls": { "type": "array", "items": { "type": "object", "properties": { "blockOverrides": { "type": "object", "properties": { "baseFeePerGas": { "type": "string", "description": "The base fee per gas for the block, encoded as hexadecimal" } }, "description": "(Optional) An object to override block-level parameters" }, "stateOverrides": { "type": "object", "properties": { "address": { "type": "object", "properties": { "balance": { "type": "string", "description": "(Optional) The balance to set for the account, encoded as hexadecimal" }, "nonce": { "type": "string", "description": "(Optional) The nonce to set for the account, encoded as hexadecimal" }, "code": { "type": "string", "description": "(Optional) The bytecode to set for the account, encoded as hexadecimal" }, "state": { "type": "object", "description": "(Optional) A key-value mapping to override all slots in the account storage" }, "stateDiff": { "type": "object", "description": "(Optional) A key-value mapping to override individual slots in the account storage" } }, "description": "The address of the account to override" } }, "description": "(Optional) An object to override account states" }, "calls": { "type": "array", "items": { "type": "object", "properties": { "from": { "type": "string", "description": "The address from which the transaction is sent" }, "to": { "type": "string", "description": "The address to which the transaction is directed" }, "maxFeePerGas": { "type": "string", "description": "(Optional) The maximum fee per gas the sender is willing to pay" }, "value": { "type": "string", "description": "(Optional) The value sent with the transaction, encoded as hexadecimal" }, "data": { "type": "string", "description": "(Optional) The data payload of the transaction, encoded as hexadecimal" } } }, "description": "Array of transaction call objects" } } }, "description": "Array of block state call objects" }, "validation": { "type": "boolean", "description": "(Optional) A boolean indicating whether to perform validation checks" }, "traceTransfers": { "type": "boolean", "description": "(Optional) A boolean indicating whether to trace value transfers" } } } }, { "name": "blockParameter", "description": "Use 'pending' to execute against the most recent Base Flashblock. Other valid tags are 'latest', 'earliest', 'safe', and 'finalized'", "schema": { "type": "string" } } ], "result": { "name": "result", "description": "Array of simulation results", "schema": { "type": "array", "items": { "type": "object", "properties": { "hash": { "type": "string", "description": "Block hash" }, "parentHash": { "type": "string", "description": "Parent block hash" }, "sha3Uncles": { "type": "string", "description": "Uncle blocks hash in hexadecimal" }, "miner": { "type": "string", "description": "Miner/validator address" }, "stateRoot": { "type": "string", "description": "State trie root in hexadecimal" }, "transactionsRoot": { "type": "string", "description": "Transactions trie root in hexadecimal" }, "receiptsRoot": { "type": "string", "description": "Receipts trie root in hexadecimal" }, "logsBloom": { "type": "string", "description": "Logs bloom filter in hexadecimal" }, "difficulty": { "type": "string", "description": "Block difficulty in hexadecimal" }, "number": { "type": "string", "description": "Block number in hexadecimal" }, "gasLimit": { "type": "string", "description": "Gas limit in hexadecimal" }, "gasUsed": { "type": "string", "description": "Gas used in hexadecimal" }, "timestamp": { "type": "string", "description": "Block timestamp in hexadecimal" }, "extraData": { "type": "string", "description": "Extra data field in hexadecimal" }, "mixHash": { "type": "string", "description": "Mix hash in hexadecimal" }, "nonce": { "type": "string", "description": "Nonce in hexadecimal" }, "baseFeePerGas": { "type": "string", "description": "Base fee per gas in hexadecimal" }, "withdrawalsRoot": { "type": "string", "description": "Withdrawals trie root in hexadecimal" }, "blobGasUsed": { "type": "string", "description": "Amount of blob gas used in hexadecimal" }, "excessBlobGas": { "type": "string", "description": "Excess blob gas in hexadecimal" }, "parentBeaconBlockRoot": { "type": "string", "description": "Parent beacon block root in hexadecimal" }, "requestsHash": { "type": "string", "description": "Requests hash in hexadecimal" }, "size": { "type": "string", "description": "Block size in hexadecimal" }, "uncles": { "type": "array", "items": {}, "description": "Array of uncle block hashes" }, "transactions": { "type": "array", "items": {}, "description": "Array of transaction hashes" }, "withdrawals": { "type": "array", "items": {}, "description": "Array of withdrawal objects" }, "calls": { "type": "array", "items": { "type": "object", "properties": { "returnData": { "type": "string", "description": "Return data from the call in hexadecimal" }, "logs": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "Address of the contract that generated the log" }, "topics": { "type": "array", "items": {}, "description": "Array of indexed log parameters" }, "data": { "type": "string", "description": "Contains non-indexed log parameters" }, "blockHash": { "type": "string", "description": "Block hash or null if not yet included" }, "blockNumber": { "type": "string", "description": "Block number in hexadecimal" }, "blockTimestamp": { "type": "string", "description": "Block timestamp in hexadecimal" }, "transactionHash": { "type": "string", "description": "Hash of the transaction" }, "transactionIndex": { "type": "string", "description": "Index of the transaction in the block" }, "logIndex": { "type": "string", "description": "Index of the log in the block" }, "removed": { "type": "boolean", "description": "Whether the log was removed due to chain reorganization" } } }, "description": "Array of logs generated during the call" }, "gasUsed": { "type": "string", "description": "Amount of gas used in hexadecimal" }, "status": { "type": "string", "description": "Status code of the call in hexadecimal" } } }, "description": "Array of call results" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_simulateV1" }, "examples": [ { "name": "eth_simulateV1 example", "params": [ { "name": "blockParameter", "value": "pending" } ], "result": { "name": "eth_simulateV1 result", "value": [ { "hash": "0x5dc06db47cf5529ae88f14aa03ad72238269ecb9edfe20bd02d470b44a65db42", "parentHash": "0x9ceebdfdaec3417377bd59f4f5afda667518be85e5ca8d760c8e8e56e533ba72", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "miner": "0x4200000000000000000000000000000000000011", "stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000", "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "difficulty": "0x0", "number": "0x27221cc", "gasLimit": "0x165a0bc0", "gasUsed": "0x0", "timestamp": "0x696ea085", "extraData": "0x010000003200000006000000000007a120", "mixHash": "0x80100e7132ba0e4610b349c11b664dc80a160d2a57c8b2caf44e0c2d159a2345", "nonce": "0x0000000000000000", "baseFeePerGas": "0x212b9b", "withdrawalsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000", "blobGasUsed": "0x0", "excessBlobGas": "0x0", "parentBeaconBlockRoot": "0xdd864b52bceea6db42aeef5e925a186859ee6034e8e720cd1a7bb5bc924b1957", "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "size": "0x27c", "uncles": [], "transactions": [], "withdrawals": [], "calls": [] } ] } } ] }, { "name": "eth_subscribe", "summary": "Subscribes to real-time Flashblock events via WebSocket, including new transactions, pending logs, and block state updat", "description": "Subscribes to real-time Flashblock events via WebSocket, including new transactions, pending logs, and block state updates. Each subscription returns one item per WebSocket message and emits events every 200ms.", "params": [ { "name": "subscription type", "description": "The type of Flashblock event you want to subscribe to. This method supports the following Flashblock-specific subscription types:", "required": true, "schema": { "enum": [ "newFlashblockTransactions", "pendingLogs", "newFlashblocks" ] } }, { "name": "options", "description": "Optional parameters depending on the subscription type. For newFlashblockTransactions, pass true as a boolean for enriched data. For pendingLogs, pass a filter object with address and topics fields", "schema": { "type": "object", "properties": { "address": { "type": "string", "description": "The contract address or a list of addresses from which logs should originate (used with pendingLogs)" }, "topics": { "type": "array", "items": {}, "description": "An array of topic hashes to filter logs by (used with pendingLogs)" } } } } ], "result": { "name": "result", "description": "The hex-encoded subscription ID. This ID will be attached to all received events and can also be used to cancel the subscription using eth_unsubscribe", "schema": { "type": "string" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_subscribe" }, "examples": [ { "name": "eth_subscribe example", "params": [ { "name": "subscription type", "value": "newFlashblocks" } ], "result": { "name": "eth_subscribe result", "value": "0x1887ec8b9589ccad00000000000532da" } } ] }, { "name": "eth_unsubscribe", "summary": "Cancels an existing subscription so that no further events are sent.", "description": "Cancels an existing subscription so that no further events are sent.", "params": [ { "name": "subscription ID", "description": "A subscription ID that was previously generated in a eth_subscribe RPC request", "required": true, "schema": { "type": "string" } } ], "result": { "name": "result", "description": "A boolean value indicating if the subscription was canceled successfully", "schema": { "type": "boolean" } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/base/flashblocks/eth_unsubscribe" }, "examples": [ { "name": "eth_unsubscribe example", "params": [ { "name": "subscription ID", "value": "0xe9549ac54eeec07f" } ], "result": { "name": "eth_unsubscribe result", "value": true } } ] } ], "servers": [ { "name": "Flashblocks API", "url": "https://docs-demo.base-mainnet.quiknode.pro" } ] }