UtxoContext (Class)

UTXO context for tracking addresses and balances.

balance property

balance: Optional[Balance]

Current balance for this context (if available).

balance_strings property

balance_strings: Optional[BalanceStrings]

Current balance formatted as strings (if available).

is_active property

is_active: bool

Whether the underlying processor is connected and running.

mature_length property

mature_length: int

Number of mature UTXO entries.

__new__

__new__(processor: UtxoProcessor, id: Optional[Any] = None) -> UtxoContext

Create a new UtxoContext.

PARAMETER	DESCRIPTION
processor	The UtxoProcessor to bind to. TYPE: UtxoProcessor
id	Optional 32-byte hex id (string) or Hash. TYPE: Optional[Any] DEFAULT: None

clear

clear() -> None

Clear all tracked addresses and UTXOs (async).

mature_range

mature_range(from_: int, to: int) -> list[UtxoEntryReference]

Return a range of mature UTXO entries.

pending

pending() -> list[UtxoEntryReference]

Return pending UTXO entries.

track_addresses

track_addresses(addresses: Sequence[Address] | Sequence[str], current_daa_score: Optional[int] = None) -> None

Track and scan a list of addresses (async).

PARAMETER	DESCRIPTION
addresses	List of Address objects or address strings. TYPE: Sequence[Address] | Sequence[str]
current_daa_score	Optional current DAA score for scan context. TYPE: Optional[int] DEFAULT: None

unregister_addresses

unregister_addresses(addresses: Sequence[Address] | Sequence[str]) -> None

Unregister a list of addresses (async).