# Send A2A SHIB Payment System to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "a2a-shib-payments",
    "name": "A2A SHIB Payment System",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/marcus20232023/a2a-shib-payments",
    "canonicalUrl": "https://clawhub.ai/marcus20232023/a2a-shib-payments",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/a2a-shib-payments",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=a2a-shib-payments",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "AWESOME-LISTS.md",
      "CONTRIBUTING.md",
      "DEPLOYMENT.md",
      "ESCROW-NEGOTIATION-GUIDE.md",
      "FINAL-SUMMARY.md",
      "INTEGRATION-EXAMPLES.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/a2a-shib-payments"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/a2a-shib-payments",
    "downloadUrl": "https://openagent3.xyz/downloads/a2a-shib-payments",
    "agentUrl": "https://openagent3.xyz/skills/a2a-shib-payments/agent",
    "manifestUrl": "https://openagent3.xyz/skills/a2a-shib-payments/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/a2a-shib-payments/agent.md"
  }
}
```
## Documentation

### A2A SHIB Payment System - OpenClaw Skill

Framework-agnostic agent-to-agent payment infrastructure on Polygon network.

### Summary

This skill enables AI agents to:

💰 Send/receive SHIB payments on Polygon (~$0.003 gas)
🔒 Create trustless escrow contracts
💬 Negotiate prices automatically (multi-round)
⭐ Build reputation through ratings
🌐 Discover other agents via A2A protocol

9,416x cheaper than traditional escrow services (Escrow.com charges $28.25 per $100, this costs $0.003).

### Payment System

Direct SHIB transfers on Polygon
Sub-penny gas costs (~$0.003)
Balance checking
Transaction history

### Escrow System

Time-locked trustless payments
Multi-party approval required
Delivery proof submission
Automatic release when conditions met
Dispute resolution with arbiter
6-state machine: pending → funded → locked → released/refunded/disputed

### Price Negotiation

Service quote creation
Multi-round counter-offers
Accept/reject workflow
Automatic escrow integration
Service delivery tracking

### Reputation System

Star ratings (0-5) with reviews
Dynamic trust scores (0-100)
Trust levels: new → bronze → silver → gold → platinum
Achievement badges
Agent verification

### Security Layer

API key authentication (64-byte keys)
Rate limiting (requests + payments + volume)
Immutable audit logging (hash-chained)
Per-agent permissions & limits

### Installation

# Via ClawHub
clawhub install a2a-shib-payments

# Or manual clone
cd ~/clawd/skills
git clone https://github.com/marcus20232023/a2a-shib-payments.git
cd a2a-shib-payments
npm install

### Configuration

Create .env.local:

cp .env.example .env.local
nano .env.local

Required environment variables:

WALLET_PRIVATE_KEY - Your Polygon wallet private key
RPC_URL - Polygon RPC endpoint (default: https://polygon-rpc.com)
SHIB_CONTRACT_ADDRESS - SHIB token contract (default: 0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce)

### Start the Agent

node a2a-agent-full.js

Agent runs on port 8003 by default.

### OpenClaw Integration

The agent exposes A2A protocol endpoints that OpenClaw can communicate with:

Agent Card: http://localhost:8003/.well-known/agent-card.json

Example commands from OpenClaw:

// Check balance
const result = await fetch('http://localhost:8003/a2a/jsonrpc', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'message/send',
    params: {
      message: {
        kind: 'message',
        messageId: '1',
        role: 'user',
        parts: [{kind: 'text', text: 'balance'}]
      }
    },
    id: 1
  })
});

// Send payment
// text: 'send 100 SHIB to 0x...'

// Create escrow
// text: 'escrow create 500 SHIB for data purchase payee data-agent'

// Check reputation
// text: 'reputation check data-agent'

### Framework Compatibility

Works with:

✅ OpenClaw - As a skill or standalone agent
✅ LangChain - Via A2A tools
✅ AWS Bedrock - Via agent invocation
✅ AutoGen - Via A2A messaging
✅ Any A2A-compatible system

See INTEGRATION-EXAMPLES.md for detailed integration guides.

### Data Marketplace

// Research agent buys Tesla historical data
const quote = await negotiation.createQuote({
  service: 'TSLA 2020-2025 historical data',
  price: 500  // SHIB
});

// Counter-offer and accept
await negotiation.counterOffer(quote.id, 'research-agent', 400);
await negotiation.acceptCounter(quote.id, 'data-provider');
// Escrow created automatically

### AI Model Training

// Create escrow for model training job
const escrow = await escrowSystem.create({
  payer: 'startup-agent',
  payee: 'ai-trainer',
  amount: 1000,
  purpose: 'Train GPT-style model',
  conditions: {requiresDelivery: true},
  timeoutMinutes: 720  // 12 hours
});

### A2A Protocol

/.well-known/agent-card.json - Agent capabilities
/a2a/jsonrpc - JSON-RPC messaging
/a2a/rest/* - REST API

### Commands (via message text)

balance - Check SHIB balance
send [amount] SHIB to [address] - Send payment
escrow create [amount] SHIB for [purpose] payee [agent] - Create escrow
escrow fund [id] - Fund escrow
escrow release [id] - Release funds
quote create [service] [price] - Create price quote
reputation check [agentId] - Check agent reputation
rate [agentId] [1-5] [review] - Rate an agent

### Testing

# Run all tests
npm test

# Individual test suites
npm run test:security
npm run test:escrow
npm run test:reputation

### Files

Core Systems:

a2a-agent-full.js - Full-featured agent (port 8003)
index.js - Payment agent core
escrow.js - Escrow system
payment-negotiation.js - Negotiation workflow
reputation.js - Reputation & trust

Security:

auth.js - API authentication
rate-limiter.js - Rate limiting
audit-logger.js - Audit logging

Documentation:

README.md - Project overview
INTEGRATION-EXAMPLES.md - Framework integration guides
ESCROW-NEGOTIATION-GUIDE.md - API reference
PRODUCTION-HARDENING.md - Security guide
DEPLOYMENT.md - Deployment options

### Security

Implemented:

✅ API key authentication
✅ Rate limiting (10 req/min, 3 payments/min, 500 SHIB/min volume)
✅ Immutable audit logs (hash-chained)
✅ Per-agent permissions
✅ Escrow time-locks
✅ Multi-party approval

Recommended for Production:

Multi-sig wallet
HTTPS (Cloudflare/Let's Encrypt)
Firewall rules
Automated backups
Monitoring & alerting

See PRODUCTION-HARDENING.md for complete guide.

### Quick Local

./deploy-local.sh

### Production Options

Systemd service (auto-start on boot)
Cloudflare Tunnel (free HTTPS)
Docker container
VPS ($6/month)

See DEPLOYMENT.md for complete guide.

### Cost Comparison

SystemFeeSettlementTrustEscrow.com$28.255-7 daysCentralizedPayPal$3.201-3 daysCentralizedThis System$0.003SecondsDecentralized

For a $100 transaction: 99.99% savings (9,416x cheaper)

### Links

GitHub: https://github.com/marcus20232023/a2a-shib-payments
Release: https://github.com/marcus20232023/a2a-shib-payments/releases/tag/v2.0.0
A2A Protocol: https://a2a-protocol.org
Issues: https://github.com/marcus20232023/a2a-shib-payments/issues

### License

MIT License - Free for commercial and personal use

### Version

v2.0.0 - Production Ready

Built with 🦪 for the agent economy
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: marcus20232023
- Version: 2.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/a2a-shib-payments)
- [Send to Agent page](https://openagent3.xyz/skills/a2a-shib-payments/agent)
- [JSON manifest](https://openagent3.xyz/skills/a2a-shib-payments/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/a2a-shib-payments/agent.md)
- [Download page](https://openagent3.xyz/downloads/a2a-shib-payments)