Deploy a Stellar Asset Contract (SAC) from within a contract

​

Overview

​

Prerequisites:

• Basic understanding of Rust programming language. To brush up on Rust, check out Rustlings or The Rust book.
• Soroban Rust SDK installed and configured in your development environment.
• Basic understanding of the Soroban Rust SDK and familiarity with Soroban’s core concepts and Rust programming.

​

1. Define the SacDeployer contract

use soroban_sdk::{contract, contractimpl, Env, Address, Bytes};

#[contract]
pub struct SacDeployer;

#[contractimpl]
impl SacDeployer {
    pub fn deploy_sac(env: Env, serialized_asset: Bytes) -> Address {
        // Create the Deployer with Asset
        let deployer = env.deployer().with_stellar_asset(serialized_asset);
        let _ = deployer.deployed_address();
        // Deploy the Stellar Asset Contract
        let sac_address = deployer.deploy();

        sac_address
    }
}

​

Explanation

• SacDeployer contract: this contract defines the deploy_sac function to handle the deployment of the SAC.
• deploy_sac function:
  • env.deployer().with_stellar_asset(serialized_asset): creates a deployer configured to deploy a Stellar Asset Contract using the provided serialized asset.
  • deployer.deploy(): Deploys the SAC and returns the address of the deployed contract.

​

2. Testing the deployment

#[test]
fn test() {
    use soroban_sdk::{
        xdr::{Asset, Limits, WriteXdr},
        Bytes, Env,
    };

    let env = Env::default();
    let contract_id = env.register(SacDeployer, ());
    let client = SacDeployerClient::new(&env, &contract_id);

    let serialized_asset = Bytes::from_slice(&env, &Asset::Native.to_xdr(Limits::none()).unwrap());
    let sac_address = client.deploy_sac(&serialized_asset);

    assert_eq!(sac_address, env.deployer().with_stellar_asset(serialized_asset).deployed_address());
}

​

Explanation

• env.register(SacDeployer, ()): registers the SacDeployer contract in the test environment and returns its contract ID.
• SacDeployerClient::new(&env, &contract_id): creates a client used to invoke the deployed SacDeployer contract’s functions.
• serialized_asset: the Stellar Asset XDR serialized to bytes. This example serializes the native XLM asset via soroban_sdk::xdr::Asset; for an issued asset, use Asset::CreditAlphanum4/Asset::CreditAlphanum12 instead.
• client.deploy_sac(&serialized_asset): invokes the contract, which deploys the SAC and returns its address.
• The assertion confirms the returned address matches the deterministic address the SDK computes for that same serialized asset.

​

Conclusion