https://github.com/stellar/soroban-react-mint-token
An example dapp for minting tokens on Soroban
https://github.com/stellar/soroban-react-mint-token
Last synced: about 1 year ago
JSON representation
An example dapp for minting tokens on Soroban
- Host: GitHub
- URL: https://github.com/stellar/soroban-react-mint-token
- Owner: stellar
- Created: 2023-06-12T16:35:43.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-22T19:00:51.000Z (about 2 years ago)
- Last Synced: 2024-04-22T20:27:35.925Z (about 2 years ago)
- Language: TypeScript
- Homepage:
- Size: 989 KB
- Stars: 2
- Watchers: 17
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Soroban React Mint Token
This serves as a basic example of how a token administrator can mint more tokens
on Soroban.
You can explore this dapp at https://scaffold-soroban.stellar.org/ by choosing
mint-token from the "select demo" dropdown.
## Prerequisites
The Mint Token DApp relies on the following dependencies:
- Node (>=16.14.0 <=18.0.0): https://nodejs.org/en/download/
- Yarn (v1.22.5 or newer): https://classic.yarnpkg.com/en/docs/install
- Freighter wallet(v5.0 or newer): https://www.freighter.app/
## Features
The Mint Token DApp offers the following features:
1. **Freighter Wallet Integration**: The Mint Token DApp seamlessly integrates
with Freighter/Albedo/XBull, allowing users to connect their wallet to access
Soroban token balances and utilize their signing capabilities for
secure and integrity-checked transactions.
2. **Transaction Construction**: Leveraging the Soroban token's contract
interface, the DApp constructs transactions that invoke the `mint`
method. This method facilitates the minting of new tokens to an address.
## Getting Started
To use the Mint Token DApp, follow these steps:
1. Install and set up one of the supported wallets.
- [Freighter wallet](https://www.freighter.app/)
- [Albedo wallet](https://albedo.link/install-extension)
- [XBull wallet](https://xbull.app/)
2. Clone and navigate into the
[Mint Token DApp repository](https://github.com/stellar/soroban-react-mint-token/tree/main)
by trunning the following:
```
git clone https://github.com/stellar/soroban-react-mint-token.git
cd soroban-react-mint-token
```
3. Install the dependencies by running the following:
```
yarn
```
4. If you are using the Freighter wallet, ensure that experimental mode
is enabled. You can find this setting in Freighter wallet at:
_`Settings(⚙️)>Preferences>ENABLE EXPERIMENTAL MODE`_.
6. [Enable and add Soroban Tokens](https://soroban.stellar.org/docs/getting-started/connect-freighter-wallet#enable-soroban-tokens)
in Freighter.
7. Connect the dapp to Freighter.
8. Add the public key for the account that will receive the newly minted tokens.
9. Add the contract ID for the token that you will be minting, and add the quantity of new tokens to mint.
10. Set the desired transaction fee & memo.
11. Confirm your transaction parameters, and submit it to the network.
12. View your transaction's result XDR and optionally start the mint flow over.
## Build the Project
```
yarn && yarn build
```
## Starting a Dev Environment
```
yarn && yarn start
```
## Contributions
Contributions to the Mint Token DApp are welcome. If you encounter any issues, have
suggestions for improvements, or would like to contribute to the codebase,
please submit an issue, pull request, or reach out to us on
[Discord](https://discord.com/channels/897514728459468821/1037073682599780494).