iota-sdk 2.0.0-beta.1

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
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

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

use std::time::Duration;

use tokio::time::timeout;

use crate::{
    client::{secret::SecretManage, ClientError},
    wallet::{operations::syncing::SyncOptions, task, Wallet, WalletError},
};

/// The default interval for background syncing
pub(crate) const DEFAULT_BACKGROUNDSYNCING_INTERVAL: Duration = Duration::from_secs(7);

#[derive(Clone, PartialEq, Debug)]
pub(crate) enum BackgroundSyncStatus {
    Stopped,
    Running,
    Stopping,
}

impl<S: 'static + SecretManage> Wallet<S>
where
    WalletError: From<S::Error>,
    ClientError: From<S::Error>,
{
    /// Start the background syncing process for the wallet, default interval is 7 seconds
    pub async fn start_background_syncing(
        &self,
        options: impl Into<Option<SyncOptions>> + Send,
        interval: Option<Duration>,
    ) -> Result<(), WalletError> {
        log::debug!("[start_background_syncing]");

        let options = options.into();
        let (tx_background_sync, mut rx_background_sync) = self.background_syncing_status.clone();

        // stop existing process if running
        if *rx_background_sync.borrow() == BackgroundSyncStatus::Running {
            tx_background_sync.send(BackgroundSyncStatus::Stopping).ok();
        }

        log::debug!("[background_syncing]: waiting for the old process to stop");
        rx_background_sync
            .wait_for(|status| *status != BackgroundSyncStatus::Stopping)
            .await
            .ok();

        tx_background_sync.send(BackgroundSyncStatus::Running).ok();

        let wallet = self.clone();
        let interval_seconds = interval.unwrap_or(DEFAULT_BACKGROUNDSYNCING_INTERVAL);

        task::spawn(async move {
            loop {
                log::debug!("[background_syncing]: syncing wallet");

                if let Err(err) = wallet.sync(options).await {
                    log::debug!("[background_syncing] error: {}", err)
                }

                let res = timeout(interval_seconds, async {
                    rx_background_sync
                        .wait_for(|status| *status == BackgroundSyncStatus::Stopping)
                        .await
                        .is_ok()
                })
                .await;

                // If true it means rx_background_sync changed to BackgroundSyncStatus::Stopping
                if Ok(true) == res {
                    log::debug!("[background_syncing]: stopping");
                    break;
                }
            }
            tx_background_sync.send(BackgroundSyncStatus::Stopped).ok();
            log::debug!("[background_syncing]: stopped");
        });
        Ok(())
    }

    /// Request to stop the background syncing of the wallet
    pub fn request_stop_background_syncing(&self) {
        log::debug!("[request_stop_background_syncing]");
        self.background_syncing_status
            .0
            .send(BackgroundSyncStatus::Stopping)
            .ok();
    }

    /// Stop the background syncing of the wallet
    pub async fn stop_background_syncing(&self) -> Result<(), WalletError> {
        log::debug!("[stop_background_syncing]");

        let mut rx_background_sync = self.background_syncing_status.1.clone();

        // immediately return if is stopped
        if *rx_background_sync.borrow() == BackgroundSyncStatus::Stopped {
            return Ok(());
        }

        // send stop request
        self.request_stop_background_syncing();

        // wait until it has stopped
        rx_background_sync
            .wait_for(|status| *status == BackgroundSyncStatus::Stopped)
            .await
            .ok();

        Ok(())
    }
}