Skip to content

[Start here > Overview] Add a high-level definition of workchains #1682

@delovoyhomie

Description

@delovoyhomie

Problem / Why

New developers encounter the term workchain early (addresses, masterchain/workchains, sharding), but Start here doesn’t provide a simple, high-level definition. This creates confusion and forces readers to jump into advanced architecture docs.

What to do

Add a short “Key terms” snippet (or a callout) in Start here that defines:

  • Workchain (what it is, in plain language)
  • How it relates to masterchain and shardchains (1 sentence max)
  • Optional: why devs should care (e.g., addresses include workchain id; most apps use workchain 0)

Suggested text (draft):

A workchain is a TON blockchain with its own rules and account space. The masterchain maintains global configuration, while workchains host most accounts and smart contracts. Workchains can be partitioned into shardchains for scalability.

Acceptance criteria

  • “Workchain” is defined in Start here in 1–3 sentences, understandable for beginners.
  • Includes one practical note for devs (e.g., “most smart contracts are in workchain 0 (and why?)” / “addresses include workchain id”).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions