# README

Soroban provides a mechanism to **wrap a (classic) Stellar asset in a smart contract** so that the token can be minted and transferred in Soroban. However, a lot of questions are arised...

Soroban offers a mechanism to **wrap a (classic) Stellar asset within a smart contract** enabling the token to be minted and exchanged within the Soroban framework. However, numerous questions have arisen...

* How can developers **issue tokens** within Soroban or **wrap an existing Stellar Classic Asset?**
* Do these two chains **share the token balance** for a specific address?
* What occurs if the **issuer mints** tokens in Soroban subsequent to wrapping the asset?
* Can the Smart Contract prevent Stellar Classic transactions involving the Stellar Asset?
* Is it possible to impose specific logic during asset transfers?
* How do we handle the native Stellar Lumens (XLM) token within Soroban?

We have developed a **token playground** to explain how Stellar assets can be managed from a Soroban smart contract. Please check our Playground's Chapters:

* [Chapter 1: Introduction & Motivation.](https://token-playground.gitbook.io/guide/index/1_introduction_and_motivation)
* [Chapter 2 : Basic Concepts](https://token-playground.gitbook.io/guide/index/2_basic_concepts)
* [Chapter 3 : Environment preparation](https://token-playground.gitbook.io/guide/index/3_environment_preparation)
* [Chapter 4 : Issue and Mint Asset in Stellar.](https://token-playground.gitbook.io/guide/index/4_issue_and_mint_asset_in_stellar)
* [Chapter 5: Get info about a token in Classic.](https://token-playground.gitbook.io/guide/index/5_get_info_about_token_in_stellar)
* [Chapter 6 : Wrap a token from Stellar Classic to Soroban.](https://github.com/esteblock/token-playground/blob/main/docs/6_wrap-a-token-from-classic-to-soroban.md)
* [Chapter 7 : Mint from a wrapped token in Soroban.](https://token-playground.gitbook.io/guide/index/7_mint_from_a_wrapped_token_in_soroban)
* [Chapter 8 : Use the native Stellar Lumens (XLM) the classic way.](https://token-playground.gitbook.io/guide/index/8_use_xlm_native_inside_classic)
* [Chapter 9 : Read the native token (XLM) using soroban-cli.](https://token-playground.gitbook.io/guide/index/9_read_native_soroban_cli)
* [Chapter 10 : Write the native token (XLM) using soroban-cli.](https://token-playground.gitbook.io/guide/index/10_native_xlm_transfer_transfer_from_soroban_cli)
* [Chapter 11 : Use the native token (XLM) inside a smart contract.](https://token-playground.gitbook.io/guide/index/11_use_xlm_inside_contract)
* [Chapter 12 : Identify a Stellar Classic Asset using stellar-sdk.](https://token-playground.gitbook.io/guide/index/12_identify_classic_using_stellar_sdk)
* [Chapter 13 : Wrap an asset using stellar-sdk.](https://token-playground.gitbook.io/guide/index/13_wrap_classic_using_stellar_sdk)