agent-wallet

Name: agent-wallet
Author: dingdawg

本地服务

github.com/dingdawg金融数据022 周前更新

代码仓库

关于 agent-wallet

agent-wallet 是用于管理 Agent USDC 钱包活动的 MCP 服务，通过支出策略和不可篡改的审计记录约束并验证支付，适合需要管控 Agent 支付的团队。

主要功能

01按支出策略创建钱包
02管理 USDC 支付并生成收据
03管理收款并生成收据
04运行时更新限额和允许列表
05验证防篡改收据链

适用场景

01设置每日和单笔支出上限
02按策略授权 Agent 支付
03记录被拒绝的支付尝试
04核验钱包活动审计记录

MCP 相关

提供五种 MCP 工具，用于创建钱包、管理支付和收款、更新策略及审计收据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dingdawg-agent-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "dingdawg-agent-wallet"
      ]
    }
  }
}

启动命令npx -y dingdawg-agent-wallet

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmdingdawg-agent-wallet1.0.6stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
label	string	否	便于用户理解的标签
network	string	否	链网络（默认值：base）
provider	enum	是	钱包提供程序coinbase \| x402 \| local
wallet_id	string	否	可选的自定义钱包 ID
daily_cap_usdc	number	否	USDC 每日支出限额（默认值：500）
per_call_cap_usdc	number	否	USDC 单笔交易限额（默认值：100）
allowed_recipients	array	否	收款人钱包地址的可选允许列表

详细介绍

dingdawg-agent-wallet — 实时演示

展示受治理的 Agent 钱包如何执行策略：允许、拒绝、升级验证、允许列表——全部在 5 秒内完成。无需 API 密钥。无需区块链。

演示内容

▶ provision_wallet
  wallet_id:    demo-wallet-abc123
  daily_cap:    $200 USDC
  per_call_cap: $100 USDC

▶ governed_spend — $25 USDC (allowed)
  ✓ AUTHORIZED
  receipt_id:      6aba84a6-...
  daily_remaining: $175 USDC
  next_step:       wallet.sendToken({ assetId: "usdc", amount: "25", destination: "0xVendorABC123" })

▶ governed_spend — $150 USDC (exceeds per-call cap)
  ✗ DENIED
  reason:      Amount 150 USDC exceeds per-call cap 100 USDC
  receipt_id:  cd7a7aa8-... (denial is logged too)

▶ governed_spend — $75 USDC (step-up required)
  ⚠ STEP-UP REQUIRED
  reason: Amount 75 USDC > step-up threshold 50 USDC — MFA required
  fix:    Pass approval_token from your authorization flow

▶ governed_spend — unknown recipient (not in allowlist)
  ✗ DENIED
  reason: Recipient 0xUnknownAddress not in allowlist

▶ wallet_audit
  chain_verified: true ✓
  total_receipts: 5
  [17:02:18] DENY  $10 USDC    governed_spend
  [17:02:18] DENY  $75 USDC    governed_spend
  [17:02:18] DENY  $150 USDC   governed_spend
  [17:02:18] ALLOW $25 USDC    governed_spend
  [17:02:18] ALLOW              provision_wallet

每个操作——无论允许还是拒绝——都会生成不可变的回执。chain_verified: true 表示完整链路具备防篡改能力——任何修改都可被检测到。

运行

git clone https://github.com/DingDawg/agent-wallet-demo
cd agent-wallet-demo
npm install
node demo.mjs

软件包

dingdawg-agent-wallet — 5 个 MCP 工具，可为任意 Agent 钱包添加策略执行和不可变的审计轨迹。

npm install dingdawg-agent-wallet

工具	功能
`provision_wallet`	创建钱包并设置支出策略（每日上限、单次调用上限、允许列表）
`governed_spend`	策略检查 → 授权 → 不可变回执
`governed_receive`	接收付款并生成防篡改回执
`wallet_policy`	在运行时更新限额和允许列表
`wallet_audit`	完整回执链 — `chain_verified: true`