feat(api): create ScriptHashTxsSummary and ScriptHashStats structs

Author: luisschwab

src/api.rs

@@ -6,7 +6,8 @@ pub use bitcoin::consensus::{deserialize, serialize};
 pub use bitcoin::hex::FromHex;
 use bitcoin::Weight;
 pub use bitcoin::{
-    transaction, Amount, BlockHash, OutPoint, ScriptBuf, Transaction, TxIn, TxOut, Txid, Witness,
+    transaction, Amount, BlockHash, OutPoint, ScriptBuf, ScriptHash, Transaction, TxIn, TxOut,
+    Txid, Witness,
 };
 
 use serde::Deserialize;
@@ -123,6 +124,19 @@ pub struct AddressTxsSummary {
     pub tx_count: u32,
 }
 
+/// [`ScriptHash`] statistics, includes the script hash, and the [`TxOut`] information for the
+/// script hash.
+#[derive(Debug, Copy, Clone, PartialEq, Eq, Deserialize)]
+pub struct ScriptHashStats {
+    /// The summary of confirmed transactions for this [`ScriptHash`].
+    pub chain_stats: ScriptHashTxsSummary,
+    /// The summary of mempool transactions for this [`ScriptHash`].
+    pub mempool_stats: ScriptHashTxsSummary,
+}
+
+/// Contains a summary of the transactions for a [`ScriptHash`].
+pub type ScriptHashTxsSummary = AddressTxsSummary;
+
 /// Information about an UTXO's status: confirmation status,
 /// confirmation height, confirmation block hash and confirmation block time.
 #[derive(Debug, Copy, Clone, PartialEq, Eq, Deserialize)]