reservedBalance property

BigInt reservedBalance

Value of the wallet's reserved UTXOs: its own funds, committed and so not spendable right now, and not part of totalBalance — the same treatment as watchOnlyBalance, which is the wallet's and unspendable for a different reason (bead libspiffy-a5h8).

A reservation an application placed, an in-flight payment's inputs, or a deferred payment's held inputs — handed to the recipient, held by the payment's txid with no expiry until the network settles it, ARC reports it failed, or the user cancels or reclaims it. Without this field money the wallet still owns vanished from every number the coordinator reported. Which payment holds what is GetDeferredPaymentsQuery; why nothing can be selected is the reason WalletBalances.noneSelectableReason names.

Counted over the same UTXOs as the spendable balance — not plugin-managed, not watch-only, not one the wallet cannot unlock alone — so the four numbers here partition the wallet's own unspent funds, pending UTXOs apart. It is the read model's reservedBalance (WalletReadModel.reservedBalance), computed from the same rows rather than read from the wallet row's snapshot of it, so it cannot be a moment older than the numbers beside it.

Implementation

final BigInt reservedBalance;