soroban-cli 26.0.0

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

use std::fmt::Debug;

use clap::Parser;

use crate::commands::{config::network, global};
use crate::config::{address::AliasName, locator};
use crate::print::Print;

#[derive(Parser, Debug, Clone)]
#[group(skip)]
pub struct Cmd {
    #[command(flatten)]
    pub config_locator: locator::Args,

    #[command(flatten)]
    pub network: network::Args,

    /// The contract alias that will be used.
    pub alias: AliasName,

    /// Overwrite the contract alias if it already exists.
    #[arg(long)]
    pub overwrite: bool,

    /// The contract id that will be associated with the alias.
    #[arg(long = "id")]
    pub contract_id: stellar_strkey::Contract,
}

#[derive(thiserror::Error, Debug)]
pub enum Error {
    #[error(transparent)]
    Locator(#[from] locator::Error),

    #[error(transparent)]
    Network(#[from] network::Error),

    #[error(
        "alias '{alias}' is already referencing contract '{contract}' on network '{network_passphrase}'"
    )]
    AlreadyExist {
        alias: String,
        network_passphrase: String,
        contract: stellar_strkey::Contract,
    },
}

impl Cmd {
    pub fn run(&self, global_args: &global::Args) -> Result<(), Error> {
        let print = Print::new(global_args.quiet);
        let alias = &self.alias;
        let network = self.network.get(&self.config_locator)?;
        let network_passphrase = &network.network_passphrase;

        let contract = self
            .config_locator
            .get_contract_id(&self.alias, network_passphrase)?;

        if let Some(contract) = contract {
            if contract != self.contract_id && !self.overwrite {
                return Err(Error::AlreadyExist {
                    alias: alias.to_string(),
                    network_passphrase: network_passphrase.clone(),
                    contract,
                });
            }
        }

        print.infoln(format!(
            "Contract alias '{alias}' will reference {contract} on network '{network_passphrase}'",
            contract = self.contract_id
        ));

        self.config_locator.save_contract_id(
            &network.network_passphrase,
            &self.contract_id,
            alias,
        )?;

        print.checkln(format!("Contract alias '{alias}' has been added"));

        Ok(())
    }
}