Testnet vs mainnet TON

Отличия testnet и mainnet TON для разработчика: сеть, адреса, токены и как не перепутать окружения.

Testnet vs mainnet TON — коротко

Весь цикл разработки и CI — на testnet; mainnet только после проверки деплоя, get-методов и реальных сообщений. Сети не совместимы: другие global id, другие адреса контрактов, отдельные faucet-токены. Один и тот же mnemonic даёт адреса в обеих сетях, но состояние и балансы не общие.

Таблица сравнения

Параметр	Testnet	Mainnet
Назначение	Разработка, e2e, демо	Реальные средства
TON	Бесплатный faucet	Реальная ценность
Адреса контрактов	Свои деплои / тестовые	Прод-адреса
RPC / API	testnet endpoints	mainnet endpoints
Индексаторы	Отдельные (TonAPI testnet и т.п.)	Прод-индексы
Риск ошибки	Низкий (время)	Потеря средств

Когда сидеть на testnet

Пишешь и гоняешь Blueprint / sandbox + сетевые e2e
Крутишь jetton transfer, NFT mint, TON Connect без реальных денег
Проверяешь bounce, gas, seqno, expired messages

Когда mainnet

Контракт прогнан на testnet с тем же bytecode (с учётом init-данных)
В конфиге явно разделены MAINNET_* / TESTNET_* endpoints и адреса
Есть мониторинг и лимиты на суммы в первые дни

Пример: явный выбор сети

typescript

// @ton/ton ^15
import { TonClient } from "@ton/ton";

const isMainnet = process.env.TON_NETWORK === "mainnet";

const client = new TonClient({
  endpoint: isMainnet
    ? "https://toncenter.com/api/v2/jsonRPC"
    : "https://testnet.toncenter.com/api/v2/jsonRPC",
  apiKey: process.env.TONCENTER_API_KEY,
});

// Адреса master/jetton/router — тоже разные. Не подставляй mainnet-адрес в testnet-клиент.
const jettonMaster = isMainnet
  ? process.env.JETTON_MASTER_MAINNET!
  : process.env.JETTON_MASTER_TESTNET!;

Чеклист перед «переключил env на mainnet»: endpoint, api key, адреса контрактов, TON Connect manifest/ton_proof domain, и что в UI больше нет faucet-кнопки.

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