Wallet Standards in TON

Q: Wallet Standards in TON

Every wallet in the TON blockchain is a smart contract deployed on-chain. As the blockchain evolved, wallet smart contracts were updated to add new capabilities and security improvements — resulting in a series of versioned standards. Each version is a different contract, which is why the same seed phrase produces different wallet addresses depending on which version is active.

Why are there different wallet standards?

Every wallet in the TON blockchain is a smart contract deployed on-chain. As the blockchain evolved, wallet smart contracts were updated to add new capabilities and security improvements — resulting in a series of versioned standards. Each version is a different contract, which is why the same seed phrase produces different wallet addresses depending on which version is active.

The wallet standard history in TON runs from V1 to V5 (branded as W5). Full technical specifications for each version are in the TON blockchain documentation.

TON wallet versions at a glance

Version	Notes
V1R1, V1R2, V1R3	Original wallet contracts. Very limited — no support for multiple signatures or queries. Rarely used today.
V2R1, V2R2	Added expiration time for transactions. Still limited relative to later versions.
V3R1, V3R2	Added subwallet IDs — allowing multiple wallet addresses from a single key pair. V3R2 is the most widely deployed version historically. Tonkeeper supports from V3R1 onwards.
V4R2	Added plugin support, enabling subscription payments and recurring charges. Widely used on mobile.
W5 (V5)	Current default in Tonkeeper. Supports on-chain two-factor authentication, gasless transactions, and improved efficiency. Introduced by Tonkeeper in 2024.

How to access all wallet standards in Tonkeeper

All new wallets created in Tonkeeper use W5 by default. If you need to access funds in an older wallet version:

Desktop or Web Tonkeeper: go to Settings → Active address and add the wallet version you need.
Mobile Tonkeeper: only V4R2 is available in addition to W5. Go to Settings → Wallet V4R2 to access it.

📌 Note: Tonkeeper supports wallet versions starting from V3R1. Earlier versions (V1, V2) are not supported. If you have funds in a V1 or V2 wallet from the early TON ecosystem, you will need to use a different TON wallet application that supports those versions.