Support for getchaintxstats RPC

Author: clarkmoody

client/src/client.rs

@@ -955,6 +955,12 @@ pub trait RpcApi: Sized {
         self.call("getchaintips", &[])
     }
 
+    /// Compute statistics about the total number and rate of transactions in the chain.
+    fn get_chain_tx_stats(&self, nblocks: Option<u64>, blockhash: Option<&bitcoin::BlockHash>)
+        -> Result<json::GetChainTxStatsResult> {
+        self.call("getchaintxstats", &[opt_into_json(nblocks)?, opt_into_json(blockhash)?])
+    }
+
     fn send_to_address(
         &self,
         address: &Address<NetworkChecked>,

json/src/lib.rs

@@ -1817,6 +1817,26 @@ pub enum GetChainTipsResultStatus {
     Active,
 }
 
+#[derive(Clone, PartialEq, Debug, Deserialize, Serialize)]
+pub struct GetChainTxStatsResult {
+  /// The timestamp for the final block in the window, expressed in UNIX epoch time
+    pub time : u64,
+    /// The total number of transactions in the chain up to that point
+    pub txcount: u64,
+    /// The hash of the final block in the window
+    pub window_final_block_hash: bitcoin::BlockHash,
+    /// The height of the final block in the window.
+    pub window_final_block_height: u64,
+    /// Size of the window in number of blocks
+    pub window_block_count: u64,
+    /// The number of transactions in the window. Only returned if "window_block_count" is > 0
+    pub window_tx_count: Option<u64>,
+    /// The elapsed time in the window in seconds. Only returned if "window_block_count" is > 0
+    pub window_interval: Option<u64>,
+    /// The average rate of transactions per second in the window. Only returned if "window_interval" is > 0
+    pub txrate: Option<f64>,
+}
+
 impl FinalizePsbtResult {
     pub fn transaction(&self) -> Option<Result<Transaction, encode::Error>> {
         self.hex.as_ref().map(|h| encode::deserialize(h))