add docs on How to get TON testnet tokens

docs.json

@@ -83,6 +83,7 @@
               "ecosystem/wallet-apps/tonkeeper",
               "ecosystem/wallet-apps/web",
               "ecosystem/wallet-apps/dev",
+              "ecosystem/wallet-apps/testnet-tokens",
               "ecosystem/wallet-apps/addresses-workflow"
             ]
           },

ecosystem/wallet-apps/testnet-tokens.mdx

@@ -0,0 +1,101 @@
+---
+title: "How to get TON testnet tokens"
+sidebarTitle: "Fund testnet wallet"
+---
+
+import { Image } from '/snippets/image.jsx';
+import { Aside } from '/snippets/aside.jsx';
+
+TON testnet tokens are free test coins you can use for development and testing on the TON testnet network. They let you experiment and build without spending actual Toncoin.
+
+## Get Toncoins from the testnet faucet bot
+
+The Testgiver TON Bot is a Telegram bot that dispenses 2 free test Toncoins to users, allowing them to experiment on testnet.
+
+To request testnet tokens:
+
+1. Open [@testgiver\_ton\_bot](https://t.me/testgiver_ton_bot) in your browser. You'll see a prompt asking if you want to open Telegram. Click **Open Telegram**.
+
+<Image
+  src="/resources/images/wallets/fund-wallet/open-telegram-light.png"
+  darkSrc="/resources/images/wallets/fund-wallet/open-telegram-dark.png"
+  alt="Open Telegram prompt"
+/>
+
+2. Once the bot opens, you'll see the bot info. Click **START** to begin.
+
+<Image
+  src="/resources/images/wallets/fund-wallet/start-bot-light.png"
+  darkSrc="/resources/images/wallets/fund-wallet/start-bot-dark.png"
+  alt="Start bot screen"
+/>
+
+3. The bot will welcome you and you have two options to request TON:
+
+- **Option 1**: Click the **Get 2 TON** in testnet button.
+
+<Image
+src="/resources/images/wallets/fund-wallet/bot-welcome-light.png"
+darkSrc="/resources/images/wallets/fund-wallet/bot-welcome-dark.png"
+alt="Bot welcome screen"
+/>
+
+- **Option 2**: Click **Menu** and then select the `/get` command.
+
+<Image
+src="/resources/images/wallets/fund-wallet/menu-light.png"
+darkSrc="/resources/images/wallets/fund-wallet/menu-dark.png"
+alt="Bot menu"
+/>
+
+Either option will take you to the next step.
+
+4. You'll be asked to complete a captcha. Click on the captcha image to open it in full size, then carefully enter the characters you see.
+
+<Image
+  src="/resources/images/wallets/fund-wallet/captcha-light.png"
+  darkSrc="/resources/images/wallets/fund-wallet/captcha-dark.png"
+  alt="Captcha screen"
+/>
+
+5. Once the captcha is complete, you'll be prompted to enter your wallet address. Paste your testnet wallet address when prompted. Make sure you're using your **testnet** wallet address, not your mainnet address.
+
+<Aside type="caution">Double-check that you're pasting your testnet wallet address. Mainnet and testnet addresses are different. See [How to read and write user-friendly TON addresses](/ton/addresses/writing-and-reading-addresses#how-to-read-and-write-ton-addresses)</Aside>
+
+<Image
+  src="/resources/images/wallets/fund-wallet/enter-address-light.png"
+  darkSrc="/resources/images/wallets/fund-wallet/enter-address-dark.png"
+  alt="Enter wallet address"
+/>
+
+6. Once you submit your address, you'll see a confirmation message that your request has been added to the queue. The bot will process your request and send 2 testnet TON to your address shortly.
+
+<Image
+  src="/resources/images/wallets/fund-wallet/request-confirmed-light.png"
+  darkSrc="/resources/images/wallets/fund-wallet/request-confirmed-dark.png"
+  alt="Request confirmed"
+/>
+
+**That's it!** Wait a few seconds and the testnet TON will appear in your wallet.
+
+## Verify your balance
+
+After requesting tokens, refresh your wallet to see the updated balance, or verify the transaction on [Tonviewer Testnet](https://testnet.tonviewer.com/).
+
+1. Open [Tonviewer Testnet](https://testnet.tonviewer.com/) and paste your wallet address in the search bar. Click **Find** to search.
+
+<Image
+  src="/resources/images/wallets/fund-wallet/tonviewer-light.png"
+  darkSrc="/resources/images/wallets/fund-wallet/tonviewer-dark.png"
+  alt="Tonviewer search"
+/>
+
+2. You'll see your wallet details including your balance and transaction history showing the testnet TON you received from the bot. Your wallet state will show **uninit**, which means your wallet has received funds but hasn't been deployed yet.
+
+<Image
+  src="/resources/images/wallets/fund-wallet/account-uninit-light.png"
+  darkSrc="/resources/images/wallets/fund-wallet/account-uninit-dark.png"
+  alt="Wallet balance showing uninit state"
+/>
+
+**All done!** You now have TON in your wallet and can start building and testing on testnet without any cost.