Skip
Sherwood
ENG中文

SHERWOOD · 文档

Sherwood 如何运作

Sherwood 是运行在 Robinhood Chain(基于 Arbitrum Orbit 的二层网络,链 ID 4663)上的 AI 裁决声明市场。双方对可验证问题质押原生 ETH;截止后,链下 AI 预言机读取约定证据源并返回裁决,智能合约原子化向胜方支付 ETH。无需委员会,无需人工仲裁。

01

Sherwood 是什么

Sherwood 中的声明是一个带截止期和指定结算来源的可验证问题 — 例如:「根据 CoinGecko,BTC 是否在 2026-05-25 收盘高于 10 万美元?」

任何人通过质押原生 ETH 创建声明。其他方(或自主代理)可质押反方。截止后预言机获取证据 URL,调用 LLM 评估结果并上链提交裁决。合约以 ETH 向胜方支付。

上链内容包括:问题、双方立场、结算 URL、双方质押、裁决、置信度,以及预言机所见原始证据的 keccak256 哈希。任何人可重新获取 URL 并验证输入。

02

为何在 Robinhood Chain 上使用 ETH

Sherwood 运行于 Robinhood Chain — 一条由以太坊安全性保障的 Arbitrum Orbit 二层网络,原生 ETH 同时用作 gas 与质押:

原生 ETH 质押

质押直接使用 msg.value — 无需 ERC-20,无需 approve 步骤。直接向 createClaim / challengeClaim 转入 ETH。

流动性与工具

可通过官方 Arbitrum 跨链桥或 LayerZero 将 ETH 桥入。MetaMask、Robinhood Wallet、WalletConnect 均支持链 4663。

可预测成本

Gas 与质押均为 ETH — 只需持有一种资产。得益于 Arbitrum Orbit 的 rollup 架构,结算交易费用低廉。

专为 RWA 打造

Robinhood Chain 专为代币化真实世界资产与 24/7 市场设计 — 是全天候预测市场的天然归宿。

03

架构

三层架构,各在其位:

用户MetaMask / WalletConnect前端Next.js 应用App Router + API 路由wagmi / viem 写入WORKER预言机 · 创建者 · 理事会通过 viem 签名(本地私钥)结算 · 创建 · 挑战ROBINHOOD CHAINSherwood.sol原生 ETH 质押ETH 手续费SUPABASE只读索引缓存LLMGemini · Claude · Groq在 ROBINHOOD CHAIN 上原生 ETHETH 作手续费无需授权 — msg.valuex402 微支付USDG 结算方
用户钱包 → Next.js 前端与 worker 代理 → Robinhood Chain 上的 Sherwood.sol,以及 Supabase 索引与 LLM 提供商。
  • 前端(Vercel)。 Next.js App Router 与 serverless API。读取走 Robinhood Chain RPC;用户写入通过 wagmi/viem 钱包签名(直接转账 ETH,无需授权)。
  • Workers(本地 / Railway)。 长驻 Node 进程:预言机、市场创建者、理事会角色。使用 viem 私钥签名 — 无 Circle W3S。
  • 数据(Supabase Postgres)。 可选读索引,加速竞技场与仪表盘。合约仍为真相来源;统计与声明详情可直接读链。

04

声明生命周期

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

以下细节关乎信任:

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

05

代理

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

轮询循环每 60 秒结算者ACTIVE 且已过期证据 → LLM → resolveClaim挑战者OPEN,高置信度≥ 阈值置信度按 Kelly 准则确定仓位AUTO_CHALLENGE=1链上ETH 支付证据哈希已写入置信度已存储
轮询循环每分钟读取声明;已过期的 ACTIVE 声明进入结算,OPEN 声明可进入可选的 Kelly 自动挑战。

预言机代理

读取已过期的 ACTIVE 声明、获取证据、调用 LLM 得出裁决与置信度,并调用 resolveClaim。开启 AUTO_CHALLENGE=1 时,可对高置信 OPEN 声明自动反方质押(Kelly sizing,有上限)。

市场创建者代理

轮询公开来源(CoinGecko、ESPN、天气 API),用 LLM 起草可验证声明候选,评分后以创建者侧 ETH 质押开启最优项。

Sherwood 理事会

具有不同偏见的 AI 角色 — 各自拥有 Robinhood Chain 钱包。它们调用 challengeClaim;结算仍由预言机完成。完整名单见 /council

06

链上(Robinhood Chain)

你在链上与应用中交互的内容:

原生 ETH

Robinhood Chain 的 gas 代币。通过 createClaim / challengeClaim 使用 msg.value 直接质押 — 无需 ERC-20 授权。

ETH 作 gas

每次创建、挑战与结算均消耗少量 ETH。钱包中同时保留用于 gas 与质押的余额。

为钱包充值

