English Français العربية

io.github.dingdawg/agent-wallet

السجل الرسمي المالية والمدفوعات

Governed USDC wallet for AI agents — policy gates, spending caps, and Ed25519-signed receipts.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package dingdawg-agent-wallet
Claude Code 
claude mcp add agent-wallet -- npx -y dingdawg-agent-wallet@1.0.6
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "agent-wallet": {
            "command": "npx",
            "args": [
                "-y",
                "dingdawg-agent-wallet@1.0.6"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. dingdawg-agent-wallet — live demo
  2. What it demonstrates
  3. Run it
  4. The package
  5. Why this matters

dingdawg-agent-wallet — live demo

Shows governed agent wallet enforcement in action: allow, deny, step-up, allowlist — all in 5 seconds. No API keys. No blockchain required.

What it demonstrates

▶ 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

Every action — allow AND deny — produces an immutable receipt. chain_verified: true means the full chain is tamper-evident — any modification is detectable.

Run it

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

The package

dingdawg-agent-wallet — 5 MCP tools that wrap any agent wallet with policy enforcement and an immutable audit trail.

npm install dingdawg-agent-wallet
ToolWhat it does
provision_walletCreate wallet with spend policy (daily cap, per-call cap, allowlist)
governed_spendPolicy check → authorize → immutable receipt
governed_receiveAccept payment with tamper-evident receipt
wallet_policyUpdate limits and allowlists at runtime
wallet_auditFull receipt chain — chain_verified: true

Coinbase AgentKit gives your agent a wallet. DingDawg gives it a conscience.

Why this matters

AI agents can now hold USDC and spend autonomously. The infrastructure exists. What doesn't: who enforces what the agent is allowed to spend, on what, for whom — and proves it happened correctly.

  • governed_spend authorizes then returns the exact agentkit_call SDK method to execute on-chain
  • Every denial is logged — you can prove what your agent didn't do
  • chain_verified: true means the audit trail is tamper-evident — any modification is detectable

npm · DingDawg

الأسئلة الشائعة

ما هو io.github.dingdawg/agent-wallet؟

Governed USDC wallet for AI agents — policy gates, spending caps, and Ed25519-signed receipts.

كيف أثبّت io.github.dingdawg/agent-wallet؟

يعمل على جهازك. في Claude Code: claude mcp add agent-wallet -- npx -y dingdawg-agent-wallet@1.0.6. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.dingdawg/agent-wallet إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.dingdawg/agent-wallet مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.dingdawg/agent-wallet؟

ينشره dingdawg. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.