cdk-lnd 0.18.0

CDK payment backend for lnd
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

//! LND Errors

use thiserror::Error;
use tonic::Status;

/// LND Error
#[derive(Debug, Error)]
pub enum Error {
    /// Amount Error
    #[error(transparent)]
    Amount(#[from] cdk_common::amount::Error),
    /// Invoice amount not defined
    #[error("Unknown invoice amount")]
    UnknownInvoiceAmount,
    /// Unknown invoice
    #[error("Unknown invoice")]
    UnknownInvoice,
    /// Connection error
    #[error("LND connection error")]
    Connection,
    /// Invalid hash
    #[error("Invalid hash")]
    InvalidHash,
    /// Payment failed
    #[error("LND payment failed")]
    PaymentFailed,
    /// Payment dispatch outcome is indeterminate
    ///
    /// Returned when a `send_*` call or its status stream fails at the
    /// dispatch boundary: LND may or may not have accepted the payment. This
    /// is deliberately distinct from [`Error::PaymentFailed`], which is only
    /// constructed after every route retry ended in a definitive no-route
    /// result (i.e. pre-dispatch). Backends must keep this variant out of the
    /// terminal-failure classifier so the melt stays indeterminate.
    #[error("LND payment dispatch outcome is indeterminate")]
    AmbiguousDispatch,
    /// Unknown payment status
    #[error("LND unknown payment status")]
    UnknownPaymentStatus,
    /// Missing last hop in route
    #[error("LND missing last hop in route")]
    MissingLastHop,
    /// No route found
    #[error("No route found")]
    NoRoute,
    /// Amount overflow
    #[error("Amount overflow")]
    AmountOverflow,
    /// Errors coming from the backend
    #[error("LND error: `{0}`")]
    LndError(Status),
    /// Errors invalid config
    #[error("LND invalid config: `{0}`")]
    InvalidConfig(String),
    /// Could not read file
    #[error("Could not read file")]
    ReadFile,
    /// Database Error
    #[error("Database error: {0}")]
    Database(String),
}

impl From<Error> for cdk_common::payment::Error {
    fn from(e: Error) -> Self {
        Self::Backend(Box::new(e))
    }
}