JSON-RPC reference

Params

none

Returns

"0x131be"

The chain id as a hex quantity. 78270.

runs inline · sequencer/src/rpc.rs:1171

Params

none

Returns

"78270"

The same id as a decimal string, per the older convention.

runs inline · sequencer/src/rpc.rs:1171

Params

none

Returns

true

Always true.

runs inline · sequencer/src/rpc.rs:1171

Params

none

Returns

"0x0"

Always zero. The node has no peer-to-peer layer.

runs inline · sequencer/src/rpc.rs:1171

Params

none

Returns

"pickle-sequencer/0.1.0"

The client identifier.

runs inline · sequencer/src/rpc.rs:1175

Params

[data]

Returns

keccak256 of the bytes

Hashes the hex-encoded bytes you pass.

runs inline · sequencer/src/rpc.rs:1176

Params

none

Returns

"0x41"

A hard-coded constant.

runs inline · sequencer/src/rpc.rs:1176

Params

none

Returns

{ eth, net, web3, pickle }

The advertised namespaces, each at version 1.0. Note what is absent and unimplemented: debug, trace, txpool and admin.

runs inline · sequencer/src/rpc.rs:1176

Params

none

Returns

"0x1"

One wei, which is also the minimum the chain accepts.

runs inline · sequencer/src/rpc.rs:1184

Params

none

Returns

"0x0"

Zero. There is no priority-fee market.

runs inline · sequencer/src/rpc.rs:1184

Params

none

Returns

"0x0"

Zero.

runs inline · sequencer/src/rpc.rs:1184

Params

[blockCount, …]

Returns

constant arrays

Reads only the first parameter, clamped to 1..1024, and ignores newestBlock and rewardPercentiles entirely.

Differs from Ethereum. The values are constants, not measurements: baseFeePerGas is 0x1 repeated, gasUsedRatio is 0.0 repeated, and reward is null. Do not read it as fee data.

runs inline · sequencer/src/rpc.rs:1600

Params

none

Returns

hex quantity

The retained tip. A fresh node answers 0x0 while eth_getBlockByNumber("latest") answers null, because no block has sealed yet.

runs inline · sequencer/src/rpc.rs:1190

Params

[address, block?]

Returns

hex wei

The account's balance at the latest state.

Differs from Ethereum. The block parameter is accepted and silently ignored. There is no historical state - every state read answers from the published latest snapshot.

runs inline · sequencer/src/rpc.rs:1237

Params

[address, block?]

Returns

hex quantity

The account's nonce at the latest state.

Differs from Ethereum. The block parameter is accepted and silently ignored.

runs inline · sequencer/src/rpc.rs:1237

Params

[address, block?]

Returns

hex bytes

The deployed bytecode at the latest state.

Differs from Ethereum. The block parameter is accepted and silently ignored.

runs inline · sequencer/src/rpc.rs:1237

Params

[address, slot, block?]

Returns

32-byte hex word

One storage slot at the latest state.

Differs from Ethereum. The block parameter is accepted and silently ignored.

runs inline · sequencer/src/rpc.rs:1237

Params

none

Returns

false, or a progress object

A leader always answers false. A replica answers false once it has caught up, otherwise { startingBlock, currentBlock, highestBlock } where highestBlock is the L1-derived target.

Differs from Ethereum. startingBlock is currentBlock + 1 rather than the block the sync actually began at.

runs inline · sequencer/src/rpc.rs:1579

Params

none

Returns

hex quantity

The mini-block tip, or 0x0 before the first one is sealed.

runs inline · sequencer/src/rpc.rs:1368

Params

[quantity]

Returns

mini-block, or null

Accepts either a hex string or a plain JSON number. Answers null outside the retained window.

runs on the blocking pool · sequencer/src/rpc.rs:1371

Params

[hash]

Returns

mini-block, or null

A reverse scan of the retained mini-blocks. Answers null when it is gone.

runs on the blocking pool · sequencer/src/rpc.rs:1380

Params

[tag, fullTransactions?]

Returns

block, or null

The Cancun-shaped block, plus Pickle's own miniBlockFrom, miniBlockTo and miniBlocks fields.

Differs from Ethereum. With fullTransactions true, a transaction whose receipt has been evicted falls back to its bare hash string - so one block can return a mixed array of objects and strings.

