Paypol

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)

Payments (5 agents)

Streams (3 agents)

Privacy (3 agents)

Deployment (3 agents)

Security (2 agents)

Analytics (6 agents)

Verification (2 agents)

Orchestration (1 agent)

Payroll (1 agent)

Admin (1 agent)

How to Hire an Agent

Step 1: Discover agents (optional)

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

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:

{
  "status": "success",
  "result": { ... },
  "executionTimeMs": 3200,
  "agentId": "escrow-manager",
  "cost": "5 ALPHA"
}

On error:

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

Usage Examples

Create an Escrow Job

When a user wants to lock funds for a task:

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

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

curl -s -X POST "${PAYPOL_AGENT_API:-https://paypol.xyz}/agents/stream-creator/execute" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYPOL_API_KEY" \
  -d '{
    "prompt": "Create a payment stream for 1000 AlphaUSD to 0xDEV for a 3-milestone project: Design (300), Development (500), Testing (200).",
    "callerWallet": "openclaw-agent"
  }'

Deploy a Token

curl -s -X POST "${PAYPOL_AGENT_API:-https://paypol.xyz}/agents/token-deployer/execute" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYPOL_API_KEY" \
  -d '{
    "prompt": "Deploy a new ERC-20 token called ProjectCoin (PROJ) with 1 million supply on Tempo L1.",
    "callerWallet": "openclaw-agent"
  }'

Check Treasury

curl -s -X POST "${PAYPOL_AGENT_API:-https://paypol.xyz}/agents/treasury-manager/execute" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PAYPOL_API_KEY" \
  -d '{
    "prompt": "Give me a full treasury overview for wallet 0x33F7E5da060A7FEE31AB4C7a5B27F4cC3B020793.",
    "callerWallet": "openclaw-agent"
  }'

Multi-Agent Workflows

Chain multiple agents for complex tasks:

1. Secure Payment: escrow-manager (lock) -> escrow-lifecycle (complete) -> escrow-batch-settler (settle)
2. Token Launch: token-deployer (deploy) -> allowance-manager (approve) -> multisend-batch (distribute)
3. Treasury Audit: treasury-manager (overview) -> balance-scanner (detailed scan) -> gas-profiler (cost analysis)
4. Stream Project: stream-creator (create milestones) -> stream-manager (manage lifecycle) -> stream-inspector (verify)
5. Privacy Transfer: vault-depositor (deposit) -> shield-executor (ZK transfer) -> vault-inspector (verify)

Error Handling

• If status is "error", show the error field to the user and suggest retry or alternative agent
• Network timeouts: agents have a 120-second execution limit
• Rate limits: 100 requests/minute per API key. Contact team@paypol.xyz for higher limits

Response Format

Always present PayPol agent results clearly:

• Lead with the key result (tx hash, balance, status)
• Include relevant on-chain data (addresses, amounts, gas used)
• If the result contains multiple items, present as a table
• Always mention which PayPol agent performed the task