fuel-core 0.15.3

Fuel client.
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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

use crate::{
    database::{
        resource::AssetSpendTarget,
        Database,
    },
    resource_query::{
        random_improve,
        SpendQuery,
    },
    schema::{
        coin::Coin,
        message::Message,
        scalars::{
            message_id::MessageId,
            Address,
            AssetId,
            UtxoId,
            U64,
        },
    },
    service::Config,
};
use async_graphql::{
    Context,
    InputObject,
    Object,
    Union,
};
use fuel_core_interfaces::common::fuel_tx;
use itertools::Itertools;

#[derive(InputObject)]
pub struct SpendQueryElementInput {
    /// Identifier of the asset to spend.
    asset_id: AssetId,
    /// Target amount for the query.
    amount: U64,
    /// The maximum number of currencies for selection.
    max: Option<U64>,
}

#[derive(InputObject)]
pub struct ExcludeInput {
    /// Utxos to exclude from the selection.
    utxos: Vec<UtxoId>,
    /// Messages to exclude from the selection.
    messages: Vec<MessageId>,
}

/// The schema analog of the [`crate::database::utils::Resource`].
#[derive(Union)]
pub enum Resource {
    Coin(Coin),
    Message(Message),
}

#[derive(Default)]
pub struct ResourceQuery;

#[Object]
impl ResourceQuery {
    /// For each `query_per_asset`, get some spendable resources(of asset specified by the query) owned by
    /// `owner` that add up at least the query amount. The returned resources are actual resources
    /// that can be spent. The number of resources is optimized to prevent dust accumulation.
    /// Max number of resources and excluded resources can also be specified.
    ///
    /// Returns:
    ///     The list of spendable resources per asset from the query. The length of the result is
    ///     the same as the length of `query_per_asset`. The ordering of assets and `query_per_asset`
    ///     is the same.
    async fn resources_to_spend(
        &self,
        ctx: &Context<'_>,
        #[graphql(desc = "The `Address` of the resources owner.")] owner: Address,
        #[graphql(desc = "\
            The list of requested assets` resources with asset ids, `target` amount the user wants \
            to reach, and the `max` number of resources in the selection. Several entries with the \
            same asset id are not allowed.")]
        query_per_asset: Vec<SpendQueryElementInput>,
        #[graphql(desc = "The excluded resources from the selection.")]
        excluded_ids: Option<ExcludeInput>,
    ) -> async_graphql::Result<Vec<Vec<Resource>>> {
        let config = ctx.data_unchecked::<Config>();

        let owner: fuel_tx::Address = owner.0;
        let query_per_asset = query_per_asset
            .into_iter()
            .map(|e| {
                AssetSpendTarget::new(
                    e.asset_id.0,
                    e.amount.0,
                    e.max
                        .map(|max| max.0)
                        .unwrap_or(config.chain_conf.transaction_parameters.max_inputs),
                )
            })
            .collect_vec();
        let excluded_ids: Option<Vec<_>> = excluded_ids.map(|exclude| {
            let utxos = exclude
                .utxos
                .into_iter()
                .map(|utxo| crate::database::resource::ResourceId::Utxo(utxo.0));
            let messages = exclude
                .messages
                .into_iter()
                .map(|message| crate::database::resource::ResourceId::Message(message.0));
            utxos.chain(messages).collect()
        });

        let spend_query = SpendQuery::new(owner, &query_per_asset, excluded_ids)?;

        let db = ctx.data_unchecked::<Database>();

        let resources = random_improve(db, &spend_query)?
            .into_iter()
            .map(|resources| {
                resources
                    .into_iter()
                    .map(|resource| match resource {
                        crate::database::resource::Resource::Coin { id, fields } => {
                            Resource::Coin(Coin(id, fields))
                        }
                        crate::database::resource::Resource::Message {
                            fields, ..
                        } => Resource::Message(Message(fields)),
                    })
                    .collect_vec()
            })
            .collect();

        Ok(resources)
    }
}