Rulvar API reference

---

Rulvar API reference / @rulvar/core / foldLedger

Function: foldLedger()

function foldLedger(
   entries, 
   abandonFold, 
   priceUsd?): Ledger;

Defined in: packages/core/src/journal/replayer.ts:89

The budget ledger fold as a PURE function over entries (extracted in RV1209 so an offline reader folds the identical arithmetic instead of a lookalike): usage sums over terminal entries once, never twice; agentsSpawned counts agent dispatches. Dollars fold on the settled billing basis (RV801): per provider call where the entry's records cover its usage, the per-slice aggregate otherwise, the same basis as the CostReport and the invoice.

Parameters

Parameter	Type
entries	readonly JournalEntry[]
abandonFold	AbandonFold
priceUsd?	(servedBy, usage, seq?) => number | undefined

Returns

Ledger