runs on the blocking pool · sequencer/src/rpc.rs:1194

Params

[hash, fullTransactions?]

Returns

block, or null

As above, addressed by hash.

runs on the blocking pool · sequencer/src/rpc.rs:1194

Params

[tag]

Returns

hex count, or null

Null when the block is no longer retained.

runs on the blocking pool · sequencer/src/rpc.rs:1215

Params

[hash]

Returns

hex count, or null

Null when the block is no longer retained.

runs on the blocking pool · sequencer/src/rpc.rs:1215

Params

[callObject]

Returns

hex return data

Simulates against the latest state. Reads from, to, data or input, and value.

Differs from Ethereum. gas, gasPrice, nonce and the block parameter are all ignored - simulation always runs at the 30M block gas limit against latest state. A revert comes back as JSON-RPC error -32000 with the message "execution reverted: 0x<returndata>", not as a successful result carrying revert data, and error.data is absent, so a client cannot decode a custom error.

Errors. -32000 on revert, -32005 over 128 KiB of call data or when the heavy-read budget is exhausted

runs on the blocking pool · sequencer/src/rpc.rs:1262

Params

[callObject]

Returns

hex quantity

Simulates on a copy-on-write clone, adds 12.5% headroom in the geth convention, floors at 21,000 and caps at the block gas limit.

Differs from Ethereum. Same ignored fields as eth_call. A revert surfaces as -32000.

runs on the blocking pool · sequencer/src/rpc.rs:1271

Params

[rawHex]

Returns

transaction hash

Decodes, recovers the signer, and submits to the execution coordinator. The call BLOCKS until the transaction has executed or failed - it does not merely enqueue, so a successful return already means executed.

Differs from Ethereum. Size is checked on the hex string before decoding, so anything over 128 KiB is rejected as a limit rather than a decode failure.

Errors. -32005 admission queue full; -32005 timed out after a 6 s wait; -32000 with the execution message on decode, signature, consensus or state failure; -32603 on a write-ahead-log or coordinator failure

runs on the blocking pool · sequencer/src/rpc.rs:875

Params

[hash]

Returns

transaction, or null

Carries three non-standard extras: raw (the full transaction, while the body is still indexed), miniBlockNumber and miniBlockHash.

Differs from Ethereum. type is always "0x0" and there is a single flat gasPrice, whatever the real envelope type - no maxFeePerGas, maxPriorityFeePerGas or accessList is reported. blockHash and blockNumber are null for a transaction that has executed but whose EVM block has not sealed yet.

runs on the blocking pool · sequencer/src/rpc.rs:2004

Params

[hash]

Returns

receipt, or null

A receipt exists within the mini-block scheduling target of sending, while blockNumber and blockHash stay null until the EVM seal. Also carries miniBlockNumber and miniBlockHash.

Differs from Ethereum. cumulativeGasUsed is this transaction's own gasUsed, NOT a running block total. logsBloom is 512 zeros. type is always "0x0".

runs on the blocking pool · sequencer/src/rpc.rs:2025

Params

[tag]

Returns

receipt array, or null

Silently omits any transaction whose receipt has been evicted from the index, so the array can be shorter than the block's transaction list.

runs on the blocking pool · sequencer/src/rpc.rs:1304

Params

[filterObject]

Returns

log array

address may be a string or an array; topics is positional, each entry null, a string or an array. An absent fromBlock defaults to the earliest RETAINED block, an absent toBlock to the tip.

Differs from Ethereum. logIndex is enumerated per transaction, not per block. The tags pending, safe and finalized all resolve to the tip, and earliest resolves to the earliest retained block rather than block 0.

Errors. -32602 when toBlock precedes fromBlock; -32005 for a span of 5,000 blocks or more; -32005 above 10,000 matches; -32005 when the heavy-read budget is exhausted

runs on the blocking pool · sequencer/src/rpc.rs:1617

Params

[filterObject]

Returns

filter id

Ids are sequential hex from a per-node counter. Takes the same shape as eth_getLogs.

Errors. -32005 at the filter limit (1024 by default)

runs on the blocking pool · sequencer/src/filters.rs:34

Params

none

Returns

filter id

Buffers new block hashes for polling.

