开发者钱包服务

git clone https://github.com/Tylerc8138/x402-MCP-Wallet.git
cd x402-MCP-Wallet
npm install && npm run build

{
  "mcpServers": {
    "clawd-wallet": {
      "command": "node",
      "args": ["/path/to/unified-clawd-wallet-mcp/dist/mcp-server/index.js"],
      "env": {
        "CLAWD_BACKEND_URL": "https://clawd-domain-backend-production.up.railway.app",
        "CLAWD_TAP_MOCK_MODE": "true"
      }
    }
  }
}

You: "Check my wallet balance"

Claude: [calls x402_check_balance]

{
  "success": true,
  "balance": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f...",
    "amount": "25.50",
    "currency": "USDC",
    "decimals": 6
  }
}

You: "What's my USDC balance?"

{
  "success": true,
  "balance": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f...",
    "amount": "25.50",
    "currency": "USDC",
    "decimals": 6
  }
}

You: "Add $50 to my wallet"

{
  "success": true,
  "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f...",
  "expectedAmount": 50,
  "currency": "USDC",
  "message": "Secure payment window opened. Complete purchase to add $50 USDC to your wallet on base.",
  "estimatedArrival": "1-5 minutes after payment confirmation"
}

You: "Redeem referral code CLAWD2024"

{
  "success": true,
  "code": "CLAWD2024",
  "amount": 15,
  "currency": "USDC",
  "txHash": "0x1234...abcd",
  "recipientAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f...",
  "explorerUrl": "https://basescan.org/tx/0x1234...abcd",
  "message": "Successfully redeemed $15 USDC! Check your balance with x402_check_balance."
}

You: "Search for domains with 'myproject'"

{
  "query": "myproject",
  "results": [
    { "domain": "myproject.dev", "available": true, "first_year_price_usdc": "14.99" },
    { "domain": "myproject.xyz", "available": true, "first_year_price_usdc": "4.99" },
    { "domain": "myproject.com", "available": false }
  ]
}

You: "Buy myproject.xyz for John Doe, john@example.com"

{
  "success": true,
  "domain": "myproject.xyz",
  "status": "registered",
  "expires": "2027-02-01",
  "nameservers": ["ns1.porkbun.com", "ns2.porkbun.com"]
}

You: "Verify my identity for premium merchants"

{
  "success": true,
  "status": "verified",
  "agentId": "agent_abc123",
  "identityLevel": "kyc",
  "reputationScore": 50.0,
  "message": "Identity verified at KYC level. Premium merchants will now accept your payments."
}

1. "Add $50 to my wallet"                → Fund via Coinbase (card/bank)
2. "Check my balance"                    → Verify funds arrived
3. "Verify my identity"                  → Enable premium services
4. "Search for domains with 'myproject'" → Find a domain
5. "Buy myproject.xyz"                   → Purchase with USDC

1. "Redeem referral code CLAWD2024"     → Get $15 USDC free
2. "Check my balance"                    → Verify funds arrived
3. "Verify my identity"                  → Enable premium services

1. "Search for coolapp domains"          → Find available options
2. "Buy coolapp.dev for Jane Doe"        → Purchase domain
3. "Point coolapp.dev to 192.0.2.1"      → Create A record
4. "Add www.coolapp.dev as alias"        → Create CNAME record
5. "Show DNS for coolapp.dev"            → Verify configuration

1. "Find AI image services"              → Discover services
2. "Generate an image of a sunset"       → Pays automatically via x402
3. "Show my recent transactions"         → Review payments

# Coinbase Onramp (get from https://portal.cdp.coinbase.com/)
CDP_PROJECT_ID=your_project_id
CDP_API_KEY_NAME=organizations/your_org_id/apiKeys/your_key_id
CDP_API_KEY_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----
your_pkcs8_private_key_here
-----END PRIVATE KEY-----"

# Required for domain features
CLAWD_BACKEND_URL=https://clawd-domain-backend-production.up.railway.app

# TAP configuration
CLAWD_TAP_REGISTRY=https://tap-registry.visa.com/v1  # Production
CLAWD_TAP_MOCK_MODE=true                              # Demo mode (no real registry)

# Referral system (operators only)
CLAWD_TREASURY_PRIVATE_KEY=0x...                      # Treasury wallet for payouts

PORKBUN_API_KEY=pk1_...          # From porkbun.com/account/api
PORKBUN_SECRET=sk1_...           # From porkbun.com/account/api
TREASURY_ADDRESS=0x...           # Your wallet to receive domain payments
PUBLIC_URL=https://...           # Your Railway deployment URL
DATABASE_URL=sqlite:////tmp/clawd_domains.db  # Railway uses /tmp
ENVIRONMENT=production

{
  "mcpServers": {
    "clawd-wallet": {
      "command": "node",
      "args": ["/Users/you/clawd-wallet/dist/mcp-server/index.js"],
      "env": {
        "CDP_PROJECT_ID": "your_project_id",
        "CDP_API_KEY_NAME": "organizations/your_org_id/apiKeys/your_key_id",
        "CDP_API_KEY_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nYOUR_KEY_HERE\n-----END PRIVATE KEY-----",
        "CLAWD_BACKEND_URL": "https://clawd-domain-backend-production.up.railway.app",
        "CLAWD_TAP_MOCK_MODE": "true"
      }
    }
  }
}

┌─────────────────────────────────────────────────────────────┐
│  Claude Code / MCP Client                                   │
└─────────────────────────┬───────────────────────────────────┘
                          │ MCP Protocol (stdio)
                          ▼
┌─────────────────────────────────────────────────────────────┐
│  CLAWD Wallet MCP Server (22 tools)                         │
│  ├─ Wallet: balance, payments, history, funding             │
│  ├─ Referral: code redemption                               │
│  ├─ TAP: identity verification                              │
│  └─ Domains: search, purchase, DNS                          │
└──────────┬──────────────────────┬───────────────────────────┘
           │                      │
           │ USDC on Base         │ HTTPS
           ▼                      ▼
┌──────────────────┐    ┌────────────────────┐    ┌────────────────────┐
│  Base Network    │    │  Domain Backend    │    │  Coinbase CDP      │
│  (x402 services) │    │  (Railway/FastAPI) │    │  (Onramp API)      │
└──────────────────┘    └─────────┬──────────┘    └────────────────────┘
                                  │
                                  ▼
                        ┌────────────────────┐
                        │  Porkbun API       │
                        └────────────────────┘

# Build
npm run build

# Watch mode
npm run dev

# Run MCP server directly
node dist/mcp-server/index.js

# Run backend locally
cd backend
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
uvicorn src.main:app --port 8402 --reload

cd backend
railway login
railway init
railway up

# Set environment variables in Railway dashboard:
# PORKBUN_API_KEY, PORKBUN_SECRET, TREASURY_ADDRESS, PUBLIC_URL, DATABASE_URL

# Rebuild the project
npm run build

# Check the path in your MCP config matches your actual install location
ls /path/to/clawd-wallet/dist/mcp-server/index.js

export CLAWD_TREASURY_PRIVATE_KEY=0x...