部署/Oracle Node

Oracle Node

去中心化数据验证

Pact 协议级去中心化节点。拉 Twitter / Farcaster / Discord 真实 KPI，EIP-712 签字，多签上链。0.9% 协议费 pool 分润 + 议会 NFT 优先权 + 长期 protocol equity。

一键安装

$ curl -fsSL https://pact.gjs.ink/install-oracle.sh | bash

会装 Docker + clone repo + 交互式 .env (oracle 私钥 / Twitter token / coordinator secret) + 启动 container + 健康检查

与 Hermes / Marketing Agent 的区别

这是真正的去中心化节点。

Hermes / Marketing Agent

私人客户端

· 一个用户用 Pact 的工具
· 协议不依赖它
· 无需多签 / 抵押
· 类比 MetaMask / Rabby

Oracle Node

协议基础设施

· 协议硬依赖 — 没它没法验 KPI
· 需要 5000 PACT 抵押 + 多签 quorum
· 错误 / 共谋会被 slash
· 类比 Chainlink node operator

经济模型

收益模型 + 抵押 + 罚没。

抵押

5,000

PACT 锁定

退出有 7 天 cooldown 后退回

月分润

0.9%

GMV pool 分给 N oracle

月 $500k GMV / 5 oracles ≈ 150 PACT/月/oracle

议会 NFT

100

Oracle 专属 cohort

早期 oracle 优先分配，长期 protocol equity

罚没 (slash) 规则

KPI 提交错误 (与其他 oracle 差 > 5%，月 3 次)-500 PACT

节点离线 > 24h-200 PACT

错误 sign 导致 campaign 错误 release-5,000 PACT (全部)

共谋 (跟商家 / Hermes 通谋假 KPI)-5,000 + 永久 ban

手动安装

不用一键脚本，自己一步步装。

第 1 步 · 依赖

$ sudo apt update && sudo apt install -y docker.io docker-compose-plugin git

第 2 步 · clone

$ git clone https://github.com/hongnono-wdh/pact-protocol.git
$ cd pact-protocol/oracle-node

第 3 步 · 配置 .env

ORACLE_PRIVATE_KEY=0x...
ORACLE_NODE_INDEX=4
PACT_RPC_URL=https://pact-chain.gjs.ink
PACT_CHAIN_ID=9777
PACT_ESCROW_ADDR=0x62Ff1Be5184f59de79b7fEb6B32a08832067A548

# Data source APIs (你自己掏钱)
TWITTER_BEARER=...                     # $100/month paid tier
FARCASTER_NEYNAR_KEY=...               # 可选, free tier

COORDINATOR_URL=https://pact-api.gjs.ink/api/v1/oracle
COORDINATOR_SHARED_SECRET=...          # admin 给你

POLL_INTERVAL_SECONDS=15
PORT=9001

第 4 步 · 启动

$ docker compose up -d

第 5 步 · 验证

$ curl http://localhost:9001/health

{
  "status": "ok",
  "signer": "0xYourOracleAddress",
  "node_index": 4,
  "uptime_seconds": 30,
  "campaigns_signed_total": 0,
  "data_source_status": {
    "twitter": "ok",
    "farcaster": "ok"
  }
}

申请流程

怎么变成 Oracle 节点运营方。

准备钱包 + 5000 PACT 抵押

专门钱包不要主钱包。从 faucet 拿 5000 PACT (testnet) 或议会战略购入 (mainnet)。

VPS + Twitter API key

$5/月 VPS 任意供应商。Twitter API v2 paid tier ($100/月)。Farcaster Neynar 免费。

联系 admin

Email [email protected] 告知：oracle wallet 公钥地址 / VPS 公网 IP (admin 加监控白名单) / 你的联系方式。

Admin grant ORACLE_ROLE

admin 调 grantRole 给你钱包 + share coordinator secret。

跑 install script

填好 .env，启动。

24h 后正式运转

admin 验证你节点 health → 你开始 sign + 分润。

分润路线图

早期 oracle 拿的不是钱，是议会股权。

现在 W4 close

月活 GMV $300 (3 demo)

~ 0.1 PACT/月

W5 W2

KOL 真单实验后

~ 1.5 PACT/月

半年后

真单流稳定

~ 15 PACT/月

1 年 + 议会 NFT 分发

$500k/月 GMV

~ 150 PACT/月 + 议会 NFT

完整运营指南（含 monitoring system prompt / troubleshooting）