Workchains и шардинг: masterchain vs basechain

Как TON делится на workchain'ы и шарды: masterchain (−1), basechain (0) и зачем это масштабирование.

Workchains и шарды

TON масштабируется горизонтально: сеть делится на workchain'ы, а те — на shardchain'ы (шарды). Большинство пользовательских контрактов и кошельков живут в basechain (workchain 0). Служебная «шина» сети — masterchain (workchain −1).

Адрес всегда включает номер workchain: -1:... или 0:....


Masterchain vs basechain

Masterchain (−1)Basechain (0)
РольКонфиг сети, валидаторы, привязка шардовОбычные кошельки, DeFi, jetton, NFT
НагрузкаСлужебнаяОсновной пользовательский трафик
ПримерКонтракты системной конфигурацииТвой кошелёк и dApp-контракты

Шарды basechain могут делитьсяться и сливаться под нагрузкой. Для разработчика приложения это почти прозрачно: ты работаешь с адресом и сообщениями, маршрутизацию делает сеть.

typescript
// @ton/core ^0.59.0
import { Address } from "@ton/core";

const wallet = Address.parse(
  "EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N",
);
console.log(wallet.workChain); // 0 — basechain

const master = Address.parse(
  "-1:3333333333333333333333333333333333333333333333333333333333333333",
);
console.log(master.workChain); // -1 — masterchain

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

  1. Транзакции исполняются внутри шардчейна аккаунта.
  2. Сообщение на адрес в другом шарде уходит через механизм маршрутизации TON.
  3. Masterchain фиксирует состояние шардов и параметры сети (config).
  4. Адреса с разными workChain не «переезжают» автоматически — workchain часть идентичности аккаунта.

На практике 99% dApp-разработки — это workchain 0. Masterchain нужен, когда читаешь конфиг сети или системные контракты.


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

Игнорировать workchain при сравнении адресов → один и тот же хеш в −1 и 0 — разные аккаунты.

Ждать мгновенного кросс-шард эффекта → доставка сообщения в другой шард асинхронна; проектируй контракты под сообщения, а не под синхронный call.

Класть пользовательскую логику в masterchain «для надёжности» → basechain для приложений; masterchain — инфраструктура сети.


Что дальше

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