面向比特币应用的 Citrea RPC

Citrea 是一个 ZK Rollup，直接将批次证明和压缩后的状态差异发布到比特币上，因此仅凭比特币即可重建其状态。其他比特币扩容方案往往依赖侧链验证者、联邦多签或外部数据可用性层。BTC 通过 Clementine 进出 Citrea——这是一座基于 BitVM 的跨链桥，其安全性只需要一个诚实的签名者、观察塔和挑战者，而不是诚实多数。在执行层面，Citrea 运行 Type 2 zkEVM，现有 Solidity 合约无需修改即可部署。

GetBlock 通过 HTTPS JSON-RPC 和 WebSocket 端点提供 Citrea 托管访问。服务涵盖标准的 eth_、net_ 和 web3_ 方法，以及用于交易追踪的 eth_subscribe 和 debug_trace* 方法。自建 Citrea 全节点还需要一个已同步的比特币节点。GetBlock 同时运维两者，正常运行时间达 99.99%。

任何与 EVM 兼容的钱包，只需将 Chain ID 4114 和 GetBlock 端点添加为自定义网络即可连接 Citrea。Citrea 的 Schnorr 和 secp256r1 预编译合约也让智能账户钱包能够在链上验证通行密钥（passkey）和比特币风格的签名。面向 JavaScript、TypeScript、Python、Go 和 Rust 的标准以太坊 SDK 以及常用的合约开发框架均可直接使用。

Citrea RPC 节点可返回 cBTC 余额、交易、收据、区块、事件日志、合约存储，并可通过合约调用获取 ERC-20 代币数据。Debug 追踪方法提供调用级别的执行细节，便于索引和审计。由于每个区块都以记录比特币区块头和跨链桥事件的系统交易开头，应用还可以通过标准的 eth_call 从 BitcoinLightClient 合约读取比特币区块数据。

在 GetBlock 控制台中创建 Citrea 主网端点，即可获得包含访问令牌的 HTTPS 和 WSS URL。将任意 EVM 库或钱包指向该 URL，设置 Chain ID 为 4114，原生货币为 cBTC（18 位小数）。首次调用 eth_chainId 或 eth_blockNumber 即可确认连接成功。

大多数应用依赖 eth_getBalance、eth_call、eth_sendRawTransaction、eth_getTransactionReceipt、eth_getLogs 和 eth_feeHistory，并使用 debug_traceTransaction 获取执行追踪。部分 Citrea 区块链节点还提供 citrea_ 和 ledger_ 命名空间，例如可用 citrea_getLastProvenL2Height 查看链在比特币上已被证明到的高度。

支持。GetBlock 的 Citrea 端点支持 WebSocket 连接，可通过 eth_subscribe 订阅 newHeads、logs 和 newPendingTransactions。由于出块时间为 2 秒，newHeads 可稳定推送软确认区块。Citrea 的内存池不公开，因此与拥有公开内存池的链相比，待处理交易订阅提供的信息可能较少。

Citrea 主网的 Chain ID 为 4114（0x1012），Citrea 测试网的 Chain ID 为 5115（0x13fb）。两个网络均以 cBTC 作为原生货币，精度为 18 位小数。调用 eth_chainId 会返回十六进制值，钱包和库据此确认所连接的网络是否正确。