storm_rpc 0.9.0

Storm node RPC API
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

// RGB node providing smart contracts functionality for Bitcoin & Lightning.
//
// Written in 2022 by
//     Dr. Maxim Orlovsky <orlovsky@lnp-bp.org>
//
// Copyright (C) 2022 by LNP/BP Standards Association, Switzerland.
//
// You should have received a copy of the MIT License along with this software.
// If not, see <https://opensource.org/licenses/MIT>.

use std::str::FromStr;

use internet2::addr::NodeId;
use lnp2p::bifrost::BifrostApp;
use microservices::esb;
use microservices::esb::{ClientId, ServiceName};
use storm::StormApp;
use strict_encoding::{strict_deserialize, strict_serialize};

pub type DaemonId = u64;

/// Identifiers of daemons participating in LNP Node
#[derive(Clone, PartialEq, Eq, Hash, Debug, Display, From, StrictEncode, StrictDecode)]
pub enum ServiceId {
    #[display("stormd")]
    #[strict_encoding(value = 0x25)] // This mimics Bifrost LNP storm service id
    MsgApp(BifrostApp),

    #[display("chapp<{0}>")]
    #[strict_encoding(value = 0x24)]
    ChannelApp(BifrostApp),

    /// Storm application daemon. For sending messages to [`StormApp::System`] a
    /// [`ServiceId::stormd()`] must be used.
    #[display("app<{0}>")]
    #[strict_encoding(value = 0x41)]
    StormApp(StormApp),

    #[display("client<{0}>")]
    #[strict_encoding(value = 2)]
    Client(ClientId),

    #[display("lnpd")]
    #[strict_encoding(value = 0x20)]
    Lnp,

    #[display("peerd<bifrost, {0}>")]
    #[from]
    #[strict_encoding(value = 0x22)]
    Peer(NodeId),

    #[display("tansferd<{0}>")]
    #[strict_encoding(value = 0x42)]
    Transfer(DaemonId),

    #[display("other<{0}>")]
    #[strict_encoding(value = 0xFF)]
    Other(ServiceName),
}

impl ServiceId {
    pub fn stormd() -> ServiceId { ServiceId::MsgApp(BifrostApp::Storm) }
    pub fn chatd() -> ServiceId { ServiceId::StormApp(StormApp::Chat) }
    pub fn downpourd() -> ServiceId { ServiceId::StormApp(StormApp::FileTransfer) }
}

impl esb::ServiceAddress for ServiceId {}

impl From<ServiceId> for Vec<u8> {
    fn from(daemon_id: ServiceId) -> Self {
        strict_serialize(&daemon_id).expect("Memory-based encoding does not fail")
    }
}

impl From<Vec<u8>> for ServiceId {
    fn from(vec: Vec<u8>) -> Self {
        strict_deserialize(&vec).unwrap_or_else(|_| {
            ServiceId::Other(
                ServiceName::from_str(&String::from_utf8_lossy(&vec))
                    .expect("ClientName conversion never fails"),
            )
        })
    }
}