Deploy the Stellar Asset Contract for a Stellar asset
The Stellar CLI can deploy a Stellar Asset Contract for a Stellar asset so that any Stellar smart contract can interact with the asset.
Every Stellar asset has reserved a contract that anyone can deploy. Once deployed any contract can interact with that asset by holding a balance of the asset, receiving the asset, or sending the asset.
Deploying the Stellar Asset Contract for a Stellar asset enables that asset for use in smart contracts.
The Stellar Asset Contract can be deployed for any possible Stellar asset, either assets already in use on Stellar or assets that have never seen any activity. This means that the issuer doesn't need to have been created, and no one needs to be yet holding the asset on Stellar.
To perform the deploy, use the following command:
stellar contract asset deploy \
--source S... \
--network testnet \
--asset USDC:GCYEIQEWOCTTSA72VPZ6LYIZIK4W4KNGJR72UADIXUXG45VDFRVCQTYE
The asset
argument corresponds to the symbol and it's issuer address, which is how assets are identified on Stellar.
The same can be done for the native Lumens asset:
stellar contract asset deploy \
--source S... \
--network testnet \
--asset native
Deploying the native asset will fail on testnet or mainnet as a Stellar Asset Contract already exists.
For any asset, the contract address can be fetched with:
stellar contract id asset \
--network testnet \
--asset native
Guides in this category:
๐๏ธ Contract Lifecycle
Manage the lifecycle of a Stellar smart contract using the CLI
๐๏ธ Deploy a contract from installed Wasm bytecode
Deploy an instance of a compiled contract that is already installed on the network
๐๏ธ Deploy the Stellar Asset Contract for a Stellar asset
Deploy an SAC for a Stellar asset so that it can interact with smart contracts
๐๏ธ Extend a deployed contract instance's TTL
Use the CLI to extend the time to live (TTL) of a contract instance
๐๏ธ Extend a deployed contract's storage entry TTL
Use the CLI to extend the time to live (TTL) of a contract's persistent storage entry
๐๏ธ Extend a deployed contract's Wasm code TTL
Use Stellar CLI to extend contract's Wasm bytecode TTL, with or without local binary
๐๏ธ Install and deploy a smart contract
Combine the install and deploy commands in the Stellar CLI to accomplish both tasks
๐๏ธ Install Wasm bytecode
Use the Stellar CLI to install a compiled smart contract on the ledger
๐๏ธ Payments and Assets
Send XLM, stellar classic, or a soroban asset using the Stellar CLI
๐๏ธ Restore an archived contract using the Stellar CLI
Restore an archived contract instance using the Stellar CLI
๐๏ธ Restore archived contract data using the Stellar CLI
Restore archived contract storage entries using Stellar CLI