本文是 docs/API.md 的中文快速入口，面向需要先跑通常用查询的矿工、集成者和文档读者。完整字段说明和更多端点请参考英文版 API Reference。
Base URL: https://rustchain.org
所有示例使用 curl -sk，其中 -k 用于当前节点证书环境。
检查节点是否在线、数据库是否可写、版本和同步状态：
curl -sk https://rustchain.org/health | jq .| 字段 | 类型 | 含义 |
|---|---|---|
ok |
boolean | 节点是否健康 |
version |
string | 节点协议版本 |
uptime_s |
integer | 节点运行秒数 |
db_rw |
boolean | 数据库是否可读写 |
查询当前 epoch、slot、奖励池和已登记矿工数量：
curl -sk https://rustchain.org/epoch | jq .| 字段 | 类型 | 含义 |
|---|---|---|
epoch |
integer | 当前 epoch |
slot |
integer | 当前 slot |
blocks_per_epoch |
integer | 每个 epoch 的 slot 数 |
epoch_pot |
number | 当前 epoch 待分配 RTC |
enrolled_miners |
integer | 已登记矿工数量 |
列出当前活跃或已登记矿工：
curl -sk https://rustchain.org/api/miners | jq .| 字段 | 类型 | 含义 |
|---|---|---|
miner |
string | 矿工 ID 或钱包地址 |
device_family |
string | CPU 家族 |
device_arch |
string | 具体架构 |
hardware_type |
string | 可读硬件描述 |
antiquity_multiplier |
number | 古董证明奖励倍率 |
last_attest |
integer | 最近一次 attestation 时间戳 |
使用 miner_id 查询 RTC 余额：
curl -sk "https://rustchain.org/wallet/balance?miner_id=YOUR_WALLET_OR_MINER_ID" | jq .| 字段 | 类型 | 含义 |
|---|---|---|
miner_id |
string | 钱包或矿工标识 |
amount_rtc |
number | RTC 可读余额 |
amount_i64 |
integer | micro-RTC 整数余额 |
查询钱包近期转账历史：
curl -sk "https://rustchain.org/wallet/history?miner_id=YOUR_WALLET_OR_MINER_ID&limit=10" | jq .| 参数 | 必填 | 含义 |
|---|---|---|
miner_id |
是* | 推荐的钱包或矿工标识参数 |
address |
是* | 兼容旧客户端的别名 |
limit |
否 | 最大返回数量，默认 50 |
miner_id 和 address 二选一即可。
浏览器查看交易、钱包和矿工：
https://rustchain.org/explorer/
可以搜索钱包地址、交易哈希或矿工 ID。
本文只覆盖公开只读查询和文档入口。不要在公开 issue、PR 或聊天中粘贴私钥、助记词、keystore、验证码或密码。钱包创建、提现、转账、跨链桥和交易所操作应由用户本人在可信环境中完成。