Predge 裁定智能体已付款的任务是否已交付,并附上任何人都能核验的签名记录。
Predge 是 AI 智能体支付的信任与争议层。支付通道负责转移资金;Predge 回答它们留下的问题:已付款的任务交付了吗?我们给出用 Predge 公开的 ed25519 密钥签名、可离线验证的裁定,并在工作从未送达时给出退款建议。v2 合约已在 Arc 和 Base 上线(地址见链;状态见 Trust);退款只是建议,由商户执行,签名裁决才是产品本身。我们不运营支付通道。目前已上线:Base、Solana、Arc、Monad 和 Algorand 上的 x402 支付;设计与通道无关。预测市场是第一个垂直领域:同样的签名记录用于跟踪 Polymarket 的结算风险,我们分析了 2026 年 1 月 1 日至 10 月 2 日的 3,005 起 UMA 争议。
裁决
当前:9 条 EVM 链上的 v2.1 合约
v2.1 于 2026 年 10 月 23 日部署在 Arc(5042)和 Base(8453)上,并于 2026 年 10 月 26 日部署在 Arbitrum、Avalanche、BNB Chain、Celo、Optimism、Sonic 和 Unichain 上(链列表和链接见链)。每条链上的六个地址相同,均已在 Sourcify 上验证(完全匹配)。它们修复了我们自查中发现的 H-01 至 H-03 和 M-01 至 M-05。
| 合约 | 地址(全部 9 条 v2.1 链) | 链接 |
|---|---|---|
| PredgeAgentValidatorV2 | 0xE4CFdE5dbD9afD518b9c59136939607505bF643D | Sourcify · Arc · Base |
| AgentJobV2 | 0x5C673c6aBF3c60C3F6Ce3f1509f5d99C08F8B13F | Sourcify · Arc · Base |
| PredgeValidatorBondV2 | 0x97E960Fe3D7759af8f51A95319859E60Df554329 | Sourcify · Arc · Base |
| PredgeSettlementV2 | 0x6fac55c5187A9cdb519F77163C7e3fD9E87F6f24 | Sourcify · Arc · Base |
| MockRefundProtocolV2 (demo refund protocol) | 0x50041FdAb10f8f56E24FA9CA806f082CcAeb05E9 | Sourcify · Arc · Base |
| PredgeRefundArbiterV2 | 0xf404F908cb1ba47C01AB8526B725aAA940557eA9 | Sourcify · Arc · Base |
所有者:0x9084f5000E07C7133D6dA5eE4f271AB6D1821144,一个临时的单一 EOA。计划转移到 Safe 2-of-3 多签(Ownable2Step),目标日期为 2026 年 10 月 23 日。操作员(热运维密钥,所有者可轮换):0x8ffFB76c4329DDC8ee4a859DDF55AB48ba25e292。保证金是每条链原生代币约 $5 的最低额(例如 Arc 上 5 USDC,Base 上 0.002 ETH),不是任务价值的百分比。它们不是担保。外部审计前扫描(Olympix)已完成:修复了 10 项发现,7 项按设计接受;修复已包含在 v2.1 中。完整审计仍在计划中。凭证:predgeAI/predge-deploy。
旧版 v1(已知问题,不持有资金)
本节其余部分描述 v1 合约原本的设计运作方式。这是历史,不是保证。
Predge 位于退款协议的仲裁席位上(形态类似 Circle 的 Refund Protocol 和 x402r 退款扩展)。合约 PredgeRefundArbiter 的设计目的是限制这个席位能做的事。
- 双方提交证据。付款方或商户用各自的密钥把
sha256(evidence)登记到链上。 - Predge 引用证据作出裁定。裁定在任何资金转移之前,记录证据哈希和方向(退款或放款)。
rule()只接受已登记到链上的证据。 - 1 天质疑窗口。v1 合约定义了一个 86,400 秒的窗口,期间可以调用
challenge。当前的合约不持有资金。 - 预期的检查,而非有效的保障。
challenge的设计是比较 Predge 引用的哈希与当事方登记的哈希。我们 2026 年 10 月 20 日的审查发现,裁定成功后质疑永远无法成功(发现 H-03),因此请不要依赖它。v2 合约旨在解决这个问题。
Arc 主网上的旧版 v1(chainId 5042)
| 合约 | 地址 |
|---|---|
| PredgeRefundArbiter | 0xA9c39e9aEd452Ee638a10aC10f6A6288C4Ca6E89 |
| MockRefundProtocol(演示目标) | 0xf6659f725B3F790287a75f7A83C373E2a3D908aa |
| PredgeValidatorBond v2.1 | 0xfeE8b89eb8aa2499F7025Cd9aaEB13a4b046d0d1 |
| AgentJob (ERC-8183) | 0x8B9589B8F5857dDe080Ac68e8B370c3bA5E74495 |
| PredgeAgentValidator (ERC-8004) | 0xbe601d486D821450F9248ab91891736B1a09699F |
链上读取:该仲裁合约(0xA9c3…6E89)的 challengeWindow = 86400 秒,minBond = 0.05 USDC(Arc 的原生 gas 代币);保证金 disputeWindow = 86400 秒。0.05 USDC 的下限仅适用于这个较早的 Arc 仲裁合约。
主网上的完整运行
在较早的 Arc 仲裁合约上的一次演示运行:付款方登记证据,仲裁合约引用该记录作出裁定,并针对演示退款协议执行了退款:fileEvidence · rule。第二次裁定引用了未登记的证据,并针对它发起了一次质疑(challenge)。这是我们 10 月 20 日审查之前的历史,不是保证;当前的合约不持有资金。
该次运行(2026 年 9 月 18 日)使用的是上一版仲裁合约 0xA1533757…5Ad967。上方在用的仲裁合约增加了一条规则:证据必须先登记到链上才能被引用。源代码和凭证:predgeAI/predge-arc。
链:9 条链上的 v2.1,16 条主网上的旧版 v1
当前:下方标有 v2.1 的 9 条链上部署了 v2.1,地址见上方的 v2.1 表。旧版 v1(已知问题,不持有资金):一套合约,每个合约一个地址,下方每条链上都有。源代码已在 Sourcify 上验证(完全匹配)。
| 链 | chainId | 合约 | 链接 |
|---|---|---|---|
| Ethereum | 1 | legacy v1 | v1 arbiter · v1 source |
| Base | 8453 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| BNB Chain | 56 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Arbitrum One | 42161 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Optimism | 10 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Polygon | 137 | legacy v1 | v1 arbiter · v1 source |
| Avalanche C-Chain | 43114 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Celo | 42220 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Gnosis | 100 | legacy v1 | v1 arbiter · v1 source |
| Linea | 59144 | legacy v1 | v1 arbiter · v1 source |
| Unichain | 130 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Sonic | 146 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Arc | 5042 | v2.1 + legacy v1 | v2.1 bond · v2.1 source · v1 arbiter · v1 source |
| Monad | 143 | legacy v1 | v1 arbiter · v1 source |
| Mantle | 5000 | legacy v1 | v1 arbiter · v1 source |
| Robinhood Chain | 4663 | legacy v1 | v1 arbiter · v1 source |
| 合约 | 旧版 v1 地址(全部 16 条链) |
|---|---|
| PredgeRefundArbiter | 0xb2972B4944Eec83946EB7B23D572AbE04F46E22c |
| PredgeValidatorBond v2.1 | 0x800B5596a8540e752dE8f8a8AF99E927d139A643 |
| PredgeAgentValidator (ERC-8004) | 0x925767fdce6C819F027f55CC50464e3bCdfD2671 |
| AgentJob (ERC-8183) | 0xcBaB4a9FA4d756b4C5e2a18F055d2E0132CE7D1D |
| PredgeSettlement | 0x47BE8a7d461De505723a0Ac1d74982e53f8E412b |
| MockRefundProtocol (demo target) | 0xcaC30945CDF0F963f38972d939e111B87b80Cf79 |
链上读取,16 条链上均相同:仲裁合约的 challengeWindow = 86400 秒,minBond = 1015 wei,即该链原生代币的 0.001(Ethereum 和 ETH L2 上为 0.001 ETH,其他链上为 0.001 BNB、POL、AVAX、CELO、xDAI、S、MNT 或 MON;Arc 的原生代币是 USDC,所以是 0.001 USDC)。保证金以原生代币缴纳。
于 2026 年 10 月 18 日从 0x5d016C1B4d7A42eB7c982da1Ae7fFdB958CFCAe9 部署。各链凭证:predgeAI/predge-deploy。上方的 Arc 表是较早的 Arc 部署和完整的主网运行;两者都继续在线。需要其他 EVM 链?告诉我们:一天内即可部署。
Zcash:屏蔽的 2-of-3 托管(主网)
Zcash · 主网。Predge 在 Zcash 上运行屏蔽的 2-of-3 FROST 托管。买方、卖方和中立仲裁方(Predge)各持有一份密钥分片,其中任意两方即可付款。仲裁方只会共同签署其 Ed25519 签名裁决所指定的那笔确切付款;它无法单独转移资金。资金存放在 Zcash 的屏蔽 Ironwood 池中,在链上,一笔付款看起来就像普通的屏蔽交易。
状态:三条路径(放款、争议退款、争议付款),以及仲裁方拒绝错误付款,于 2026 年 10 月 31 日在 Zcash 公共测试网上完成了端到端运行。2026 年 11 月 13 日,争议退款路径用真实的 ZEC 在 Zcash 主网上运行:向托管存入 0.02 ZEC,仲裁方拒绝向其裁决未指定的卖方付款,然后买方和仲裁方共同签署了退款(主网付款交易 50407885adf3b688f30d3a2e8d020297f1adb775dc9b5e2be9e6d50c61fcd5f2)。测试网退款交易示例:2bc943804f1b30eb256a3f33b79a60677621c01e4cb41320ba7a32ee70c1f711。
代码:predgeAI/zcash-escrow。Predge 还向 OpenPGP-Wallet/frost-zec 贡献篡改测试用例:共同签名方必须拒绝向错误地址付款的 PCZT。
请求裁决(API)
你的智能体为一次服务调用付了款。把承诺的内容、实际收到的内容和已付款项发给 Predge,即可拿到一份签名裁决:delivered、not_delivered 或 inconclusive。检查是确定性的(没有模型,Predge 也没有人工介入):HTTP 状态、content type、非空正文、有效 JSON、你的 JSON Schema、必填字段、预期的 sha256 和延迟上限。Predge 并不观察交付过程,因此裁决的真实程度取决于你发送的证据。
POST https://api.predge.io/v1/verdicts $0.05, paid call under $1
POST https://api.predge.io/v1/verdicts/large $0.50, paid call of $1 or more
GET https://api.predge.io/v1/verdicts/:id free, the stored signed verdict
GET https://api.predge.io/v1/verdicts/report free with a key, signed monthly report通过 x402 支付(Base、Solana、Algorand、Arc 或 Monad 上的 USDC,无需密钥),或在 x-predge-key 中发送试点密钥:30 天试点期内免费,计入该密钥的每日配额。发送到错误价格档位的调用会收到 400 wrong_tier,且不收费。
curl https://api.predge.io/v1/verdicts \
-H "content-type: application/json" \
-H "x-predge-key: $PREDGE_KEY" \
-d '{
"job": {
"endpoint": "https://api.example.com/v1/report",
"expected_content_type": "application/json",
"json_schema": {"type": "object", "required": ["rows"]},
"required_fields": ["rows"],
"max_latency_ms": 5000
},
"delivery": {
"status": 502,
"headers": {"content-type": "text/html"},
"body": "<html>bad gateway</html>",
"latency_ms": 420
},
"payment": {
"amount_usd": 0.25, "network": "eip155:8453", "tx_hash": "0x...",
"payer": "0xBuyer...", "payee": "0xMerchant..."
},
"buyer_id": "agent-42", "merchant_id": "example-api",
"agent": {"id": "eip155:8453:0x8004...:123", "version": "2.1.0",
"operator": "Acme Payments, Inc.", "authorization_ref": "mandate/weekly-cap"}
}'了解你的智能体(可选)。添加 agent(买方智能体)和 provider_agent(商户的智能体),每个都带有 id(ERC-8004 智能体 id 或任何稳定的字符串)、version、operator(负责的公司或钱包)以及可选的 authorization_ref(授权或策略 id)。这些由你自行声明,Predge 不做验证,但它们会被签入裁决、存储并返回(未提供时为 null),因此声明之后无法被更改。不带这些字段的请求照常工作。
响应(已精简):
{
"id": "vrd_Zm9vYmFyYmF6cXV4MTIzNDU2",
"verdict": "not_delivered",
"reason_codes": ["status_not_2xx", "content_type_mismatch", "schema_violation"],
"checks": [{"id": "status_2xx", "status": "fail", "detail": "HTTP 502, not a 2xx success"}, ...],
"refund_recommended": true,
"refund_amount_usd": "0.250000",
"refund": {
"recommended": true, "amount_usd": "0.250000",
"from": "0xMerchant...", "to": "0xBuyer...",
"status": "recommendation_only", "onchain": null,
"instructions": "The merchant (payee) should return this amount to the buyer (payer) ..."
},
"verify_url": "https://api.predge.io/v1/verdicts/vrd_...",
"attestation": {"kind": "verdict", "algorithm": "ed25519", "canonical": "...", "signature": "..."}
}在 TypeScript 中,使用试点密钥:
const res = await fetch("https://api.predge.io/v1/verdicts", {
method: "POST",
headers: { "content-type": "application/json", "x-predge-key": process.env.PREDGE_KEY! },
body: JSON.stringify({ job, delivery, payment }),
});
const verdict = await res.json();
if (verdict.refund_recommended) notifyMerchant(verdict.refund, verdict.verify_url);裁决使用与所有 Predge 记录相同的 ed25519 密钥签名(attestation 字段,以及覆盖整个正文的 x-predge-body-signature 头);请按验证中的说明离线核验。持有 id 的人都可以通过 GET /v1/verdicts/:id 免费重新读取;id 无法被猜到。
月度争议处理报告
面向风控或合规团队:GET /v1/verdicts/report?month=2026-10,密钥放在 x-predge-key 中(可选 merchant_id、最大 1000 的 limit、cursor)。免费,并计为该密钥配额的一次调用。一个密钥只能看到它自己请求过的裁决;没有密钥则返回 401。
curl "https://api.predge.io/v1/verdicts/report?month=2026-10" -H "x-predge-key: $PREDGE_KEY"报告包含各项计数(总数、已交付、未交付、无定论)、退款建议(数量和 USD 总额)、主要原因代码、从交付证据时间戳到裁决的中位时间和 p95 时间、带结果和 verify_url 的裁决 id(分页)、一份可复现的样本,以及一条 methodology 说明。它与裁决一样经过签名(attestation 和 x-predge-body-signature),因此可按验证离线核验。它统计的是基于请求方所提供证据的签名记录,并不是对交付的审计。
refund 块说明谁应该向谁支付多少,由商户通过链下抵扣、退款或向付款方转账来执行。签名裁决才是产品;裁决响应中的 onchain 为 null。v2 合约已在 Arc 和 Base 上线(地址见链)。定价
结算风险
一次调用就能告诉你,某个 Polymarket 市场的结果是已结算、有争议,还是在等待 UMA 投票,数据实时读取自 UMA 的 Optimistic Oracle 和 Polygon 上 Polymarket 的 UMA CTF 适配器。免费、无需密钥、带签名。
curl https://api.predge.io/v1/settlement-risk/:market:market = condition id、数字市场 id 或 slug。
Protocol V2 市场:由 UMA 解决的市场通过 Polymarket 的 OracleAggregator 读取(protocol: "v2");由 Chainlink 或 EOA 上报的市场,以及原子性的 neg-risk V2 市场,在支持之前返回 422 unsupported_protocol_v2。422 或 404 绝不意味着“没有风险”。
你会得到什么
risk_level:ok(无提案或争议)、watch、caution(有争议、已送交 UMA 投票或已暂停)、resolved(链上结果已最终确定)。uma_state、dispute_count、每起争议及其 tx、sent_to_uma_vote、公告板更新、onchain_resolution。segment_dispute_rate:2026 年这类市场发生争议的频率,附 95% 区间。attestation:对记录的 ed25519 签名,密钥 id 为3b6551a6439b9bda。见验证。
争议追踪器(免费)
过去 30 天内在 UMA 上出现争议的每个 Polymarket 市场,附其状态(disputed、uma_vote、resolved)和指向其签名记录的链接。页面:data.predge.io/disputes。可嵌入的徽章:<iframe src="https://data.predge.io/badge?market=ID" width="320" height="96">。
curl https://api.predge.io/v1/settlement-risk/active结算预估(付费)
GET https://api.predge.io/v1/settlement-risk/:market/estimate完整的签名记录加上 settlement_estimate。通过 x402 每次调用 $0.02,以 Base、Solana、Algorand、Arc 或 Monad 上的 USDC 支付;购买它的那笔付款会记在签名记录内。400/404/422/502 不收费;在预估支持之前,Protocol V2 市场在这里同样返回 422 unsupported_protocol_v2。试点合作伙伴可以获得一个密钥(x-predge-key 头),无需付款即可解锁。
签名的付款收据遵循 predgeAI/x402-receipts 中的开放规范。
Desk:针对你的钱包所持市场的提醒
面向交易者。最多添加 10 个钱包;它们持有的每个 Polymarket 市场都会被监控,每个结算事件都会发送到你的 webhook 和 Telegram:proposal、dispute、uma_vote(被争议两次,结果交由 UMA 投票)、bulletin_update(澄清和其他通知)以及 resolution。每个事件都附带签名的结算风险记录,即每起争议的证据。开始 14 天 Desk 试用,之后每月 $300。
curl -H "x-predge-key: $DESK_KEY" https://api.predge.io/v1/desk/config
curl -X PUT -H "x-predge-key: $DESK_KEY" -H "content-type: application/json" \
-d '{"wallets":["0x…"],"webhook_url":"https://you.example/hook","telegram_chat_ids":["123456789"]}' \
https://api.predge.io/v1/desk/config
curl -X POST -H "x-predge-key: $DESK_KEY" https://api.predge.io/v1/desk/test
curl -H "x-predge-key: $DESK_KEY" https://api.predge.io/v1/desk/eventsWebhook 投递带有签名:x-predge-signature: sha256=HMAC-SHA256(secret, "<x-predge-timestamp>.<raw body>")。拒绝时间戳偏差超过 5 分钟的请求。非 2xx 的响应会重试约一小时。同一个密钥每月涵盖 5,000 次 /estimate 调用。
巨鲸数据 API 和 MCP
Polymarket 巨鲸交易、按结果验证的优势排序的钱包业绩记录、聪明钱信号和签名证明。通过 x402 以 USDC 按调用付费:无需账户,无需 API 密钥。
| 路由 | 价格 |
|---|---|
| GET /v1/whales/latest | $0.005 |
| GET /v1/wallets/leaderboard | $0.01 |
| GET /v1/wallets/:address | $0.01 |
| GET /v1/signals/consensus | $0.03 |
| GET /v1/attest/:conditionId | $0.02,带签名 |
完整的路由列表和价格:api.predge.io · openapi.json · /.well-known/x402。付费数据延迟 15 分钟。
从代码中调用
npx x402-proxy https://api.predge.io/v1/whales/latest?limit=10任何 x402 客户端都可以(例如 @x402/fetch):请求路由,读取 402,付款,重试。
MCP 服务器
claude mcp add predge-whale-data \
-e BUYER_PRIVATE_KEY=0xYOUR_FUNDED_BASE_KEY \
-e X402_NETWORK=base \
-- npx -y @predge/whale-data-mcpnpm 上的 @predge/whale-data-mcp(源代码)。付费工具会花费真实的 USDC,并在任何资金转移之前受 MAX_PRICE_USD(默认 $0.05)的硬性上限约束。免费工具(发现、结算风险、记录验证)无需密钥。请使用余额很少的专用买方钱包。如果想要用登录而不是钱包的订阅方式,请使用托管 MCP 服务器。
托管 MCP 服务器
在 Claude、ChatGPT、Cursor、Codex 和其他 MCP 客户端中使用 Predge:Polymarket 巨鲸交易、钱包档案、内幕信号和签名的结算风险检查,以及针对你的钱包所持市场的 Desk 提醒。一个 URL,用你的 Predge 账户登录,无需钱包,也无需向 Predge 按调用付款。这是面向个人的订阅途径;按调用付费的智能体使用 npm 服务器和 x402,裁决则在 API 中。
https://app.predge.io/mcpStreamable HTTP,无状态,JSON 响应。没有凭据时返回 401,并附带 WWW-Authenticate: Bearer resource_metadata="https://app.predge.io/.well-known/oauth-protected-resource/mcp"。
连接
Claude(claude.ai、Desktop、移动端):Customize > Connectors > Add custom connector,粘贴上面的 URL,选择“Sign in now”,登录 Predge 并点击 Allow。ChatGPT:Plugins > + > Add custom MCP server,粘贴 URL,选择 OAuth。在 Team 和 Enterprise 套餐中,由所有者为整个组织添加一次连接器。
支持自定义请求头的客户端使用个人访问令牌。在 app.predge.io/app/agents 创建一个(以 pgm_ 开头,只显示一次,每个账户最多 10 个),并以 Authorization: Bearer pgm_… 发送。该页面还提供各客户端可直接复制粘贴的设置。
# Claude Code
claude mcp add --transport http predge https://app.predge.io/mcp --header "Authorization: Bearer $PREDGE_MCP_TOKEN"
# Gemini CLI
gemini mcp add --transport http --header "Authorization: Bearer $PREDGE_MCP_TOKEN" predge https://app.predge.io/mcp// Cursor: ~/.cursor/mcp.json
{ "mcpServers": { "predge": { "url": "https://app.predge.io/mcp", "headers": { "Authorization": "Bearer pgm_…" } } } }# Codex CLI: ~/.codex/config.toml (or OAuth: codex mcp login predge)
[mcp_servers.predge]
url = "https://app.predge.io/mcp"
bearer_token_env_var = "PREDGE_MCP_TOKEN"OAuth
遵循 MCP 授权规范的 OAuth 2.1,适用于带有 Connect 按钮的客户端。动态客户端注册(RFC 7591)位于 /oauth/register,仅限公共客户端,因此无需输入 client id 或 secret。使用 PKCE S256 的授权码(必需)、带轮换的 refresh token、有效期 1 小时的 access token,scope 为 mcp。每个连接都会作为已连接应用显示在 app.predge.io/app/agents 中,并可在那里断开。
| 文档 | URL |
|---|---|
| 受保护资源(RFC 9728) | app.predge.io/.well-known/oauth-protected-resource/mcp |
| 授权服务器(RFC 8414) | app.predge.io/.well-known/oauth-authorization-server |
套餐和限额
| 免费 | Pro | Desk | |
|---|---|---|---|
| 价格 | $0 | $20/月 或 $195/年 | $300/月,14 天免费试用 |
| 工具 | search_markets, live_whale_trades, top_whales | 所有读取工具 | Pro 工具外加 Desk 提醒和钱包 |
| 每个 UTC 日的调用次数 | 25 | 2,000 | 2,000 |
| 每分钟调用次数 | 10 | 60 | 120 |
| 数据 | 交易延迟 90 秒,每次调用最多 10 行 | 实时 | 实时 |
超出限额,或使用你的套餐不包含的工具时,调用会返回一个说明原因的 MCP 工具错误,并链接到 app.predge.io/app/settings。在那里升级后再次调用即可。Desk:开始试用。
工具
| 工具 | 套餐 | 功能 |
|---|---|---|
| search_markets | Free | Find markets by words, id, slug or link |
| live_whale_trades | Free | Latest large trades (Free: 90 s delay, 10 rows) |
| top_whales | Free | Highest-scoring wallets (Free: 10 rows) |
| get_market | Pro+ | Market detail with whale flow and order flow |
| get_wallet | Pro+ | Wallet score, P&L and recent trades |
| insider_signals | Pro+ | Fresh-wallet and all-in signals |
| settlement_risk | Pro+ | Signed UMA settlement-risk check |
| perps_markets | Pro+ | Polymarket Perps prices, funding and open interest |
| perps_whales | Pro+ | Perps whale board with the Predge score |
| perps_wallet | Pro+ | A Perps account: positions, leverage, liquidation estimate |
| lonestar_weather_forecast | Pro+ | LoneStarOracle WeatherOracle P(high > X), paid x402 $0.02 to LoneStarOracle |
| lonestar_macro | Pro+ | LoneStarOracle US macro, paid x402 $0.05 to LoneStarOracle |
| lonestar_rates | Pro+ | LoneStarOracle rates and recession odds, paid x402 $0.05 to LoneStarOracle |
| lonestar_labor | Pro+ | LoneStarOracle US labor, paid x402 $0.05 to LoneStarOracle |
| lonestar_energy | Pro+ | LoneStarOracle EIA energy inventories, paid x402 $0.05 to LoneStarOracle |
| proxies_sx_proxy | Pro+ | Proxies.sx residential/mobile proxy for anti-bot or geo-blocked sources, paid x402 $4/GB (min $0.40) to Proxies.sx |
| my_watchlist | Pro+ | Your watchlist wallets |
| my_desk_alerts | Desk+ | Recent dispute and settlement events |
| desk_wallets | Desk+ | Wallets your Desk watches |
| desk_add_wallet | Desk+ | Add a wallet to your Desk |
只读,desk_add_wallet 除外,它只编辑你自己的 Desk 钱包列表。标有“paid x402 to”其他提供方的工具不会通过 Predge 向你收费:工具会返回该提供方的 x402 付款要求,由你自己的 x402 客户端直接向提供方付款。Predge 从不持有密钥,也从不下单。结算退出(以 2¢ 或更低、或 98¢ 或更高的价格卖出)默认不会出现在交易列表中,除非你要求。
付款
根据你的身份有三种方式,另有一个用于管理密钥和额度的控制台(4)。同一个 x402 调用在所有方式中都适用;密钥只会改变哪些是免费的。
1. 无密钥 x402,按调用付费
无需账户,无需密钥。调用付费路由,API 返回 402 及价格和它接受的网络,你的客户端用 USDC 付款并重复请求。402 头(PAYMENT-REQUIRED)是 x402 v2;JSON 正文用通俗的话说明同样的内容。你需要一个在某个受支持网络上有少量 USDC 的钱包。下面是使用 v2 包、适用于 Base 的完整 Node 客户端:
// npm i @x402/fetch @x402/evm viem (Node 20+, ES module)
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
// A wallet that holds USDC on Base. Use a dedicated low-balance key.
const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const client = new x402Client();
registerExactEvmScheme(client, { signer });
const pay = wrapFetchWithPayment(fetch, client);
// $0.03: the client reads the 402, signs the payment, retries.
const res = await pay("https://api.predge.io/v1/signals/consensus");
console.log(res.status, await res.json());不要使用旧的 x402-fetch v1 包:它从正文读取报价,而 v1 的付款不是 v2 服务器所期望的。想不写代码就试一试:npx x402-proxy https://api.predge.io/v1/whales/latest?limit=10。各路由的价格和网络见 llms.txt。
2. 试点密钥:前 30 天免费,之后按调用付费
在 predge.io/start 获取密钥(仅需邮箱)。以 x-predge-key 发送。30 天内,它为免费的签名路由和付费的结算预估(GET /v1/settlement-risk/:market/estimate)提供每日配额,无需付费。30 天后,预估会再次返回 402,并带有头 X-Predge-Pilot: estimate_grant_expired。此后你用上面的无密钥 x402 客户端按调用付费;为此并不需要密钥。可通过 GET /v1/me 或在 predge.io/account 查看你的套餐、配额和到期时间。
curl -H "x-predge-key: $PREDGE_KEY" https://api.predge.io/v1/me3. Desk,面向交易者
针对你的 Polymarket 钱包的结算提醒,免费试用后每月 $300。详情和注册:predge.io/desk。API:见上文。
4. 管理密钥和额度
登录 app.predge.io/developers,在一处管理你的 API 密钥:创建密钥(最多 5 个有效密钥,只显示一次,仅以哈希形式存储)、重命名、吊销(下一次请求起生效)和轮换(立即生成新密钥,旧密钥在你选择的宽限期内仍可使用,默认 24 小时)。它还会显示每个密钥的用量(今天、7 天和 30 天,按路由)以及你的配额。已从 predge.io/start 拿到试点密钥?打开新密钥下方的链接,或把密钥粘贴到控制台中,即可将其关联到你的账户。试点密钥和控制台密钥(pdg_live_…)的工作方式相同。
若想从余额而不是按调用付费,请在 Billing 下充值 USDC($20、$50、$200,或 $10 至 $1,000 之间的任意金额)。带有 x-predge-key、调用有定价的数据路由时,会先从你的额度中扣费,响应中也会说明(X-Predge-Credits-Charged、X-Predge-Credits-Balance)。失败的调用不收费。没有额度,或在签名响应指明 x402 付款的路由(/v1/attest、/v1/wallets/:address/attest、/v1/track-record)上,你就按调用通过 x402 付款,与上文完全相同。每次充值都有可打印的收据。
curl -H "x-predge-key: $PREDGE_KEY" https://api.predge.io/v1/whales/latest # paid from credits, no x402 client needed验证签名
每条签名记录都带有一个 attestation,包含 canonical(实际被签名的字节)、signature 和 kid。请对照 Predge 的密钥注册表离线核验,而不是响应里自带的密钥:通过 kid 查找密钥,并拒绝注册表中标记为 revoked 的任何密钥,无论签名是何时作出的。密钥会轮换;请重新读取注册表,而不要固定某个密钥。
| 当前密钥 id(kid) | 3b6551a6439b9bda |
| ed25519 公钥 | 3b6551a6439b9bda0de7e3b8dc89f276b2141fdfde310f762e663ab4ba2e9d1b |
| 密钥注册表 | api.predge.io/.well-known/predge-keys.json |
// Node 20+, no dependencies
import { createPublicKey, verify } from "node:crypto";
const reg = await (await fetch("https://api.predge.io/.well-known/predge-keys.json")).json();
const r = await (await fetch("https://api.predge.io/v1/settlement-risk/5608010")).json();
const a = r.attestation;
// Look the key up by kid in the registry and refuse revoked keys
const entry = reg.keys.find((k) => k.kid === a.kid);
if (!entry || entry.status === "revoked") throw new Error("unknown or revoked key " + a.kid);
const key = createPublicKey({ format: "der", type: "spki",
key: Buffer.concat([Buffer.from("302a300506032b6570032100", "hex"), Buffer.from(entry.public_key, "hex")]) });
console.log(verify(null, Buffer.from(a.canonical, "utf8"), key, Buffer.from(a.signature, "hex"))); // true签名的内容
对于结算风险记录(payload_version: "2",自 2026 年 10 月 18 日起),签名还涵盖市场问题和 slug、每条公告板更新的 sha256,以及每次读取所在的 Polygon 区块(block:编号和哈希)。每个 eth_call 都在该区块上运行,因此归档节点可以完全复现这条记录。自 payload_version: "3" 起,市场日期以其在 Polymarket 中的名称签名:gamma_end_date(创建时设定的计划结束时间,常常已过时)、uma_end_date 和 closed_time(市场实际关闭的时间),每个都是 ISO-8601 UTC 或 null,原始 Gamma 字符串在 gamma_dates_raw 中。版本 2 的字段 end_date 已移除;请读取 gamma_end_date 获得同样的值。旧记录仍然有效。
整个 HTTP 正文也会被签名,放在 x-predge-body-signature 头中:对 predge-body-v1、一个换行符,再加上原始正文字节作 ed25519 签名。
const res = await fetch("https://api.predge.io/v1/settlement-risk/5608010");
const body = Buffer.from(await res.arrayBuffer());
const sig = /sig=([0-9a-f]{128})/.exec(res.headers.get("x-predge-body-signature"))[1];
console.log(verify(null, Buffer.concat([Buffer.from("predge-body-v1\n"), body]), key, Buffer.from(sig, "hex"))); // true规范:data.predge.io/canonicalization.md,第 5a 和 5b 节。Python:python3 verify_record.py record.json --body-signature "<header>"(verify_record.py)。
无需代码:把记录粘贴到 data.predge.io/verify。对于签名的 x402 付款收据,规范、TypeScript 库和测试向量在 predgeAI/x402-receipts。
GPU 租赁:按验证通过的天数付款
用于把 GPU 时间租给陌生买家的结算。买家每天用 USDC 预付到 Arc 上的托管合约。探针检查当天,Predge 签署裁决。已交付的那天付给主机方,未交付的那天退给买家。面向主机方和买家的概览:predge.io/gpu。
合约:Arc 主网上的 AgentJobV2
| 合约 | 地址(Arc,chainId 5042) |
|---|---|
| AgentJobV2(ERC-8183 风格的任务托管) | 0x5C673c6aBF3c60C3F6Ce3f1509f5d99C08F8B13F |
每个租用日一个任务。USDC 是 Arc 的原生 gas 代币,所以托管金额就是随 createJob 发送的金额。USDC 存放在合约中,不在 Predge 手里。
- 创建。买家(client)调用
createJob(provider, evaluator, specHash, expiredAt)并发送当天的价格,这笔金额就是托管金额。evaluator 必须不同于 client 和 provider。在 GPU 交易中,evaluator 是 Predge。 - 提交。在
expiredAt之前,主机方(provider)调用submit(jobId, deliverable, output)。deliverable是当天证据文件的 sha256。output可选:如果发送,合约会在链上检查它的 sha256 是否等于deliverable。 - 裁决。在提交后的
evaluationWindow内,Predge 调用complete(jobId, reason, data)付给 provider,或调用reject(jobId, reason, data)退给 client。reason是对已签名裁决的 bytes32 承诺。 - 超时。如果任务到期仍未提交,或 Predge 未在评估窗口内裁决,任何人都可以调用
claimRefund(jobId),托管金额退给 client。 - 提取。付款或退款记入收款方名下,由收款方通过
withdraw()或withdrawTo(to)提取。
用 getJob(jobId) 读取任务。事件:JobCreated、Submitted、Completed、Rejected、Refunded、Withdrawn。
SLA 与 specHash
主机方和买家在买家付款前约定 SLA。每天都有一份 spec:交易 ID、第几天、时间窗口、价格、SLA、主机方和买家地址以及网络。其规范 JSON 的 sha256 就是任务的 specHash,因此当天的条款在链上固定。1x A100 80GB 交易的 SLA:
"sla": {
"gpu_model": "A100",
"gpu_count": 1,
"min_memory_mib_per_gpu": 80000,
"heartbeats_per_period": 24,
"min_uptime_pct": 95,
"benchmark": "fp16_matmul_tflops_per_gpu",
"min_benchmark": 200
}含义:GPU 名称包含 A100,至少 1 块 GPU,每块 GPU 至少 80000 MiB 显存,24 次心跳中至少 95% 在线,fp16 matmul 至少 200 TFLOPS。
探针
探针在租用的实例内运行,和买家的任何工作负载一样。它不需要访问主机方的机器或网络。在一天中,它记录 nvidia-smi 心跳(GPU 名称、数量、显存),并运行一个简短的 fp16 基准测试:用 PyTorch 和 CUDA 在 cuda:0 上做 8192x8192 matmul,约 10 秒。输出是一份证据 JSON(predge-compute-evidence-v1)。它的 sha256 就是主机方在链上提交的 deliverable。
裁决
Predge 将证据与 spec 对照,并为当天签署裁决:delivered 或 not_delivered。它使用与其他 Predge 裁决相同的 predge-attest-v1 封装(对规范 JSON 的 ed25519 签名),并绑定任务 spec 哈希(job_sha256)、预付交易(payment_ref)和证据哈希(delivery.body_sha256)。可以像任何裁决一样离线验证:裁决 和 验证签名。
实证:在 Arc 主网上的三天
2026 年 11 月 12 日。一块租用的 A100,每天 0.20 USDC 托管,共 14 笔交易。第 2 天主机方换上了 A40,当天被退款。
| 天 | 探针看到的情况 | 结果 | 裁决交易 |
|---|---|---|---|
| 第 1 天 | NVIDIA A100-SXM4-80GB,检查通过 | 付给主机方 | 0xa292…37ba |
| 第 2 天 | NVIDIA A40(48 GB),而不是约定的 A100 | 退给买家 | 0x7fe8…4b16 |
| 第 3 天 | 再次是 NVIDIA A100-SXM4-80GB,检查通过 | 付给主机方 | 0x3118…ea46 |
目前的限制
- 合约已通过 Olympix 自动化工具检查。目前还没有独立的人工审计,所以首批交易金额小且有上限。
- 控制机器的主机方可能会试图向探针提供虚假读数。在生产环境中,我们固定探针镜像,并从实例外部交叉核对读数。
开始
告诉我们你的 GPU 和每天的价格:predge.io/gpu,或通过 Telegram 联系我们:t.me/latcom。
联系方式
预约 30 分钟的通话:calendly.com/hello-predge/30min。或发邮件到 hello@predge.io,也可以在 Telegram 上联系我们:t.me/latcom。