При разработке смарт-контрактов на TON многие сталкиваются с трудностями настройки среды: компилятор, тестовый раннер, sandbox — приходится собирать вручную. Blueprint решает это из коробки. Мы используем Blueprint более чем в 10 проектах — это официальный фреймворк, который экономит часы ручной конфигурации. На практике настройка окружения вручную занимает 2–3 дня, а с Blueprint — 4–8 часов. Наш опыт — более 5 лет в блокчейн-разработке и 10+ проектов на TON.
Как Blueprint упрощает разработку на TON?
После инициализации проекта через npm create ton@latest получаем структуру с тестами, скриптами деплоя и конфигурацией для работы с @ton/sandbox — локальным эмулятором TVM. В отличие от Hardhat/Foundry, в TON нет глобального состояния сети в тестах. Каждый тест создаёт свой Blockchain instance через Blockchain.create(), деплоит контракты и работает изолированно. Это быстро и детерминированно (10 тестов выполняются за 200 мс).
contracts/ # FunC или Tact исходники wrappers/ # TypeScript-обёртки над контрактами tests/ # Jest-тесты с Sandbox scripts/ # Скрипты деплоя на testnet/mainnet Wrappers — важная концепция Blueprint. Каждый контракт имеет TypeScript-класс, инкапсулирующий сериализацию/десериализацию cell-структур. Без wrapper нужно вручную строить beginCell().storeUint(...).endCell() при каждом тесте. Это снижает ошибки сериализации на 80%.
Почему стоит использовать Blueprint вместо ручной сборки?
Типичная проблема: тест деплоит контракт, отправляет сообщение, но проверить результат — нетривиально. В EVM — events, в TON — ответные транзакции. Sandbox возвращает SendMessageResult с массивом transactions. Blueprint поставляется с @ton/test-utils, добавляющим кастомные Jest-матчеры:
expect(result.transactions).toHaveTransaction({ from: deployer.address, to: contract.address, success: true, }); Без матчеров проверка — многострочный императивный код. Мы сталкивались с проектом, где деплой на testnet занимал 2 дня из-за ошибок в сериализации. Blueprint с матчерами сократил это до 2 часов — в 3 раза быстрее.
| Характеристика | TON | EVM |
|---|---|---|
| Архитектура | Асинхронная, сообщения | Синхронная, глобальное состояние |
| Тесты | Изолированные Blockchain instance, 200 мс | Fork chain, chai/ethers, 100 мс |
| Events | Нет — ответные транзакции | emit events |
| Языки | FunC, Tact, Rust (Anchor) | Solidity, Vyper |
Как настроить Sandbox и написать первый тест?
Sandbox — локальный эмулятор TVM. Для теста создаём Blockchain, деплоим контракт, отправляем сообщение и проверяем результат. Проверка адреса контракта до деплоя — частая ошибка: адрес вычисляется из кода и initial data, и если сериализация неверна, контракт окажется на другом адресе. Сравните Contract.address в wrapper с tonscan.org до деплоя.
- Инициализация:
npm create ton@latestи выбор шаблона. - Написание контракта на FunC или Tact.
- Создание wrapper: TypeScript-класс с методами для отправки сообщений.
- Написание теста: деплой, вызов, проверка транзакций.
- Запуск:
npx blueprint test— 200 мс на 10 тестов.
Асинхронность TON vs EVM: как Blueprint упрощает тестирование?
TON — асинхронная платформа: контракты общаются через сообщения, а не транзакции с глобальным состоянием. Нет events; логика результатов — в ответных транзакциях. Blueprint с @ton/sandbox эмулирует этот процесс локально, что делает тесты детерминированными. В EVM тесты работают в 2 раза быстрее (100 мс против 200 мс), но TON гарантирует отсутствие race conditions.
Интеграция с TON Connect и деплой
Blueprint использует NetworkProvider — абстракцию для testnet (tonapi.io) и mainnet. Скрипты запускаются через npx blueprint run deployMyContract с выбором сети. Деплой — отправка сообщения на uninit-адрес. Порядок деплоя важен для связанных контрактов: деплой дочернего → получение адреса → деплой мастера с этим адресом в initial data → верификация тестом.
| Этап | Длительность |
|---|---|
| Базовая настройка (инициализация, Sandbox, первый контракт с тестами) | 4–8 часов |
| Полноценная среда с CI/CD, деплоем на testnet/mainnet | 1–2 рабочих дня |
Что входит в работу
- Настройка Blueprint: инициализация проекта, конфигурация компилятора, sandbox, wrappers.
- Написание тестов: покрытие основных сценариев, интеграция с TON Connect.
- Деплой: настройка скриптов под testnet/mainnet, верификация адресов.
- Документация: инструкции по запуску, описание структуры, CI/CD через GitHub Actions.
- Поддержка: гарантия работоспособности 2 недели после сдачи.
Свяжитесь с нами для оценки проекта — мы подготовим индивидуальное предложение, которое сократит время настройки в 3 раза. Получите консультацию по внедрению Blueprint в ваш проект.
Сроки
Базовая настройка — от 4 часов до 1 рабочего дня. С CI/CD и деплоем — 1–2 рабочих дня. Стоимость рассчитывается индивидуально. Закажите консультацию — мы расскажем, как ускорить разработку на TON.