Explain an immature or pending Bitcoin wallet balance
A freshly mined regtest reward and an incoming unconfirmed payment affect different counters. Preserve that distinction when an application displays funds.
Read the wallet's categories
With the regtest wallet lab loaded, inspect the amounts in BTC. The mine object groups amounts recognized by this wallet. After mining a block to its own address, look specifically at immature.
bitcoin-cli -regtest -rpcwallet=lab getbalances | jq '.mine | {trusted, untrusted_pending, immature}'
Choose a figure for the display
untrusted_pending captures unconfirmed funds from outside the wallet. Immature coinbase outputs move into the usable balance as more blocks accumulate. trusted can include eligible unconfirmed wallet change. For a screen explicitly promising confirmed funds, use a confirmation-filtered output query and document your minimum depth.