# AgentPay

> Pay-per-action AI agent services on Base. Every call is a KeeperHub workflow execution — paid in USDC via x402, settled onchain, with a full audit trail. The UI is one client; the rail is the product.

## Agent access

- Machine manifest: https://agentpay-ochre.vercel.app/.well-known/agent.json (also https://agentpay-ochre.vercel.app/api/manifest)
- Execution layer: KeeperHub. Payments: x402 v2, scheme "exact", USDC on Base (eip155:8453).
- Call pattern: POST the call URL with a JSON body → HTTP 402 with x402 requirements → sign an EIP-3009 TransferWithAuthorization for the exact amount → retry with the PAYMENT-SIGNATURE header → 200 with the result. The facilitator pays gas. The final response carries a base64 payment-response header containing the settlement tx hash.
- Any x402-capable client works. With @keeperhub/wallet: createPaymentSigner({ walletLoader }).fetch(callUrl, { method: "POST", body, paymentHint: "x402" }) pays automatically.
- Audit: every response includes an executionId. Step logs: KeeperHub MCP tool get_execution({ executionId }) at https://app.keeperhub.com/mcp.
- Billing note: executions are billed even when the workflow errors (e.g. passing a wallet to a token-contract read). Validate inputs first.

## Services

### Token Risk Analyzer — $0.05 / call

POST https://app.keeperhub.com/api/mcp/workflows/token-risk-analysis/call
Body: { "address": "<ERC-20 token contract on Base — a contract, not a wallet>" }
Returns: native balance of the contract, basescan link, success flag.

### Yield Scanner — $0.05 / call

POST https://app.keeperhub.com/api/mcp/workflows/yield-scanner/call
Body: { "address": "<wallet address>", "asset": "<token address on Base — USDC or WETH>" }
Returns: wallet ETH + USDC liquidity and the live Aave V3 supply APY for the requested asset (currentLiquidityRate in ray; divide by 1e25 for percent).

### Portfolio Analyzer — $0.05 / call

POST https://app.keeperhub.com/api/mcp/workflows/portfolio-rebalance/call
Body: { "address": "<wallet address>" }
Returns: ETH, USDC and WETH holdings snapshot (final node output is the WETH balance in wei; full per-node readout via get_execution).

## Payment details

- x402 v2 · scheme exact · asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · payTo per challenge
- EIP-3009 TransferWithAuthorization — signed offline, no gas needed by the payer
- Settlement is a plain USDC transfer on Base, verifiable on BaseScan

## Identity

ERC-8004 agent #31875 (Ethereum mainnet) — https://8004scan.io/agents/ethereum/31875
Feedback: rate executions on the ReputationRegistry via the keeperhub-wallet feedback tool.