Ledger Overview
This document describes the account sets created by the credit module on initialization, their accounting context, and the transaction templates that structure the flow of funds between accounts.
Collateral in Liquidation
Collateral remains borrower-owned and off balance sheet while it is sent for liquidation. Sending collateral moves both the BTC amount and its functional-currency carrying value at the send-time exchange rate between memorandum accounts only. When the executed collateral sale is recorded, the ledger clears those same BTC and functional-currency amounts from the memorandum accounts and recognizes the reported net proceeds as a receivable. Recording the sale does not mean the cash has settled. This flow does not transfer ownership to the bank or recognize a repossessed Asset.
Finalizing the sale recognizes the reported net proceeds without asserting that cash has settled: it debits a per-liquidation proceeds receivable, grouped under the product's Asset/Debit liquidation-proceeds account set, and credits the facility's Liability/Credit borrower-proceeds account. Cash settlement, wire processing, and any related FX conversion are outside this workflow.
The system then applies an internal recovery equal to the lesser of net sale proceeds and collectible obligations. It debits the borrower-proceeds Liability and credits payment holding using the sale's effective date, after which the normal payment-allocation waterfall applies the recovery to obligations. Proceeds above collectible debt remain as a borrower Liability; when proceeds are insufficient, all proceeds leave that Liability and the unpaid balance remains collectible debt.
Omnibus Account Sets
Omnibus account sets group product-wide positions. Most contain one shared off-balance-sheet account. The liquidation-proceeds omnibus is an Asset account set containing one receivable per recorded collateral sale.
Facility
Ref: credit-facility-omnibus-account-set
Name: Credit Facility Omnibus Account Set
Purpose: Tracks total credit line commitments across all facilities
Category: Off-Balance Sheet
Normal Balance: Debit
Account Creation: Shared (1 account: credit-facility-omnibus-account)
Collateral
Ref: credit-collateral-omnibus-account-set
Name: Credit Collateral Omnibus Account Set
Purpose: Tracks total collateral deposited across all facilities
Category: Off-Balance Sheet
Normal Balance: Debit
Account Creation: Shared (1 account: credit-collateral-omnibus-account)
────────────────────────────────────────
Ref: credit-facility-liquidation-proceeds-omnibus-account-set
Name: Credit Facility Liquidation Proceeds Omnibus Account Set
Purpose: Groups liquidation-sale receivables across all facilities
Category: Asset
Normal Balance: Debit
Account Creation: Product-level set with one receivable per liquidation
Interest
Ref: credit-interest-added-to-obligations-omnibus-account-set
Name: Credit Interest Added to Obligations Omnibus Account Set
Purpose: Tracks total posted interest added to borrower obligations
Category: Off-Balance Sheet
Normal Balance: Debit
Account Creation: Shared (1 account: credit-interest-added-to-obligations-omnibus-account)
Payments
Ref: credit-payments-made-omnibus-account-set
Name: Credit Payments Made Omnibus Account Set
Purpose: Tracks total payments received across all facilities
Category: Off-Balance Sheet
Normal Balance: Credit
Account Creation: Shared (1 account: credit-payments-made-omnibus-account)
Summary Account Sets
Summary account sets aggregate balances and transactions from accounts created per credit facility. Their category and normal balance depend on the economic position represented; they are not uniformly off balance sheet.
Facility
Ref: credit-facility-remaining-account-set
Name: Credit Facility Remaining Account Set
Purpose: Tracks undrawn facility balance
Category: Off-Balance Sheet
Normal Balance: Credit
Account Creation: Per-facility
────────────────────────────────────────
Ref: credit-uncovered-outstanding-account-set
Name: Credit Uncovered Outstanding Account Set
Purpose: Tracks outstanding amount not yet covered by an unapplied payment
Category: Off-Balance Sheet
Normal Balance: Credit
Account Creation: Per-facility
Collateral
Ref: credit-collateral-account-set
Name: Credit Collateral Account Set
Purpose: Tracks collateral pledged to the facility
Category: Off-Balance Sheet
Normal Balance: Credit
Account Creation: Per-facility
────────────────────────────────────────
Ref: credit-facility-collateral-in-liquidation-account-set
Name: Credit Facility Collateral In-Liquidation Account Set
Purpose: Tracks collateral in active liquidation
Category: Off-Balance Sheet
Normal Balance: Credit
Account Creation: Per-facility
────────────────────────────────────────
Ref: credit-facility-liquidated-collateral-account-set
Name: Credit Facility Liquidated Collateral Account Set
Purpose: Tracks collateral that has been liquidated
Category: Off-Balance Sheet
Normal Balance: Credit
Account Creation: Per-facility
────────────────────────────────────────
Ref: credit-facility-proceeds-from-liquidation-account-set
Name: Credit Facility Proceeds From Liquidation Account Set
Purpose: Tracks sale proceeds owed to the borrower after collateral liquidation
Category: Liability
Normal Balance: Credit
Account Creation: Per-facility
Short-Term Disbursed Receivable
All sets in this group are Asset category, Debit normal balance, per-facility.
Ref pattern: short-term-credit-{type}-disbursed-receivable-account-set
Purpose: Tracks principal owed on short-term facilities, by customer type.
Where {type} is one of: individual, government-entity, private-company, bank, financial-institution, foreign-agency-or-subsidiary, non-domiciled-company.
Long-Term Disbursed Receivable
All sets in this group are Asset category, Debit normal balance, per-facility.
Ref pattern: long-term-credit-{type}-disbursed-receivable-account-set
Purpose: Tracks principal owed on long-term facilities, by customer type.
Where {type} is one of: individual, government-entity, private-company, bank, financial-institution, foreign-agency-or-subsidiary, non-domiciled-company.
Overdue Disbursed Receivable
All sets in this group are Asset category, Debit normal balance, per-facility.
Ref pattern: overdue-credit-{type}-disbursed-receivable-account-set
Purpose: Tracks principal past due, by customer type.
Where {type} is one of: individual, government-entity, private-company, bank, financial-institution, foreign-agency-or-subsidiary, non-domiciled-company.
Defaulted Receivable
Ref: credit-disbursed-defaulted-account-set
Name: Credit Disbursed Defaulted Account Set
Purpose: Tracks defaulted principal
Category: Asset
Normal Balance: Debit
Account Creation: Per-facility
────────────────────────────────────────
Ref: credit-interest-defaulted-account-set
Name: Credit Interest Defaulted Account Set
Purpose: Tracks defaulted interest
Category: Asset
Normal Balance: Debit
Account Creation: Per-facility
Short-Term Interest Receivable
All sets in this group are Asset category, Debit normal balance, per-facility.
Ref pattern: short-term-credit-{type}-interest-receivable-account-set
Purpose: Tracks interest owed on short-term facilities, by customer type.
Where {type} is one of: individual, government-entity, private-company, bank, financial-institution, foreign-agency-or-subsidiary, non-domiciled-company.
Long-Term Interest Receivable
All sets in this group are Asset category, Debit normal balance, per-facility.
Ref pattern: long-term-credit-{type}-interest-receivable-account-set
Purpose: Tracks interest owed on long-term facilities, by customer type.
Where {type} is one of: individual, government-entity, private-company, bank, financial-institution, foreign-agency-or-subsidiary, non-domiciled-company.
Revenue
Ref: credit-interest-income-account-set
Name: Credit Interest Income Account Set
Purpose: Recognized interest revenue
Category: Revenue
Normal Balance: Credit
Account Creation: Per-facility
────────────────────────────────────────
Ref: credit-fee-income-account-set
Name: Credit Fee Income Account Set
Purpose: Recognized fee revenue (structuring fees)
Category: Revenue
Normal Balance: Credit
Account Creation: Per-facility
Payment Holding
Ref: credit-payment-holding-account-set
Name: Credit Payment Holding Account Set
Purpose: Temporarily holds payments that are waiting to be applied to obligations
Category: Asset
Normal Balance: Credit
Account Creation: Per-facility
Transaction Templates
Columns to the right of Template Code represent account sets involved in the transaction. A cell value indicates that the template debits (DR) or credits (CR) an account from that account set, on the Settled or Pending layer. Empty cells mean the template does not involve that account set.
Facility
┌─────────────────────────────────────┬──────────────────────┬──────────────────────┐
│ Template Code │ Facility Omnibus │ Facility Remaining │
├─────────────────────────────────────┼──────────────────────┼──────────────────────┤
│ CREATE_CREDIT_FACILITY_PROPOSAL │ DR (Pending) │ CR (Pending) │
├─────────────────────────────────────┼──────────────────────┼──────────────────────┤
│ ACTIVATE_CREDIT_FACILITY │ CR (Pending) │ DR (Pending) │
│ │ DR (Settled) │ CR (Settled) │
└─────────────────────────────────────┴──────────────────────┴──────────────────────┘
Disbursals
┌──────────────────────────┬─────────────┬─────────────┬─────────────┬──────────────────┐
│ Template Code │ Facility │ Uncovered │ Disbursed │ Deposit Omnibus │
│ │ Remaining │ Outstanding │ Receivable │ (external) │
├──────────────────────────┼─────────────┼─────────────┼─────────────┼──────────────────┤
│ INITIATE_CREDIT_FACILITY │ DR (Settled)│ CR (Settled)│ │ │
│ _DISBURSAL │ CR (Pending)│ DR (Pending)│ │ │
├──────────────────────────┼─────────────┼─────────────┼─────────────┼──────────────────┤
│ SETTLE_DISBURSAL │ DR (Pending)│ CR (Pending)│ DR (Settled)│ CR (Settled) │
├──────────────────────────┼─────────────┼─────────────┼─────────────┼──────────────────┤
│ CANCEL_DISBURSAL │ DR (Pending)│ CR (Pending)│ │ │
│ │ CR (Settled)│ DR (Settled)│ │ │
└──────────────────────────┴─────────────┴─────────────┴─────────────┴──────────────────┘
Interest
┌────────────────────────────────────┬─────────────┬─────────────┬─────────────┬─────────────┐
│ Template Code │ Interest │ Interest │ Int. Added │ Uncovered │
│ │ Receivable │ Income │ to Oblig. │ Outstanding │
│ │ │ │ Omnibus │ │
├────────────────────────────────────┼─────────────┼─────────────┼─────────────┼─────────────┤
│ CREDIT_FACILITY_ACCRUE_INTEREST │ DR (Pending)│ CR (Pending)│ │ │
├────────────────────────────────────┼─────────────┼─────────────┼─────────────┼─────────────┤
│ CREDIT_FACILITY_POST_ACCRUED_ │ CR (Pending)│ DR (Pending)│ │ │
│ INTEREST │ DR (Settled)│ CR (Settled)│ DR (Settled)│ CR (Settled)│
└────────────────────────────────────┴─────────────┴─────────────┴─────────────┴─────────────┘
Fees
┌─────────────────────┬─────────────┬─────────────┬─────────────┬──────────────┐
│ Template Code │ Facility │ Uncovered │ Disbursed │ Fee Income │
│ │ Remaining │ Outstanding │ Receivable │ │
├─────────────────────┼─────────────┼─────────────┼─────────────┼──────────────┤
│ ADD_STRUCTURING_FEE │ DR (Settled)│ CR (Settled)│ DR (Settled)│ CR (Settled) │
└─────────────────────┴─────────────┴─────────────┴─────────────┴──────────────┘