from sqlite3 import Row from typing import Any, Dict, List, Optional, TypedDict, Union from pydantic import BaseModel from cashu.core.crypto import derive_keys, derive_keyset_id, derive_pubkeys from cashu.core.secp import PrivateKey, PublicKey # ------- PROOFS ------- class P2SHScript(BaseModel): """ Describes spending condition of a Proof """ script: str signature: str address: Union[str, None] = None class Proof(BaseModel): """ Value token """ id: Union[ None, str ] = "" # NOTE: None for backwards compatibility for old clients that do not include the keyset id < 0.3 amount: int = 0 secret: str = "" # secret or message to be blinded and signed C: str = "" # signature on secret, unblinded by wallet script: Union[P2SHScript, None] = None # P2SH spending condition reserved: Union[ None, bool ] = False # whether this proof is reserved for sending, used for coin management in the wallet send_id: Union[ None, str ] = "" # unique ID of send attempt, used for grouping pending tokens in the wallet time_created: Union[None, str] = "" time_reserved: Union[None, str] = "" def to_dict(self): # dictionary without the fields that don't need to be send to Carol return dict(id=self.id, amount=self.amount, secret=self.secret, C=self.C) def to_dict_no_secret(self): # dictionary but without the secret itself return dict(id=self.id, amount=self.amount, C=self.C) def __getitem__(self, key): return self.__getattribute__(key) def __setitem__(self, key, val): self.__setattr__(key, val) class Proofs(BaseModel): # NOTE: not used in Pydantic validation __root__: List[Proof] class BlindedMessage(BaseModel): """ Blinded message or blinded secret or "output" which is to be signed by the mint """ amount: int B_: str # Hex-encoded blinded message class BlindedSignature(BaseModel): """ Blinded signature or "promise" which is the signature on a `BlindedMessage` """ id: Union[str, None] = None amount: int C_: str # Hex-encoded signature class BlindedMessages(BaseModel): # NOTE: not used in Pydantic validation __root__: List[BlindedMessage] = [] # ------- LIGHTNING INVOICE ------- class Invoice(BaseModel): amount: int pr: str hash: Union[None, str] = None preimage: Union[str, None] = None issued: Union[None, bool] = False paid: Union[None, bool] = False time_created: Union[None, str, int, float] = "" time_paid: Union[None, str, int, float] = "" # ------- API ------- # ------- API: KEYS ------- class KeysResponse(BaseModel): __root__: Dict[str, str] class KeysetsResponse(BaseModel): keysets: list[str] # ------- API: MINT ------- class PostMintRequest(BaseModel): outputs: List[BlindedMessage] class PostMintResponseLegacy(BaseModel): # NOTE: Backwards compability for < 0.8.0 where we used a simple list and not a key-value dictionary __root__: List[BlindedSignature] = [] class PostMintResponse(BaseModel): promises: List[BlindedSignature] = [] class GetMintResponse(BaseModel): pr: str hash: str # ------- API: MELT ------- class PostMeltRequest(BaseModel): proofs: List[Proof] pr: str outputs: Union[List[BlindedMessage], None] class GetMeltResponse(BaseModel): paid: Union[bool, None] preimage: Union[str, None] change: Union[List[BlindedSignature], None] = None # ------- API: SPLIT ------- class PostSplitRequest(BaseModel): proofs: List[Proof] amount: int outputs: List[BlindedMessage] class PostSplitResponse(BaseModel): fst: List[BlindedSignature] snd: List[BlindedSignature] # ------- API: CHECK ------- class CheckSpendableRequest(BaseModel): proofs: List[Proof] class CheckSpendableResponse(BaseModel): spendable: List[bool] class CheckFeesRequest(BaseModel): pr: str class CheckFeesResponse(BaseModel): fee: Union[int, None] # ------- KEYSETS ------- class KeyBase(BaseModel): """ Public key from a keyset id for a given amount. """ id: str amount: int pubkey: str class WalletKeyset: """ Contains the keyset from the wallets's perspective. """ id: Union[str, None] public_keys: Union[Dict[int, PublicKey], None] mint_url: Union[str, None] = None valid_from: Union[str, None] = None valid_to: Union[str, None] = None first_seen: Union[str, None] = None active: Union[bool, None] = True def __init__( self, public_keys=None, mint_url=None, id=None, valid_from=None, valid_to=None, first_seen=None, active=None, ): self.id = id self.valid_from = valid_from self.valid_to = valid_to self.first_seen = first_seen self.active = active self.mint_url = mint_url if public_keys: self.public_keys = public_keys self.id = derive_keyset_id(self.public_keys) class MintKeyset: """ Contains the keyset from the mint's perspective. """ id: Union[str, None] derivation_path: str private_keys: Dict[int, PrivateKey] public_keys: Union[Dict[int, PublicKey], None] = None valid_from: Union[str, None] = None valid_to: Union[str, None] = None first_seen: Union[str, None] = None active: Union[bool, None] = True version: Union[str, None] = None def __init__( self, id=None, valid_from=None, valid_to=None, first_seen=None, active=None, seed: str = "", derivation_path: str = "", version: str = "", ): self.derivation_path = derivation_path self.id = id self.valid_from = valid_from self.valid_to = valid_to self.first_seen = first_seen self.active = active self.version = version # generate keys from seed if seed: self.generate_keys(seed) def generate_keys(self, seed): """Generates keys of a keyset from a seed.""" self.private_keys = derive_keys(seed, self.derivation_path) self.public_keys = derive_pubkeys(self.private_keys) # type: ignore self.id = derive_keyset_id(self.public_keys) # type: ignore def get_keybase(self): assert self.id is not None return { k: KeyBase(id=self.id, amount=k, pubkey=v.serialize().hex()) for k, v in self.public_keys.items() # type: ignore } class MintKeysets: """ Collection of keyset IDs and the corresponding keyset of the mint. """ keysets: Dict[str, MintKeyset] def __init__(self, keysets: List[MintKeyset]): self.keysets = {k.id: k for k in keysets} # type: ignore def get_ids(self): return [k for k, _ in self.keysets.items()] # ------- TOKEN ------- class TokenV1(BaseModel): """ A (legacy) Cashu token that includes proofs. This can only be received if the receiver knows the mint associated with the keyset ids of the proofs. """ # NOTE: not used in Pydantic validation __root__: List[Proof] class TokenV2Mint(BaseModel): """ Object that describes how to reach the mints associated with the proofs in a TokenV2 object. """ url: str # mint URL ids: List[str] # List of keyset id's that are from this mint class TokenV2(BaseModel): """ A Cashu token that includes proofs and their respective mints. Can include proofs from multiple different mints and keysets. """ proofs: List[Proof] mints: Optional[List[TokenV2Mint]] = None def to_dict(self): if self.mints: return dict( proofs=[p.to_dict() for p in self.proofs], mints=[m.dict() for m in self.mints], ) else: return dict(proofs=[p.to_dict() for p in self.proofs])