iota-sdk 1.0.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

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

use std::{sync::atomic::Ordering, time::Duration};

use tokio::time::sleep;

use crate::{
    client::secret::SecretManage,
    wallet::{account::operations::syncing::SyncOptions, Wallet},
};

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

impl<S: 'static + SecretManage> Wallet<S>
where
    crate::wallet::Error: From<S::Error>,
{
    /// Start the background syncing process for all accounts, default interval is 7 seconds
    pub async fn start_background_syncing(
        &self,
        options: Option<SyncOptions>,
        interval: Option<Duration>,
    ) -> crate::wallet::Result<()> {
        log::debug!("[start_background_syncing]");
        // stop existing process if running
        if self.background_syncing_status.load(Ordering::Relaxed) == 1 {
            self.background_syncing_status.store(2, Ordering::Relaxed);
        };
        while self.background_syncing_status.load(Ordering::Relaxed) == 2 {
            log::debug!("[background_syncing]: waiting for the old process to stop");
            sleep(Duration::from_secs(1)).await;
        }

        self.background_syncing_status.store(1, Ordering::Relaxed);
        let wallet = self.clone();
        let _background_syncing = std::thread::spawn(move || {
            #[cfg(not(target_family = "wasm"))]
            let runtime = tokio::runtime::Builder::new_multi_thread()
                .enable_all()
                .build()
                .unwrap();
            #[cfg(target_family = "wasm")]
            let runtime = tokio::runtime::Builder::new_current_thread()
                .enable_all()
                .build()
                .unwrap();
            runtime.block_on(async {
                'outer: loop {
                    log::debug!("[background_syncing]: syncing accounts");
                    for account in wallet.accounts.read().await.iter() {
                        // Check if the process should stop before syncing each account so it stops faster
                        if wallet.background_syncing_status.load(Ordering::Relaxed) == 2 {
                            log::debug!("[background_syncing]: stopping");
                            break 'outer;
                        }
                        match account.sync(options.clone()).await {
                            Ok(_) => {}
                            Err(err) => log::debug!("[background_syncing] error: {}", err),
                        };
                    }
                    // split interval syncing to seconds so stopping the process doesn't have to wait long
                    let seconds = interval.unwrap_or(DEFAULT_BACKGROUNDSYNCING_INTERVAL).as_secs();
                    for _ in 0..seconds {
                        if wallet.background_syncing_status.load(Ordering::Relaxed) == 2 {
                            log::debug!("[background_syncing]: stopping");
                            break 'outer;
                        }
                        sleep(Duration::from_secs(1)).await;
                    }
                }
                wallet.background_syncing_status.store(0, Ordering::Relaxed);
                log::debug!("[background_syncing]: stopped");
            });
        });
        Ok(())
    }

    /// Stop the background syncing of the accounts
    pub async fn stop_background_syncing(&self) -> crate::wallet::Result<()> {
        log::debug!("[stop_background_syncing]");
        // immediately return if not running
        if self.background_syncing_status.load(Ordering::Relaxed) == 0 {
            return Ok(());
        }
        // send stop request
        self.background_syncing_status.store(2, Ordering::Relaxed);
        // wait until it stopped
        while self.background_syncing_status.load(Ordering::Relaxed) != 0 {
            #[cfg(target_family = "wasm")]
            gloo_timers::future::TimeoutFuture::new(10).await;
            #[cfg(not(target_family = "wasm"))]
            tokio::time::sleep(std::time::Duration::from_millis(10)).await;
        }
        Ok(())
    }
}