From 81085429690d591fcf2895e9e61ede5b8e6d0e49 Mon Sep 17 00:00:00 2001 From: SwiftAdviser Date: Wed, 13 Sep 2023 13:53:46 +0200 Subject: [PATCH] updated section DApps & main page for DApps --- docs/develop/dapps/README.mdx | 99 ++++++++++----------- docs/develop/dapps/telegram-apps/README.mdx | 3 + sidebars.js | 63 +++++++------ 3 files changed, 85 insertions(+), 80 deletions(-) diff --git a/docs/develop/dapps/README.mdx b/docs/develop/dapps/README.mdx index ae4cd9e80e..78cfd18fc0 100644 --- a/docs/develop/dapps/README.mdx +++ b/docs/develop/dapps/README.mdx @@ -1,8 +1,7 @@ import Button from '@site/src/components/button' -# Overview - -To start with DApps on TON, you need to understand the basics of the blockchain and the TON architecture. You can find this information in the [Concepts](/learn/introduction) section. +# Getting Started +Before diving into DApps, make sure you understand the underlying blockchain principles. You might find our [The Open Network](/learn/introduction) and [Blockchain of Blockchains](/learn/overviews/ton-blockchain) articles useful. Comparing to the pure [Smart Contracts](/develop/smart-contracts/) development, DApps development is more complex. You need to understand [how to work with APIs](/develop/dapps/apis/), how to use authenticate user using [TON Connect](/develop/dapps/ton-connect/overview) and how to use [SDKs](/develop/dapps/apis/sdk) to work with the blockchain. @@ -12,81 +11,75 @@ colorType="secondary" sizeType={'sm'}> Choose an SDK -## Basic tools +## Basic Tools and Resources + +Here are some key resources that you'll need throughout your DApp development journey: -Here you can see links to the most important resources for you to get started with TON: +1. [Developer Wallets](/participate/wallets/apps) +2. [Blockchain Explorers](/participate/explorers) +3. [API Documentation](/develop/dapps/apis/) +4. [SDKs for Various Languages](/develop/dapps/apis/sdk) +5. [Using the Testnet](/develop/smart-contracts/environment/testnet) +6. [TON Unfreezer](https://unfreezer.ton.org/) -- [Wallet Apps for Developers](/participate/wallets/apps) — to create and manage wallets. -- [List of Explorers](/participate/explorers) — to view the state of the blockchain. -- [API Types](/develop/dapps/apis/) — different ways to interact with the blockchain. -- [List of SDKs](/develop/dapps/apis/sdk) — list of SDKs for different languages and APIs. -- [Testnet and how to use it](/develop/smart-contracts/environment/testnet) — to test your contracts. -- [TON Unfreezer](https://unfreezer.ton.org/) - to unfreeze contracts that ran out of gas for rent. +### Asset Management -## Asset processing +Working with assets? These guides cover the essentials: -* [Payment processing](/develop/dapps/asset-processing/) -* [NFT processing](/develop/dapps/asset-processing/nft) -* [Metadata parsing](/develop/dapps/asset-processing/metadata) +- [Payments Processing](/develop/dapps/asset-processing/) +- [Token (Jetton) Processing](/develop/dapps/asset-processing/jettons) +- [Handling NFTs](/develop/dapps/asset-processing/nft) +- [Parsing Metadata](/develop/dapps/asset-processing/metadata) -## Introduction to DeFi +### Introduction to DeFi -* [Toncoin processing](/develop/dapps/defi/coins) -* [Tokens on TON (Jettons & NFTs)](/develop/dapps/defi/tokens) -* [TON Payments](/develop/dapps/defi/ton-payments) -* [Subscriptions on TON](/develop/dapps/defi/subscriptions) +Interested in decentralized finance (DeFi)? Here's how to handle different types of assets: -## Tutorials and examples +- [Understanding Toncoin](/develop/dapps/defi/coins) +- [Tokens: Jettons & NFTs](/develop/dapps/defi/tokens) +- [TON Payments](/develop/dapps/defi/ton-payments) +- [Setting up Subscriptions](/develop/dapps/defi/subscriptions) -### Basics +## Tutorials and Examples -* Jettons (Tokens): [Mint your first Jetton](/develop/dapps/tutorials/jetton-minter) -* NFTs: [Step by step NFT collection minting](/develop/dapps/tutorials/collection-minting) +### DeFi Basics +- Create Your First Token: [Mint Your First Jetton](/develop/dapps/tutorials/jetton-minter) +- Step by Step: [NFT Collection Minting](/develop/dapps/tutorials/collection-minting) -### JavaScript +### Language-Specific Guides -* Payment processing using JavaScript: - * [Create a key pair and a wallet](https://github.com/toncenter/examples/blob/main/common.js) (tonweb) - * [Accepting deposits to a single wallet](https://github.com/toncenter/examples/blob/main/deposits-single-wallet.js) (tonweb) - * [Accepting deposits to multiple wallets](https://github.com/toncenter/examples/blob/main/deposits.js) (tonweb) - * [Withdrawal process](https://github.com/toncenter/examples/blob/main/withdrawals.js) (tonweb) - * [Payment channel example](https://github.com/toncenter/payment-channels-example/blob/main/index.js) (tonweb) -* [TON Bridge front-end](https://github.com/ton-blockchain/bridge) (Vue.js, no comments) -* [Web Wallet source code](https://github.com/toncenter/ton-wallet) (tonweb, no comments) -* [Bot for sales of dumplings](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js) +#### JavaScript +- [Payment Process](https://github.com/toncenter/examples) +- [TON Bridge](https://github.com/ton-blockchain/bridge) +- [Web Wallet](https://github.com/toncenter/ton-wallet) +- [Dumpling Sales Bot](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js) -### Python +#### Python -- [psylopank/pytonlib examples](https://github.com/psylopunk/pytonlib/tree/main/examples) -- [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) +- [Example Projects](https://github.com/psylopunk/pytonlib/tree/main/examples) +- [Storefront Bot](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot) -### Go +#### Go -- [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) +- [Examples](https://github.com/xssnick/tonutils-go/tree/master/example) -### ZK +### Advanced Topics -* [Simple ZK on TON](/develop/dapps/tutorials/simple-zk-on-ton) +- [Zero-Knowledge Proofs](/develop/dapps/tutorials/simple-zk-on-ton) -### Wallets 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) -### No necessary material? +## 👨‍💻 Contribution -You have 2 ways here: write tutorial by you own or describe the problem for the community. +Missing some crucial material? You can either write a tutorial yourself or describe the problem for the community. + + + - - diff --git a/docs/develop/dapps/telegram-apps/README.mdx b/docs/develop/dapps/telegram-apps/README.mdx index 2f96733ea8..fe3b0d37ab 100644 --- a/docs/develop/dapps/telegram-apps/README.mdx +++ b/docs/develop/dapps/telegram-apps/README.mdx @@ -1,3 +1,6 @@ +--- +description: Telegram Web Apps (or TWAs) are web applications that run inside the Telegram messenger. They are built using web technologies — HTML, CSS, and JavaScript. +--- import Button from '@site/src/components/button' # What is TWA? diff --git a/sidebars.js b/sidebars.js index c8fb48b60a..88e44bb943 100644 --- a/sidebars.js +++ b/sidebars.js @@ -145,16 +145,6 @@ const sidebars = { 'type': 'html', 'value': ' Development ', }, - { - type: 'category', - label: 'APIs and SDKs', - items: [ - 'develop/dapps/apis/README', - 'develop/dapps/apis/toncenter', - 'develop/dapps/apis/adnl', - 'develop/dapps/apis/sdk' - ], - }, { type: 'category', label: 'Smart Contracts', @@ -302,26 +292,15 @@ const sidebars = { }, { type: 'category', - label: 'Learn', + label: 'APIs and SDKs', items: [ - { - type: 'doc', - id: 'develop/dapps/tutorials/collection-minting', - label: 'NFT collection minting', - }, - 'develop/dapps/tutorials/jetton-minter', - { - type: 'category', - label: 'Telegram bots', - items: [ - 'develop/dapps/tutorials/accept-payments-in-a-telegram-bot', - 'develop/dapps/tutorials/accept-payments-in-a-telegram-bot-2', - 'develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js', - ], - }, - 'develop/dapps/tutorials/simple-zk-on-ton', + 'develop/dapps/apis/README', + 'develop/dapps/apis/toncenter', + 'develop/dapps/apis/adnl', + 'develop/dapps/apis/sdk' ], }, + { type: 'category', label: 'Guidelines', @@ -343,6 +322,36 @@ const sidebars = { 'develop/dapps/defi/subscriptions', ], }, + { + type: 'category', + label: 'Tutorials & Examples', + items: [ + { + type: 'doc', + id: 'develop/dapps/tutorials/collection-minting', + label: 'NFT Minting Guide', + }, + { + type: 'doc', + id: 'develop/dapps/tutorials/jetton-minter', + label: 'Mint Your First Token', + }, + { + type: 'doc', + id: 'develop/dapps/tutorials/simple-zk-on-ton', + label: 'Zero-Knowledge Proofs', + }, + { + type: 'category', + label: 'Telegram Bot Examples', + items: [ + 'develop/dapps/tutorials/accept-payments-in-a-telegram-bot', + 'develop/dapps/tutorials/accept-payments-in-a-telegram-bot-2', + 'develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js', + ], + }, + ], + }, ] }, {