diff --git a/docs.json b/docs.json index 2d7cba0d..89689fd2 100644 --- a/docs.json +++ b/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" ] }, diff --git a/ecosystem/wallet-apps/testnet-tokens.mdx b/ecosystem/wallet-apps/testnet-tokens.mdx new file mode 100644 index 00000000..96e756ff --- /dev/null +++ b/ecosystem/wallet-apps/testnet-tokens.mdx @@ -0,0 +1,113 @@ +--- +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 that can be used for development and testing before going live. + +There are two ways to get testnet tokens: + +## Option 1: Get free tokens from the Testgiver TON Bot (2 TON/hour) + +The Testgiver TON Bot is a Telegram bot that gives you 2 free test Toncoins per hour. This is the fastest way to get tokens for testing with no application required. + +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**. + +Open Telegram prompt + +2. Once the bot opens, you'll see the bot info. Click **START** to begin. + +Start bot screen + +3. The bot will welcome you and you have two ways to request TON: + +- You can directly click the **Get 2 TON in testnet** button. + +Bot welcome screen + +- Altenatively, click **Menu** and then select the `/get` command. + +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. + +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. + + + +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. + +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. + +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. + +Wallet balance showing uninit state + +**All done!** You now have testnet TON in your wallet and can start building and testing without any cost. + +## Option 2: Request larger amounts (up to 5,000 TON) + +This option is ideal for projects with extensive testing needs that require more capacity than the standard 2 TON per hour. + +You can request up to 5,000 testnet TON by filling out the [token request form](https://builders.ton.org/profile/projects/new?applicationSlug=testnet-form). + +The form will be reviewed by the TON Foundation and the tokens will be sent directly to your testnet wallet address. \ No newline at end of file diff --git a/resources/images/wallets/fund-wallet/account-uninit-dark.png b/resources/images/wallets/fund-wallet/account-uninit-dark.png new file mode 100644 index 00000000..5b7f9625 Binary files /dev/null and b/resources/images/wallets/fund-wallet/account-uninit-dark.png differ diff --git a/resources/images/wallets/fund-wallet/account-uninit-light.png b/resources/images/wallets/fund-wallet/account-uninit-light.png new file mode 100644 index 00000000..f99cc852 Binary files /dev/null and b/resources/images/wallets/fund-wallet/account-uninit-light.png differ diff --git a/resources/images/wallets/fund-wallet/bot-welcome-dark.png b/resources/images/wallets/fund-wallet/bot-welcome-dark.png new file mode 100644 index 00000000..d0be16b1 Binary files /dev/null and b/resources/images/wallets/fund-wallet/bot-welcome-dark.png differ diff --git a/resources/images/wallets/fund-wallet/bot-welcome-light.png b/resources/images/wallets/fund-wallet/bot-welcome-light.png new file mode 100644 index 00000000..aa6810d6 Binary files /dev/null and b/resources/images/wallets/fund-wallet/bot-welcome-light.png differ diff --git a/resources/images/wallets/fund-wallet/captcha-dark.png b/resources/images/wallets/fund-wallet/captcha-dark.png new file mode 100644 index 00000000..705e6dea Binary files /dev/null and b/resources/images/wallets/fund-wallet/captcha-dark.png differ diff --git a/resources/images/wallets/fund-wallet/captcha-light.png b/resources/images/wallets/fund-wallet/captcha-light.png new file mode 100644 index 00000000..f138f352 Binary files /dev/null and b/resources/images/wallets/fund-wallet/captcha-light.png differ diff --git a/resources/images/wallets/fund-wallet/enter-address-dark.png b/resources/images/wallets/fund-wallet/enter-address-dark.png new file mode 100644 index 00000000..24fd9ea7 Binary files /dev/null and b/resources/images/wallets/fund-wallet/enter-address-dark.png differ diff --git a/resources/images/wallets/fund-wallet/enter-address-light.png b/resources/images/wallets/fund-wallet/enter-address-light.png new file mode 100644 index 00000000..cb0d4e71 Binary files /dev/null and b/resources/images/wallets/fund-wallet/enter-address-light.png differ diff --git a/resources/images/wallets/fund-wallet/menu-dark.png b/resources/images/wallets/fund-wallet/menu-dark.png new file mode 100644 index 00000000..17da6fae Binary files /dev/null and b/resources/images/wallets/fund-wallet/menu-dark.png differ diff --git a/resources/images/wallets/fund-wallet/menu-light.png b/resources/images/wallets/fund-wallet/menu-light.png new file mode 100644 index 00000000..3c4ecbe9 Binary files /dev/null and b/resources/images/wallets/fund-wallet/menu-light.png differ diff --git a/resources/images/wallets/fund-wallet/open-telegram-dark.png b/resources/images/wallets/fund-wallet/open-telegram-dark.png new file mode 100644 index 00000000..477b4d2f Binary files /dev/null and b/resources/images/wallets/fund-wallet/open-telegram-dark.png differ diff --git a/resources/images/wallets/fund-wallet/open-telegram-light.png b/resources/images/wallets/fund-wallet/open-telegram-light.png new file mode 100644 index 00000000..3da334ad Binary files /dev/null and b/resources/images/wallets/fund-wallet/open-telegram-light.png differ diff --git a/resources/images/wallets/fund-wallet/request-confirmed-dark.png b/resources/images/wallets/fund-wallet/request-confirmed-dark.png new file mode 100644 index 00000000..40d07973 Binary files /dev/null and b/resources/images/wallets/fund-wallet/request-confirmed-dark.png differ diff --git a/resources/images/wallets/fund-wallet/request-confirmed-light.png b/resources/images/wallets/fund-wallet/request-confirmed-light.png new file mode 100644 index 00000000..31c9884c Binary files /dev/null and b/resources/images/wallets/fund-wallet/request-confirmed-light.png differ diff --git a/resources/images/wallets/fund-wallet/start-bot-dark.png b/resources/images/wallets/fund-wallet/start-bot-dark.png new file mode 100644 index 00000000..247d96c7 Binary files /dev/null and b/resources/images/wallets/fund-wallet/start-bot-dark.png differ diff --git a/resources/images/wallets/fund-wallet/start-bot-light.png b/resources/images/wallets/fund-wallet/start-bot-light.png new file mode 100644 index 00000000..2c89cd15 Binary files /dev/null and b/resources/images/wallets/fund-wallet/start-bot-light.png differ diff --git a/resources/images/wallets/fund-wallet/testgiver.png b/resources/images/wallets/fund-wallet/testgiver.png new file mode 100644 index 00000000..f6d2cd29 Binary files /dev/null and b/resources/images/wallets/fund-wallet/testgiver.png differ diff --git a/resources/images/wallets/fund-wallet/tonviewer-dark.png b/resources/images/wallets/fund-wallet/tonviewer-dark.png new file mode 100644 index 00000000..bdc2b60d Binary files /dev/null and b/resources/images/wallets/fund-wallet/tonviewer-dark.png differ diff --git a/resources/images/wallets/fund-wallet/tonviewer-light.png b/resources/images/wallets/fund-wallet/tonviewer-light.png new file mode 100644 index 00000000..b5417d4e Binary files /dev/null and b/resources/images/wallets/fund-wallet/tonviewer-light.png differ