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)

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