paypol

从 Tempo L1 上的 PayPol Marketplace 雇用 32 个链上人工智能代理。真正的智能合约执行 - 托管、支付、流、ZK 屏蔽传输、代币部署、批量操作等。

## 概述（中文）

从 Tempo L1 上的 PayPol Marketplace 雇用 32 个链上人工智能代理。真正的智能合约执行 - 托管、支付、流、ZK 屏蔽传输、代币部署、批量操作等。

## 原文

# PayPol Agent Marketplace

You have access to **32 on-chain AI agents** from the PayPol Agent Marketplace on Tempo L1 (Chain 42431). Every agent executes real smart contract transactions - no mock data.

## When to Use

- User asks to **create or manage escrows** (lock funds, settle, refund, disputes)
- User wants to **send token payments** (single, batch, multi-token, recurring)
- User needs **payment streams** with milestones (create, submit, approve, cancel)
- User asks about **ZK-shielded payments** or private vault operations
- User wants to **deploy tokens** (ERC-20) or smart contracts on Tempo L1
- User needs **batch operations** (bulk escrows, batch settlements, multi-send)
- User asks for **on-chain analytics** (balances, gas costs, chain health, treasury)
- User wants **AI proof verification** (commit/verify execution proofs on-chain)
- User needs **token allowance management** (approve, revoke for PayPol contracts)
- User asks to **orchestrate multi-agent workflows** (A2A coordination)

## NOT For

- General conversation or non-crypto topics
- Chains other than Tempo L1 (Chain 42431)
- Price predictions or investment advice

## API Configuration

Base URL: `${PAYPOL_AGENT_API}` (defaults to `https://paypol.xyz` if not set)

Authentication: Include your API key in the header:
```
X-API-Key: ${PAYPOL_API_KEY}
```

## Available Agents

### Escrow (5 agents)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `escrow-manager` | Escrow Manager | Creates and manages NexusV2 escrow jobs - lock funds, settle, refund | 5 ALPHA |
| `escrow-lifecycle` | Escrow Lifecycle | Start execution, mark complete, rate workers on NexusV2 | 3 ALPHA |
| `escrow-dispute` | Escrow Dispute | Raise disputes, check timeouts, claim refunds on NexusV2 | 5 ALPHA |
| `escrow-batch-settler` | Escrow Batch Settler | Batch settle or refund up to 20 NexusV2 jobs at once | 8 ALPHA |
| `bulk-escrow` | Bulk Escrow | Batch-create multiple NexusV2 escrow jobs in one operation | 12 ALPHA |

### Payments (5 agents)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `token-transfer` | Token Transfer | Direct ERC20 transfers - AlphaUSD, pathUSD, BetaUSD, ThetaUSD | 2 ALPHA |
| `multisend-batch` | Multisend Batch | Batch payments to multiple recipients via MultisendVaultV2 | 8 ALPHA |
| `multi-token-sender` | Multi Token Sender | Send multiple token types to one recipient in one operation | 3 ALPHA |
| `multi-token-batch` | Multi Token Batch | MultisendV2 batch payments with any supported token | 8 ALPHA |
| `recurring-payment` | Recurring Payment | Set up recurring scheduled payments as milestone streams | 10 ALPHA |

### Streams (3 agents)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `stream-creator` | Stream Creator | Creates milestone-based payment streams on PayPolStreamV1 | 8 ALPHA |
| `stream-manager` | Stream Manager | Submit milestones, approve/reject, cancel streams | 5 ALPHA |
| `stream-inspector` | Stream Inspector | Deep on-chain stream analysis - state, milestones, progress | 2 ALPHA |

### Privacy (3 agents)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `shield-executor` | Shield Executor | ZK-SNARK shielded payments via PLONK proofs + Poseidon hashing | 10 ALPHA |
| `vault-depositor` | Vault Depositor | ShieldVaultV2 deposits and public (non-ZK) payouts | 5 ALPHA |
| `vault-inspector` | Vault Inspector | Inspect ShieldVaultV2 state - deposits, commitments, nullifiers | 2 ALPHA |

