diff --git a/ecosystem/wallet-apps/web.mdx b/ecosystem/wallet-apps/web.mdx index b07c0572..dc054d5d 100644 --- a/ecosystem/wallet-apps/web.mdx +++ b/ecosystem/wallet-apps/web.mdx @@ -2,6 +2,293 @@ title: "wallet.ton.org" --- -import { Stub } from '/snippets/stub.jsx'; +import { Aside } from "/snippets/aside.jsx"; +import { Image } from '/snippets/image.jsx'; - +[wallet.ton.org](https://github.com/ton-blockchain/ton-wallet) is the self-custodial wallet developed by TON Core. +It supports jettons, NFTs, [TON DNS](/services/dns), [TON Sites](/services/sites), [TON Proxy](/services/proxy), and is available as a web app and browser extension. + +## Key features + +- **Testnet support:** accepts the `testnet` parameter in the browser. +- **Supports [W5](/standard/wallets/v5)**: the latest wallet smart contract standard for TON Blockchain. + +## Wallet setup + +To get started, set up your [wallet.ton.org](https://wallet.ton.org/), a web-based wallet interface. + +1. Open [wallet.ton.org](https://wallet.ton.org/). + +1. Click "Create Wallet" to create a new wallet. + +Web wallet welcome page + +3. Next, choose "Use Password" to protect your wallet: + +Password option + +4. Set and confirm your password. + Ensure you use a _strong and unique_ password to protect your wallet. + +Password setup + +5. Read the "Use Responsibly" notice and check the box to _confirm that you have read and accepted this information_. + +Use responsibility notice + +6. After confirming, you’ll be prompted to manually back up your secret key. + This key is the **only** way to recover access to your wallet if you lose your password or device. + Click "Back Up Now" to continue. + +Back up your password + +7. Read the "Safety Rules" carefully, check all the boxes to confirm that you understand them. Then click "Understood" to continue. + +Safety rules + +8. Write down your 24 recovery words and store them in **a safe place**. + _Never share them with anyone or enter them anywhere else._ + + + +Once you’re ready, click "Let’s Check" to verify your recovery phrase. + +Recovery words + +9. In the "Let’s Check" step, enter the requested words to make sure your recovery phrase was saved correctly. + +Then click "Continue" to finish the setup. + +Verify your secret words + +**Congratulations!** _Your wallet is now ready to use._ + +### Interface overview + +The main screen of the wallet displays essential account information and actions. + +- **Account balance (yellow box)** displays the total amount of Toncoin and other tokens held on your account. +- **Account address (red box)** is your unique account identifier, shown both as a QR code and as a base64-encoded string. + +For example: `UQDDKXleckOm6CTbab3CPz0TkvbSkrlUFum_YMIa-IIfGmXk`. +You can share this address to receive TON, jettons, or NFTs. + +- The **send button (green box)** opens the transfer form, allowing you to send TON or jettons to another account address. + +Wallet interface + +### Wallet contract version + +To check which [wallet contract version](/standard/wallets/comparison) is used: + +1. Click the "Settings" icon. + +Settings button + +2. In the "Wallet Versions", you can see which contract your wallet uses. + +Settings button + +3. Click the field to view the current version, for example, _W5_. + +If you previously used older wallet contracts, such as v3 or v4, you can import them using your mnemonic phrase. + +Settings button + +### Testnet + +In wallet.ton.org, the **Testnet account** is derived from the **Mainnet wallet’s mnemonic**. + + + +To add a Testnet account: + +1. Click the **Settings** icon. + +Settings button + +2. In the settings window, **double-click** the wallet version number to open developer options. + +Click on version + +3. In the **Developer options** panel, locate the **Networks** section and select **Testnet**. + +Choose Testnet + +4. The app automatically returns to the main screen, where the interface indicates that you’re now using **the Testnet version**. + + + +Choose Testnet + +_You can also check the wallet contract version in **Testnet** — the settings UI displays [the same version information](/ecosystem/wallet-apps/web#wallet-contract-version) as on Mainnet._ + +## Deploy a wallet + +A wallet must be **deployed** before use — its account state must be **active**. + +Newly created wallets have the default state **nonexist**, meaning the account has _no code, data, or balance_. + +### 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 your address into the search bar. + +Insert your address in Tonviewer search + +2. The account details will appear. In a newly created wallet, the status is **nonexist**, indicating the wallet is not deployed. + +Account status: nonexist + +### Fund the wallet + +A wallet must receive funds before deployment. + +- On Testnet, request free Testnet Toncoins from the TON Testnet Faucet. + +After receiving funds, the wallet enters the **uninit** state. This means the account has a balance, but the smart contract is not yet deployed. + +Account status: uninit + +### Send the first transaction + +With TON in the account, the wallet can be deployed. Deployment occurs when _the wallet processes its first transaction_. +In this example, we send TON to the account itself on Testnet to observe the transaction and wallet deployment on-chain. + + + +To send TON to your own account: + +1. Click **Send**, enter your wallet address in **Recipient Address**, and the **Amount** of TON. Optionally, add a comment. Click **Send TON**. + +Sending coins + +2. In the confirmation popup, verify the transaction details and click **Confirm** if correct; otherwise, **Edit**. + +Confirm transaction + +3. After confirmation, the wallet will display a notification: "Coins have been sent!" + +Notification + +Next, check your wallet status in the blockchain explorer. + +The wallet should appear as **active**. _Congratulations, you have successfully deployed your contract!_ + +Account status: active + +You will also see a "Contract Type" field indicating `v5`. +For details, see [Wallet v5](/standard/wallets/v5). diff --git a/resources/images/wallets/wallet-ton-org/active_dark.png b/resources/images/wallets/wallet-ton-org/active_dark.png new file mode 100644 index 00000000..d9508044 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/active_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/active_light.png b/resources/images/wallets/wallet-ton-org/active_light.png new file mode 100644 index 00000000..f26e5b65 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/active_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/address_nonexist_dark.png b/resources/images/wallets/wallet-ton-org/address_nonexist_dark.png new file mode 100644 index 00000000..79c5fa79 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/address_nonexist_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/address_nonexist_light.png b/resources/images/wallets/wallet-ton-org/address_nonexist_light.png new file mode 100644 index 00000000..9ea8a73e Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/address_nonexist_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/address_uninit_dark.png b/resources/images/wallets/wallet-ton-org/address_uninit_dark.png new file mode 100644 index 00000000..99ea9d7b Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/address_uninit_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/address_uninit_light.png b/resources/images/wallets/wallet-ton-org/address_uninit_light.png new file mode 100644 index 00000000..74d0cd81 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/address_uninit_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/backup_dark.png b/resources/images/wallets/wallet-ton-org/backup_dark.png new file mode 100644 index 00000000..dbd6528b Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/backup_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/backup_light.png b/resources/images/wallets/wallet-ton-org/backup_light.png new file mode 100644 index 00000000..ae2d61fe Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/backup_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/confirm_dark.png b/resources/images/wallets/wallet-ton-org/confirm_dark.png new file mode 100644 index 00000000..72f031dd Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/confirm_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/confirm_light.png b/resources/images/wallets/wallet-ton-org/confirm_light.png new file mode 100644 index 00000000..4def038d Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/confirm_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/contract_type_dark.png b/resources/images/wallets/wallet-ton-org/contract_type_dark.png new file mode 100644 index 00000000..172f707b Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/contract_type_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/contract_type_light.png b/resources/images/wallets/wallet-ton-org/contract_type_light.png new file mode 100644 index 00000000..ee170f5f Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/contract_type_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/creating_password_dark.png b/resources/images/wallets/wallet-ton-org/creating_password_dark.png new file mode 100644 index 00000000..a89eeabc Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/creating_password_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/creating_password_light.png b/resources/images/wallets/wallet-ton-org/creating_password_light.png new file mode 100644 index 00000000..a823ec0d Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/creating_password_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/notification_dark.png b/resources/images/wallets/wallet-ton-org/notification_dark.png new file mode 100644 index 00000000..a1dcc91c Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/notification_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/notification_light.png b/resources/images/wallets/wallet-ton-org/notification_light.png new file mode 100644 index 00000000..5783c7bd Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/notification_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/password_dark.png b/resources/images/wallets/wallet-ton-org/password_dark.png new file mode 100644 index 00000000..424427f8 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/password_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/password_light.png b/resources/images/wallets/wallet-ton-org/password_light.png new file mode 100644 index 00000000..b77cc3de Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/password_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/responsibility_dark.png b/resources/images/wallets/wallet-ton-org/responsibility_dark.png new file mode 100644 index 00000000..c185d56b Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/responsibility_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/responsibility_light.png b/resources/images/wallets/wallet-ton-org/responsibility_light.png new file mode 100644 index 00000000..c33fc114 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/responsibility_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/safety_dark.png b/resources/images/wallets/wallet-ton-org/safety_dark.png new file mode 100644 index 00000000..90dc82e1 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/safety_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/safety_light.png b/resources/images/wallets/wallet-ton-org/safety_light.png new file mode 100644 index 00000000..0bd8461f Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/safety_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/secret_words_dark.png b/resources/images/wallets/wallet-ton-org/secret_words_dark.png new file mode 100644 index 00000000..0baa5ad0 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/secret_words_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/secret_words_light.png b/resources/images/wallets/wallet-ton-org/secret_words_light.png new file mode 100644 index 00000000..ecc1f95b Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/secret_words_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/send_coins_dark.png b/resources/images/wallets/wallet-ton-org/send_coins_dark.png new file mode 100644 index 00000000..e0dbe2be Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/send_coins_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/send_coins_light.png b/resources/images/wallets/wallet-ton-org/send_coins_light.png new file mode 100644 index 00000000..a53f2983 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/send_coins_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/settings_dark.png b/resources/images/wallets/wallet-ton-org/settings_dark.png new file mode 100644 index 00000000..e43c96b2 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/settings_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/settings_light.png b/resources/images/wallets/wallet-ton-org/settings_light.png new file mode 100644 index 00000000..8c477736 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/settings_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/testnet_dark.png b/resources/images/wallets/wallet-ton-org/testnet_dark.png new file mode 100644 index 00000000..0476809d Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/testnet_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/testnet_light.png b/resources/images/wallets/wallet-ton-org/testnet_light.png new file mode 100644 index 00000000..3e87be3d Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/testnet_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/testnet_version_dark.png b/resources/images/wallets/wallet-ton-org/testnet_version_dark.png new file mode 100644 index 00000000..d0fe8947 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/testnet_version_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/testnet_version_light.png b/resources/images/wallets/wallet-ton-org/testnet_version_light.png new file mode 100644 index 00000000..4f06f853 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/testnet_version_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/tonviewer_dark.png b/resources/images/wallets/wallet-ton-org/tonviewer_dark.png new file mode 100644 index 00000000..e7ac3d33 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/tonviewer_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/tonviewer_light.png b/resources/images/wallets/wallet-ton-org/tonviewer_light.png new file mode 100644 index 00000000..112ee75b Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/tonviewer_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/ui_dark.png b/resources/images/wallets/wallet-ton-org/ui_dark.png new file mode 100644 index 00000000..dece6b3c Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/ui_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/ui_light.png b/resources/images/wallets/wallet-ton-org/ui_light.png new file mode 100644 index 00000000..a3366a96 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/ui_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/verify_dark.png b/resources/images/wallets/wallet-ton-org/verify_dark.png new file mode 100644 index 00000000..e6834afd Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/verify_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/verify_light.png b/resources/images/wallets/wallet-ton-org/verify_light.png new file mode 100644 index 00000000..76dcfcb4 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/verify_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/version_dark.png b/resources/images/wallets/wallet-ton-org/version_dark.png new file mode 100644 index 00000000..cd9d1084 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/version_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/version_light.png b/resources/images/wallets/wallet-ton-org/version_light.png new file mode 100644 index 00000000..ea57c3de Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/version_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/wallet_version_dark.png b/resources/images/wallets/wallet-ton-org/wallet_version_dark.png new file mode 100644 index 00000000..aff53cc5 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/wallet_version_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/wallet_version_light.png b/resources/images/wallets/wallet-ton-org/wallet_version_light.png new file mode 100644 index 00000000..cf2dd47f Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/wallet_version_light.png differ diff --git a/resources/images/wallets/wallet-ton-org/welcome_page_dark.png b/resources/images/wallets/wallet-ton-org/welcome_page_dark.png new file mode 100644 index 00000000..bac7ac59 Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/welcome_page_dark.png differ diff --git a/resources/images/wallets/wallet-ton-org/welcome_page_light.png b/resources/images/wallets/wallet-ton-org/welcome_page_light.png new file mode 100644 index 00000000..d9dfc31a Binary files /dev/null and b/resources/images/wallets/wallet-ton-org/welcome_page_light.png differ