Hi Celo community 👋
I'm Oluwafemi, building **AbaPay**, with support from a Prezenti Season 3 Frontier grant.
AbaPay is a set of payment rails that lets any AI agent pay real-world bills from its own Celo wallet in stablecoins. Today that covers Nigerian airtime, mobile data, electricity, cable TV and exam PINs. The bill is settled in naira on the other side, and the agent never touches fiat.
## How an agent pays
- **x402.** POST the bill to `https://agents.abapays.com/api/pay/x402` and get a `402` back with the exact price. Sign one EIP-3009 authorization in **USDC, USDâ‚® or USAâ‚® on Celo**, then retry. There's no account, no API key, and no CELO needed for gas.
- **MCP.** AbaPay is listed in the official MCP Registry as `io.github.investorphem/abapay`. Claude, Cursor and other MCP clients can check balances, pay, batch and schedule payments, with a bounded, revocable on-chain allowance.
- **A2A.** The same tools are exposed as an A2A agent.
## Identity
- **ERC-8004:** AbaPay is agent **#9687** on Celo.
- **Self Agent ID:** AbaPay is registered as Self agent **#196**.
- **Calling agents:** an agent can sign its own requests with its Self Agent ID. AbaPay checks the SelfAgentRegistry and records the payment as coming from a human-backed agent.
## For builders
- **SDKs:** `npm install abapay-sdk` (TypeScript) or `pip install abapay-sdk` (Python). Both include a Celo quickstart and Self Agent ID signing.
- **Reference agent (MIT):** https://github.com/investorphem/abapay-reference-agent
- Clone it, fund a Celo wallet with about $1 of USDC, and make your first payment in under 10 minutes.
- It has a spending cap that is checked before anything is signed.
- Plain-English requests through Claude are optional.
- **Docs:** https://docs.abapays.com
## What I'm looking for
1. **Agent builders on Celo** who want their agent to pay for something real. I'll help you integrate.
2. **Developers willing to try the reference agent** and tell me where the quickstart trips you up.
3. **Self Agent ID holders**, so we can show verified agents paying through the rails.
I'll post results here as we go: agents live, payments, wallets and volume, all verifiable on-chain.
Questions and feedback are welcome below, or reach me on Telegram [@investorphem](https://t.me/AbaPays), or on X at [@AbaPays](https://x.com/AbaPays).
Nice work on this. Checking the cap before anything is signed in the reference agent, and refusing a missing bill or a payer mismatch before settlement, are the right calls. I read through the repo and three things stood out.
-
The EIP-3009 authorization covers payer, payTo, value, window and nonce, but not the bill. The nonce comes from the client and a retry is matched on (payer, nonce), so whoever submits a signed
X-PAYMENTfirst decides which meter or phone gets the naira, as long as the bill fits the signed value andwallet_addressnames the signer. The agent’s own retry is then answered from that first row, SUCCESS included. The SDK setsvalidBeforeto now plusmaxTimeoutSeconds, which the challenge sets to 86400, so a header that ends up in agent logs or a tool transcript stays usable for a day. Returning a nonce in the 402 that you derive from the bill (serviceID, billersCode, amount and a quote id), refusing a retry whose body doesn’t match it, and a window of a few minutes would tie each payment to its bill. -
In AbaPayV3 the allowance caps how much the relayer can spend, not where it goes:
payBillFortakesaccountNumberfrom the relayer, and the allowance has no time window. A leaked relayer key could spend a user’s whole allowance on someone else’s meter, in back to backmaxAgentPaymentPerTxchunks. Letting users register payees on chain (a hash of serviceType and accountNumber) plus a daily limit keeps autopay working with far less at stake. -
The 24h withdrawal timelock is there for a stolen owner key, but
setMaxRefundandrefundUsertake effect immediately, in V3 and V4, so the refund cap can be raised and the vault sent to any address in two transactions. PuttingsetMaxRefundbehind the same delay, or the owner behind a multisig, keeps the timelock meaningful.