Billing engines like Metronome calculate the bill at the end of the month. Base Ledger enforces real-time budget limits in less than 5ms. Stop race conditions, eliminate double-spending, and prevent AI agents from bankrupting your API budget.
Why eventual consistency fails for pre-paid SaaS.
Built on Apache Pekko and Event Sourcing. Wallet state lives in memory on a single Actor. Zero row-level database locking. Double-spending is mathematically impossible.
Standard metering tools buffer events in Kafka. We authorize or hard-reject transactions in milliseconds. The moment a user's token balance hits zero, the API call is blocked.
The Open-Source core uses PostgreSQL for zero-friction local deployment. When your AI agents go viral, seamlessly upgrade to our fully-managed DynamoDB Cloud infrastructure. Same API, infinite scale.
Billing platforms are built for eventual consistency. They are post-paid. Base Ledger is an OLTP authorization engine built for pre-paid limits. We guarantee the wallet balance, authorize the transaction in real-time, and pass the clean data to your billing engine.
Send an atomic JSON payload to Add, Reserve, or Spend tokens for a specific wallet.
Engine validates balances and appends to the immutable log.
Balances update instantly. Webhooks fire to your application.
The infrastructure layer you can trust with real money.
Encrypted at rest and in transit. Role-based access control (RBAC) baked in.
Safe retries. We guarantee that a transaction is processed exactly once.
Every transaction is an immutable event. Perfect cryptographic audit trails for your finance and compliance teams.
Fault-tolerant, multi-AZ cloud architecture ensures your ledger stays online. (Up to 99.999% SLA available on Enterprise BYOC).
Query financial state instantly. No ETLs or overnight batch jobs required.
Listen for real-time events. Dispatch immutable webhooks without manual polling infrastructure.
Connect to your ledger instance securely. All requests are authenticated using your API key.
Place a temporary hold on the user's tokens before starting an expensive AI generation process.
Once the generation is successful, capture the held tokens. Add metadata to track feature usage.
// 1. Initialize Ledger const ledger = new BaseLedger('bl_live_...');// 2. Reserve Tokens for AI Prompt const hold = await ledger.wallet("usr_881").reserve({ "idempotencyKey": "req_5512", "holdId": "prompt_99x", "amount": 150, "ttlSeconds": 60, "metadata": { "model": "gpt-4-turbo" } });// 3. AI Generation Successful -> Spend Tokens const result = await client.wallet("usr_881").spend({ "idempotencyKey": "req_5513", "holdId": "prompt_99x", "amount": 123, "metadata": { "feature": "image_generation" } }); console.log(result.availableBalance);
Meter token usage per prompt with exact precision.
Hold funds, split payments, and handle payouts.
In-game currency systems that can't be glitched.
Loyalty points systems with audit trails.
The financial layer for modern apps.