Wallet v4 vs v5

Что изменилось между wallet v4 и v5 в TON: plugins, extensions, gas и когда мигрировать.

Wallet v4 vs v5 — коротко

Для новых интеграций ориентируйся на W5 (wallet v5): единый стандарт с extensions, удобнее для batch и TON Connect. v4 остаётся массовым легаси в существующих кошельках — поддерживать оба opcode/payload нужно, пока аудитория на v4 не уйдёт.

Таблица сравнения

Параметр	Wallet v4R2	Wallet v5 (W5)
Статус	Широко развёрнут, легаси	Актуальный стандарт кошельков
Расширяемость	Plugins (ограниченная модель)	Extensions (более гибкая)
Подпись / auth	seqno + subwallet_id	Обновлённая схема, в т.ч. extension auth
Batch	Ограниченный список out messages	Лучше подходит для нескольких действий
TON Connect	Работает	Предпочтительный путь в новых клиентах
Адрес	Другой code/data → другой адрес	Не «апгрейд на месте»: новый деплой

Когда оставаться на v4

У пользователя уже задеплоен v4 с балансом и историей — «переезд» = новый адрес + перевод средств
Твой бэкенд шлёт только проверенные v4 payloads и нет ресурса на dual-support сразу
Тестируешь против конкретного кошелька, который ещё на v4

Когда брать v5

Новый продукт / Mini App, нет установленной базы адресов
Нужны extensions и более предсказуемая модель прав
Хочешь меньше трения с актуальными версиями Tonkeeper и TON Connect

Пример: разные контракты — разные адреса

typescript

// @ton/ton ^15, @ton/core ^0.27
import { WalletContractV4, WalletContractV5R1 } from "@ton/ton";
import { mnemonicToPrivateKey } from "@ton/crypto";

const key = await mnemonicToPrivateKey(mnemonic.split(" "));

const v4 = WalletContractV4.create({ workchain: 0, publicKey: key.publicKey });
const v5 = WalletContractV5R1.create({
  workchain: 0,
  publicKey: key.publicKey,
});

// Один mnemonic → разные адреса. Это не «обновление», а другой контракт.
console.log(v4.address.toString());
console.log(v5.address.toString());

В коде интеграции всегда определяй версию кошелька по подключению (TON Connect), а не предполагай v4 «по умолчанию навсегда».

Материалы gramdocs.tech носят образовательный характер и не являются финансовой, юридической или инвестиционной рекомендацией. Работа с блокчейном TON и токеном Gram связана с рисками потери средств. Правовая информация