Skip to main content
T TON Adoption
← Glossary
NODE/03 · Term

Wallet V3

Classic third-generation TON wallet contract. Supports seqno, time-bound validity, and up to four outgoing messages per external message.

Aliases: wallet v3, w3, v3r2

Wallet V3 (often wallet-v3 or v3r2) is the classic third-generation TON wallet contract, the default for most wallets for years. It’s a minimal but solid contract: sign the message with the private key, verify seqno, dispatch up to four outgoing messages.

What it does

  • Signature + seqno. Every external message is signed; the contract checks the public key and increments seqno (replay protection).
  • Time-bound validity. Each message carries a valid_until timestamp. Externals received past that time are rejected — limiting the chance that a request stuck in mempool fires an hour late.
  • Subwallet ID. A parameter that lets one private key derive multiple distinct wallet contracts (different subwallet_id → different addresses). Useful for cold/hot copies.

What it doesn’t

Compared to newer versions, V3 lacks:

  • Plugins. Can’t sign a single message that pulls a recurring fee — that’s v4.
  • Gasless via extensions. That’s v5.
  • Mini-app nonce schemes. Solved separately in v5.

Where you find it

  • Older wallets. Tonkeeper and MyTonWallet created v3r2 by default before 2023.
  • Hardware wallets. Ledger TON-app often works with v3 as the most battle-tested option.
  • Custodial services. Exchanges and bots holding TON like v3 for simplicity and predictable gas.

Should you still use it?

Creating a new wallet on v3 in 2026 is outdated — v4/v5 give you plugins and richer flows. But millions of existing v3 contracts keep working fine — there’s no expiry. Many cold-storage setups deliberately stay on v3: smaller surface area, fewer potential bugs.

Related terms