ton_lib_core 0.0.7

A collection of types and utilities for interacting with the TON network
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

use bitstream_io::Integer;
use num_bigint::{BigInt, BigUint};
use num_traits::Zero;
use std::fmt::Display;

/// Allows generic read/write operation for any numeric type
pub trait TonCellNum: Display + Sized + Clone {
    const SIGNED: bool;
    const IS_PRIMITIVE: bool;
    type Primitive: Zero + Integer;
    type UnsignedPrimitive: Integer;

    fn tcn_from_bytes(bytes: &[u8]) -> Self;
    fn tcn_to_bytes(&self) -> Vec<u8>;

    fn tcn_from_primitive(value: Self::Primitive) -> Self;
    fn tcn_to_unsigned_primitive(&self) -> Option<Self::UnsignedPrimitive>;

    fn tcn_is_zero(&self) -> bool;
    fn tcn_min_bits_len(&self) -> usize; // must includes sign bit if SIGNED=true
    fn tcn_shr(&self, bits: usize) -> Self;
}

// Implementation for primitive types
macro_rules! ton_cell_num_primitive_impl {
    ($src:ty, $sign:tt, $unsign:ty) => {
        impl TonCellNum for $src {
            const SIGNED: bool = $sign;
            const IS_PRIMITIVE: bool = true;
            type Primitive = $src;
            type UnsignedPrimitive = $unsign;
            fn tcn_from_bytes(_bytes: &[u8]) -> Self { unreachable!() }
            fn tcn_to_bytes(&self) -> Vec<u8> { unreachable!() }

            fn tcn_from_primitive(value: Self::Primitive) -> Self { value }
            fn tcn_to_unsigned_primitive(&self) -> Option<Self::UnsignedPrimitive> { Some(*self as $unsign) }

            fn tcn_is_zero(&self) -> bool { *self == 0 }
            fn tcn_min_bits_len(&self) -> usize { unreachable!() }
            fn tcn_shr(&self, _bits: usize) -> Self { unreachable!() }
        }
    };
}

ton_cell_num_primitive_impl!(i8, true, u8);
ton_cell_num_primitive_impl!(u8, false, u8);
ton_cell_num_primitive_impl!(i16, true, u16);
ton_cell_num_primitive_impl!(u16, false, u16);
ton_cell_num_primitive_impl!(i32, true, u32);
ton_cell_num_primitive_impl!(u32, false, u32);
ton_cell_num_primitive_impl!(i64, true, u64);
ton_cell_num_primitive_impl!(u64, false, u64);
ton_cell_num_primitive_impl!(i128, true, u128);
ton_cell_num_primitive_impl!(u128, false, u128);

// Implementation for usize
impl TonCellNum for usize {
    const SIGNED: bool = false;
    const IS_PRIMITIVE: bool = true;
    type Primitive = u128;
    type UnsignedPrimitive = u128;
    fn tcn_from_bytes(_bytes: &[u8]) -> Self { unreachable!() }
    fn tcn_to_bytes(&self) -> Vec<u8> { unreachable!() }

    fn tcn_from_primitive(value: Self::Primitive) -> Self { value as Self }
    fn tcn_to_unsigned_primitive(&self) -> Option<Self::UnsignedPrimitive> { Some(*self as u128) }

    fn tcn_is_zero(&self) -> bool { *self == 0 }
    fn tcn_min_bits_len(&self) -> usize { unreachable!() } // extra bit for sign
    fn tcn_shr(&self, _bits: usize) -> Self { unreachable!() }
}

// Implementation for BigInt and BigUint
impl TonCellNum for BigInt {
    const SIGNED: bool = true;
    const IS_PRIMITIVE: bool = false;
    type Primitive = i128;
    type UnsignedPrimitive = u128;
    fn tcn_from_bytes(bytes: &[u8]) -> Self { BigInt::from_signed_bytes_be(bytes) }
    fn tcn_to_bytes(&self) -> Vec<u8> { BigInt::to_signed_bytes_be(self) }

    fn tcn_from_primitive(value: Self::Primitive) -> Self { value.into() }
    fn tcn_to_unsigned_primitive(&self) -> Option<Self::UnsignedPrimitive> { None }

    fn tcn_is_zero(&self) -> bool { Zero::is_zero(self) }
    fn tcn_min_bits_len(&self) -> usize { self.bits() as usize + 1 } // extra bit for sign
    fn tcn_shr(&self, bits: usize) -> Self { self >> bits }
}

impl TonCellNum for BigUint {
    const SIGNED: bool = false;
    const IS_PRIMITIVE: bool = false;
    type Primitive = u128;
    type UnsignedPrimitive = u128;
    fn tcn_from_bytes(bytes: &[u8]) -> Self { BigUint::from_bytes_be(bytes) }
    fn tcn_to_bytes(&self) -> Vec<u8> { BigUint::to_bytes_be(self) }

    fn tcn_from_primitive(value: Self::Primitive) -> Self { value.into() }
    fn tcn_to_unsigned_primitive(&self) -> Option<Self::UnsignedPrimitive> { None }

    fn tcn_is_zero(&self) -> bool { Zero::is_zero(self) }
    fn tcn_min_bits_len(&self) -> usize { self.bits() as usize }
    fn tcn_shr(&self, bits: usize) -> Self { self >> bits }
}