Module nodeinterface_rpc 

RPC-layer handlers for NodeInterface (0xc8) methods that require chain-history or call-stack access beyond what a precompile can do.

Implemented as an eth_call override on ArbEthApi. Precompile-level fallbacks return zero / empty (see arb_precompiles::nodeinterface) so callers that don’t go through eth_call still get a valid response.

Constants

NODE_INTERFACE_ADDRESS

NodeInterface virtual contract address.

SEL_BLOCK_L1_NUM

SEL_CONSTRUCT_OUTBOX_PROOF

SEL_FIND_BATCH_CONTAINING_BLOCK

SEL_GAS_ESTIMATE_COMPONENTS

SEL_GAS_ESTIMATE_L1_COMPONENT

SEL_GET_L1_CONFIRMATIONS

SEL_L2_BLOCK_RANGE_FOR_L1

SEL_LEGACY_LOOKUP_MESSAGE_BATCH_PROOF

SEL_NITRO_GENESIS_BLOCK

Functions

decode_single_u64_arg

Decode the uint64 argument from the selector blockL1Num(uint64) / l2BlockRangeForL1(uint64) / findBatchContainingBlock(uint64) / nitroGenesisBlock() (no arg, returns 0).

encode_gas_estimate_components

ABI-encode the (uint64, uint64, uint256, uint256) result of gasEstimateComponents: (gasEstimate, gasEstimateForL1, baseFee, l1BaseFeeEstimate).

encode_l2_block_range

ABI-encode the (uint64, uint64) result of l2BlockRangeForL1.

encode_legacy_lookup_empty

ABI-encode legacyLookupMessageBatchProof’s all-zero 9-value tuple. The head is nine words (0x120), so the empty proof array begins at 0x120 and the empty calldataForL1 at 0x140; both length words live inside the 0x160 buffer.

encode_u64_word

ABI-encode a single uint64 as a right-aligned 32-byte word.

find_l2_block_range

Binary-search headers to find the block-range that was emitted against the given L1 block. The predicate on each header is l1_block_number_from_mix_hash(header.mix_hash).

gas_estimate_data_len

Extract the bytes parameter (data) from an ABI-encoded (address, bool, bytes) gas-estimate call, returning its length.

unpack_mix_hash

Decode a packed header’s mix_hash field to (sendCount, l1BlockNumber, arbosVersion).