qorechain-sdk 0.3.0

QoreChain SDK for Rust: networks, denom/address utils, HD accounts (native/EVM/SVM), ML-DSA-87 PQC signing, typed messages for all custom modules, tx lifecycle (auto-gas, tracking, search), typed queries, WS subscriptions, and REST/JSON-RPC read clients.
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

//! Built-in network presets for the QoreChain Rust SDK.
//!
//! Both the `testnet` and `mainnet` presets are fully populated and live; their
//! endpoints default to localhost ports so the SDK works out of the box against
//! a locally running node, and callers can override them with real hostnames.
//! [`get_network`] returns either preset.

use crate::error::{Error, Result};

/// bech32 human-readable prefixes used across QoreChain address types.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Bech32Prefixes {
    /// Account address prefix (e.g. `qor`).
    pub account: String,
    /// Validator operator address prefix (e.g. `qorvaloper`).
    pub validator: String,
    /// Validator consensus address prefix (e.g. `qorvalcons`).
    pub consensus: String,
}

/// Display and base denomination metadata for the network's staking coin.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct CoinInfo {
    /// Display denom (e.g. `QOR`).
    pub display: String,
    /// Base denom (e.g. `uqor`).
    pub base: String,
    /// Decimal exponent (1 display = 10^exponent base).
    pub exponent: u32,
}

/// Service endpoints for talking to a network across its supported VMs.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Endpoints {
    /// Cosmos REST (LCD) endpoint.
    pub rest: String,
    /// Cosmos gRPC endpoint.
    pub grpc: String,
    /// Consensus RPC endpoint.
    pub rpc: String,
    /// EVM JSON-RPC endpoint.
    pub evm_rpc: String,
    /// EVM WebSocket endpoint.
    pub evm_ws: String,
    /// SVM JSON-RPC endpoint.
    pub svm_rpc: String,
}

/// A fully described network preset.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct NetworkConfig {
    /// Preset name.
    pub name: String,
    /// Whether the network is live.
    pub live: bool,
    /// Chain ID.
    pub chain_id: Option<String>,
    /// bech32 prefixes.
    pub bech32: Bech32Prefixes,
    /// Staking coin metadata.
    pub coin: CoinInfo,
    /// Service endpoints.
    pub endpoints: Option<Endpoints>,
}

fn bech32_prefixes() -> Bech32Prefixes {
    Bech32Prefixes {
        account: "qor".into(),
        validator: "qorvaloper".into(),
        consensus: "qorvalcons".into(),
    }
}

fn coin_info() -> CoinInfo {
    CoinInfo {
        display: "QOR".into(),
        base: "uqor".into(),
        exponent: 6,
    }
}

/// Returns the built-in network presets in stable order: `[testnet, mainnet]`.
pub fn networks() -> Vec<NetworkConfig> {
    vec![
        NetworkConfig {
            name: "testnet".into(),
            live: true,
            chain_id: Some("qorechain-diana".into()),
            bech32: bech32_prefixes(),
            coin: coin_info(),
            endpoints: Some(Endpoints {
                rest: "http://localhost:1317".into(),
                grpc: "http://localhost:9090".into(),
                rpc: "http://localhost:26657".into(),
                evm_rpc: "http://localhost:8545".into(),
                evm_ws: "ws://localhost:8546".into(),
                svm_rpc: "http://localhost:8899".into(),
            }),
        },
        NetworkConfig {
            name: "mainnet".into(),
            live: true,
            chain_id: Some("qorechain-vladi".into()),
            bech32: bech32_prefixes(),
            coin: coin_info(),
            endpoints: Some(Endpoints {
                rest: "http://localhost:1317".into(),
                grpc: "http://localhost:9090".into(),
                rpc: "http://localhost:26657".into(),
                evm_rpc: "http://localhost:8545".into(),
                evm_ws: "ws://localhost:8546".into(),
                svm_rpc: "http://localhost:8899".into(),
            }),
        },
    ]
}

/// Resolves a network preset by name.
///
/// Returns an error if the named network is unknown.
pub fn get_network(name: &str) -> Result<NetworkConfig> {
    networks()
        .into_iter()
        .find(|n| n.name == name)
        .ok_or_else(|| Error::UnknownNetwork(name.to_string()))
}

/// Lists the known network preset names without any liveness check.
pub fn list_networks() -> Vec<String> {
    vec!["testnet".into(), "mainnet".into()]
}