bitcoin_hashes 0.20.0

Hash functions used by the rust-bitcoin eccosystem
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
105
106

#[test]
#[cfg(feature = "alloc")]
#[cfg(feature = "hex")]
fn test() {
    use alloc::string::ToString;

    use crate::{ripemd160, HashEngine};

    #[derive(Clone)]
    struct Test {
        input: &'static str,
        output: [u8; 20],
        output_str: &'static str,
    }

    #[rustfmt::skip]
    let tests = [
        // Test messages from FIPS 180-1
        Test {
            input: "abc",
            output: [
                0x8e, 0xb2, 0x08, 0xf7,
                0xe0, 0x5d, 0x98, 0x7a,
                0x9b, 0x04, 0x4a, 0x8e,
                0x98, 0xc6, 0xb0, 0x87,
                0xf1, 0x5a, 0x0b, 0xfc,
            ],
            output_str: "8eb208f7e05d987a9b044a8e98c6b087f15a0bfc"
        },
        Test {
            input:
                 "abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq",
            output: [
                0x12, 0xa0, 0x53, 0x38,
                0x4a, 0x9c, 0x0c, 0x88,
                0xe4, 0x05, 0xa0, 0x6c,
                0x27, 0xdc, 0xf4, 0x9a,
                0xda, 0x62, 0xeb, 0x2b,
            ],
            output_str: "12a053384a9c0c88e405a06c27dcf49ada62eb2b"
        },
        // Examples from wikipedia
        Test {
            input: "The quick brown fox jumps over the lazy dog",
            output: [
                0x37, 0xf3, 0x32, 0xf6,
                0x8d, 0xb7, 0x7b, 0xd9,
                0xd7, 0xed, 0xd4, 0x96,
                0x95, 0x71, 0xad, 0x67,
                0x1c, 0xf9, 0xdd, 0x3b,
            ],
            output_str: "37f332f68db77bd9d7edd4969571ad671cf9dd3b",
        },
        Test {
            input: "The quick brown fox jumps over the lazy cog",
            output: [
                0x13, 0x20, 0x72, 0xdf,
                0x69, 0x09, 0x33, 0x83,
                0x5e, 0xb8, 0xb6, 0xad,
                0x0b, 0x77, 0xe7, 0xb6,
                0xf1, 0x4a, 0xca, 0xd7,
            ],
            output_str: "132072df690933835eb8b6ad0b77e7b6f14acad7",
        },
    ];

    for mut test in tests {
        // Hash through high-level API, check hex encoding/decoding
        let hash = ripemd160::Hash::hash(test.input.as_bytes());
        assert_eq!(hash, test.output_str.parse::<ripemd160::Hash>().expect("parse hex"));
        assert_eq!(hash.as_byte_array(), &test.output);
        assert_eq!(hash.to_string(), test.output_str);
        assert_eq!(ripemd160::Hash::from_bytes_ref(&test.output), &hash);
        assert_eq!(ripemd160::Hash::from_bytes_mut(&mut test.output), &hash);

        // Hash through engine, checking that we can input byte by byte
        let mut engine = ripemd160::Hash::engine();
        for ch in test.input.as_bytes() {
            engine.input(&[*ch]);
        }
        let manual_hash = ripemd160::Hash::from_engine(engine);
        assert_eq!(hash, manual_hash);
        assert_eq!(hash.to_byte_array(), test.output);
    }
}

#[test]
#[cfg(feature = "serde")]
fn ripemd_serde() {
    use serde_test::{assert_tokens, Configure, Token};

    use crate::ripemd160;

    #[rustfmt::skip]
    static HASH_BYTES: [u8; 20] = [
        0x13, 0x20, 0x72, 0xdf,
        0x69, 0x09, 0x33, 0x83,
        0x5e, 0xb8, 0xb6, 0xad,
        0x0b, 0x77, 0xe7, 0xb6,
        0xf1, 0x4a, 0xca, 0xd7,
    ];

    let hash = ripemd160::Hash::from_byte_array(HASH_BYTES);
    assert_tokens(&hash.compact(), &[Token::BorrowedBytes(&HASH_BYTES[..])]);
    assert_tokens(&hash.readable(), &[Token::Str("132072df690933835eb8b6ad0b77e7b6f14acad7")]);
}