thruput-xdr 0.63.0

Bindings for Thruput protocol structures
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

//! The 32-byte [`ContractAddress`] of each address the protocol reserves at
//! genesis: the null address and the contracts placed there.
//!
//! [`GenesisContractAddresses`] numbers these addresses; the address is that
//! number in big-endian order in the last four bytes, with every other byte
//! zero.
//!
//! ```
//! use thruput_xdr::genesis_addresses::ADDRESS_NATIVE_TOKEN;
//!
//! let mut bytes = [0u8; 32];
//! bytes[31] = 1;
//! assert_eq!(*ADDRESS_NATIVE_TOKEN, bytes);
//! ```

use crate::genesis::GenesisContractAddresses;
use crate::types::ContractAddress;

/// Returns the [`ContractAddress`] of the genesis contract `addr` names.
const fn genesis_contract_address(
    addr: GenesisContractAddresses,
) -> ContractAddress {
    let mut bytes = [0u8; 32];
    let id = addr.0.to_be_bytes();
    bytes[28] = id[0];
    bytes[29] = id[1];
    bytes[30] = id[2];
    bytes[31] = id[3];
    ContractAddress::new(bytes)
}

/// The reserved null address: all 32 bytes zero.
pub const ADDRESS_NULL: ContractAddress =
    genesis_contract_address(GenesisContractAddresses::kAddressNull);

/// Address of the precompiled native-token contract.
pub const ADDRESS_NATIVE_TOKEN: ContractAddress =
    genesis_contract_address(GenesisContractAddresses::kAddressNativeToken);

/// Address of the genesis root contract.
pub const ADDRESS_GENESIS_ROOT: ContractAddress =
    genesis_contract_address(GenesisContractAddresses::kAddressGenesisRoot);

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn addresses_pack_the_genesis_id_into_the_last_four_bytes() {
        assert_eq!(*ADDRESS_NULL, [0u8; 32]);

        let mut native = [0u8; 32];
        native[31] = 1;
        assert_eq!(*ADDRESS_NATIVE_TOKEN, native);

        let mut root = [0u8; 32];
        root[31] = 2;
        assert_eq!(*ADDRESS_GENESIS_ROOT, root);

        assert_eq!(
            *genesis_contract_address(GenesisContractAddresses(0x0102_0304)),
            [
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 1, 2, 3, 4,
            ],
        );
    }
}