mx-core 0.1.0

Core utilities for MultiversX Rust services.
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

# mx-core

Core utilities shared across MultiversX Rust services.

## Features

- **Wallet Derivation**: BIP39 mnemonic to Ed25519 signing keys
- **Shard Computation**: Matching mx-chain-go algorithm
- **Address Encoding**: Bech32 encode/decode utilities
- **BigIntCaster Helpers**: Go-compatible big integer encode/decode plus unsigned amount parsing
- **Topic System**: P2P gossipsub topic generation and parsing
- **Protocol Constants**: Centralized network constants

## Usage

```rust
use mx_core::{
    // Wallet derivation
    derive_signing_key, derive_address,
    // Shard computation
    shard_of, shard_of_address_bytes, select_shard, shard_of_bytes,
    decode_embedded_receiver,
    // Address encoding
    decode_bech32, encode_bech32,
    // Big integer helpers
    parse_big_uint, encode_big_int_caster, decode_big_int_caster,
    // Topic system
    BaseTopic, TopicInfo, TopicRouting, TopicShard,
    broadcast_topic, transaction_topics_from_shards,
    // Constants
    META_SHARD_ID, METACHAIN_SHARD_ID, ALL_SHARD_ID,
    TX_OPTION_HASH_SIGN, TX_OPTION_GUARDED,
    // Encoding utilities
    decode_base64, decode_hex, decode_base64_or_hex,
};

// Derive wallet from mnemonic
let key = derive_signing_key(mnemonic, 0, 0)?;
let address = derive_address(mnemonic, 0, 0)?;

// Compute shard (multiple methods)
let shard = shard_of(&address, 3)?;
let shard = shard_of_address_bytes(&raw_bytes, 3);
let shard = select_shard(last_byte, 3);

// Parse topic (with caching for hot paths)
let info = TopicInfo::parse("transactions_0_1");
let info = TopicInfo::parse_cached("transactions_0_1"); // cached version
```

## Modules

| Module | Description |
|--------|-------------|
| `wallet` | Ed25519 key derivation from BIP39 mnemonics |
| `shard` | Shard computation matching mx-chain-go |
| `bech32_utils` | Address encoding/decoding |
| `bigint` | Go BigIntCaster helpers and unsigned amount parsing |
| `topics` | P2P topic generation and parsing |
| `constants` | Protocol constants |
| `encoding` | Base64/hex utilities |
| `mnemonic` | Mnemonic normalization |

## Performance

- `shard_of_address_bytes`: ~30ns (pre-decoded)
- `shard_of`: ~530ns (includes bech32 decode)
- Topic parsing: Cached for hot paths