Skip to content

docs: Document intentional RPC endpoint block parameter defaults (ENG-1904)#91

Open
init4samwise wants to merge 1 commit intomainfrom
samwise/eng-1904-rpc-endpoint-block-defaults
Open

docs: Document intentional RPC endpoint block parameter defaults (ENG-1904)#91
init4samwise wants to merge 1 commit intomainfrom
samwise/eng-1904-rpc-endpoint-block-defaults

Conversation

@init4samwise
Copy link
Contributor

Summary

Adds documentation explaining the intentional difference in default block parameters across EVM RPC endpoints, addressing ENG-1904.

Current Implementation (Verified Correct)

  • eth_call: Defaults to latest - for inspecting current chain state
  • eth_estimateGas: Defaults to pending - for estimating new transactions with newest header info
  • eth_createAccessList: Currently not_supported, would default to pending when implemented

Changes

  • Added inline comments explaining the design rationale at the relevant code locations
  • Added comprehensive documentation comment on TxParams struct
  • Confirmed current behavior matches architectural intent per @prestwich guidance

Context

James clarified in Linear that:

estimateGas and createAccessList are always for creating new transactions, and thus require newest header information (pending). while ethCall may be for inspecting current state, and therefore uses latest.

This PR documents this intentional design choice to prevent future confusion.

Closes ENG-1904

- eth_call uses 'latest' for current state inspection
- eth_estimateGas uses 'pending' for new transaction estimation
- eth_createAccessList would use 'pending' when implemented

Resolves ENG-1904
@init4samwise init4samwise requested a review from a team as a code owner February 28, 2026 15:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant