feat: add apply_block_relevant/batch_insert_relevant_uncofirmed to wallet

Author: vladimirfomene

crates/bdk/src/wallet/mod.rs

@@ -34,7 +34,7 @@ use bitcoin::secp256k1::Secp256k1;
 use bitcoin::sighash::{EcdsaSighashType, TapSighashType};
 use bitcoin::{
     absolute, Address, Network, OutPoint, Script, ScriptBuf, Sequence, Transaction, TxOut, Txid,
-    Weight, Witness,
+    Weight, Witness, Block,
 };
 use core::fmt;
 use core::ops::Deref;
@@ -1949,6 +1949,15 @@ impl<D> Wallet<D> {
         Ok(())
     }
 
+    /// Stages wallet changes in memory for later commit.
+    /// 
+    /// To commit changes to the persistence backend, call [`commit`].
+    /// 
+    /// [`commit`]: Self::commit
+    pub fn stage(&mut self, changeset: ChangeSet) where D: PersistBackend<ChangeSet> {
+        self.persist.stage(changeset);
+    }
+
     /// Commits all currently [`staged`] changed to the persistence backend returning and error when
     /// this fails.
     ///
@@ -1995,6 +2004,27 @@ impl<D> Wallet<D> {
         assert_ne!(lookahead, 0, "lookahead must be greater than 0");
         self.indexed_graph.index.set_lookahead_for_all(lookahead);
     }
+
+    /// Insert all the block's relevant transactions into the IndexedTxGraph.
+    pub fn apply_block_relevant(&mut self, block: Block, height: u32) -> Result<ChangeSet, CannotConnectError> {
+        let chain_update = CheckPoint::from_header(&block.header, height).into_update(false);
+        let mut changeset = ChangeSet::from(self.chain.apply_update(chain_update)?);
+        changeset.append(ChangeSet::from(
+            self.indexed_graph.apply_block_relevant(block, height),
+        ));
+        Ok(changeset)
+    }
+
+    /// Batch insert unconfirmed transactions into the IndexedTxGraph.
+    /// Filtering out those that are not relevant.
+    ///
+    /// Read more here: [`self.indexed_graph.batch_insert_relevant_unconfirmed()`]
+    pub fn batch_insert_relevant_unconfirmed<'t>(
+        &mut self,
+        unconfirmed_txs: impl IntoIterator<Item = (&'t Transaction, u64)>,
+    ) -> indexed_tx_graph::ChangeSet<ConfirmationTimeAnchor, keychain::ChangeSet<KeychainKind>> {
+        self.indexed_graph.batch_insert_relevant_unconfirmed(unconfirmed_txs)
+    }
 }
 
 impl<D> AsRef<bdk_chain::tx_graph::TxGraph<ConfirmationTimeAnchor>> for Wallet<D> {