For the complete documentation index, see llms.txt. This page is also available as Markdown.

JSON RPC API

Who this is for: developers calling Lumia RPC endpoints directly. This is the method table only: for setup and choosing an endpoint see /run-a-node/rpc-node/json-rpc-endpoints, which transcludes this page.

Standard Ethereum JSON-RPC

Lumia nodes run cdk-erigon and expose the standard Ethereum JSON-RPC namespaces. Both public endpoints run cdk-erigon v2.65.0-RC2.

Compatibility is therefore cdk-erigon's, not go-ethereum's, and the two differ at the edges. eth_getProof is not available on either endpoint, and neither is the long-deprecated eth_getCompilers.

eth_feeHistory and eth_maxPriorityFeePerGas are available on both.

Lumia's own public endpoints were probed directly. Both behave identically:

Namespace
On the public endpoints
Probe

trace_*

Available

trace_block returned trace data on both chains

txpool_*

Available

txpool_status returned baseFee, pending, queued on both

debug_*

Partially available. The tracing calls work; the raw-data getters do not.

debug_traceCall and debug_traceBlockByNumber returned results; debug_getRawHeader and debug_getRawTransaction returned error -32601

admin_*

Not available

admin_nodeInfo returned error -32601 on both

If you are running your own node, this is the shape worth copying: tracing exposed, administration closed.

Lumia-specific extensions (zkevm_*)

Quoted from docs.lumia.org:

Method
Description

zkevm_consolidatedBlockNumber

"Returns the latest block number that is connected to the latest batch verified."

zkevm_isBlockVirtualized

"Returns true if the provided block number is already connected to a batch that was already virtualized, otherwise false."

zkevm_isBlockConsolidated

"Returns true if the provided block number is already connected to a batch that was already verified, otherwise false."

zkevm_batchNumber

"Returns the latest batch number."

zkevm_virtualBatchNumber

"Returns the latest virtual batch number."

zkevm_verifiedBatchNumber

"Returns the latest verified batch number."

zkevm_batchNumberByBlockNumber

"Returns the batch number of the batch connected to the block."

zkevm_getBatchByNumber

"Gets a batch for a given number"

zkevm_getFullBlockByNumber

"Gets a block with extra information for a given number"

zkevm_getFullBlockByHash

"Gets a block with extra information for a given hash"

zkevm_getNativeBlockHashesInRange

"Returns the list of native block hashes."

zkevm_getTransactionByL2Hash

"Returns the information about a transaction requested by transaction l2 hash."

zkevm_getTransactionReceiptByL2Hash

"Returns the receipt information of a transaction by its l2 hash."

zkevm_getExitRootsByGER

"Gets the exit roots accordingly to the provided Global Exit Root"

zkevm_getLatestGlobalExitRoot

"Returns the latest global exit root used in a batch."

zkevm_estimateCounters

"Estimates the transaction ZK Counters"

zkevm_estimateFee

"Estimates the transaction Fee following the effective gas price rules"

zkevm_estimateGasPrice

"Estimates the transaction Gas Price following the effective gas price rules"

Deprecated / unsupported

docs.lumia.org itself lists none of the above as deprecated.

Source / last verified

Standard/zkevm_* method text: checked at docs.lumia.org/build/run-an-rpc/json-rpc-endpoints.

Last updated

Was this helpful?