{ "openrpc": "1.2.6", "info": { "title": "GIWA Flashblocks API", "description": "Quicknode GIWA 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": "string", "description": "The integer of gas provided for the transaction execution" }, "gasPrice": { "type": "string", "description": "The integer of gasPrice used for each paid gas encoded as hexadecimal" }, "value": { "type": "string", "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 GIWA 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": "string", "description": "The fake key-value mapping to override all slots in the account storage before executing the call" }, "stateDiff": { "type": "object", "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/giwa/flashblocks/eth_call" }, "examples": [ { "name": "eth_call example", "params": [ { "name": "blockNumber/tag", "value": "pending" } ], "result": { "name": "eth_call result", "value": "0x0000000000000000000000000000000000000000000000000000000000000000" } } ] }, { "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": "string", "description": "The integer of gas provided for the transaction execution" }, "gasPrice": { "type": "string", "description": "The integer of gasPrice used for each paid gas encoded as hexadecimal" }, "value": { "type": "string", "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 GIWA 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/giwa/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": "array", "items": {} } } ], "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/giwa/flashblocks/eth_getBalance" }, "examples": [ { "name": "eth_getBalance example", "params": [ { "name": "address", "value": "0x4200000000000000000000000000000000000006" }, { "name": "tag", "value": "pending" } ], "result": { "name": "eth_getBalance result", "value": "0x5304529ba9ef1a3937" } } ] }, { "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": "array", "items": {} } }, { "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": { "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" }, "blobGasUsed": { "type": "string", "description": "The amount of blob gas used in the block (EIP-4844)" }, "difficulty": { "type": "string", "description": "The integer of the difficulty for this block encoded as a hexadecimal" }, "excessBlobGas": { "type": "string", "description": "The excess blob gas carried over from the previous block (EIP-4844)" }, "extraData": { "type": "string", "description": "The “extra data” field of this block" }, "gasLimit": { "type": "string", "description": "The maximum gas allowed in this block encoded as a hexadecimal" }, "gasUsed": { "type": "string", "description": "The total used gas by all transactions in this block encoded as a hexadecimal" }, "hash": { "type": "string", "description": "The block hash of the requested block. null if pending" }, "logsBloom": { "type": "string", "description": "The bloom filter for the logs of the block. null if pending" }, "miner": { "type": "string", "description": "The address of the beneficiary to whom the mining rewards were given" }, "mixHash": { "type": "string", "description": "A string of a 256-bit hash encoded as a hexadecimal" }, "nonce": { "type": "string", "description": "The hash of the generated proof-of-work. null if pending" }, "number": { "type": "string", "description": "The block number of the requested block encoded as hexadecimal. null if pending" }, "parentBeaconBlockRoot": { "type": "string", "description": "The parent beacon block root for this block." }, "parentHash": { "type": "string", "description": "The hash of the parent 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." }, "sha3Uncles": { "type": "string", "description": "The SHA3 of the uncles data in the block" }, "size": { "type": "string", "description": "The size of the block in bytes" }, "stateRoot": { "type": "string", "description": "The root of the final state trie of the block" }, "timestamp": { "type": "string", "description": "The UNIX timestamp for when the block was collated" }, "transactions": { "type": "array", "items": {}, "description": "An array of transaction objects or transaction hashes" }, "transactionsRoot": { "type": "string", "description": "The root of the transaction trie of the block" }, "uncles": { "type": "array", "items": {}, "description": "An array of uncle hashes" }, "withdrawals": { "type": "array", "items": {}, "description": "An array of withdrawal objects for this block." }, "withdrawalsRoot": { "type": "string", "description": "The root hash of the withdrawals data for the block" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/giwa/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": "0x115", "blobGasUsed": "0x1000e0", "difficulty": "0x0", "excessBlobGas": "0x0", "extraData": "0x01000000fa000000060000000000000000", "gasLimit": "0x3938700", "gasUsed": "0x17ff58", "hash": "0xcb028733f5b7ce1cde0d5c055ba588a7fd5ece91404066b7c23ea0441606a847", "logsBloom": "0x14008000000400802000040180000004001080100010000000040000000100010004000800208000000000100000400000408000060080220200402010240800080010000020000000000008400800000000000000041202040200008000000408000020020000101000404000000800010001000002000010080010000000000000018000000000020000000080001404000801002800080400000100002050020000100000000800000100000020000000000000810000002000000000400000002002000000000003000000000008020000008001401860000000000464000010000000000084022000018200004000000001008021400000001000000000", "miner": "0x4200000000000000000000000000000000000011", "mixHash": "0xa9095f5ea5c15a6b6e23800e8828c4a8b97da448675fbf197e92710cdadc70cb", "nonce": "0x0000000000000000", "number": "0x2052f3c", "parentBeaconBlockRoot": "0x797c82b4ab2c26b4e34357b8323d792ff85de7073885086d78b920f02ac15aca", "parentHash": "0xbd1b36fd990609d1b6111e96c1c3edc501232c6b6771d729bbcb576274353baf", "receiptsRoot": "0xae4044f4f2df3f141d92fbc9cd9b837dc52350454e8886f73194e12b6c659ca0", "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x18a8", "stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000", "timestamp": "0x6a871b98", "transactions": [ "0xc224c39638d4e8d3a145d99c79050d677c7f7dff5459e2bc0373d1055846bb0a", "0xee630ca9b4fc38c0edffd5d1846da4d10d02c9e1d6815a7b445e2519b61d37f1", "0x66548240afa4478c6da2d3504e65f4335e2809b17140f9e394dd74342c58a3c1", "0x97f023fbc389c6a8d5863a36b791f050d56f15b6ea9d5a98fba2cef0bcd86b20", "0x91e1860a19a419c6ab3302ee8443533e1554a7a5a6f2f667429c57445e81b711", "0xccbc31e8d11e891c0d1b7df1b2cb231acb6fd094de1067668ac835221af2ba26", "0x1a32d5ebb58a03bdd9689226df814ebcba41af9f6f82c8c2fc3e8d51c0cf1cde", "0x552a90a39bc58c76c4a99e3e7e04da7126ad7fbd95afb3dfaa70953adbb99032", "0x92c693350499ad66acf424a2bc74eb96ad2fca671e21d15958e2b9b1b11d0099", "0xeb81c871543cd768aa7a322c509df8760b0ec43e5274cac336cdda6b10a0ab09", "0x69a3f1c8f38f72dae307be1fa8cf81aa9c3d2c52477e8ceebe7dd19016506148", "0x83586cf3cc060d4d94b8bfef662c843e72af2b76d78c06e11843f5663a1d53fc", "0xc22c95bc014abfa121acc46d8d6884144ec2ae5142cb53b999ff4ae7dc2de591", "0xb1f0f2b604e4bb0659497a0c0b4d09242341ebcfbbf19fb52adfa1f9ca7ea2b6", "0x469bd7547c10ddcbc177832988f6c7f1fd8dc24fb6245259db2258b70aa80c62", "0x78f89b29bbe7d2f1cd76f11b881c6772808a97794c59b6f961a83df25c52d1eb", "0x5bd99f2ed03f1781344028780a98f1f130b2cedce32ee45b8bb45ee598f4b47c", "0x526c6fd62fec39b7da9c5e496d166ece7ae60deeb15952544dc5c57dee2e1555", "0x398779f41446ffd6a08402e851cd6c28500f620209baeec82cd158de337c8bed", "0x87d4f1d2bb09611f507b9c0acf682dbcae223f391c113d121612d8640682fb5b", "0x8a2a9ae50464e9f9ae87f81bbe6ed5c8772f51c745d10b9e74964acd0105559a", "0x9c8e0cee3335393987fab64e8126b91133eff6dc5033365576139225b25f15a6", "0x19e025a3bb2753a3f71a79dc659377dc71d8546105eb00e86c0b8b455b00ee0b", "0x6808be34301e1297705b82b3f62fd2bd24aa89006aa5054561e55c41163ab842", "0x3665ecc4671ef8980ceb464ea5a32491e437aed55e0f6b21782199567d463c42", "0x5fff796da5a042d0ae27d9d65760a9ab3fbf034f938f410b962aea93a20e1e29" ], "transactionsRoot": "0x5b53eb274d5b8b84ebb9ddbae480028cc9fb7c20595f3263b2507e025216e997", "uncles": [], "withdrawals": [], "withdrawalsRoot": "0xfa6bed59bd0ef0ff65cf2f4e7e9ffe919524175aae74c88f4338103f89bfb66d" } } } ] }, { "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": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address from which this log originated" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in. Null when it's a pending log" }, "blockNumber": { "type": "string", "description": "The block number containing this log. Null when the log is pending" }, "blockTimestamp": { "type": "string", "description": "The timestamp of the block where this log was included, in hexadecimal format" }, "data": { "type": "string", "description": "It contains one or more 32 Bytes non-indexed arguments of the 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" }, "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)" }, "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" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/giwa/flashblocks/eth_getLogs" }, "examples": [ { "name": "eth_getLogs example", "params": [], "result": { "name": "eth_getLogs result", "value": [ { "address": "0x4200000000000000000000000000000000000006", "blockHash": "0xbd1b36fd990609d1b6111e96c1c3edc501232c6b6771d729bbcb576274353baf", "blockNumber": "0x2052f3b", "blockTimestamp": "0x6a871b97", "data": "0x00000000000000000000000000000000000000000000000000000093e98cce75", "logIndex": "0x5", "removed": false, "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000009d3d8065fe36f6148bed659d5cf3fec122ccdb77", "0x000000000000000000000000aa4dbd22a151a17dc30cc594110ce1993ecc2509" ], "transactionHash": "0xe845ad11d6af4b4765be399edf27da644c47574389e76eeb4335570c95754be0", "transactionIndex": "0x9" }, { "address": "0x4200000000000000000000000000000000000006", "blockHash": "0xbd1b36fd990609d1b6111e96c1c3edc501232c6b6771d729bbcb576274353baf", "blockNumber": "0x2052f3b", "blockTimestamp": "0x6a871b97", "data": "0x0000000000000000000000000000000000000000000000000000001f325041fa", "logIndex": "0xc", "removed": false, "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x000000000000000000000000e007c6df0320145d9423b144c63822fb86a3ba4d", "0x00000000000000000000000013241c48a28aa4e74eadda6ecb5a0e82a9959d25" ], "transactionHash": "0x6dfea4daa754d54a5a432c83b6389c7aac8a584234b061d6788b761082479545", "transactionIndex": "0x13" }, { "address": "0x4200000000000000000000000000000000000006", "blockHash": "0xbd1b36fd990609d1b6111e96c1c3edc501232c6b6771d729bbcb576274353baf", "blockNumber": "0x2052f3b", "blockTimestamp": "0x6a871b97", "data": "0x00000000000000000000000000000000000000000000000000000017da72e3ed", "logIndex": "0x11", "removed": false, "topics": [ "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c", "0x000000000000000000000000ad153c844ccac3d2ea991170624200e54730be74" ], "transactionHash": "0x15afb89cfbc698ec1130317563f001b745e5d30844e8ae97479c55459fb17dd7", "transactionIndex": "0x16" }, { "address": "0x4200000000000000000000000000000000000006", "blockHash": "0x9797ca031d75a5ee13515bf2030fd7be57b7b0bbfb1b263e74411e4f9159db71", "blockNumber": "0x2052f3c", "blockTimestamp": "0x6a871b98", "data": "0x0000000000000000000000000000000000000000000000000000001fa33cf1aa", "logIndex": "0x19", "removed": false, "topics": [ "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c", "0x000000000000000000000000ad153c844ccac3d2ea991170624200e54730be74" ], "transactionHash": "0x3665ecc4671ef8980ceb464ea5a32491e437aed55e0f6b21782199567d463c42", "transactionIndex": "0x18" } ] } } ] }, { "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": { "accessList": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string", "description": "The address that will be accessed" }, "storageKeys": { "type": "array", "items": {}, "description": "The storage keys that will be accessed at this address" } } }, "description": "A list of addresses and storage keys that the transaction will access" }, "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" }, "blockTimestamp": { "type": "string", "description": "The timestamp of the block where this log was included, encoded as hexadecimal." }, "chainId": { "type": "string", "description": "The chain id of the transaction, if any" }, "from": { "type": "string", "description": "The address of the sender" }, "gas": { "type": "string", "description": "The gas provided by the sender, encoded as hexadecimal" }, "gasPrice": { "type": "string", "description": "The gas price provided by the sender in wei encoded as hexadecimal" }, "hash": { "type": "string", "description": "The hash of the transaction" }, "input": { "type": "string", "description": "The data sent along with the transaction" }, "maxFeePerGas": { "type": "string", "description": "The maximum fee per gas set in the transaction" }, "maxPriorityFeePerGas": { "type": "string", "description": "The maximum priority gas fee set in the transaction" }, "nonce": { "type": "string", "description": "The number of transactions made by the sender prior to this one encoded as hexadecimal" }, "r": { "type": "string", "description": "The R field of the signature" }, "s": { "type": "string", "description": "The S field of the signature" }, "to": { "type": "string", "description": "The address of the receiver. Null when it's a contract creation transaction" }, "transactionIndex": { "type": "string", "description": "The integer of the transaction's index position that the log was created from. Null when it's a pending log" }, "type": { "type": "string", "description": "The transaction type" }, "v": { "type": "string", "description": "The standardized V field of the signature" }, "value": { "type": "string", "description": "The value transferred in wei encoded as hexadecimal" }, "yParity": { "type": "string", "description": "The parity bit used in signature recovery" } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/giwa/flashblocks/eth_getTransactionByHash" }, "examples": [ { "name": "eth_getTransactionByHash example", "params": [ { "name": "hash", "value": "0x79dfb44c80e7282b6a7d5a4e917c06ef15778df6f488682b0ee2a1677d6dbae0" } ], "result": { "name": "eth_getTransactionByHash result", "value": { "accessList": [], "blockHash": "0x415aac98a7007e1e40980402bf6c52c077dd8d2e137dfea24da702b04486bf26", "blockNumber": "0x205203b", "blockTimestamp": "0x6a870c97", "chainId": "0x164ce", "from": "0x5ad176ebb13cabe62ee7c07f52a67b4a48cbef83", "gas": "0x61a80", "gasPrice": "0x4c4c57", "hash": "0x79dfb44c80e7282b6a7d5a4e917c06ef15778df6f488682b0ee2a1677d6dbae0", "input": "0xda1750b0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000010000000404624044d1509a0460ae9dc9236b04602aaee65ef7045e993727d9b3", "maxFeePerGas": "0x2faf080", "maxPriorityFeePerGas": "0x4c4b40", "nonce": "0x15d3d34", "r": "0x4b8a5f52cfe9190b6f02b6ff096b05aec6abcdfc50c45a4ceeffd6680dee972a", "s": "0x27555c0befd4312b2c97b97d3bee8d3d03d297287904d6583cdf41dc937746d8", "to": "0xbbe55e29bbc6d71ecab1ac011c9ac5206ab2fe74", "transactionIndex": "0x1", "type": "0x2", "v": "0x0", "value": "0x0", "yParity": "0x0" } } } ] }, { "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": "array", "items": {} } } ], "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/giwa/flashblocks/eth_getTransactionCount" }, "examples": [ { "name": "eth_getTransactionCount example", "params": [ { "name": "address", "value": "0xDeaDDEaDDeAdDeAdDEAdDEaddeAddEAdDEAd0001" }, { "name": "tag", "value": "pending" } ], "result": { "name": "eth_getTransactionCount result", "value": "0x2052f5c" } } ] }, { "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": { "blobGasUsed": { "type": "string", "description": "Amount of blob gas used in hexadecimal" }, "blockHash": { "type": "string", "description": "The hash of the block where this transaction was in" }, "blockNumber": { "type": "string", "description": "The block number where this transaction was added encoded as a hexadecimal" }, "contractAddress": { "type": [ "string", "null" ], "description": "The contract address created for contract creation, otherwise null" }, "cumulativeGasUsed": { "type": "string", "description": "The total gas used when this transaction was executed in the block" }, "daFootprintGasScalar": { "type": "string", "description": "The data availability footprint gas scalar value for the system configuration" }, "effectiveGasPrice": { "type": "string", "description": "The total giwa 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" }, "blockHash": { "type": "string", "description": "The hash of the block where this log was in" }, "blockNumber": { "type": "string", "description": "The block number where this log was in" }, "blockTimestamp": { "type": "string", "description": "The timestamp of the block where this log was included, encoded as hexadecimal." }, "data": { "type": "string", "description": "The 32 byte non-indexed argument of the log" }, "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" }, "topics": { "type": "array", "items": {}, "description": "An array of zero to four 32 Bytes DATA of indexed log arguments" }, "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" } } }, "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/giwa/flashblocks/eth_getTransactionReceipt" }, "examples": [ { "name": "eth_getTransactionReceipt example", "params": [ { "name": "hash", "value": "0x79dfb44c80e7282b6a7d5a4e917c06ef15778df6f488682b0ee2a1677d6dbae0" } ], "result": { "name": "eth_getTransactionReceipt result", "value": { "blobGasUsed": "0x9c40", "blockHash": "0x415aac98a7007e1e40980402bf6c52c077dd8d2e137dfea24da702b04486bf26", "blockNumber": "0x205203b", "contractAddress": null, "cumulativeGasUsed": "0x17910", "daFootprintGasScalar": "0x190", "effectiveGasPrice": "0x4c4c57", "from": "0x5ad176ebb13cabe62ee7c07f52a67b4a48cbef83", "gasUsed": "0x98d2", "l1BaseFeeScalar": "0x558", "l1BlobBaseFee": "0x3e06a9c", "l1BlobBaseFeeScalar": "0xc3c9d", "l1Fee": "0x1b48ffc0f", "l1GasPrice": "0x396b08e4", "l1GasUsed": "0x640", "logs": [ { "address": "0xbbe55e29bbc6d71ecab1ac011c9ac5206ab2fe74", "blockHash": "0x415aac98a7007e1e40980402bf6c52c077dd8d2e137dfea24da702b04486bf26", "blockNumber": "0x205203b", "blockTimestamp": "0x6a870c97", "data": "0x00000000000000000000000000000000000000000000000000045e993727d9b30000000000000000000000000000000000000000000000000004602aaee65ef7000000000000000000000000000000000000000000000000000460ae9dc9236b0000000000000000000000000000000000000000000000000004624044d1509a", "logIndex": "0x0", "removed": false, "topics": [ "0x77900c982acb0a4b9c002980f47d50d1c82f6ce2d7b5749723ba0c097040ffa7", "0x0000000000000000000000000000000000000000000000000000000000000004" ], "transactionHash": "0x79dfb44c80e7282b6a7d5a4e917c06ef15778df6f488682b0ee2a1677d6dbae0", "transactionIndex": "0x1" } ], "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000400000000000000000000000000000000000000008000000000000100000000000000000000000000000000000000000000000000000018000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000008000000020000000000000000000000000000000000000000000000000000000000000000000000000000000", "status": "0x1", "to": "0xbbe55e29bbc6d71ecab1ac011c9ac5206ab2fe74", "transactionHash": "0x79dfb44c80e7282b6a7d5a4e917c06ef15778df6f488682b0ee2a1677d6dbae0", "transactionIndex": "0x1", "type": "0x2" } } } ] }, { "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": "string", "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 GIWA 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": { "baseFeePerGas": { "type": "string", "description": "Base fee per gas in hexadecimal" }, "blobGasUsed": { "type": "string", "description": "Amount of blob gas used in hexadecimal" }, "calls": { "type": "array", "items": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "integer", "description": "An error status code" }, "data": { "type": "string", "description": "A data field containing error related information" }, "message": { "type": "string", "description": "An error message" } }, "description": "(Optional) An object array containing error information" }, "gasUsed": { "type": "string", "description": "Amount of gas used 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" }, "maxUsedGas": { "type": "string", "description": "The maximum gas consumed while processing the simulated call, encoded as hexadecimal" }, "returnData": { "type": "string", "description": "Return data from the call in hexadecimal" }, "status": { "type": "string", "description": "Status code of the call in hexadecimal" } } }, "description": "Array of call results" }, "difficulty": { "type": "string", "description": "Block difficulty in hexadecimal" }, "excessBlobGas": { "type": "string", "description": "Excess blob gas in hexadecimal" }, "extraData": { "type": "string", "description": "Extra data field in hexadecimal" }, "gasLimit": { "type": "string", "description": "Gas limit in hexadecimal" }, "gasUsed": { "type": "string", "description": "Gas used in hexadecimal" }, "hash": { "type": "string", "description": "Block hash" }, "logsBloom": { "type": "string", "description": "Logs bloom filter in hexadecimal" }, "miner": { "type": "string", "description": "Miner/validator address" }, "mixHash": { "type": "string", "description": "Mix hash in hexadecimal" }, "nonce": { "type": "string", "description": "Nonce in hexadecimal" }, "number": { "type": "string", "description": "Block number in hexadecimal" }, "parentBeaconBlockRoot": { "type": "string", "description": "Parent beacon block root in hexadecimal" }, "parentHash": { "type": "string", "description": "Parent block hash" }, "receiptsRoot": { "type": "string", "description": "Receipts trie root in hexadecimal" }, "requestsHash": { "type": "string", "description": "Requests hash in hexadecimal" }, "sha3Uncles": { "type": "string", "description": "Uncle blocks hash in hexadecimal" }, "size": { "type": "string", "description": "Block size in hexadecimal" }, "stateRoot": { "type": "string", "description": "State trie root in hexadecimal" }, "timestamp": { "type": "string", "description": "Block timestamp in hexadecimal" }, "transactions": { "type": "array", "items": {}, "description": "Array of transaction hashes" }, "transactionsRoot": { "type": "string", "description": "Transactions trie root in hexadecimal" }, "uncles": { "type": "array", "items": {}, "description": "Array of uncle block hashes" }, "withdrawals": { "type": "array", "items": {}, "description": "Array of withdrawal objects" }, "withdrawalsRoot": { "type": "string", "description": "Withdrawals trie root in hexadecimal" } } } } }, "tags": [ { "name": "eth" } ], "externalDocs": { "description": "Quicknode docs", "url": "https://www.quicknode.com/docs/giwa/flashblocks/eth_simulateV1" }, "examples": [ { "name": "eth_simulateV1 example", "params": [ { "name": "blockParameter", "value": "pending" } ], "result": { "name": "eth_simulateV1 result", "value": [ { "baseFeePerGas": "0x5f5e100", "blobGasUsed": "0x9c40", "calls": [ { "error": { "code": 3, "data": "0x", "message": "execution reverted" }, "gasUsed": "0x5233", "logs": [], "maxUsedGas": "0x5233", "returnData": "0x", "status": "0x0" } ], "difficulty": "0x0", "excessBlobGas": "0x0", "extraData": "0x01000000fa000000060000000000000000", "gasLimit": "0x3938700", "gasUsed": "0x5233", "hash": "0x101021ea2f8900d7530407f54dc1a4fac21ea0d3177789f62db0d90df37a3a15", "logsBloom": "0x00000000000000000000080000000000001000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000040000000000000000000000000000000000000000000000020000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000002000001000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000100000000000000000000", "miner": "0x4200000000000000000000000000000000000011", "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000", "nonce": "0x0000000000000000", "number": "0x2052f3f", "parentBeaconBlockRoot": "0x797c82b4ab2c26b4e34357b8323d792ff85de7073885086d78b920f02ac15aca", "parentHash": "0xc140d75f15c9862a390d274f420a4517381658446df85c47c2f53a9736fb2a2c", "receiptsRoot": "0x619d343dce36c3c936ca930f3ba82e334507ca857025e6dae388b20d5e0e4bcf", "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x2b2", "stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000", "timestamp": "0x6a871ba6", "transactions": [ "0x722ca035810a03204f2dd2131bc43d3224c997abba372d53df2d7f1bec17e79c" ], "transactionsRoot": "0xcebd7014fb1c363148d6fa5feb255a7775a053cccbda91e457feb9fe4434cc34", "uncles": [], "withdrawals": [], "withdrawalsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000" } ] } } ] } ], "servers": [ { "name": "Flashblocks API", "url": "https://docs-demo.giwa-sepolia.quiknode.pro" } ] }