getBalance

fun getBalance(timeMillis: Long): BigInteger

Gets the wallet balance at a specific time.

Time Parameter: Unix timestamp in milliseconds (e.g., System.currentTimeMillis()). The balance is calculated based on dust generation progress up to this time.

Return Value: Balance in Specks (smallest dust unit).

  • 1 Dust = 1,000,000 Specks

  • Uses BigInteger to support very large balances (u128 from Rust)

Error Handling: Returns BigInteger.ZERO if:

  • State is closed

  • Native function returns null

  • Invalid timestamp

Return

Balance in Specks, or ZERO on error

Parameters

timeMillis

Unix timestamp in milliseconds