Struct soroban_sdk::deploy::Deployer

pub struct Deployer { /* private fields */ }

Deployer provides access to deploying contracts.

Implementations

impl Deployer

pub fn env(&self) -> &Env

pub fn with_current_contract( &self, salt: impl IntoVal<Env, BytesN<32>> ) -> DeployerWithAddress

Get a deployer that deploys contract that derive the contract IDs from the current contract and provided salt.

pub fn with_address( &self, address: Address, salt: impl IntoVal<Env, BytesN<32>> ) -> DeployerWithAddress

Get a deployer that deploys contracts that derive the contract ID from the provided address and salt.

The deployer address must authorize all the deployments.

pub fn with_stellar_asset( &self, serialized_asset: impl IntoVal<Env, Bytes> ) -> DeployerWithAsset

Get a deployer that deploys an instance of Stellar Asset Contract corresponding to the provided serialized asset.

serialized_asset is the Stellar Asset XDR serialized to bytes. Refer to [soroban_sdk::xdr::Asset]

pub fn upload_contract_wasm( &self, contract_wasm: impl IntoVal<Env, Bytes> ) -> BytesN<32>

Upload the contract Wasm code to the network.

Returns the hash of the uploaded Wasm that can be then used for the contract deployment.

Examples

use soroban_sdk::{BytesN, Env};

const WASM: &[u8] = include_bytes!("../doctest_fixtures/contract.wasm");

#[test]
fn test() {
    let env = Env::default();
    env.deployer().upload_contract_wasm(WASM);
}

pub fn update_current_contract_wasm( &self, wasm_hash: impl IntoVal<Env, BytesN<32>> )

Replaces the executable of the current contract with the provided Wasm.

The Wasm blob identified by the wasm_hash has to be already present in the ledger (uploaded via [Deployer::upload_contract_wasm]).

The function won’t do anything immediately. The contract executable will only be updated after the invocation has successfully finished.