智能部署

一个用于发布、开发、部署和升级 Soroban 智能合约的框架。

你可以将其视为智能合约的包管理器。

考虑以下合约

#![no_std]
use soroban_sdk::{self, contract, contractimpl};

#[contract]
pub struct ContractA;

#[contractimpl]
impl ContractA {
    pub fn add(x: u32, y: u32) -> u32 {
        x.checked_add(y).expect("no overflow")
    }
}

smartdeploy_sdk::core_riff!();

最后一行 smartdeploy_sdk::core_riff 确保合约可以重新部署。

构建后，您可以发布和部署合约。

smartdeploy call smartdeploy --fee 10000 -- \
                                publish \
                                --contract-name contract-a \
                                --wasm-file-path .../contract_a.wasm \
                                --author default
smartdeploy deploy --published-name contract_a \
                   --deployed-name contract_a \
                   --source default

现在假设我们还有一个第二个合约b

#![no_std]
use soroban_sdk::{self, contract, contractimpl, Address, Env};

smartdeploy_sdk::import_contract!(contract_a);

#[contract]
pub struct ContractB;

#[contractimpl]
impl ContractB {
    /// Add two numbers using the `add` method of ContractA.
    pub fn add_with(env: Env, contract_id: Address, x: u32, y: u32) -> u32 {
        contract_a::Client::new(&env, &contract_id).add(&x, &y)
    }
}

smartdeploy_sdk::core_riff!();

我们可以“安装”合约a，然后引用它来创建客户端

smartdeploy install contract_a

现在，import_contract 宏允许您以依赖常规Rust依赖项的方式导入合约。

smartdeploy_sdk::import_contract!(contract_a);
...
contract_a::Client::new(&env, &contract_id).add(&x, &y)

现在构建合约，因为合约a已被添加到 target/smartdeploy/contract_a/index.wasm

soroban contract build --package contract-b

在发布和部署 contract_b 后，让我们更进一步，创建第三个合约。

#![no_std]
use soroban_sdk::{self, contract, contractimpl, symbol_short, Env, Symbol};

smartdeploy_sdk::import_contract!(contract_a);
smartdeploy_sdk::import_contract!(contract_b);

#[contract]
pub struct ContractC;

const KEY: &Symbol = &symbol_short!("KEY");

fn default_value(env: &Env) -> u32 {
    env.storage().instance().get(KEY).unwrap_or_default()
}

#[contractimpl]
impl ContractC {
    /// Initialize the contract with a number to be used as the default value.
    pub fn init(env: Env, num: u32) {
        if !env.storage().instance().has(KEY) {
            env.storage().instance().set(KEY, &num);
        }
    }
    /// Add two numbers using the `add` method of ContractA.
    pub fn add_with(env: Env, x: u32, y: Option<u32>) -> u32 {
        contract_b::new(&env).add_with(
            &contract_a::address(&env),
            &x,
            &y.unwrap_or_else(|| default_value(&env)),
        )
    }
}

smartdeploy_sdk::core_riff!();

我们还需要安装 contract_b

smartdeploy install contract_b

这还将添加一个包含合约ID的 target/smartdeploy/contract_b/contract_id.txt 文件。有了合约的ID，我们可以直接创建客户端，而无需追踪合约ID。

contract_b::new(&env)

并且我们可以直接访问地址

contract_a::address(&env)

这对于预言机合约或任何希望开发者在其合约中调用的合约来说非常方便。

您还会注意到这个合约有一个init方法。目前，使用Soroban CLI，您无法一步部署和调用合约。但是，您可以使用smartdeploy！

就像Soroban CLI的出色功能一样，smartdeploy为要部署的合约生成一个CLI。您可以使用 --help 访问可能的方法。

smartdeploy deploy --published-name contract_c \
                   deployed-name c3pO \
                   --source default \ 
                   -- \
                   --help

smartdeploy deploy --published-name contract_c --deployed-name c3pO -- --help
Usage: c3pO [COMMAND]

