Ledger

Wallet operations

Ledger

The BroSettlement ledger is the operating record for balances, transaction history, reconciliation, and audit evidence.

Blockchain events tell you what happened on-chain. Ledger entries tell you how that activity affects customer, merchant, seller, player, recipient, or internal account balances.

Journal entries

The ledger records balance changes as immutable journal entries. A journal entry can represent:

  • Deposit credit
  • Withdrawal debit
  • Network fee
  • Internal transfer
  • Adjustment
  • Reversal

Ledger principles

  • Immutable history: entries are appended, not overwritten.
  • Traceability: each entry links to an operation, blockchain transaction, or internal transfer.
  • Separation of concerns: blockchain monitoring and accounting state are distinct.
  • Organization scope: balances are tracked within the organization context.
  • Stable identifiers: product accounts and wallet activity can be connected through internal IDs.

Example entry

json
{
  "entryId": "led_123",
  "organizationId": "org_123",
  "walletId": "wal_123",
  "type": "deposit_credit",
  "asset": "USDT",
  "chain": "TRON",
  "amount": "2500.00",
  "status": "posted",
  "transactionHash": "0x9f2c...",
  "createdAt": "2026-06-25T09:10:00Z"
}

Reconciliation flow

  1. Receive an event

Your backend receives a deposit, withdrawal, or confirmation event.

  1. Fetch operation state

Query the operation or transaction by ID to get its current status.

  1. Read ledger entries

Fetch ledger entries for the operation and update your internal accounting view.

  1. Store external references

Store BroSettlement IDs in your system so support and finance teams can trace the movement later.

Related pages

ReconciliationDesign a reconciliation flow from on-chain activity to internal balances.WebSocket eventsReceive lifecycle events before reconciling against ledger records.