frost/bdk
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(chain): Improve TxGraph::ChangeSet docs

Browse Source
This commit is contained in:
LLFourn 2024-02-10 09:13:08 +11:00
parent dbbd514242
commit 13ab5a835d
No known key found for this signature in database
GPG Key ID: A27093B54DA11F65
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
crates/chain/src/tx_graph.rs
View File

@ -40,20 +40,23 @@
//! # use bdk_chain::example_utils::*; //! # use bdk_chain::example_utils::*;
//! # use bitcoin::Transaction; //! # use bitcoin::Transaction;
//! # let tx_a = tx_from_hex(RAW_TX_1); //! # let tx_a = tx_from_hex(RAW_TX_1);
//! let mut graph: TxGraph = TxGraph::default(); //! let mut tx_graph: TxGraph = TxGraph::default();
//! let mut another_graph: TxGraph = TxGraph::default();
//! //!
//! // insert a transaction //! // insert a transaction
//! let changeset = graph.insert_tx(tx_a); //! let changeset = tx_graph.insert_tx(tx_a);
//! //!
//! // the resulting changeset can be applied to another tx graph //! // We can restore the state of the `tx_graph` by applying all
//! another_graph.apply_changeset(changeset); //! // the changesets obtained by mutating the original (the order doesn't matter).
//! let mut restored_tx_graph: TxGraph = TxGraph::default();
//! restored_tx_graph.apply_changeset(changeset);
//!
//! assert_eq!(tx_graph, restored_tx_graph);
//! ``` //! ```
//! //!
//! A [`TxGraph`] can also be updated with another [`TxGraph`]. //! A [`TxGraph`] can also be updated with another [`TxGraph`] which merges them together.
//! //!
//! ``` //! ```
//! # use bdk_chain::BlockId; //! # use bdk_chain::{Append, BlockId};
//! # use bdk_chain::tx_graph::TxGraph; //! # use bdk_chain::tx_graph::TxGraph;
//! # use bdk_chain::example_utils::*; //! # use bdk_chain::example_utils::*;
//! # use bitcoin::Transaction; //! # use bitcoin::Transaction;
@ -67,10 +70,7 @@
//! //!
//! // if we apply it again, the resulting changeset will be empty //! // if we apply it again, the resulting changeset will be empty
//! let changeset = graph.apply_update(update); //! let changeset = graph.apply_update(update);
//! assert!({ //! assert!(changeset.is_empty());
//! use bdk_chain::Append;
//! changeset.is_empty()
//! });
//! ``` //! ```
//! [`try_get_chain_position`]: TxGraph::try_get_chain_position //! [`try_get_chain_position`]: TxGraph::try_get_chain_position
//! [`insert_txout`]: TxGraph::insert_txout //! [`insert_txout`]: TxGraph::insert_txout