ton-dev-cli

⚠️ ton-dev-cli is deprecated. Please use tondev package instead.

TON Labs Dev Command Line Tool

See https://docs.ton.dev for documentation.
Also check our Youtube channel for tutorials.

Dependencies

Node.js >= 10.x installed
Docker >= 19.x installed

Install

npm install -g ton-dev-cli

See installation guide in case of problems

Basic operations

Invocation

While installed globally, ton-dev-cli package places its executable tondev into system path, so you could use it everywhere in your file system as a main command to invoke the tool.

Type:
tondev info (or just tondev) - to see current status
tondev -V - to see ton-dev-cli version
tondev -a - to see versions of the compilers and node containers available in DockerHub registry
tondev -h or tondev --help for the help about usage, options and subcommands

You can use -h or --help option with any subcommand to get extended help about its usage. Also full help content is included in this document below.

Initialization

In order to get started, run: tondev setup

The command triggers Docker image pull from DockerHub registry and launches the corresponding containers:

tonlabs-compilers-<local user name> that is used for building solidity contracts
tonlabs-local-node-<local user name> is a local TON node container runs compiled contracts.

You can specify additional options to customize the installation:

-n, --networks
-m, --compilers

Managing containers

To start and stop both containers, use the tondev start and tondev stop commands. Use these commands to save machine resources.

restart restarts the installed containers.
recreate removes containers and re-creates them again. Start tondev utility again after.
-n, --networks [names] applies the command to specified network(s) (use comma to separate)
-m, --compilers applies the command to the compiler kit container

Building local nodes network

To test your contract at multiple nodes, create a network. A network consists of multiple inter-connected local nodes.

A single run of tondev setup creates a single local node listening to port 80.

In order to add another node:

tondev add anotherNode
tondev set --port 81 anotherNode

tondev add adds another node to network config. By default it uses port 80.

Given that multiple nodes cannot use the same port, reset the port with tondev set -p.

Note: You can add multiple nodes simultaneously by separating names with a space.

Exposing local node ArangoDB

It is useful to expose ArangoDB built in each local node. To do it, run:

tondev set --db-port 8881 anotherNode

Instead of the port number you can specify "bind" to use the default Arango DB port or "unbind" to stop exposing the port.

Renaming local node

In order to rename a node, run:

tondev set --new-name newName oldName

To remove a node run tondev remove anotherNode or tondev rm anotherNode.

Compiling Solidity

Solidity contracts are compiled with the following command:

tondev sol [options] [files...]

The following options are available:

-l, --client-languages <languages> to generate client code for languages: "js" (use comma to separate several languages)
-L, --client-level <client-level> client code level: "run" to run only, "deploy" to run and deploy (includes an imageBase64 of a binary contract)

Switching compiler versions

tondev CLI allows switching between compiler versions; run:

tondev use 0.14.0

The command pulls a relevant Docker container. You can also run:

tondev use [options] <version> to use specified version for containers

Removing containers

In order to remove Docker containers and images related to TON Dev, run:

tondev clean

The following options are available to customize the command:

-n, --networks clean local node docker containers and images
-m, --compilers clean compilers docker containers and images
-c, --containers clean containers only (default: false)

If no option is specified, the command removes all TON Dev docker containers and images.

Key Pair Generation

command: keys

Usage: tondev keys|k [options]

Generate random Key Pair

Complete help for version: 0.17.5

`tondev -help`

Usage: tondev [options] [command]

TON Labs development tools

Options:
  -V, --version               output the version number
  -a, --available             Show available versions.
  -h, --help                  display help for command

Commands:
  info [options]              Show summary about dev environment.
  sol [options] [files...]    Build solidity contract[s].
  gen [options] [files...]    Generate client code for contract[s].
  start [options]             Start dev containers.
  stop [options]              Stop dev containers.
  restart [options]           Restart dev containers.
  recreate [options]          Recreate dev containers.
  setup [options]             Setup dev environment.
  clean [options]             Remove docker containers and images related to
                              TON Dev.
  use [options] <version>     Use specified version for containers.
  set [options] [network...]  Set network[s] options.
  add [network...]            Add network[s].
  remove|rm [network...]      Remove network[s].
  keys|k                      Generate random Key Pair.
  addr|a <addr>               Convert address.
  help [command]              display help for command

subcommands help:

`tondev info --help`

Usage: tondev info [options]

Show summary about dev environment.

Options:
  -a, --available  Show available versions.
  -h, --help       display help for command

`tondev sol --help`

Usage: tondev sol [options] [files...]

Build solidity contract[s].

Options:
  -l, --client-languages <languages>  Generate client code for specified
                                      languages separated by comma, supported
                                      languages: "js".
  -L, --client-level <client-level>   Client code level: "run" to run only,
                                      "deploy" to run and deploy (includes an
                                      imageBase64 of binary contract) (default:
                                      "deploy")
  --js-module <module-type>           Java Script module type: `node` to use
                                      with `const FooContract =
                                      require('foo')`, `nodeNoDefault` to use
                                      with `const {FooContract} =
                                      require('foo')`, `es` to use with `import
                                      FooContract from 'foo'`, `esNoDefault` to
                                      use with `import {FooContract} from
                                      'foo'`. (default: "node")
  -h, --help                          display help for command

`tondev gen --help`

Usage: tondev gen [options] [files...]

Generate client code for contract[s].

