mx_core/
lib.rs

1//! Core utilities for `MultiversX` Rust services.
2//!
3//! This crate provides shared functionality used across mx-relayer, mx-stress, and mx-notifier:
4//! - Protocol constants (shard IDs, transaction options)
5//! - Mnemonic normalization
6//! - Shard computation (matching mx-chain-go algorithm)
7//! - Bech32 address encoding/decoding
8//! - Go `BigIntCaster` encode/decode helpers and unsigned amount parsing
9//! - Base64/hex encoding utilities
10//! - Wallet derivation (Ed25519 signing keys and addresses from BIP39 mnemonics)
11
12mod bech32_utils;
13mod bigint;
14mod constants;
15mod encoding;
16mod error;
17pub mod leader;
18mod mnemonic;
19pub mod resilience;
20mod shard;
21mod topics;
22mod wallet;
23pub mod ws_protocol;
24
25// Re-export public API
26pub use bech32_utils::{decode_bech32, decode_optional_bech32, encode_bech32};
27pub use bigint::{decode_big_int_caster, encode_big_int_caster, parse_big_uint};
28#[allow(deprecated)]
29pub use constants::{
30    ALL_SHARD_ID, META_SHARD_ID, METACHAIN_SHARD_ID, TX_OPTION_GUARDED, TX_OPTION_HASH_SIGN,
31};
32pub use encoding::{
33    decode_base64, decode_base64_bytes, decode_base64_or_hex, decode_hex, decode_optional_base64,
34    decode_optional_hex, filter_username,
35};
36pub use error::CoreError;
37pub use leader::{
38    ConsensusMsgType, ConsensusSignal, EligibleValidator, decode_consensus_signal, epoch_shuffle,
39    select_consensus_group, select_leader,
40};
41pub use mnemonic::normalize_mnemonic;
42pub use shard::{
43    decode_embedded_receiver, select_shard, shard_of, shard_of_address_bytes, shard_of_bytes,
44};
45pub use topics::{
46    BaseTopic, TRANSACTIONS_BASE_TOPIC, TopicInfo, TopicRouting, TopicShard, all_topics_for_shards,
47    broadcast_topic, communication_identifier_between_shards, transaction_topics_from_shards,
48};
49pub use wallet::{derive_address, derive_signing_key};
mx_core/lib.rs

mx_core/
lib.rs
