Skip to main content

Do you need your own node?

  • Run your own full node when you need guaranteed uptime or to serve high-volume workloads without third-party rate limits. Validators and staking services need to install a node and activate validator mode.
  • Rely on public endpoints when building prototypes or light integrations. Community liteservers and APIs such as Toncenter or other RPC providers already expose the blockchain for read access and transaction submission.

Pick your target environment

If you needRun
Validator or nominator capacitySetting up a node using MyTonCtrl with the validator, nominator pool, or single nominator workflows; the wrapper automates validator wallets, overlays, elections, and upgrades.
Liteserver APIsSetting up a node using MyTonCtrl with liteserver option (and archive mode if needed) to expose API for applications.
An isolated development networkSetting up a local blockchain using MyLocalTon to spin up a local shard, explorer, and APIs for rapid iterations with no mainnet impact.
Diversify validator locations. Check the validator map (Toncenter Grafana) before deploying new validators and distribute capacity across regions. Providers in Western Europe already run many TON validators; prefer underutilized zones to avoid centralizing block production.

Node types

RoleWhat it doesWhen to use it
Full nodeStores the latest shards, tracks the masterchain, and serves data to lite-clients.Required for custom infrastructure, analytics, or to back your own APIs.
Archive nodeExtends a full node with long-term block storage.Required for historical state replay, compliance exports, or deep analytics datasets.
ValidatorProduces and signs blocks, participates in elections, and earns rewards.Needed to run validation with your stake or to operate a nominator pool service.

Full node

The full node is a basic node type within the TON blockchain. It serves as the backbone of the TON blockchain by keeping its block history—in other words, its current state. Compared to archive nodes, full nodes keep only the latest part of the blockchain state, which is vital for ensuring client applications’ network stability and operation. Full nodes prune the state of the TON blockchain they keep. This means the full node automatically removes earlier blocks that become unnecessary for the network to manage its data volume effectively. To allow client applications to look for blocks and transactions and send new transactions into the TON blockchain, full nodes are equipped with the liteserver functionality.

Archive node

The archive node is a full node that keeps the entire block history of the TON blockchain. These nodes act as the decentralized point of truth to ensure consistency of the whole blockchain history. They are a backend for blockchain explorers and other applications relying on deep transaction history. Archive nodes do not prune the blockchain state, elevating system requirements, especially in storage. According to the latest estimations, while full and validator nodes require about 1 TB of disk space, archive nodes need about 12 TB to store the complete block history.

Validator node

Validator nodes or validators are the TON network participants who propose new blocks and verify transactions according to the TON’s proof-of-stake mechanism. In this way, validators contribute to the overall blockchain security. Validators get rewards in TON for successful participation in the validation process. To be entitled to propose and validate blocks, other participants elect validators based on the amount of TON they hold—in other words, their stake. The more TON a validator stakes, the higher its chances of being elected, validating blocks for the network, and earning rewards. As a rule, validator operators motivate other TON holders to stake with them to get passive income from the resulting rewards. In this way, validators ensure network stability and security and contribute to its growth.

Interacting with TON nodes

TON nodes can run in liteserver mode, which allows external applications to interact with the TON blockchain. In this mode, the nodes process requests from clients, enabling them to access blockchain data, send transactions, and retrieve information about blocks and transactions. Liteserver uses the Abstract Datagram Network Layer (ADNL) protocol, so you generally also use ton-http-api (a Toncenter-like API), which acts as an HTTP-to-ADNL frontend and exposes an HTTP API. Full and archive nodes typically enable liteserver mode because they store blockchain history and handle external requests. In contrast, validator nodes do not need it as they focus on validating new blocks efficiently without extra workload from external queries. You have two options to allow your application to interact with the TON blockchain:
  1. To have a stable connection, you can set up your own full or archive node with a liteserver mode and ton-http-api enabled using MyTonCtrl.
  2. If you cannot set up your TON node with a liteserver, you can use Toncenter or other RPC providers.
I