kaspa-consensus-core 0.15.0

Kaspa consensus core
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

use super::utxo_diff::*;
use crate::tx::*;

/// An abstraction for read-only queries over a UTXO collection
pub trait UtxoView {
    fn get(&self, outpoint: &TransactionOutpoint) -> Option<UtxoEntry>;
}

/// Composes a UTXO view from a base UTXO view and a UTXO diff
/// Note: can be used to compose any number of diff layers by nesting instances
pub struct ComposedUtxoView<V: UtxoView, D: ImmutableUtxoDiff> {
    base: V,
    diff: D,
}

impl<V: UtxoView, D: ImmutableUtxoDiff> ComposedUtxoView<V, D> {
    pub fn new(base: V, diff: D) -> Self {
        Self { base, diff }
    }
}

impl<V: UtxoView, D: ImmutableUtxoDiff> UtxoView for ComposedUtxoView<V, D> {
    fn get(&self, outpoint: &TransactionOutpoint) -> Option<UtxoEntry> {
        // First check diff added entries
        if let Some(entry) = self.diff.added().get(outpoint) {
            return Some(entry.clone());
        }
        // If not in added, but in removed, then considered removed
        if self.diff.removed().contains_key(outpoint) {
            return None;
        }
        // Fallback to base view
        self.base.get(outpoint)
    }
}

impl<T: UtxoView> UtxoView for &T {
    fn get(&self, outpoint: &TransactionOutpoint) -> Option<UtxoEntry> {
        (*self).get(outpoint)
    }
}

pub trait UtxoViewComposition: UtxoView + Sized {
    fn compose<D: ImmutableUtxoDiff>(self, diff: D) -> ComposedUtxoView<Self, D>;
}

impl<T: UtxoView> UtxoViewComposition for T {
    fn compose<D: ImmutableUtxoDiff>(self, diff: D) -> ComposedUtxoView<Self, D> {
        ComposedUtxoView::new(self, diff)
    }
}