跳转至主要内容

X Layer API 概述

更新于
2026年4月28日

Quicknode 在所有端点上均支持以下 X Layer API。通过您的 X Layer 端点,您可以调用这些 API 中提供的任何方法。有关支持的 RPC 方法的完整列表,请参阅各 API 的文档。

支持的 API

支持的网络

Quicknode 提供以下 X 层网络的接入服务:

主网
类型:制作
链 ID:
196
HTTP:
WSS:
存档:
修剪:
测试网
类型:测试网
链 ID:
1952
HTTP:
WSS:
存档:
修剪:
注:

XLayer 在区块处使用重新生成机制 42,810,021. 此区块之前的历史数据虽然可用,但存储在旧版节点上,当您为诸如 eth_getBlockByNumber, eth_getBalance,以及 debug_trace*.

区块 42,810,021 本身无法追踪,且可能会返回 {"code":4444,"message":"pruned history unavailable"}.

交易节点要求

X Layer 使用两种不同的节点客户端,它们在重创世边界(区块42,810,021)处分开:

  • 42,810,021 以及此前 — 需要一个 cdk-Erigon 节点。Geth 节点返回 null 用于这些历史交易。
  • 块之后 42,810,021 — 需要一个 盖斯 节点。Erigon 节点返回 null 用于这些当前交易。

要查询重生前的数据,请包含 x-qn-height 在请求中添加包含目标块编号的标头,以便将其路由到 cdk-Erigon 节点。如果没有此标头,请求将默认使用 盖斯 节点,因此对于“再生成”后的区块,不要求包含区块头。

“重生”前的示例(cdk-Erigon,区块号 ≤ 42,810,021):

curl --location 'https://docs-demo.xlayer-mainnet.quiknode.pro/' \
--header 'Content-Type: application/json' \
--header 'x-qn-height: 42810020' \
--data '{"method":"eth_getBlockByNumber","params":["0x28D3AA4",false],"id":1,"jsonrpc":"2.0"}'

重生后示例(盖斯,区块号 > 42,810,021):

curl --location 'https://docs-demo.xlayer-mainnet.quiknode.pro/' \
--header 'Content-Type: application/json' \
--data '{"method":"eth_getBlockByNumber","params":["0x28D3AA6",false],"id":1,"jsonrpc":"2.0"}'

支持的产品

分享此文档