bsv-sdk 0.2.81

Pure Rust implementation of the BSV Blockchain SDK
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

//! Wallet wire transport substrates.
//!
//! Provides the wire protocol infrastructure for remote wallet access:
//! - WalletWire trait: abstraction over binary transport
//! - WalletWireCalls: enum of 28 call codes
//! - WalletWireTransceiver: client-side WalletInterface over wire
//! - WalletWireProcessor: server-side dispatch to wallet implementation
//! - WalletClient: validation layer wrapping a wire transport
//! - HTTPWalletWire: HTTP binary transport (network feature)
//! - HTTPWalletJSON: HTTP JSON transport (network feature)

pub mod wallet_client;
pub mod wallet_wire_calls;
pub mod wallet_wire_processor;
pub mod wallet_wire_transceiver;

#[cfg(feature = "network")]
pub mod http_wallet_json;
#[cfg(feature = "network")]
pub mod http_wallet_wire;

use async_trait::async_trait;

use crate::wallet::error::WalletError;

pub use wallet_client::WalletClient;
pub use wallet_wire_calls::WalletWireCall;
pub use wallet_wire_processor::WalletWireProcessor;
pub use wallet_wire_transceiver::WalletWireTransceiver;

#[cfg(feature = "network")]
pub use http_wallet_json::HttpWalletJson;
#[cfg(feature = "network")]
pub use http_wallet_wire::HttpWalletWire;

/// Abstraction over a raw transport medium where binary data can be sent
/// to and received from a wallet.
///
/// Uses `#[async_trait]` for object safety, matching WalletInterface.
/// Supports both static dispatch (`W: WalletWire`) and dynamic dispatch (`dyn WalletWire`).
#[async_trait]
pub trait WalletWire: Send + Sync {
    /// Send a binary message to the wallet and receive the response.
    async fn transmit_to_wallet(&self, message: &[u8]) -> Result<Vec<u8>, WalletError>;
}

#[cfg(test)]
mod tests;