TON Speedrun

[romanovichim]

Summary

Website with quests - tutorials on TON. Clone the github, go through 5-6 steps and immediately try some practical thing on TON. And only then proceed to complex tech tutorials.

This will be the MVP version: https://speedrunethereum.com/

Context

The problem of a typical tutorial on TON is that only prepositions are clear to a beginner(cell from c4 using adnl to slice e.t.c), and that there are a lot of steps (and on the 28th step...) in the tutorials, each of which has a lot of theory.

So if we imagine the process of a developer rolling into the ecosystem as a funnel, it will turn out that many fly off at the moment of the first touch with the technical side of TON(Although it is worth noting here that the people working on onboarding developers in TON are doing an excellent job and over the past year everything has become much better.).

And I want it to be different, as it is done in games, the first quests are simple and exciting to feel the game, and then thousands of hours in this game are just around the corner.

I want to make a series of 6 quests working on this principle. A person clones a repository, takes 6-7 steps and is already feeling some working, practically applicable product, and then there are links to already deep and complex tutorials.

All tutorials will be on one one-page site with a thin connection, and the last 3 quests will be available only after the first three quests are completed (the website will check whether the person has deployed the first three quests from his wallet).

But of course, in addition to quests, we need articles where to send the user if, after the quest, he wants to delve into the TON. Some of the necessary tutorials and articles are already there, some I want to write as part of this footstep.

The site itself will be just a deployment page on github pages with a simple design, if the concept works, then in the future it will be possible to complicate the design, as it looks like in the original idea: https://speedrunethereum.com/

The footstep doesn't mention marketing, as while I'm doing the footstep, I'm planning to get into custdev and thus find the best marketing practices for a similar project, as well as a backlog for future improvements.

Quests and articles that I want to prepare as part of this footstep. Some already exist (I will describe them here to understand the concept):

• 1. Deploy NFT Quest
  • ton-community/sandbox project with NFT code and deployment script via qr code (the user will deploy in the test network through the wallet), and then see his NFT in the test network.
    • Articles:
      • write a simple contract from scratch in ton-community/sandbox (work with c4,throw e.t.c)
      • write tests for a simple contract
      • deploy via wallet (simple deploy pipeline)
      • Blueprint SDK FunC lessons Update TON FunC Lessons with Blueprint SDK #235
• 2. Chatbot contract Quest
  • Chatbot contract ton-community/sandbox project with tests. The contract itself returns different words depending on the number of entered TON.
    • Articles:
      • Let's analyze the contract and sending messages
      • ton-community/sandbox tests for messages
• 3. Vending Machine Jetton Quest
  • ton-community/sandbox project for Jetton deploying and playing with it
    • Articles:
      • Analyze Jetton Standart https://github.com/romanovichim/TonFunClessons_ru/blob/main/9lesson/ninthlesson.md
• 4. Lottery Quest
  • Lottery smart contract contract ton-community/sandbox project with tests.
    • Articles:
      • Analyzing lottery contract
      • About random in TON: https://docs.ton.org/develop/smart-contracts/guidelines/random-number-generation
• 5. TonConnect Quest
  • Making ui for the chatbot contract, using https://github.com/ton-connect/sdk
    • Articles:
      • react_ui login button
      • react_ui send transaction
