Importing Testnet Tokens

​

Tutorial: Importing Testnet Tokens for Use in Soroban

​

Introduction

​

Prerequisites

• Basic understanding of blockchain concepts and the Stellar network.
• A system with Bash shell.
• The jq tool installed for JSON processing.
• The Stellar CLI installed.

​

Overview of the Script

• Reading and merging asset lists from JSON files.
• Wrapping each asset to be compatible with Soroban.
• Updating a token list with new Soroban addresses.

​

Script Breakdown

1. Setting Environment Variables and Directories
   ASSETS_DIRECTORY="/path/to/known_stellar_classic_assets.json"
   GENERATED_STELLAR_ASSETS="/path/to/generated_stellar_assets.json"
   
   • ASSETS_DIRECTORY and GENERATED_STELLAR_ASSETS point to the JSON files containing asset information.
   • known_stellar_classic_assets.json example
   {
     "tokens": [
       {
         "symbol": "USDC",
         "name": "centre.ioUSDCoin",
         "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
         "asset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
       }
     ]
   }
   
2. Reading and Merging Asset Lists

CLASSIC_ASSETS_JSON=$(jq '.tokens' "$ASSETS_DIRECTORY")
GENERATED_ASSETS_JSON=$(jq '.tokens' "$GENERATED_STELLAR_ASSETS")

3. Wrapping Assets
   TOKEN_ADDRESS=$(stellar contract id asset --network "$NETWORK" --asset "$ASSET")
   
   This is the critical line where each asset is wrapped. The stellar contract id asset command deploys the built in Stellar Asset Contract for the asset and returns its contract address, which is how Soroban contracts reach that same asset.
4. Looping Through Assets The script loops through each asset in the merged list, wrapping them and updating the token list with their new Soroban addresses.
5. Updating the Token List The updated token addresses are saved back to the TOKENS_DIRECTORY, ensuring that the assets are now usable in Soroban.
6. Error Handling and Outputs The script includes checks to handle errors and provide informative output messages throughout the process.

​

Running the Script

1. Ensure you have the necessary JSON files in the specified directories.
2. Run the script in your Bash shell:
   ./setup_stellar_classic_assets.sh [network]
   
   Replace [network] with the desired network type (e.g., testnet).

​

Conclusion