Hackathon · 2026

Agent Allowance

A spending account for an AI agent. Rules decide first; your Ledger signs the exceptions.

njoku.dev/agent-allowance
Agent Allowance’s home screen. A teal gauge disk shows 0.14 RLUSD left of a 0.20 budget, with limit tiles, a payment path, and recent activity underneath.

Try it

Try the allowance here.

Same dashboard as the hackathon demo. Run agent walks the story with simulated payments; approvals use a labeled simulated Ledger signature. Nothing leaves your browser.

njoku.dev/agent-allowanceOpen in a new tab
Agent Allowance’s home screen. A teal gauge disk shows 0.14 RLUSD left of a 0.20 budget, with limit tiles, a payment path, and recent activity underneath.

Simulated payments · stays in this browser

Would you give an AI your credit card? Agent Allowance is a spending account for an AI agent. You fund a small budget — 0.20 RLUSD in the demo. The agent pays a merchant on its own only when the quote is from a merchant on your list, at or under a 0.05 RLUSD cap per purchase, before the allowance ends, and still inside the budget. Anything else waits for you, and your Ledger approves it.

Payments are AP4M x402 vouchers settling RLUSD on XRPL EVM Testnet (chain ID 1449000). Built for the Mastercard × XRPL Hackathon, Agentic Finance track.

A playable public demo runs on this site at /agent-allowance/. Approvals use a labeled simulated Ledger signature, and Run agent records simulated payments in your browser — nothing is broadcast. The full source is on GitHub.

What you can do

  • See remaining budget as a gauge disk, the five limits as tiles, spend by merchant, and the latest activity.
  • Set it up in a minute: name the agent, set the budget and cap, choose merchants, pick an end date, and connect a Ledger as the approver.
  • Understand every hold: which rule a purchase hit, how far over the cap it is, and exactly what the Ledger signs.
  • Ask Eve anything about the account. She reads; the only actions she can propose are a freeze and a decline, which you confirm.
  • Freeze everything at once. Unfreeze is one obvious button away.

How it works

  1. Rules first. checkRules reads the merchant’s HTTP 402 quote and stops at the first failure: expired, merchant not allowed, over the cap, or over the budget. Nothing is signed on a failure.
  2. Jev, second. Optional risk review can hold a quote for a person after the rules allow it. Jev cannot spend past a rule.
  3. AP4M x402. The agent reuses an open Channel, signs one voucher, and the merchant redeems it on XRPL EVM Testnet.
  4. Ledger for exceptions. Out-of-rule purchases and allowance raises need EIP-712 signatures (ApprovePurchase, SetAllowance). Lowering a limit applies without a signature.

Run it

You need Node.js 22.13 or newer. From the repo:

cp .env.example .env
npm start    # API :8787, dashboard :5173

Or deploy the hosted public demo from render.yaml — every visitor gets a private sandbox, and approvals use a clearly labeled simulated Ledger signature.

npm test
npm --prefix dashboard run build
Play the Kilobyte demoOpens in a new tab
KilobyteCase study
Play the Agent Allowance demoOpens in a new tab
Agent AllowanceHackathon
Play the OrbitScope demoOpens in a new tab
OrbitScopePersonal project
njoku.devPersonal project
Python & Java practiceIndependent study
HomePage
All projectsPage
AboutSection
ExperienceSection
SkillsSection
ContactSection
EducationSection
RésuméPrintable
Send me a messageContact form
Switch light / dark themeAppearance
GitHub@michaelnjoku347
LinkedInProfile
View this site’s sourceGitHub