К основному содержанию
T TON Adoption
← Словарь
NODE/03 · Term

Версия кошелька

Версия смарт-контракта кошелька в TON. От кода контракта (v3R2, v4R2, v5R1/W5) зависит адрес и набор фич — апгрейд почти всегда означает смену адреса.

Синонимы: v3r2, v4r2, v5r1, w5, версия wallet-контракта

Версия кошелька — это конкретная редакция смарт-контракта, который и есть «кошелёк» в TON. В отличие от EVM-сетей, где кошелёк — просто пара ключей, а адрес выводится из публичного ключа, в TON у каждого пользователя на блокчейне развёрнут собственный контракт. Какой код развёрнут — определяет и набор возможностей, и сам адрес.

Почему адрес зависит от версии

Адрес контракта в TON вычисляется как хэш от его initial state, в который входит код контракта и начальные данные (включая публичный ключ владельца). Меняется код — меняется хэш — меняется адрес. Это ключевое отличие от Ethereum и причина, по которой апгрейд кошелька с v4R2 на v5R1 даёт пользователю новый адрес для того же seed-фразы.

Основные версии в проде

  • v3R2 — базовый кошелёк, активно использовался до 2022. Поддерживает простые переводы Toncoin и сообщения произвольным контрактам. Минимум логики, минимум gas. До сих пор встречается у пользователей, которые завели кошелёк рано и не апгрейдились.
  • v4R2 — добавлена поддержка plugins и подписок: контракт может хранить список под-контрактов, которым разрешено снимать средства по расписанию. На практике массово plugins не выстрелили, но v4R2 несколько лет был дефолтом в Tonkeeper и других кошельках.
  • v5R1 / W5 — релиз 2024 года, текущий дефолт большинства кошельков. Главные отличия:
    • Gasless transfers — комиссию за перевод jetton можно платить самим jetton-ом (например, USDT), а не Toncoin. Это закрывает классическую проблему «у меня есть USDT, но нет TON на газ».
    • Batched messages — до 255 исходящих сообщений в одной транзакции против 4 в v4. Удобно для airdrop-рассылок и сложных DeFi-операций в одном клике.
    • Расширения (extensions) — более гибкая модель плагинов.

Существуют также Highload Wallet (отдельная серия для бирж и сервисов с высокой пропускной способностью) и Multisig — это уже отдельные семейства контрактов, а не «следующие версии» обычного кошелька.

UX-проблема апгрейда

Поскольку адрес меняется при смене версии, кошельки обычно показывают пользователю сразу несколько адресов под одним seed: «v4R2 балансом 0 TON», «v5R1 балансом 12 TON». При апгрейде нужно вручную перевести средства со старого адреса на новый и помнить, что входящие на старый адрес продолжат приходить, пока контрагенты не обновят запись.

Tonkeeper, MyTonWallet и Tonhub поддерживают все актуальные версии и позволяют переключаться между ними в настройках. Новые установки обычно сразу создают v5R1/W5.

Когда какая версия имеет смысл

  • Обычный пользователь — v5R1/W5, дефолт.
  • Сервис-биржа с тысячами выводов в час — Highload Wallet.
  • Команда из нескольких человек, которой нужно совместное согласование транзакций — Multisig.
  • Старые v3R2/v4R2 имеет смысл апгрейдить, особенно если хочется gasless-переводов USDT.

См. также