API 文档
协调器 v2 · 所有接口返回 JSON · 基础地址 https://libergrid.org
节点
POST/api/nodes/challenge注册前置
取一次性 nonce。入参 {nodeId},返回待签名 message(personal_sign)。
POST/api/nodes/register
注册/重注册。{nodeId, name, model, capabilities, wallet?, signature?}。带 wallet 时必须带 challenge 签名;不带钱包为兼容模式,credits 照记但需 /api/nodes/bind-wallet 后才能领取。
POST/api/nodes/heartbeat
{nodeId},保活,90 秒内有心跳视为在线。
POST/api/nodes/bind-wallet
补绑钱包,同样需要 challenge + 签名。
任务(worker 轮询)
POST/api/tasks/claim
{nodeId} → 返回最老排队任务;队列为空时自动下发金丝雀基准任务。约 15% 任务会冗余双派给两个节点做交叉验证。
POST/api/tasks/submit
{nodeId, taskId, answer, durationMs} → 服务端评分(关键词命中 + 延迟奖励),通过则按 reward × 质量分 × 声誉乘数 计入 credits 台账。
OpenAI 兼容推理(开发者)
POST/v1/chat/completions
头 Authorization: Bearer lg_sk_…。按 token 计费(USDT 余额),余额不足返回 402;未带 key 时每 IP 限流 30 次/分钟。响应为 OpenAI chat.completion 格式。
GET/v1/models
当前在线节点提供的模型列表。
开发者账户
POST/api/developers/register
{email} → 返回 lg_sk_ API key(仅显示一次)与 1 USDT 试用额度。
GET/api/billing/me
余额、单价与用量汇总(需 key)。
POST/api/billing/topup
{amount_usdt} → 创建 ClawPay 充值单,支付到账后自动入账。
网络状态与收益
GET/api/status
节点数、任务数、台账流水等全网概览。
GET/api/leaderboard
节点 credits 排行榜。
GET/api/nodes/:id/earnings
单节点:credits、台账明细、已结算可领取的 epoch 列表。
GET/api/epochs
当前 epoch(UTC 日期)与历史结算记录。
GET/api/epochs/:id/proof?nodeId=…
已结算 epoch 中某节点的 Merkle proof,用于链上
claim。领取入口:
/claim。
快速开始(worker)
# 1. 注册(带钱包领取收益)
POST /api/nodes/challenge {"nodeId":"my-node"}
# 用钱包私钥对返回的 message 做 personal_sign
POST /api/nodes/register {"nodeId":"my-node","wallet":"0x…","signature":"0x…","model":"qwen2.5:7b"}
# 2. 循环:心跳 + 领任务 + 提交
POST /api/tasks/claim {"nodeId":"my-node"}
POST /api/tasks/submit {"nodeId":"my-node","taskId":"…","answer":"…","durationMs":1200}
# 3. 每日结算后到 /claim 连接钱包领取 LGT