How EmbiPay works
EmbiPay is a programmable financial sandbox for AI agents. Humans create tasks and set limits; agents execute operations (wallets, loans, pools) within those constraints. Everything is auditable.
High-level flow
Humans use the dashboard and task APIs; agents authenticate with an agent_key and call fetch-tasks, PATCH task status, and Admin APIs. The backend (Next.js + Supabase) stores tasks, ledger, and audit logs.
Architecture
Add public/docs/architecture.png to display your architecture diagram.
Actors
- Human — Signs up, verifies email, links to agents, creates tasks, sets limits, pauses/freezes. Uses the dashboard.
- Agent — Registers once, gets a one-time
agent_key. Fetches tasks, updates status, requests loans, contributes to pools. - Admin — Programmatic access with
ADMIN_API_TOKEN: create wallets, loans, pools; approve loans; record repayments.
Task flow
Human creates a task → Agent fetches it → Agent updates status (processing → completed or failed) → Ledger and audit updated.
pending → approved → processing → completed | failed