Ton

Main TON monorepo, which includes the code of the node/validator, lite-client, tonlib, FunC compiler, etc.

The Open Network

The Open Network (TON) is a fast, secure, scalable blockchain focused on handling millions of transactions per second (TPS) with the goal of reaching hundreds of millions of blockchain users.

• To learn more about different aspects of TON blockchain and its underlying ecosystem check documentation
• To run node, validator or lite-server check Participate section
• To develop decentralised apps check Tutorials, FunC docs and DApp tutorials
• To work on TON check wallets, explorers, DEXes and utilities
• To interact with TON check APIs

Updates flow

• master branch - mainnet is running on this stable branch.

  Only emergency updates, urgent updates, or updates that do not affect the main codebase (GitHub workflows / docker images / documentation) are committed directly to this branch.

• testnet branch - testnet is running on this branch. The branch contains a set of new updates. After testing, the testnet branch is merged into the master branch and then a new set of updates is added to testnet branch.

• backlog - other branches that are candidates to getting into the testnet branch in the next iteration.

Usually, the response to your pull request will indicate which section it falls into.

"Soft" Pull Request rules

• Thou shall not merge your own PRs, at least one person should review the PR and merge it (4-eyes rule)
• Thou shall make sure that workflows are cleanly completed for your PR before considering merge

Build TON blockchain

Ubuntu 20.4, 22.04 (x86-64, aarch64)

Install additional system libraries

Compile TON binaries

MacOS 11, 12 (x86-64, aarch64)

Windows 10, 11, Server (x86-64)

You need to install

first. Go to https://www.visualstudio.com/downloads/ and download

MS Visual Studio 2022 Community

.

Launch installer and select

. After installation, also make sure that

cmake

is globally available by adding

C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin

to the system

PATH

(adjust the path per your needs).

Open an elevated (Run as Administrator)

, go to the root folder and execute:

Building TON to WebAssembly

Install additional system libraries on Ubuntu

Compile TON binaries with emscripten

Building TON tonlib library for Android (arm64-v8a, armeabi-v7a, x86, x86-64)

Install additional system libraries on Ubuntu

Compile TON tonlib library

Build TON portable binaries with Nix package manager

You need to install Nix first.

Then compile TON with Nix by executing below command from the root folder:

More examples for other platforms can be found under

.

Running tests

Tests are executed by running

in the build directory. See

doc/Tests.md

for more information.