diff --git a/ecosystem/wallet-apps/tonkeeper.mdx b/ecosystem/wallet-apps/tonkeeper.mdx index 76011de99..93b4489bd 100644 --- a/ecosystem/wallet-apps/tonkeeper.mdx +++ b/ecosystem/wallet-apps/tonkeeper.mdx @@ -2,6 +2,322 @@ title: "Tonkeeper" --- -import { Stub } from '/snippets/stub.jsx'; +import { Aside } from "/snippets/aside.jsx"; +import { Image } from '/snippets/image.jsx'; - +[Tonkeeper](https://tonkeeper.com/) is a self‑custodial mobile wallet available on [iOS](https://apps.apple.com/us/app/tonkeeper-ton-wallet/id1587742107) and [Android](https://play.google.com/store/apps/details?id=com.ton_keeper). +It supports regular [wallets](/standard/wallets/how-it-works), [Jettons](/standard/tokens/jettons/overview), [NFTs](/standard/tokens/nft/overview), and [TON Connect](/ecosystem/ton-connect). Its github repository can be found [here](https://github.com/tonkeeper). + +
+ Tonkeeper main interface +
+ +- 🟡 **Account balance** displays the total amount of Toncoin and other tokens held on account. +- 🔴 **Account address** is shown as a base64-encoded string. It can be shared to receive TON, jettons, or NFTs. +- 🟢 **Send/Receive/Scan buttons** are used to transfer TON or jettons to another account, receive TON or jettons to the wallet, and scan QR codes to confirm transactions, respectively. + +## Create a wallet + +A wallet is required to do any transactions on a public global network. It is the primary way to interact with the blockchain. This step-by-step guide explains how to use Tonkeeper app to create a testnet wallet account. + +Testnet is used instead of mainnet, because it is more suitable for development and experimentation, and test coins can be obtained for free on testnet. The procedure works the same way on mainnet, except funds will have to be procured in a different way. + +Overall procedure is: + +- Generate a mnemonic (a key). It uniquely determines wallet's address, but the wallet doesn't exist on blockchain yet, i.e. is in [`nonexist`](/foundations/status#status-variety) status. +- Send some funds to the wallet's account. Now it will be in [`uninit`](/foundations/status#status-variety) status, i.e. already with some balance on it, but without any code yet. +- Deploy wallet's code to this address. Some of these funds will be used to pay for the deploy process. Now the wallet is in [`active`](/foundations/status#status-variety) status, and can be used for any purpose. + + + + + +### Generate a key + +1. Install Tonkeeper on [iOS](https://apps.apple.com/us/app/tonkeeper-ton-wallet/id1587742107) or [Android](https://play.google.com/store/apps/details?id=com.ton_keeper). + +1. Click Create New Wallet + +
+ Create a wallet +
+ +1. Create a passcode and re-enter it. Passcode is used to encrypt the mnemonic. + +
+ Create a passcode + + Confirm the passcode +
+ +1. Click Back up your recovery phrase and Back Up Manually. + +
+ Back up + + Confirm the passcode +
+ +1. Save 24 words of the [mnemonic](/standard/wallets/mnemonics). + + + +
+ Recovery phrase +
+ +1. Pass the check that the mnemonic was saved. + +
+ Recovery phrase +
+ +1. The main interface of the app should now appear. + +### Switch to testnet + +1. Click wallet to open the Add Wallet pop-up. + +
+ Add testnet +
+ +1. In the "Add Wallet" window, scroll down to the "For developers" section. Click the "Testnet Account" card. + +
+ Testnet account +
+ +1. Enter the recovery phrase that was provided when the wallet was created on Mainnet, then click Confirm. + +
+ Recovery phrase for testnet +
+ +1. The main interface of the app should now appear, indicating that the testnet is used. Also address of the testnet wallet in the [user-friendly format](/foundations/addresses/formats#user-friendly-format) starts with `k` or `0`. + +
+ Main interface with testnet note +
+ +### Add funds into the wallet + +1. Message [`@testgiver_ton_bot`](https://t.me/testgiver_ton_bot) in [Telegram](https://telegram.org/). +1. Press the Start or send `/start` message. +1. Pass the captcha test. +1. Enter and send the testnet wallet address displayed by wallet.ton.org. +1. Soon after the "Request added to the queue" response, 2 TON will be sent to the wallet. +1. There won't be any other message that the transfer happened. [Use an explorer](#check-the-account-state) to check the request status. +1. The account should be in the `uninit` status now. + +Account status: uninit + +For a detailed step-by-step guide, see [How to get Toncoin on testnet](/contract-dev/testing/testnet-tokens). + +### Deploy the code + + + +To deploy the code, send any transaction from the wallet. The recipient can be any address, including the wallet itself. + +1. Click Send on the main interface, enter wallet address in "Address or name", and the "Amount" of TON. Click Continue. + +
+ Send TON +
+ +1. Verify the transaction details and swipe if correct. Otherwise, tap `<` in the top-left corner to edit. + +
+ Verify transaction +
+ +1. After confirmation, enter the passcode. Then, the "History" page displays the sent transaction. + +1. [Use an explorer](#check-the-account-state) to check wallet's status. It should be `active` now. + +## Check the account state + +Use a [blockchain explorer](/ecosystem/explorers/overview) to inspect the account. For **Testnet**, use [Tonviewer Testnet](https://testnet.tonviewer.com/). + +1. Paste the wallet address into the search bar.
Insert address in Tonviewer search + +1. The account details will appear. In a newly created wallet, the status is `nonexist`, indicating the wallet is not deployed.
Account status: nonexist + +## Verify wallet's version + +By default, Tonkeeper creates wallets with the [Wallet v5](/standard/wallets/v5) code deployed on them. To switch [wallet contract version](/standard/wallets/comparison) to [v4](/standard/wallets/v4): + +1. On the main menu, tap the gear icon in the upper-right corner. + +1. In "Settings", select Wallet v4R2 and enter the passcode. + +
+ V4R2 +
+ +1. The wallet v4r2 is auto-generated and the app returns to the main menu. + + - If v5 is highlighted, v4 has no visual indicator. + - To check, tap the wallet name — **wallet v4r2** — v5 is highlighted, while v4 is not. + +
+ V4R2 +
diff --git a/resources/images/Tonkeeper.png b/resources/images/Tonkeeper.png deleted file mode 100644 index 80c0581ae..000000000 Binary files a/resources/images/Tonkeeper.png and /dev/null differ diff --git a/resources/images/wallets/tonkeeper/add-testnet-wallet-dark.png b/resources/images/wallets/tonkeeper/add-testnet-wallet-dark.png new file mode 100644 index 000000000..f34c6af9a Binary files /dev/null and b/resources/images/wallets/tonkeeper/add-testnet-wallet-dark.png differ diff --git a/resources/images/wallets/tonkeeper/add-testnet-wallet-light.png b/resources/images/wallets/tonkeeper/add-testnet-wallet-light.png new file mode 100644 index 000000000..5535f4a0b Binary files /dev/null and b/resources/images/wallets/tonkeeper/add-testnet-wallet-light.png differ diff --git a/resources/images/wallets/tonkeeper/backup-check-dark.png b/resources/images/wallets/tonkeeper/backup-check-dark.png new file mode 100644 index 000000000..482a45dad Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-check-dark.png differ diff --git a/resources/images/wallets/tonkeeper/backup-check-light.png b/resources/images/wallets/tonkeeper/backup-check-light.png new file mode 100644 index 000000000..c1a6c1f7b Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-check-light.png differ diff --git a/resources/images/wallets/tonkeeper/backup-dark.png b/resources/images/wallets/tonkeeper/backup-dark.png new file mode 100644 index 000000000..a47f28233 Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-dark.png differ diff --git a/resources/images/wallets/tonkeeper/backup-ligh.png b/resources/images/wallets/tonkeeper/backup-ligh.png new file mode 100644 index 000000000..7ccb12524 Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-ligh.png differ diff --git a/resources/images/wallets/tonkeeper/backup-light.png b/resources/images/wallets/tonkeeper/backup-light.png new file mode 100644 index 000000000..09ae01e5d Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-light.png differ diff --git a/resources/images/wallets/tonkeeper/backup-manually-dark.png b/resources/images/wallets/tonkeeper/backup-manually-dark.png new file mode 100644 index 000000000..a8ccb77ac Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-manually-dark.png differ diff --git a/resources/images/wallets/tonkeeper/backup-manually-light.png b/resources/images/wallets/tonkeeper/backup-manually-light.png new file mode 100644 index 000000000..da3ffe408 Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-manually-light.png differ diff --git a/resources/images/wallets/tonkeeper/backup-manually.png b/resources/images/wallets/tonkeeper/backup-manually.png new file mode 100644 index 000000000..d44537322 Binary files /dev/null and b/resources/images/wallets/tonkeeper/backup-manually.png differ diff --git a/resources/images/wallets/tonkeeper/confirm-dark.png b/resources/images/wallets/tonkeeper/confirm-dark.png new file mode 100644 index 000000000..77836ad05 Binary files /dev/null and b/resources/images/wallets/tonkeeper/confirm-dark.png differ diff --git a/resources/images/wallets/tonkeeper/confirm-light.png b/resources/images/wallets/tonkeeper/confirm-light.png new file mode 100644 index 000000000..5f17a3df6 Binary files /dev/null and b/resources/images/wallets/tonkeeper/confirm-light.png differ diff --git a/resources/images/wallets/tonkeeper/create-wallet-dark.png b/resources/images/wallets/tonkeeper/create-wallet-dark.png new file mode 100644 index 000000000..7e5b2339a Binary files /dev/null and b/resources/images/wallets/tonkeeper/create-wallet-dark.png differ diff --git a/resources/images/wallets/tonkeeper/create-wallet-light.png b/resources/images/wallets/tonkeeper/create-wallet-light.png new file mode 100644 index 000000000..c266e054f Binary files /dev/null and b/resources/images/wallets/tonkeeper/create-wallet-light.png differ diff --git a/resources/images/wallets/tonkeeper/for-devs-dark.png b/resources/images/wallets/tonkeeper/for-devs-dark.png new file mode 100644 index 000000000..d84af064a Binary files /dev/null and b/resources/images/wallets/tonkeeper/for-devs-dark.png differ diff --git a/resources/images/wallets/tonkeeper/for-devs-light.png b/resources/images/wallets/tonkeeper/for-devs-light.png new file mode 100644 index 000000000..c5d940c3a Binary files /dev/null and b/resources/images/wallets/tonkeeper/for-devs-light.png differ diff --git a/resources/images/wallets/tonkeeper/main-int-dark.png b/resources/images/wallets/tonkeeper/main-int-dark.png new file mode 100644 index 000000000..3ff23194e Binary files /dev/null and b/resources/images/wallets/tonkeeper/main-int-dark.png differ diff --git a/resources/images/wallets/tonkeeper/main-int-light.png b/resources/images/wallets/tonkeeper/main-int-light.png new file mode 100644 index 000000000..c66e3f3a9 Binary files /dev/null and b/resources/images/wallets/tonkeeper/main-int-light.png differ diff --git a/resources/images/wallets/tonkeeper/main-int-test-dark.png b/resources/images/wallets/tonkeeper/main-int-test-dark.png new file mode 100644 index 000000000..23dc190fa Binary files /dev/null and b/resources/images/wallets/tonkeeper/main-int-test-dark.png differ diff --git a/resources/images/wallets/tonkeeper/main-int-test-light.png b/resources/images/wallets/tonkeeper/main-int-test-light.png new file mode 100644 index 000000000..bb03a7ba4 Binary files /dev/null and b/resources/images/wallets/tonkeeper/main-int-test-light.png differ diff --git a/resources/images/wallets/tonkeeper/passcode-dark.png b/resources/images/wallets/tonkeeper/passcode-dark.png new file mode 100644 index 000000000..5b4681ef5 Binary files /dev/null and b/resources/images/wallets/tonkeeper/passcode-dark.png differ diff --git a/resources/images/wallets/tonkeeper/passcode-light.png b/resources/images/wallets/tonkeeper/passcode-light.png new file mode 100644 index 000000000..e9760fdc1 Binary files /dev/null and b/resources/images/wallets/tonkeeper/passcode-light.png differ diff --git a/resources/images/wallets/tonkeeper/recovery-dark.png b/resources/images/wallets/tonkeeper/recovery-dark.png new file mode 100644 index 000000000..78e6af884 Binary files /dev/null and b/resources/images/wallets/tonkeeper/recovery-dark.png differ diff --git a/resources/images/wallets/tonkeeper/recovery-light.png b/resources/images/wallets/tonkeeper/recovery-light.png new file mode 100644 index 000000000..0239bb30a Binary files /dev/null and b/resources/images/wallets/tonkeeper/recovery-light.png differ diff --git a/resources/images/wallets/tonkeeper/recovery-test-dark.png b/resources/images/wallets/tonkeeper/recovery-test-dark.png new file mode 100644 index 000000000..4d41ffa07 Binary files /dev/null and b/resources/images/wallets/tonkeeper/recovery-test-dark.png differ diff --git a/resources/images/wallets/tonkeeper/recovery-test-light.png b/resources/images/wallets/tonkeeper/recovery-test-light.png new file mode 100644 index 000000000..a8d67b616 Binary files /dev/null and b/resources/images/wallets/tonkeeper/recovery-test-light.png differ diff --git a/resources/images/wallets/tonkeeper/reenter-dark.png b/resources/images/wallets/tonkeeper/reenter-dark.png new file mode 100644 index 000000000..7dcf1239a Binary files /dev/null and b/resources/images/wallets/tonkeeper/reenter-dark.png differ diff --git a/resources/images/wallets/tonkeeper/reenter-light.png b/resources/images/wallets/tonkeeper/reenter-light.png new file mode 100644 index 000000000..9845116c4 Binary files /dev/null and b/resources/images/wallets/tonkeeper/reenter-light.png differ diff --git a/resources/images/wallets/tonkeeper/send-dark.png b/resources/images/wallets/tonkeeper/send-dark.png new file mode 100644 index 000000000..ad8d1b29b Binary files /dev/null and b/resources/images/wallets/tonkeeper/send-dark.png differ diff --git a/resources/images/wallets/tonkeeper/send-light.png b/resources/images/wallets/tonkeeper/send-light.png new file mode 100644 index 000000000..81b7d163f Binary files /dev/null and b/resources/images/wallets/tonkeeper/send-light.png differ diff --git a/resources/images/wallets/tonkeeper/v4r2-dark.png b/resources/images/wallets/tonkeeper/v4r2-dark.png new file mode 100644 index 000000000..c56d046f5 Binary files /dev/null and b/resources/images/wallets/tonkeeper/v4r2-dark.png differ diff --git a/resources/images/wallets/tonkeeper/v4r2-light.png b/resources/images/wallets/tonkeeper/v4r2-light.png new file mode 100644 index 000000000..1c8541e9c Binary files /dev/null and b/resources/images/wallets/tonkeeper/v4r2-light.png differ diff --git a/resources/images/wallets/tonkeeper/wallet-v4r2-dark.png b/resources/images/wallets/tonkeeper/wallet-v4r2-dark.png new file mode 100644 index 000000000..d739669d4 Binary files /dev/null and b/resources/images/wallets/tonkeeper/wallet-v4r2-dark.png differ diff --git a/resources/images/wallets/tonkeeper/wallet-v4r2-light.png b/resources/images/wallets/tonkeeper/wallet-v4r2-light.png new file mode 100644 index 000000000..113d9b778 Binary files /dev/null and b/resources/images/wallets/tonkeeper/wallet-v4r2-light.png differ