-
Notifications
You must be signed in to change notification settings - Fork 50
feat: what is a node #1732
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
feat: what is a node #1732
Changes from 3 commits
4785bb0
e528fac
07c5aea
a9b929d
bddfeef
2d31335
5e28c30
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,53 @@ | ||||||
| --- | ||||||
| title: "What is a node?" | ||||||
| description: "Understand nodes, validators, and how apps reach the TON network." | ||||||
| --- | ||||||
|
|
||||||
| import { Image } from "/snippets/image.jsx"; | ||||||
|
|
||||||
| A node is a server running TON blockchain software. It stores the chain state, verifies blocks and transactions, and propagates new data to other nodes and clients. | ||||||
|
|
||||||
| This matters when deciding whether to rely on a public API or run infrastructure, and when tracing how a wallet action becomes an on-chain transaction. | ||||||
delovoyhomie marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
|
|
||||||
| ## What a node does | ||||||
|
|
||||||
| A _full node_ keeps the latest blockchain state and relays blocks and messages across the peer-to-peer network. A _validator_ is a full node that participates in consensus and produces blocks. Many full nodes also expose a _liteserver_ endpoint so wallets and apps can query data or submit messages without running a full node themselves. | ||||||
|
|
||||||
| TON also has _lite clients_. They do not store chain state locally. Instead, they request the data they need from liteserver-enabled full nodes. | ||||||
|
|
||||||
| ## Node types and roles | ||||||
|
|
||||||
| - **Full node** — stores the latest state and propagates blocks and messages. See [Node roles and modes](/ecosystem/node/overview). | ||||||
| - **Archive node** — a full node that keeps the entire history for analytics and explorers. See [Node roles and modes](/ecosystem/node/overview). | ||||||
| - **Validator node** — produces blocks and participates in consensus. See [Running a validator](/ecosystem/node/run-validator). | ||||||
| - **Liteserver** — a mode that exposes a gateway for lite clients and APIs. See [Interacting with TON nodes](/ecosystem/node/overview#interacting-with-ton-nodes). | ||||||
|
|
||||||
| ## Who runs nodes | ||||||
|
|
||||||
| - **Validators** — stake Toncoin, participate in consensus, and produce blocks. | ||||||
| - **Infrastructure providers** — run full nodes and liteservers to back APIs. | ||||||
| - **Explorers and indexers** — run archive nodes to serve historical data. | ||||||
| - **Projects and exchanges** — run nodes for reliable, low-latency access. | ||||||
delovoyhomie marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
| - **Community operators** — add connectivity and redundancy to the network. | ||||||
|
|
||||||
| ## How apps reach the network | ||||||
|
|
||||||
| Wallets and dApps act as lite clients: they do not keep chain state locally and instead connect to an [API provider](/ecosystem/api/overview) or a liteserver gateway. The gateway forwards requests to full nodes. Validators are the subset of nodes that finalize new blocks, and the results propagate back through the network. | ||||||
|
|
||||||
| <Image | ||||||
| src="/resources/images/nodes/node-flow.svg" | ||||||
| alt="Flow from a user wallet or dApp through an API or liteserver gateway to TON full nodes and validators." | ||||||
| /> | ||||||
|
|
||||||
| ## Run your own node (optional) | ||||||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [HIGH] Non-imperative, descriptive heading on task sectionThe heading
Suggested change
Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @novusnota @aigerimu wdyt? |
||||||
|
|
||||||
| Use public APIs for prototypes and light workloads. Run a full node when an app needs guaranteed uptime or direct access to the network. | ||||||
delovoyhomie marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
|
||||||
| - [Set up a node with MyTonCtrl](/ecosystem/node/setup-mytonctrl) | ||||||
| - [Set up a local network with MyLocalTon](/ecosystem/node/setup-mylocalton) | ||||||
|
|
||||||
| ## See also | ||||||
|
|
||||||
| - [Node roles and modes](/ecosystem/node/overview) | ||||||
| - [Running a validator](/ecosystem/node/run-validator) | ||||||
| - [Liteserver mode](/ecosystem/node/overview#interacting-with-ton-nodes) | ||||||
Uh oh!
There was an error while loading. Please reload this page.