refresh

suspend fun refresh(): Any

Force a fresh resync of both shielded and dust state.

Unshielded NIGHT is already kept live by the subscription started at SDK build time, so it's not re-pulled here. Shielded NIGHT and DUST are local-replay-driven and can lag if the SDK's subscriptions had a transient hiccup; calling refresh catches them up immediately.

Use cases:

  • Between sequential transactions (avoid stale UTXO state for fees).

  • When the UI shows a "refresh" affordance and the user wants on-demand freshness rather than waiting on the natural cadence.

  • After waitForFunding returns, if you also need shielded NIGHT fresh (waitForFunding only refreshes dust).

Errors in shielded resync don't abort the dust resync (and vice versa) — partial freshness is better than no freshness.