跳到主要内容

浏览器 / 索引器 REST API

explorer.bout.network 上的 OXN 区块浏览器由一个 REST API 支撑。这个 API 驱动浏览器 UI，也可以直接用于索引器、分析面板、监控服务。

基础 URL​

API 在：

https://explorer.bout.network/v1/

所有端点返回 JSON。

常见查询模式​

端点路径与字段名可能演进。以下是典型端点形态；具体 schema 以线上 API 为准。

区块​

curl https://explorer.bout.network/v1/blocks?limit=10
curl https://explorer.bout.network/v1/blocks/12345

返回区块元数据：高度、哈希、时间戳、交易数、消耗 gas。

交易​

curl https://explorer.bout.network/v1/transactions?limit=25
curl https://explorer.bout.network/v1/transactions/0x{tx_hash}

交易字段：from、to、value、gas、status。加密交易的 data 字段存在但不透明（CBOR 信封字节）。

账户​

curl https://explorer.bout.network/v1/accounts/0x{address}

返回余额、交易计数，以及（如果是合约）创建交易。

事件 / Allowances​

领域相关的表——具体端点取决于索引器暴露了什么。标准表包括事件日志（加密交易的为加密）与 ERC-20 allowances。

分页​

返回列表的端点支持分页：

?limit=25&offset=0

或基于游标：

?limit=25&after=<cursor>

跟随响应中的 Link header 或 next_cursor 字段继续。

查询过滤​

常见过滤：

  • ?address=0x...——限定到特定账户或合约
  • ?from_height=X&to_height=Y——限定到区块范围
  • ?status=success|failed——按交易状态限定

API 能看到什么​

浏览器索引器看到的与任何观察者一致的公开链数据：

  • 区块与交易元数据：完全可见。
  • 加密 calldata：不透明字节。
  • 加密事件 topic / data：不透明字节。
  • 合约地址与字节码：完全可见。

索引器无法解密机密合约状态或事件内容。它是纯公开读侧，符合预期。

限流​

REST API 应用自己的限流，与 JSON-RPC 限流形态相似——按 IP 配额、429 Too Many Requests 响应。见限流。

自建索引器​

需要自定义索引（特定事件、计算视图、交叉引用数据），针对 OXN RPC 自建索引器很直接。标准 EVM 索引器（Ponder、Envio、SubQuery 模式）只要能接受加密 calldata 作为不透明字节就能工作。

下一步​