23
23
//!
24
24
//! * [`list_canonical_txs`](TxGraph::list_canonical_txs) lists canonical transactions.
25
25
//! * [`filter_chain_txouts`](TxGraph::filter_chain_txouts) filters out canonical outputs from a
26
- //! list of outpoints.
26
+ //! list of outpoints.
27
27
//! * [`filter_chain_unspents`](TxGraph::filter_chain_unspents) filters out canonical unspent
28
- //! outputs from a list of outpoints.
28
+ //! outputs from a list of outpoints.
29
29
//! * [`balance`](TxGraph::balance) gets the total sum of unspent outputs filtered from a list of
30
- //! outpoints.
30
+ //! outpoints.
31
31
//! * [`canonical_iter`](TxGraph::canonical_iter) returns the [`CanonicalIter`] which contains all
32
- //! of the canonicalization logic.
32
+ //! of the canonicalization logic.
33
33
//!
34
34
//! All these methods require a `chain` and `chain_tip` argument. The `chain` must be a
35
35
//! [`ChainOracle`] implementation (such as [`LocalChain`](crate::local_chain::LocalChain)) which
39
39
//! transactions have precedence over others:
40
40
//!
41
41
//! * [`Anchor`] - This bit of data represents that a transaction is anchored in a given block. If
42
- //! the transaction is anchored in chain of `chain_tip`, or is an ancestor of a transaction
43
- //! anchored in chain of `chain_tip`, then the transaction must be canonical.
42
+ //! the transaction is anchored in chain of `chain_tip`, or is an ancestor of a transaction
43
+ //! anchored in chain of `chain_tip`, then the transaction must be canonical.
44
44
//! * `last_seen` - This is the timestamp of when a transaction is last-seen in the mempool. This
45
- //! value is updated by [`insert_seen_at`](TxGraph::insert_seen_at) and
46
- //! [`apply_update`](TxGraph::apply_update). Transactions that are seen later have higher
47
- //! priority than those that are seen earlier. `last_seen` values are transitive. This means
48
- //! that the actual `last_seen` value of a transaction is the max of all the `last_seen` values
49
- //! from it's descendants.
45
+ //! value is updated by [`insert_seen_at`](TxGraph::insert_seen_at) and
46
+ //! [`apply_update`](TxGraph::apply_update). Transactions that are seen later have higher
47
+ //! priority than those that are seen earlier. `last_seen` values are transitive. This means
48
+ //! that the actual `last_seen` value of a transaction is the max of all the `last_seen` values
49
+ //! from it's descendants.
50
50
//! * `last_evicted` - This is the timestamp of when a transaction last went missing from the
51
- //! mempool. If this value is equal to or higher than the transaction's `last_seen` value, then
52
- //! it will not be considered canonical.
51
+ //! mempool. If this value is equal to or higher than the transaction's `last_seen` value, then
52
+ //! it will not be considered canonical.
53
53
//!
54
54
//! # Graph traversal
55
55
//!
@@ -484,7 +484,7 @@ impl<A: Clone + Ord> TxGraph<A> {
484
484
/// The supplied closure takes in two inputs `(depth, ancestor_tx)`:
485
485
///
486
486
/// * `depth` is the distance between the starting `Transaction` and the `ancestor_tx`. I.e., if
487
- /// the `Transaction` is spending an output of the `ancestor_tx` then `depth` will be 1.
487
+ /// the `Transaction` is spending an output of the `ancestor_tx` then `depth` will be 1.
488
488
/// * `ancestor_tx` is the `Transaction`'s ancestor which we are considering to walk.
489
489
///
490
490
/// The supplied closure returns an `Option<T>`, allowing the caller to map each `Transaction`
@@ -502,7 +502,7 @@ impl<A: Clone + Ord> TxGraph<A> {
502
502
/// The supplied closure takes in two inputs `(depth, descendant_txid)`:
503
503
///
504
504
/// * `depth` is the distance between the starting `txid` and the `descendant_txid`. I.e., if the
505
- /// descendant is spending an output of the starting `txid` then `depth` will be 1.
505
+ /// descendant is spending an output of the starting `txid` then `depth` will be 1.
506
506
/// * `descendant_txid` is the descendant's txid which we are considering to walk.
507
507
///
508
508
/// The supplied closure returns an `Option<T>`, allowing the caller to map each node it visits
@@ -642,7 +642,7 @@ impl<A: Anchor> TxGraph<A> {
642
642
/// * A non-empty witness has precedence over an empty witness.
643
643
/// * A smaller witness has precedence over a larger witness.
644
644
/// * If the witness sizes are the same, we prioritize the two witnesses with lexicographical
645
- /// order.
645
+ /// order.
646
646
pub fn insert_tx < T : Into < Arc < Transaction > > > ( & mut self , tx : T ) -> ChangeSet < A > {
647
647
// This returns `Some` only if the merged tx is different to the `original_tx`.
648
648
fn _merge_tx_witnesses (
0 commit comments