Инструменты экосистемы TON

Инструменты разработчика — это ваша мастерская. Как плотник не начнёт работу без проверенного набора инструментов, так и блокчейн-разработчик должен знать свои рабочие инструменты до начала написания кода. Освоение Tonkeeper, Tonviewer и Blueprint до написания первого контракта позволит сосредоточиться на логике, а не на борьбе с инфраструктурой.

Перед тем как погрузиться в архитектуру и разработку на TON, познакомимся с основными инструментами, которые будут использоваться на протяжении всего курса.

Tonkeeper — основной кошелек TON

Tonkeeper — это самый популярный кошелек для блокчейна TON. Он доступен как мобильное приложение и расширение для браузера.

Возможности Tonkeeper

• Отправка и получение TON и Jetton-токенов
• Взаимодействие со смарт-контрактами
• Подключение к dApps через TON Connect
• Просмотр NFT и коллекций
• Встроенный браузер для DeFi-приложений

Установка

1. Мобильное приложение: скачайте из App Store или Google Play по запросу “Tonkeeper”
2. Расширение браузера: установите из Chrome Web Store или Firefox Add-ons

Переключение на testnet

Работа в testnet позволяет экспериментировать без риска потери реальных средств:

1. Откройте Tonkeeper
2. Перейдите в Настройки
3. Нажмите на версию приложения 5 раз подряд — откроется режим разработчика
4. Включите Developer Mode
5. Выберите Testnet в качестве сети

Tonviewer — блок-эксплорер TON

Tonviewer (tonviewer.com) — это основной блок-эксплорер для блокчейна TON. Он позволяет исследовать все, что происходит в сети.

Что можно посмотреть в Tonviewer

• Адреса — баланс, историю транзакций, связанные контракты
• Транзакции — детали каждой транзакции, сообщения, комиссии
• Смарт-контракты — код, данные, методы get
• Блоки — информацию о блоках мастерчейна и воркчейнов
• Токены — Jetton-балансы и трансферы

Как использовать

1. Откройте tonviewer.com
2. Вставьте адрес кошелька или контракта в строку поиска
3. Изучайте историю транзакций, баланс и состояние контракта

Полезные функции для разработчиков

• Вкладка “Methods” — вызов get-методов контракта прямо в браузере
• Вкладка “Code” — просмотр скомпилированного кода контракта
• Trace — визуализация цепочки сообщений между контрактами (особенно полезно для отладки)

TON Web IDE — среда разработки в браузере

TON Web IDE — это браузерная среда разработки, которая позволяет писать, компилировать и тестировать смарт-контракты без установки локальных инструментов.

Возможности

• Написание контрактов на Tact и FunC/Tolk
• Компиляция прямо в браузере
• Развертывание контрактов в testnet
• Встроенный отладчик
• Шаблоны для типичных контрактов

Когда использовать

TON Web IDE идеально подходит для:

• Быстрого прототипирования идей
• Изучения языка (не нужно настраивать окружение)
• Экспериментов с небольшими контрактами

Blueprint — CLI-инструментарий для Tact

Blueprint — это набор инструментов командной строки для полноценной разработки смарт-контрактов на Tact. Это аналог Hardhat/Foundry из мира Ethereum.

Возможности Blueprint

• Создание проектов — генерация структуры проекта по шаблону
• Компиляция — сборка контрактов Tact в байт-код TVM
• Тестирование — запуск unit-тестов с эмуляцией блокчейна
• Деплой — развертывание контрактов в testnet/mainnet
• Скрипты — автоматизация взаимодействия с контрактами

Установка

npm create ton@latest

Эта команда создаст новый проект с уже настроенной структурой, зависимостями и примером контракта.

Структура проекта Blueprint

my-project/
  contracts/        -- исходный код контрактов (Tact)
  tests/            -- тесты (Jest + @ton/sandbox)
  scripts/          -- скрипты деплоя и взаимодействия
  wrappers/         -- TypeScript-обертки для контрактов

Tolk — язык для компиляции в браузере

Tolk — это новый язык программирования для TON, синтаксически близкий к FunC, но с более современным синтаксисом. Его главная особенность — возможность компиляции прямо в браузере через WebAssembly.

Зачем нужен Tolk

• Компиляция в браузере — не нужно устанавливать компилятор локально
• Современный синтаксис — привычный для разработчиков, знакомых с TypeScript/Kotlin
• Совместимость с FunC — компилируется в тот же байт-код TVM

Сводная таблица инструментов

Что дальше?

Теперь у вас есть представление об основных инструментах экосистемы TON. В следующих модулях мы будем использовать их на практике:

• M01: Tonviewer для исследования архитектуры TON
• M03: Blueprint и TON Web IDE для написания первых контрактов на Tact
• M04: Tolk и TON Web IDE для знакомства с FunC-стилем
• M07: Tonkeeper для подключения к dApps через TON Connect

Частые ошибки

1. Используют mainnet вместо testnet при тестировании, в результате теряя реальные Toncoin на экспериментах.
2. Не добавляют тестнет-сеть в Tonkeeper и потом не понимают, почему тестовые транзакции не отображаются в кошельке.
3. Игнорируют Tonviewer при отладке и пытаются дебажить транзакции «вслепую», не анализируя трассировку сообщений.
4. Устанавливают устаревшую версию Blueprint через npm и получают несовместимость с актуальными шаблонами контрактов.