bdk_coin_select 0.4.1

Tools for input selection for making bitcoin transactions.
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

use super::change_lower_bound;
use crate::{bnb::BnbMetric, float::Ordf32, ChangePolicy, CoinSelector, Target};

#[derive(Clone, Debug)]
/// Metric for finding changeless solutions only.
pub struct Changeless {
    /// The target parameters for the resultant selection.
    pub target: Target,
    /// Policy to determine whether a selection requires a change output.
    pub change_policy: ChangePolicy,
}

impl BnbMetric for Changeless {
    fn score(&mut self, cs: &CoinSelector<'_>) -> Option<Ordf32> {
        if cs.is_target_met(self.target)
            && cs.drain_value(self.target, self.change_policy).is_none()
        {
            Some(Ordf32(0.0))
        } else {
            None
        }
    }

    fn bound(&mut self, cs: &CoinSelector<'_>) -> Option<Ordf32> {
        if change_lower_bound(cs, self.target, self.change_policy).is_some() {
            None
        } else {
            Some(Ordf32(0.0))
        }
    }

    fn requires_ordering_by_descending_value_pwu(&self) -> bool {
        true
    }
}