lnsocket 0.5.1

An async lightning network socket with with core-lightning rpc support
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

use crate::ln::msgs::{DecodeError, LightningError};
use serde::Deserialize;
use std::fmt;
use std::io;
use std::net::AddrParseError;

/// Errors surfaced by this crate.
///
/// Notably, I/O failures are reduced to an `io::ErrorKind` so the type stays small and Send/Sync.
/// For example, DNS resolution failure maps to `Error::DnsError`, other I/O paths map to
/// `Error::Io(kind)`.
///
/// Display is human-readable; use pattern matching if you need to branch on kinds.
#[derive(Debug, Clone)]
pub enum Error {
    NotConnected,
    FirstMessageNotInit,
    DnsError,
    Io(io::ErrorKind),
    Json,
    Lightning(LightningError),
    Decode(DecodeError),
    AddrParse(std::net::AddrParseError),
    Rpc(RpcError),
}

#[derive(Debug, Clone, Deserialize)]
pub struct RpcError {
    pub code: i64,
    pub message: String,
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Error::NotConnected => write!(f, "Not connected to server"),
            Error::FirstMessageNotInit => write!(f, "First message was not init"),
            Error::DnsError => write!(f, "Failed to resolve hostname"),
            Error::Io(kind) => write!(f, "I/O error: {}", kind),
            Error::Lightning(err) => write!(f, "Lightning error: {:?}", err),
            Error::Decode(err) => write!(f, "decoding error: {:?}", err),
            Error::Json => write!(f, "json error"),
            Error::AddrParse(err) => write!(f, "Address parse error: {err}"),
            Error::Rpc(err) => write!(f, "commando rpc error: {err:?}"),
        }
    }
}

impl From<io::Error> for Error {
    fn from(err: io::Error) -> Self {
        Self::Io(err.kind())
    }
}

impl From<serde_json::Error> for Error {
    fn from(_err: serde_json::Error) -> Self {
        Self::Json
    }
}

impl From<DecodeError> for Error {
    fn from(decode: DecodeError) -> Self {
        Self::Decode(decode)
    }
}

impl From<LightningError> for Error {
    fn from(lnerr: LightningError) -> Self {
        Self::Lightning(lnerr)
    }
}

impl From<AddrParseError> for Error {
    fn from(err: AddrParseError) -> Self {
        Self::AddrParse(err)
    }
}