diff --git a/docs/develop/dapps/README.md b/docs/develop/dapps/README.mdx similarity index 70% rename from docs/develop/dapps/README.md rename to docs/develop/dapps/README.mdx index b94edc033f..600f72fa5d 100644 --- a/docs/develop/dapps/README.md +++ b/docs/develop/dapps/README.mdx @@ -1,9 +1,14 @@ -# Overview +import Button from '@site/src/components/button' -The best place to start is a TON Hello World guide of how to create your first Web App: +# Overview -- [TON Hello World: Step by step guide for building your first web client](https://ton-community.github.io/tutorials/03-client/) +The best place to start is a Web App guide of how to create your first DApp on TON: + + ## Tools @@ -14,10 +19,40 @@ Here you can see links to the most important resources for you to get started wi - [Testnet](/develop/smart-contracts/environment/testnet.md) — info about the testnet and how to use it. - [Unfreezer](https://unfreezer.ton.org/) - Unfreeze a TON contract that ran out of gas for rent. + +## Telegram Web Apps (TWA) + +- [Telegram Web Apps Documentation](https://core.telegram.org/bots/webapps) — full description on Telegram website. + +### TWA SDKs + +- [ton-defi-org/tonstarter-twa](https://github.com/ton-defi-org/tonstarter-twa) — template for new TWA interaction with TON +- [twa-dev/boilerplate](https://github.com/twa-dev/Boilerplate) — another boilerplate for a new TWA. +- [twa-dev/sdk](https://github.com/twa-dev/sdk) — NPM package for TWA SDK +- [twa-dev/Mark42](https://github.com/twa-dev/Mark42) — Mark42 is a simple lightweight tree-shakable UI library for TWA + +:::info Community +Join a special Telegram [Community Chat](https://t.me/+1mQMqTopB1FkNjIy) for TWA developers if you're interested. +::: + + +## Payments processing + +* Toncoin processing +* Jettons (Tokens) processing +* NFT processing +* Metadata parsing + ## Examples If you are a web or bot developer, you may find the following repositories useful: +### Basics + +* Jettons (Tokens): [Mint your first Jetton](/develop/dapps/tutorials/jetton-minter) +* NFTs: [Step by step NFT collection minting](/develop/dapps/tutorials/collection-minting) + + ### JavaScript * Payment processing using JavaScript: @@ -44,51 +79,23 @@ If you are a web or bot developer, you may find the following repositories usefu - [10+ examples from xssnick/tonutils-go](https://github.com/xssnick/tonutils-go/tree/master/example) - [7+ examples from tonkeeper/tongo](https://github.com/tonkeeper/tongo/tree/master/example) -## TON SDKs +### ZK -Learn the complete list of The Open Network SDKs from the SDKs page: -* [SDK](/develop/dapps/apis/sdk) +* [Simple ZK on TON](/develop/dapps/tutorials/simple-zk-on-ton) - -## Telegram WebApps (TWA) - -- [Telegram WebApps Documentation](https://core.telegram.org/bots/webapps) — full description on Telegram website. - -### TWA SDKs - -- [ton-defi-org/tonstarter-twa](https://github.com/ton-defi-org/tonstarter-twa) — template for new TWA interaction with TON -- [twa-dev/boilerplate](https://github.com/twa-dev/Boilerplate) — another boilerplate for a new TWA. -- [twa-dev/sdk](https://github.com/twa-dev/sdk) — NPM package for TWA SDK -- [twa-dev/Mark42](https://github.com/twa-dev/Mark42) — Mark42 is a simple lightweight tree-shakable UI library for TWA - -:::info Community -Join a special Telegram [Community Chat](https://t.me/+1mQMqTopB1FkNjIy) for TWA developers if you're interested. -::: - -## Authorization SDK - -To add login button to your website or web app use the following: - -### TON Connect - -[ton-connect]( -/develop/dapps/ton-connect) is a unified authorization standard for every wallet in the TON ecosystem. It's supported and developed by Tonkeeper team with tech advisors from TON Community. - -#### Documentation - -* [Introducing TON Connect](/develop/dapps/ton-connect) -* [TON Connect for Developers](/develop/dapps/ton-connect/developers) -* [TON Connect 2.0 vs 1.0](/develop/dapps/ton-connect/comparison) -* [ton-connect/wallets-list](https://github.com/ton-connect/wallets-list) — list of supported wallets (add yours!) - - -### Usage examples +### Wallets examples - [Desktop standard wallet (C++ and Qt)](https://github.com/ton-blockchain/wallet-desktop) - [Android standard wallet (Java)](https://github.com/ton-blockchain/wallet-android) - [iOS standard wallet (Swift)](https://github.com/ton-blockchain/wallet-ios) - [TonLib CLI (C++)](https://github.com/ton-blockchain/ton/blob/master/tonlib/tonlib/tonlib-cli.cpp) -## APIs +### No necessary material? + +You have 2 ways here: write tutorial by you own or describe the problem for the community. -- Go to [API](/develop/dapps/apis) section to read more about APIs in TON + + diff --git a/docs/develop/dapps/apis/README.md b/docs/develop/dapps/apis/README.md index 79fb649a5f..ec92eb41ef 100644 --- a/docs/develop/dapps/apis/README.md +++ b/docs/develop/dapps/apis/README.md @@ -250,7 +250,5 @@ curl -X 'GET' \ ## See Also * [TON Center API](/develop/dapps/apis/toncenter) -* [SDKs](/develop/dapps/apis/sdk) -* [SDKs](/develop/dapps/apis/sdk) -* [Apps Examples](/develop/dapps/examples) +* [List of SDKs](/develop/dapps/apis/sdk) * [Smart Contract Examples](/develop/smart-contracts/examples) \ No newline at end of file diff --git a/docs/develop/dapps/examples.md b/docs/develop/dapps/examples.md deleted file mode 100644 index eb5f7de448..0000000000 --- a/docs/develop/dapps/examples.md +++ /dev/null @@ -1,22 +0,0 @@ -# Examples - -### JavaScript - -- [A standard web wallet](https://github.com/toncenter/ton-wallet) (Plain JS) -- [Bridge frontend](https://github.com/ton-blockchain/bridge) (Vue.js) -- [Bot for sales of dumplings](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js) - -### TypeScript -- [nns2009/ton-payment-tracker](https://github.com/nns2009/ton-payment-tracker) - -### Python - -- [Transfer NFT & Jettons by creating a transfer message from the owner wallet](https://github.com/tonfactory/tonsdk#transfer-nft--jettons-by-creating-a-transfer-message-from-an-owner-wallet) -- [Create mnemonic, init wallet class, create an external message to deploy the wallet](https://github.com/tonfactory/tonsdk#create-mnemonic-init-wallet-class-create-external-message-to-deploy-the-wallet) -- [Storefront bot with payments in TON](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot) -- [Bot with own balance](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-2) - -### Go - -- [10+ examples from xssnick/tonutils-go](https://github.com/xssnick/tonutils-go/tree/master/example) -- [nns2009/ton-payment-tracker](https://github.com/nns2009/ton-payment-tracker) diff --git a/docs/develop/dapps/ton-connect/integration.md b/docs/develop/dapps/ton-connect/integration.md index 4fa869a62b..f3e0ea7775 100644 --- a/docs/develop/dapps/ton-connect/integration.md +++ b/docs/develop/dapps/ton-connect/integration.md @@ -307,7 +307,7 @@ The results above take the following into consideration: ## Logging out and requesting TonProof -Now we have logged into our webapp, but... how does the backend know that it is the correct party? To verify this we must request the wallet ownership proof. +Now we have logged into our Web App, but... how does the backend know that it is the correct party? To verify this we must request the wallet ownership proof. This can be completed only using authentication, so we must log out. Therefore, we run the following code in the console: diff --git a/docs/develop/dapps/tutorials/overview.mdx b/docs/develop/dapps/tutorials/overview.mdx index 077eaccece..66491aff62 100644 --- a/docs/develop/dapps/tutorials/overview.mdx +++ b/docs/develop/dapps/tutorials/overview.mdx @@ -2,33 +2,4 @@ import Button from '@site/src/components/button' # Overview -Find a tutorial well-suited for your stack across all the materials listed below. - -## Basic - -* [Step by step NFT collection minting](/develop/dapps/tutorials/collection-minting) -* [Mint your first Jetton](/develop/dapps/tutorials/jetton-minter) - -## Telegram bots - -### JavaScript - -* [Bot for sales of dumplings](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js) - -### Python - -* [Storefront bot with payments in TON](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot) -* [Bot with own balance](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-2) - -## ZK - -* [Simple ZK on TON](/develop/dapps/tutorials/simple-zk-on-ton) -## No necessary material? - -You have 2 ways here: write tutorial by you own or describe the problem for the community. - - - +TODO: remove \ No newline at end of file diff --git a/docusaurus.config.js b/docusaurus.config.js index 5770ccc056..a69a55d33f 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -208,7 +208,7 @@ const config = { items: [ { type: 'dropdown', - to: '/develop/dapps/tutorials/overview', + to: '/learn/introduction', position: 'left', label: 'Concepts', items: [ @@ -241,7 +241,7 @@ const config = { }, { type: 'dropdown', - to: '/develop/dapps/tutorials/overview', + to: '/develop/overview', position: 'left', label: 'Get Started', items: [ @@ -251,15 +251,15 @@ const config = { }, { to: 'https://ton-community.github.io/tutorials/03-client/', - label: 'Build your first WebApp', + label: 'Build your first Web App', }, { to: 'develop/dapps/ton-connect/overview', label: 'Integrate with Wallets', }, { - to: 'develop/dapps/tutorials/overview', - label: 'Guides Hub', + to: 'develop/dapps/', + label: 'Guides & Examples', }, ], diff --git a/sidebars.js b/sidebars.js index f379062233..11e0fbe13b 100644 --- a/sidebars.js +++ b/sidebars.js @@ -157,7 +157,7 @@ const sidebars = { }, { type: 'category', - label: 'Develop Smart Contracts', + label: 'Smart Contracts', items: [ 'develop/smart-contracts/README', { @@ -286,7 +286,7 @@ const sidebars = { { type: 'category', - label: 'Develop Apps', + label: 'DApp Development', items: [ 'develop/dapps/README', { @@ -329,7 +329,6 @@ const sidebars = { 'develop/dapps/defi/subscriptions', ], }, - 'develop/dapps/examples', ] }, { @@ -375,8 +374,13 @@ const sidebars = { }, { type: 'category', - label: 'Wallets', + label: 'Protocol specifications', items: [ + { + type: 'link', + label: 'TON Connect Protocol', + href: 'https://github.com/ton-blockchain/ton-connect', + }, { type: 'link', label: 'TON Connect Wallets',