• 6. Marktetplace Analyzer Quest
  • scrtpt using https://www.npmjs.com/package/ton-lite-client for Getgems nft smart contracts, let's find offer sales and auctions in the last hours
    • Articles:
      • Introductory about ADNL and connecting to it (using https://www.npmjs.com/package/ton-lite-client )
      • Run GetMethod and how sales contracts work (using https://www.npmjs.com/package/ton-lite-client )
      • Collection of transactions on ADNL (using https://www.npmjs.com/package/ton-lite-client )

P.S Articles will be published to dev.to and https://t.me/ton_learn

Goals

Create tutorials on TON that first draw a person into the ecosystem, and only then load him with complex technical details

Deliverables

• 1. Deploy NFT Quest - ton-community/sandbox project with NFT code and deployment script via qr code (the user will deploy in the test network through the wallet), and then see his NFT in the test network.
  • Articles:
    • write a simple contract from scratch in ton-community/sandbox (work with c4,throw e.t.c)
    • write tests for a simple contract
    • deploy via wallet (simple deploy pipeline)
• 2. Chatbot contract Quest - Chatbot contract ton-community/sandbox project with tests. The contract itself returns different words depending on the number of entered TON.
  • Articles:
    • Let's analyze the contract and sending messages
    • ton-community/sandbox tests for messages
• 3. Vending Machine Jetton Quest - ton-community/sandbox project for Jetton deploying and playing with it
• 4. Lottery Quest - Lottery smart contract contract ton-community/sandbox project with tests.
  • Articles:
    • Analyzing lottery contract
• 5. TonConnect Quest - Making ui for the chatbot contract, using https://github.com/ton-connect/sdk
  • Articles:
    • react_ui login button
    • react_ui send transaction
• 6. Marktetplace Analyzer Quest - scrtpt using https://www.npmjs.com/package/ton-lite-client for Getgems nft smart contracts, let's find offer sales and auctions in the last hours
  • Articles:
    • Introductory about ADNL and connecting to it (using https://www.npmjs.com/package/ton-lite-client )
    • Run GetMethod and how sales contracts work (using https://www.npmjs.com/package/ton-lite-client )
    • Collection of transactions on ADNL (using https://www.npmjs.com/package/ton-lite-client )

Github pages Website with Tonconnect auth and adnl check so that the last three tasks are available only after the first three

Definition of Done

• 1) Deploy NFT Quest - ton-community/sandbox project with NFT code and deployment script via qr code (the user will deploy in the test network through the wallet), and then see his NFT in the test network.

  • Articles:
    • write a simple contract from scratch in ton-community/sandbox (work with c4,throw e.t.c)
    • write tests for a simple contract
    • deploy via wallet (simple deploy pipeline)

• 2) Chatbot contract Quest - Chatbot contract ton-community/sandbox project with tests. The contract itself returns different words depending on the number of entered TON.

  • Articles:
    • Let's analyze the contract and sending messages
    • ton-community/sandbox tests for messages

• 3) Vending Machine Jetton Quest - ton-community/sandbox project for Jetton deploying and playing with it

• 4) Lottery Quest - Lottery smart contract contract ton-community/sandbox project with tests.

  • Articles:
    • Analyzing lottery contract

• 5) TonConnect Quest - Making ui for the chatbot contract, using https://github.com/ton-connect/sdk

  • Articles:
    • react_ui login button
    • react_ui send transaction

• 6) Marktetplace Analyzer Quest - scrtpt using https://www.npmjs.com/package/ton-lite-client for Getgems nft smart contracts, let's find offer sales and auctions in the last hours

  • Articles:
    • Introductory about ADNL and connecting to it (using https://www.npmjs.com/package/ton-lite-client )
    • Run GetMethod and how sales contracts work (using https://www.npmjs.com/package/ton-lite-client )
    • Collection of transactions on ADNL (using https://www.npmjs.com/package/ton-lite-client )

• Github pages Website with Tonconnect auth and adnl check so that the last three tasks are available only after the first three

Reward

• Standard TON Footstep NFT

• 1. Deploy NFT Quest (creation and testing) 400 USD in TON equivalent
  • Articles:
    • write a simple contract from scratch in ton-community/sandbox (work with c4,throw e.t.c) 150 USD in TON equivalent
    • write tests for a simple contract 200 USD in TON equivalent
    • deploy via wallet (simple deploy pipeline) 200 USD in TON equivalent
• 2. Chatbot contract Quest 400 USD in TON equivalent
  • Articles:
    • Let's analyze the contract and sending messages 100 USD in TON equivalent
    • ton-community/sandbox tests for messages 200 USD in TON equivalent
• 3. Vending Machine Jetton Quest (creation and testing) 250 USD in TON equivalent
• 4. Lottery Quest 400 USD in TON equivalent
  • Articles:
    • Analyzing lottery contract 100 USD in TON equivalent
• 5. TonConnect Quest (creation and testing) 300 USD in TON equivalent
  • Articles:
    • react_ui login button 200 USD in TON equivalent
    • react_ui send transaction 200 USD in TON equivalent
• 6. Marktetplace Analyzer Quest (creation and testing) 400 USD in TON equivalent
  • Articles:
    • Introductory about ADNL and connecting to it (using https://www.npmjs.com/package/ton-lite-client ) 150 USD in TON equivalent
    • Run GetMethod and how sales contracts work (using https://www.npmjs.com/package/ton-lite-client ) 200 USD in TON equivalent
    • Collection of transactions on ADNL (using https://www.npmjs.com/package/ton-lite-client ) 200 USD in TON equivalent

Github pages Website with Tonconnect auth and adnl check so that the last three tasks are available only after the first three (creation and testing). 300 USD in TON equivalent

Total: $4350

Oriental Release Date

I need two months for this footstep

[Gusarich]

Can you please specify total amount of rewards?

[romanovichim]

Can you please specify total amount of rewards?

In total for this footstep I want 4350 USD in TON equivalent

[ProgramCrafter]

Deploy NFT quest can be based on https://docs.ton.org/develop/get-started-with-ton, I think.

[delovoyhomie]

@romanovichim, apologies for the long wait. It took some time to build and evaluate the future of this product. We have concluded that it is crucial to develop both FunC and Tact, especially in terms of integrating deeper articles with superficial learning at the start.

As you said, you will create a prototype for custdev that will then be refined - that's very commendable!

You can start work now! Don't forget to occasionally update us on your progress here.

[romanovichim]

Update: I wrote drafts of all articles and drafts of all quests and their code. In the near future I will proofread everything and start publishing articles.

[romanovichim]

Articles and quests:

1. Deploy NFT Quest - https://github.com/romanovichim/TONQuest1
   Articles:
   write a simple contract from scratch in ton-community/sandbox (work with c4,throw e.t.c)https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/pipeline/simplesmartcontract.md
   write tests for a simple contract https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/pipeline/simpletest.md
   deploy via wallet (simple deploy pipeline) https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/pipeline/simpledeploy.md

2. Chatbot contract Quest - https://github.com/romanovichim/TONQuest2

Articles:
Let's analyze the contract and sending messages https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/pipeline/chatbot.md
ton-community/sandbox tests for messages https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/pipeline/chatbottest.md

3. Vending Machine Jetton Quest - https://github.com/romanovichim/TONQuest3

4. Lottery Quest - https://github.com/romanovichim/TONQuest4

Articles:
Analyzing lottery contract - https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/bonus/random/random.md

5. TonConnect Quest - https://github.com/romanovichim/TONQuest5

Articles:
react_ui login button https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/tonconnect/button.md
react_ui send transaction https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/tonconnect/sendtx.md

6. Marketplace Analyzer Quest - https://github.com/romanovichim/TONQuest6

Articles:
Introductory about ADNL and connecting to it https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/requests/ADNL/adnlintro.md
Run GetMethod and how sales contracts work https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/requests/ADNL/adnlgetsale.md
Collection of transactions on ADNL https://github.com/romanovichim/TonFunClessons_Eng/blob/main/lessons/requests/ADNL/adnltxes.md

[SwiftAdviser]

@romanovichim hey! You did a nice job! Can I ask you to add syntax highlight to every file you provided to make it easier to read the code?

Like "tsx" or "console"?

console:

npm install blueprint

JSX (react):

import { LiteClient, LiteRoundRobinEngine, LiteSingleEngine, LiteEngine } from "ton-lite-client";
import { Address, Cell, loadTransaction,parseTuple, TupleReader, beginCell  } from "ton-core";
import { Buffer } from 'buffer';

function intToIP(int: number) {
	var part1 = int & 255;
	var part2 = ((int >> 8) & 255);
	var part3 = ((int >> 16) & 255);
	var part4 = ((int >> 24) & 255);

	return part4 + "." + part3 + "." + part2 + "." + part1;
}

[romanovichim]

yes, when I finish with the site, I will go through the lessons and add syntax highlight

[romanovichim]

@delovoyhomie DONE

wallet

EQAvmc9oVnOvLFlUAgeNmZNZoKeDg9vTEiAQxNFw-t5mh3m7

MVP:
https://romanovichim.github.io/tonspeedrun/

P.S I am gradually starting to post content from this footsteps and at the same time I will go through all the articles again to clean them up, including what Roman wrote about. I will also try to collect feedback for the next iteration of the product if it hits the audience

[SwiftAdviser]

@delovoyhomie the initial example in the footstep was provided on a custom domain:

This will be the MVP version: https://speedrunethereum.com/

Could we ask to provide the same level of quality for the project?

It has many reasons why it's important:

1. Branding. It's so easy to remember domain like "tonspeedrun.com" instead of long github domain.
2. SEO. By hosting the project on the custom domain, any user who is interested in TON can find TON Speedrun in Google, Bing, etc. It won't work for GitHub domain.
3. Popularity. By making the release on a custom domain, you truly release the project, while MVP version sure can be hosted on the github too.

I would kindly ask @delovoyhomie or @romanovichim to select, buy the domain, and release the project everywhere with a beautiful and easy-to-remember version of TON Speedrun. It's very cheap, but the effect could be great.

[delovoyhomie]

@SwiftAdviser, that's a cool idea, I'll do it!

[delovoyhomie]

https://tonspeedrun.com