Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/romanovichim/TONQuest6
https://github.com/romanovichim/TONQuest6
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/romanovichim/TONQuest6
- Owner: romanovichim
- Created: 2023-07-26T10:12:24.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-08T17:56:05.000Z (about 1 year ago)
- Last Synced: 2024-07-30T20:32:46.226Z (5 months ago)
- Language: TypeScript
- Size: 9.05 MB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-ton - 🚩 Challenge 6: Analyzing NFT Sales on Getgems Marketplace
README
# TON Speedrun
## 🚩 Challenge 6: Analyzing NFT sales on the Getgems marketplace
🎫 Analyzing NFT sales on the Getgems marketplace. We will get information about sales through get-methods of smart contracts
🌟 Script that will return the latest sales from the marketplace and distinguish between types of sales.
💬 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/TONQuest6.git
```
```sh
cd challenge-6
yarn install
```
---
# Checkpoint 1: 🔬 Analyze Logic 😮
Understanding how smart contracts work, you can get almost any information from the network. In TON, the actor model, respectively, in order to understand where to get information, you need to understand the chain of smart contracts.
Let's try to go this way for the Getgems marketplace, take some NFT and, moving from it, try to find the information we need.
> In this quest, you have to search a lot for addresses in the TON network, if you have problems with this, at the end of each script there will be a hint - the correct address with which the script will work - but this is an extreme case.
---
# Checkpoint 2: 📡 Search for Marketplace Contract 📡
So we have a clean slate in front of us and we need to start from something. The simplest thing seems to be to take the address of the NFT from the marketplace and try to look at it in detail.
Go to https://getgems.io/ and search any NFT collection, make sure that NFT has sales (history at the very bottom of the page)
Example:
Find Getgems Marketplace in the sales contract
As you can understand, royalties from each sale come here, which means that we can track all sales of the Getgems marketplace, getting the addresses of smart contracts for the sale from the transactions of the Getgems marketplace contract, and then take information about the sale.
Run the script and check in the exporter https://tonscan.org/ that the transactions are correct.
```sh
yarn getmarketplace
```
Result:
---
# Checkpoint 3: 👩🚀 Search for Types of sales 👩🚀
Now we have all the sales, but they are different, I’ll tell you right away that Getgems have:
- Simple Sale
- Offer
- Auction
By making requests to the Getmethods of these smart contracts, you can get information about what NFT is being sold for and at what price. Get methods they have the following:
- Simple Sale - get_sale_data()
- Offer - get_offer_data()
- Auction - get_sale_data()
Find all three types of addresses in the marketplace transactions in the scripts below and run them:
Simple Sale:
```sh
yarn getsale
```
Offer:
```sh
yarn getoffer
```
Auction:
```sh
yarn getauction
```
---
# Checkpoint 4:🎩 Query last sales 🎩
Let's collect everything we learned in past checkpoints and display information about the last NFTs sold
```sh
yarn getnftsold
```
Result:
Cool, but not enough, an additional script that would display at the NFT address what kind of collection and NFT would be in place.
---
# ⚔️ Side Quests
Quick results are great, but to play longer, enjoy the ecosystem, I suggest you the following tutorials:
- [Introductory](https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/requests/ADNL/adnlintro.md) about ADNL and connecting to it
- Run [Get Method](https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/requests/ADNL/adnlgetsale.md) and how sales contracts work
- [Collect](https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/requests/ADNL/adnltxes.md) transactions on ADNL
# 🏆 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
```