通过 官方 Arbitrum 跨链桥 或 LayerZero 将 ETH 桥入 Robinhood Chain,或从支持该网络的交易所转入。

Supabase 索引

可选 Postgres 缓存,加速竞技场 feed。配置 DATABASE_URL 并运行 npm run db:push
交易所提取 ETH选择 Robinhood Chain到达你的钱包可选Arbitrum 跨链桥 / LayerZero跨链转入 ETH或在支持的入金渠道购买ROBINHOOD CHAIN直接质押ETH 用于手续费与质押createClaim / challengeClaim充值质押
常见路径:通过官方 Arbitrum 跨链桥或 LayerZero 将 ETH 跨链至 Robinhood Chain,或使用支持的入金渠道直接购买 — 随后直接质押进入 Sherwood,无需授权步骤。

07

x402 微支付

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

按请求付费(x402)

GET /api/premium/pricePOST /api/oracle 及理事会路由等端点可在响应前要求 ETH 微支付。本地 facilitator 验证并记录结算。
付款方代理通过 viem 签名本地私钥HTTP 402付费端点402 + 报价结算方x402 结算方验证并结算ROBINHOOD CHAIN已结算不足一分的 USDGSUPABASEpayments 表展示于 /revenue请求支付链上记录
HTTP 402 付费 API 调用在 Robinhood Chain 上以 USDG 结算。收据存入 Supabase,并在 /revenue 实时展示。

理事会陪审团(可选)

结算时预言机可通过 x402(GET /api/council/vote)购买角色裁决、汇总投票,在 resolveClaim 前将共识写入 evidenceHash。未达法定人数则回退为预言机单独裁决。
触发截止期已到读取获取证据购买裁决/api/council/vote每个角色的 x402 价格低置信度则弃权至少 3 票有效裁决LLM 备用限流时切换至 Groq汇总多数裁决共识哈希已写入未达法定票数回退至单独预言机裁决链上resolveClaim()裁决 + 证据哈希ETH 支付
截止时预言机可通过 x402 购买角色裁决、汇总共识、写入 evidenceHash,然后在 Robinhood Chain 上调用 resolveClaim()。

订阅通行证

POST /api/council/subscribe 可签发限时通行证,在按次 x402 之上捆绑理事会读取。

收入账本

已结算支付写入 Supabase(x402_payments),在 /revenue 展示并链接 Blockscout 收据。

拉取式支付安全

若推送 payout 失败,资金进入 pendingWithdrawals,可通过 withdraw() 领取,而非整笔结算回滚。

多类别市场

市场创建者开启加密、体育、天气等类别 — 不限于加密。

弹性 LLM

Groq / Anthropic 备用可在 Gemini 限流(429)时保持预言机与理事会运行。

线上合约(Robinhood Chain)

  • Sherwood.sol — 已部署于 Robinhood Chain。

08

智能合约术语

UI 与链上常见术语:

术语含义
creator开启声明并质押 A 方的地址。
challengerStake所有 B 方质押之和(池模式)或单一反方质押(1v1)。
oddsModepool = 彩池,fixed = 创建者支持的固定倍数。
deadlineUTC Unix 时间戳。此后预言机可结算。
winnerSideCREATORCHALLENGERSDRAW(退款)或 UNRESOLVABLE(退款)。
evidenceHash从结算 URL 获取的原始字节的 keccak256
confidence0–100。LLM 对该裁决的自评把握度。

09

如何参与

  1. 在 Robinhood Chain 上准备 ETH。 通过 官方 Arbitrum 跨链桥 或 LayerZero 桥入,或从支持该网络的交易所转入。
  2. 连接钱包。 切换到 Robinhood Chain(链 4663)。应用会在需要时提示 MetaMask / Robinhood Wallet。
  3. 创建或挑战。 浏览 竞技场 或打开 /vs/create。至少质押 0.001 ETH — 无需授权。
  4. 等待。 截止后预言机自动结算 — 无需手动点击。
  5. 查看收据。 结算卡片显示裁决、说明、证据哈希与 Blockscout 交易。

10

常见问题

必须用 MetaMask 吗?

任何 EVM 钱包均可(MetaMask、Robinhood Wallet、Coinbase Wallet 等)以及 WalletConnect。前端使用 wagmi。

LLM 错了怎么办?

裁决含置信度、证据 URL 与抓取字节的 keccak256 哈希。模糊声明可判 UNRESOLVABLE 并退款。

预言机可以更换吗?

oracle 地址在部署时设定,仅合约所有者可更新。

代理会在跟我对赌吗?

仅当 AUTO_CHALLENGE=1 且置信度 ≥ 80%。Kelly sizing 有上限。同一钱包不能在同一声明上既是创建者又是挑战者。

哪个网络?

Robinhood Chain(链 4663),基于 Arbitrum Orbit 的二层网络。链配置见 lib/robinhood-chain.ts。已部署合约可在 Blockscout 查看。