TON OS Startup Edition
Local blockchain for Free TON DApp development and testing.
Have a question? Get quick help in our channel:
What is TON OS Startup Edition?
TON OS Startup Edition (SE) is a local blockchain that developer can run on their machine in one click.
At the moment we publish TON OS SE only as a docker image. We plan to provide simple installers for MacOS, Win, Linux without docker by the end of Q1 2021.
See the TON Labs TON OS SE documentation for detailed information.
Use-cases
- Test your applications locally
- Test your contracts
- Run TON OS remotely on a server and test your application from different devices
How to install
Pre-requisites
- Latest Docker installed
Attention! Docker daemon must be running.
Instal via TONDEV Development Environment
If you have TONDEV installed globally on your machine, run this command
$ tondev se start
Checkout other TON OS SE commands accessible from TONDEV. You can also access these commands from TONDEV VS Code Extension.
Install via docker command
Run this command
$ docker run -d --name local-node -e USER_AGREEMENT=yes -p80:80 tonlabs/local-node
To check that SE has been installed successfully check its local playground at http://0.0.0.0/graphql. For Windows, use http://127.0.0.1/graphql or http://localhost/graphql.
If you specified another port then add it to the local url http://0.0.0.0:port/graphql
Find out more about GraphQL API.
How to connect to TON OS SE Graphql API from SDK
Attention at the moment there are a few differences in SE behaviour comparing with a real TON blockchain. Read about them before you start implemennting. Please note that we plan to upgrade the SE behaviour in the next releases so that it will work the same way as a real network.
To connect to local blockchain from your application specify localhost in SDK Client network config.
TON OS SE components:
- TON Labs implementation of TON VM written in Rust
- ArangoDB database
- GraphQL endpoint with web playground
- Pre-deployed Giver
How to build docker image locally
In order to build and use TON OS Startup Edition you need Docker. To build docker image, run from the repository root:
Linux/Mac:
./build.sh
Windows:
build.cmd