{"id":13511560,"url":"https://github.com/ton-blockchain/ton","last_synced_at":"2025-05-13T19:03:06.569Z","repository":{"id":38916918,"uuid":"206946371","full_name":"ton-blockchain/ton","owner":"ton-blockchain","description":"Main TON monorepo","archived":false,"fork":false,"pushed_at":"2025-05-13T06:24:22.000Z","size":29224,"stargazers_count":3585,"open_issues_count":182,"forks_count":1213,"subscribers_count":193,"default_branch":"master","last_synced_at":"2025-05-13T07:28:14.277Z","etag":null,"topics":["blockchain","cryptocurrency","infinite-sharding","ton"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ton-blockchain.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":"LICENSE.LGPL","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-09-07T09:33:40.000Z","updated_at":"2025-05-11T06:07:26.000Z","dependencies_parsed_at":"2023-10-30T10:46:03.025Z","dependency_job_id":"aca2de72-76eb-4d6b-a446-2c1bb4f78175","html_url":"https://github.com/ton-blockchain/ton","commit_stats":null,"previous_names":[],"tags_count":46,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ton-blockchain%2Fton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ton-blockchain%2Fton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ton-blockchain%2Fton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ton-blockchain%2Fton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ton-blockchain","download_url":"https://codeload.github.com/ton-blockchain/ton/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254010793,"owners_count":21998993,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","cryptocurrency","infinite-sharding","ton"],"created_at":"2024-08-01T03:00:56.326Z","updated_at":"2025-05-13T19:03:06.522Z","avatar_url":"https://github.com/ton-blockchain.png","language":"C++","funding_links":[],"categories":["C++","Original source codes and GitHub repo","Others"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://ton.org\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://ton.org/download/ton_logo_dark_background.svg\"\u003e\n      \u003cimg alt=\"TON logo\" src=\"https://ton.org/download/ton_logo_light_background.svg\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n  \u003ch3\u003eReference implementation of TON Node and tools\u003c/h3\u003e\n  \u003chr/\u003e\n\u003c/div\u003e\n\n## \n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://tonresear.ch\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/TON%20Research-0098EA?style=flat\u0026logo=discourse\u0026label=Forum\u0026labelColor=gray\" alt=\"Ton Research\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://t.me/toncoin\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/TON%20Community-0098EA?logo=telegram\u0026logoColor=white\u0026style=flat\" alt=\"Telegram Community Group\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://t.me/tonblockchain\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/TON%20Foundation-0098EA?logo=telegram\u0026logoColor=white\u0026style=flat\" alt=\"Telegram Foundation Group\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://t.me/tondev_eng\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/chat-TONDev-0098EA?logo=telegram\u0026logoColor=white\u0026style=flat\" alt=\"Telegram Community Chat\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://twitter.com/ton_blockchain\"\u003e\n    \u003cimg src=\"https://img.shields.io/twitter/follow/ton_blockchain\" alt=\"Twitter Group\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://answers.ton.org\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-TON%20Overflow-FE7A16?style=flat\u0026logo=stack-overflow\u0026logoColor=white\" alt=\"TON Overflow Group\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://stackoverflow.com/questions/tagged/ton\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Stack%20Overflow-FE7A16?style=flat\u0026logo=stack-overflow\u0026logoColor=white\" alt=\"Stack Overflow Group\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n\nMain TON monorepo, which includes the code of the node/validator, lite-client, tonlib, FunC compiler, etc.\n\n## The Open Network\n\n__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.\n- To learn more about different aspects of TON blockchain and its underlying ecosystem check [documentation](https://ton.org/docs)\n- To run node, validator or lite-server check [Participate section](https://ton.org/docs/participate/nodes/run-node)\n- To develop decentralised apps check [Tutorials](https://docs.ton.org/v3/guidelines/smart-contracts/guidelines), [FunC docs](https://ton.org/docs/develop/func/overview) and [DApp tutorials](https://docs.ton.org/v3/guidelines/dapps/overview)\n- To work on TON check [wallets](https://ton.app/wallets), [explorers](https://ton.app/explorers), [DEXes](https://ton.app/dex) and [utilities](https://ton.app/utilities)\n- To interact with TON check [APIs](https://docs.ton.org/v3/guidelines/dapps/apis-sdks/overview)\n\n## Updates flow\n\n* **master branch** - mainnet is running on this stable branch.\n\n    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.\n\n* **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.\n\n* **backlog** - other branches that are candidates to getting into the testnet branch in the next iteration.\n\nUsually, the response to your pull request will indicate which section it falls into.\n\n\n## \"Soft\" Pull Request rules\n\n* Thou shall not merge your own PRs, at least one person should review the PR and merge it (4-eyes rule)\n* Thou shall make sure that workflows are cleanly completed for your PR before considering merge\n\n## Build TON blockchain\n\n### Ubuntu 20.4, 22.04, 24.04 (x86-64, aarch64)\nInstall additional system libraries\n```bash\n  sudo apt-get update\n  sudo apt-get install -y build-essential git cmake ninja-build zlib1g-dev libsecp256k1-dev libmicrohttpd-dev libsodium-dev\n          \n  wget https://apt.llvm.org/llvm.sh\n  chmod +x llvm.sh\n  sudo ./llvm.sh 16 all\n```\nCompile TON binaries\n```bash\n  cp assembly/native/build-ubuntu-shared.sh .\n  chmod +x build-ubuntu-shared.sh\n  ./build-ubuntu-shared.sh  \n```\n\n### MacOS 11, 12 (x86-64, aarch64)\n```bash\n  cp assembly/native/build-macos-shared.sh .\n  chmod +x build-macos-shared.sh\n  ./build-macos-shared.sh\n```\n\n### Windows 10, 11, Server (x86-64)\nYou need to install `MS Visual Studio 2022` first.\nGo to https://www.visualstudio.com/downloads/ and download `MS Visual Studio 2022 Community`.\n\nLaunch installer and select `Desktop development with C++`. \nAfter installation, also make sure that `cmake` is globally available by adding\n`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).\n\nOpen an elevated (Run as Administrator) `x86-64 Native Tools Command Prompt for VS 2022`, go to the root folder and execute: \n```bash\n  copy assembly\\native\\build-windows.bat .\n  build-windows.bat\n```\n\n### Building TON to WebAssembly\nInstall additional system libraries on Ubuntu\n```bash\n  sudo apt-get update\n  sudo apt-get install -y build-essential git cmake ninja-build zlib1g-dev libsecp256k1-dev libmicrohttpd-dev libsodium-dev\n          \n  wget https://apt.llvm.org/llvm.sh\n  chmod +x llvm.sh\n  sudo ./llvm.sh 16 all\n```\nCompile TON binaries with emscripten\n```bash\n  cd assembly/wasm\n  chmod +x fift-func-wasm-build-ubuntu.sh\n  ./fift-func-wasm-build-ubuntu.sh\n```\n\n### Building TON tonlib library for Android (arm64-v8a, armeabi-v7a, x86, x86-64)\nInstall additional system libraries on Ubuntu\n```bash\n  sudo apt-get update\n  sudo apt-get install -y build-essential git cmake ninja-build automake libtool texinfo autoconf libgflags-dev \\\n  zlib1g-dev libssl-dev libreadline-dev libmicrohttpd-dev pkg-config libgsl-dev python3 python3-dev \\\n  libtool autoconf libsodium-dev libsecp256k1-dev\n```\nCompile TON tonlib library\n```bash\n  cp assembly/android/build-android-tonlib.sh .\n  chmod +x build-android-tonlib.sh\n  ./build-android-tonlib.sh\n```\n\n### TON portable binaries\n\nLinux portable binaries are wrapped into AppImages, at the same time MacOS portable binaries are statically linked executables.\nLinux and MacOS binaries are available for both x86-64 and arm64 architectures. \n\n## Running tests\n\nTests are executed by running `ctest` in the build directory. See `doc/Tests.md` for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fton-blockchain%2Fton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fton-blockchain%2Fton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fton-blockchain%2Fton/lists"}