Blueprint: создание нового проекта

Создашь Blueprint-проект через npm create ton, выберешь шаблон Tact/FunC и проверишь сборку.

Что такое Blueprint

Blueprint — TypeScript-окружение для контрактов на TON: шаблон проекта, компиляция, тесты в Sandbox и деплой. На момент публикации входная точка — create-ton@0.34.0 (подтянет актуальный @ton/blueprint).

Создаём проект

Нужен Node.js 22+ (установка окружения).

Интерактивно:

bash

# create-ton 0.34.x → @ton/blueprint
npm create ton@latest

Без вопросов — сразу Counter на Tact:

bash

npm create ton@latest -- simple-counter --type tact-counter --contractName SimpleCounter
cd simple-counter
npm install

Типы шаблонов: tact-counter, tact-empty, func-counter, func-empty, tolk-counter, tolk-empty.

Проверка:

bash

npx blueprint build
npm test

Ожидаешь успешную компиляцию и зелёные тесты из шаблона.

Структура каталогов

text

simple-counter/
├── contracts/          # исходники .tact / .fc
├── wrappers/           # TypeScript-классы для вызовов
├── tests/              # Jest + @ton/sandbox
├── scripts/            # деплой и сценарии
├── build/              # артефакты после blueprint build
├── package.json
└── tsconfig.json

Как это работает

npm create ton@latest — скачивает create-ton, генерирует файлы под выбранный язык.
npx blueprint build — компилирует контракт (Tact → BoC или FunC через func-js) и обновляет wrappers.
npm test — поднимает локальный Blockchain из @ton/sandbox, без testnet/mainnet.
npx blueprint run — интерактивные скрипты из scripts/ (в том числе деплой).

Добавить ещё один контракт в существующий проект:

bash

npx blueprint create MyContract --type tact-empty

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

Запускаешь blueprint не из корня проекта → «command not found» или чужой package.json. Сначала cd в каталог с package.json.

Пропускаешь npm install → нет локального @ton/blueprint. Установи зависимости, затем npx blueprint build.

Путаешь шаблон FunC и Tact → разные расширения и wrappers. Для старта бери tact-counter, если не учишь FunC специально.

Что дальше

Tact CLI: установка и первая компиляция — компилятор отдельно от Blueprint
TON Sandbox: локальное тестирование — как устроены тесты без сети
Первый смарт-контракт: Counter на Tact — разбор контракта из шаблона

Материалы gramdocs.tech носят образовательный характер и не являются финансовой, юридической или инвестиционной рекомендацией. Работа с блокчейном TON и токеном Gram связана с рисками потери средств. Правовая информация