multiversx-sdk 0.16.1

SDK for interacting with the MultiversX blockchain
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

use multiversx_chain_core::types::ShardId;

use crate::wallet::Wallet;

const ALICE_PEM: &str = include_str!("test_wallets/alice.pem");
const BOB_PEM: &str = include_str!("test_wallets/bob.pem");
const CAROL_PEM: &str = include_str!("test_wallets/carol.pem");
const DAN_PEM: &str = include_str!("test_wallets/dan.pem");
const EVE_PEM: &str = include_str!("test_wallets/eve.pem");
const FRANK_PEM: &str = include_str!("test_wallets/frank.pem");
const GRACE_PEM: &str = include_str!("test_wallets/grace.pem");
const HEIDI_PEM: &str = include_str!("test_wallets/heidi.pem");
const IVAN_PEM: &str = include_str!("test_wallets/ivan.pem");
const JUDY_PEM: &str = include_str!("test_wallets/judy.pem");
const MALLORY_PEM: &str = include_str!("test_wallets/mallory.pem");
const MIKE_PEM: &str = include_str!("test_wallets/mike.pem");
const SOPHIE_PEM: &str = include_str!("test_wallets/s0phie.pem");
const SIMON_PEM: &str = include_str!("test_wallets/s1mon.pem");
const SZONJA_PEM: &str = include_str!("test_wallets/s2onja.pem");

const WALLETS: &[(&str, &str)] = &[
    ("alice", ALICE_PEM),
    ("bob", BOB_PEM),
    ("carol", CAROL_PEM),
    ("dan", DAN_PEM),
    ("eve", EVE_PEM),
    ("frank", FRANK_PEM),
    ("grace", GRACE_PEM),
    ("heidi", HEIDI_PEM),
    ("ivan", IVAN_PEM),
    ("judy", JUDY_PEM),
    ("mallory", MALLORY_PEM),
    ("mike", MIKE_PEM),
    ("sophie", SOPHIE_PEM),
    ("s0phie", SOPHIE_PEM),
    ("simon", SIMON_PEM),
    ("s1mon", SIMON_PEM),
    ("szonja", SZONJA_PEM),
    ("s2onja", SZONJA_PEM),
];

fn test_wallet(pem_file_contents: &str) -> Wallet {
    Wallet::from_pem_file_contents(pem_file_contents.to_string()).unwrap()
}

/// Test wallet. Do not use on mainnet.
pub fn alice() -> Wallet {
    test_wallet(ALICE_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn bob() -> Wallet {
    test_wallet(BOB_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn carol() -> Wallet {
    test_wallet(CAROL_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn dan() -> Wallet {
    test_wallet(DAN_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn eve() -> Wallet {
    test_wallet(EVE_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn frank() -> Wallet {
    test_wallet(FRANK_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn grace() -> Wallet {
    test_wallet(GRACE_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn heidi() -> Wallet {
    test_wallet(HEIDI_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn ivan() -> Wallet {
    test_wallet(IVAN_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn judy() -> Wallet {
    test_wallet(JUDY_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn mallory() -> Wallet {
    test_wallet(MALLORY_PEM)
}

/// Test wallet. Do not use on mainnet.
pub fn mike() -> Wallet {
    test_wallet(MIKE_PEM)
}

/// Test wallet. Do not use on mainnet.
///
/// Sophie's wallet will always be in shard 0.
///
/// Address: 0x14af28ce7d79117f689228b1af89d16e8b0c16a3d36062a2b6eeb8fbab6c0000
pub fn sophie() -> Wallet {
    test_wallet(SOPHIE_PEM)
}

/// Test wallet. Do not use on mainnet.
///
/// Simon's wallet will always be in shard 1.
///
/// Address: 0x4b9ab2524a7d15416fb78d4d88249dc30272bd6ee1b8a07d4342c33a40a00001
pub fn simon() -> Wallet {
    test_wallet(SIMON_PEM)
}

/// Test wallet. Do not use on mainnet.
///
/// Szonja's wallet will always be in shard 2.
///
/// Address: 0x5ea3f378aaaa9f51cef76093b62e1041c90b415016dfa49760d7a846a8d90002
pub fn szonja() -> Wallet {
    test_wallet(SZONJA_PEM)
}

/// Test wallets. Do not use on mainnet.
///
/// Yields a wallet for the given shard id. Only shard ids 0, 1, and 2 are supported.
pub fn for_shard(shard_id: ShardId) -> Wallet {
    let shard_id_num = shard_id.as_u32();
    match shard_id_num {
        0 => sophie(),
        1 => simon(),
        2 => szonja(),
        _ => panic!("No test wallet for shard id {shard_id_num}"),
    }
}

pub fn valid_names() -> Vec<&'static str> {
    WALLETS.iter().map(|(n, _)| *n).collect()
}

/// Returns the raw PEM file contents for the named test wallet, or `None` if the name is unknown.
///
/// For the list of valid names see [`valid_names()`].
pub fn pem_contents(name: &str) -> Option<&'static str> {
    WALLETS
        .iter()
        .find(|(n, _)| *n == name)
        .map(|(_, pem)| *pem)
}