JSON-RPC 레퍼런스

Params

none

Returns

"0x131be"

The chain id as a hex quantity. 78270 on the public testnet; the whitepaper's 78271 is the mainnet figure.

Params

none

Returns

"78270"

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

Params

none

Returns

true

Always true.

Params

none

Returns

"0x0"

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

Params

none

Returns

"pickle-sequencer/0.1.0"

The client identifier.

Params

[data]

Returns

keccak256 of the bytes

Hashes the hex-encoded bytes you pass.

Params

none

Returns

"0x41"

A hard-coded constant.

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.

Params

none

Returns

"0x1"

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

Params

none

Returns

"0x0"

Zero. There is no priority-fee market.

Params

none

Returns

"0x0"

Zero.

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.

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.

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.

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.

Params

[address, block?]

Returns

hex bytes

The deployed bytecode at the latest state.

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

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.

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.

Params

none

Returns

hex quantity

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

Params

[quantity]

Returns

mini-block, or null

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

Params

[hash]

Returns

mini-block, or null

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

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.

Params

[hash, fullTransactions?]

Returns

block, or null

As above, addressed by hash.

Params

[tag]

Returns

hex count, or null

Null when the block is no longer retained.

Params

[hash]

Returns

hex count, or null

Null when the block is no longer retained.

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

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.

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

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.

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".

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.

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

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)

Params

none

Returns

filter id

Buffers new block hashes for polling.

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.

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

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.

Params

[filterId]

Returns

boolean

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

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.

Params

none

Returns

node counters

The same handler as pickle_stats, under a second name.

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.

Params

any

Returns

-32601

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

Params

any

Returns

-32601

Refused, for the same reason.

Params

any

Returns

-32601

Refused, for the same reason.

Params

any

Returns

-32601

Refused, for the same reason.

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.

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.

Params

none

Returns

[]

Always empty. The node manages no keys.

Params

none

Returns

false

Always false.

Params

none

Returns

"0x0"

Always zero.

Params

[block]

Returns

"0x0"

Always zero. Parameters are not validated.

Params

[hash]

Returns

"0x0"

Always zero. Parameters are not validated.

Params

[block, index]

Returns

null

Always null. Parameters are not validated.

Params

[hash, index]

Returns

null

Always null. Parameters are not validated.

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.

Params

any

Returns

-32601 or -32603

As above.

Params

any

Returns

-32601 or -32603

As above.

Params

any

Returns

-32601 or -32603

As above.