Skip to content

A tool to run and maintain a TON node/validator

License

Notifications You must be signed in to change notification settings

Telegramian/mytonctrl

 
 

Repository files navigation

Данный текст доступен на русском языке.

What is it?

This console is a wrapper over fift,lite-client and validator-engine-console. It was created to facilitate wallet, domain and validator management on Linux OS.

Functionality

  • Show TON network status
  • Management of local wallets
    • Create local wallet
    • Activate local wallet
    • Show local wallets
    • Import wallet from file (.pk)
    • Save wallet address to file (.addr)
    • Delete local wallet
  • Show account status
    • Show account balance
    • Show account history
    • Show account status from bookmarks
  • Transferring funds to the wallet
    • Transfer of a fixed amount
    • Transfer of the entire amount (all)
    • Transfer of the entire amount with wallet deactivation (alld)
    • Transferring funds to the wallet from bookmarks
    • Transferring funds to a wallet through a chain of self-deleting wallets
  • Manage bookmarks
    • Add account to bookmarks
    • Show bookmarks
    • Delete bookmark
  • Offer management
    • Show offers
    • Vote for the proposal
    • Automatic voting for previously voted proposals
  • Domain management
    • Rent a new domain
    • Show rented domains
    • Show domain status
    • Delete domain
    • Automatic domain renewal
  • Controlling the validator
    • Participate in the election of a validator
    • Return bet + reward
    • Autostart validator on abnormal termination (systemd)
    • Send validator statistics to https://toncenter.com

List of tested operating systems

Ubuntu 16.04 LTS (Xenial Xerus) - Error: TON compilation error
Ubuntu 18.04 LTS (Bionic Beaver) - OK
Ubuntu 20.04 LTS (Focal Fossa) - OK
Debian 8 - Error: Unable to locate package libgsl-dev
Debian 9 - Error: TON compilation error
Debian 10 - OK

Installation scripts overview

  • toninstaller.sh: clones TON and mytonctrl sources to /usr/src/ton and/usr/src/mytonctrl folders, compiles programs from sources and writes them to /usr/bin/.
  • mytoninstaller.py: configures the validator and mytonctrl; generates validator connection keys.

Installation modes

There are two installation modes: lite and full. They both compile and install TON components. However the lite version does not configure or run the node/validator.

Installation for Ubuntu

  1. Download and execute the install.sh script in the desired installation mode. During installation the script prompts you for the superuser password several times.
wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh
sudo bash install.sh -m <mode>
  1. Done. You can try to run the mytonctrl console now.
mytonctrl

Installation for Debian

  1. Download and execute the install.sh script in the desired installation mode. During installation the script prompts you for the superuser password several times.
wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh
su root -c 'bash install.sh -m <mode>'
  1. Done. You can try to run the mytonctrl console now.
mytonctrl

Telemetry

By default, mytonctrl sends validator statistics to the https://toncenter.com server. It is necessary to identify network abnormalities, as well as to quickly give feedback to developers. To disable telemetry during installation, use the -t flag:

sudo bash install.sh -m <mode> -t

To disable telemetry after installation, do the following:

MyTonCtrl> set sendTelemetry false

Web admin panel

To control the node/validator through the browser, you need to install an additional module: mytonctrl -> installer -> enable JR

Next, you need to create a password for connection: mytonctrl -> installer -> setwebpass

Ready. Now you can go to https://tonadmin.org site and log in with your credentials. git: https://github.com/igroman787/mtc-jsonrpc

Local copy of toncenter

To set up a local https://toncenter.com copy on your server, install an additional module: mytonctrl -> installer -> enable PT

Ready. A local copy of toncenter is available at http://<server-ip-address>:8000 git: https://github.com/igroman787/pytonv3

Useful links

  1. https://github.com/ton-blockchain/mytonctrl/blob/master/docs/en/manual-ubuntu.md
  2. https://ton.org/docs/

About

A tool to run and maintain a TON node/validator

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 94.3%
  • Shell 5.7%