00 / Start

30 分钟,
跑通你第一笔 Pact 单。

选你的角色,跟着 3 步走。每一步都对应一个真实的链上动作, tx 直接进 Blockscout — 不是 demo。

chain 9777 + oracle 3-node (committee, 2-of-3 quorum) faucet · explorer · backend · frontend discovery bot (Server 2, watching CampaignCreated) verified 2026-05-22 11:32 UTC
CONCEPT · BEFORE YOU START

"Agent 到底怎么拥有钱包?"

Pact 里有 3 类钱包。搞清楚每一类是什么、谁掌握私钥, onboarding 后面的步骤就不会困惑。

01 · YOUR HUMAN WALLET
你的钱包 (MetaMask)

你装的 MetaMask / Rabby。你持有私钥。这是真正能"签名"的钱包, 所有 PactAgent NFT 都登记在它名下。

· 谁掌握: 你
· 在链上以"个人钱包地址"出现
· gas + faucet 领的 PACT 落在这里
02 · AGENT 6551 ACCOUNT
Agent 的"链上身份账户"

每个 PactAgent NFT 通过 ERC-6551 自动绑定一个智能合约账户。 这个账户就是 agent 在链上的"钱包" — 但它没有自己的私钥。 它由你的 NFT 持有人控制(execute 函数)。

· 谁掌握: NFT owner (= 你的钱包)
· 在链上以"6551 合约地址"出现 (Escrow.creator / advertiser 字段)
· 累积的 PACT + SBT 都落在这里
03 · ORACLE / AGENT SERVER KEY
Agent 软件的"操作私钥"

当你部署 Hermes/Marketing Agent 7×24 跑(`install.sh` 装的那个), 你给它一个专门的钱包私钥(.env 里的 OWNER_PRIVATE_KEY)。 建议:用专用钱包(不是主资产钱包),只放少量 PACT 做 gas。

· 谁掌握: 你,但放在 agent server 的 .env 里
· agent 软件用它代你签所有链上动作
· 不部署 agent (手动模式) = 不需要这个
关键不变量(为啥这么设计?)
  • 链上身份 = NFT。 NFT 转给新人,新人立刻控制原来那个 6551 account 的所有 PACT + SBT + 历史。不需要"迁移"操作。
  • Agent server 的私钥可以更换。 停掉旧 agent,换个 .env 的 OWNER_PRIVATE_KEY,只要是 NFT 当前持有人的私钥就行。
  • 协议永远不存私钥。 Pact 后端 / Discovery bot / Oracle node 都没有你 owner 的私钥。 签名一定在你自己的 server / wallet 上发生。
  • Oracle node 是另一回事。 Oracle 节点有自己的 5000 PACT 抵押 + 自己的 ORACLE_ROLE 钱包 — 跟 advertiser/creator 流程完全独立。
PRE-REQS · 5 分钟

两边都要先准备

钱包 · MetaMask / Rabby

加 Pact testnet 网络: chainId 9777, RPC pact-chain.gjs.ink

领 PACT

pact-faucet.gjs.ink 领 testnet PACT。商家需要 ≥ 100 PACT 做单,创作者只需 gas (~0)。

加 Pact 群

Telegram + Discord 实时 broadcast 新单 + 创作者名单。 t.me/pactprotocol

PATH A · ADVERTISER (商家)

3 步发出你的第一个 campaign。

你给一个真实的 Web3 KOL 100 PACT,让他在 Twitter 推你的项目。 KPI 不达成,你的钱自动退回。

01
绑钱包 + Mint Marketing Agent NFT

pact.gjs.ink/advertiser 连 wallet。 找 Pact admin (hong@omineye.ai) 给你 mint 一个 Demand 类型的 Agent NFT, 并自动建好 6551 智能账户。

产出: NFT tokenId + 6551 account 地址。这个 6551 account 就是你的"市场预算账户"。

# Admin 端 (你跟 hong@omineye.ai 沟通后):
$ TO=0xYourWallet NAME="MyProject Marketing Bot" \
    npx hardhat run scripts/mint-marketing-agent-for.ts --network pact

# 输出:
#   tokenId: 5
#   6551 account: 0x...
02
充值 6551 account + 找 Hermes

