casper-client 5.0.1

A client library and binary for interacting with the Casper network
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

use async_trait::async_trait;
use clap::{ArgMatches, Command};

use casper_client::cli::{CliError, DeployStrParams};

use super::creation_common::{self, DisplayOrder};
use crate::{command::ClientCommand, common, Success};

pub struct PutDeploy;

static DEPRECATION_WARNING: &str = r#"
#################################### WARNING ####################################
#                                                                               #
#        put-deploy subcommand is deprecated in favor of put-transaction        #
#                    and will be removed in a future release                    #
#                                                                               #
#################################################################################
"#;

#[async_trait]
impl ClientCommand for PutDeploy {
    const NAME: &'static str = "put-deploy";
    const ABOUT: &'static str =
        "[DEPRECATED: use `put-transaction` instead] Create a deploy and send it to the network for execution";

    fn build(display_order: usize) -> Command {
        let subcommand = Command::new(Self::NAME)
            .about(Self::ABOUT)
            .display_order(display_order)
            .arg(common::verbose::arg(DisplayOrder::Verbose as usize))
            .arg(common::rpc_id::arg(DisplayOrder::RpcId as usize))
            .arg(creation_common::speculative_exec::arg())
            .arg(creation_common::gas_price::arg())
            .arg(creation_common::min_bid_override::arg());
        let subcommand = creation_common::apply_common_session_options(subcommand);
        let subcommand = creation_common::apply_common_payment_options(subcommand, None);
        creation_common::apply_common_creation_options(subcommand, true, true)
    }

    async fn run(matches: &ArgMatches) -> Result<Success, CliError> {
        // show deprecation warning for each use of `put-deploy` subcommand
        println!("{DEPRECATION_WARNING}");

        creation_common::show_simple_arg_examples_and_exit_if_required(matches);
        creation_common::show_json_args_examples_and_exit_if_required(matches);

        let maybe_rpc_id = common::rpc_id::get(matches);
        let node_address = common::node_address::get(matches);
        let verbosity_level = common::verbose::get(matches);

        let secret_key = common::secret_key::get(matches).unwrap_or_default();
        let is_speculative_exec = creation_common::speculative_exec::get(matches);
        let timestamp = creation_common::timestamp::get(matches);
        let ttl = creation_common::ttl::get(matches);
        let chain_name = creation_common::chain_name::get(matches);
        let session_account = creation_common::session_account::get(matches)?;
        let gas_price = creation_common::gas_price::get(matches);
        let session_str_params = creation_common::session_str_params(matches);
        let payment_str_params = creation_common::payment_str_params(matches);
        let min_bid_override = creation_common::min_bid_override::get(matches);

        if is_speculative_exec {
            casper_client::cli::speculative_put_deploy(
                maybe_rpc_id,
                node_address,
                verbosity_level,
                DeployStrParams {
                    secret_key,
                    timestamp,
                    ttl,
                    chain_name,
                    session_account: &session_account,
                    gas_price_tolerance: gas_price,
                },
                session_str_params,
                payment_str_params,
            )
            .await
            .map(Success::from)
        } else {
            casper_client::cli::put_deploy_with_min_bid_override(
                maybe_rpc_id,
                node_address,
                verbosity_level,
                min_bid_override,
                DeployStrParams {
                    secret_key,
                    timestamp,
                    ttl,
                    chain_name,
                    session_account: &session_account,
                    gas_price_tolerance: gas_price,
                },
                session_str_params,
                payment_str_params,
            )
            .await
            .map(Success::from)
        }
    }
}