feat(client): add get_block method

Author: luisschwab

src/async.rs

@@ -476,6 +476,13 @@ impl<S: Sleeper> AsyncClient<S> {
         self.get_response_json("/fee-estimates").await
     }
 
+    /// Get a summary about a [`Block`], given it's [`BlockHash`].
+    pub async fn get_block(&self, blockhash: &BlockHash) -> Result<BlockInformation, Error> {
+        let path = format!("/block/{blockhash}");
+
+        self.get_response_json(&path).await
+    }
+
     /// Gets some recent block summaries starting at the tip or at `height` if
     /// provided.
     ///

src/blocking.rs

@@ -403,6 +403,14 @@ impl BlockingClient {
 
         self.get_response_json(&path)
     }
+
+    /// Get a summary about a [`Block`], given it's [`BlockHash`].
+    pub fn get_block(&self, blockhash: &BlockHash) -> Result<BlockInformation, Error> {
+        let path = format!("/block/{blockhash}");
+
+        self.get_response_json(&path)
+    }
+
     /// Gets some recent block summaries starting at the tip or at `height` if
     /// provided.
     ///

src/lib.rs

@@ -267,6 +267,7 @@ mod test {
     use electrsd::{corepc_node, ElectrsD};
     use lazy_static::lazy_static;
     use std::env;
+    use std::str::FromStr;
     use tokio::sync::Mutex;
     #[cfg(all(feature = "blocking", feature = "async"))]
     use {
@@ -922,6 +923,25 @@ mod test {
         assert_eq!(scripthash_txs_txids, scripthash_txs_txids_async);
     }
 
+    #[cfg(all(feature = "blocking", feature = "async"))]
+    #[tokio::test]
+    async fn test_get_block() {
+        let (blocking_client, async_client) = setup_clients().await;
+
+        // Genesis block `BlockHash` on regtest.
+        let blockhash_genesis =
+            BlockHash::from_str("0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206")
+                .unwrap();
+
+        let block_info_blocking = blocking_client.get_block(&blockhash_genesis).unwrap();
+        let block_info_async = async_client.get_block(&blockhash_genesis).await.unwrap();
+
+        assert_eq!(block_info_async, block_info_blocking);
+        assert_eq!(block_info_async.id, blockhash_genesis);
+        assert_eq!(block_info_async.height, 0);
+        assert_eq!(block_info_async.previousblockhash, None);
+    }
+
     #[cfg(all(feature = "blocking", feature = "async"))]
     #[tokio::test]
     async fn test_get_blocks() {