cashu/nuts/
nut02.rs

1//! NUT-02: Keysets and keyset ID
2//!
3//! <https://github.com/cashubtc/nuts/blob/main/02.md>
4
5use core::fmt;
6use core::str::FromStr;
7use std::array::TryFromSliceError;
8#[cfg(feature = "mint")]
9use std::collections::BTreeMap;
10
11#[cfg(feature = "mint")]
12use bitcoin::bip32::{ChildNumber, DerivationPath, Xpriv};
13use bitcoin::hashes::sha256::Hash as Sha256;
14use bitcoin::hashes::Hash;
15#[cfg(feature = "mint")]
16use bitcoin::key::Secp256k1;
17#[cfg(feature = "mint")]
18use bitcoin::secp256k1;
19use serde::{Deserialize, Deserializer, Serialize};
20use serde_with::{serde_as, VecSkipError};
21use thiserror::Error;
22
23use super::nut01::Keys;
24#[cfg(feature = "mint")]
25use super::nut01::{MintKeyPair, MintKeys};
26use crate::nuts::nut00::CurrencyUnit;
27use crate::util::hex;
28use crate::{ensure_cdk, Amount};
29
30/// NUT02 Error
31#[derive(Debug, Error)]
32pub enum Error {
33    /// Hex Error
34    #[error(transparent)]
35    HexError(#[from] hex::Error),
36    /// Keyset length error
37    #[error("NUT02: ID length invalid, expected 8 bytes (short/v1) or 33 bytes (v2)")]
38    Length,
39    /// Unknown version
40    #[error("NUT02: Unknown Version")]
41    UnknownVersion,
42    /// Keyset id does not match
43    #[error("Keyset id incorrect")]
44    IncorrectKeysetId,
45    /// Short keyset id does not match any of the provided IDv2s
46    #[error("Short keyset id does not match any of the provided IDv2s")]
47    UnknownShortKeysetId,
48    /// Short keyset id is ill-formed
49    #[error("Short keyset id is ill-formed")]
50    MalformedShortKeysetId,
51    /// Slice Error
52    #[error(transparent)]
53    Slice(#[from] TryFromSliceError),
54}
55
56/// Keyset version
57#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
58#[cfg_attr(feature = "swagger", derive(utoipa::ToSchema))]
59pub enum KeySetVersion {
60    /// Version 00
61    Version00,
62    /// Version 01
63    Version01,
64}
65
66impl KeySetVersion {
67    /// [`KeySetVersion`] to byte
68    pub fn to_byte(&self) -> u8 {
69        match self {
70            Self::Version00 => 0,
71            Self::Version01 => 1,
72        }
73    }
74
75    /// [`KeySetVersion`] from byte
76    pub fn from_byte(byte: &u8) -> Result<Self, Error> {
77        match byte {
78            0 => Ok(Self::Version00),
79            1 => Ok(Self::Version01),
80            _ => Err(Error::UnknownVersion),
81        }
82    }
83
84    /// [`KeySetVersion`] from proto value
85    pub fn from_proto_i32(value: i32) -> Result<Self, Error> {
86        match value {
87            1 => Ok(Self::Version00),
88            2 => Ok(Self::Version01),
89            _ => Err(Error::UnknownVersion),
90        }
91    }
92
93    /// [`KeySetVersion`] to proto value
94    pub fn to_proto_i32(&self) -> i32 {
95        match self {
96            Self::Version00 => 1,
97            Self::Version01 => 2,
98        }
99    }
100}
101
102impl fmt::Display for KeySetVersion {
103    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
104        match self {
105            KeySetVersion::Version00 => f.write_str("00"),
106            KeySetVersion::Version01 => f.write_str("01"),
107        }
108    }
109}
110
111/// Keyset ID bytes
112#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
113#[cfg_attr(feature = "swagger", derive(utoipa::ToSchema))]
114pub enum IdBytes {
115    /// Bytes for v1
116    V1([u8; 7]),
117    /// Bytes for v2
118    V2([u8; 32]),
119}
120
121impl IdBytes {
122    /// Convert [`IdBytes`] to [`Vec<u8>`]
123    pub fn to_vec(&self) -> Vec<u8> {
124        match self {
125            IdBytes::V1(bytes) => bytes.to_vec(),
126            IdBytes::V2(bytes) => bytes.to_vec(),
127        }
128    }
129}
130
131/// A keyset ID is an identifier for a specific keyset. It can be derived by
132/// anyone who knows the set of public keys of a mint. The keyset ID **CAN**
133/// be stored in a Cashu token such that the token can be used to identify
134/// which mint or keyset it was generated from.
135#[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, Serialize, Deserialize)]
136#[serde(into = "String", try_from = "String")]
137#[cfg_attr(feature = "swagger", derive(utoipa::ToSchema))]
138pub struct Id {
139    version: KeySetVersion,
140    id: IdBytes,
141}
142
143impl Id {
144    const STRLEN_V1: usize = 14;
145    const BYTELEN_V1: usize = 7;
146    const STRLEN_V2: usize = 64;
147    const BYTELEN_V2: usize = 32;
148
149    /// [`Id`] to bytes
150    pub fn to_bytes(&self) -> Vec<u8> {
151        [vec![self.version.to_byte()], self.id.to_vec()].concat()
152    }
153
154    /// [`Id`] from bytes
155    pub fn from_bytes(bytes: &[u8]) -> Result<Self, Error> {
156        if bytes.is_empty() {
157            return Err(Error::Length);
158        }
159
160        let version = KeySetVersion::from_byte(&bytes[0])?;
161        let id = match version {
162            KeySetVersion::Version00 => IdBytes::V1(bytes[1..].try_into()?),
163            KeySetVersion::Version01 => IdBytes::V2(bytes[1..].try_into()?),
164        };
165        Ok(Self { version, id })
166    }
167
168    /// Get the version of the keyset
169    pub fn get_version(&self) -> KeySetVersion {
170        self.version
171    }
172
173    /// *** V2 KEYSET ***
174    /// create [`Id`] v2 from keys, unit and (optionally) expiry
175    /// 1 - sort public keys by their amount in ascending order
176    /// 2 - concatenate all public keys to one byte array
177    /// 3 - concatenate the lowercase unit string to the byte array (e.g. "unit:sat")
178    /// 4 - If a final expiration is specified, convert it into a radix-10 string and concatenate it (e.g "final_expiry:1896187313")
179    /// 5 - HASH_SHA256 the concatenated byte array and take the first 31 bytes
180    /// 6 - prefix it with a keyset ID version byte
181    ///
182    /// # Panics
183    ///
184    /// This function will not panic under normal circumstances as the hash output
185    /// is always valid hex and the correct length.
186    pub fn v2_from_data(
187        map: &Keys,
188        unit: &CurrencyUnit,
189        input_fee_ppk: u64,
190        expiry: Option<u64>,
191    ) -> Self {
192        let mut keys: Vec<(&Amount, &super::PublicKey)> = map.iter().collect();
193        keys.sort_by_key(|(amt, _v)| *amt);
194
195        let keys_string = keys
196            .iter()
197            .map(|(amt, pubkey)| format!("{}:{}", amt, hex::encode(pubkey.to_bytes())))
198            .collect::<Vec<String>>()
199            .join(",");
200
201        let mut data = keys_string;
202        data.push_str(&format!("|unit:{}", unit));
203
204        if input_fee_ppk > 0 {
205            data.push_str(&format!("|input_fee_ppk:{}", input_fee_ppk));
206        }
207
208        if let Some(expiry) = expiry {
209            if expiry > 0 {
210                data.push_str(&format!("|final_expiry:{}", expiry));
211            }
212        }
213
214        let hash = Sha256::hash(data.as_bytes());
215        let hex_of_hash = hex::encode(hash.to_byte_array());
216
217        Self {
218            version: KeySetVersion::Version01,
219            id: IdBytes::V2(
220                hex::decode(&hex_of_hash[0..Self::STRLEN_V2])
221                    .expect("Keys hash could not be hex decoded")
222                    .try_into()
223                    .expect("Invalid length of hex id"),
224            ),
225        }
226    }
227
228    /// *** V1 VERSION ***
229    /// As per NUT-02:
230    ///   1. sort public keys by their amount in ascending order
231    ///   2. concatenate all public keys to one string
232    ///   3. HASH_SHA256 the concatenated public keys
233    ///   4. take the first 14 characters of the hex-encoded hash
234    ///   5. prefix it with a keyset ID version byte
235    ///
236    /// # Panics
237    ///
238    /// This function will not panic under normal circumstances as the hash output
239    /// is always valid hex and the correct length.
240    pub fn v1_from_keys(map: &Keys) -> Self {
241        let mut keys: Vec<(&Amount, &super::PublicKey)> = map.iter().collect();
242        keys.sort_by_key(|(amt, _v)| *amt);
243
244        let pubkeys_concat: Vec<u8> = keys
245            .iter()
246            .map(|(_, pubkey)| pubkey.to_bytes())
247            .collect::<Vec<[u8; 33]>>()
248            .concat();
249
250        let hash = Sha256::hash(&pubkeys_concat);
251        let hex_of_hash = hex::encode(hash.to_byte_array());
252
253        Self {
254            version: KeySetVersion::Version00,
255            id: IdBytes::V1(
256                hex::decode(&hex_of_hash[0..Self::STRLEN_V1])
257                    .expect("Keys hash could not be hex decoded")
258                    .try_into()
259                    .expect("Invalid length of hex id"),
260            ),
261        }
262    }
263
264    /// Selects the correct IDv2 from a list of keysets and the given short-id
265    /// or returns the short-id in the case of v1.
266    pub fn from_short_keyset_id(
267        short_id: &ShortKeysetId,
268        keysets_info: &[KeySetInfo],
269    ) -> Result<Self, Error> {
270        // Check prefix length
271        if short_id.prefix.len() < Self::BYTELEN_V1 || short_id.prefix.len() > Self::BYTELEN_V2 {
272            return Err(Error::MalformedShortKeysetId);
273        }
274
275        match short_id.version {
276            KeySetVersion::Version00 => {
277                let mut idbytes: [u8; Self::BYTELEN_V1] = [0u8; Self::BYTELEN_V1];
278                idbytes.copy_from_slice(&short_id.prefix[..Self::BYTELEN_V1]);
279                Ok(Self {
280                    version: short_id.version,
281                    id: IdBytes::V1(idbytes),
282                })
283            }
284            KeySetVersion::Version01 => {
285                // We return the first match or error
286                for keyset_info in keysets_info.iter() {
287                    if keyset_info.id.version == KeySetVersion::Version01
288                        && keyset_info.id.id.to_vec().starts_with(&short_id.prefix)
289                    {
290                        return Ok(keyset_info.id);
291                    }
292                }
293                Err(Error::UnknownShortKeysetId)
294            }
295        }
296    }
297}
298
299// Used to generate a compressed unique identifier as part of the NUT13 spec
300// This is a one-way function
301impl From<Id> for u32 {
302    fn from(value: Id) -> Self {
303        let id_bytes = value.to_bytes();
304        let mut hex_bytes: [u8; 8] = [0; 8];
305        hex_bytes.copy_from_slice(&id_bytes[..8]);
306
307        let int = u64::from_be_bytes(hex_bytes);
308
309        (int % (2_u64.pow(31) - 1)) as u32
310    }
311}
312
313impl fmt::Display for Id {
314    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
315        let hex_id = match self.id {
316            IdBytes::V1(id) => hex::encode(id),
317            IdBytes::V2(id) => hex::encode(id),
318        };
319        f.write_str(&format!("{}{}", self.version, hex_id))
320    }
321}
322
323impl fmt::Debug for Id {
324    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
325        let hex_id = match self.id {
326            IdBytes::V1(id) => hex::encode(id),
327            IdBytes::V2(id) => hex::encode(id),
328        };
329        f.write_str(&format!("{}{}", self.version, hex_id))
330    }
331}
332
333impl TryFrom<String> for Id {
334    type Error = Error;
335
336    fn try_from(s: String) -> Result<Self, Self::Error> {
337        // Check that string is ASCII (required for hex) to avoid panics on byte slicing
338        // with multi-byte UTF-8 characters
339        ensure_cdk!(
340            s.is_ascii(),
341            Error::HexError(hex::Error::InvalidHexCharacter {
342                c: s.chars().find(|c| !c.is_ascii()).unwrap_or('\0'),
343                index: s.chars().position(|c| !c.is_ascii()).unwrap_or(0),
344            })
345        );
346
347        ensure_cdk!(
348            s.len() == Self::STRLEN_V1 + 2 || s.len() == Self::STRLEN_V2 + 2,
349            Error::Length
350        );
351
352        let version: KeySetVersion = KeySetVersion::from_byte(&hex::decode(&s[..2])?[0])?;
353        let id = match version {
354            KeySetVersion::Version00 => IdBytes::V1(
355                hex::decode(&s[2..])?
356                    .try_into()
357                    .map_err(|_| Error::Length)?,
358            ),
359            KeySetVersion::Version01 => IdBytes::V2(
360                hex::decode(&s[2..])?
361                    .try_into()
362                    .map_err(|_| Error::Length)?,
363            ),
364        };
365
366        Ok(Self { version, id })
367    }
368}
369
370impl FromStr for Id {
371    type Err = Error;
372
373    fn from_str(s: &str) -> Result<Self, Self::Err> {
374        Self::try_from(s.to_string())
375    }
376}
377
378impl From<Id> for String {
379    fn from(value: Id) -> Self {
380        value.to_string()
381    }
382}
383
384/// Improper prefix of the keyset ID. In case of v1, this is the whole ID.
385/// In case of v2, this is the 8-byte prefix
386#[derive(Clone, PartialEq, Eq, PartialOrd, Ord, Hash, Serialize, Deserialize)]
387#[serde(into = "String", try_from = "String")]
388#[cfg_attr(feature = "swagger", derive(utoipa::ToSchema))]
389pub struct ShortKeysetId {
390    /// The version of the short keyset
391    version: KeySetVersion,
392    /// The improper prefix of the keyset ID bytes
393    prefix: Vec<u8>,
394}
395
396impl ShortKeysetId {
397    /// [`ShortKeysetId`] to bytes
398    pub fn to_bytes(&self) -> Vec<u8> {
399        [vec![self.version.to_byte()], self.prefix.clone()].concat()
400    }
401
402    /// [`ShortKeysetId`] from bytes
403    pub fn from_bytes(bytes: &[u8]) -> Result<Self, Error> {
404        if bytes.is_empty() {
405            return Err(Error::Length);
406        }
407
408        let version = KeySetVersion::from_byte(&bytes[0])?;
409        let prefix = bytes[1..].to_vec();
410        Ok(Self { version, prefix })
411    }
412}
413
414impl From<Id> for ShortKeysetId {
415    fn from(id: Id) -> Self {
416        let version = id.version;
417        let prefix: Vec<u8> = match id.version {
418            KeySetVersion::Version00 => match id.id {
419                IdBytes::V1(idbytes) => Vec::from(&idbytes),
420                _ => panic!("Unexpected IdBytes length"),
421            },
422            KeySetVersion::Version01 => match id.id {
423                IdBytes::V2(idbytes) => Vec::from(&idbytes[..7]),
424                _ => panic!("Unexpected IdBytes length"),
425            },
426        };
427
428        Self { version, prefix }
429    }
430}
431
432impl fmt::Display for ShortKeysetId {
433    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
434        let hex_id = hex::encode(&self.prefix);
435        f.write_str(&format!("{}{}", self.version, hex_id))
436    }
437}
438
439impl fmt::Debug for ShortKeysetId {
440    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
441        let hex_id = hex::encode(&self.prefix);
442        f.write_str(&format!("{}{}", self.version, hex_id))
443    }
444}
445
446impl TryFrom<String> for ShortKeysetId {
447    type Error = Error;
448
449    fn try_from(s: String) -> Result<Self, Self::Error> {
450        // Check that string is ASCII (required for hex) to avoid panics on byte slicing
451        // with multi-byte UTF-8 characters
452        ensure_cdk!(
453            s.is_ascii(),
454            Error::HexError(hex::Error::InvalidHexCharacter {
455                c: s.chars().find(|c| !c.is_ascii()).unwrap_or('\0'),
456                index: s.chars().position(|c| !c.is_ascii()).unwrap_or(0),
457            })
458        );
459
460        let bytes = hex::decode(s)?;
461
462        Self::from_bytes(&bytes)
463    }
464}
465
466impl FromStr for ShortKeysetId {
467    type Err = Error;
468
469    fn from_str(s: &str) -> Result<Self, Self::Err> {
470        Self::try_from(s.to_string())
471    }
472}
473
474impl From<ShortKeysetId> for String {
475    fn from(value: ShortKeysetId) -> Self {
476        value.to_string()
477    }
478}
479
480/// Mint Keysets [NUT-02]
481/// Ids of mints keyset ids
482#[serde_as]
483#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
484#[cfg_attr(feature = "swagger", derive(utoipa::ToSchema))]
485pub struct KeysetResponse {
486    /// set of public key ids that the mint generates
487    #[serde_as(as = "VecSkipError<_>")]
488    pub keysets: Vec<KeySetInfo>,
489}
490
491/// Keyset
492#[derive(Debug, Clone, PartialEq, Eq, Deserialize, Serialize)]
493#[cfg_attr(feature = "swagger", derive(utoipa::ToSchema))]
494pub struct KeySet {
495    /// Keyset [`Id`]
496    #[cfg_attr(feature = "swagger", schema(value_type = String))]
497    pub id: Id,
498    /// Keyset [`CurrencyUnit`]
499    pub unit: CurrencyUnit,
500    /// Keyset state - indicates whether the mint will sign new outputs with this keyset
501    #[serde(skip_serializing_if = "Option::is_none")]
502    pub active: Option<bool>,
503    /// Keyset [`Keys`]
504    pub keys: Keys,
505    /// Input Fee PPK
506    #[serde(default)]
507    pub input_fee_ppk: u64,
508    /// Expiry
509    #[serde(skip_serializing_if = "Option::is_none")]
510    pub final_expiry: Option<u64>,
511}
512
513impl KeySet {
514    /// Verify the keyset id matches keys
515    pub fn verify_id(&self) -> Result<(), Error> {
516        let keys_id = match self.id.version {
517            KeySetVersion::Version00 => Id::v1_from_keys(&self.keys),
518            KeySetVersion::Version01 => Id::v2_from_data(
519                &self.keys,
520                &self.unit,
521                self.input_fee_ppk,
522                self.final_expiry,
523            ),
524        };
525
526        ensure_cdk!(
527            u32::from(keys_id) == u32::from(self.id),
528            Error::IncorrectKeysetId
529        );
530
531        ensure_cdk!(keys_id == self.id, Error::IncorrectKeysetId);
532
533        Ok(())
534    }
535}
536
537/// KeySetInfo
538#[derive(Debug, Clone, Hash, PartialEq, Eq, Deserialize, Serialize)]
539#[cfg_attr(feature = "swagger", derive(utoipa::ToSchema))]
540pub struct KeySetInfo {
541    /// Keyset [`Id`]
542    #[cfg_attr(feature = "swagger", schema(value_type = String))]
543    pub id: Id,
544    /// Keyset [`CurrencyUnit`]
545    pub unit: CurrencyUnit,
546    /// Keyset state
547    /// Mint will only sign from an active keyset
548    pub active: bool,
549    /// Input Fee PPK
550    #[serde(
551        deserialize_with = "deserialize_input_fee_ppk",
552        default = "default_input_fee_ppk"
553    )]
554    pub input_fee_ppk: u64,
555    /// Expiry of the keyset
556    #[serde(skip_serializing_if = "Option::is_none")]
557    pub final_expiry: Option<u64>,
558}
559
560/// List of [KeySetInfo]
561pub type KeySetInfos = Vec<KeySetInfo>;
562
563/// Utility methods for [KeySetInfos]
564pub trait KeySetInfosMethods {
565    /// Filter for active keysets
566    fn active(&self) -> impl Iterator<Item = &KeySetInfo> + '_;
567
568    /// Filter keysets for specific unit
569    fn unit(&self, unit: CurrencyUnit) -> impl Iterator<Item = &KeySetInfo> + '_;
570}
571
572impl KeySetInfosMethods for KeySetInfos {
573    fn active(&self) -> impl Iterator<Item = &KeySetInfo> + '_ {
574        self.iter().filter(|k| k.active)
575    }
576
577    fn unit(&self, unit: CurrencyUnit) -> impl Iterator<Item = &KeySetInfo> + '_ {
578        self.iter().filter(move |k| k.unit == unit)
579    }
580}
581
582fn deserialize_input_fee_ppk<'de, D>(deserializer: D) -> Result<u64, D::Error>
583where
584    D: Deserializer<'de>,
585{
586    // This will either give us a u64 or null (which becomes None)
587    let opt = Option::<u64>::deserialize(deserializer)?;
588    Ok(opt.unwrap_or_else(default_input_fee_ppk))
589}
590
591fn default_input_fee_ppk() -> u64 {
592    0
593}
594
595#[cfg(feature = "mint")]
596/// MintKeyset
597#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
598pub struct MintKeySet {
599    /// Keyset [`Id`]
600    pub id: Id,
601    /// Keyset [`CurrencyUnit`]
602    pub unit: CurrencyUnit,
603    /// Keyset [`MintKeys`]
604    pub keys: MintKeys,
605    /// Input Fee PPK
606    #[serde(default)]
607    pub input_fee_ppk: u64,
608    #[serde(skip_serializing_if = "Option::is_none")]
609    /// Expiry [`Option<u64>`]
610    pub final_expiry: Option<u64>,
611}
612
613#[cfg(feature = "mint")]
614impl MintKeySet {
615    /// Generate new [`MintKeySet`]
616    ///
617    /// # Panics
618    ///
619    /// This function will panic if the RNG fails or if key derivation fails,
620    /// which should not happen under normal circumstances.
621    pub fn generate<C: secp256k1::Signing>(
622        secp: &Secp256k1<C>,
623        xpriv: Xpriv,
624        unit: CurrencyUnit,
625        amounts: &[u64],
626        input_fee_ppk: u64,
627        final_expiry: Option<u64>,
628        version: KeySetVersion,
629    ) -> Self {
630        let mut map = BTreeMap::new();
631        for (i, amount) in amounts.iter().enumerate() {
632            let secret_key = xpriv
633                .derive_priv(
634                    secp,
635                    &[ChildNumber::from_hardened_idx(i as u32).expect("order is valid index")],
636                )
637                .expect("RNG busted")
638                .private_key;
639            let public_key = secret_key.public_key(secp);
640            map.insert(
641                amount.into(),
642                MintKeyPair {
643                    secret_key: secret_key.into(),
644                    public_key: public_key.into(),
645                },
646            );
647        }
648
649        let keys = MintKeys::new(map);
650        let id = match version {
651            KeySetVersion::Version00 => Id::v1_from_keys(&keys.clone().into()),
652            KeySetVersion::Version01 => {
653                Id::v2_from_data(&keys.clone().into(), &unit, input_fee_ppk, final_expiry)
654            }
655        };
656        Self {
657            id,
658            unit,
659            keys,
660            input_fee_ppk,
661            final_expiry,
662        }
663    }
664
665    /// Generate new [`MintKeySet`] from seed
666    ///
667    /// # Panics
668    ///
669    /// This function will panic if the RNG fails or if key derivation fails,
670    /// which should not happen under normal circumstances.
671    #[allow(clippy::too_many_arguments)]
672    pub fn generate_from_seed<C: secp256k1::Signing>(
673        secp: &Secp256k1<C>,
674        seed: &[u8],
675        amounts: &[u64],
676        currency_unit: CurrencyUnit,
677        derivation_path: DerivationPath,
678        input_fee_ppk: u64,
679        final_expiry: Option<u64>,
680        version: KeySetVersion,
681    ) -> Self {
682        let xpriv = Xpriv::new_master(bitcoin::Network::Bitcoin, seed).expect("RNG busted");
683        Self::generate(
684            secp,
685            xpriv
686                .derive_priv(secp, &derivation_path)
687                .expect("RNG busted"),
688            currency_unit,
689            amounts,
690            input_fee_ppk,
691            final_expiry,
692            version,
693        )
694    }
695
696    /// Generate new [`MintKeySet`] from xpriv
697    ///
698    /// # Panics
699    ///
700    /// This function will panic if the RNG fails or if key derivation fails,
701    /// which should not happen under normal circumstances.
702    #[allow(clippy::too_many_arguments)]
703    pub fn generate_from_xpriv<C: secp256k1::Signing>(
704        secp: &Secp256k1<C>,
705        xpriv: Xpriv,
706        amounts: &[u64],
707        currency_unit: CurrencyUnit,
708        derivation_path: DerivationPath,
709        input_fee_ppk: u64,
710        final_expiry: Option<u64>,
711        version: KeySetVersion,
712    ) -> Self {
713        Self::generate(
714            secp,
715            xpriv
716                .derive_priv(secp, &derivation_path)
717                .expect("RNG busted"),
718            currency_unit,
719            amounts,
720            input_fee_ppk,
721            final_expiry,
722            version,
723        )
724    }
725}
726
727#[cfg(feature = "mint")]
728impl From<MintKeySet> for Id {
729    fn from(keyset: MintKeySet) -> Id {
730        let keys: Keys = keyset.keys.into();
731        match keyset.id.version {
732            KeySetVersion::Version00 => Id::v1_from_keys(&keys),
733            KeySetVersion::Version01 => Id::v2_from_data(
734                &keys,
735                &keyset.unit,
736                keyset.input_fee_ppk,
737                keyset.final_expiry,
738            ),
739        }
740    }
741}
742
743#[cfg(feature = "mint")]
744impl From<&MintKeys> for Id {
745    fn from(map: &MintKeys) -> Self {
746        let keys: super::Keys = map.clone().into();
747
748        Id::v1_from_keys(&keys)
749    }
750}
751
752#[cfg(test)]
753mod test {
754    use std::str::FromStr;
755
756    use bitcoin::secp256k1::rand::{self, RngCore};
757
758    use super::{KeySetInfo, KeySetVersion, Keys, KeysetResponse, ShortKeysetId};
759    use crate::nuts::nut02::{Error, Id};
760    use crate::nuts::KeysResponse;
761    use crate::util::hex;
762    use crate::CurrencyUnit;
763
764    const SHORT_KEYSET_ID: &str = "00456a94ab4e1c46";
765    const SHORT_KEYSET: &str = r#"
766        {
767            "1":"03a40f20667ed53513075dc51e715ff2046cad64eb68960632269ba7f0210e38bc",
768            "2":"03fd4ce5a16b65576145949e6f99f445f8249fee17c606b688b504a849cdc452de",
769            "4":"02648eccfa4c026960966276fa5a4cae46ce0fd432211a4f449bf84f13aa5f8303",
770            "8":"02fdfd6796bfeac490cbee12f778f867f0a2c68f6508d17c649759ea0dc3547528"
771        }
772    "#;
773
774    const KEYSET_ID: &str = "000f01df73ea149a";
775    const KEYSET: &str = r#"
776        {
777            "1":"03ba786a2c0745f8c30e490288acd7a72dd53d65afd292ddefa326a4a3fa14c566",
778            "2":"03361cd8bd1329fea797a6add1cf1990ffcf2270ceb9fc81eeee0e8e9c1bd0cdf5",
779            "4":"036e378bcf78738ddf68859293c69778035740e41138ab183c94f8fee7572214c7",
780            "8":"03909d73beaf28edfb283dbeb8da321afd40651e8902fcf5454ecc7d69788626c0",
781            "16":"028a36f0e6638ea7466665fe174d958212723019ec08f9ce6898d897f88e68aa5d",
782            "32":"03a97a40e146adee2687ac60c2ba2586a90f970de92a9d0e6cae5a4b9965f54612",
783            "64":"03ce86f0c197aab181ddba0cfc5c5576e11dfd5164d9f3d4a3fc3ffbbf2e069664",
784            "128":"0284f2c06d938a6f78794814c687560a0aabab19fe5e6f30ede38e113b132a3cb9",
785            "256":"03b99f475b68e5b4c0ba809cdecaae64eade2d9787aa123206f91cd61f76c01459",
786            "512":"03d4db82ea19a44d35274de51f78af0a710925fe7d9e03620b84e3e9976e3ac2eb",
787            "1024":"031fbd4ba801870871d46cf62228a1b748905ebc07d3b210daf48de229e683f2dc",
788            "2048":"0276cedb9a3b160db6a158ad4e468d2437f021293204b3cd4bf6247970d8aff54b",
789            "4096":"02fc6b89b403ee9eb8a7ed457cd3973638080d6e04ca8af7307c965c166b555ea2",
790            "8192":"0320265583e916d3a305f0d2687fcf2cd4e3cd03a16ea8261fda309c3ec5721e21",
791            "16384":"036e41de58fdff3cb1d8d713f48c63bc61fa3b3e1631495a444d178363c0d2ed50",
792            "32768":"0365438f613f19696264300b069d1dad93f0c60a37536b72a8ab7c7366a5ee6c04",
793            "65536":"02408426cfb6fc86341bac79624ba8708a4376b2d92debdf4134813f866eb57a8d",
794            "131072":"031063e9f11c94dc778c473e968966eac0e70b7145213fbaff5f7a007e71c65f41",
795            "262144":"02f2a3e808f9cd168ec71b7f328258d0c1dda250659c1aced14c7f5cf05aab4328",
796            "524288":"038ac10de9f1ff9395903bb73077e94dbf91e9ef98fd77d9a2debc5f74c575bc86",
797            "1048576":"0203eaee4db749b0fc7c49870d082024b2c31d889f9bc3b32473d4f1dfa3625788",
798            "2097152":"033cdb9d36e1e82ae652b7b6a08e0204569ec7ff9ebf85d80a02786dc7fe00b04c",
799            "4194304":"02c8b73f4e3a470ae05e5f2fe39984d41e9f6ae7be9f3b09c9ac31292e403ac512",
800            "8388608":"025bbe0cfce8a1f4fbd7f3a0d4a09cb6badd73ef61829dc827aa8a98c270bc25b0",
801            "16777216":"037eec3d1651a30a90182d9287a5c51386fe35d4a96839cf7969c6e2a03db1fc21",
802            "33554432":"03280576b81a04e6abd7197f305506476f5751356b7643988495ca5c3e14e5c262",
803            "67108864":"03268bfb05be1dbb33ab6e7e00e438373ca2c9b9abc018fdb452d0e1a0935e10d3",
804            "134217728":"02573b68784ceba9617bbcc7c9487836d296aa7c628c3199173a841e7a19798020",
805            "268435456":"0234076b6e70f7fbf755d2227ecc8d8169d662518ee3a1401f729e2a12ccb2b276",
806            "536870912":"03015bd88961e2a466a2163bd4248d1d2b42c7c58a157e594785e7eb34d880efc9",
807            "1073741824":"02c9b076d08f9020ebee49ac8ba2610b404d4e553a4f800150ceb539e9421aaeee",
808            "2147483648":"034d592f4c366afddc919a509600af81b489a03caf4f7517c2b3f4f2b558f9a41a",
809            "4294967296":"037c09ecb66da082981e4cbdb1ac65c0eb631fc75d85bed13efb2c6364148879b5",
810            "8589934592":"02b4ebb0dda3b9ad83b39e2e31024b777cc0ac205a96b9a6cfab3edea2912ed1b3",
811            "17179869184":"026cc4dacdced45e63f6e4f62edbc5779ccd802e7fabb82d5123db879b636176e9",
812            "34359738368":"02b2cee01b7d8e90180254459b8f09bbea9aad34c3a2fd98c85517ecfc9805af75",
813            "68719476736":"037a0c0d564540fc574b8bfa0253cca987b75466e44b295ed59f6f8bd41aace754",
814            "137438953472":"021df6585cae9b9ca431318a713fd73dbb76b3ef5667957e8633bca8aaa7214fb6",
815            "274877906944":"02b8f53dde126f8c85fa5bb6061c0be5aca90984ce9b902966941caf963648d53a",
816            "549755813888":"029cc8af2840d59f1d8761779b2496623c82c64be8e15f9ab577c657c6dd453785",
817            "1099511627776":"03e446fdb84fad492ff3a25fc1046fb9a93a5b262ebcd0151caa442ea28959a38a",
818            "2199023255552":"02d6b25bd4ab599dd0818c55f75702fde603c93f259222001246569018842d3258",
819            "4398046511104":"03397b522bb4e156ec3952d3f048e5a986c20a00718e5e52cd5718466bf494156a",
820            "8796093022208":"02d1fb9e78262b5d7d74028073075b80bb5ab281edcfc3191061962c1346340f1e",
821            "17592186044416":"030d3f2ad7a4ca115712ff7f140434f802b19a4c9b2dd1c76f3e8e80c05c6a9310",
822            "35184372088832":"03e325b691f292e1dfb151c3fb7cad440b225795583c32e24e10635a80e4221c06",
823            "70368744177664":"03bee8f64d88de3dee21d61f89efa32933da51152ddbd67466bef815e9f93f8fd1",
824            "140737488355328":"0327244c9019a4892e1f04ba3bf95fe43b327479e2d57c25979446cc508cd379ed",
825            "281474976710656":"02fb58522cd662f2f8b042f8161caae6e45de98283f74d4e99f19b0ea85e08a56d",
826            "562949953421312":"02adde4b466a9d7e59386b6a701a39717c53f30c4810613c1b55e6b6da43b7bc9a",
827            "1125899906842624":"038eeda11f78ce05c774f30e393cda075192b890d68590813ff46362548528dca9",
828            "2251799813685248":"02ec13e0058b196db80f7079d329333b330dc30c000dbdd7397cbbc5a37a664c4f",
829            "4503599627370496":"02d2d162db63675bd04f7d56df04508840f41e2ad87312a3c93041b494efe80a73",
830            "9007199254740992":"0356969d6aef2bb40121dbd07c68b6102339f4ea8e674a9008bb69506795998f49",
831            "18014398509481984":"02f4e667567ebb9f4e6e180a4113bb071c48855f657766bb5e9c776a880335d1d6",
832            "36028797018963968":"0385b4fe35e41703d7a657d957c67bb536629de57b7e6ee6fe2130728ef0fc90b0",
833            "72057594037927936":"02b2bc1968a6fddbcc78fb9903940524824b5f5bed329c6ad48a19b56068c144fd",
834            "144115188075855872":"02e0dbb24f1d288a693e8a49bc14264d1276be16972131520cf9e055ae92fba19a",
835            "288230376151711744":"03efe75c106f931a525dc2d653ebedddc413a2c7d8cb9da410893ae7d2fa7d19cc",
836            "576460752303423488":"02c7ec2bd9508a7fc03f73c7565dc600b30fd86f3d305f8f139c45c404a52d958a",
837            "1152921504606846976":"035a6679c6b25e68ff4e29d1c7ef87f21e0a8fc574f6a08c1aa45ff352c1d59f06",
838            "2305843009213693952":"033cdc225962c052d485f7cfbf55a5b2367d200fe1fe4373a347deb4cc99e9a099",
839            "4611686018427387904":"024a4b806cf413d14b294719090a9da36ba75209c7657135ad09bc65328fba9e6f",
840            "9223372036854775808":"0377a6fe114e291a8d8e991627c38001c8305b23b9e98b1c7b1893f5cd0dda6cad"
841        }
842    "#;
843
844    #[test]
845    fn test_deserialization_and_id_generation() {
846        let _id = Id::from_str("009a1f293253e41e").unwrap();
847
848        let keys: Keys = serde_json::from_str(SHORT_KEYSET).unwrap();
849
850        let id: Id = Id::v1_from_keys(&keys);
851
852        assert_eq!(id, Id::from_str(SHORT_KEYSET_ID).unwrap());
853
854        let keys: Keys = serde_json::from_str(KEYSET).unwrap();
855
856        let id: Id = Id::v1_from_keys(&keys);
857
858        assert_eq!(id, Id::from_str(KEYSET_ID).unwrap());
859    }
860
861    #[test]
862    fn test_v2_deserialization_and_id_generation() {
863        let unit: CurrencyUnit = CurrencyUnit::from_str("sat").unwrap();
864        let expiry: u64 = 2059210353; // +10 years from now
865        let input_fee_ppk = 100;
866
867        let keys: Keys = serde_json::from_str(SHORT_KEYSET).unwrap();
868        let id_from_str =
869            Id::from_str("015ba18a8adcd02e715a58358eb618da4a4b3791151a4bee5e968bb88406ccf76a")
870                .unwrap();
871        let id = Id::v2_from_data(&keys, &unit, input_fee_ppk, Some(expiry));
872        assert_eq!(id, id_from_str);
873
874        let keys: Keys = serde_json::from_str(KEYSET).unwrap();
875        let id_from_str =
876            Id::from_str("01ab6aa4ff30390da34986d84be5274b48ad7a74265d791095bfc39f4098d9764f")
877                .unwrap();
878        let id = Id::v2_from_data(&keys, &unit, 0, Some(expiry));
879        assert_eq!(id, id_from_str);
880
881        let id = Id::v2_from_data(&keys, &unit, 0, None);
882        let id_from_str =
883            Id::from_str("012fbb01a4e200c76df911eeba3b8fe1831202914b24664f4bccbd25852a6708f8")
884                .unwrap();
885        assert_eq!(id, id_from_str);
886    }
887
888    #[test]
889    fn test_deserialization_keyset_info() {
890        let h = r#"{"id":"009a1f293253e41e","unit":"sat","active":true}"#;
891
892        let _keyset_response: KeySetInfo = serde_json::from_str(h).unwrap();
893
894        let h = r#"{"id":"009a1f293253e41e","unit":"sat","active":true, "input_fee_ppk":null}"#;
895
896        let _keyset_response: KeySetInfo = serde_json::from_str(h).unwrap();
897    }
898
899    #[test]
900    fn test_deserialization_of_keyset_response() {
901        let h = r#"{"keysets":[{"id":"009a1f293253e41e","unit":"sat","active":true, "input_fee_ppk": 100},{"id":"eGnEWtdJ0PIM","unit":"sat","active":true},{"id":"003dfdf4e5e35487","unit":"sat","active":true},{"id":"0066ad1a4b6fc57c","unit":"sat","active":true},{"id":"00f7ca24d44c3e5e","unit":"sat","active":true},{"id":"001fcea2931f2d85","unit":"sat","active":true},{"id":"00d095959d940edb","unit":"sat","active":true},{"id":"000d7f730d657125","unit":"sat","active":true},{"id":"0007208d861d7295","unit":"sat","active":true},{"id":"00bfdf8889b719dd","unit":"sat","active":true},{"id":"00ca9b17da045f21","unit":"sat","active":true}]}"#;
902
903        let _keyset_response: KeysetResponse = serde_json::from_str(h).unwrap();
904    }
905
906    #[test]
907    fn test_to_int() {
908        let id = Id::from_str("009a1f293253e41e").unwrap();
909
910        let id_int = u32::from(id);
911        assert_eq!(864559728, id_int)
912    }
913
914    #[test]
915    fn test_v2_to_int() {
916        let id = Id::from_str("01adc013fa9d85171586660abab27579888611659d357bc86bc09cb26eee8bc035")
917            .unwrap();
918
919        let id_int = u32::from(id);
920        assert_eq!(2113471806, id_int);
921    }
922
923    #[test]
924    fn test_id_from_invalid_byte_length() {
925        let three_bytes = [0x01, 0x02, 0x03];
926        let result = Id::from_bytes(&three_bytes);
927        assert!(result.is_err(), "Expected an invalid byte length error");
928    }
929
930    #[test]
931    fn test_id_from_empty_bytes() {
932        let result = Id::from_bytes(&[]);
933        assert!(
934            matches!(result, Err(Error::Length)),
935            "Expected an Error::Length error but got {:?}",
936            result
937        );
938    }
939
940    #[test]
941    fn test_keyset_bytes() {
942        let id = Id::from_str("009a1f293253e41e").unwrap();
943
944        let id_bytes = id.to_bytes();
945
946        assert_eq!(id_bytes.len(), 8);
947
948        let id_from_bytes = Id::from_bytes(&id_bytes).unwrap();
949
950        assert_eq!(id_from_bytes, id);
951    }
952
953    #[test]
954    fn test_keyset_version_proto_mapping() {
955        assert_eq!(
956            KeySetVersion::from_proto_i32(1).unwrap(),
957            KeySetVersion::Version00
958        );
959        assert_eq!(
960            KeySetVersion::from_proto_i32(2).unwrap(),
961            KeySetVersion::Version01
962        );
963        assert!(matches!(
964            KeySetVersion::from_proto_i32(0),
965            Err(Error::UnknownVersion)
966        ));
967
968        assert_eq!(KeySetVersion::Version00.to_proto_i32(), 1);
969        assert_eq!(KeySetVersion::Version01.to_proto_i32(), 2);
970    }
971
972    #[test]
973    fn test_deserialization_keys_response() {
974        let keys = r#"{"keysets":[{"id":"I2yN+iRYfkzT","unit":"sat","keys":{"1":"03ba786a2c0745f8c30e490288acd7a72dd53d65afd292ddefa326a4a3fa14c566","2":"03361cd8bd1329fea797a6add1cf1990ffcf2270ceb9fc81eeee0e8e9c1bd0cdf5","4":"036e378bcf78738ddf68859293c69778035740e41138ab183c94f8fee7572214c7","8":"03909d73beaf28edfb283dbeb8da321afd40651e8902fcf5454ecc7d69788626c0","16":"028a36f0e6638ea7466665fe174d958212723019ec08f9ce6898d897f88e68aa5d","32":"03a97a40e146adee2687ac60c2ba2586a90f970de92a9d0e6cae5a4b9965f54612","64":"03ce86f0c197aab181ddba0cfc5c5576e11dfd5164d9f3d4a3fc3ffbbf2e069664","128":"0284f2c06d938a6f78794814c687560a0aabab19fe5e6f30ede38e113b132a3cb9","256":"03b99f475b68e5b4c0ba809cdecaae64eade2d9787aa123206f91cd61f76c01459","512":"03d4db82ea19a44d35274de51f78af0a710925fe7d9e03620b84e3e9976e3ac2eb","1024":"031fbd4ba801870871d46cf62228a1b748905ebc07d3b210daf48de229e683f2dc","2048":"0276cedb9a3b160db6a158ad4e468d2437f021293204b3cd4bf6247970d8aff54b","4096":"02fc6b89b403ee9eb8a7ed457cd3973638080d6e04ca8af7307c965c166b555ea2","8192":"0320265583e916d3a305f0d2687fcf2cd4e3cd03a16ea8261fda309c3ec5721e21","16384":"036e41de58fdff3cb1d8d713f48c63bc61fa3b3e1631495a444d178363c0d2ed50","32768":"0365438f613f19696264300b069d1dad93f0c60a37536b72a8ab7c7366a5ee6c04","65536":"02408426cfb6fc86341bac79624ba8708a4376b2d92debdf4134813f866eb57a8d","131072":"031063e9f11c94dc778c473e968966eac0e70b7145213fbaff5f7a007e71c65f41","262144":"02f2a3e808f9cd168ec71b7f328258d0c1dda250659c1aced14c7f5cf05aab4328","524288":"038ac10de9f1ff9395903bb73077e94dbf91e9ef98fd77d9a2debc5f74c575bc86","1048576":"0203eaee4db749b0fc7c49870d082024b2c31d889f9bc3b32473d4f1dfa3625788","2097152":"033cdb9d36e1e82ae652b7b6a08e0204569ec7ff9ebf85d80a02786dc7fe00b04c","4194304":"02c8b73f4e3a470ae05e5f2fe39984d41e9f6ae7be9f3b09c9ac31292e403ac512","8388608":"025bbe0cfce8a1f4fbd7f3a0d4a09cb6badd73ef61829dc827aa8a98c270bc25b0","16777216":"037eec3d1651a30a90182d9287a5c51386fe35d4a96839cf7969c6e2a03db1fc21","33554432":"03280576b81a04e6abd7197f305506476f5751356b7643988495ca5c3e14e5c262","67108864":"03268bfb05be1dbb33ab6e7e00e438373ca2c9b9abc018fdb452d0e1a0935e10d3","134217728":"02573b68784ceba9617bbcc7c9487836d296aa7c628c3199173a841e7a19798020","268435456":"0234076b6e70f7fbf755d2227ecc8d8169d662518ee3a1401f729e2a12ccb2b276","536870912":"03015bd88961e2a466a2163bd4248d1d2b42c7c58a157e594785e7eb34d880efc9","1073741824":"02c9b076d08f9020ebee49ac8ba2610b404d4e553a4f800150ceb539e9421aaeee","2147483648":"034d592f4c366afddc919a509600af81b489a03caf4f7517c2b3f4f2b558f9a41a","4294967296":"037c09ecb66da082981e4cbdb1ac65c0eb631fc75d85bed13efb2c6364148879b5","8589934592":"02b4ebb0dda3b9ad83b39e2e31024b777cc0ac205a96b9a6cfab3edea2912ed1b3","17179869184":"026cc4dacdced45e63f6e4f62edbc5779ccd802e7fabb82d5123db879b636176e9","34359738368":"02b2cee01b7d8e90180254459b8f09bbea9aad34c3a2fd98c85517ecfc9805af75","68719476736":"037a0c0d564540fc574b8bfa0253cca987b75466e44b295ed59f6f8bd41aace754","137438953472":"021df6585cae9b9ca431318a713fd73dbb76b3ef5667957e8633bca8aaa7214fb6","274877906944":"02b8f53dde126f8c85fa5bb6061c0be5aca90984ce9b902966941caf963648d53a","549755813888":"029cc8af2840d59f1d8761779b2496623c82c64be8e15f9ab577c657c6dd453785","1099511627776":"03e446fdb84fad492ff3a25fc1046fb9a93a5b262ebcd0151caa442ea28959a38a","2199023255552":"02d6b25bd4ab599dd0818c55f75702fde603c93f259222001246569018842d3258","4398046511104":"03397b522bb4e156ec3952d3f048e5a986c20a00718e5e52cd5718466bf494156a","8796093022208":"02d1fb9e78262b5d7d74028073075b80bb5ab281edcfc3191061962c1346340f1e","17592186044416":"030d3f2ad7a4ca115712ff7f140434f802b19a4c9b2dd1c76f3e8e80c05c6a9310","35184372088832":"03e325b691f292e1dfb151c3fb7cad440b225795583c32e24e10635a80e4221c06","70368744177664":"03bee8f64d88de3dee21d61f89efa32933da51152ddbd67466bef815e9f93f8fd1","140737488355328":"0327244c9019a4892e1f04ba3bf95fe43b327479e2d57c25979446cc508cd379ed","281474976710656":"02fb58522cd662f2f8b042f8161caae6e45de98283f74d4e99f19b0ea85e08a56d","562949953421312":"02adde4b466a9d7e59386b6a701a39717c53f30c4810613c1b55e6b6da43b7bc9a","1125899906842624":"038eeda11f78ce05c774f30e393cda075192b890d68590813ff46362548528dca9","2251799813685248":"02ec13e0058b196db80f7079d329333b330dc30c000dbdd7397cbbc5a37a664c4f","4503599627370496":"02d2d162db63675bd04f7d56df04508840f41e2ad87312a3c93041b494efe80a73","9007199254740992":"0356969d6aef2bb40121dbd07c68b6102339f4ea8e674a9008bb69506795998f49","18014398509481984":"02f4e667567ebb9f4e6e180a4113bb071c48855f657766bb5e9c776a880335d1d6","36028797018963968":"0385b4fe35e41703d7a657d957c67bb536629de57b7e6ee6fe2130728ef0fc90b0","72057594037927936":"02b2bc1968a6fddbcc78fb9903940524824b5f5bed329c6ad48a19b56068c144fd","144115188075855872":"02e0dbb24f1d288a693e8a49bc14264d1276be16972131520cf9e055ae92fba19a","288230376151711744":"03efe75c106f931a525dc2d653ebedddc413a2c7d8cb9da410893ae7d2fa7d19cc","576460752303423488":"02c7ec2bd9508a7fc03f73c7565dc600b30fd86f3d305f8f139c45c404a52d958a","1152921504606846976":"035a6679c6b25e68ff4e29d1c7ef87f21e0a8fc574f6a08c1aa45ff352c1d59f06","2305843009213693952":"033cdc225962c052d485f7cfbf55a5b2367d200fe1fe4373a347deb4cc99e9a099","4611686018427387904":"024a4b806cf413d14b294719090a9da36ba75209c7657135ad09bc65328fba9e6f","9223372036854775808":"0377a6fe114e291a8d8e991627c38001c8305b23b9e98b1c7b1893f5cd0dda6cad"}},{"id":"00759e3f8b06b36f","unit":"sat","keys":{"1":"038a935c51c76c780ff9731cfbe9ab477f38346775809fa4c514340feabbec4b3a","2":"038288b12ebf2db3645e5d58835bd100398b6b19dfef338c698b55c05d0d41fb0a","4":"02fc8201cf4ea29abac0495d1304064f0e698762b8c0db145c1737b38a9d61c7e2","8":"02274243e03ca19f969acc7072812405b38adc672d1d753e65c63746b3f31cc6eb","16":"025f07cb2493351e7d5202f05eaf3934d5c9d17e73385e9de5bfab802f7d8caf92","32":"03afce0a897c858d7c88c1454d492eac43011e3396dda5b778ba1fcab381c748b1","64":"037b2178f42507f0c95e09d9b435a127df4b3e23ccd20af8075817d3abe90947ad","128":"02ebce8457b48407d4d248dba5a31b3eabf08a6285d09d08e40681c4adaf77bd40","256":"03c89713d27d6f8e328597b43dd87623efdcb251a484932f9e095ebfb6dbf4bdf2","512":"02df10f3ebba69916d03ab1754488770498f2e5466224d6df6d12811a13e46776c","1024":"02f5d9cba0502c21c6b39938a09dcb0390f124a2fd65e45dfeccd153cc1864273d","2048":"039de1dad91761b194e7674fb6ba212241aaf7f49dcb578a8fe093196ad1b20d1c","4096":"03cc694ba22e455f1c22b2cee4a40ecdd4f3bb4da0745411adb456158372d3efbb","8192":"029d66c24450fc315e046010df6870d61daa90c5c486c5ec4d7d3b99c5c2bce923","16384":"0387d063821010c7bd5cf79441870182f70cd432d13d3fc255e7b6ffd82c9d3c5a","32768":"021a94c6c03f7de8feb25b8a8b8d1f1c6f56af4bc533eb97c9e8b89c76b616ff11","65536":"038989c6ed91a7c577953115b465ee400a270a64e95eda8f7ee9d6bf30b8fe4908","131072":"03c3d3cd2523f004ee479a170b0ec5c74c060edb8356fc1b0a9ed8087cf6345172","262144":"02e54a7546f1a9194f30baa593a13d4e2949eb866593445d89675d7d394ef6320b","524288":"034e91037b3f1d3258d1e871dede80e98ef83e307c2e5ff589f38bd046f97546f8","1048576":"03306d42752a1adcfa394af2a690961ac9b80b1ac0f5fdc0890f66f8dc7d25ac6e","2097152":"03ec114332fe798c3e36675566c4748fda7d881000a01864ec48486512d7901e76","4194304":"02095e3e443d98ca3dfabcebc2f9154f3656b889783f7edb8290cfb01f497e63cf","8388608":"03c90f31525a4f9ab6562ec3edbf2bafc6662256ea6ce82ab19a45d2aee80b2f15","16777216":"03c0ae897a45724465c713c1379671ac5ff0a81c32e5f2dd27ea7e5530c7af484c","33554432":"034bcf793b70ba511e9c84cd07fc0c73c061e912bc02df4cac7871d048bad653b6","67108864":"021c6826c23a181d14962f43121943569a54f9d5af556eb839aee42d3f62debee6","134217728":"030e1bc651b6496922978d6cd3ed923cbf12b4332c496f841f506f5abf9d186d35","268435456":"03e3219e50cf389a75794f82ab4f880f5ffe9ca227b992c3e93cb4bb659d8e3353","536870912":"03879ad42536c410511ac6956b9da2d0da59ce7fbb6068bd9b25dd7cccddcc8096","1073741824":"03c4d3755a17904c0cfa7d7a21cc5b4e85fca8ac85369fcb12a6e2177525117dee","2147483648":"02e7a5d5cd3ea24f05f741dddad3dc8c5e24db60eb9bf9ad888b1c5dfbd792665e","4294967296":"03c783d24d8c9e51207eb3d6199bf48d6eb81a4b34103b422724be15501ff921bd","8589934592":"03200234495725455f4c4e6b6cb7b7936eb7cd1d1c9bb73d2ce032bae7d728b3ca","17179869184":"02eafa50ac67de2c206d1a67245b72ec20fac081c2a550294cc0a711246ed65a41","34359738368":"024c153c2a56de05860006aff9dc35ec9cafd7ac68708442a3a326c858b0c1a146","68719476736":"035a890c2d5c8bf259b98ac67d0d813b87778bcb0c0ea1ee9717ac804b0be3f563","137438953472":"025184ca832f08b105fdb471e2caf14025a1daa6f44ce90b4c7703878ccb6b26e8","274877906944":"039d19a41abdd49949c60672430018c63f27c5a28991f9fbb760499daccc63146c","549755813888":"03a138ac626dd3e6753459903aa128a13c052ed0058f2ead707c203bd4a7565237","1099511627776":"0298c8ef2eab728613103481167102efaf2d4b7a303cb94b9393da37a034a95c53","2199023255552":"02d88f8fc93cd2edf303fdebfecb70e59b5373cb8f746a1d075a9c86bc9382ac07","4398046511104":"02afd89ee23eee7d5fe6687fee898f64e9b01913ec71b5c596762b215e040c701f","8796093022208":"02196b461f3c804259e597c50e514920427aab4beaef0c666185fb2ff4399813db","17592186044416":"037b33746a6fd7a71d4cf17c85d13a64b98620614c0028d4995163f1b8484ee337","35184372088832":"036cce0a1878bbc63b3108c379ef4e6529fbf20ed675d80d91ca3ccc55fde4bdbd","70368744177664":"039c81dccb319ba70597cdf9db33b459164a1515c27366c8f667b01d988874e554","140737488355328":"036b2dd85a3c44c4458f0b246ce19a1524a191f1716834cfb452c6e1f946172c19","281474976710656":"022c84722c31a2b3d8cfd9b6a9e6199515fd97d6a9c390fc3d82f123bfc501ad04","562949953421312":"0355e2be85ee599b8fa7e6e68a9954573d032e89aa9e65c2e1231991664c200bf3","1125899906842624":"024b10818cd27f3eec6c9daf82b9dfa53928ab0711b711070bd39892ac10dee765","2251799813685248":"02a6d726432bb18c3145eba4fc0b587bf64f3be8617c0070dda33944474b3f8740","4503599627370496":"0248304be3cbaf31ec320bc636bb936c5984caf773df950fc44c6237ec09c557a1","9007199254740992":"03a3c0e9da7ece7d7b132c53662c0389bd87db801dff5ac9edd9f46699cb1dc065","18014398509481984":"03b6c4c874e2392072e17fbfd181afbd40d6766a8ca4cf932264ba98d98de1328c","36028797018963968":"0370dca4416ec6e30ff02f8e9db7804348b42e3f5c22099dfc896fa1b2ccbe7a69","72057594037927936":"0226250140aedb79de91cb4cc7350884bde229063f34ee0849081bb391a37c273e","144115188075855872":"02baef3a94d241aee9d6057c7a7ee7424f8a0bcb910daf6c49ddcabf70ffbc77d8","288230376151711744":"030f95a12369f1867ce0dbf2a6322c27d70c61b743064d76cfc81dd43f1a052ae6","576460752303423488":"021bc89118ab6eb1fbebe0fa6cc76da8236a7991163475a73a22d8efd016a45800","1152921504606846976":"03b0c1e658d7ca12830a0b590ea5a4d6db51084ae80b6d8abf27ad2d762209acd1","2305843009213693952":"0266926ce658a0bdae934071f22e09dbb6ecaff2a4dc4b1f8e23626570d993b48e","4611686018427387904":"03ac17f10f9bb745ebd8ee9cdca1b6981f5a356147d431196c21c6d4869402bde0","9223372036854775808":"037ab5b88c8ce34c4a3970be5c6f75b8a7a5493a12ef56a1c9ba9ff5f90de46fcc"}},{"id":"000f01df73ea149a","unit":"sat","keys":{"1":"03ba786a2c0745f8c30e490288acd7a72dd53d65afd292ddefa326a4a3fa14c566","2":"03361cd8bd1329fea797a6add1cf1990ffcf2270ceb9fc81eeee0e8e9c1bd0cdf5","4":"036e378bcf78738ddf68859293c69778035740e41138ab183c94f8fee7572214c7","8":"03909d73beaf28edfb283dbeb8da321afd40651e8902fcf5454ecc7d69788626c0","16":"028a36f0e6638ea7466665fe174d958212723019ec08f9ce6898d897f88e68aa5d","32":"03a97a40e146adee2687ac60c2ba2586a90f970de92a9d0e6cae5a4b9965f54612","64":"03ce86f0c197aab181ddba0cfc5c5576e11dfd5164d9f3d4a3fc3ffbbf2e069664","128":"0284f2c06d938a6f78794814c687560a0aabab19fe5e6f30ede38e113b132a3cb9","256":"03b99f475b68e5b4c0ba809cdecaae64eade2d9787aa123206f91cd61f76c01459","512":"03d4db82ea19a44d35274de51f78af0a710925fe7d9e03620b84e3e9976e3ac2eb","1024":"031fbd4ba801870871d46cf62228a1b748905ebc07d3b210daf48de229e683f2dc","2048":"0276cedb9a3b160db6a158ad4e468d2437f021293204b3cd4bf6247970d8aff54b","4096":"02fc6b89b403ee9eb8a7ed457cd3973638080d6e04ca8af7307c965c166b555ea2","8192":"0320265583e916d3a305f0d2687fcf2cd4e3cd03a16ea8261fda309c3ec5721e21","16384":"036e41de58fdff3cb1d8d713f48c63bc61fa3b3e1631495a444d178363c0d2ed50","32768":"0365438f613f19696264300b069d1dad93f0c60a37536b72a8ab7c7366a5ee6c04","65536":"02408426cfb6fc86341bac79624ba8708a4376b2d92debdf4134813f866eb57a8d","131072":"031063e9f11c94dc778c473e968966eac0e70b7145213fbaff5f7a007e71c65f41","262144":"02f2a3e808f9cd168ec71b7f328258d0c1dda250659c1aced14c7f5cf05aab4328","524288":"038ac10de9f1ff9395903bb73077e94dbf91e9ef98fd77d9a2debc5f74c575bc86","1048576":"0203eaee4db749b0fc7c49870d082024b2c31d889f9bc3b32473d4f1dfa3625788","2097152":"033cdb9d36e1e82ae652b7b6a08e0204569ec7ff9ebf85d80a02786dc7fe00b04c","4194304":"02c8b73f4e3a470ae05e5f2fe39984d41e9f6ae7be9f3b09c9ac31292e403ac512","8388608":"025bbe0cfce8a1f4fbd7f3a0d4a09cb6badd73ef61829dc827aa8a98c270bc25b0","16777216":"037eec3d1651a30a90182d9287a5c51386fe35d4a96839cf7969c6e2a03db1fc21","33554432":"03280576b81a04e6abd7197f305506476f5751356b7643988495ca5c3e14e5c262","67108864":"03268bfb05be1dbb33ab6e7e00e438373ca2c9b9abc018fdb452d0e1a0935e10d3","134217728":"02573b68784ceba9617bbcc7c9487836d296aa7c628c3199173a841e7a19798020","268435456":"0234076b6e70f7fbf755d2227ecc8d8169d662518ee3a1401f729e2a12ccb2b276","536870912":"03015bd88961e2a466a2163bd4248d1d2b42c7c58a157e594785e7eb34d880efc9","1073741824":"02c9b076d08f9020ebee49ac8ba2610b404d4e553a4f800150ceb539e9421aaeee","2147483648":"034d592f4c366afddc919a509600af81b489a03caf4f7517c2b3f4f2b558f9a41a","4294967296":"037c09ecb66da082981e4cbdb1ac65c0eb631fc75d85bed13efb2c6364148879b5","8589934592":"02b4ebb0dda3b9ad83b39e2e31024b777cc0ac205a96b9a6cfab3edea2912ed1b3","17179869184":"026cc4dacdced45e63f6e4f62edbc5779ccd802e7fabb82d5123db879b636176e9","34359738368":"02b2cee01b7d8e90180254459b8f09bbea9aad34c3a2fd98c85517ecfc9805af75","68719476736":"037a0c0d564540fc574b8bfa0253cca987b75466e44b295ed59f6f8bd41aace754","137438953472":"021df6585cae9b9ca431318a713fd73dbb76b3ef5667957e8633bca8aaa7214fb6","274877906944":"02b8f53dde126f8c85fa5bb6061c0be5aca90984ce9b902966941caf963648d53a","549755813888":"029cc8af2840d59f1d8761779b2496623c82c64be8e15f9ab577c657c6dd453785","1099511627776":"03e446fdb84fad492ff3a25fc1046fb9a93a5b262ebcd0151caa442ea28959a38a","2199023255552":"02d6b25bd4ab599dd0818c55f75702fde603c93f259222001246569018842d3258","4398046511104":"03397b522bb4e156ec3952d3f048e5a986c20a00718e5e52cd5718466bf494156a","8796093022208":"02d1fb9e78262b5d7d74028073075b80bb5ab281edcfc3191061962c1346340f1e","17592186044416":"030d3f2ad7a4ca115712ff7f140434f802b19a4c9b2dd1c76f3e8e80c05c6a9310","35184372088832":"03e325b691f292e1dfb151c3fb7cad440b225795583c32e24e10635a80e4221c06","70368744177664":"03bee8f64d88de3dee21d61f89efa32933da51152ddbd67466bef815e9f93f8fd1","140737488355328":"0327244c9019a4892e1f04ba3bf95fe43b327479e2d57c25979446cc508cd379ed","281474976710656":"02fb58522cd662f2f8b042f8161caae6e45de98283f74d4e99f19b0ea85e08a56d","562949953421312":"02adde4b466a9d7e59386b6a701a39717c53f30c4810613c1b55e6b6da43b7bc9a","1125899906842624":"038eeda11f78ce05c774f30e393cda075192b890d68590813ff46362548528dca9","2251799813685248":"02ec13e0058b196db80f7079d329333b330dc30c000dbdd7397cbbc5a37a664c4f","4503599627370496":"02d2d162db63675bd04f7d56df04508840f41e2ad87312a3c93041b494efe80a73","9007199254740992":"0356969d6aef2bb40121dbd07c68b6102339f4ea8e674a9008bb69506795998f49","18014398509481984":"02f4e667567ebb9f4e6e180a4113bb071c48855f657766bb5e9c776a880335d1d6","36028797018963968":"0385b4fe35e41703d7a657d957c67bb536629de57b7e6ee6fe2130728ef0fc90b0","72057594037927936":"02b2bc1968a6fddbcc78fb9903940524824b5f5bed329c6ad48a19b56068c144fd","144115188075855872":"02e0dbb24f1d288a693e8a49bc14264d1276be16972131520cf9e055ae92fba19a","288230376151711744":"03efe75c106f931a525dc2d653ebedddc413a2c7d8cb9da410893ae7d2fa7d19cc","576460752303423488":"02c7ec2bd9508a7fc03f73c7565dc600b30fd86f3d305f8f139c45c404a52d958a","1152921504606846976":"035a6679c6b25e68ff4e29d1c7ef87f21e0a8fc574f6a08c1aa45ff352c1d59f06","2305843009213693952":"033cdc225962c052d485f7cfbf55a5b2367d200fe1fe4373a347deb4cc99e9a099","4611686018427387904":"024a4b806cf413d14b294719090a9da36ba75209c7657135ad09bc65328fba9e6f","9223372036854775808":"0377a6fe114e291a8d8e991627c38001c8305b23b9e98b1c7b1893f5cd0dda6cad"}},{"id":"yjzQhxghPdrr","unit":"sat","keys":{"1":"038a935c51c76c780ff9731cfbe9ab477f38346775809fa4c514340feabbec4b3a","2":"038288b12ebf2db3645e5d58835bd100398b6b19dfef338c698b55c05d0d41fb0a","4":"02fc8201cf4ea29abac0495d1304064f0e698762b8c0db145c1737b38a9d61c7e2","8":"02274243e03ca19f969acc7072812405b38adc672d1d753e65c63746b3f31cc6eb","16":"025f07cb2493351e7d5202f05eaf3934d5c9d17e73385e9de5bfab802f7d8caf92","32":"03afce0a897c858d7c88c1454d492eac43011e3396dda5b778ba1fcab381c748b1","64":"037b2178f42507f0c95e09d9b435a127df4b3e23ccd20af8075817d3abe90947ad","128":"02ebce8457b48407d4d248dba5a31b3eabf08a6285d09d08e40681c4adaf77bd40","256":"03c89713d27d6f8e328597b43dd87623efdcb251a484932f9e095ebfb6dbf4bdf2","512":"02df10f3ebba69916d03ab1754488770498f2e5466224d6df6d12811a13e46776c","1024":"02f5d9cba0502c21c6b39938a09dcb0390f124a2fd65e45dfeccd153cc1864273d","2048":"039de1dad91761b194e7674fb6ba212241aaf7f49dcb578a8fe093196ad1b20d1c","4096":"03cc694ba22e455f1c22b2cee4a40ecdd4f3bb4da0745411adb456158372d3efbb","8192":"029d66c24450fc315e046010df6870d61daa90c5c486c5ec4d7d3b99c5c2bce923","16384":"0387d063821010c7bd5cf79441870182f70cd432d13d3fc255e7b6ffd82c9d3c5a","32768":"021a94c6c03f7de8feb25b8a8b8d1f1c6f56af4bc533eb97c9e8b89c76b616ff11","65536":"038989c6ed91a7c577953115b465ee400a270a64e95eda8f7ee9d6bf30b8fe4908","131072":"03c3d3cd2523f004ee479a170b0ec5c74c060edb8356fc1b0a9ed8087cf6345172","262144":"02e54a7546f1a9194f30baa593a13d4e2949eb866593445d89675d7d394ef6320b","524288":"034e91037b3f1d3258d1e871dede80e98ef83e307c2e5ff589f38bd046f97546f8","1048576":"03306d42752a1adcfa394af2a690961ac9b80b1ac0f5fdc0890f66f8dc7d25ac6e","2097152":"03ec114332fe798c3e36675566c4748fda7d881000a01864ec48486512d7901e76","4194304":"02095e3e443d98ca3dfabcebc2f9154f3656b889783f7edb8290cfb01f497e63cf","8388608":"03c90f31525a4f9ab6562ec3edbf2bafc6662256ea6ce82ab19a45d2aee80b2f15","16777216":"03c0ae897a45724465c713c1379671ac5ff0a81c32e5f2dd27ea7e5530c7af484c","33554432":"034bcf793b70ba511e9c84cd07fc0c73c061e912bc02df4cac7871d048bad653b6","67108864":"021c6826c23a181d14962f43121943569a54f9d5af556eb839aee42d3f62debee6","134217728":"030e1bc651b6496922978d6cd3ed923cbf12b4332c496f841f506f5abf9d186d35","268435456":"03e3219e50cf389a75794f82ab4f880f5ffe9ca227b992c3e93cb4bb659d8e3353","536870912":"03879ad42536c410511ac6956b9da2d0da59ce7fbb6068bd9b25dd7cccddcc8096","1073741824":"03c4d3755a17904c0cfa7d7a21cc5b4e85fca8ac85369fcb12a6e2177525117dee","2147483648":"02e7a5d5cd3ea24f05f741dddad3dc8c5e24db60eb9bf9ad888b1c5dfbd792665e","4294967296":"03c783d24d8c9e51207eb3d6199bf48d6eb81a4b34103b422724be15501ff921bd","8589934592":"03200234495725455f4c4e6b6cb7b7936eb7cd1d1c9bb73d2ce032bae7d728b3ca","17179869184":"02eafa50ac67de2c206d1a67245b72ec20fac081c2a550294cc0a711246ed65a41","34359738368":"024c153c2a56de05860006aff9dc35ec9cafd7ac68708442a3a326c858b0c1a146","68719476736":"035a890c2d5c8bf259b98ac67d0d813b87778bcb0c0ea1ee9717ac804b0be3f563","137438953472":"025184ca832f08b105fdb471e2caf14025a1daa6f44ce90b4c7703878ccb6b26e8","274877906944":"039d19a41abdd49949c60672430018c63f27c5a28991f9fbb760499daccc63146c","549755813888":"03a138ac626dd3e6753459903aa128a13c052ed0058f2ead707c203bd4a7565237","1099511627776":"0298c8ef2eab728613103481167102efaf2d4b7a303cb94b9393da37a034a95c53","2199023255552":"02d88f8fc93cd2edf303fdebfecb70e59b5373cb8f746a1d075a9c86bc9382ac07","4398046511104":"02afd89ee23eee7d5fe6687fee898f64e9b01913ec71b5c596762b215e040c701f","8796093022208":"02196b461f3c804259e597c50e514920427aab4beaef0c666185fb2ff4399813db","17592186044416":"037b33746a6fd7a71d4cf17c85d13a64b98620614c0028d4995163f1b8484ee337","35184372088832":"036cce0a1878bbc63b3108c379ef4e6529fbf20ed675d80d91ca3ccc55fde4bdbd","70368744177664":"039c81dccb319ba70597cdf9db33b459164a1515c27366c8f667b01d988874e554","140737488355328":"036b2dd85a3c44c4458f0b246ce19a1524a191f1716834cfb452c6e1f946172c19","281474976710656":"022c84722c31a2b3d8cfd9b6a9e6199515fd97d6a9c390fc3d82f123bfc501ad04","562949953421312":"0355e2be85ee599b8fa7e6e68a9954573d032e89aa9e65c2e1231991664c200bf3","1125899906842624":"024b10818cd27f3eec6c9daf82b9dfa53928ab0711b711070bd39892ac10dee765","2251799813685248":"02a6d726432bb18c3145eba4fc0b587bf64f3be8617c0070dda33944474b3f8740","4503599627370496":"0248304be3cbaf31ec320bc636bb936c5984caf773df950fc44c6237ec09c557a1","9007199254740992":"03a3c0e9da7ece7d7b132c53662c0389bd87db801dff5ac9edd9f46699cb1dc065","18014398509481984":"03b6c4c874e2392072e17fbfd181afbd40d6766a8ca4cf932264ba98d98de1328c","36028797018963968":"0370dca4416ec6e30ff02f8e9db7804348b42e3f5c22099dfc896fa1b2ccbe7a69","72057594037927936":"0226250140aedb79de91cb4cc7350884bde229063f34ee0849081bb391a37c273e","144115188075855872":"02baef3a94d241aee9d6057c7a7ee7424f8a0bcb910daf6c49ddcabf70ffbc77d8","288230376151711744":"030f95a12369f1867ce0dbf2a6322c27d70c61b743064d76cfc81dd43f1a052ae6","576460752303423488":"021bc89118ab6eb1fbebe0fa6cc76da8236a7991163475a73a22d8efd016a45800","1152921504606846976":"03b0c1e658d7ca12830a0b590ea5a4d6db51084ae80b6d8abf27ad2d762209acd1","2305843009213693952":"0266926ce658a0bdae934071f22e09dbb6ecaff2a4dc4b1f8e23626570d993b48e","4611686018427387904":"03ac17f10f9bb745ebd8ee9cdca1b6981f5a356147d431196c21c6d4869402bde0","9223372036854775808":"037ab5b88c8ce34c4a3970be5c6f75b8a7a5493a12ef56a1c9ba9ff5f90de46fcc"}}]}"#;
975
976        let keys_response: KeysResponse = serde_json::from_str(keys).unwrap();
977
978        assert_eq!(keys_response.keysets.len(), 2);
979    }
980
981    fn generate_random_id(version: KeySetVersion) -> Id {
982        match version {
983            KeySetVersion::Version00 => {
984                let mut rand_bytes = vec![0u8; 8];
985                rand::thread_rng().fill_bytes(&mut rand_bytes[1..]);
986                Id::from_bytes(&rand_bytes).unwrap_or_else(|e| {
987                    panic!("Failed to create Id from {}: {e}", hex::encode(rand_bytes))
988                })
989            }
990            KeySetVersion::Version01 => {
991                let mut rand_bytes = vec![1u8; 33];
992                rand::thread_rng().fill_bytes(&mut rand_bytes[1..]);
993                Id::from_bytes(&rand_bytes).unwrap_or_else(|e| {
994                    panic!("Failed to create Id from {}: {e}", hex::encode(rand_bytes))
995                })
996            }
997        }
998    }
999
1000    #[test]
1001    fn test_id_serialization() {
1002        let id = generate_random_id(KeySetVersion::Version00);
1003        let id_str = id.to_string();
1004
1005        assert!(id_str.chars().all(|c| c.is_ascii_hexdigit()));
1006        assert_eq!(16, id_str.len());
1007        assert_eq!(id_str.to_lowercase(), id_str);
1008    }
1009
1010    #[test]
1011    fn test_id_v2_serialization() {
1012        let id = generate_random_id(KeySetVersion::Version01);
1013        let id_str = id.to_string();
1014
1015        assert!(id_str.chars().all(|c| c.is_ascii_hexdigit()));
1016        assert_eq!(66, id_str.len());
1017        assert_eq!(id_str.to_lowercase(), id_str);
1018    }
1019
1020    #[test]
1021    fn test_id_deserialization() {
1022        let id_from_short_str = Id::from_str("00123");
1023        assert!(matches!(id_from_short_str, Err(Error::Length)));
1024
1025        let id_from_non_hex_str = Id::from_str(&SHORT_KEYSET_ID.replace('a', "x"));
1026        assert!(matches!(id_from_non_hex_str, Err(Error::HexError(_))));
1027
1028        let id_invalid_version = Id::from_str(&SHORT_KEYSET_ID.replace("00", "99"));
1029        assert!(matches!(id_invalid_version, Err(Error::UnknownVersion)));
1030
1031        let id_from_uppercase = Id::from_str(&SHORT_KEYSET_ID.to_uppercase());
1032        assert!(id_from_uppercase.is_ok());
1033    }
1034
1035    #[test]
1036    fn test_short_keyset_id_from_id() {
1037        let idv1 = Id::from_str("009a1f293253e41e").unwrap();
1038        let idv2 =
1039            Id::from_str("01adc013fa9d85171586660abab27579888611659d357bc86bc09cb26eee8bc035")
1040                .unwrap();
1041
1042        let short_id_1: ShortKeysetId = idv1.into();
1043        let short_id_2: ShortKeysetId = idv2.into();
1044
1045        assert!(short_id_1.to_string() == "009a1f293253e41e");
1046        assert!(short_id_2.to_string() == "01adc013fa9d8517");
1047    }
1048
1049    #[test]
1050    fn test_id_with_non_ascii_chars() {
1051        // Test that non-ASCII characters in ID strings don't cause panics
1052        // but instead return proper errors. This was found by fuzzing.
1053        // The character 'ǝ' is a 2-byte UTF-8 sequence that could cause
1054        // panics when slicing by byte index.
1055        let id_with_non_ascii = Id::from_str("0ǝfa73302d12ff{");
1056        assert!(matches!(id_with_non_ascii, Err(Error::HexError(_))));
1057
1058        // Also test ShortKeysetId
1059        let short_id_with_non_ascii = ShortKeysetId::from_str("0ǝfa73302d12ff");
1060        assert!(matches!(short_id_with_non_ascii, Err(Error::HexError(_))));
1061    }
1062
1063    #[test]
1064    fn test_v2_from_data_expiry_zero_is_same_as_none() {
1065        let unit: CurrencyUnit = CurrencyUnit::from_str("sat").unwrap();
1066        let keys: Keys = serde_json::from_str(SHORT_KEYSET).unwrap();
1067
1068        let id_with_none = Id::v2_from_data(&keys, &unit, 0, None);
1069        let id_with_zero = Id::v2_from_data(&keys, &unit, 0, Some(0));
1070        assert_eq!(
1071            id_with_none, id_with_zero,
1072            "expiry=Some(0) should be treated the same as expiry=None"
1073        );
1074    }
1075
1076    #[test]
1077    fn test_v2_from_data_input_fee_zero_is_same_as_no_fee_component() {
1078        let unit: CurrencyUnit = CurrencyUnit::from_str("sat").unwrap();
1079        let keys: Keys = serde_json::from_str(SHORT_KEYSET).unwrap();
1080
1081        let id_without_fee = Id::v2_from_data(&keys, &unit, 0, Some(2059210353));
1082        let id_with_same_inputs = Id::v2_from_data(&keys, &unit, 0, Some(2059210353));
1083
1084        assert_eq!(id_without_fee, id_with_same_inputs);
1085    }
1086
1087    #[test]
1088    fn test_from_short_keyset_id_prefix_too_short() {
1089        let v1_info = KeySetInfo {
1090            id: Id::from_str("00009a1f293253e4").unwrap(),
1091            unit: CurrencyUnit::Sat,
1092            active: true,
1093            input_fee_ppk: 0,
1094            final_expiry: None,
1095        };
1096        let keysets = vec![v1_info];
1097
1098        let short_id = ShortKeysetId::from_bytes(&[0x00, 0x01, 0x02, 0x03]).unwrap();
1099        let res = Id::from_short_keyset_id(&short_id, &keysets);
1100        assert!(
1101            matches!(res, Err(Error::MalformedShortKeysetId)),
1102            "Expected MalformedShortKeysetId for prefix < 7 bytes, got {:?}",
1103            res
1104        );
1105    }
1106
1107    #[test]
1108    fn test_from_short_keyset_id_prefix_too_long() {
1109        let v2_id =
1110            Id::from_str("01adc013fa9d85171586660abab27579888611659d357bc86bc09cb26eee8bc035")
1111                .unwrap();
1112        let v2_info = KeySetInfo {
1113            id: v2_id,
1114            unit: CurrencyUnit::Sat,
1115            active: true,
1116            input_fee_ppk: 0,
1117            final_expiry: None,
1118        };
1119        let keysets = vec![v2_info];
1120
1121        let mut bytes = vec![0x01u8];
1122        bytes.extend_from_slice(&[0xAA; 33]);
1123        let short_id = ShortKeysetId::from_bytes(&bytes).unwrap();
1124        let res = Id::from_short_keyset_id(&short_id, &keysets);
1125        assert!(
1126            matches!(res, Err(Error::MalformedShortKeysetId)),
1127            "Expected MalformedShortKeysetId for prefix > 32 bytes, got {:?}",
1128            res
1129        );
1130    }
1131
1132    #[test]
1133    fn test_from_short_keyset_id_panic_regression() {
1134        // v1 id - 7 bytes + 1 byte version prefix = 16 hex chars
1135        let v1_id = Id::from_str("00009a1f293253e4").unwrap();
1136        let v1_info = KeySetInfo {
1137            id: v1_id,
1138            unit: CurrencyUnit::Sat,
1139            active: true,
1140            input_fee_ppk: 0,
1141            final_expiry: None,
1142        };
1143
1144        // v2 id - 32 bytes
1145        let v2_id =
1146            Id::from_str("01adc013fa9d85171586660abab27579888611659d357bc86bc09cb26eee8bc035")
1147                .unwrap();
1148        let v2_info = KeySetInfo {
1149            id: v2_id,
1150            unit: CurrencyUnit::Sat,
1151            active: true,
1152            input_fee_ppk: 0,
1153            final_expiry: None,
1154        };
1155
1156        let keysets = vec![v1_info, v2_info];
1157
1158        // This is a v2 short id with 8 bytes prefix
1159        // Before the fix, this would panic when checking against v1_info
1160        let short_id = ShortKeysetId::from_str("01000000003b00000e").unwrap();
1161
1162        let res = Id::from_short_keyset_id(&short_id, &keysets);
1163        assert!(res.is_err());
1164    }
1165
1166    #[test]
1167    fn test_from_short_keyset_id_accepts_boundary_prefix_lengths() {
1168        let v1_id = Id::from_str("00009a1f293253e4").unwrap();
1169        let v2_id =
1170            Id::from_str("01adc013fa9d85171586660abab27579888611659d357bc86bc09cb26eee8bc035")
1171                .unwrap();
1172
1173        let keysets = vec![
1174            KeySetInfo {
1175                id: v1_id,
1176                unit: CurrencyUnit::Sat,
1177                active: true,
1178                input_fee_ppk: 0,
1179                final_expiry: None,
1180            },
1181            KeySetInfo {
1182                id: v2_id,
1183                unit: CurrencyUnit::Sat,
1184                active: true,
1185                input_fee_ppk: 0,
1186                final_expiry: None,
1187            },
1188        ];
1189
1190        let short_v1 = ShortKeysetId::from_bytes(&v1_id.to_bytes()).unwrap();
1191        let short_v2 = ShortKeysetId::from(v2_id);
1192
1193        assert_eq!(
1194            Id::from_short_keyset_id(&short_v1, &keysets).unwrap(),
1195            v1_id
1196        );
1197        assert_eq!(
1198            Id::from_short_keyset_id(&short_v2, &keysets).unwrap(),
1199            v2_id
1200        );
1201    }
1202
1203    #[test]
1204    fn test_from_short_keyset_id_returns_unknown_when_v2_prefix_does_not_match() {
1205        let v2_id =
1206            Id::from_str("01adc013fa9d85171586660abab27579888611659d357bc86bc09cb26eee8bc035")
1207                .unwrap();
1208        let keysets = vec![KeySetInfo {
1209            id: v2_id,
1210            unit: CurrencyUnit::Sat,
1211            active: true,
1212            input_fee_ppk: 0,
1213            final_expiry: None,
1214        }];
1215
1216        let short_id = ShortKeysetId::from_str("01ffffffffffffff").unwrap();
1217        let res = Id::from_short_keyset_id(&short_id, &keysets);
1218
1219        assert!(matches!(res, Err(Error::UnknownShortKeysetId)));
1220    }
1221
1222    #[test]
1223    fn test_from_short_keyset_id_accepts_exact_32_byte_v2_prefix() {
1224        // Boundary test: a short id whose prefix is exactly 32 bytes (BYTELEN_V2)
1225        // must be accepted and match the full v2 id (which is itself 32 bytes).
1226        let v2_id =
1227            Id::from_str("01adc013fa9d85171586660abab27579888611659d357bc86bc09cb26eee8bc035")
1228                .unwrap();
1229        let keysets = vec![KeySetInfo {
1230            id: v2_id,
1231            unit: CurrencyUnit::Sat,
1232            active: true,
1233            input_fee_ppk: 0,
1234            final_expiry: None,
1235        }];
1236
1237        // Build a ShortKeysetId whose prefix equals the full 32-byte id.
1238        // The byte representation is: [version_byte, 32-byte id...], total 33 bytes.
1239        let short_id = ShortKeysetId::from_bytes(&v2_id.to_bytes()).unwrap();
1240        assert_eq!(short_id.prefix.len(), 32);
1241
1242        let res = Id::from_short_keyset_id(&short_id, &keysets).unwrap();
1243        assert_eq!(res, v2_id);
1244    }
1245
1246    #[test]
1247    fn test_id_debug_format_equals_display() {
1248        // Ensure Debug impl is not a no-op. Mutants that replace the body with
1249        // Ok(Default::default()) would produce an empty string.
1250        let id_v1 = Id::from_str(SHORT_KEYSET_ID).unwrap();
1251        assert_eq!(format!("{:?}", id_v1), id_v1.to_string());
1252        assert!(!format!("{:?}", id_v1).is_empty());
1253
1254        let id_v2 =
1255            Id::from_str("01adc013fa9d85171586660abab27579888611659d357bc86bc09cb26eee8bc035")
1256                .unwrap();
1257        assert_eq!(format!("{:?}", id_v2), id_v2.to_string());
1258        assert!(!format!("{:?}", id_v2).is_empty());
1259    }
1260
1261    #[test]
1262    fn test_short_keyset_id_debug_format_equals_display() {
1263        // Mutants replacing the body with Ok(Default::default()) would produce "".
1264        let short_v1 = ShortKeysetId::from_str(SHORT_KEYSET_ID).unwrap();
1265        assert_eq!(format!("{:?}", short_v1), short_v1.to_string());
1266        assert!(!format!("{:?}", short_v1).is_empty());
1267
1268        let v2_id =
1269            Id::from_str("01adc013fa9d85171586660abab27579888611659d357bc86bc09cb26eee8bc035")
1270                .unwrap();
1271        let short_v2: ShortKeysetId = v2_id.into();
1272        assert_eq!(format!("{:?}", short_v2), short_v2.to_string());
1273        assert!(!format!("{:?}", short_v2).is_empty());
1274    }
1275
1276    #[test]
1277    fn test_keyset_verify_id_valid_returns_ok() {
1278        use super::KeySet;
1279
1280        // v1 keyset
1281        let keys: Keys = serde_json::from_str(SHORT_KEYSET).unwrap();
1282        let id = Id::v1_from_keys(&keys);
1283        let keyset = KeySet {
1284            id,
1285            unit: CurrencyUnit::Sat,
1286            active: Some(true),
1287            keys: keys.clone(),
1288            input_fee_ppk: 0,
1289            final_expiry: None,
1290        };
1291        assert!(keyset.verify_id().is_ok(), "valid v1 keyset should verify");
1292
1293        // v2 keyset
1294        let unit = CurrencyUnit::Sat;
1295        let input_fee_ppk = 100u64;
1296        let expiry = Some(2059210353u64);
1297        let id_v2 = Id::v2_from_data(&keys, &unit, input_fee_ppk, expiry);
1298        let keyset_v2 = KeySet {
1299            id: id_v2,
1300            unit,
1301            active: Some(true),
1302            keys,
1303            input_fee_ppk,
1304            final_expiry: expiry,
1305        };
1306        assert!(
1307            keyset_v2.verify_id().is_ok(),
1308            "valid v2 keyset should verify"
1309        );
1310    }
1311
1312    #[test]
1313    fn test_keyset_verify_id_mismatch_returns_error() {
1314        use super::KeySet;
1315
1316        // Use SHORT_KEYSET's keys but mislabel it with KEYSET_ID (from a different keyset).
1317        let keys: Keys = serde_json::from_str(SHORT_KEYSET).unwrap();
1318        let wrong_id = Id::from_str(KEYSET_ID).unwrap();
1319
1320        let keyset = KeySet {
1321            id: wrong_id,
1322            unit: CurrencyUnit::Sat,
1323            active: Some(true),
1324            keys,
1325            input_fee_ppk: 0,
1326            final_expiry: None,
1327        };
1328
1329        let res = keyset.verify_id();
1330        assert!(
1331            matches!(res, Err(Error::IncorrectKeysetId)),
1332            "expected IncorrectKeysetId, got {:?}",
1333            res
1334        );
1335    }
1336
1337    #[test]
1338    fn test_keyset_infos_active_filter() {
1339        use super::KeySetInfosMethods;
1340
1341        let id_a = Id::from_str("009a1f293253e41e").unwrap();
1342        let id_b = Id::from_str("00456a94ab4e1c46").unwrap();
1343        let id_c = Id::from_str("000f01df73ea149a").unwrap();
1344
1345        let infos: Vec<KeySetInfo> = vec![
1346            KeySetInfo {
1347                id: id_a,
1348                unit: CurrencyUnit::Sat,
1349                active: true,
1350                input_fee_ppk: 0,
1351                final_expiry: None,
1352            },
1353            KeySetInfo {
1354                id: id_b,
1355                unit: CurrencyUnit::Sat,
1356                active: false,
1357                input_fee_ppk: 0,
1358                final_expiry: None,
1359            },
1360            KeySetInfo {
1361                id: id_c,
1362                unit: CurrencyUnit::Usd,
1363                active: true,
1364                input_fee_ppk: 0,
1365                final_expiry: None,
1366            },
1367        ];
1368
1369        let active_ids: Vec<Id> = infos.active().map(|k| k.id).collect();
1370        assert_eq!(active_ids.len(), 2, "expected two active keysets");
1371        assert!(active_ids.contains(&id_a));
1372        assert!(active_ids.contains(&id_c));
1373        assert!(!active_ids.contains(&id_b));
1374    }
1375
1376    #[test]
1377    fn test_keyset_infos_unit_filter() {
1378        use super::KeySetInfosMethods;
1379
1380        let id_a = Id::from_str("009a1f293253e41e").unwrap();
1381        let id_b = Id::from_str("00456a94ab4e1c46").unwrap();
1382        let id_c = Id::from_str("000f01df73ea149a").unwrap();
1383
1384        let infos: Vec<KeySetInfo> = vec![
1385            KeySetInfo {
1386                id: id_a,
1387                unit: CurrencyUnit::Sat,
1388                active: true,
1389                input_fee_ppk: 0,
1390                final_expiry: None,
1391            },
1392            KeySetInfo {
1393                id: id_b,
1394                unit: CurrencyUnit::Usd,
1395                active: true,
1396                input_fee_ppk: 0,
1397                final_expiry: None,
1398            },
1399            KeySetInfo {
1400                id: id_c,
1401                unit: CurrencyUnit::Sat,
1402                active: false,
1403                input_fee_ppk: 0,
1404                final_expiry: None,
1405            },
1406        ];
1407
1408        let sat_ids: Vec<Id> = infos.unit(CurrencyUnit::Sat).map(|k| k.id).collect();
1409        assert_eq!(sat_ids.len(), 2, "expected two Sat keysets");
1410        assert!(sat_ids.contains(&id_a));
1411        assert!(sat_ids.contains(&id_c));
1412        assert!(
1413            !sat_ids.contains(&id_b),
1414            "Usd keyset should not appear in Sat filter"
1415        );
1416
1417        // A unit that does not match any entry must return an empty iterator.
1418        let none_ids: Vec<Id> = infos.unit(CurrencyUnit::Eur).map(|k| k.id).collect();
1419        assert!(none_ids.is_empty());
1420    }
1421
1422    #[test]
1423    fn test_default_input_fee_ppk_is_zero() {
1424        // KeySetInfo missing the input_fee_ppk field must default to 0.
1425        let json = r#"{"id":"009a1f293253e41e","unit":"sat","active":true}"#;
1426        let info: KeySetInfo = serde_json::from_str(json).unwrap();
1427        assert_eq!(info.input_fee_ppk, 0);
1428
1429        // Explicit null should also default to 0 via the custom deserializer.
1430        let json_null =
1431            r#"{"id":"009a1f293253e41e","unit":"sat","active":true,"input_fee_ppk":null}"#;
1432        let info_null: KeySetInfo = serde_json::from_str(json_null).unwrap();
1433        assert_eq!(info_null.input_fee_ppk, 0);
1434    }
1435}
cashu/nuts/nut02.rs

cashu/nuts/
nut02.rs
