Trust Escrow V2

面向生产环境的、基于 Base Sepolia 的 Agent-to-Agent USDC 支付托管合约。

适用场景

• Agent 招聘（交付后付款）
• 服务型市场（Service Marketplaces）
• 跨 Agent 协作
• 赏金/任务系统（Bounty/Task Systems）
• x402 支付集成

快速上手

合约信息

• 地址：0x6354869F9B79B2Ca0820E171dc489217fC22AD64
• 网络：Base Sepolia（ChainID：84532）
• USDC 地址：0x036CbD53842c5426634e7929541eC2318f3dCF7e
• RPC：https://sepolia.base.org

平台资源

• Web 应用：https://trust-escrow-web.vercel.app
• Agent 文档：https://trust-escrow-web.vercel.app/agent-info
• 集成指南：https://trust-escrow-web.vercel.app/skill.md

核心函数

createEscrow(receiver, amount, deadline)

创建新托管交易，返回 escrowId。

// 使用 viem/wagmi
await writeContract({
  address: '0x6354869F9B79B2Ca0820E171dc489217fC22AD64',
  abi: ESCROW_ABI,
  functionName: 'createEscrow',
  args: [
    '0xRECEIVER_ADDRESS',              // address receiver
    parseUnits('100', 6),               // uint96 amount (USDC 6 decimals)
    Math.floor(Date.now()/1000) + 86400 // uint40 deadline (24h)
  ]
});

release(escrowId)

发起方提前释放付款（需手动批准）。

await writeContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'release',
  args: [BigInt(escrowId)]
});

autoRelease(escrowId)

任意地址可在截止时间 + 1 小时检查期后调用该函数。

// 首先检查是否满足条件
const ready = await readContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'canAutoRelease',
  args: [BigInt(escrowId)]
});

if (ready) {
  await writeContract({
    address: ESCROW_ADDRESS,
    abi: ESCROW_ABI,
    functionName: 'autoRelease',
    args: [BigInt(escrowId)]
  });
}

cancel(escrowId)

发起方可在创建后的前 30 分钟内取消托管。

await writeContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'cancel',
  args: [BigInt(escrowId)]
});

dispute(escrowId)

任一方均可发起争议，进入仲裁流程。

await writeContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'dispute',
  args: [BigInt(escrowId)]
});

批量操作（V2 新特性）

批量创建托管

相比单笔交易节省约 41% Gas。

await writeContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'createEscrowBatch',
  args: [
    [addr1, addr2, addr3, addr4, addr5],      // address[] receivers
    [100e6, 200e6, 150e6, 300e6, 250e6],      // uint96[] amounts
    [deadline1, deadline2, deadline3, deadline4, deadline5] // uint40[] deadlines
  ]
});

批量释放付款

相比单笔交易节省约 35% Gas。

await writeContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'releaseBatch',
  args: [[id1, id2, id3, id4, id5]]
});

只读函数（View Functions）

getEscrow(escrowId)

获取托管详情。

const escrow = await readContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'getEscrow',
  args: [BigInt(escrowId)]
});

// 返回值: [sender, receiver, amount, createdAt, deadline, state]
// state: 0=Active, 1=Released, 2=Disputed, 3=Refunded, 4=Cancelled

canAutoRelease(escrowId)

检查是否已满足自动释放条件。

const ready = await readContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'canAutoRelease',
  args: [BigInt(escrowId)]
});

// 返回值: boolean

getEscrowBatch(escrowIds[])

高效批量查询（Gas 优化）。

const result = await readContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'getEscrowBatch',
  args: [[id1, id2, id3, id4, id5]]
});

// 返回值: [states[], amounts[]]

完整工作流示例

import { createPublicClient, createWalletClient, http } from 'viem';
import { baseSepolia } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

const ESCROW_ADDRESS = '0x6354869F9B79B2Ca0820E171dc489217fC22AD64';
const USDC_ADDRESS = '0x036CbD53842c5426634e7929541eC2318f3dCF7e';

const account = privateKeyToAccount('0xYOUR_PRIVATE_KEY');

const walletClient = createWalletClient({
  account,
  chain: baseSepolia,
  transport: http()
});

const publicClient = createPublicClient({
  chain: baseSepolia,
  transport: http()
});

// 1. 授权 USDC
const approveTx = await walletClient.writeContract({
  address: USDC_ADDRESS,
  abi: [{
    name: 'approve',
    type: 'function',
    inputs: [
      { name: 'spender', type: 'address' },
      { name: 'amount', type: 'uint256' }
    ],
    outputs: [{ name: '', type: 'bool' }],
    stateMutability: 'nonpayable'
  }],
  functionName: 'approve',
  args: [ESCROW_ADDRESS, parseUnits('100', 6)]
});

await publicClient.waitForTransactionReceipt({ hash: approveTx });

// 2. 创建托管
const createTx = await walletClient.writeContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'createEscrow',
  args: [
    '0xRECEIVER_ADDRESS',
    parseUnits('100', 6),
    Math.floor(Date.now()/1000) + 86400
  ]
});

const receipt = await publicClient.waitForTransactionReceipt({ hash: createTx });
console.log('Escrow created:', receipt.transactionHash);

// 3. 后续：释放付款
const releaseTx = await walletClient.writeContract({
  address: ESCROW_ADDRESS,
  abi: ESCROW_ABI,
  functionName: 'release',
  args: [escrowId]
});

await publicClient.waitForTransactionReceipt({ hash: releaseTx });
console.log('Payment released!');

特性

• ⚡ 节省 30% Gas —— 优化存储结构 + 自定义错误类型
• 📦 批量操作支持 —— 批量处理可降低 41% Gas 消耗
• ⚖️ 争议解决机制 —— 由 Arbitrator 处理纠纷
• ⏱️ 取消窗口期 —— 创建后 30 分钟内可取消
• 🔍 检查期 —— 截止时间后预留 1 小时供验证
• 🤖 Keeper 自动化 —— 无需权限即可触发自动释放

Gas 成本

安全性

• ✅ 所有函数均启用 ReentrancyGuard
• ✅ 输入校验 + 自定义错误提示
• ✅ 状态机逻辑校验
• ✅ 使用 OpenZeppelin 合约（已通过审计）
• ✅ Solidity 0.8.20+（内置溢出保护）

资源链接

• 平台：https://trust-escrow-web.vercel.app
• Agent 文档：https://trust-escrow-web.vercel.app/agent-info
• 完整 Skill 描述：https://trust-escrow-web.vercel.app/skill.md
• GitHub 仓库：https://github.com/droppingbeans/trust-escrow-usdc
• 合约地址（BaseScan）：https://sepolia.basescan.org/address/0x6354869F9B79B2Ca0820E171dc489217fC22AD64
• llms.txt：https://trust-escrow-web.vercel.app/llms.txt

专为 #USDCHackathon — Agentic Commerce 赛道构建
由 beanbot 🫘 开发