diff --git a/ecosystem/wallet-apps/tonkeeper.mdx b/ecosystem/wallet-apps/tonkeeper.mdx index 7e9f85d3..ea8ac21a 100644 --- a/ecosystem/wallet-apps/tonkeeper.mdx +++ b/ecosystem/wallet-apps/tonkeeper.mdx @@ -2,4 +2,217 @@ title: "Tonkeeper" --- -Stub +import { Aside } from "/snippets/aside.jsx"; +import { Image } from '/snippets/image.jsx'; + +[Tonkeeper](https://tonkeeper.com/) is a self‑custodial wallet for the TON blockchain. It supports Toncoin, jettons, NFTs, and TON Connect, and is available as a mobile app, desktop app, browser extension, and web version. + +## Key features + +- TON Connect integration: Enables secure communication between Tonkeeper and decentralized applications using the [TON Connect](/ecosystem/ton-connect) protocol. +- Prepaid balance feature: Automatically covers transaction fees (gas) when your wallet doesn’t have enough Toncoin to process a transaction. +- W5 support: Implements the latest [W5](/standard/wallets/v5) wallet smart contract standard used across the TON blockchain. +- Built-in dApp browser: Provides a native browser for interacting with decentralized applications directly within Tonkeeper. +- Asset management: Supports digital assets like jettons and NFTs. +- Cross-platform architecture: Runs on mobile, desktop and web enviroment. + + +### Supported platforms + +* **Mobile apps:** iOS, Android +* **Desktop apps:** Windows, macOS, Linux +* **Browser extensions:** Chrome, Firefox, Brave, Yandex Edge +* **Telegram:** accessible via [Telegram clients](https://t.me/tonkeeperbot). + + +## Create a wallet + +You need to first install Tonkeeper using any of the methods above. For the steps below, we’ll use the mobile version as it’s convenient to set up. Once installed: + +1. Open Tonkeeper. +2. Click **Create new wallet**. + + + +3. Customize your wallet by adding your wallet name. Add a name or icon if desired. + + + +4. Set a PIN code for transaction confirmation. Your TON wallet will be created but we are not done yet. + + + +5. Click **Back up your recovery phrase**. Without it, you cannot restore access to your wallet. + + + +6. Click **Back up manually**. You'll see an attention dialog box (*read this carefully as it contains dos and don'ts you need to know before viewing your recovery phrase*). Once you're done, click continue. + + + +7. Write down the 24 recovery phrases shown to you as this is very important. Click check backup once you're done. + +Never share your recovery phrase with anyone. If someone gets access to your 24-word recovery phrase, they can have access to all your funds. + +8. You'll be asked to verify a few words to confirm if you have saved your recovery phrase correctly. After verification, click **Done**. + + + +9. You can always back up your recovery phrase whenever you choose. + + + +**That's it!** _Your wallet is now ready to use_. + +## Testnet accounts + +Tonkeeper requires an existing Mainnet wallet before you can create a Testnet account. The Testnet account is derived from your Mainnet wallet's mnemonic. + +To add a Testnet account: + +1. Click on your wallet name at the top of the screen and click **Add wallet**. + + + +2. Select **Testnet account** from the list. + + + +3. Enter your 24‑word recovery phrase given to you when you created the wallet and tap **Continue**. + +4. You can add a custom name or icon for your Testnet wallet. + + + +5. Enter your passcode to confirm and your Testnet wallet will be created. + +**All set!** You now have both mainnet and testnet wallet set up. + +Mainnet and Testnet use different address formats, your Testnet address will not be identical to your Mainnet address. See [How to read and write TON addresses](https://companyname-a7d5b98e-wallet-ton-org.mintlify.app/ton/addresses/writing-and-reading-addresses#using-online-converter) for details on address formats and conversion. + + + +## Deploy a wallet + +Before you can use your wallet, it must be **deployed** — the account state needs to become **active**. + +When you first create a wallet, it starts in the **nonexist** state, meaning there’s _no code, data, or balance_ stored on-chain yet. + +### Check your account state + +You can use the [TON blockchain explorer](/ecosystem/explorers/overview) to check your account status. For **Testnet**, use [Tonviewer Testnet](https://testnet.tonviewer.com/). + +1. Paste your wallet address into the search bar. + +Insert your address in Tonviewer search + +2. Your account details will show up. For a newly created wallet, you'll see the status as **nonexist**, which means your wallet isn't deployed yet. + +Account status - nonexist + +### Fund your wallet + +Your wallet needs to receive funds before it can be deployed. + +On Testnet, you can get free Testnet Toncoins from the [TON Testnet Faucet](link). + +Once you receive funds, your wallet moves to the **uninit** state. This means your account has a balance, but the smart contract isn't deployed yet. + +Account status - uninit + +### Send your first transaction + +Now that you have TON in your account, you can deploy the wallet. Deployment happens when _your wallet processes its first transaction_. + +For this example, we'll send TON to your own account on Testnet so you can see the transaction and wallet deployment happen on-chain. + +To send TON to your own account: + +1. Click **Send**. +2. Enter your own wallet address as the recipient. +3. Enter the amount you want to send and click **Continue**. + +Send transaction + +4. Review the transaction details and click **Confirm**. + +Account status: uninit + +5. Enter your PIN to approve the transanction request. You'll see a confirmation screen once the transaction is sent. + +Next, check your wallet status in the blockchain explorer — if it’s active, _you’ve successfully deployed your contract!_ +Account status: uninit + +You'll also see other fields like your address, current TON balance, and contract type showing your wallet version. To learn more about wallet contract types, see the [Wallets history](/standard/wallets/overview). + +## See also + +* [Tonkeeper GitHub repository](https://github.com/tonkeeper) \ No newline at end of file diff --git a/resources/images/Tonkeeper.png b/resources/images/Tonkeeper.png deleted file mode 100644 index 80c0581a..00000000 Binary files a/resources/images/Tonkeeper.png and /dev/null differ diff --git a/resources/images/wallets/tonkeeper/active-dark.png b/resources/images/wallets/tonkeeper/active-dark.png new file mode 100644 index 00000000..d9508044 Binary files /dev/null and b/resources/images/wallets/tonkeeper/active-dark.png differ diff --git a/resources/images/wallets/tonkeeper/active-light.png b/resources/images/wallets/tonkeeper/active-light.png new file mode 100644 index 00000000..f26e5b65 Binary files /dev/null and b/resources/images/wallets/tonkeeper/active-light.png differ diff --git a/resources/images/wallets/tonkeeper/active.png b/resources/images/wallets/tonkeeper/active.png new file mode 100644 index 00000000..aff1449a Binary files /dev/null and b/resources/images/wallets/tonkeeper/active.png differ diff --git a/resources/images/wallets/tonkeeper/add-wallet-dark.jpeg b/resources/images/wallets/tonkeeper/add-wallet-dark.jpeg new file mode 100644 index 00000000..f80f43fc Binary files /dev/null and b/resources/images/wallets/tonkeeper/add-wallet-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/add-wallet-light.jpeg b/resources/images/wallets/tonkeeper/add-wallet-light.jpeg new file mode 100644 index 00000000..33161c2a Binary files /dev/null and b/resources/images/wallets/tonkeeper/add-wallet-light.jpeg differ diff --git a/resources/images/wallets/tonkeeper/address-nonexist-dark.png b/resources/images/wallets/tonkeeper/address-nonexist-dark.png new file mode 100644 index 00000000..79c5fa79 Binary files /dev/null and b/resources/images/wallets/tonkeeper/address-nonexist-dark.png differ diff --git a/resources/images/wallets/tonkeeper/address-nonexist-light.png b/resources/images/wallets/tonkeeper/address-nonexist-light.png new file mode 100644 index 00000000..9ea8a73e Binary files /dev/null and b/resources/images/wallets/tonkeeper/address-nonexist-light.png differ diff --git a/resources/images/wallets/tonkeeper/address-uninit-dark.png b/resources/images/wallets/tonkeeper/address-uninit-dark.png new file mode 100644 index 00000000..99ea9d7b Binary files /dev/null and b/resources/images/wallets/tonkeeper/address-uninit-dark.png differ diff --git a/resources/images/wallets/tonkeeper/address-uninit-light.png b/resources/images/wallets/tonkeeper/address-uninit-light.png new file mode 100644 index 00000000..74d0cd81 Binary files /dev/null and b/resources/images/wallets/tonkeeper/address-uninit-light.png differ diff --git a/resources/images/wallets/tonkeeper/backup-check-dark.jpeg b/resources/images/wallets/tonkeeper/backup-check-dark.jpeg new file mode 100644 index 00000000..e0ca2a0d Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-check-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/backup-check-light.jpeg b/resources/images/wallets/tonkeeper/backup-check-light.jpeg new file mode 100644 index 00000000..9c45db82 Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-check-light.jpeg differ diff --git a/resources/images/wallets/tonkeeper/backup-dark.png b/resources/images/wallets/tonkeeper/backup-dark.png new file mode 100644 index 00000000..81436829 Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-dark.png differ diff --git a/resources/images/wallets/tonkeeper/backup-final-dark.jpeg b/resources/images/wallets/tonkeeper/backup-final-dark.jpeg new file mode 100644 index 00000000..aaa49b2b Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-final-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/backup-final-light.jpeg b/resources/images/wallets/tonkeeper/backup-final-light.jpeg new file mode 100644 index 00000000..9423b79a Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-final-light.jpeg differ diff --git a/resources/images/wallets/tonkeeper/backup-light.jpg b/resources/images/wallets/tonkeeper/backup-light.jpg new file mode 100644 index 00000000..cadddb94 Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-light.jpg differ diff --git a/resources/images/wallets/tonkeeper/backup-manually-dark.jpeg b/resources/images/wallets/tonkeeper/backup-manually-dark.jpeg new file mode 100644 index 00000000..522d5be0 Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-manually-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/backup-manually-light.jpeg b/resources/images/wallets/tonkeeper/backup-manually-light.jpeg new file mode 100644 index 00000000..df0eaccb Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-manually-light.jpeg differ diff --git a/resources/images/wallets/tonkeeper/confirm-transaction-dark.jpeg b/resources/images/wallets/tonkeeper/confirm-transaction-dark.jpeg new file mode 100644 index 00000000..3160419c Binary files /dev/null and b/resources/images/wallets/tonkeeper/confirm-transaction-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/confirm-transaction-light.jpeg b/resources/images/wallets/tonkeeper/confirm-transaction-light.jpeg new file mode 100644 index 00000000..8defe501 Binary files /dev/null and b/resources/images/wallets/tonkeeper/confirm-transaction-light.jpeg differ diff --git a/resources/images/wallets/tonkeeper/create-wallet-dark.jpeg b/resources/images/wallets/tonkeeper/create-wallet-dark.jpeg new file mode 100644 index 00000000..48540497 Binary files /dev/null and b/resources/images/wallets/tonkeeper/create-wallet-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/create-wallet-light.jpeg b/resources/images/wallets/tonkeeper/create-wallet-light.jpeg new file mode 100644 index 00000000..88fee4ea Binary files /dev/null and b/resources/images/wallets/tonkeeper/create-wallet-light.jpeg differ diff --git a/resources/images/wallets/tonkeeper/customize-wallet-dark.jpeg b/resources/images/wallets/tonkeeper/customize-wallet-dark.jpeg new file mode 100644 index 00000000..313fb30a Binary files /dev/null and b/resources/images/wallets/tonkeeper/customize-wallet-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/customize-wallet-light.jpeg b/resources/images/wallets/tonkeeper/customize-wallet-light.jpeg new file mode 100644 index 00000000..a943e505 Binary files /dev/null and b/resources/images/wallets/tonkeeper/customize-wallet-light.jpeg differ diff --git a/resources/images/wallets/tonkeeper/send-transaction-dark.jpeg b/resources/images/wallets/tonkeeper/send-transaction-dark.jpeg new file mode 100644 index 00000000..db014ed5 Binary files /dev/null and b/resources/images/wallets/tonkeeper/send-transaction-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/send-transaction-light.jpeg b/resources/images/wallets/tonkeeper/send-transaction-light.jpeg new file mode 100644 index 00000000..ae5c6147 Binary files /dev/null and b/resources/images/wallets/tonkeeper/send-transaction-light.jpeg differ diff --git a/resources/images/wallets/tonkeeper/testnet-dark.jpeg b/resources/images/wallets/tonkeeper/testnet-dark.jpeg new file mode 100644 index 00000000..610c88e8 Binary files /dev/null and b/resources/images/wallets/tonkeeper/testnet-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/testnet-light.jpg b/resources/images/wallets/tonkeeper/testnet-light.jpg new file mode 100644 index 00000000..7e808ec8 Binary files /dev/null and b/resources/images/wallets/tonkeeper/testnet-light.jpg differ diff --git a/resources/images/wallets/tonkeeper/tonkeeper-dark.jpeg b/resources/images/wallets/tonkeeper/tonkeeper-dark.jpeg new file mode 100644 index 00000000..7762562c Binary files /dev/null and b/resources/images/wallets/tonkeeper/tonkeeper-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/tonkeeper-light.jpeg b/resources/images/wallets/tonkeeper/tonkeeper-light.jpeg new file mode 100644 index 00000000..81b56ba0 Binary files /dev/null and b/resources/images/wallets/tonkeeper/tonkeeper-light.jpeg differ diff --git a/resources/images/wallets/tonkeeper/tonviewer-dark.png b/resources/images/wallets/tonkeeper/tonviewer-dark.png new file mode 100644 index 00000000..e7ac3d33 Binary files /dev/null and b/resources/images/wallets/tonkeeper/tonviewer-dark.png differ diff --git a/resources/images/wallets/tonkeeper/tonviewer-light.png b/resources/images/wallets/tonkeeper/tonviewer-light.png new file mode 100644 index 00000000..112ee75b Binary files /dev/null and b/resources/images/wallets/tonkeeper/tonviewer-light.png differ diff --git a/resources/images/wallets/tonkeeper/wallet-dark.jpeg b/resources/images/wallets/tonkeeper/wallet-dark.jpeg new file mode 100644 index 00000000..617f8da9 Binary files /dev/null and b/resources/images/wallets/tonkeeper/wallet-dark.jpeg differ diff --git a/resources/images/wallets/tonkeeper/wallet-light.jpeg b/resources/images/wallets/tonkeeper/wallet-light.jpeg new file mode 100644 index 00000000..228d2145 Binary files /dev/null and b/resources/images/wallets/tonkeeper/wallet-light.jpeg differ