Module utxo 

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:

• the cached Chain, and
• the shared finalized ZebraDb reference.

Structs

AddressUtxos

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::Addresses in query_height_range, in chain order, at most max_entries of them; 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 the UTXOs outside query_height_range, truncates the result to max_entries, and returns it.

chain_transparent_utxo_changes 🔒

Returns the UTXO changes (created and spent) for addresses in the non-finalized chain, matching or overlapping the UTXOs for the finalized_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.

finalized_scan_limit 🔒

The number of UTXOs a limited finalized query has to ask for, when the caller wants max_entries of them and the non-finalized chain spends chain_spent_count of the addresses’ UTXOs.

lookup_tx_ids_for_utxos 🔒

Returns the transaction::Hashes containing the supplied UTXOs, from the non-finalized chain and finalized db.