Skip
Voxtra
ENG中文

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

架构

三层架构,各在其位:

用户MetaMask / CoinbaseVERCEL · 前端Next.js 16 应用/explorer · /vs/[id]+ /api 路由RAILWAY · WORKERS预言机 · 创建者 · 理事会viem 私钥代理轮询、评估、质押、结算BSC 主网Voxtra.solERC-20 USDC 质押BNB gas · 链 56SUPABASE读索引缓存LLM 提供商Gemini · Anthropic链上 BSCUSDCBNB gasapprovex402facilitator
用户钱包 → Next.js 前端与 worker 代理 → BSC 主网上的 Voxtra.sol,以及 Supabase 索引与 LLM 提供商。
  • 前端(Vercel)。 Next.js App Router 与 serverless API。读取走 BSC RPC;用户写入通过 wagmi/viem 钱包签名(USDC 授权 + 合约调用)。
  • Workers(本地 / Railway)。 长驻 Node 进程:预言机、市场创建者、理事会角色。使用 viem 私钥签名 — 无托管钱包服务。
  • 数据(Supabase Postgres)。 可选读索引,加速竞技场与仪表盘。合约仍为真相来源;统计与声明详情可直接读链。

04

声明生命周期

01创建授权并质押 USDC(A 方)02挑战B 方授权并质押03等待截止期到达04读取预言机获取证据05评估LLM 返回裁决与置信度06结算链上原子化 USDC 支付创建者预言机
从创建到结算的六个步骤。第 04–06 步由预言机代理自动完成。

以下细节关乎信任:

  • 链上证据哈希。 存储 keccak256(原始证据)。任何人可重新获取 URL 并验证预言机所见内容。
  • 置信度是一等公民。 LLM 返回 0–100 分。UI 区分确定与有争议区间。
  • 模糊则退款。 DRAWUNRESOLVABLE 退还质押,而非强行选出错误胜方。
  • 仅预言机可结算。 resolveClaim 由部署时配置的预言机地址门禁。

05

代理

后台持续运行:预言机、市场创建者与理事会角色。每个代理钱包是普通 EVM 地址,持有 BNB(gas)与 USDC(质押),在 worker 环境中通过 viem 私钥签名。

轮询循环每 60 秒角色 A · 结算者state = ACTIVE 且已过截止获取证据 → LLM → resolveClaim()角色 B · 挑战者(可选)state = OPEN 且截止未到早期 LLM 读取 → 置信度 ≥ 80%Kelly sizing 质押(≤ 25% 资金)需 AUTO_CHALLENGE=1链上USDC 支付证据哈希已写入置信度已存储
轮询循环每分钟读取声明;已过期的 ACTIVE 声明进入结算,OPEN 声明可进入可选的 Kelly 自动挑战。

预言机代理

读取已过期的 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_URLSUPABASE_SERVICE_ROLE_KEY,然后在 Supabase SQL Editor 中一次性运行 supabase/schema.sql
交易所 / CEX提现 USDC选择 BSC 网络到达钱包可选PancakeSwap在 BSC 兑换 USDC或官方 BNB 跨链桥BSC 主网approve(Voxtra)USDC + BNB gas创建 / 挑战充值质押
常见路径:从交易所提现或跨链 USDC 到 BSC、在 PancakeSwap 兑换,或使用官方 BNB Chain 跨链桥 — 然后授权 Voxtra 进行质押。

07

x402 微支付

代理可通过 HTTP 402 以亚美分 USDC 购买付费 API。支付在 BSC 结算;账本持久化并在 /revenue 展示。

按请求付费(x402)

GET /api/premium/pricePOST /api/oracle 及理事会路由等端点可在响应前要求 USDC 微支付。本地 facilitator 验证并记录结算。
付款方 · 代理viem 签名私钥HTTP 402/api/premium/price报价 $0.001 USDCFACILITATORfacilitator验证 + 结算BSC 主网已结算亚美分 USDCSUPABASEx402_payments→ /revenue请求支付上链记录
HTTP 402 付费 API 调用在 BSC 上以 USDC 结算。收据存入 Supabase,并在 /revenue 实时展示。

理事会陪审团(可选)

结算时预言机可通过 x402(GET /api/council/vote)购买角色裁决、汇总投票,在 resolveClaim 前将共识写入 evidenceHash。未达法定人数则回退为预言机单独裁决。
01 · 触发截止到达02 · 读取预言机获取证据03 · 购买 N 个裁决 (x402)GET /api/council/vote$0.001 → 各角色钱包规则弃权 · 专家按类别法定人数 = 3 票决定性投票(默认)LLM 回退Gemini 429 时用 Groq (Llama)04 · 汇总7 – 2共识 → evidenceHash未达法定人数回退为预言机单独裁决05 · 链上resolveClaim()裁决 + evidenceHash→ 支付
截止时预言机可通过 x402 购买角色裁决、汇总共识、写入 evidenceHash,然后在 BSC 上调用 resolveClaim()。

订阅通行证

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)。
oddsModepool = 彩池,fixed = 创建者支持的固定倍数。
deadlineUTC Unix 时间戳。此后预言机可结算。
winnerSideCREATORCHALLENGERSDRAW(退款)或 UNRESOLVABLE(退款)。
evidenceHash从结算 URL 获取的原始字节的 keccak256
confidence0–100。LLM 对该裁决的自评把握度。

09

如何参与

  1. 在 BSC 上准备 USDC。 从交易所提现、在 PancakeSwap 兑换,或使用 BNB Chain 跨链桥。保留 BNB 作 gas。
  2. 连接钱包。 切换到 BSC 主网(链 56)。应用会在需要时提示 MetaMask / Rabby。
  3. 创建或挑战。 浏览 竞技场 或打开 /vs/create。授权 USDC 后至少质押 2 USDC。
  4. 等待。 截止后预言机自动结算 — 无需手动点击。
  5. 查看收据。 结算卡片显示裁决、说明、证据哈希与 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 查看。