feat: add wallet changeset primitives

Author: rustaceanrob

bdk-ffi/src/bitcoin.rs

@@ -37,7 +37,7 @@ use std::str::FromStr;
 use std::sync::{Arc, Mutex};
 
 /// A reference to an unspent output by TXID and output index.
-#[derive(Debug, Clone, Eq, PartialEq, uniffi:: Record)]
+#[derive(Debug, Clone, Eq, PartialEq, std::hash::Hash, uniffi:: Record)]
 pub struct OutPoint {
     /// The transaction.
     pub txid: Arc<Txid>,
@@ -54,6 +54,15 @@ impl From<&BdkOutPoint> for OutPoint {
     }
 }
 
+impl From<BdkOutPoint> for OutPoint {
+    fn from(value: BdkOutPoint) -> Self {
+        Self {
+            txid: Arc::new(Txid(value.txid)),
+            vout: value.vout,
+        }
+    }
+}
+
 impl From<OutPoint> for BdkOutPoint {
     fn from(outpoint: OutPoint) -> Self {
         BdkOutPoint {
@@ -63,6 +72,19 @@ impl From<OutPoint> for BdkOutPoint {
     }
 }
 
+/// An [`OutPoint`] suitable as a key in a hash map.
+#[derive(Debug, PartialEq, Eq, std::hash::Hash, uniffi::Object)]
+#[uniffi::export(Debug, Eq, Hash)]
+pub struct HashableOutPoint(pub(crate) OutPoint);
+
+#[uniffi::export]
+impl HashableOutPoint {
+    /// Get the internal [`OutPoint`]
+    pub fn outpoint(&self) -> OutPoint {
+        self.0.clone()
+    }
+}
+
 /// Represents fee rate.
 ///
 /// This is an integer type representing fee rate in sat/kwu. It provides protection against mixing
@@ -588,6 +610,24 @@ impl From<&BdkTxOut> for TxOut {
     }
 }
 
+impl From<BdkTxOut> for TxOut {
+    fn from(tx_out: BdkTxOut) -> Self {
+        Self {
+            value: tx_out.value.to_sat(),
+            script_pubkey: Arc::new(Script(tx_out.script_pubkey)),
+        }
+    }
+}
+
+impl From<TxOut> for BdkTxOut {
+    fn from(tx_out: TxOut) -> Self {
+        Self {
+            value: BdkAmount::from_sat(tx_out.value),
+            script_pubkey: tx_out.script_pubkey.0.clone(),
+        }
+    }
+}
+
 /// A bitcoin Block hash
 #[derive(Debug, Clone, Copy, PartialEq, Eq, std::hash::Hash, uniffi::Object)]
 #[uniffi::export(Display, Eq, Hash)]

bdk-ffi/src/types.rs

@@ -1,4 +1,7 @@
-use crate::bitcoin::{Address, Amount, BlockHash, OutPoint, Script, Transaction, TxOut, Txid};
+use crate::bitcoin::{
+    Address, Amount, BlockHash, DescriptorId, HashableOutPoint, OutPoint, Script, Transaction,
+    TxOut, Txid,
+};
 use crate::error::{CreateTxError, RequestBuilderError};
 
 use bdk_core::bitcoin::absolute::LockTime as BdkLockTime;
@@ -24,7 +27,7 @@ use bdk_wallet::Balance as BdkBalance;
 use bdk_wallet::LocalOutput as BdkLocalOutput;
 use bdk_wallet::Update as BdkUpdate;
 
-use std::collections::HashMap;
+use std::collections::{BTreeMap, BTreeSet, HashMap};
 use std::convert::TryFrom;
 use std::sync::{Arc, Mutex};
 
@@ -85,16 +88,34 @@ impl From<BdkChainPosition<BdkConfirmationBlockTime>> for ChainPosition {
 }
 
 /// Represents the confirmation block and time of a transaction.
-#[derive(Debug, uniffi::Record)]
+#[derive(Debug, Clone, PartialEq, Eq, std::hash::Hash, uniffi::Record)]
 pub struct ConfirmationBlockTime {
     /// The anchor block.
     pub block_id: BlockId,
     /// The confirmation time of the transaction being anchored.
     pub confirmation_time: u64,
 }
 
+impl From<BdkConfirmationBlockTime> for ConfirmationBlockTime {
+    fn from(value: BdkConfirmationBlockTime) -> Self {
+        Self {
+            block_id: value.block_id.into(),
+            confirmation_time: value.confirmation_time,
+        }
+    }
+}
+
+impl From<ConfirmationBlockTime> for BdkConfirmationBlockTime {
+    fn from(value: ConfirmationBlockTime) -> Self {
+        Self {
+            block_id: value.block_id.into(),
+            confirmation_time: value.confirmation_time,
+        }
+    }
+}
+
 /// A reference to a block in the canonical chain.
-#[derive(Debug, uniffi::Record)]
+#[derive(Debug, Clone, PartialEq, Eq, std::hash::Hash, uniffi::Record)]
 pub struct BlockId {
     /// The height of the block.
     pub height: u32,
@@ -111,6 +132,15 @@ impl From<BdkBlockId> for BlockId {
     }
 }
 
+impl From<BlockId> for BdkBlockId {
+    fn from(value: BlockId) -> Self {
+        Self {
+            height: value.height,
+            hash: value.hash.0,
+        }
+    }
+}
+
 /// A transaction that is deemed to be part of the canonical history.
 #[derive(uniffi::Record)]
 pub struct CanonicalTx {
@@ -725,3 +755,150 @@ pub struct UnconfirmedTx {
     pub tx: Arc<Transaction>,
     pub last_seen: u64,
 }
+
+/// Mapping of descriptors to their last revealed index.
+#[derive(Debug, Clone, uniffi::Record)]
+pub struct IndexerChangeSet {
+    pub last_revealed: HashMap<Arc<DescriptorId>, u32>,
+}
+
+impl From<bdk_wallet::chain::indexer::keychain_txout::ChangeSet> for IndexerChangeSet {
+    fn from(mut value: bdk_wallet::chain::indexer::keychain_txout::ChangeSet) -> Self {
+        let mut changes = HashMap::new();
+        for (id, index) in core::mem::take(&mut value.last_revealed) {
+            changes.insert(Arc::new(DescriptorId(id.0)), index);
+        }
+        Self {
+            last_revealed: changes,
+        }
+    }
+}
+
+impl From<IndexerChangeSet> for bdk_wallet::chain::indexer::keychain_txout::ChangeSet {
+    fn from(mut value: IndexerChangeSet) -> Self {
+        let mut changes = BTreeMap::new();
+        for (id, index) in core::mem::take(&mut value.last_revealed) {
+            let descriptor_id = bdk_wallet::chain::DescriptorId(id.0);
+            changes.insert(descriptor_id, index);
+        }
+        Self {
+            last_revealed: changes,
+        }
+    }
+}
+
+/// The hash added or removed at the given height.
+#[derive(Debug, Clone, uniffi::Record)]
+pub struct ChainChange {
+    /// Effected height
+    pub height: u32,
+    /// A hash was added or must be removed.
+    pub hash: Option<Arc<BlockHash>>,
+}
+
+/// Changes to the local chain
+#[derive(Debug, Clone, uniffi::Record)]
+pub struct LocalChainChangeSet {
+    pub changes: Vec<ChainChange>,
+}
+
+impl From<bdk_wallet::chain::local_chain::ChangeSet> for LocalChainChangeSet {
+    fn from(mut value: bdk_wallet::chain::local_chain::ChangeSet) -> Self {
+        let mut changes = Vec::with_capacity(value.blocks.len());
+        for (height, hash) in core::mem::take(&mut value.blocks) {
+            let hash = hash.map(|h| Arc::new(BlockHash(h)));
+            let change = ChainChange { height, hash };
+            changes.push(change);
+        }
+        Self { changes }
+    }
+}
+
+impl From<LocalChainChangeSet> for bdk_wallet::chain::local_chain::ChangeSet {
+    fn from(mut value: LocalChainChangeSet) -> Self {
+        let mut changes = BTreeMap::new();
+        for change in core::mem::take(&mut value.changes) {
+            let height = change.height;
+            let hash = change.hash.map(|h| h.0);
+            changes.insert(height, hash);
+        }
+        Self { blocks: changes }
+    }
+}
+
+#[derive(Debug, Clone, uniffi::Record)]
+pub struct Anchor {
+    pub confirmation_block_time: ConfirmationBlockTime,
+    pub txid: Arc<Txid>,
+}
+
+#[derive(Debug, Clone, uniffi::Record)]
+pub struct TxGraphChangeSet {
+    pub txs: Vec<Arc<Transaction>>,
+    pub txouts: HashMap<Arc<HashableOutPoint>, TxOut>,
+    pub anchors: Vec<Anchor>,
+    pub last_seen: HashMap<Arc<Txid>, u64>,
+}
+
+impl From<bdk_wallet::chain::tx_graph::ChangeSet<BdkConfirmationBlockTime>> for TxGraphChangeSet {
+    fn from(mut value: bdk_wallet::chain::tx_graph::ChangeSet<BdkConfirmationBlockTime>) -> Self {
+        let btree_txs = core::mem::take(&mut value.txs);
+        let txs = btree_txs
+            .into_iter()
+            .map(|tx| Arc::new(tx.as_ref().into()))
+            .collect::<Vec<Arc<Transaction>>>();
+        let mut txouts = HashMap::new();
+        for (outpoint, txout) in core::mem::take(&mut value.txouts) {
+            txouts.insert(Arc::new(HashableOutPoint(outpoint.into())), txout.into());
+        }
+        let mut anchors = Vec::new();
+        for anchor in core::mem::take(&mut value.anchors) {
+            let confirmation_block_time = anchor.0.into();
+            let txid = Arc::new(Txid(anchor.1));
+            let anchor = Anchor {
+                confirmation_block_time,
+                txid,
+            };
+            anchors.push(anchor);
+        }
+        let mut last_seens = HashMap::new();
+        for (txid, time) in core::mem::take(&mut value.last_seen) {
+            last_seens.insert(Arc::new(Txid(txid)), time);
+        }
+        TxGraphChangeSet {
+            txs,
+            txouts,
+            anchors,
+            last_seen: last_seens,
+        }
+    }
+}
+
+impl From<TxGraphChangeSet> for bdk_wallet::chain::tx_graph::ChangeSet<BdkConfirmationBlockTime> {
+    fn from(mut value: TxGraphChangeSet) -> Self {
+        let mut txs = BTreeSet::new();
+        for tx in core::mem::take(&mut value.txs) {
+            let tx = Arc::new(tx.as_ref().into());
+            txs.insert(tx);
+        }
+        let mut txouts = BTreeMap::new();
+        for txout in core::mem::take(&mut value.txouts) {
+            txouts.insert(txout.0.outpoint().into(), txout.1.into());
+        }
+        let mut anchors = BTreeSet::new();
+        for anchor in core::mem::take(&mut value.anchors) {
+            let txid = anchor.txid.0;
+            anchors.insert((anchor.confirmation_block_time.into(), txid));
+        }
+        let mut last_seen = BTreeMap::new();
+        for (txid, time) in core::mem::take(&mut value.last_seen) {
+            last_seen.insert(txid.0, time);
+        }
+        Self {
+            txs,
+            txouts,
+            anchors,
+            last_seen,
+        }
+    }
+}

bdk-ffi/tests/bindings/test.kts

@@ -4,7 +4,7 @@
  */
 
 import org.bitcoindevkit.bitcoin.Network
-import org.bitcoindevkit.BlockId
+import org.bitcoindevkit.Condition
 
 // A type from bitcoin-ffi
 val network = Network.TESTNET

bdk-ffi/tests/bindings/test.py

@@ -1,4 +1,4 @@
-from bdkpython import BlockId
+from bdkpython import Condition
 from bdkpython.bitcoin import Network
 
 import unittest