by 详细分析 ▾
运行时依赖
版本
TruCheq Protocol Skill 1.0.0 – 初始版本 - 浏览 TruCheq 协议已验证的 P2P 市场上架列表。 - 获取包含卖家信任等级（World ID 验证）的详细上架数据。 - 在 Base Sepolia 测试网使用 Coinbase x402 支付（USDC）购买商品。 - 通过 XMTP 加密消息与卖家安全聊天。 - 支持带图片上传的上架创建；卖家通过 World ID 多级验证。 - 所有市场与消息操作通过简单 API 路由（无需直接交互区块链或 IPFS）。
安装命令
点击复制技能文档
# TruCheq 协议代理技能 使用此技能帮助用户通过 P2P 商务协议买卖物品。卖家通过 World ID 验证，列表由市场 API 展示（IPFS 已抽象），买家通过 Base Sepolia 上的 Coinbase x402 支付，并使用加密的 XMTP 聊天。 ## 网络配置 - 链：Base Sepolia（链 ID：84532） - 支付代币：USDC（0x036cbd53842c5426634e7929545ec598f828a2b5） - XMTP 环境：dev（用于 Base Sepolia 测试网） ## 核心功能 ### 1. 浏览市场 TruCheq 市场（/marketplace）展示来自经过验证的用户和代理的列表。所有卖家均已通过 World ID 验证身份。 市场 URL： `` GET {TRUCHEQ_API_URL}/marketplace ` 注意： 代理可抓取此页面以找到列表 CID。每个列表包含：cid、卖家地址、metadataUrl、价格以及 isOrbVerified 标志（Orb = 最高信任，Device = 较低信任）。 ### 2. 获取列表详情 通过 CID（来自市场或已知列表）获取特定列表的详细信息。 ` GET {TRUCHEQ_API_URL}/api/deal/{cid}?meta={metadataUrl} ` 参数： - cid - 列表内容 ID - meta - 元数据 URL（来自市场） 响应： `json { "id": "Qm...", "seller": "0x...", "metadataURI": "https://...", "price": "300", "isOrbVerified": true } ` ### 2. 通过 x402 购买 使用 Coinbase x402 协议为列表付款。未付款时返回 402（需要付款），付款后返回列表数据及有效证明。 ` GET {TRUCHEQ_API_URL}/api/deal/{cid}/x402?meta={ipfsUrl} ` 未付款（402 响应）： `json { "error": "Payment required", "scheme": "exact", "price": "300000000", "network": "84532", "asset": "USDC", "payTo": "0x...", "maxTimeoutSeconds": 300, "description": "TruCheq listing: ItemName - 300 USDC" } ` 付款标头格式： ` WWW-Authenticate: x402 scheme=exact, network=eip155:84532, amount=$300000000, asset=USDC, payTo=0x... ` ### 3. 创建列表（卖家） 上传图片并创建新列表。API 在内部处理 IPFS 存储。 ` POST {TRUCHEQ_API_URL}/api/upload Content-Type: multipart/form-data ` 上传图片： - type: "image" - file: 二进制图片文件 创建列表： - type: "metadata" - metadata: 包含 itemName、description、price、seller、createdAt、isOrbVerified、images 的 JSON 对象 ### 4. 验证 World ID 证明 验证用户的 World ID 证明。支持四个信任级别： ` POST {TRUCHEQ_API_URL}/api/verify ` 请求： `json { "devPortalPayload": { "nullifier_hash": "0x...", "proof": "0x...", "verification_level": "orb" } } ` 验证级别： - orb - 最高信任，World ID Orb 生物识别验证 - secureDocument - 政府 ID 验证 - document - 基础文件验证 - device - 最低信任，基于设备验证 ### 5. XMTP 消息 在买家和卖家之间发送加密消息。 ` POST {TRUCHEQ_API_URL}/api/xmtp ` 发送消息： `json { "action": "send", "buyerAddress": "0x...", "message": "Hi, I'm interested!" } ` 列出对话： `json { "action": "list-conversations" } ` 获取消息： `json { "action": "messages", "conversationId": "..." } ` ## 使用流程 ### 购买物品流程 1. 浏览市场：GET /marketplace 查看所有列表 2. 选择列表并获取详情：GET /api/deal/{cid}?meta={metadataUrl} 3. 检查 isOrbVerified 了解卖家信任级别 4. 打开 XMTP 聊天：POST /api/xmtp 并设置 action 为 "send" 5. 通过 x402 支付：GET /api/deal/{cid}/x402?meta={metadataUrl} 并附带付款证明 ### 创建列表流程（卖家） 1. 上传图片：POST /api/upload 并设置 type=image 2. 创建包含 itemName、description、price、卖家地址、images 的元数据 JSON 3. 上传元数据：POST /api/upload 并设置 type=metadata 4. 分享列表 URL：{baseUrl}/deal/{cid}?meta={metadataUrl} ### 验证卖家流程 1. 获取列表以得到卖家地址 2. 要求卖家提供 World ID 证明 3. 验证：POST /api/verify 并附带卖家的 devPortalPayload ## 列表元数据结构 `json { "itemName": "Apple Watch Ultra", "description": "Like new, comes with box", "price": "300", "seller": "0xabc123...", "createdAt": 1734567890, "isOrbVerified": true, "verificationLevel": "orb", "images": ["ipfs://Qm...", "ipfs://Qm..."] } ` ## 信任指标 - isOrbVerified: true + verificationLevel: "orb" = 最高信任 - verificationLevel: "secureDocument" = 政府 ID 已验证 - verificationLevel: "document" = 基础文件已验证 - verificationLevel: "device" = 基于设备（最低信任） ## 错误代码 - 400 - 缺少必需参数 - 402 - 需要付款（x402 端点） - 404 - 资源未找到 - 500` - 服务器错误 ## 重要说明 - 列表存储于 IPFS（通过市场 API 隐藏——无需直接交互 IPFS） - 付款直接给卖家（无托管） - 列表元数据中的卖家地址用于 XMTP - XMTP 环境为 "dev"（Base Sepolia 测试网）