lnbot 1.0.0

Official Rust SDK for LnBot — Bitcoin for AI Agents. Send and receive sats over Lightning.
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

use thiserror::Error;

/// Errors returned by the LnBot SDK.
#[derive(Error, Debug)]
#[non_exhaustive]
pub enum LnBotError {
    /// The server rejected the request as invalid (HTTP 400).
    #[error("Bad Request (400): {body}")]
    BadRequest { body: String },

    /// The API key is missing or invalid (HTTP 401).
    #[error("Unauthorized (401): {body}")]
    Unauthorized { body: String },

    /// The API key lacks permission for this operation (HTTP 403).
    #[error("Forbidden (403): {body}")]
    Forbidden { body: String },

    /// The requested resource was not found (HTTP 404).
    #[error("Not Found (404): {body}")]
    NotFound { body: String },

    /// The request conflicted with existing state (HTTP 409).
    #[error("Conflict (409): {body}")]
    Conflict { body: String },

    /// An API error with a non-standard status code.
    #[error("API error (HTTP {status}): {body}")]
    Api { status: u16, body: String },

    /// An HTTP transport error from `reqwest`.
    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),

    /// A JSON serialization or deserialization error.
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),
}

pub(crate) fn from_status(status: u16, body: String) -> LnBotError {
    match status {
        400 => LnBotError::BadRequest { body },
        401 => LnBotError::Unauthorized { body },
        403 => LnBotError::Forbidden { body },
        404 => LnBotError::NotFound { body },
        409 => LnBotError::Conflict { body },
        _ => LnBotError::Api { status, body },
    }
}