Method Support By Mode
Method Support By Mode
Section titled “Method Support By Mode”Use this matrix to choose the right mode. This page is a summary of the normative contract sources in docs/specs/prd.md and docs/specs/json-rpc-contract.md.
Use JSON-RPC reference pages for exact method signatures, params, payloads, and errors.
Capability Matrix
Section titled “Capability Matrix”| Capability family | Trusted mode | Light mode | Method details |
|---|---|---|---|
Core reads (eth_chainId, eth_blockNumber, account/code/storage/nonce reads) | yes | yes (eth_chainId always; proof-backed account/code/storage/nonce reads and eth_blockNumber require ready = true; proof-backed numeric selectors are limited to block 0 plus the retained verified-history window) | Core Reads, Verified Light-Mode Reads |
Simulation (eth_call, eth_estimateGas) | yes | no (-32010; both are trusted-only in phase 1, and eth_call remains a deferred light-mode proof-backed target) | Simulation, Unsupported And Deferred |
| Transaction submission and mining | yes | no | Transactions And Mining |
Compatibility utilities (web3_*, net_*, eth_mining, eth_syncing, eth_protocolVersion) | yes | no (-32010) | JSON-RPC Overview |
Txpool introspection (txpool_content, txpool_status, txpool_inspect) | yes | no (-32010) | Transactions And Mining |
Canonical block/transaction/receipt/log queries, including block tx counts, tx-by-block-index lookups, and eth_getLogs | yes | no | Blocks, Receipts, And Logs |
ZEVM trusted namespace (zevm_* except zevm_lightSyncStatus) | yes | no | ZEVM Controls |
ZEVM light namespace (zevm_lightSyncStatus) | no | yes | Verified Light-Mode Reads |
Trusted compatibility aliases (anvil_*, selected hardhat_*, selected evm_*) | yes | no | ZEVM Controls, Transactions And Mining |
Filter lifecycle beyond eth_getLogs | not part of current contract (deferred) | not part of current contract (deferred) | Unsupported And Deferred |
Subscriptions (eth_subscribe, eth_unsubscribe) | not part of current contract (deferred method surface) | not part of current contract (deferred method surface) | Unsupported And Deferred |
| WebSocket transport | transport-level unsupported (HTTP JSON-RPC only; outside JSON-RPC method dispatch, not a method-level deferred mapping) | transport-level unsupported (HTTP JSON-RPC only; outside JSON-RPC method dispatch, not a method-level deferred mapping) | Unsupported And Deferred |
Selector And Readiness Rules
Section titled “Selector And Readiness Rules”- mode-incompatible methods fail with
-32010 - compatibility alias acceptance is closed-world: only aliases explicitly enumerated on JSON-RPC reference pages are accepted
- deferred-surface promotion and phase-1 boundary/graduation criteria are canonicalized in Specs And Process
- in light mode,
eth_chainIdis always callable - in light mode, while
ready = false, proof-backed reads andeth_blockNumberfail with-32011 - in light mode, numeric selectors are limited to block
0plus the retained verified-history window - in light mode, numeric selectors outside that retained window fail with
-32602 - in light mode, canonical query methods on the blocks/receipts/logs page (
eth_getBlockBy*,eth_getBlockTransactionCountBy*,eth_getTransactionBy*,eth_getTransactionReceipt,eth_getBlockReceipts,eth_getLogs) fail with-32010 - trusted-mode
pending,safe, andfinalizedare aliases oflatest - light-mode
safeandfinalizedare consensus-anchored heads
Where To Go Next
Section titled “Where To Go Next”- Concept: Runtime Modes
- Concept: Trusted Mode
- Concept: Light Mode
- Quickstart: Run Trusted Mode
- Quickstart: Forked Dev Node
- Reference: Canonical Specs And Docs-First Process
- Reference: Configuration Overview