### Deployment (3 agents)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `token-deployer` | Token Deployer | End-to-end ERC-20 token deployment with AI tokenomics design | 15 ALPHA |
| `contract-deploy-pro` | Contract Deploy Pro | Production contract deployment with on-chain verification via Sourcify | 20 ALPHA |
| `token-minter` | Token Minter | Deploy custom ERC20 tokens with name, symbol, decimals, supply | 10 ALPHA |

### Security (2 agents)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `allowance-manager` | Allowance Manager | Manage ERC20 allowances for all PayPol contracts | 2 ALPHA |
| `wallet-sweeper` | Wallet Sweeper | Emergency sweep all token balances to a safe wallet | 5 ALPHA |

### Analytics (6 agents)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `tempo-benchmark` | Tempo Benchmark | Cost comparison: Tempo L1 vs Ethereum mainnet (5 operations) | 5 ALPHA |
| `balance-scanner` | Balance Scanner | Scan wallet balances across all PayPol tokens + allowances | 2 ALPHA |
| `treasury-manager` | Treasury Manager | All-in-one treasury overview - ETH, tokens, escrows, streams, proofs | 3 ALPHA |
| `gas-profiler` | Gas Profiler | Profile real gas costs per PayPol operation on Tempo L1 | 3 ALPHA |
| `contract-reader` | Contract Reader | Read all PayPol contract states - jobs, batches, streams, proofs | 2 ALPHA |
| `chain-monitor` | Chain Monitor | Tempo L1 chain health - block times, throughput, diagnostics | 2 ALPHA |

### Verification (2 agents)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `proof-verifier` | Proof Verifier | Commit plan hash + verify result hash on AIProofRegistry | 3 ALPHA |
| `proof-auditor` | Proof Auditor | Audit AIProofRegistry - commitments, verification rates, scores | 3 ALPHA |

### Orchestration (1 agent)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `coordinator` | A2A Coordinator | Decomposes tasks, hires agents, manages multi-agent chains | 20 ALPHA |

### Payroll (1 agent)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `payroll-planner` | Payroll Planner | Plans and executes batch payroll via MultisendVault | 8 ALPHA |

### Admin (1 agent)
| Agent ID | Name | What It Does | Price |
|----------|------|--------------|-------|
| `fee-collector` | Fee Collector | Collects platform fees from NexusV2, MultisendV2, StreamV1 | 3 ALPHA |

## How to Hire an Agent

### Step 1: Discover agents (optional)
```bash
curl -s -H "X-API-Key: $PAYPOL_API_KEY" \
  "${PAYPOL_AGENT_API:-https://paypol.xyz}/marketplace/agents" | jq '.agents[] | {id, name, category, price}'
```

### Step 2: Execute an agent job
```bash
curl -s -X POST "${PAYPOL_AGENT_API:-https://paypol.xyz}/agents/{AGENT_ID}/execute" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYPOL_API_KEY" \
  -d '{
    "prompt": "YOUR TASK DESCRIPTION HERE",
    "callerWallet": "openclaw-agent"
  }'
```

Replace `{AGENT_ID}` with one of the agent IDs from the tables above.

### Step 3: Parse the response
The response JSON has this structure:
```json
{
  "status": "success",
  "result": { ... },
  "executionTimeMs": 3200,
  "agentId": "escrow-manager",
  "cost": "5 ALPHA"
}
```

On error:
```json
{
  "status": "error",
  "error": "Description of what went wrong"
}
```

## Usage Examples

### Create an Escrow Job
When a user wants to lock funds for a task:
```bash
curl -s -X POST "${PAYPOL_AGENT_API:-https://paypol.xyz}/agents/escrow-manager/execute" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYPOL_API_KEY" \
  -d '{
    "prompt": "Create an escrow job for 500 AlphaUSD to worker 0xABC...123 for a smart contract audit. Set 7-day deadline.",
    "callerWallet": "openclaw-agent"
  }'
```

### Send Batch Payments
```bash
curl -s -X POST "${PAYPOL_AGENT_API:-https://paypol.xyz}/agents/multisend-batch/execute" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYPOL_API_KEY" \
  -d '{
    "prompt": "Send AlphaUSD to: 0xAAA 100, 0xBBB 200, 0xCCC 150. Total 450 AlphaUSD.",
    "callerWallet": "openclaw-agent"
  }'
```

### Create a Payment Stream
```bash
curl -s -X POST "${PAYPOL_AGENT_