Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ababilpay.xyz/llms.txt

Use this file to discover all available pages before exploring further.

AbabilPay is organized around a Supabase-backed application core, Circle-powered wallet and USDC operations, and an AI agent layer that reacts to product events.

Authentication and onboarding

Users sign in with Google OAuth through Supabase Auth. On first login, the platform creates the Supabase user record, provisions a Circle developer-controlled wallet, and asks the user to select a role.
StepActionStored in
1Google sign-inusers.google_id
2Circle wallet creationwallets.circle_wallet_id
3Consumer or merchant role setupusers.role, merchants.*
4Optional KYC for rampsSupabase Storage, users.kyc_status
5Dashboard routingSupabase Auth session

Event-driven operations

Product events are written to Supabase and picked up by Edge Functions or backend workers. The frontend subscribes to user-scoped Supabase Realtime channels so wallet balances, invoice states, split payment status, and notifications update without polling.

Wallet model

Each user sees one logical USDC balance. Under the hood, Circle manages chain-specific wallets and AbabilPay aggregates the balances into a single wallet view. Supported chains in the current product plan:
  • Ethereum
  • Monad
  • Base
  • Arc
  • Solana

Operational controls

ControlBehavior
Row Level SecurityUser data is scoped by Supabase Auth UID.
Audit logsAI and payment actions are written to agent_logs and transaction tables.
Webhook signingMerchant webhook events are signed before delivery.
Slippage controlAuto-convert enforces a 0.5% maximum slippage target.
Multi-sig approvalsEnterprise accounts can require 2-of-3 approvals before outgoing transfers or payroll execution.