multiversx-sc-snippets 0.65.1

MultiversX framework for building smart contract interaction snippets
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

use anyhow::Error;
use multiversx_sc_scenario::imports::Bech32Address;
use multiversx_sdk::gateway::{
    ChainSimulatorAddKeysRequest, ChainSimulatorGenerateBlocksRequest,
    ChainSimulatorSendFundsRequest, ChainSimulatorSetStateOverwriteRequest,
    ChainSimulatorSetStateRequest, GatewayAsyncService, SetStateAccount,
};

use crate::InteractorBase;

pub const ALL_ACTIVATIONS_EPOCH: u64 = 2;

impl<GatewayProxy> InteractorBase<GatewayProxy>
where
    GatewayProxy: GatewayAsyncService,
{
    pub async fn send_user_funds(&self, receiver: &Bech32Address) -> Result<String, Error> {
        if !self.use_chain_simulator {
            return Ok(String::from("no-simulator"));
        }

        self.proxy
            .request(ChainSimulatorSendFundsRequest::to_address(receiver))
            .await
    }

    pub async fn generate_blocks(&self, num_blocks: u64) -> Result<String, Error> {
        if !self.use_chain_simulator {
            return Ok(String::from("no-simulator"));
        }

        self.proxy
            .request(ChainSimulatorGenerateBlocksRequest::num_blocks(num_blocks))
            .await
    }

    pub async fn add_key(&self, key: Vec<u8>) -> Result<String, Error> {
        if !self.use_chain_simulator {
            return Ok(String::from("no-simulator"));
        }

        self.proxy
            .request(ChainSimulatorAddKeysRequest::with_keys(vec![key]))
            .await
    }

    pub async fn generate_blocks_until_epoch(&self, epoch_number: u64) -> Result<String, Error> {
        if !self.use_chain_simulator {
            return Ok(String::from("no-simulator"));
        }

        self.proxy
            .request(ChainSimulatorGenerateBlocksRequest::until_epoch(
                epoch_number,
            ))
            .await
    }

    /// Convenience method to wait enough blocks until all relevant activations are processed.
    pub async fn generate_blocks_until_all_activations(&self) {
        let _ = self
            .generate_blocks_until_epoch(ALL_ACTIVATIONS_EPOCH)
            .await
            .expect("Failed to generate blocks until all activations");
    }

    pub async fn generate_blocks_until_tx_processed(&self, tx_hash: &str) -> Result<String, Error> {
        if !self.use_chain_simulator {
            return Ok(String::from("no-simulator"));
        }

        self.proxy
            .request(ChainSimulatorGenerateBlocksRequest::until_tx_processed(
                tx_hash,
            ))
            .await
    }

    pub async fn set_state(&self, accounts: Vec<SetStateAccount>) -> Result<String, Error> {
        if !self.use_chain_simulator {
            return Ok(String::from("no-simulator"));
        }

        self.proxy
            .request(ChainSimulatorSetStateRequest::for_accounts(accounts))
            .await
    }

    pub async fn set_state_overwrite(
        &self,
        accounts: Vec<SetStateAccount>,
    ) -> Result<String, Error> {
        if !self.use_chain_simulator {
            return Ok(String::from("no-simulator"));
        }

        self.proxy
            .request(ChainSimulatorSetStateOverwriteRequest::for_accounts(
                accounts,
            ))
            .await
    }

    pub async fn set_state_for_saved_accounts(&self) -> Result<String, Error> {
        if !self.use_chain_simulator {
            return Ok(String::from("no-simulator"));
        }

        let accounts = self.get_accounts_from_file();
        self.proxy
            .request(ChainSimulatorSetStateRequest::for_accounts(accounts))
            .await
    }
}