miden-client-web 0.14.3

Web Client library that facilitates interaction with the Miden network
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

use miden_client::auth::{PublicKey as NativePublicKey, Signature as NativeSignature};
use miden_client::{Deserializable, Word as NativeWord};
use wasm_bindgen::prelude::*;
use wasm_bindgen_futures::js_sys::Uint8Array;

use crate::js_error_with_context;
use crate::models::signature::Signature;
use crate::models::signing_inputs::SigningInputs;
use crate::models::word::Word;
use crate::utils::serialize_to_uint8array;

#[wasm_bindgen]
#[derive(Clone)]
pub struct PublicKey(pub(crate) NativePublicKey);

#[wasm_bindgen]
impl PublicKey {
    /// Serializes the public key into bytes.
    pub fn serialize(&self) -> Uint8Array {
        serialize_to_uint8array(&self.0)
    }

    /// Deserializes a public key from bytes.
    pub fn deserialize(bytes: &Uint8Array) -> Result<PublicKey, JsValue> {
        let native_public_key = NativePublicKey::read_from_bytes(&bytes.to_vec())
            .map_err(|e| js_error_with_context(e, "Failed to deserialize public key"))?;
        Ok(PublicKey(native_public_key))
    }

    /// Verifies a blind message word against the signature.
    pub fn verify(&self, message: &Word, signature: &Signature) -> bool {
        self.verify_data(&SigningInputs::new_blind(message), signature)
    }

    /// Returns the commitment corresponding to this public key.
    #[wasm_bindgen(js_name = "toCommitment")]
    pub fn to_commitment(&self) -> Word {
        let commitment = self.0.to_commitment();
        let native_word: NativeWord = commitment.into();
        native_word.into()
    }

    /// Recovers a public key from a signature (only supported for `RpoFalcon512`).
    #[wasm_bindgen(js_name = "recoverFrom")]
    pub fn recover_from(message: &Word, signature: &Signature) -> Result<PublicKey, JsValue> {
        let native_message: NativeWord = message.into();
        let native_signature: NativeSignature = signature.into();

        match native_signature {
            NativeSignature::Falcon512Poseidon2(falcon_signature) => {
                let public_key = miden_client::crypto::rpo_falcon512::PublicKey::recover_from(
                    native_message,
                    &falcon_signature,
                );
                Ok(NativePublicKey::Falcon512Poseidon2(public_key).into())
            },
            NativeSignature::EcdsaK256Keccak(_) => Err(JsValue::from_str(
                "Recovering a public key from an EcdsaK256Keccak signature is not supported yet",
            )),
        }
    }

    /// Verifies a signature over arbitrary signing inputs.
    #[wasm_bindgen(js_name = "verifyData")]
    pub fn verify_data(&self, signing_inputs: &SigningInputs, signature: &Signature) -> bool {
        let native_public_key: NativePublicKey = self.into();
        let message = signing_inputs.to_commitment().into();
        let native_signature: NativeSignature = signature.clone().into();
        native_public_key.verify(message, native_signature)
    }
}

// CONVERSIONS
// ================================================================================================

impl From<NativePublicKey> for PublicKey {
    fn from(native_public_key: NativePublicKey) -> Self {
        PublicKey(native_public_key)
    }
}

impl From<&NativePublicKey> for PublicKey {
    fn from(native_public_key: &NativePublicKey) -> Self {
        PublicKey(native_public_key.clone())
    }
}

impl From<PublicKey> for NativePublicKey {
    fn from(public_key: PublicKey) -> Self {
        public_key.0
    }
}

impl From<&PublicKey> for NativePublicKey {
    fn from(public_key: &PublicKey) -> Self {
        public_key.0.clone()
    }
}