# 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.](/guide/index/1_introduction_and_motivation.md)
* [Chapter 2 : Basic Concepts](/guide/index/2_basic_concepts.md)
* [Chapter 3 : Environment preparation](/guide/index/3_environment_preparation.md)
* [Chapter 4 : Issue and Mint Asset in Stellar.](/guide/index/4_issue_and_mint_asset_in_stellar.md)
* [Chapter 5: Get info about a token in Classic.](/guide/index/5_get_info_about_token_in_stellar.md)
* [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.](/guide/index/7_mint_from_a_wrapped_token_in_soroban.md)
* [Chapter 8 : Use the native Stellar Lumens (XLM) the classic way.](/guide/index/8_use_xlm_native_inside_classic.md)
* [Chapter 9 : Read the native token (XLM) using soroban-cli.](/guide/index/9_read_native_soroban_cli.md)
* [Chapter 10 : Write the native token (XLM) using soroban-cli.](/guide/index/10_native_xlm_transfer_transfer_from_soroban_cli.md)
* [Chapter 11 : Use the native token (XLM) inside a smart contract.](/guide/index/11_use_xlm_inside_contract.md)
* [Chapter 12 : Identify a Stellar Classic Asset using stellar-sdk.](/guide/index/12_identify_classic_using_stellar_sdk.md)
* [Chapter 13 : Wrap an asset using stellar-sdk.](/guide/index/13_wrap_classic_using_stellar_sdk.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://token-playground.gitbook.io/guide/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.