mesc 0.3.0

libraries for creating, loading, and modifying MESC configuation data
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

use crate::{validate, ChainId, MescError};
use serde::{Deserialize, Serialize};
use std::collections::HashMap;

/// Endpoint
#[derive(Serialize, Deserialize, Debug, Clone, Eq, PartialEq)]
pub struct Endpoint {
    /// name
    pub name: String,
    /// url
    pub url: String,
    /// chain_id
    pub chain_id: Option<ChainId>,
    /// endpoint_metadata
    pub endpoint_metadata: HashMap<String, serde_json::Value>,
}

impl Endpoint {
    /// chain_id as String
    pub fn chain_id_string(&self) -> String {
        self.chain_id.clone().map(|x| x.to_string()).unwrap_or("-".to_string())
    }
}

/// Profile
#[derive(Serialize, Deserialize, Debug, Clone, Eq, PartialEq)]
pub struct Profile {
    /// name
    pub name: String,
    /// default_endpoint
    pub default_endpoint: Option<String>,
    /// network_defaults
    pub network_defaults: HashMap<ChainId, String>,
    /// profile metadata
    pub profile_metadata: HashMap<String, serde_json::Value>,
    /// use mesc
    pub use_mesc: bool,
}

impl Profile {
    /// create new profile
    pub fn new<T: Into<String>>(name: T) -> Profile {
        Profile {
            name: name.into(),
            default_endpoint: None,
            network_defaults: HashMap::new(),
            profile_metadata: HashMap::new(),
            use_mesc: true,
        }
    }
}

/// ConfigMode
#[derive(Debug)]
pub enum ConfigMode {
    /// Path
    Path,
    /// Env
    Env,
    /// Disabled
    Disabled,
}

/// RpcConfig
#[derive(Serialize, Deserialize, Debug, Clone, Eq, PartialEq)]
pub struct RpcConfig {
    /// mesc version
    pub mesc_version: String,
    /// default endpoint
    pub default_endpoint: Option<String>,
    /// endpoints
    pub endpoints: HashMap<String, Endpoint>,
    /// network defaults
    pub network_defaults: HashMap<ChainId, String>,
    /// network names
    pub network_names: HashMap<String, ChainId>,
    /// profile
    pub profiles: HashMap<String, Profile>,
    /// global metadata
    pub global_metadata: HashMap<String, serde_json::Value>,
}

impl Default for RpcConfig {
    fn default() -> Self {
        Self {
            mesc_version: env!("CARGO_PKG_VERSION").to_string(),
            default_endpoint: None,
            network_defaults: HashMap::new(),
            network_names: HashMap::new(),
            endpoints: HashMap::new(),
            profiles: HashMap::new(),
            global_metadata: HashMap::new(),
        }
    }
}

impl RpcConfig {
    /// serialize config
    pub fn serialize(&self) -> Result<String, MescError> {
        Ok(serde_json::to_string(self)?)
    }

    /// validate config
    pub fn validate(&self) -> Result<(), MescError> {
        validate::validate_config(self)
    }
}