/ DOCUMENTATION
Build on the route
Everything you need to use RemitRoute as a person, or pay it as another agent. No em dashes, just hyphens. This is real money on Celo mainnet, so every value here is verifiable.
Quickstart
01
Open RemitRoute in MiniPay
It detects the wallet and auto-connects. No connect button.
02
Set a rule
Type it plainly, for example "save 10 percent every Friday". Confirm the parsed rule.
03
Fund the automation wallet
Sign one cUSD transfer. The agent runs everything after that. Withdraw any time.
Core concepts
EXECUTION WALLET
A dedicated automation wallet the agent runs from. You fund it and can withdraw any time.
SCHEDULE
A rule with a kind, params, a cadence, and a next-run time. Stored as the source of truth.
HEARTBEAT
The 20-minute loop that wakes the agent, runs due schedules, and posts metrics onchain.
Rule types
KINDPARAMSEXAMPLE
savings_sweeppercent, cadence, venue10% idle cUSD → Aave, Fridays
fx_rebalancetarget_weights, threshold40% cKES, rebalance weekly
remittanceto, amount, token, date5,000 cNGN on the 1st
dcaamount, asset, cadence$2 CELO daily
withdrawalamount, toreturn funds to MiniPay wallet
x402 FX-route API
Other agents pay RemitRoute per call for an optimal FX route and live rate. Each request settles onchain via x402 on Celo.
GET/api/fx-route$0.01 / call
# request
curl -H "X-PAYMENT: <sig>" \
https://remitroute.xyz/api/fx-route?from=cUSD&to=cKES
# 200 OK
{
"route": ["cUSD","cKES"],
"rate": 129.41,
"slippageBps": 50,
"settled": true
}
Onchain addresses
CELO MAINNET / CHAIN ID 42220
USDC0xcebA9300f2b948710d2653dD7B07f33A8B32118C
USDC adapter (gas)0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B
cUSD0x765DE816845861e75A25fCA122bb6898B8B1282a
ERC-8004 Identity0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
ERC-8004 Reputation0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
Mento Broker, exchange IDs, local-currency stablecoins, and the Aave V3 Pool are resolved at runtime. Verify every address on Celoscan before use.
Safety + caps
✓ SPEND CAPS
Per-user and global, every cycle.
✓ CIRCUIT BREAKER
Halts on anomaly.
✓ GAS FLOOR
Never drains the buffer.
✓ IDEMPOTENCY
No double execution.