docs: Update API documentation

- Add syntax highlighting for code blocks in
README

Author: tvpeter

README.md

@@ -1,8 +1,6 @@
 # bdk-bitcoind-client
 
-A minimal, experimental Bitcoin Core RPC client designed specifically for the Bitcoin Dev Kit (BDK). Unlike generic RPC wrappers, 
-`bdk-bitcoind-client` focuses on high-performance data emission and strict type safety, with built-in support for multiple Bitcoin 
-Core versions (v28.0 through v30.0+).
+A minimal Bitcoin Core RPC client designed specifically for the Bitcoin Dev Kit (BDK). It retrieves blockchain data from `bitcoind` over JSON-RPC and supports multiple versions of Bitcoin Core (v28.0 through v30.0+).
 
 ### Features 
 
@@ -14,17 +12,17 @@ Core versions (v28.0 through v30.0+).
 ### Installation
 
 Add this to your `Cargo.toml`:
-```
-// For the latest Bitcoin Core (v30.0+) 
+```toml
+# For the latest Bitcoin Core (v30.0+) 
 bdk-bitcoind-client = { version = "0.1.0" }
 
-// OR for older nodes (e.g., v28.x) 
+# OR for older nodes (e.g., v28.x) 
 bdk-bitcoind-client = { version = "0.1.0", default-features = false, features = ["28_0"] }
 ```
 
 ### Quick Start
 
-```
+```rust
 use bdk_bitcoind_client::{Auth, Client};
 use std::path::PathBuf;
 fn main() -> anyhow::Result<()> {
@@ -55,7 +53,7 @@ Bitcoin Core often changes its JSON-RPC response fields (e.g., adding the target
 | ----------------- | --------------------- | -------------------------------------------- | 
 | 30_0 (default)    | v30.x and newer       | Supports latest target and difficulty fields.|
 | 29_0              | v29.x                 | Aligned with v29 schema. |
-| 28_0v             | 28.x and older        | Omits newer fields |
+| 28_0             | v28.x and older        | Omits newer fields |
 
 
 ### Development and Testing

src/client.rs

@@ -63,15 +63,15 @@ pub struct Client {
 }
 
 impl Client {
-    /// Creates a client connection to a bitcoind JSON-RPC server with authentication
+    /// Creates a client connection to a bitcoind JSON-RPC server with authentication.
     ///
     /// Requires authentication via username/password or cookie file.
     /// For connections without authentication, use `with_transport` instead.
     ///
     /// # Arguments
     ///
     /// * `url` - URL of the RPC server
-    /// * `auth` - authentication method (`UserPass` or `CookieFile`).
+    /// * `auth` - authentication method (`UserPass` or `CookieFile`)
     ///
     /// # Errors
     ///
@@ -109,7 +109,7 @@ impl Client {
         }
     }
 
-    /// Calls the underlying RPC `method` with given `args` list
+    /// Calls the underlying RPC `method` with the given `args`.
     ///
     /// This is the generic function used by all specific RPC methods.
     pub fn call<T>(&self, method: &str, args: &[serde_json::Value]) -> Result<T, Error>
@@ -124,9 +124,9 @@ impl Client {
     }
 }
 
-/// `Bitcoind` RPC methods implementation for `Client`
+/// `bitcoind` RPC methods implementation for `Client`.
 impl Client {
-    /// Retrieves the raw block data for a given block hash (verbosity 0)
+    /// Retrieves the raw block data for a given block hash (verbosity 0).
     ///
     /// # Arguments
     ///
@@ -140,7 +140,7 @@ impl Client {
             .and_then(|block_hex| deserialize_hex(&block_hex).map_err(Error::DecodeHex))
     }
 
-    /// Retrieves the hash of the tip of the best block chain.
+    /// Retrieves the hash of the best chain's block.
     ///
     /// # Returns
     ///
@@ -150,7 +150,7 @@ impl Client {
             .and_then(|blockhash_hex| blockhash_hex.parse().map_err(Error::HexToArray))
     }
 
-    /// Retrieves the number of blocks in the longest chain
+    /// Retrieves the number of blocks in the longest chain.
     ///
     /// # Returns
     ///
@@ -162,36 +162,36 @@ impl Client {
             .map_err(Error::TryFromInt)
     }
 
-    /// Retrieves the block hash at a given height
+    /// Retrieves the [`BlockHash`] of the block at `height`.
     ///
     /// # Arguments
     ///
     /// * `height`: The block height
     ///
     /// # Returns
     ///
-    /// The `BlockHash` for the given height
+    /// The [`BlockHash`] of the block at `height`
     pub fn get_block_hash(&self, height: u32) -> Result<BlockHash, Error> {
         self.call::<String>("getblockhash", &[json!(height)])
             .and_then(|blockhash_hex| blockhash_hex.parse().map_err(Error::HexToArray))
     }
 
-    /// Retrieve the `basic` BIP 157 content filter for a particular block
+    /// Retrieve the Compact Block Filter (BIP-0158) with type `basic` for the block given its `Blockhash`.
     ///
     /// # Arguments
     ///
     /// * `block_hash`: The hash of the block whose filter is requested
     ///
     /// # Returns
     ///
-    /// The `GetBlockFilter` structure containing the filter data
+    /// The `GetBlockFilter` structure containing the filter data for the block
     pub fn get_block_filter(&self, block_hash: &BlockHash) -> Result<GetBlockFilter, Error> {
         let block_filter: v30::GetBlockFilter =
             self.call("getblockfilter", &[json!(block_hash)])?;
         block_filter.into_model().map_err(Error::GetBlockFilter)
     }
 
-    /// Retrieves the raw block header for a given block hash.
+    /// Retrieves the `Header` for a `Block` given its `BlockHash`.
     ///
     /// # Arguments
     ///
@@ -205,7 +205,7 @@ impl Client {
             .and_then(|header_hex: String| deserialize_hex(&header_hex).map_err(Error::DecodeHex))
     }
 
-    /// Retrieves the transaction IDs of all transactions currently in the mempool
+    /// Retrieves the `Txid`s for all transactions in the mempool.
     ///
     /// # Returns
     ///
@@ -215,7 +215,7 @@ impl Client {
             .map(|txids| txids.0)
     }
 
-    /// Retrieves the raw transaction data for a given transaction ID
+    /// Retrieves the raw transaction data for a given transaction ID.
     ///
     /// # Arguments
     ///