feat: add get_block

Author: luisschwab

src/async.rs

@@ -27,8 +27,9 @@ use log::{debug, error, info, trace};
 use reqwest::{header, Client, Response};
 
 use crate::{
-    AddressStats, BlockStatus, BlockSummary, Builder, Error, MerkleProof, OutputSpendStatus,
-    OutputStatus, ScriptHashStats, Tx, TxStatus, Utxo, BASE_BACKOFF_MILLIS, RETRYABLE_ERROR_CODES,
+    AddressStats, BlockInformation, BlockStatus, BlockSummary, Builder, Error, MerkleProof,
+    OutputSpendStatus, OutputStatus, ScriptHashStats, Tx, TxStatus, Utxo, BASE_BACKOFF_MILLIS,
+    RETRYABLE_ERROR_CODES,
 };
 
 #[derive(Debug, Clone)]
@@ -464,6 +465,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

@@ -28,8 +28,9 @@ use bitcoin::hex::{DisplayHex, FromHex};
 use bitcoin::{Address, Block, BlockHash, MerkleBlock, Script, Transaction, Txid};
 
 use crate::{
-    AddressStats, BlockStatus, BlockSummary, Builder, Error, MerkleProof, OutputSpendStatus,
-    OutputStatus, ScriptHashStats, Tx, TxStatus, Utxo, BASE_BACKOFF_MILLIS, RETRYABLE_ERROR_CODES,
+    AddressStats, BlockInformation, BlockStatus, BlockSummary, Builder, Error, MerkleProof,
+    OutputSpendStatus, OutputStatus, ScriptHashStats, Tx, TxStatus, Utxo, BASE_BACKOFF_MILLIS,
+    RETRYABLE_ERROR_CODES,
 };
 
 #[derive(Debug, Clone)]
@@ -389,6 +390,13 @@ 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 {
@@ -966,6 +967,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() {