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

Citrea

GetBlock provides fast and reliable access to Citrea nodes via JSON-RPC API. Connect to the Citrea network without running your own infrastructure.

Citrea is a ZK-rollup that brings EVM smart contracts to Bitcoin: it is the first zkEVM rollup settling to Bitcoin, using BitVM-based bridging and zero-knowledge proofs for verification. Its native gas token is cBTC, a Bitcoin-backed asset.

The execution layer is EVM-compatible, so Solidity contracts and the eth_* JSON-RPC surface, along with tooling such as Foundry, Hardhat, Ethers.js, and Viem, work unchanged. This reference documents the Ethereum-compatible JSON-RPC interface of the Citrea mainnet, available over HTTP and WebSocket

Key Features

  • Bitcoin zkEVM Rollup: The first zkEVM rollup settling to Bitcoin, verified with zero-knowledge proofs

  • cBTC Gas: Transaction fees are paid in cBTC, a Bitcoin-backed native asset

  • EVM Compatible: Runs standard Ethereum bytecode and tooling unchanged

  • EIP-1559 Fees: Base-fee pricing with eth_feeHistory and priority fees, alongside legacy gas

  • Conservative RPC Surface: The widely-supported eth_* / net_* / web3_* methods plus eth_subscribe and the core debug_trace* methods, over HTTP and WebSocket

  • Testnet: An environment for building against Citrea before mainnet

TECHNICAL DISCLAIMER: AUTHORITATIVE JSON-RPC API SPECIFICATION.

GetBlock's RPC API reference documentation is provided exclusively for informational purposes and to optimize the developer experience. Citrea implements the standard Ethereum JSON-RPC interface; the canonical specification for these methods is the Ethereum JSON-RPC specification at ethereum.org, and Citrea-specific behavior is documented at Citrea Documentation. Citrea is a zkEVM; some Ethereum methods common on geth nodes may be unavailable.

Network Information

Property
Value

Network Name

Citrea

Chain ID

5115

Native Currency

cBTC (Bitcoin-backed)

EVM Compatible

Yes (zkEVM)

Settlement Layer

Bitcoin

Fee Model

EIP-1559 + legacy

Base URL

Supported Networks

Network
Chain ID
JSON-RPC
WSS
GraphQL
MEV protected (WebSocket)
MEV protected (JSON-RPC)
Frankfurt, Germany
New York, USA
Singapore, Singapore

Citrea Mainnet

4114

✅

✅

❌

❌

❌

❌

✅

❌

Quickstart

1

Setup project

2

Install dependency

3

Add code

4

Run the script

5

Response

1

Setup project

2

Install dependency

3

Add code

4

Run the script

Available API Methods

Chain & Client Info

Method
Description

web3_clientVersion

Client software version identifier

web3_sha3

Keccak-256 hash of hex-encoded data

net_version

Network ID as a decimal string

eth_chainId

Chain ID per EIP-155

eth_blockNumber

Current chain tip block number

eth_syncing

Sync status, or false if fully synced

Gas & Fees

Method
Description

eth_gasPrice

Legacy gas price estimate in wei

eth_maxPriorityFeePerGas

Suggested EIP-1559 priority fee in wei

eth_feeHistory

Historical base fees and priority-fee percentiles

Account & State

Method
Description

eth_getBalance

GLMR balance of an address at a given block

eth_getStorageAt

Value at a specific contract storage slot

eth_getTransactionCount

Address nonce (transaction count)

eth_getCode

Deployed bytecode at an address

Blocks

Method
Description

eth_getBlockByHash

Block data by block hash

eth_getBlockByNumber

Block data by block number or tag

eth_getBlockTransactionCountByHash

Transaction count in a block, by hash

eth_getBlockTransactionCountByNumber

Transaction count in a block, by number

Transactions

Method
Description

eth_getTransactionByHash

Transaction data by transaction hash

eth_getTransactionByBlockHashAndIndex

Transaction by block hash and index

eth_getTransactionByBlockNumberAndIndex

Transaction by block number and index

eth_getTransactionReceipt

Transaction receipt with status, gas, and logs

Execution & Simulation

Method
Description

eth_call

Execute a message call without a transaction

eth_estimateGas

Estimate gas required to execute a transaction

Filters & Logs

Method
Description

eth_newFilter

Create a log filter with address and topic criteria

eth_newBlockFilter

Create a filter for new block hashes

eth_newPendingTransactionFilter

Create a filter for pending transaction hashes

eth_uninstallFilter

Remove a previously created filter

eth_getFilterChanges

Poll new entries for a filter since the last poll

eth_getFilterLogs

Get all logs matching a log filter

eth_getLogs

Query logs matching criteria in one call

Transaction Submission

Method
Description

eth_sendRawTransaction

Submit a signed transaction to the network

WebSocket Subscriptions

Method
Description

eth_subscribe

Subscribe to newHeads, logs, newPendingTransactions, or syncing

eth_unsubscribe

Cancel an active subscription

Debug & Trace

Method
Description

debug_traceBlockByHash

Trace all transactions in a block by hash

debug_traceBlockByNumber

Trace all transactions in a block by number

debug_traceCall

Trace a simulated message call

debug_traceTransaction

Trace execution of a mined transaction

Support

For technical support and questions:

See Also

Last updated

Was this helpful?