doubleentry 0.8.0

An immutable, tamper-evident double-entry bookkeeping engine: one pure rule core, exact integer money, identity derived from the idempotency key, and one append-only RFC 6962 Merkle log with inclusion, consistency and sealed-balance proofs and C2SP checkpoints, in memory (sync) or over SQLite and PostgreSQL (async).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

//! An invoice, a partial payment, and the open item that remains.
#![allow(clippy::indexing_slicing)] // an example asserts its outcomes; the library never panics
use doubleentry::prelude::*;

const AR: &str = "Assets:Receivables:Customer-42";
const START: Date = date!("2026-01-01");

fn main() -> Result<()> {
    let mut books = Journal::new(LedgerId::new("example.com/acme")?);
    books.declare_currency(EUR, 2, START)?;
    books.define_months(2026, 1..=12)?;
    books.open(AR, AccountKind::Asset, START)?;
    books.open("Assets:Bank", AccountKind::Asset, START)?;
    books.open("Income:Sales", AccountKind::Income, START)?;
    books.open("Liabilities:VAT", AccountKind::Liability, START)?;

    let invoice = books.record(
        Entry::new("INV-1", date!("2026-03-01"))
            .document(Document::new("invoice", "INV-1")?)
            .debit(AR, amount!("1190.00"), EUR)
            .credit("Income:Sales", amount!("1000.00"), EUR)
            .credit("Liabilities:VAT", amount!("190.00"), EUR),
    )?;
    let (paid, on) = (amount!("500.00"), date!("2026-03-10"));
    let payment = books.record(
        Entry::new("PAY-1", on)
            .debit("Assets:Bank", paid, EUR)
            .credit(AR, paid, EUR),
    )?;
    let debit = PostingRef::at(invoice.id, 0); // the invoice's receivable leg
    let credit = PostingRef::at(payment.id, 1); // the payment's receivable leg
    books.clear("CLR-1", debit, credit, paid, on)?;

    let open = books.open_items(AR, EUR, &BalanceQuery::all())?;
    assert_eq!(open[0].residual, amount!("690.00"));
    println!("{}", open[0]); // INV-1  2026-03-01  debit 1190.00  open 690.00
    Ok(())
}