Skip to content

A tool to run and maintain a TON node/validator

License

Notifications You must be signed in to change notification settings

Full-Hat/mytonctrl

 
 

Repository files navigation

GitHub stars GitHub forks GitHub issues GitHub pull requests GitHub last commit GitHub license

MyTonCtrl

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

Contents

What is MyTonCtrl?

MyTonCtrl is a console application that serves as a convenient wrapper for fift, lite-client, and validator-engine-console. It has been specifically developed to streamline wallet, domain, and validator management tasks on the Linux operating system.

MyTonCtrl Status

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

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

Installation

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 andfull. 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>
  2. 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>'
  2. Done. You can try to run the mytonctrl console now.

    mytonctrl

MyTonCtrl Documentation

This repository contains the following technical documents for MyTonCtrl, categorized by language. Simply click the links below to navigate to the document you're interested in.

FAQ Import Wallets Ubuntu Manual Nominator Pool
English (EN) Link Link Link Link
Russian (RU) Link Link Link Link
Traditional Chinese Link Link Link Link

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

MyTonCtrl installer mode

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

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 93.1%
  • Shell 6.9%