cml-chain-wasm 6.2.0

Multiplatform WASM SDK for main Cardano blockchain functionality
Documentation 
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
99
100
101
102

use wasm_bindgen::prelude::{wasm_bindgen, JsError};

use crate::{
    auxdata::AuxiliaryData,
    plutus::{CostModels, PlutusData, Redeemers},
    transaction::{TransactionBody, TransactionWitnessSet},
    utils::LanguageList,
    PlutusDataList,
};

use cml_crypto_wasm::{AuxiliaryDataHash, DatumHash, ScriptDataHash, TransactionHash};

use cml_chain::NonemptySet;

#[wasm_bindgen]
pub fn hash_auxiliary_data(auxiliary_data: &AuxiliaryData) -> AuxiliaryDataHash {
    cml_chain::crypto::hash::hash_auxiliary_data(auxiliary_data.as_ref()).into()
}

#[wasm_bindgen]
pub fn hash_transaction(tx_body: &TransactionBody) -> TransactionHash {
    cml_chain::crypto::hash::hash_transaction(tx_body.as_ref()).into()
}

#[wasm_bindgen]
pub fn hash_plutus_data(plutus_data: &PlutusData) -> DatumHash {
    cml_chain::crypto::hash::hash_plutus_data(plutus_data.as_ref()).into()
}

/// Calculates the hash for script data (no plutus scripts) if it is necessary.
/// Returns None if it was not necessary (no datums/redeemers) to include.
///
/// Most users will not directly need this as when using the builders
/// it will be invoked for you.
///
/// Note: This WASM binding does not work with non-standard witness set
/// encodings. If you created the witness set manually this is not an issue
/// but for constructing it from deserializing a transaction/witness then
/// please use calc_script_data_hash_from_witness()
#[wasm_bindgen]
pub fn hash_script_data(
    redeemers: &Redeemers,
    cost_models: &CostModels,
    datums: Option<PlutusDataList>,
    //    encoding: Option<TransactionWitnessSetEncoding>,
) -> ScriptDataHash {
    let datums = datums.map(|datums| NonemptySet::from(Into::<Vec<_>>::into(datums)));
    cml_chain::crypto::hash::hash_script_data(
        redeemers.as_ref(),
        cost_models.as_ref(),
        datums.as_ref(),
        None,
    )
    .into()
}

/// Calculates the hash for script data (with plutus scripts) if it is necessary.
/// Returns None if it was not necessary (no datums/redeemers) to include.
///
/// Most users will not directly need this as when using the builders
/// it will be invoked for you.
///
/// Note: This WASM binding does not work with non-standard witness set
/// encodings. If you created the witness set manually this is not an issue
/// but for constructing it from deserializing a transaction/witness then
/// please use calc_script_data_hash_from_witness()
#[wasm_bindgen]
pub fn calc_script_data_hash(
    redeemers: &Redeemers,
    datums: &PlutusDataList,
    cost_models: &CostModels,
    used_langs: &LanguageList,
    //    encoding: Option<TransactionWitnessSetEncoding>,
) -> Result<Option<ScriptDataHash>, JsError> {
    cml_chain::crypto::hash::calc_script_data_hash(
        redeemers.as_ref(),
        &NonemptySet::from(Into::<Vec<_>>::into(datums.clone())),
        cost_models.as_ref(),
        used_langs.as_ref(),
        None,
    )
    .map(|sdh| sdh.map(Into::into))
    .map_err(Into::into)
}

/// Calculates the hash for script data from a witness if it is necessary.
/// Returns None if it was not necessary (no datums/redeemers) to include.
///
/// Most users will not directly need this as when using the builders
/// it will be invoked for you.
#[wasm_bindgen]
pub fn calc_script_data_hash_from_witness(
    witnesses: &TransactionWitnessSet,
    cost_models: &CostModels,
) -> Result<Option<ScriptDataHash>, JsError> {
    cml_chain::crypto::hash::calc_script_data_hash_from_witness(
        witnesses.as_ref(),
        cost_models.as_ref(),
    )
    .map(|sdh| sdh.map(Into::into))
    .map_err(Into::into)
}