diff --git a/docs.json b/docs.json index 5a082c7a..5ea19c0e 100644 --- a/docs.json +++ b/docs.json @@ -45,6 +45,7 @@ "guidebook/from-ethereum", "guidebook/payment", "guidebook/nft", + "guidebook/testnet-tokens", "guidebook/tokens", "guidebook/airdrop", "guidebook/debug", diff --git a/guidebook/testnet-tokens.mdx b/guidebook/testnet-tokens.mdx new file mode 100644 index 00000000..1ee98a2d --- /dev/null +++ b/guidebook/testnet-tokens.mdx @@ -0,0 +1,122 @@ +--- +title: "How to get TON testnet tokens" +sidebarTitle: "Get testnet tokens" +--- + +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 + +The Testgiver TON Bot is a Telegram bot that gives you 2 free test Toncoin per hour. It’s the easiest way to fund your test wallet for development. + +To request testnet tokens: + +1. Download [Telegram](https://telegram.org/) on your device and create an account. + +1. In your browser, open [@testgiver\_ton\_bot](https://t.me/testgiver_ton_bot) and 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. From here, 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, enter your testnet wallet 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. + +Request confirmed + +**That's it!** The bot will process the request and send you 2 test Toncoin. + + + +## 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. + +## Verify your balance + +After requesting tokens, refresh your wallet to see the updated balance or verify the transaction using the Tonviewer Testnet explorer. Here's how: + +1. Open [Tonviewer Testnet](https://testnet.tonviewer.com/), paste your wallet address in the search bar and Click **Find**. + +Tonviewer search + +2. You'll see your wallet details including your current balance and transaction history showing the testnet TON you received from the bot. Your wallet state will also 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. + +You can use this to [deploy your wallet](/wallet-apps/overview) by sending your first transaction, which will move your [account state](/ton/statuses#status-variety) from **uninit** to **active**. diff --git a/resources/images/fund-wallet/account-uninit-dark.png b/resources/images/fund-wallet/account-uninit-dark.png new file mode 100644 index 00000000..5b7f9625 Binary files /dev/null and b/resources/images/fund-wallet/account-uninit-dark.png differ diff --git a/resources/images/fund-wallet/account-uninit-light.png b/resources/images/fund-wallet/account-uninit-light.png new file mode 100644 index 00000000..f99cc852 Binary files /dev/null and b/resources/images/fund-wallet/account-uninit-light.png differ diff --git a/resources/images/fund-wallet/bot-welcome-dark.png b/resources/images/fund-wallet/bot-welcome-dark.png new file mode 100644 index 00000000..d0be16b1 Binary files /dev/null and b/resources/images/fund-wallet/bot-welcome-dark.png differ diff --git a/resources/images/fund-wallet/bot-welcome-light.png b/resources/images/fund-wallet/bot-welcome-light.png new file mode 100644 index 00000000..aa6810d6 Binary files /dev/null and b/resources/images/fund-wallet/bot-welcome-light.png differ diff --git a/resources/images/fund-wallet/captcha-dark.png b/resources/images/fund-wallet/captcha-dark.png new file mode 100644 index 00000000..705e6dea Binary files /dev/null and b/resources/images/fund-wallet/captcha-dark.png differ diff --git a/resources/images/fund-wallet/captcha-light.png b/resources/images/fund-wallet/captcha-light.png new file mode 100644 index 00000000..f138f352 Binary files /dev/null and b/resources/images/fund-wallet/captcha-light.png differ diff --git a/resources/images/fund-wallet/enter-address-dark.png b/resources/images/fund-wallet/enter-address-dark.png new file mode 100644 index 00000000..24fd9ea7 Binary files /dev/null and b/resources/images/fund-wallet/enter-address-dark.png differ diff --git a/resources/images/fund-wallet/enter-address-light.png b/resources/images/fund-wallet/enter-address-light.png new file mode 100644 index 00000000..cb0d4e71 Binary files /dev/null and b/resources/images/fund-wallet/enter-address-light.png differ diff --git a/resources/images/fund-wallet/menu-dark.png b/resources/images/fund-wallet/menu-dark.png new file mode 100644 index 00000000..17da6fae Binary files /dev/null and b/resources/images/fund-wallet/menu-dark.png differ diff --git a/resources/images/fund-wallet/menu-light.png b/resources/images/fund-wallet/menu-light.png new file mode 100644 index 00000000..3c4ecbe9 Binary files /dev/null and b/resources/images/fund-wallet/menu-light.png differ diff --git a/resources/images/fund-wallet/open-telegram-dark.png b/resources/images/fund-wallet/open-telegram-dark.png new file mode 100644 index 00000000..477b4d2f Binary files /dev/null and b/resources/images/fund-wallet/open-telegram-dark.png differ diff --git a/resources/images/fund-wallet/open-telegram-light.png b/resources/images/fund-wallet/open-telegram-light.png new file mode 100644 index 00000000..3da334ad Binary files /dev/null and b/resources/images/fund-wallet/open-telegram-light.png differ diff --git a/resources/images/fund-wallet/request-confirmed-dark.png b/resources/images/fund-wallet/request-confirmed-dark.png new file mode 100644 index 00000000..40d07973 Binary files /dev/null and b/resources/images/fund-wallet/request-confirmed-dark.png differ diff --git a/resources/images/fund-wallet/request-confirmed-light.png b/resources/images/fund-wallet/request-confirmed-light.png new file mode 100644 index 00000000..31c9884c Binary files /dev/null and b/resources/images/fund-wallet/request-confirmed-light.png differ diff --git a/resources/images/fund-wallet/start-bot-dark.png b/resources/images/fund-wallet/start-bot-dark.png new file mode 100644 index 00000000..247d96c7 Binary files /dev/null and b/resources/images/fund-wallet/start-bot-dark.png differ diff --git a/resources/images/fund-wallet/start-bot-light.png b/resources/images/fund-wallet/start-bot-light.png new file mode 100644 index 00000000..2c89cd15 Binary files /dev/null and b/resources/images/fund-wallet/start-bot-light.png differ diff --git a/resources/images/fund-wallet/testgiver.png b/resources/images/fund-wallet/testgiver.png new file mode 100644 index 00000000..f6d2cd29 Binary files /dev/null and b/resources/images/fund-wallet/testgiver.png differ diff --git a/resources/images/fund-wallet/tonkeeper-wallet-dark.jpeg b/resources/images/fund-wallet/tonkeeper-wallet-dark.jpeg new file mode 100644 index 00000000..a56a5f14 Binary files /dev/null and b/resources/images/fund-wallet/tonkeeper-wallet-dark.jpeg differ diff --git a/resources/images/fund-wallet/tonkeeper-wallet-light.jpeg b/resources/images/fund-wallet/tonkeeper-wallet-light.jpeg new file mode 100644 index 00000000..23ae0f31 Binary files /dev/null and b/resources/images/fund-wallet/tonkeeper-wallet-light.jpeg differ diff --git a/resources/images/fund-wallet/tonviewer-dark.png b/resources/images/fund-wallet/tonviewer-dark.png new file mode 100644 index 00000000..bdc2b60d Binary files /dev/null and b/resources/images/fund-wallet/tonviewer-dark.png differ diff --git a/resources/images/fund-wallet/tonviewer-light.png b/resources/images/fund-wallet/tonviewer-light.png new file mode 100644 index 00000000..b5417d4e Binary files /dev/null and b/resources/images/fund-wallet/tonviewer-light.png differ