iota-sdk 0.3.0

The IOTA SDK provides developers with a seamless experience to develop on IOTA by providing account abstractions and clients to interact with node APIs.
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

// Copyright 2022 IOTA Stiftung
// SPDX-License-Identifier: Apache-2.0

//! Helper functions used in the input selection

use crate::{
    client::Result,
    types::block::{
        address::{Address, Ed25519Address},
        output::{
            unlock_condition::AddressUnlockCondition, BasicOutputBuilder, NativeTokens, Output, Rent, RentStructure,
        },
    },
};

// Dedup inputs by output id, because other data could be different, even if it's the same output
// TODO remove ?
// pub(crate) fn dedup_inputs(
//     mandatory_inputs: &mut Vec<InputSigningData>,
//     additional_inputs: &mut Vec<InputSigningData>,
// ) {
//     // Sorting inputs by OutputId so duplicates can be safely removed.
//     mandatory_inputs.sort_by_key(|input| *input.output_metadata.output_id());
//     mandatory_inputs.dedup_by_key(|input| *input.output_metadata.output_id());
//     additional_inputs.sort_by_key(|input| *input.output_metadata.output_id());
//     additional_inputs.dedup_by_key(|input| *input.output_metadata.output_id());

//     // Remove additional inputs that are already mandatory.
//     // TODO: could be done more efficiently with itertools unique?
//     additional_inputs.retain(|input| {
//         !mandatory_inputs
//             .iter()
//             .any(|mandatory_input| input.output_metadata.output_id() == mandatory_input.output_metadata.output_id())
//     });
// }

/// Computes the minimum storage deposit amount that a basic output needs to have with an [AddressUnlockCondition] and
/// optional [NativeTokens].
pub fn minimum_storage_deposit_basic_output(
    config: &RentStructure,
    native_tokens: &Option<NativeTokens>,
    token_supply: u64,
) -> Result<u64> {
    let mut basic_output_builder = BasicOutputBuilder::new_with_amount(Output::AMOUNT_MIN);
    if let Some(native_tokens) = native_tokens {
        basic_output_builder = basic_output_builder.with_native_tokens(native_tokens.clone());
    }
    let basic_output = basic_output_builder
        // Null address because we only care about the size and ed25519, alias and nft addresses have the same size.
        .add_unlock_condition(AddressUnlockCondition::new(Address::from(Ed25519Address::from(
            [0; Ed25519Address::LENGTH],
        ))))
        .finish_output(token_supply)?;

    Ok(basic_output.rent_cost(config))
}