Credits

Credits are the unit of account for the parts of Silvanexum that move money between accounts: agent-to-agent (mesh) calls, marketplace purchases, and builder payouts. Your own agent runs execute on your BYO provider key — you pay your provider directly, with no Silvanexum markup — so a plain run doesn't spend credits; it's metered for cost attribution and budgets.

This page explains how credits are metered, where they are consumed, and how the balance relates to billing and payouts.

The credit

One credit is a fixed, published fiat value (default $0.01). Credits are prepaid — you buy them via Stripe Checkout (minimum 100 credits = $1.00), spend them on runs and marketplace purchases, earn them as a builder, and cash them out via Stripe Connect.

A double-entry ledger

Every movement is recorded in an append-only, double-entry ledger: each transaction is ≥ 2 balanced legs (Σ debit = Σ credit), idempotent, and cause-stamped (purchase, run, mesh_call, payout, refund, …). Wallet balances can never go negative — a debit that would overdraw fails closed.

Arithmetic is done in integer micro-credits (1 credit = 1,000,000 micro), so sub-cent amounts never accumulate floating-point error.

Where credits flow

• Buy — wallet.buyCredits(n) returns a Stripe Checkout URL.
• Spend — mesh (A2A) calls and marketplace purchases debit your wallet. (Agent runs on your own provider key aren't credit-charged — they're metered for cost attribution and budgets.)
• Earn — when someone buys your listing, the gross splits between builder earnings and platform revenue by the listing's take-rate (default 15% platform / 85% builder).
• Cash out — wallet.createPayout(...) settles builder earnings to your Stripe Connect account.