getCurrentBalance

suspend fun getCurrentBalance(address: String): BigInteger

Get current dust balance for an address.

Calculation:

  • Loads DustLocalState from persistent storage

  • Calls native getBalance() with current time

  • Returns total dust in Specks

Time-based Generation: Balance increases over time as dust generates from registered Night UTXOs. Calling this method multiple times with different timestamps returns different values.

Units:

  • Returns: Specks (smallest dust unit)

  • 1 Dust = 1,000,000 Specks

  • To convert to Dust: balance / 1_000_000

Return

Current balance in Specks (BigInteger to support u128)

Parameters

address

Wallet address