gramdocs.tech
Документация

Установка окружения для разработки на TON

Поставишь Node.js LTS, проверишь npm и подготовишь машину к Blueprint, Tact и FunC.

Что нужно для разработки на TON

Стек контрактов и тестов на TON — это Node.js + TypeScript. Компиляторы Tact и FunC, Blueprint и Sandbox ставятся как npm-пакеты; отдельный «TON SDK installer» не нужен.

На момент публикации: Node.js 22 LTS (минимум 18), npm 10+.

Ставим Node.js

macOS / Linux — через nvm или официальный установщик с nodejs.org:

bash
# nvm — удобно переключать версии
nvm install 22
nvm use 22

node -v   # v22.x.x
npm -v    # 10.x.x

Windows — поставь Node.js 22 LTS с nodejs.org. Для нативного func/fift позже удобнее WSL2 (Ubuntu); для Blueprint + Tact хватает обычного Windows.

Проверка после установки:

bash
node -v
npm -v

Если node не находится — переоткрой терминал или проверь, что путь к Node добавлен в PATH.

Редактор и расширения

Достаточно VS Code / Cursor с подсветкой TypeScript. Для Tact поставь расширение Tact Language (официальное от tact-lang) — автодополнение и диагностика в .tact.

Отдельно ставить Rust, Solidity-компилятор или Docker для старта не нужно.

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

  • Node.js — рантайм для CLI (blueprint, tact), тестов Jest и скриптов деплоя.
  • npm — ставит @ton/blueprint, @tact-lang/compiler, @ton/sandbox, @ton/core.
  • TypeScript — язык врапперов и тестов; в шаблонах Blueprint уже настроен tsconfig.json.

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

Node 16 или старше 18, но без LTS → странные ошибки WASM/компилятора. Поставь 22 и переоткрой терминал.

Ставишь пакеты глобально «на всякий случай» → версии разъезжаются с проектом. Зависимости держи в package.json проекта; глобально достаточно node/npm.

На Windows ждёшь нативный func без WSL → для FunC через Blueprint используй @ton-community/func-js (WASM). Нативный бинарник — отдельный путь, см. FunC CLI.

Что дальше

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