nostr-sdk-base 0.1.0

// Copyright (c) 2022 Yuki Kishimoto
// Distributed under the MIT software license

use bitcoin_hashes::sha256;

/// Gets the number of leading zero bits of a hash. Result is between 0 and 255.
pub fn get_leading_zero_bits(h: sha256::Hash) -> u8 {
    let mut res = 0_u8;
    for b in h.as_ref() {
        if *b == 0 {
            res += 8;
        } else {
            res += b.leading_zeros() as u8;
            return res;
        }
    }
    res
}

/// Returns all possible ID prefixes (hex) that have the specified number of leading zero bits.
///
/// Possible values: 0-255
pub fn get_prefixes_for_difficulty(leading_zero_bits: u8) -> Vec<String> {
    let mut r = vec![];

    if leading_zero_bits == 0 {
        return r;
    }

    // Up to 64
    let prefix_hex_len = if leading_zero_bits % 4 == 0 {
        leading_zero_bits / 4
    } else {
        leading_zero_bits / 4 + 1
    };

    // Bitlength of relevant prefixes, from 4 (prefix has at least 1 hex char) to 256 (all 64 chars)
    let prefix_bits: u16 = prefix_hex_len as u16 * 4;

    // pow expects u32
    for i in 0..2_u8.pow((prefix_bits - leading_zero_bits as u16) as u32) {
        let p = format!("{:01$x}", i, prefix_hex_len as usize); // https://stackoverflow.com/a/26286238
        r.push(p);
    }

    r
}

#[cfg(test)]
pub mod tests {
    use bitcoin_hashes::hex::FromHex;
    use bitcoin_hashes::sha256::Hash;

    use crate::util::nip13::*;

    #[test]
    fn check_get_leading_zeroes() {
        assert_eq!(
            4,
            get_leading_zero_bits(
                Hash::from_hex("0fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            3,
            get_leading_zero_bits(
                Hash::from_hex("1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("2fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            1,
            get_leading_zero_bits(
                Hash::from_hex("4fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            1,
            get_leading_zero_bits(
                Hash::from_hex("5fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            1,
            get_leading_zero_bits(
                Hash::from_hex("6fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            1,
            get_leading_zero_bits(
                Hash::from_hex("7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );

        assert_eq!(
            0,
            get_leading_zero_bits(
                Hash::from_hex("8fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            0,
            get_leading_zero_bits(
                Hash::from_hex("9fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            0,
            get_leading_zero_bits(
                Hash::from_hex("afffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            0,
            get_leading_zero_bits(
                Hash::from_hex("bfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            0,
            get_leading_zero_bits(
                Hash::from_hex("cfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            0,
            get_leading_zero_bits(
                Hash::from_hex("dfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            0,
            get_leading_zero_bits(
                Hash::from_hex("efffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            0,
            get_leading_zero_bits(
                Hash::from_hex("ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );

        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("20ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("21ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("22ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("23ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("24ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("25ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("26ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("27ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("28ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("29ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("2affffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("2bffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("2cffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("2dffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("2effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );
        assert_eq!(
            2,
            get_leading_zero_bits(
                Hash::from_hex("2fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
                    .unwrap()
            )
        );

        assert_eq!(
            248,
            get_leading_zero_bits(
                Hash::from_hex("00000000000000000000000000000000000000000000000000000000000000ff")
                    .unwrap()
            )
        );
        assert_eq!(
            252,
            get_leading_zero_bits(
                Hash::from_hex("000000000000000000000000000000000000000000000000000000000000000f")
                    .unwrap()
            )
        );
        assert_eq!(
            255,
            get_leading_zero_bits(
                Hash::from_hex("0000000000000000000000000000000000000000000000000000000000000001")
                    .unwrap()
            )
        );
    }

    #[test]
    fn check_find_prefixes_for_pow() {
        assert_eq!(get_prefixes_for_difficulty(0).is_empty(), true);

        assert_eq!(
            get_prefixes_for_difficulty(1),
            vec!["0", "1", "2", "3", "4", "5", "6", "7"]
        );
        assert_eq!(get_prefixes_for_difficulty(2), vec!["0", "1", "2", "3"]);
        assert_eq!(get_prefixes_for_difficulty(3), vec!["0", "1"]);
        assert_eq!(get_prefixes_for_difficulty(4), vec!["0"]);

        assert_eq!(
            get_prefixes_for_difficulty(5),
            vec!["00", "01", "02", "03", "04", "05", "06", "07"]
        );
        assert_eq!(get_prefixes_for_difficulty(6), vec!["00", "01", "02", "03"]);
        assert_eq!(get_prefixes_for_difficulty(7), vec!["00", "01"]);
        assert_eq!(get_prefixes_for_difficulty(8), vec!["00"]);

        assert_eq!(
            get_prefixes_for_difficulty(9),
            vec!["000", "001", "002", "003", "004", "005", "006", "007"]
        );
        assert_eq!(
            get_prefixes_for_difficulty(10),
            vec!["000", "001", "002", "003"]
        );
        assert_eq!(get_prefixes_for_difficulty(11), vec!["000", "001"]);
        assert_eq!(get_prefixes_for_difficulty(12), vec!["000"]);

        assert_eq!(
            get_prefixes_for_difficulty(254),
            vec![
                "0000000000000000000000000000000000000000000000000000000000000000",
                "0000000000000000000000000000000000000000000000000000000000000001",
                "0000000000000000000000000000000000000000000000000000000000000002",
                "0000000000000000000000000000000000000000000000000000000000000003"
            ]
        );
        assert_eq!(
            get_prefixes_for_difficulty(255),
            vec![
                "0000000000000000000000000000000000000000000000000000000000000000",
                "0000000000000000000000000000000000000000000000000000000000000001"
            ]
        );
    }
}