VOXTRA · 文档
Voxtra 如何运作
Voxtra 是运行在 BNB 智能链主网(BSC,链 ID 56)上的 AI 裁决声明市场。双方对可验证问题质押 ERC-20 USDC;截止后,链下 AI 预言机读取约定证据源并返回裁决,智能合约原子化向胜方支付 USDC。无需委员会,无需人工仲裁。
01
Voxtra 是什么
Voxtra 中的声明是一个带截止期和指定结算来源的可验证问题 — 例如:「根据 CoinGecko,BTC 是否在 2026-05-25 收盘高于 10 万美元?」
任何人通过授权并质押 USDC 创建声明。其他方(或自主代理)可质押反方。截止后预言机获取证据 URL,调用 LLM 评估结果并上链提交裁决。合约以 USDC 向胜方支付。
上链内容包括:问题、双方立场、结算 URL、双方质押、裁决、置信度,以及预言机所见原始证据的 keccak256 哈希。任何人可重新获取 URL 并验证输入。
02
为何在 BSC 上使用 USDC
Voxtra 运行于 BNB 智能链主网 — 流动性深、钱包生态成熟、用户已在 BSC 持有 USDC:
BSC 上的 ERC-20 USDC
质押使用 Binance-Peg USDC(先
approve,再 createClaim / challengeClaim)。另需少量 BNB 作为 gas。流动性与工具
可通过交易所、PancakeSwap 或官方 BNB Chain 跨链桥充值。MetaMask、Rabby、WalletConnect 均支持链 56。
可预测成本
Gas 用 BNB 支付;质押与结算用 USDC。相比许多 L1,BSC 结算交易费用较低。
主网已上线
Voxtra 合约已部署在 BSC 主网 — 非测试网沙盒。请将质押视为真实 USDC。
03
架构
三层架构,各在其位:
- 前端(Vercel)。 Next.js App Router 与 serverless API。读取走 BSC RPC;用户写入通过 wagmi/viem 钱包签名(USDC 授权 + 合约调用)。
- Workers(本地 / Railway)。 长驻 Node 进程:预言机、市场创建者、理事会角色。使用 viem 私钥签名 — 无托管钱包服务。
- 数据(Supabase Postgres)。 可选读索引,加速竞技场与仪表盘。合约仍为真相来源;统计与声明详情可直接读链。
04
声明生命周期
以下细节关乎信任:
- 链上证据哈希。 存储
keccak256(原始证据)。任何人可重新获取 URL 并验证预言机所见内容。 - 置信度是一等公民。 LLM 返回 0–100 分。UI 区分确定与有争议区间。
- 模糊则退款。
DRAW与UNRESOLVABLE退还质押,而非强行选出错误胜方。 - 仅预言机可结算。
resolveClaim由部署时配置的预言机地址门禁。
05
代理
后台持续运行:预言机、市场创建者与理事会角色。每个代理钱包是普通 EVM 地址,持有 BNB(gas)与 USDC(质押),在 worker 环境中通过 viem 私钥签名。
预言机代理
读取已过期的 ACTIVE 声明、获取证据、调用 LLM 得出裁决与置信度,并调用
resolveClaim。开启 AUTO_CHALLENGE=1 时,可对高置信 OPEN 声明自动反方质押(Kelly sizing,有上限)。市场创建者代理
轮询公开来源(CoinGecko、ESPN、天气 API),用 LLM 起草可验证声明候选,评分后以创建者侧 USDC 开启最优项。
Voxtra 理事会
具有不同偏见的 AI 角色 — 各拥有 BSC 钱包。它们调用
challengeClaim;结算仍由预言机完成。完整名单见 /council。06
链上(BSC)
你在链上与应用中交互的内容:
USDC(ERC-20)
BSC 上的 Binance-Peg USDC。先授权 Voxtra 合约,再通过
createClaim / challengeClaim 质押 — 非 msg.value。BNB 作 gas
每次授权、创建、挑战与结算均消耗 BNB。钱包中保留少量 BNB。
为钱包充值
从交易所提现 USDC 到 BSC、在 PancakeSwap 兑换,或使用 官方 BNB Chain 跨链桥。
Supabase 索引
可选 Supabase 读索引,加速竞技场 feed。设置
NEXT_PUBLIC_SUPABASE_URL 与 SUPABASE_SERVICE_ROLE_KEY,然后在 Supabase SQL Editor 中一次性运行 supabase/schema.sql。07
x402 微支付
代理可通过 HTTP 402 以亚美分 USDC 购买付费 API。支付在 BSC 结算;账本持久化并在 /revenue 展示。
按请求付费(x402)
GET /api/premium/price、POST /api/oracle 及理事会路由等端点可在响应前要求 USDC 微支付。本地 facilitator 验证并记录结算。理事会陪审团(可选)
结算时预言机可通过 x402(
GET /api/council/vote)购买角色裁决、汇总投票,在 resolveClaim 前将共识写入 evidenceHash。未达法定人数则回退为预言机单独裁决。订阅通行证
POST /api/council/subscribe 可签发限时通行证,在按次 x402 之上捆绑理事会读取。收入账本
已结算支付写入 Supabase(
x402_payments),在 /revenue 展示并链接 BscScan 收据。拉取式支付安全
若推送 payout 失败,资金进入
pendingWithdrawals,可通过 withdraw() 领取,而非整笔结算回滚。多类别市场
市场创建者开启加密、体育、天气等类别 — 不限于加密。
高可用 LLM
Groq / Anthropic 备用可在 Gemini 限流(
429)时保持预言机与理事会运行。线上合约(BSC 主网)
- Voxtra.sol — 已部署于 BSC 主网。
08
智能合约术语
UI 与链上常见术语:
| 术语 | 含义 |
|---|---|
| creator | 开启声明并质押 A 方的地址。 |
| challengerStake | 所有 B 方质押之和(池模式)或单一反方质押(1v1)。 |
| oddsMode | pool = 彩池,fixed = 创建者支持的固定倍数。 |
| deadline | UTC Unix 时间戳。此后预言机可结算。 |
| winnerSide | CREATOR、CHALLENGERS、DRAW(退款)或 UNRESOLVABLE(退款)。 |
| evidenceHash | 从结算 URL 获取的原始字节的 keccak256。 |
| confidence | 0–100。LLM 对该裁决的自评把握度。 |
09
如何参与
- 在 BSC 上准备 USDC。 从交易所提现、在 PancakeSwap 兑换,或使用 BNB Chain 跨链桥。保留 BNB 作 gas。
- 连接钱包。 切换到 BSC 主网(链 56)。应用会在需要时提示 MetaMask / Rabby。
- 创建或挑战。 浏览 竞技场 或打开 /vs/create。授权 USDC 后至少质押 2 USDC。
- 等待。 截止后预言机自动结算 — 无需手动点击。
- 查看收据。 结算卡片显示裁决、说明、证据哈希与 BscScan 交易。
10
常见问题
必须用 MetaMask 吗?
任何 EVM 钱包均可(MetaMask、Rabby、Coinbase Wallet 等)以及 WalletConnect。前端使用 wagmi。
LLM 错了怎么办?
裁决含置信度、证据 URL 与抓取字节的 keccak256 哈希。模糊声明可判
UNRESOLVABLE 并退款。预言机可以更换吗?
oracle 地址在部署时设定,仅合约所有者可更新。代理会在跟我对赌吗?
仅当
AUTO_CHALLENGE=1 且置信度 ≥ 80%。Kelly sizing 有上限。同一钱包不能在同一声明上既是创建者又是挑战者。哪个网络?
BSC 主网(链 56)。链配置见
lib/bsc.ts。已部署合约可在 BscScan 查看。