stellar-registry-cli 0.0.18

Stellar CLI plugin for publishing and deploying contracts
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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152

use std::{io::Write, path::PathBuf};

use clap::Parser;
use stellar_cli::{commands::contract::invoke, xdr};
use stellar_registry_build::named_registry::PrefixedName;

use crate::commands::global;

#[derive(Parser, Debug, Clone)]
pub struct Cmd {
    /// Name of published Wasm
    pub wasm_name: PrefixedName,

    /// Version of published Wasm, if not specified, the latest version will be fetched
    #[arg(long)]
    pub version: Option<String>,

    /// Where to write file. default stdout
    #[arg(long, short = 'o')]
    pub out_file: Option<PathBuf>,

    #[command(flatten)]
    pub config: global::Args,
}

#[derive(thiserror::Error, Debug)]
pub enum Error {
    #[error(transparent)]
    Invoke(#[from] invoke::Error),
    #[error(transparent)]
    Strkey(#[from] stellar_strkey::DecodeError),
    #[error(transparent)]
    LocatorConfig(#[from] stellar_cli::config::locator::Error),
    #[error(transparent)]
    Config(#[from] stellar_cli::config::Error),
    #[error(transparent)]
    Io(#[from] std::io::Error),

    #[error(transparent)]
    Rpc(#[from] soroban_rpc::Error),
    #[error(transparent)]
    Xdr(#[from] xdr::Error),
    #[error(transparent)]
    Network(#[from] stellar_cli::config::network::Error),
    #[error(transparent)]
    Registry(#[from] stellar_registry_build::Error),
}

impl Cmd {
    pub async fn run(&self) -> Result<(), Error> {
        let bytes = self.download_bytes().await?;
        if let Some(file) = self.out_file.as_deref() {
            let parent = file.parent().unwrap();
            std::fs::create_dir_all(parent)?;
            let mut f = std::fs::File::create(file)?;
            f.write_all(&bytes)?;
        } else {
            std::io::stdout().write_all(&bytes)?;
        }
        Ok(())
    }

    pub async fn download_bytes(&self) -> Result<Vec<u8>, Error> {
        let registry = &self.wasm_name.registry(&self.config).await?;
        let mut slop = vec!["fetch_hash", "--wasm-name", &self.wasm_name.name];
        let version = self.version.clone().map(|v| format!("\"{v}\""));
        if let Some(version) = version.as_deref() {
            slop.push("--version");
            slop.push(version);
        }
        let raw = registry
            .as_contract()
            .invoke_with_result(&slop, true)
            .await?;
        let bytes = stellar_cli::utils::rpc::get_remote_wasm_from_hash(
            &self.config.get_network()?.rpc_client()?,
            &raw.trim_matches('"').parse()?,
        )
        .await?;
        Ok(bytes)
    }
}

#[cfg(feature = "integration-tests")]
#[cfg(test)]
mod tests {
    use stellar_scaffold_test::RegistryTest;

    #[tokio::test]
    async fn simple() {
        // Create test environment

        let registry = RegistryTest::new().await;
        let v1 = registry.hello_wasm_v1();
        let _test_env = registry.clone().env;

        // Path to the hello world contract WASM

        // First publish the contract
        registry
            .registry_cli("publish")
            .arg("--wasm")
            .arg(v1.to_str().unwrap())
            .arg("--binver")
            .arg("0.0.1")
            .arg("--wasm-name")
            .arg("hello")
            .assert()
            .success();

        let bytes = registry
            .parse_cmd::<crate::commands::download::Cmd>(&["hello"])
            .unwrap()
            .download_bytes()
            .await
            .unwrap();
        let expected = std::fs::read(v1).unwrap();
        assert_eq!(bytes, expected);
    }

    #[tokio::test]
    async fn unverified() {
        // Create test environment

        let registry = RegistryTest::new().await;
        let v1 = registry.hello_wasm_v1();
        let _test_env = registry.clone().env;

        // Path to the hello world contract WASM

        // First publish the contract
        registry
            .registry_cli("publish")
            .arg("--wasm")
            .arg(v1.to_str().unwrap())
            .arg("--binver")
            .arg("0.0.1")
            .arg("--wasm-name")
            .arg("unverified/hello")
            .assert()
            .success();

        let bytes = registry
            .parse_cmd::<crate::commands::download::Cmd>(&["unverified/hello"])
            .unwrap()
            .download_bytes()
            .await
            .unwrap();
        let expected = std::fs::read(v1).unwrap();
        assert_eq!(bytes, expected);
    }
}