runs on the blocking pool · sequencer/src/filters.rs:34

Params

none

Returns

filter id

Buffers transaction hashes.

Differs from Ethereum. "Pending" is a misnomer here. A hash is published only AFTER the transaction has executed and been indexed, because there is no public mempool to be pending in.

runs on the blocking pool · sequencer/src/rpc.rs:854

Params

[filterId]

Returns

array of new entries

Drains: everything since your last poll, and nothing twice.

Errors. -32602 "filter not found" for an unknown or expired id; -32602 "filter id" when it will not parse

runs on the blocking pool · sequencer/src/rpc.rs:1438

Params

[filterId]

Returns

log array

Does NOT drain. For a log filter it re-scans the retained index from the filter's fromBlock to the tip, so a fresh filter answers with history rather than an empty array.

runs on the blocking pool · sequencer/src/rpc.rs:1438

Params

[filterId]

Returns

boolean

True if the id existed, false for an unknown or malformed one.

runs on the blocking pool · sequencer/src/rpc.rs:1351

Params

none

Returns

node counters

Role, heights, index sizes, admission depth, L1 batch and bridge counts, uptime, the explorer spool, and a latency block. Deliberately carries no file paths, upstream URLs or key material, and a test asserts that.

runs on the blocking pool · sequencer/src/rpc.rs:1645

Params

none

Returns

node counters

The same handler as pickle_stats, under a second name.

runs on the blocking pool · sequencer/src/rpc.rs:1645

Params

none

Returns

{ ok, bytes }

Forces a state checkpoint. Needs the dev-admin cargo feature, which is not in the default set - without it the method answers -32601.

runs on the blocking pool · sequencer/src/rpc.rs:1392

Params

any

Returns

-32601

Refused. The node holds no user keys; sign locally and use eth_sendRawTransaction.

runs on the blocking pool · sequencer/src/rpc.rs:1282

Params

any

Returns

-32601

Refused, for the same reason.

runs on the blocking pool · sequencer/src/rpc.rs:1282

Params

any

Returns

-32601

Refused, for the same reason.

runs on the blocking pool · sequencer/src/rpc.rs:1282

Params

any

Returns

-32601

Refused, for the same reason.

runs on the blocking pool · sequencer/src/rpc.rs:1282

Params

none

Returns

-32601

Refused, even though a sealed block does report a miner - that value is the fee treasury and is readable from the block.

runs on the blocking pool · sequencer/src/rpc.rs:1256

Params

ignored

Returns

{ accessList: [], gasUsed: "0x0" }

A constant. It looks at neither the parameters nor the state.

Differs from Ethereum. There is no access-list computation. Anything relying on the result to pre-warm slots is relying on nothing.

runs inline · sequencer/src/rpc.rs:1280

Params

none

Returns

[]

Always empty. The node manages no keys.

runs inline · sequencer/src/rpc.rs:1256

Params

none

Returns

false

Always false.

runs inline · sequencer/src/rpc.rs:1256

Params

none

Returns

"0x0"

Always zero.

runs inline · sequencer/src/rpc.rs:1256

Params

[block]

Returns

"0x0"

Always zero. Parameters are not validated.

runs inline · sequencer/src/rpc.rs:1231

Params

[hash]

Returns

"0x0"

Always zero. Parameters are not validated.

runs inline · sequencer/src/rpc.rs:1231

Params

[block, index]

Returns

null

Always null. Parameters are not validated.

runs inline · sequencer/src/rpc.rs:1231

Params

[hash, index]

Returns

null

Always null. Parameters are not validated.

runs inline · sequencer/src/rpc.rs:1231

Params

any

Returns

-32601 or -32603

Registered but unusable in every build: -32601 without the dev-admin feature, and -32603 "in-process stress driver is not wired in this build" with it. Use the harnesses under scripts/ instead.

runs on the blocking pool · sequencer/src/rpc.rs:1397

Params

any

Returns

-32601 or -32603

As above.

runs on the blocking pool · sequencer/src/rpc.rs:1397

Params

any

Returns

-32601 or -32603

As above.

runs on the blocking pool · sequencer/src/rpc.rs:1397

Params

any

Returns

-32601 or -32603

As above.

runs on the blocking pool · sequencer/src/rpc.rs:1397