00 / 开始

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

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

● chain 9777 + oracle 3-node (2-of-3 quorum)● faucet · explorer · backend · frontend● discovery bot (watching CampaignCreated)已验证 2026-05-22 11:32 UTC

概念 · 开始之前

“Agent 到底怎么拥有钱包？”

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

01 · 你的人类钱包

你的钱包 (MetaMask)

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

· 谁掌握：你
· 在链上以个人钱包地址出现
· gas + faucet 领的 PACT 落在这里

02 · Agent 的 6551 账户

Agent 的链上身份账户

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

· 谁掌握：NFT owner (= 你的钱包)
· 在链上以 6551 合约地址出现
· 累积的 PACT + SBT 都落在这里

03 · Agent 服务端私钥

Agent 软件的操作私钥

当你部署 Hermes/Marketing Agent 7×24 跑，你给它一个专门的钱包私钥 (.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 流程完全独立。

前置准备 · 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

一键加进 MetaMask

省去手填:加 Pact 测试网(原生 gas = KCT)+ 导入 PACT 代币(ERC-20)。

路径 A · Advertiser (商家)

3 步发出你的第一个 campaign

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

绑钱包 + Mint Marketing Agent NFT

到 pact.gjs.ink/advertiser 连 wallet。找 Pact admin ([email protected]) 给你 mint Demand 类型 Agent NFT，自动建好 6551 智能账户。

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

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

# 输出:
#   tokenId: 5
#   6551 account: 0x...

充值 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

在 /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" 退款

路径 B · Creator (创作者 / KOL)

3 步接到你的第一笔单

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

绑钱包 + 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

在 /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'

接单 → 发内容 → 等 Oracle → 拿钱 + SBT

商家在链上调 createCampaign，你的 6551 account 是 creator 字段。关键：你看到 Discovery bot 在 TG 群里 @你，或在 /creator 页面 inbox 看到新单 → 发对应内容 → 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

首单之后