DiegoPoveda01/local402

Charge in your currency. Receive exact USDC.
### English · Español
Local402 is x402 on Stellar for the rest of the world: a seller prices an API route
in their own currency — "1 MXN", "5 INR", "70 NGN", "0.05 EUR", "0.01 UF" — and a payer settles it with whatever
they hold: USDC, XLM or EURC. The seller always receives the exact USDC amount, in one transaction, with
no manual currency swap on either side.
| Demo video (3 min) | |
| Dashboard (testnet) | |
| Live API (Stellar mainnet) | |
| Scheme spec | docs/schemeexactfxstellar.md |
| npm | local402-pricing · local402-fx · local402-client · local402-server · local402-facilitator · local402-mcp |
| FxPay on mainnet | CA6Z4E55YN6LZEXBQPFCWUIMUJGAV42RLHYWWZ6SNIP4E73R2I2PUGHD |
| Real payments through it | XLM → USDC 0babefe1… and EURC → USDC bfe6a44d…, 2026-09-20 — each delivered exactly 0.0520721 USDC to the seller and refunded the unused input |
| An outside seller charging with it | kuyfi prices each scan at 500 CLP — the full paid flow on video (28 s) · testnet tx 44ef0d00… |
| Security | threat model · internal review — not audited, so mainnet settles only for the demo seller and from 0.01 USDC |
| Next 30 days | sprint plan: 1.0 packages, a deployable facilitator, an integration guide, kuyfi on 1.0 — each with its acceptance criterion |
| Reproducible build | release — wasm 69a12d89…, byte for byte what is deployed; Verified Build (SEP-55) on Stellar Lab |
| Bug found and fixed upstream | x402#3491 — mainnet rejects the fee the SDK bids; our fix, x402#3503, is merged |
## The problem
x402 lets an HTTP resource charge per request and lets an AI agent pay on its own. Today, though, the
price is a dollar amount settled in a single asset. Write price: "70 NGN" and the SDK fails.
That is not how commerce outside the US works. A Mexican API bills in pesos, an Indian one in rupees, a
Nigerian one in naira; a Chilean rental contract is denominated in UF, an inflation-indexed unit that
changes daily. And the customer pays with whatever is in their wallet, which is usually not the seller's
asset.
### Where it works today
Local402 prices in any currency the Reflector fiat oracle publishes on
mainnet (checked 2026-09-16), plus USD and the UF:
| Region | Currencies |
| Latin America | MXN, BRL, COP, PEN, ARS, CLP, CRC, VES |
| Africa | NGN, KES, ZAR, CDF |
| Asia | INR, JPY, CNY, KRW, PHP, HKD |
| Europe and North America | EUR, GBP, TRY, RUB, CAD |
A new currency needs no code: the day Reflector publishes it, localRoute("… XYZ") prices in it. The
demo sells one route per region (/latam in MXN, /asia in INR, /africa in NGN) next to the euro and
Chilean ones. Chile is the deepest example because of the UF, which shows that even an indexed unit
that is not a currency works the same way.
## What Local402 adds
Two independent layers. Either one is useful on its own.
1. Local-currency pricing (local402-pricing, local402-server).
The price stays in the seller's currency. The Reflector on-chain oracle
converts it to USDC at request time, rounding up so the seller never receives less than the local
price. The quote travels inside the standard 402 response as extra.local402, and the requirement