Expand description
Transparent address index UTXO queries.
In the functions in this module:
The block write task commits blocks to the finalized state before updating
chain
with a cached copy of the best non-finalized chain from
NonFinalizedState.chain_set
. Then the block commit task can commit additional blocks to
the finalized state after weโve cloned the chain
.
This means that some blocks can be in both:
Structsยง
- Address
Utxos - A convenience wrapper that efficiently stores unspent transparent outputs, and the corresponding transaction IDs.
Constantsยง
- ADDRESS_
HEIGHTS_ FULL_ RANGE - The full range of address heights.
Functionsยง
- address_
utxos - Returns the unspent transparent outputs (UTXOs) for the supplied
transparent::Address
es, in chain order; and the transaction IDs for the transactions containing those UTXOs. - apply_
utxo_ ๐changes - Combines the supplied finalized and non-finalized UTXOs, removes the spent UTXOs, and returns the result.
- chain_
transparent_ ๐utxo_ changes - Returns the UTXO changes (created and spent) for
addresses
in the non-finalized chain, matching or overlapping the UTXOs for thefinalized_tip_range
. Also returns the height of the last block in which the changes were located, or None if the state is empty. - finalized_
address_ ๐utxos - Returns the unspent transparent outputs (UTXOs) for
addresses
in the finalized chain, and the finalized tip heights the UTXOs were queried at. - lookup_
tx_ ๐ids_ for_ utxos - Returns the
transaction::Hash
es containing the supplied UTXOs, from the non-finalizedchain
and finalizeddb
.