fuel-core 0.48.0

Fuel client library is aggregation of all fuels service. It contains the all business logic of the fuel protocol.
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

//! Queries we can run directly on `FuelService`.
use crate::graphql_api::ports::TxStatusManager;
use fuel_core_storage::Result as StorageResult;
use fuel_core_types::{
    fuel_tx::{
        Transaction,
        UniqueIdentifier,
    },
    fuel_types::Bytes32,
    services::transaction_status::TransactionStatus as TxPoolTxStatus,
    tai64::Tai64,
};
use futures::{
    Stream,
    StreamExt,
};

use crate::{
    database::OffChainIterableKeyValueView,
    query::{
        TxnStatusChangeState,
        transaction_status_change,
    },
    schema::tx::types::TransactionStatus,
};

use super::*;

impl FuelService {
    /// Submit a transaction to the txpool.
    pub async fn submit(&self, tx: Transaction) -> anyhow::Result<()> {
        self.shared
            .txpool_shared_state
            .insert(tx)
            .await
            .map_err(|e| anyhow::anyhow!(e))
    }

    /// Submit a transaction to the txpool and return a stream of status changes.
    pub async fn submit_and_status_change(
        &self,
        tx: Transaction,
    ) -> anyhow::Result<impl Stream<Item = anyhow::Result<TransactionStatus>> + '_> {
        let id = tx.id(&self
            .shared
            .config
            .snapshot_reader
            .chain_config()
            .consensus_parameters
            .chain_id());
        let stream = self.transaction_status_change(id).await?;
        self.submit(tx).await?;
        Ok(stream)
    }

    /// Submit a transaction to the txpool and return the final status.
    pub async fn submit_and_await_commit(
        &self,
        tx: Transaction,
    ) -> anyhow::Result<TransactionStatus> {
        let id = tx.id(&self
            .shared
            .config
            .snapshot_reader
            .chain_config()
            .consensus_parameters
            .chain_id());
        let stream = self.transaction_status_change(id).await?.filter(|status| {
            futures::future::ready(status.as_ref().is_ok_and(|status| status.is_final()))
        });
        futures::pin_mut!(stream);
        self.submit(tx).await?;
        stream
            .next()
            .await
            .ok_or_else(|| anyhow::anyhow!("Stream closed without transaction status"))?
    }

    /// Return a stream of status changes for a transaction.
    pub async fn transaction_status_change(
        &self,
        id: Bytes32,
    ) -> anyhow::Result<impl Stream<Item = anyhow::Result<TransactionStatus>> + '_> {
        // First subscribe to the statuses, and only after that create a view.
        let tx_status_manager = &self.shared.tx_status_manager;
        let rx = tx_status_manager.tx_update_subscribe(id).await?;
        let db = self.shared.database.off_chain().latest_view()?;
        let state = StatusChangeState {
            db,
            tx_status_manager,
        };
        Ok(transaction_status_change(state, rx, id, true).await)
    }
}

struct StatusChangeState<'a> {
    db: OffChainIterableKeyValueView,
    tx_status_manager: &'a TxStatusManagerAdapter,
}

impl TxnStatusChangeState for StatusChangeState<'_> {
    async fn get_tx_status(
        &self,
        id: Bytes32,
        include_preconfirmation: bool,
    ) -> StorageResult<Option<TxPoolTxStatus>> {
        match self.db.get_tx_status(&id)? {
            Some(status) => Ok(Some(status.into())),
            None => {
                let status = self.tx_status_manager.status(id).await?;
                let status = status.map(|status| {
                    // Filter out preconfirmation statuses if not allowed. Converting to submitted status
                    // because it's the closest to the preconfirmation status.
                    // Having `now()` as timestamp isn't ideal but shouldn't cause much inconsistency.
                    if !include_preconfirmation
                        && status.is_preconfirmation()
                        && !status.is_final()
                    {
                        TxPoolTxStatus::submitted(Tai64::now())
                    } else {
                        status
                    }
                });
                Ok(status)
            }
        }
    }
}