Options:
  -l, --client-languages <languages>  Generate client code for specified
                                      languages separated by comma, supported
                                      languages: "js". (default: "js")
  -L, --client-level <client-level>   Client code level: "run" to run only,
                                      "deploy" to run and deploy (includes an
                                      imageBase64 of binary contract) (default:
                                      "deploy")
  --js-module <module-type>           Java Script module type: `node` to use
                                      with `const FooContract =
                                      require('foo')`, `nodeNoDefault` to use
                                      with `const {FooContract} =
                                      require('foo')`, `es` to use with `import
                                      FooContract from 'foo'`, `esNoDefault` to
                                      use with `import {FooContract} from
                                      'foo'`. (default: "node")
  -h, --help                          display help for command

`tondev start --help`

Usage: tondev start [options]

Start dev containers.

Options:
  -n, --networks [names]  Apply command to specified network[s] (names must be
                          separated with comma).
  -m, --compilers         Apply command to the compilers container.
  -h, --help              display help for command

`tondev stop --help`

Usage: tondev stop [options]

Stop dev containers.

Options:
  -n, --networks [names]  Apply command to specified network[s] (names must be
                          separated with comma).
  -m, --compilers         Apply command to the compilers container.
  -h, --help              display help for command

`tondev restart --help`

Usage: tondev restart [options]

Restart dev containers.

Options:
  -n, --networks [names]  Apply command to specified network[s] (names must be
                          separated with comma).
  -m, --compilers         Apply command to the compilers container.
  -h, --help              display help for command

`tondev recreate --help`

Usage: tondev recreate [options]

Recreate dev containers.

Options:
  -n, --networks [names]  Apply command to specified network[s] (names must be
                          separated with comma).
  -m, --compilers         Apply command to the compilers container.
  -h, --help              display help for command

`tondev setup --help`

Usage: tondev setup [options]

Setup dev environment.

Options:
  -n, --networks [names]  Apply command to specified network[s] (names must be
                          separated with comma).
  -m, --compilers         Apply command to the compilers container.
  -h, --help              display help for command

`tondev clean --help`

Usage: tondev clean [options]

Remove docker containers and images related to TON Dev.

Options:
  -n, --networks    Clean local node docker containers and images.
  -m, --compilers   Clean compilers docker containers and images.
  -c, --containers  Clean containers only. (default: false)
  -h, --help        display help for command

`tondev use --help`

Usage: tondev use [options] <version>

Use specified version for containers.

Options:
  -n, --networks [names]  Apply command to specified network[s] (names must be
                          separated with comma).
  -m, --compilers         Apply command to the compilers container.
  -h, --help              display help for command

`tondev set --help`

Usage: tondev set [options] [network...]

Set network[s] options.

Options:
  -p, --port <port>        Host port to bound local node.
  -d, --db-port <binding>  Host port to bound local nodes Arango DB ("bind" to
                           use default Arango DB port, "unbind" to unbind
                           Arango DB port).
  -n, --new-name <name>    Set new name for network.
  -h, --help               display help for command

`tondev add --help`

Usage: tondev add [options] [network...]

Add network[s].

Options:
  -h, --help  display help for command

`tondev remove --help`

Usage: tondev remove|rm [options] [network...]

Remove network[s].

Options:
  -h, --help  display help for command

`tondev keys --help`

Usage: tondev keys|k [options]

Generate random Key Pair.

Options:
  -h, --help  display help for command

`tondev addr --help`

Usage: tondev addr|a [options] <addr>

Convert address.

Options:
  -h, --help  display help for command

`tondev help --help`

Usage: tondev [options] [command]

TON Labs development tools

Options:
  -V, --version               output the version number
  -a, --available             Show available versions.
  -h, --help                  display help for command

Commands:
  info [options]              Show summary about dev environment.
  sol [options] [files...]    Build solidity contract[s].
  gen [options] [files...]    Generate client code for contract[s].
  start [options]             Start dev containers.
  stop [options]              Stop dev containers.
  restart [options]           Restart dev containers.
  recreate [options]          Recreate dev containers.
  setup [options]             Setup dev environment.
  clean [options]             Remove docker containers and images related to
                              TON Dev.
  use [options] <version>     Use specified version for containers.
  set [options] [network...]  Set network[s] options.
  add [network...]            Add network[s].
  remove|rm [network...]      Remove network[s].
  keys|k                      Generate random Key Pair.
  addr|a <addr>               Convert address.
  help [command]              display help for command

Licensed under the SOFTWARE EVALUATION License (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: https://www.ton.dev/licenses

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific TON DEV software governing permissions and limitations under the License.

Name		Name	Last commit message	Last commit date
Latest commit History 141 Commits
.github/workflows		.github/workflows
__tests__		__tests__
dist		dist
js-templates		js-templates
readme_generator		readme_generator
src		src
.eslintrc		.eslintrc
.flowconfig		.flowconfig
.gitignore		.gitignore
.npmignore		.npmignore
CHANGELOG.md		CHANGELOG.md
ISSUE_TEMPLATE.md		ISSUE_TEMPLATE.md
LICENSE		LICENSE
README.md		README.md
babel.config.js		babel.config.js
jest.config.js		jest.config.js
package.json		package.json

License

everx-labs/ton-dev-cli

Folders and files

Latest commit

History

Repository files navigation

ton-dev-cli

Dependencies

Install

Basic operations

Invocation

Initialization

Managing containers

Building local nodes network

Exposing local node ArangoDB

Renaming local node

Compiling Solidity

Switching compiler versions

Removing containers

Key Pair Generation

Complete help for version: 0.17.5

tondev -help

subcommands help:

tondev info --help

tondev sol --help

tondev gen --help

tondev start --help

tondev stop --help

tondev restart --help

tondev recreate --help

tondev setup --help

tondev clean --help

tondev use --help

tondev set --help

tondev add --help

tondev remove --help

tondev keys --help

tondev addr --help

tondev help --help

About

Topics

Resources

License

Stars

Watchers

Forks

Releases 2

Packages 0

Contributors 8

Languages