Trait UtxoProvider

pub trait UtxoProvider {
    // Required method
    fn get(&self, outpoint: &OutPoint) -> Option<Coin>;

    // Provided method
    fn batch_get(&self, outpoints: &[OutPoint]) -> HashMap<OutPoint, Coin> { ... }
}

Abstraction for UTXO access.

This trait decouples block verification from storage implementation, enabling:

• Substrate state lookups during normal operation
• Native RocksDB lookups for optimized storage
• Pre-fetched data during batch verification
• Cached lookups for improved performance

Required Methods

fn get(&self, outpoint: &OutPoint) -> Option<Coin>

Get a single UTXO by outpoint.

Returns None if the UTXO doesn’t exist.

Provided Methods

fn batch_get(&self, outpoints: &[OutPoint]) -> HashMap<OutPoint, Coin>

Batch-fetch multiple UTXOs.

Returns a map containing only the UTXOs that were found. Missing outpoints are silently omitted from the result.

Default implementation calls get() for each outpoint. Implementations should override for better performance.

Implementations on Foreign Types

impl UtxoProvider for HashMap<OutPoint, Coin>

Implementation for HashMap (used with pre-fetched UTXOs).

This allows verification to use pre-fetched data without any storage access.

fn get(&self, outpoint: &OutPoint) -> Option<Coin>

fn batch_get(&self, outpoints: &[OutPoint]) -> HashMap<OutPoint, Coin>

Implementors