vylth-flow 0.3.2

Official Rust SDK for Vylth Flow — self-custody crypto payment processing
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

use std::sync::Arc;
use std::time::Duration;

use crate::http::HttpClient;
use crate::resources::{
    invoices::InvoiceService, payouts::PayoutService, swaps::SwapService, wallets::WalletService,
    webhooks::WebhookVerifier, payment_links::PaymentLinkService, subscriptions::SubscriptionService,
    teams::TeamService,
};

const DEFAULT_BASE_URL: &str = "https://flow.vylth.com/api/flow";
const DEFAULT_TIMEOUT_SECS: u64 = 30;

/// The Vylth Flow client.
pub struct Flow {
    http: Arc<HttpClient>,
    webhook_secret: Option<String>,
}

impl Flow {
    /// Create a new client with the given API key.
    pub fn new(api_key: &str) -> Self {
        let http = Arc::new(HttpClient::new(
            api_key,
            DEFAULT_BASE_URL,
            Duration::from_secs(DEFAULT_TIMEOUT_SECS),
        ));
        Self {
            http,
            webhook_secret: None,
        }
    }

    /// Create a client using the builder pattern.
    pub fn builder(api_key: &str) -> FlowBuilder {
        FlowBuilder {
            api_key: api_key.to_string(),
            api_secret: None,
            base_url: DEFAULT_BASE_URL.to_string(),
            timeout: Duration::from_secs(DEFAULT_TIMEOUT_SECS),
            webhook_secret: None,
        }
    }

    pub fn invoices(&self) -> InvoiceService {
        InvoiceService {
            http: self.http.clone(),
        }
    }

    pub fn payouts(&self) -> PayoutService {
        PayoutService {
            http: self.http.clone(),
        }
    }

    pub fn wallets(&self) -> WalletService {
        WalletService {
            http: self.http.clone(),
        }
    }

    pub fn swaps(&self) -> SwapService {
        SwapService {
            http: self.http.clone(),
        }
    }

    pub fn payment_links(&self) -> PaymentLinkService {
        PaymentLinkService {
            http: self.http.clone(),
        }
    }

    pub fn subscriptions(&self) -> SubscriptionService {
        SubscriptionService {
            http: self.http.clone(),
        }
    }

    pub fn teams(&self) -> TeamService {
        TeamService {
            http: self.http.clone(),
        }
    }

    pub fn webhooks(&self) -> Option<WebhookVerifier> {
        self.webhook_secret
            .as_ref()
            .map(|s| WebhookVerifier::new(s))
    }
}

/// Builder for configuring the Flow client.
pub struct FlowBuilder {
    api_key: String,
    api_secret: Option<String>,
    base_url: String,
    timeout: Duration,
    webhook_secret: Option<String>,
}

impl FlowBuilder {
    pub fn base_url(mut self, url: &str) -> Self {
        self.base_url = url.to_string();
        self
    }

    pub fn timeout(mut self, timeout: Duration) -> Self {
        self.timeout = timeout;
        self
    }

    pub fn api_secret(mut self, secret: &str) -> Self {
        self.api_secret = Some(secret.to_string());
        self
    }

    pub fn webhook_secret(mut self, secret: &str) -> Self {
        self.webhook_secret = Some(secret.to_string());
        self
    }

    pub fn build(self) -> Flow {
        let mut client = HttpClient::new(&self.api_key, &self.base_url, self.timeout);
        if let Some(ref s) = self.api_secret {
            client = client.with_secret(s);
        }
        let http = Arc::new(client);
        Flow {
            http,
            webhook_secret: self.webhook_secret,
        }
    }
}