Commands:
  add_with   
  owner_get  Returns the owner of the contract
  owner_set  Sets the owner of the contract. If one already set it transfers it to the new owner, if signed by owner.
  redeploy   Redeploy the contract to a wasm hash
  help       Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

smartdeploy deploy --published-name contract_c \
                   deployed-name c3pO \
                   --source default \ 
                   -- \
                   init --num 41

现在我们可以使用 smartdeploy call 调用合约，并省略 --y 参数，它应该默认为 41。

smartdeploy call c3pO -- add_with --x 1
42

这个调用创建了对 contract_b 的跨合约调用，然后调用 contract_a。这一切都无需手动引用任何合约ID！

Smartdeploy 也是一个 Dapp！

请在此查看： launch.smartdeploy.dev。

当前允许您查看所有发布的合约

部署它们

并查看所有已部署的合约

即将推出

• 自动生成的初始化方法输入表单，当以与 CLI 相同的方式进行部署时使用。
• 自动生成的任何已部署合约的方法表单（不仅仅是已部署的 smartdeploy）！
• 索引将让 dapp 让您快速搜索合约，就像在 crates.io 上一样。

入门指南

smartdeploy 的关键思想是合约应该可重新部署和维护。为了解决这个问题，smartdeploy 允许发布合约二进制文件和一组原语，以确保合约可以重新部署。

smartdeploy-sdk

首先，您需要将 smartdeploy-sdk 添加到合约的 Cargo.toml 文件中。

cargo add smartdeploy-sdk

soroban-cli

目前，smartdeploy 依赖于一个尚不稳定版本的 CLI。

cargo install soroban-cli --version 20.0.0-rc4

接下来，您需要在合约中添加以下行

smartdeploy_sdk::core_riff!();

这会给您的合约添加三个方法： owner_set、owner_get 和 redeploy。在部署您的合约后，您必须调用 owner_set，使用您的账户，以便您可以调用 redploy，提供已安装合约的哈希（有关更多信息，请参阅下一节）。

然而，在开发过程中，这可能会很麻烦，因此还有一个 dev_deploy。

smartdeploy::dev_deploy!();

这会给您的合约添加 dev_deploy 方法。这允许您仅使用 wasm 二进制文件重新部署您的合约。但是，它不适合在公共网络上使用，因为任何人都可以调用它。

因此，假设您选择了后者，在最初部署您的合约后，您将获得一个合约 ID，例如 CA5YTYGCKWYJW7P3JNSMVKV2HRN4TOFMZ2VW4AQ5WQS4P3BGHNOU3PPX。

然后，在修改您的合约后，您可以使用以下方法重新部署

soroban contract invoke --id CA5YTYGCKWYJW7P3JNSMVKV2HRN4TOFMZ2VW4AQ5WQS4P3BGHNOU3PPX \
                        --network <standalone/futurenet> \
                        --fee 1000000 \
                        --source <address or name of identity> \ 
                        -- \ 
                        dev_deploy --wasm-file-path <path/to/contarct.wasm>

这使用了新添加到合约生成的 CLI 中的 --<arg>-file-path 参数，允许您将文件作为合约方法的输入传递。也使用了 --fee，因为默认值是 100，这可能不足以支付包括合约字节的成本。

smartdeploy 的另一个核心思想是合约可以发布，以便任何人都可以部署其实例。这意味着此费用仅由合约发布者支付。

注意，您还可以在调用 invoke 的同一目录中使用 .env 文件来设置 CLI 参数。例如，

SOROBAN_NETWORK=standalone
SOROBAN_ACCOUNT=default
SOROBAN_FEE=1000000

使用 Loam-SDK

Smartdeploy CLI

安装

cargo install smartdeploy-cli

目前，smartdeploy CLI 有 install 和 call 子命令，允许您在调用时使用已部署合约的名称。

cargo run -- call smartdeploy -- --help

可以列出已部署合约

cargo run -- call smartdeploy -- list_deployed_contracts