Skip to main content

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
note

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