From 2e4e556d63822fcef30cc0f0c863430a932e0f97 Mon Sep 17 00:00:00 2001 From: Novus Nota <68142933+novusnota@users.noreply.github.com> Date: Sun, 20 Apr 2025 15:36:36 +0200 Subject: [PATCH 1/5] fix: resolve warnings about the invalid warning blocks :) --- docs/v3/guidelines/dapps/tma/notcoin.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/v3/guidelines/dapps/tma/notcoin.mdx b/docs/v3/guidelines/dapps/tma/notcoin.mdx index ba8bcd24fe..8ca2533e85 100644 --- a/docs/v3/guidelines/dapps/tma/notcoin.mdx +++ b/docs/v3/guidelines/dapps/tma/notcoin.mdx @@ -40,11 +40,11 @@ The Notcoin jetton is forked from https://github.com/ton-blockchain/stablecoin-c Notcoin represents a standard TON jetton smart contract with additional functionality: - The admin of the jetton can change the jetton-minter code and its full data. -:::Warning +:::warning It is critically important for the issuer to carefully manage the admin's account private key to avoid any potential risks of being hacked. It is highly recommended to use a multi-signature wallet as the admin account, with private keys stored on different air-gapped hosts/hardware wallets. ::: -:::Warning +:::warning The contract does not check the code and data on upgrade messages, so it is possible to brick the contract if you send invalid data or code. Therefore, always check the upgrade in the testnet before applying it on the main network. ::: From 57b659487d838ee815a8142806bf9a2edd4a9f97 Mon Sep 17 00:00:00 2001 From: Novus Nota <68142933+novusnota@users.noreply.github.com> Date: Sun, 20 Apr 2025 15:37:19 +0200 Subject: [PATCH 2/5] feat: enable highlighting of triple-ticked code blocks with "bash", "sh", and "shell" suffixes --- docusaurus.config.js | 1 + 1 file changed, 1 insertion(+) diff --git a/docusaurus.config.js b/docusaurus.config.js index 8bbbf187db..40a37976e2 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -169,6 +169,7 @@ const config = { 'typescript', 'cpp', 'c', + 'bash', // bash, sh, and shell code blocks ], }, docs: { From 10147258c185ffa795efb319ef2abf016cc75eab Mon Sep 17 00:00:00 2001 From: Novus Nota <68142933+novusnota@users.noreply.github.com> Date: Tue, 29 Apr 2025 21:26:41 +0200 Subject: [PATCH 3/5] feat(tact): IDE plugins and Blueprint descriptions --- .../getting-started/ide-plugins.md | 38 ++++++++++++++++++- .../getting-started/javascript.mdx | 5 ++- 2 files changed, 40 insertions(+), 3 deletions(-) diff --git a/docs/v3/documentation/smart-contracts/getting-started/ide-plugins.md b/docs/v3/documentation/smart-contracts/getting-started/ide-plugins.md index 22e0aa182e..5af5fc9dd2 100644 --- a/docs/v3/documentation/smart-contracts/getting-started/ide-plugins.md +++ b/docs/v3/documentation/smart-contracts/getting-started/ide-plugins.md @@ -2,6 +2,10 @@ import Feedback from '@site/src/components/Feedback'; # IDE plugins +Select the IDE or editor in the table of contents on the right and install the relevant plugin for your language of choice. + +Using the [TON Web IDE](https://ide.ton.org/), you can try FunC or Tact online without installing anything locally. + ## IntelliJ IDEs Plugin ![](/img/docs/ton-jetbrains-plugin.png) @@ -16,20 +20,50 @@ There are several ways to install a plugin: - [Marketplace link](https://plugins.jetbrains.com/plugin/23382-ton) - [GitHub repository](https://github.com/ton-blockchain/intellij-ton) -## VS Code plugin +## VS Code Visual Studio Code is a free and popular IDE for developers. +### FunC + - [Marketplace link](https://marketplace.visualstudio.com/items?itemName=tonwhales.func-vscode) - [GitHub repository](https://github.com/ton-foundation/vscode-func) -## FunC Sublime Text plugin +### Tact + +- [Marketplace link](https://marketplace.visualstudio.com/items?itemName=tonstudio.vscode-tact) +- [Open VSX registry link](https://open-vsx.org/extension/tonstudio/vscode-tact) +- [GitHub repository](https://github.com/tact-lang/tact-language-server) + +## Sublime Text + +### FunC - [GitHub repository](https://github.com/savva425/func_plugin_sublimetext3) +### Tact + +- [Package Control link](https://packagecontrol.io/packages/Tact) +- [GitHub repository](https://github.com/tact-lang/tact-sublime) + +## Vim + +All-in-one Vim 8+ plugin for Tact language. + +- [GitHub repository](https://github.com/tact-lang/tact.vim) + ## Neovim To enable syntax highlighting in Neovim, follow the installation instructions in the [nvim-treesitter quickstart guide](https://github.com/nvim-treesitter/nvim-treesitter#quickstart). +To make sure `.tact` extension is properly recognized, install the [tact.vim](https://github.com/tact-lang/tact.vim) plugin. + +## Helix + +To enable support of the Tact language, refer to the following instructions: + +1. For latest syntax highlighting, setup [tree-sitter-tact](https://github.com/tact-lang/tree-sitter-tact#helix) +2. For editor intelligence, setup [tact-language-server](https://github.com/tact-lang/tact-languge-server#other-editors) + diff --git a/docs/v3/documentation/smart-contracts/getting-started/javascript.mdx b/docs/v3/documentation/smart-contracts/getting-started/javascript.mdx index 9e4f3d30bf..edfbbf0fe0 100644 --- a/docs/v3/documentation/smart-contracts/getting-started/javascript.mdx +++ b/docs/v3/documentation/smart-contracts/getting-started/javascript.mdx @@ -33,13 +33,16 @@ Watch Video Tutorials ### Tech stack - Compiling FunC with https://github.com/ton-community/func-js (no cli) +- Compiling Tact with https://github.com/tact-lang/tact - Testing smart contracts with https://github.com/ton-org/sandbox - Deploying smart contracts with TON Connect 2.0 compatible wallets or a `ton://` deeplink ### Requirements - [Node.js](https://nodejs.org/) with a recent version like v18, verify version with `node -v` -- IDE with TypeScript and FunC support like [Visual Studio Code](https://code.visualstudio.com/) with the [FunC plugin](https://marketplace.visualstudio.com/items?itemName=tonwhales.func-vscode) +- IDE with TypeScript and TON support: + - [Visual Studio Code](https://code.visualstudio.com/) with the [FunC plugin](https://marketplace.visualstudio.com/items?itemName=tonwhales.func-vscode) or [Tact plugin](https://marketplace.visualstudio.com/items?itemName=tonstudio.vscode-tact) + - [IntelliJ IDEA](https://www.jetbrains.com/idea/) with the [TON Development plugin](https://plugins.jetbrains.com/plugin/23382-ton) ## References From 1873f5c258854f1fac999fe7ebc64284ba192e8c Mon Sep 17 00:00:00 2001 From: Novus Nota <68142933+novusnota@users.noreply.github.com> Date: Tue, 29 Apr 2025 21:28:54 +0200 Subject: [PATCH 4/5] feat: add links to TON development playlist by `@alefmanvladimir` --- docs/v3/documentation/smart-contracts/overview.mdx | 2 ++ .../current/v3/documentation/smart-contracts/overview.mdx | 1 + 2 files changed, 3 insertions(+) diff --git a/docs/v3/documentation/smart-contracts/overview.mdx b/docs/v3/documentation/smart-contracts/overview.mdx index 8c53b31d95..a31f3caa94 100644 --- a/docs/v3/documentation/smart-contracts/overview.mdx +++ b/docs/v3/documentation/smart-contracts/overview.mdx @@ -49,6 +49,7 @@ Kickstart your journey with our beginner-friendly guides: - [🚩 Challenge 4: Lottery/Raffle](https://github.com/romanovichim/TONQuest4) - [🚩 Challenge 5: Create UI to interact with the contract in 5 minutes](https://github.com/romanovichim/TONQuest5) - [🚩 Challenge 6: Analyzing NFT sales on the Getgems marketplace](https://github.com/romanovichim/TONQuest6) +* [TON development playlist](https://www.youtube.com/playlist?list=PLQ5rEj25H3U2P5qp7nsgVtNGYxEojnnez) [[RU version]](https://www.youtube.com/playlist?list=PLOIvUFGfwP93tZI_WnaLyJsZlskU4ao92) ### TON Course @@ -220,6 +221,7 @@ Enhance your skillset with these community-driven educational resources. * [Smart Contracts Guidelines](/v3/guidelines/smart-contracts/guidelines) * [TON FunC Learning Path](https://blog.ton.org/func-journey) ([RU version](https://github.com/romanovichim/TonFunClessons_ru)) * [YouTube Tutorials](https://www.youtube.com/@TONDevStudy) [[RU version]](https://www.youtube.com/@WikiMar) +* [TON development playlist](https://www.youtube.com/playlist?list=PLQ5rEj25H3U2P5qp7nsgVtNGYxEojnnez) [[RU version]](https://www.youtube.com/playlist?list=PLOIvUFGfwP93tZI_WnaLyJsZlskU4ao92) ## Additional Resources diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/v3/documentation/smart-contracts/overview.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/v3/documentation/smart-contracts/overview.mdx index 15755fc7c2..345c277f70 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/v3/documentation/smart-contracts/overview.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/v3/documentation/smart-contracts/overview.mdx @@ -44,6 +44,7 @@ npm create ton@latest - [🚩 Задача 4: Лотерея/Розыгрыш](https://github.com/romanovichim/TONQuest4) - [🚩 Задача 5: Создайте пользовательский интерфейс для взаимодействия с контрактом за 5 минут](https://github.com/romanovichim/TONQuest5) - [🚩 Задача 6: Анализ продаж NFT на маркетплейсе Getgems](https://github.com/romanovichim/TONQuest6) +- [Плейлист по TON разработке](https://www.youtube.com/playlist?list=PLOIvUFGfwP93tZI_WnaLyJsZlskU4ao92) ### Курс TON From af2da75d4448fe825fc7bc4db1e96a0e31e0cc17 Mon Sep 17 00:00:00 2001 From: Novus Nota <68142933+novusnota@users.noreply.github.com> Date: Tue, 29 Apr 2025 21:40:07 +0200 Subject: [PATCH 5/5] fix: minor lint complaint --- docusaurus.config.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index 40a37976e2..0d45f0d52d 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -46,7 +46,7 @@ const config = { baseUrl: '/', themes: [ '@docusaurus/theme-live-codeblock', - ], + ], plugins: [ ['docusaurus-plugin-sass', {}], [