wallet · all services · valuation method · live valuation

Clearing House Ledger LIVE

qvtx_clearing.py

What it is

The double-entry settlement ledger. QVTX is the clearing house: value actually moves here. Intra-house transfers settle instantly; the house always nets to zero.

How it works

Append-only, hash-chained journal at ~/.qvtx_clearing/journal.jsonl (fcntl-locked = atomic).
Every posting is balanced (legs sum to zero). EXTERNAL account = the omnibus float.
pay_in credits a member (debits EXTERNAL); clear moves member->member instantly; pay_out debits a member (credits EXTERNAL).
settle_batch nets positions and anchors a settlement root on Chain 42000.

API

endpoint	notes
`GET /api/trial`	house trial balance (must net to zero)
`GET /api/statement?label=<m>`	full transaction history for a member

CLI

qvtx_clearing.py open <member>
qvtx_clearing.py payin <member> <qvtx> [ref]
qvtx_clearing.py clear <from> <to> <qvtx> [ref]
qvtx_clearing.py payout <member> <qvtx> [ref]
qvtx_clearing.py balance <member> | statement <member> | trial | settle

Example

clear alice->bob 250  ->  alice 750, bob 250, house nets to zero (instant)

What's real: REAL. Instant intra-house settlement verified; double-entry integrity holds with fees applied.

← all services