Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/romanovichim/TONQuest3
https://github.com/romanovichim/TONQuest3
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/romanovichim/TONQuest3
- Owner: romanovichim
- Created: 2023-07-20T19:28:50.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-07T10:44:24.000Z (7 months ago)
- Last Synced: 2024-07-31T20:37:23.752Z (5 months ago)
- Language: TypeScript
- Size: 28.6 MB
- Stars: 4
- Watchers: 2
- Forks: 8
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-ton - 🚩 Challenge 3: Jetton Vending Machine
README
# TON Speedrun
## 🚩 Challenge 3: Jetton Vending Machine
🤖 Smart contracts are kind of like "always on" vending machines that anyone can access. Let's make a decentralized, digital currency (an Jetton Standart token).
🌟 The final deliverable will be ICO contract deployed to the testnet
💬 Meet other builders working in TON and get help in the [official dev chat](https://t.me/tondev_eng) or [TON learn tg](https://t.me/ton_learn)
# Checkpoint 0: 🌼 Install 🌼
Required:
* [Git](https://git-scm.com/downloads)
* [Node](https://nodejs.org/en/download/) (Use Version 18 LTS)
* [Yarn](https://classic.yarnpkg.com/en/docs/install/#mac-stable)
(⚠️ Don't install the linux package `yarn` make sure you install yarn with `npm i -g yarn` or even `sudo npm i -g yarn`!)
```sh
git clone https://github.com/romanovichim/TONQuest3.git
```
```sh
cd challenge-3
yarn install
```
---
# Checkpoint 1: 💎 Jetton Standard 💎
A token is a unit of account for some digital asset in some network.
Fungible tokens are assets that are not unique and can be easily exchanged for another asset of the same type. Such tokens are made in such a way that each token is equivalent to the next token.
To enable tokens to be used in other applications (from wallets to decentralized exchanges), smart contract interface standards for tokens are being introduced.
The standard for a fungible token in the TON is the [Jetton](https://github.com/ton-blockchain/TEPs/blob/master/text/0074-jettons-standard.md).
Unlike ethereum, there is no single smart contract that stores token balances for network wallets. In the standard Token:
- master contract stores general information about the token
- for each owner of the token, a separate smart contract is created - a wallet contract, which allows you to transfer the token and store the balance
---
# Checkpoint 2: 📑 Get Jetton Master Contract Data 📂
As in the NFT standard from the first quest, Jetton contracts have mandatory GET methods. For the master contract, one of those methods is `get_jetton_data()` which returns data about the Jetton, let's try:
```sh
yarn bolt
```
You will get something like this:
That means:
`total_supply` - the total number of issues jettons
`mintable` - (-1/0) - flag which indicates whether number of jettons can increase
`admin_address`- address of smart-contract which control Jetton
`jetton_content` - cell - data in accordance to [Token Data Standard #64](https://github.com/ton-blockchain/TEPs/blob/master/text/0064-token-data-standard.md)
Well, now let's release our Jetton!
---
# Checkpoint 3: 🏭 ICO variation 🏭
ICO - Initial Coin Offering - issuance by a project or company of its own money - tokens (cryptocurrency) in order to attract investment.
The simplest smart contract for Initial Coin Offering is a slightly modified Jetton standard master contract, which, when sending cryptocurrencies to it, gives tokens in exchange.
---
# Checkpoint 4: 🔌 Compile🔌
As in the previous quest, in order to use a smart contract, it must be compiled into a hexBoC format. First, we will compile the master contract, and then the wallet, the wallet will be needed to deploy the master contract:
```sh
yarn compilemaster
```
```sh
yarn compilewallet
```
---
# Checkpoint 6: 📻 Deploy 📡
Go to the deploy.ts file, in the line 62, change the const `ownerAddress` to your own, it will be stored in register c4, and only from this address it will be possible to execute commands assigned to administer the token.
line 63 is for token metadata, you can put some link here, as this is an example, you can just write the phrase that you want to store in the master contract instead of metadata
We launch the deployment script and scan the QR code, then you already know))
```sh
yarn deploy
```
Be sure to save the link below the quar code, it contains the address of the master contract of your Jetton.
---
# Checkpoint 7: 💾 Get your Master Contract Data 💾
We go into the file and change the address at the top of the file on the line to the address of your master contract.
Launch!
```sh
yarn getjetton
```
If everything worked out, it's time to participate in ICO
---
# Checkpoint 8: 📀 Participate in ICO 📀
To participate in the ISO, you just need to send a message to the smart contract, let's do this:
```sh
yarn send
```
What to do with the QR code you already know :)
The question arises how to get the balance of our Jetton wallet.
---
# Checkpoint 9: 🎰 Getting to the wallet 🎰
Using the master contract, we will receive a wallet token of our address. Get method `get_wallet_address()`:
```sh
yarn myjettonwallet
```
Copy the address, we will use it in the `jettonwalletinfo.ts` script:
In the 12th line you need to insert the address of your wallet token, and of course run the script:
```sh
yarn jettonbalance
```
Enjoy the balance)
---
# ⚔️ Side Quests
Quick results are great, but to play longer, enjoy the ecosystem, I suggest you the following tutorials:
- Analyzing the [Jetton standard](https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/smartcontract/9lesson/ninthlesson.md)
- [Deploy ICO](https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/golang/16lesson/ICO.md) to testnet using Golang scripts
# 🏆 Reward
Congratulations on successfully completing this challenge! Before we conclude, let's take a quick look at the exciting reward awaiting you from the "TON Speedrun" collection:
Ready to claim your reward? Just scan the QR code, which can be generated using the script below:
```sh
yarn reward
```