feat(client): add get_mempool_recent_txs

Author: luisschwab

src/async.rs

@@ -27,9 +27,9 @@ use log::{debug, error, info, trace};
 use reqwest::{header, Client, Response};
 
 use crate::{
-    AddressStats, BlockInformation, BlockStatus, BlockSummary, Builder, Error, MempoolStats,
-    MerkleProof, OutputSpendStatus, OutputStatus, ScriptHashStats, Tx, TxStatus, Utxo,
-    BASE_BACKOFF_MILLIS, RETRYABLE_ERROR_CODES,
+    AddressStats, BlockInformation, BlockStatus, BlockSummary, Builder, Error, MempoolRecentTx,
+    MempoolStats, MerkleProof, OutputSpendStatus, OutputStatus, ScriptHashStats, Tx, TxStatus,
+    Utxo, BASE_BACKOFF_MILLIS, RETRYABLE_ERROR_CODES,
 };
 
 #[derive(Debug, Clone)]
@@ -458,6 +458,11 @@ impl<S: Sleeper> AsyncClient<S> {
         self.get_response_json("/mempool").await
     }
 
+    // Get a list of the last 10 [`Transaction`]s to enter the mempool.
+    pub async fn get_mempool_recent_txs(&self) -> Result<Vec<MempoolRecentTx>, Error> {
+        self.get_response_json("/mempool/recent").await
+    }
+
     /// Get an map where the key is the confirmation target (in number of
     /// blocks) and the value is the estimated feerate (in sat/vB).
     pub async fn get_fee_estimates(&self) -> Result<HashMap<u16, f64>, Error> {

src/blocking.rs

@@ -28,9 +28,9 @@ use bitcoin::hex::{DisplayHex, FromHex};
 use bitcoin::{Address, Block, BlockHash, MerkleBlock, Script, Transaction, Txid};
 
 use crate::{
-    AddressStats, BlockInformation, BlockStatus, BlockSummary, Builder, Error, MempoolStats,
-    MerkleProof, OutputSpendStatus, OutputStatus, ScriptHashStats, Tx, TxStatus, Utxo,
-    BASE_BACKOFF_MILLIS, RETRYABLE_ERROR_CODES,
+    AddressStats, BlockInformation, BlockStatus, BlockSummary, Builder, Error, MempoolRecentTx,
+    MempoolStats, MerkleProof, OutputSpendStatus, OutputStatus, ScriptHashStats, Tx, TxStatus,
+    Utxo, BASE_BACKOFF_MILLIS, RETRYABLE_ERROR_CODES,
 };
 
 #[derive(Debug, Clone)]
@@ -321,6 +321,11 @@ impl BlockingClient {
         self.get_response_json("/mempool")
     }
 
+    // Get a list of the last 10 [`Transaction`]s to enter the mempool.
+    pub fn get_mempool_recent_txs(&self) -> Result<Vec<MempoolRecentTx>, Error> {
+        self.get_response_json("/mempool/recent")
+    }
+
     /// Get an map where the key is the confirmation target (in number of
     /// blocks) and the value is the estimated feerate (in sat/vB).
     pub fn get_fee_estimates(&self) -> Result<HashMap<u16, f64>, Error> {

src/lib.rs

@@ -908,6 +908,56 @@ mod test {
         }
     }
 
+    #[cfg(all(feature = "blocking", feature = "async"))]
+    #[tokio::test]
+    async fn test_get_mempool_recent_txs() {
+        let (blocking_client, async_client) = setup_clients().await;
+        let address = BITCOIND
+            .client
+            .new_address_with_type(AddressType::Legacy)
+            .unwrap();
+
+        let _miner = MINER.lock().await;
+
+        let mut expected_txids = Vec::new();
+        for _ in 0..5 {
+            let txid = BITCOIND
+                .client
+                .send_to_address(&address, Amount::from_sat(1000))
+                .unwrap()
+                .txid()
+                .unwrap();
+            expected_txids.push(txid);
+        }
+
+        // Sleep for 5 seconds so transactions have time to propagate
+        tokio::time::sleep(tokio::time::Duration::from_secs(5)).await;
+
+        let recent_blocking = blocking_client.get_mempool_recent_txs().unwrap();
+        let recent_async = async_client.get_mempool_recent_txs().await.unwrap();
+
+        assert_eq!(recent_blocking, recent_async);
+
+        // Should return up to 10 transactions
+        assert!(recent_blocking.len() <= 10);
+        assert!(!recent_blocking.is_empty());
+
+        // Our most recent transactions should be in there
+        let returned_txids: Vec<Txid> = recent_blocking.iter().map(|tx| tx.txid).collect();
+        for expected_txid in &expected_txids {
+            assert!(
+                returned_txids.contains(expected_txid),
+                "Txid {} not found in recent mempool txs",
+                expected_txid
+            );
+        }
+
+        for tx in &recent_blocking {
+            assert!(tx.vsize > 0);
+            assert!(tx.value > 0);
+        }
+    }
+
     #[cfg(all(feature = "blocking", feature = "async"))]
     #[tokio::test]
     async fn test_get_fee_estimates() {