PactFlow

PactFlow 将自然语言 Client Agent、Cobo Agentic Wallet、ERC-8183 风格的任务托管，以及 Sepolia 上的验证与结算流程组合为可审计的 Agentic Commerce 工作流。

运行网络为 Sepolia 测试网。系统不处理真实资产，仓库不包含可用的 API Key、私钥、Cobo 钱包凭据、设备码或生产数据库数据。

核心流程

1. 用户注册并通过 Client Agent 用自然语言描述任务。
2. 平台 Provisioner 为该账户创建一只 CAW，并签发五分钟有效的设备码。
3. 用户在 Cobo Agentic Wallet App 完成配对并接管钱包；签名、Pact 批准和超额操作均在 Cobo 中完成。
4. Client 创建受 ERC-8183 状态约束的 Job：服务费与借贷本金分别进入链上托管边界。
5. Executor 执行受 Pact 约束的工作；Evaluator 验证 ExecutionProofV1 并决定结算或拒绝。

平台角色边界：

角色	职责
Client	与用户对话、收集任务条款、提出明确待确认的 Job/Pact 提案
Provisioner	创建用户专属 CAW 和首次设备码；不持有用户钱包控制权
Executor	在已批准的 Pact 范围内执行任务并提交证明
Evaluator	验证证明、记录验证结果并触发结算或拒绝

范围与限制

• 资产：SETH 与 mUSDC；网络：Ethereum Sepolia (SETH)。
• 默认 Cobo Agent Mode 下，用户接管钱包后，平台不能重新签发设备码。签名恢复在 Cobo App 完成；确实无法恢复时，用户必须明确确认创建替代 CAW，旧钱包、资产和 Pact 不自动迁移。
• 浏览器不接触钱包私钥、Cobo API Key、Pact-scoped Key 或签名材料。
• 合约地址、交易哈希与证明工件仅用于测试网验证与复现实验，不构成金融服务或投资建议。

仓库结构

backend/     FastAPI、LangGraph Client Agent、Cobo 适配器、持久化与 API
web/         Next.js 控制台、注册登录、对话、钱包、Pact 与收益界面
contracts/   Foundry 合约、ZK 证明电路和 Sepolia 部署脚本
compose.yaml 本地 PostgreSQL、Redis 与 Qdrant

Sepolia 测试部署

以下地址均为公开测试网合约，不含真实资产价值：

合约	地址
AgenticCommerce	0x170B…50aF0
CapitalVault	0xc8f0…Cb364
mUSDC	0x4BfD…8Cf73
MUSDCLendingMarket	0x8702…F1be1

该 mUSDC 是测试资产。任何地址可调用 mint(address to)，每次向目标地址发放固定 500 mUSDC，同一目标地址每个 UTC 日仅一次。

本地运行

前置条件：Node.js/pnpm、Python + uv、Docker，以及 Foundry（仅合约测试需要）。

cp .env.example .env
pnpm install
pnpm db:up
pnpm db:migrate
pnpm dev:backend
pnpm dev:web

默认地址：前端 http://localhost:3001，API http://127.0.0.1:8000。

不配置 MiniMax、Cobo、Pinata、RPC 或 Sepolia 合约地址时，代码可用于界面和本地 API 开发；需要对应能力时，请在自己的 .env 中单独填写凭据。不要将该文件提交到 Git。

验证

pnpm test:contracts
pnpm test:backend
pnpm --dir web test
pnpm --dir web exec tsc --noEmit
pnpm --dir web build

License

未提供开源许可证。除非另有书面许可，保留所有权利。