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 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 for addresses in the non-finalized chain, matching or overlapping the UTXOs for the finalized_tip_range.
• 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::Hashes containing the supplied UTXOs, from the non-finalized chain and finalized db.