Blueprint

Blueprint — официальный фреймворк для разработчиков смарт-контрактов TON, поддерживаемый командой ton-org. По смыслу это аналог Hardhat или Foundry в мире Ethereum: единая обвязка для написания контракта, прогона тестов в локальной виртуальной машине и публикации в основную или тестовую сеть.

Зачем нужен

До появления Blueprint типичный пайплайн разработки контракта на TON собирался руками: отдельно компилятор FunC, отдельно скрипты для деплоя, отдельно сторонний раннер тестов. Это работало, но требовало много шаблонного кода и плохо поддерживалось новичками. Blueprint собирает эти этапы в один CLI и предлагает структуру проекта по умолчанию: папки contracts, wrappers, tests, scripts.

Как работает

Под капотом Blueprint опирается на несколько компонентов экосистемы:

• Компиляторы FunC и Tact — оба языка контрактов TON поддерживаются из коробки, переключение задаётся в конфиге проекта.
• TypeScript-обёртки контракта — в папке wrappers лежит класс, экспонирующий методы контракта в типобезопасный JS-API. Команда npx blueprint create генерирует обёртку автоматически.
• Sandbox — отдельный пакет @ton/sandbox, эмулирующий TVM в памяти процесса. Тесты выполняются мгновенно, без поднятия локальной ноды.
• Scripts — TypeScript-скрипты деплоя и взаимодействия. Запускаются командой npx blueprint run и могут подключаться к Tonkeeper или другому кошельку через TON Connect для подписи транзакций деплоя.

Что входит в стандартный workflow

Типовой цикл выглядит так: разработчик правит контракт в contracts/MyContract.fc, обновляет обёртку, описывает тест-сценарий в tests/MyContract.spec.ts. Запуск npx blueprint test поднимает sandbox, разворачивает контракт во временной среде и проверяет ожидаемые сообщения и стейт. Когда всё зелёное — npx blueprint run deployMyContract отправляет реальную транзакцию деплоя в указанную сеть.

Применение

Blueprint используется в большинстве туториалов TON Foundation, в обучающих курсах TON Hello World, а также внутри команд DeFi-протоколов и NFT-маркетплейсов на TON. Он стал де-факто стандартом для open-source-репозиториев контрактов: типичный README проекта на TON начинается со строчки «склонируйте репозиторий, поставьте зависимости и запустите npx blueprint test».

Ограничения

Blueprint — это инструмент разработчика, а не среда выполнения, и он не заменяет валидаторскую инфраструктуру. Sandbox-эмуляция TVM очень близка к реальной, но не на сто процентов идентична: некоторые edge-кейсы по газу и нестандартные конфиги шардов воспроизводятся только на тестнете. Перед мейннет-деплоем серьёзный проект всегда проходит через тестнетную проверку и аудит, даже если sandbox-тесты зелёные.

Несмотря на это, Blueprint остаётся быстрейшим способом начать писать контракты на TON: новый разработчик за один вечер получает рабочий пайплайн «контракт — тест — деплой» без необходимости разбираться в низкоуровневых деталях ADNL и lite-сервера.