harmoniis-wallet 0.1.109

Smart-contract wallet for the Harmoniis marketplace for agents and robots (RGB contracts, Witness-backed bearer state, Webcash fees)
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

//! Centralized configuration for the harmoniis-wallet crate.
//!
//! All configurable values (URLs, timeouts, network settings) flow through
//! [`WalletConfig`]. Construct via [`WalletConfig::from_env()`] or use
//! [`WalletConfig::default()`] for production defaults.

use std::time::Duration;

/// Centralized configuration for harmoniis-wallet.
///
/// All hardcoded defaults are collected here. Consumers should construct
/// this once at startup and pass it through to wallet components.
#[derive(Debug, Clone)]
pub struct WalletConfig {
    // ── Harmoniis API ────────────────────────────────────────────────────
    pub harmoniis_api_url: String,
    pub harmoniis_direct_url: Option<String>,
    pub http_timeout: Duration,

    // ── Bitcoin ──────────────────────────────────────────────────────────
    /// Network name: "bitcoin", "testnet", "signet", "regtest".
    pub bitcoin_network: String,
    pub esplora_url: Option<String>,

    // ── ARK ──────────────────────────────────────────────────────────────
    pub ark_asp_url: String,
    pub ark_boltz_url: String,
    pub ark_connect_timeout: Duration,

    // ── Webcash ─────────────────────────────────────────────────────────
    pub webcash_server_url: String,

    // ── Storage ─────────────────────────────────────────────────────────
    pub s3_bucket: Option<String>,
    pub s3_prefix: String,
    pub secret_manager_arn: Option<String>,
}

impl Default for WalletConfig {
    fn default() -> Self {
        Self {
            harmoniis_api_url: "https://harmoniis.com/api".to_string(),
            harmoniis_direct_url: None,
            http_timeout: Duration::from_secs(30),
            bitcoin_network: "bitcoin".to_string(),
            esplora_url: None,
            ark_asp_url: "https://arkade.computer".to_string(),
            ark_boltz_url: "https://api.boltz.exchange/v2".to_string(),
            ark_connect_timeout: Duration::from_secs(30),
            webcash_server_url: webylib::NetworkMode::Production.base_url().to_string(),
            s3_bucket: None,
            s3_prefix: "wallet/".to_string(),
            secret_manager_arn: None,
        }
    }
}

impl WalletConfig {
    /// Build config from environment variables, falling back to defaults.
    pub fn from_env() -> Self {
        let mut config = Self::default();

        if let Ok(v) = std::env::var("HARMONIIS_API_URL") { config.harmoniis_api_url = v; }
        if let Ok(v) = std::env::var("HARMONIIS_DIRECT_URL") { config.harmoniis_direct_url = Some(v); }
        if let Ok(v) = std::env::var("HARMONIIS_HTTP_TIMEOUT_SECS") {
            if let Ok(secs) = v.parse::<u64>() { config.http_timeout = Duration::from_secs(secs); }
        }
        if let Ok(v) = std::env::var("HARMONIIS_BITCOIN_NETWORK") { config.bitcoin_network = v.to_lowercase(); }
        if let Ok(v) = std::env::var("HARMONIIS_ESPLORA_URL") { config.esplora_url = Some(v); }
        if let Ok(v) = std::env::var("HARMONIIS_ARK_ASP_URL") { config.ark_asp_url = v; }
        if let Ok(v) = std::env::var("HARMONIIS_ARK_BOLTZ_URL") { config.ark_boltz_url = v; }
        if let Ok(v) = std::env::var("HARMONIIS_WEBCASH_SERVER_URL") { config.webcash_server_url = v; }
        if let Ok(v) = std::env::var("HRMW_WALLET_S3_BUCKET") { config.s3_bucket = Some(v); }
        if let Ok(v) = std::env::var("HRMW_WALLET_S3_PREFIX") { config.s3_prefix = v; }
        if let Ok(v) = std::env::var("HARMONIIS_MASTER_MNEMONIC_ARN") { config.secret_manager_arn = Some(v); }

        config
    }

    /// Resolve the effective Esplora URL for the configured network.
    pub fn effective_esplora_url(&self) -> String {
        if let Some(url) = &self.esplora_url {
            return url.clone();
        }
        match self.bitcoin_network.as_str() {
            "testnet" => "https://blockstream.info/testnet/api".to_string(),
            "signet" => "https://blockstream.info/signet/api".to_string(),
            "regtest" => "http://127.0.0.1:3002".to_string(),
            _ => "https://blockstream.info/api".to_string(),
        }
    }

    /// Parse the network string into a BDK Network enum (native only).
    #[cfg(feature = "bitcoin")]
    pub fn bdk_network(&self) -> bdk_wallet::bitcoin::Network {
        match self.bitcoin_network.as_str() {
            "testnet" => bdk_wallet::bitcoin::Network::Testnet,
            "signet" => bdk_wallet::bitcoin::Network::Signet,
            "regtest" => bdk_wallet::bitcoin::Network::Regtest,
            _ => bdk_wallet::bitcoin::Network::Bitcoin,
        }
    }
}