tonkeeper-upd

Author: aigerimu

ecosystem/wallet-apps/tonkeeper.mdx

@@ -6,7 +6,22 @@ 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).
+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).
+
+<div style={{ display: "flex", justifyContent: "center" }}>
+  <Image
+    src="/resources/images/wallets/tonkeeper/main-int-light.png"
+    darkSrc="/resources/images/wallets/tonkeeper/main-int-dark.png"
+    width={228}
+    height={342}
+    alt="Tonkeeper main interface"
+  />
+</div>
+
+- 🟡 **Account balance** displays the total amount of Toncoin and other tokens held on account.
+- 🔴 **Account address** is shown as a base64-encoded string. You can share this address 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
 
@@ -33,6 +48,16 @@ Overall procedure is:
   Verify which network is used before any funds are sent.
 </Aside>
 
+
+<Aside
+  type="caution"
+  title="Bug!"
+>
+  There is a bug in Tonkeeper. Mainnet [subwallet ID](/standard/wallets/how-it-works#subwallet-id) is used to generate the address of testnet account.
+
+  If an address from Tonkeeper doesn't match an address computed with `@ton/ton` or some other library, this might be the reason.
+</Aside>
+
 ### 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).
@@ -48,7 +73,7 @@ Overall procedure is:
       />
       </div>
 
-1. Create a passcode and re-enter it.
+1. Create a passcode and re-enter it. Passcode is used to encrypt the mnemonic.
 
     <div style={{ display: "flex", justifyContent: "center", gap: "16px" }}>
       <Image
@@ -67,18 +92,6 @@ Overall procedure is:
       />
     </div>
 
-1. Customize the wallet.
-
-    <div style={{ display: "flex", justifyContent: "center" }}>
-      <Image
-        src="/resources/images/wallets/tonkeeper/customize-light.png"
-        darkSrc="/resources/images/wallets/tonkeeper/customize-dark.png"
-        width={228}
-        height={342}
-        alt="Customize the wallet"
-      />
-    </div>
-
 1. Click <kbd>Back up your recovery phrase</kbd> and <kbd>Back Up Manually</kbd>.
 
     <div style={{ display: "flex", justifyContent: "center", gap: "16px" }}>
@@ -99,13 +112,93 @@ Overall procedure is:
       />
     </div>
 
-1.
+1. Save 24 words of the [mnemonic](/standard/wallets/mnemonics).
+
+    <Aside type="danger" title="Funds at risk">
+    Mnemonic is the text representation of wallet's secret key. Losing it is the same as losing access to the wallet.<br/>
+    Anyone who has access to the mnemonic can take control of the wallet and move funds. If you suspect it already happened, create a new wallet and transfer all funds immediately. Prefer not to store recovery words digitally; write them down and keep them offline.
+    </Aside>
+
+    <div style={{ display: "flex", justifyContent: "center" }}>
+      <Image
+        src="/resources/images/wallets/tonkeeper/recovery-light.png"
+        darkSrc="/resources/images/wallets/tonkeeper/recovery-dark.png"
+        width={228}
+        height={342}
+        alt="Recovery phrase"
+      />
+    </div>
+
+1. Pass the check that the mnemonic was saved.
+
+    <div style={{ display: "flex", justifyContent: "center" }}>
+        <Image
+        src="/resources/images/wallets/tonkeeper/backup-check-light.png"
+        darkSrc="/resources/images/wallets/tonkeeper/backup-check-dark.png"
+        width={228}
+        height={342}
+        alt="Recovery phrase"
+        />
+    </div>
+
+1. The main interface of the app should now appear.
 
 ### Switch to testnet
+
+1. Click <kbd>wallet</kbd> to open the <kbd>Add Wallet</kbd> pop-up.
+
+    <div style={{ display: "flex", justifyContent: "center" }}>
+      <Image
+        src="/resources/images/wallets/tonkeeper/add-testnet-wallet-light.png"
+        darkSrc="/resources/images/wallets/tonkeeper/add-testnet-wallet-dark.png"
+        width={228}
+        height={342}
+        alt="Add testnet"
+      />
+    </div>
+
+1. In the "Add Wallet" window, scroll down to the "For developers" section. Click the "Testnet Account" card.
+
+    <div style={{ display: "flex", justifyContent: "center" }}>
+      <Image
+        src="/resources/images/wallets/tonkeeper/for-devs-light.png"
+        darkSrc="/resources/images/wallets/tonkeeper/for-devs-dark.png"
+        width={228}
+        height={342}
+        alt="Testnet account"
+      />
+    </div>
+
+1. Enter the recovery phrase that was provided when the wallet was created on Mainnet, then click <kbd>Confirm</kbd>.
+
+    <div style={{ display: "flex", justifyContent: "center" }}>
+      <Image
+        src="/resources/images/wallets/tonkeeper/recovery-test-light.png"
+        darkSrc="/resources/images/wallets/tonkeeper/recovery-test-dark.png"
+        width={228}
+        height={342}
+        alt="Recovery phrase for testnet"
+      />
+    </div>
+
+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`.
+
+    <div style={{ display: "flex", justifyContent: "center" }}>
+      <Image
+      src="/resources/images/wallets/tonkeeper/main-int-test-light.png"
+      darkSrc="/resources/images/wallets/tonkeeper/main-int-test-dark.png"
+      width={228}
+      height={342}
+      alt="Main interface with testnet note"
+      />
+    </div>
+
+
+
 ### 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 button or send `/start` message.
+1. Press the <kbd>Start</kbd> 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.
@@ -117,7 +210,47 @@ Overall procedure is:
   darkSrc="/resources/images/wallets/wallet-ton-org/address_uninit_dark.png"
   alt="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
+
+<Aside
+  type="caution"
+  title="Funds at risk"
+>
+  On-chain transfers are irreversible — verify the recipient and amount before confirming. Use testnet for practice; only use mainnet when you intend to make a real transfer.
+</Aside>
+
+To deploy the code, send any transaction from the wallet. The recipient can be any address, including the wallet itself.
+
+1. Click <kbd>Send</kbd> on the main interface, enter wallet address in "Address or name", and the "Amount" of TON. Click <kbd>Continue</kbd>.
+
+    <div style={{ display: "flex", justifyContent: "center" }}>
+      <Image
+        src="/resources/images/wallets/tonkeeper/send-light.png"
+        darkSrc="/resources/images/wallets/tonkeeper/send-dark.png"
+        width={228}
+        height={342}
+        alt="Send TON"
+      />
+    </div>
+
+1. Verify the transaction details and swipe if correct. Otherwise, tap <kbd>`<`</kbd> in the top-left corner to edit.
+
+    <div style={{ display: "flex", justifyContent: "center" }}>
+      <Image
+        src="/resources/images/wallets/tonkeeper/confirm-light.png"
+        darkSrc="/resources/images/wallets/tonkeeper/confirm-dark.png"
+        width={228}
+        height={342}
+        alt="Verify transaction"
+      />
+    </div>
+
+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/).
@@ -128,8 +261,36 @@ Use a [blockchain explorer](/ecosystem/explorers/overview) to inspect the accoun
 
 ## 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 <kbd><Icon icon="gear" size={16} /></kbd> in the upper-right corner.
+1. In "Settings", select <kbd>Wallet v4R2</kbd> and enter the passcode.
+
+    <div style={{ display: "flex", justifyContent: "center" }}>
+      <Image
+        src="/resources/images/wallets/tonkeeper/v4r2-light.png"
+        darkSrc="/resources/images/wallets/tonkeeper/v4r2-dark.png"
+        width={228}
+        height={342}
+        alt="V4R2"
+      />
+    </div>
+
+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.
+
+<div style={{ display: "flex", justifyContent: "center" }}>
+    <Image
+      src="/resources/images/wallets/tonkeeper/wallet-v4r2-light.png"
+      darkSrc="/resources/images/wallets/tonkeeper/wallet-v4r2-dark.png"
+      width={228}
+      height={342}
+      alt="V4R2"
+    />
+  </div>
+
 
 
-## See also
 
-* [Tonkeeper GitHub repository](https://github.com/tonkeeper)