从你的 wallet 转 100 PACT 到 6551 account。 然后到 Telegram @pactprotocol, 看 pinned message "registered creators" 列表 — 选一个完成率 ≥85% 主题契合的 Hermes 地址。

产出: 你确认的 Hermes 6551 account 地址 (creator address)。

# 直接在 frontend /advertiser 里点 "充值 PACT 到 agent 账户"
# 或 wagmi:
$ cast send $PACT_TOKEN_ADDR \
    "transfer(address,uint256)" $YOUR_6551 100000000000000000000 \
    --rpc-url https://pact-chain.gjs.ink --private-key $YOUR_PK
03
在 /advertiser 创建 + activate campaign

填表: creator 地址、平台 (twitter)、contentId (你项目的话题词)、 金额 100 PACT、KPI 30000 impressions、结算窗口 7 天。 点 "Create" → 钱包签 → 链上 createCampaign + approve。 点 "Activate"。

产出: tx hash + campaign ID。Discovery bot 会自动 broadcast 到 Telegram。

# 全流程在 https://pact.gjs.ink/advertiser 表单完成
# 链上结果:
# 1. PACT 100 锁仓 Escrow
# 2. CampaignCreated event 触发
# 3. Oracle 每小时检查 KPI
# 4. KPI 达 → 97 PACT 自动 release 给 creator + 1 SBT
# 5. KPI 不达 → 你点 "Open Dispute" 退款
PATH B · CREATOR (创作者 / KOL)

3 步接到你的第一笔单。

你已经有真实 Twitter / Farcaster KOL 影响力。 Pact 帮你把这影响力变成可验证的链上信誉 + PACT 收入,跨平台、跨商家通用。

01
绑钱包 + Mint Hermes (Supply) NFT

pact.gjs.ink/creator 连 wallet, ADR-2 双步绑定 (challenge + verify)。 找 admin 给你 mint Hermes (Supply) NFT + 6551 account。

产出: tokenId + 6551 account。6551 account 就是你"代理人"的链上身份。

# Admin 端 (mint for you):
$ TO=0xYourCreatorWallet NAME="Alice Defi KOL" \
    npx hardhat run scripts/mint-hermes-for.ts --network pact
02
在 /creator 注册档案 + 上 Telegram 群

填: 你的 Twitter handle、主题 (defi/nft/dao/gamefi)、平均单价 PACT/imp、6551 account 地址。 Discovery bot 自动把你加进 Telegram pinned "registered creators" 列表。

产出: 你出现在 Pact creator marketplace,商家会主动找你。

# 在 frontend /creator 表单填写
# 或后端 API:
$ curl -X POST https://pact-api.gjs.ink/api/v1/creators/ \
    -H 'content-type: application/json' \
    -d '{
      "eth_address": "0x...",
      "name": "alice_defi",
      "bilibili_uid": null
    }'

# 查询 (例:看现有 4 个 testnet 创作者):
$ curl 'https://pact-api.gjs.ink/api/v1/creators/?limit=100'
03
接单 → 发内容 → 等 Oracle → 拿钱 + SBT

商家在链上调 createCampaign,你的 6551 account 是 creator 字段。 关键:你看到 Discovery bot 在 TG 群里 @你, OR 在 /creator 页面 inbox 看到新单 → 发对应的 Twitter 内容 → Oracle 拉真实 impressions → 达 KPI 自动给你 97 PACT + 1 SBT。

可选: 部署 Hermes agent (7×24 自动接单)。看 /deploy-hermes

# 完全手动模式 (推荐先这样跑通一次):
# 1. TG 群看到 @your-creator-account: "campaign #12, 100 PACT, KPI 30k"
# 2. 你在 Twitter 发对应 thread
# 3. 每小时 Oracle 调 Twitter v2 API 拉 impressions
# 4. impressions ≥ 30000 → status: KpiReported
# 5. 商家点 Release (or 自动) → 你 6551 account +97 PACT + 1 SBT
# 6. 任何商家以后查你 6551 → 看见这枚 SBT
AFTER YOUR FIRST DEAL

第一笔单后
下一步该想什么。