AIB Protocol 技术规范

1. 代币经济学

当前流通量 ≈ PoW 窗口铸造量(h1–10,000 × 747 ≈ 747 万 AIB)+ PoS 时代零增发。任何"转 1000 万 AIB"的请求需先核对流通量。

2. 共识机制:PoW 引导 → 纯 PoS

2.1 两阶段设计(RFC-003 Bootstrap Window)

2.2 VRF 出块抽签

// 出块者选择 (每高度每 attempt)
msg     = "AIB-VRF-v1" || seed || height
output  = SHA512(pubkey || msg || ed25519.Sign(msg))
ticket  = SHA256("AIB-VRF-v1" || seed || height || output)
命中条件: ticket < stake × 2²⁵⁶ / totalStake   // 质押占比 = 中签概率
// slot 空转时按 attempt 轮转重抽 (v0.11.32+,防卡死)

验证者被抽中后签名出块(ed25519)。多 attempt 轮转解决离线验证者导致的链停滞(P27)。

2.3 终局性 Finality(v0.11.33+)

gossip 投票机制:验证者对近期块投票,2/3 质押权重确认后块标记 finalized,finalized 块禁止回滚。非侵入式设计(不改块头格式)。

2.4 同步协议

• Headers-first 同步(v0.11.33+):先拉块头链验证连续性,再批量拉块体(每批 500 块)
• 活性判定(v0.11.36+):任何收到消息(block/inv/headers/tx)都算对端活着,批量传输期间不误杀
• 版本强制(v0.11.34+):低于 v0.11.32 的节点 GETBLOCKS 被拒 + 10 分钟断连,拒绝消息附带升级指引

3. 质押 Staking(灵活流动质押,v0.11.38+)

一句话:质押进去 ~1-2 分钟开挖,拿出来 ~2 分钟到账,无锁定期。权重 = 你的质押 / 全网总质押,当前全网总质押见 GET /v1/stake/validators。

4. 地址与签名

签名体系: ed25519(确定性签名,无随机数陷阱,验签快)。AIB 是 PoS 链,每个区块的提议与投票、每个 validator 的握手都在签名/验签,ed25519 是这一场景的工程最优解。

4.1 地址命名方案(权威定义)

AIB 地址 = ed25519 公钥原样 32 字节(非哈希型地址)。同一学派:Solana / Cardano / Stellar / Algorand / Nano。链上与 API 的规范格式(canonical)是 64 位 hex;人机界面推荐使用 AIB1… bech32m 显示格式(带校验和,防手滑,不可与 EVM 0x 地址混淆)。

换算关系:AIB1 显示地址 ↔ 64位hex 是同一 32 字节的两种拼写,任何钱包/Explorer/API 应同时接受(v0.11.42 起转账 API 已双格式兼容)。

4.2 三大地址体系对比(为什么选 ed25519 原样公钥)

结论:PoS 链的签名密度是 PoW 链的百倍量级,确定性与验签吞吐是刚需 → ed25519 裸公钥 + bech32m 显示层(校验和+前缀)兼得安全与可用性。显示层于 v0.11.42 上线,链上格式零改动、零分叉。

4.3 示例地址(三格式对照)

4.4 bech32m 技术细节

编码:BIP-350 bech32m(校验常数 0x2bc830a3,非 bech32 的 1);HRP=aib;5bit 分组;6 字符校验和。整串必须全大写或全小写,混合即非法。历史上 AIB 早期实现的校验和计算有误(缺 6 零填充+用错常数),v0.11.42 修复为标准 BIP-350 并通过独立参考实现交叉验证。

5. HTTP API 全集(节点 :8080)

5.1 核心

5.2 余额与钱包

5.3 质押

5.4 其他子系统

支付通道 /v1/channel/*、AI 推理 /v1/ai/*、提案 /v1/proposals、分发 /v1/distribution、迁移 /api/migration/*、发布 /v1/release/* — 详见 GitHub docs/rfc/。

6. 节点与网络

6.1 安装(一键)

# 普通节点
curl -sSfL https://aib.one/install.sh | bash
# PoS 验证者(挖矿) — 参数形式,免疫管道环境变量陷阱
curl -fsSL https://aib.one/install.sh | bash -s -- validator

6.2 网络端口

6.3 版本策略

• 最低兼容版本 v0.11.32:低于此版本 GETBLOCKS 被拒、10 分钟后被断连
• 落后 tip >120 块的节点在 Explorer 标 ⚠ OUTDATED(健康节点排前)
• v0.11.36+ 必须双向升级(断连风暴修复涉及两端)

7. 第三方集成指南

7.1 应用验证网关(AIB Auth Gateway)

第三方应用验证"用户是否持有 AIB 资产"(签名 + 链上实时查询,不上链、不碰用户币):

BASE = https://aib.one/auth   # Auth Gateway(注: CF 对 /auth/* 路径当前返回 404,规则清理前请向项目方索取直连端点)

① 注册应用:  POST /v1/apps  {"name":"myapp","min_balance_aib":1000,"min_stake_aib":5000}
② 拿挑战:    GET  /v1/auth/challenge?app_key=xxx        → nonce(5分钟有效)
③ 用户签名:  ed25519.Sign(nonce, 用户私钥)
④ 验证:      POST /v1/auth/verify {"challenge","signature","pubkey","address"}
              → 通过发放 session token,按链上余额/质押分层(basic/premium)
⑤ 校验 token: POST /v1/check {"token"}

7.2 做市 / 交易机器人接入

• 数据:轮询 /v1/block/latest + /v1/mempool(无 WebSocket,轮询间隔建议 ≥2s)
• 转账:/v1/wallet/send(注意 to_address 必须 64 位 hex 无 0x;amount_aib 用字符串)
• 钱包:MM 专用钱包用 /v1/wallet/create 生成,私钥只显示一次必须保存
• gas:手续费自动计算,也可 fee 字段指定(sats)

7.3 常见坑(实measured)

• 地址抄了 EVM 0x… 格式 → Invalid to address format(AIB 是 64 位 hex 无 0x)
• amount 传数字而非字符串 → Invalid JSON body
• wallet/send 用 amount_aib 字段需要 v0.11.40+;旧版本只认 raw sats 的 amount
• /v1/wallet/info 的 balance_aib 含已质押;查流动余额用 /v1/stake/info/{addr}
• 同一出口 IP 多节点完全正常(peer 表按 nodeID 不按 IP)

8. 错误码参考