Struct Id 

pub struct Id { /* private fields */ }

A keyset ID is an identifier for a specific keyset. It can be derived by anyone who knows the set of public keys of a mint. The keyset ID CAN be stored in a Cashu token such that the token can be used to identify which mint or keyset it was generated from.

Implementations

impl Id

pub fn to_bytes(&self) -> Vec<u8>

Id to bytes

pub fn from_bytes(bytes: &[u8]) -> Result<Id, Error>

Id from bytes

pub fn get_version(&self) -> KeySetVersion

Get the version of the keyset

pub fn v2_from_data( map: &Keys, unit: &CurrencyUnit, input_fee_ppk: u64, expiry: Option<u64>, ) -> Id

*** V2 KEYSET *** create Id v2 from keys, unit and (optionally) expiry 1 - sort public keys by their amount in ascending order 2 - concatenate all public keys to one byte array 3 - concatenate the lowercase unit string to the byte array (e.g. “unit:sat”) 4 - If a final expiration is specified, convert it into a radix-10 string and concatenate it (e.g “final_expiry:1896187313”) 5 - HASH_SHA256 the concatenated byte array and take the first 31 bytes 6 - prefix it with a keyset ID version byte

Panics

This function will not panic under normal circumstances as the hash output is always valid hex and the correct length.

pub fn v1_from_keys(map: &Keys) -> Id

*** V1 VERSION *** As per NUT-02:

1. sort public keys by their amount in ascending order
2. concatenate all public keys to one string
3. HASH_SHA256 the concatenated public keys
4. take the first 14 characters of the hex-encoded hash
5. prefix it with a keyset ID version byte

Panics

This function will not panic under normal circumstances as the hash output is always valid hex and the correct length.

pub fn from_short_keyset_id( short_id: &ShortKeysetId, keysets_info: &[KeySetInfo], ) -> Result<Id, Error>

Selects the correct IDv2 from a list of keysets and the given short-id or returns the short-id in the case of v1.

Trait Implementations

impl Clone for Id

fn clone(&self) -> Id

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Id

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Id

fn deserialize<__D>( __deserializer: __D, ) -> Result<Id, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Id

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<&MintKeys> for Id

Available on crate feature mint only.

fn from(map: &MintKeys) -> Id

Converts to this type from the input type.

impl From<Id> for ShortKeysetId

fn from(id: Id) -> ShortKeysetId

Converts to this type from the input type.

impl From<Id> for String

fn from(value: Id) -> String

Converts to this type from the input type.

impl From<MintKeySet> for Id

Available on crate feature mint only.

fn from(keyset: MintKeySet) -> Id

Converts to this type from the input type.

impl FromStr for Id

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Id, <Id as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for Id

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Id

fn cmp(&self, other: &Id) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Id

fn eq(&self, other: &Id) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Id

fn partial_cmp(&self, other: &Id) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Id

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<String> for Id

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Id, <Id as TryFrom<String>>::Error>

Performs the conversion.

impl Copy for Id

impl Eq for Id

impl StructuralPartialEq for Id