diff --git a/docs/base-chain/flashblocks/api-reference.mdx b/docs/base-chain/flashblocks/api-reference.mdx index 2ff1577f7..13720e384 100644 --- a/docs/base-chain/flashblocks/api-reference.mdx +++ b/docs/base-chain/flashblocks/api-reference.mdx @@ -45,7 +45,12 @@ When called with `"pending"`, returns the current Flashblock — the block activ #### Returns - A block object reflecting the current preconfirmed state. See [eth_getBlockByNumber](/base-chain/reference/json-rpc-api#eth_getblockbynumber) for full field descriptions. + A block object reflecting the current preconfirmed state. See [eth_getBlockByNumber](/base-chain/reference/json-rpc-api#eth_getblockbynumber) for full field descriptions. Flashblocks-specific fields: + + - `withdrawals` — Always `[]` for Base (no L2 withdrawals in pending blocks). + - `parentBeaconBlockRoot` — Beacon block root passed from the builder; present on all pending blocks. + - `requestsHash` — Always the empty requests hash (`0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855`). + - `blobGasUsed` — Accurately reflects blob gas consumed by preconfirmed transactions (not zero-padded). @@ -63,7 +68,12 @@ curl https://sepolia-preconf.base.org \ "result": { "number": "0x1234", "hash": "0x...", - "transactions": [...] + "parentHash": "0x...", + "parentBeaconBlockRoot": "0xa4b2c8e1f3d5b7a9c2e4f6d8b0a2c4e6f8d0b2a4c6e8f0d2b4a6c8e0f2d4b6a8", + "withdrawals": [], + "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", + "blobGasUsed": "0x0", + "transactions": ["0x..."] } } ``` @@ -85,6 +95,8 @@ Returns the receipt for a preconfirmed transaction before it is included in a fi A transaction receipt object for the preconfirmed transaction, or `null` if not found. See [eth_getTransactionReceipt](/base-chain/reference/json-rpc-api#eth_gettransactionreceipt) for full field descriptions. + + - `blobGasUsed` — Accurately reflects blob gas used by the transaction. Previously returned `0x0` for all preconfirmed transactions; now correctly propagated from the Flashblock. @@ -102,7 +114,8 @@ curl https://sepolia-preconf.base.org \ "result": { "transactionHash": "0x...", "blockNumber": "0x1234", - "status": "0x1" + "status": "0x1", + "blobGasUsed": "0x0" } } ```