bitcoin-u160 0.1.19

A Rust crate for efficiently handling 160-bit opaque blobs, commonly used in cryptographic and Bitcoin-related contexts, with support for conversion from strings and byte arrays.
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

// ---------------- [ File: bitcoin-u160/src/from_le_bytes.rs ]
crate::ix!();

impl u160 {
    /// Construct a `u160` directly from a **little‑endian** 20‑byte array.
    ///
    /// This mirrors the standard‑library convention (`u32::from_le_bytes`, etc.)
    /// and simply forwards to the existing `from_bytes_20` constructor,
    /// emitting a `trace!` for observability.
    #[inline]
    pub fn from_le_bytes(mut bytes: [u8; 20]) -> Self {
        tracing::trace!(
            "u160::from_le_bytes ⇒ {:02X?}",
            bytes
        );
        // Convert caller-provided little-endian bytes into the blob's
        // canonical big-endian representation (match u256 behavior).
        bytes.reverse();
        Self::from_bytes_20(bytes)
    }
}

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

    /// Ensure `from_le_bytes` round‑trips the data verbatim.
    #[traced_test]
    fn round_trip_le_bytes() {
        info!("Verifying u160::from_le_bytes → as_slice() round‑trip.");

        let original: [u8; 20] = [
            0x01, 0x02, 0x03, 0x04, 0x05,
            0x06, 0x07, 0x08, 0x09, 0x0A,
            0x0B, 0x0C, 0x0D, 0x0E, 0x0F,
            0x10, 0x11, 0x12, 0x13, 0x14,
        ];
        let value = u160::from_le_bytes(original);
        trace!("Constructed value: {}", value.to_string());

        assert_eq!(
            value.as_slice(),
            &original,
            "Little‑endian bytes must be stored verbatim"
        );
    }
}