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_feeHistoryand priority fees, alongside legacy gasConservative RPC Surface: The widely-supported
eth_*/net_*/web3_*methods pluseth_subscribeand the coredebug_trace*methods, over HTTP and WebSocketTestnet: An environment for building against Citrea before mainnet
Network Information
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
Citrea Mainnet
4114
✅
✅
❌
❌
❌
❌
✅
❌
Quickstart
Available API Methods
Chain & Client Info
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
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
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
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
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
eth_call
Execute a message call without a transaction
eth_estimateGas
Estimate gas required to execute a transaction
Filters & Logs
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
eth_sendRawTransaction
Submit a signed transaction to the network
WebSocket Subscriptions
eth_subscribe
Subscribe to newHeads, logs, newPendingTransactions, or syncing
eth_unsubscribe
Cancel an active subscription
Debug & Trace
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:
Support: support@getblock.io
See Also
Last updated
Was this helpful?