Раньше создание токена в TON требовало десятков строк кода и часов отладки — теперь это делается за 5 шагов с jetton ton. Но простота инструмента обманчива: без учёта специфики TON даже опытные разработчики сталкиваются с неочевидными ошибками. Один пропущенный параметр — и деплой падает, токен не отображается в кошельке, а вы тратите часы на поиск причины. Эта инструкция разбирает подводные камни, которые упускают 90% тех, кто уже работал с этим стандартом.
3 параметра, которые нужно определить до генерации
Первый шаг — не код, а чёткое понимание архитектуры. Три критических параметра:
- Тип токена: валютный (FT) или NFT. Для NFT потребуется кастомизация смарт-контракта — например, добавление уникальных идентификаторов в metadata. Например, если вы создаёте NFT для цифрового искусства, важно учесть такие параметры, как размер изображения (в байтах) и формат (PNG, JPG), так как это может повлиять на структуру данных в блокчейне.
- Логика работы смарт-контракта. Будет ли он обрабатывать массовые транзакции? Нужны ли callback-функции? Эти нюансы влияют на выбор шаблона в jetton ton. Например, для токена с функцией аирдропа потребуется поддержка массовых операций, что увеличивает сложность смарт-контракта и расходы на газ.
- Политика mint/burn. Если токен децентрализован, кто имеет права на эмиссию? Пропишите правила до запуска — изменение логики после деплоя потребует миграции. Пример: разработчик создал FT-токен, но забыл ограничить mint — через неделю атакующий заминтил 10M монет.
Пример: разработчик создал FT-токен, но забыл ограничить mint — через неделю атакующий заминтил 10M монет. Также важно учитывать, что неправильно настроенная политика burn может привести к утечке токенов на заблокированные адреса, что делает их недоступными для дальнейшего использования.
Почему деплой падает на 4-м шаге
Типичные сценарии, когда транзакция идёт в отвал:
- Ошибки в настройке газа. Минимальный лимит для деплоя — 0.25 TON, но при сложной логике контракта нужно 0.4-0.5 TON. Например, если ваш контракт включает сложные математические операции или взаимодействует с другими контрактами, расход газа может резко увеличиться.
- Неправильные параметры инициализации. jetton ton генерирует шаблон, но если в metadata URI указан несуществующий IPFS-хэш — кошелёк не распознает токен. Например, если URI содержит ошибку в написании (например, пропущен символ), токен не будет отображаться в кошельке, даже если всё остальное настроено правильно.
- Проблемы с совместимостью кошелька. Некоторые версии TonConnect не поддерживают кастомные Jetton Wallets — проверьте документацию. Например, если вы используете старую версию TonConnect, ваш токен может не отображаться в кошельке, даже если контракт работает корректно.
Популярное мнение: «Ошибка в TVM означает баг в коде». На практике 70% фейлов — это неверные входные данные. Например, неправильный формат данных в metadata или недостаточный лимит газа могут привести к сбою деплоя, даже если код смарт-контракта идеален.
Как избежать 500 строк boilerplate-кода
Шаблонизация — ваше спасение:
- Используйте готовые контракты из репозиториев TON Blockchain — достаточно заменить 10-15 строк в стандартных функциях transfer и mint. Например, для токена с функцией выплаты дивидендов можно использовать готовый шаблон и добавить только одну функцию для расчёта выплат.
- Кастомизируйте только то, что отличается от MVP. Не переписывайте базовую логику хранения балансов в FunC. Например, если ваш токен отличается только названием и символом, нет необходимости изменять логику работы с балансами.
- Автоматизируйте генерацию интерфейсов. CLI-инструмент jetton ton создаёт ABI-файлы для взаимодействия с контрактом — это экономит 2-3 часа ручной работы. Например, если вам нужно создать интерфейс для взаимодействия с контрактом, CLI автоматически сгенерирует ABI-файл, что упрощает процесс разработки.
Пример: для токена с выплатой дивидендов достаточно добавить одну функцию, а не создавать контракт с нуля. Также важно отметить, что использование шаблонов позволяет избежать ошибок в базовой логике контракта, таких как неправильное хранение балансов или некорректная обработка транзакций.
Что делать, если токен не отображается в кошельке
Пошаговая диагностика:
- Проверьте metadata-контракт. Убедитесь, что поля name, symbol и decimals передаются корректно. Ошибка в типе данных (например, string вместо int) — частая причина. Например, если поле decimals содержит строку вместо числа, токен не будет отображаться в кошельке.
- Добавьте токен вручную. В Tonkeeper зайдите в «Управление активами» → «Добавить токен» → Вставьте адрес Jetton Wallet. Например, если токен не отображается автоматически, добавление его вручную может решить проблему.
- Исправьте URI схему. Web-интерфейс jetton ton иногда обрезает «https://» в metadata — допишите протокол вручную. Например, если URI содержит только IPFS-хэш, добавление «https://» перед хэшем может исправить проблему.
Важно: если контракт деплоился успешно, но токен «невидим» — проблема 99% в metadata. Также стоит проверить, что все поля metadata соответствуют стандартам Jetton, включая правильный формат данных и отсутствие ошибок в написании.
Простота интерфейса — но сложность отладки
Инструмент даёт удобный UI, но логирование остаётся на вас:
- Включите подробное логирование транзакций в тестовой сети TON — ищите ошибки типа «exit code 7» (недостаточно газа). Например, если ваша транзакция завершается с ошибкой «exit code 7», увеличьте лимит газа и повторите попытку.
- Тестируйте в sandbox. Используйте testnet.ton.org, чтобы не терять реальные TON на ошибках. Например, если вы тестируете сложный контракт, sandbox позволяет проверить его работоспособность без риска потери средств.
- Интерпретируйте ошибки TVM. Код 32 означает несоответствие типов, 34 — переполнение стека. Держите под рукой справочник. Например, если ваша транзакция завершается с ошибкой «exit code 32», проверьте типы данных в контракте.
Пример: токен с неправильным metadata не отображается даже при успешном деплое — но лог покажет «invalid opcode». Также важно учитывать, что логирование может выявить ошибки в логике контракта, такие как некорректная обработка данных или недостаточный лимит газа.
Jetton CLI vs Web-интерфейс: когда что выбрать
Сравним два подхода:
- CLI — для сложных сценариев. Плюсы: полный контроль, возможность интеграции в CI/CD. Минусы: требует знаний FunC. Например, если вам нужно создать токен с сложной логикой, CLI позволяет полностью контролировать процесс разработки и тестирования.
- Web-интерфейс — для быстрого прототипирования. Плюсы: визуальный конструктор, мгновенный деплой. Минусы: интерфейс иногда «забывает» настройки при обновлении страницы. Например, если вам нужно быстро создать MVP токена, Web-интерфейс позволяет сделать это за считанные минуты.
Выбор зависит от задачи. CLI — для продакшена, Web — для MVP за 15 минут. Учитывайте, что оба инструмента используют jetton ton под капотом. Также важно отметить, что CLI позволяет автоматизировать процесс разработки и тестирования, что особенно полезно для крупных проектов.
Создание токена теперь занимает минуты вместо часов — если знать нюансы. Осталось только выбрать правильный инструмент и проверить metadata. Среди заметных примеров использования технологии можно выделить jetton казино, где токены применяются для внутренних операций.