TRON Developer Hub CN

TRON开发者中心

欢迎来到TRON开发者中心。您将找到全面的指南和文档,以帮助您尽快开始使用TRON Developer Hub,并在遇到困难时提供支持。让我们跳进去吧!

Get Started    

介绍

TRON-CLI 是一个命令行工具,可以快速轻松地启动完整节点,事件节点和 Solidity 节点。

依赖

  • Python 3.7+
  • JDK 1.8
  • MongoDB (用于事件服务器)
  • MacOS 或 Linux

安装

在目标目录中,可以选择设置 python 虚拟环境并激活环境。然后执行 troncli 的 pip 安装。

python3 -m venv venv    // Optional step

. ./venv/bin/activate   // Optional step

pip install troncli 

为何选择 Python 虚拟环境?

与许多 Python 程序一样,TRON-CLI 包含必要的依赖文件。在缺少 Python 虚拟环境的情况下,默认情况下,pip install 命令会将所需的包下载到本地计算机的 lib / python / site-packages 目录中。如果另一个 Python 程序检查相同软件包依赖项的不同版本,则该程序可能最终使用错误的软件包,因为没有版本号的指示。使用 Python 虚拟环境,所有必需的依赖项都整齐地打包到一个 venv 目录中,该目录可以方便地与工作目录位于同一级别。这消除了由于包名称重叠导致的任何潜在混淆,以及使包更容易定位。

虚拟环境中成功的 “pip install” 会产生以下输出:

成功的 pip 安装输出

成功的 pip 安装输出

TRON-CLI Quickstart

对于那些想要启动本地专用网络的人,可以运行命令 tron-cli quick。此命令设置 tron_nodes 目录和子文件夹,将 .jar 文件移动到文件夹中,在默认端口上设置配置文件,运行节点,并输出状态详细信息。

tron-cli quick
TRON-CLI Quickstart

TRON-CLI Quickstart

TRON-CLI 主网

以下过程允许高级用户自定义其设置并连接到 Mainnet。该过程包括初始化,设置配置和运行节点。

初始化

运行 'tron-cli init' 命令设置目录,下载 .jar 文件,并将 .jar 文件移动到目录中:

tron-cli init

该命令在工作目录中创建一个名为 tron_nodes 的目录,然后创建四个文件夹 fullnodesoliditynodeeventnodegridapi。然后该命令下载 full.jarsolidity.jar,并将这些可执行文件放在各自的文件夹中。

成功的 TRON-CLI init 输出

成功的 TRON-CLI init 输出

配置

TRON-CLI 允许用户轻松配置 Full 和 Solidity 节点的 HTTP 和 gRPC IP 端口。默认设置为:

Full Node HTTP: 8500
Solidity Node HTTP: 8600
Full Node RPC: 58500
Solidity Node RPC: 58600
Event-Node RPC: 58400
Event-Node HTTP: 8400

要自定义设置,只需执行 tron-cli config --nettype 命令即可。例如,要将 Full Node HTTP 端口设置为 8090,请运行 tron-cli config --fullhttpport 8090

完整节点 HTTP 端口设置为 8090

完整节点 HTTP 端口设置为 8090

运行节点

要启动完整节点,请运行 tron-cli run

运行完整节点

运行完整节点

然后,您可以使用 tron-cli status 检查整个节点状态:

检查 TRON-CLI 整体节点状态

检查 TRON-CLI 整体节点状态

要运行 solidity 节点,请运行命令 tron-cli run --nodetype sol。对于事件节点,运行命令 tron-cli run --nodetype event

运行 TRON-CLI Solidity 节点

运行 TRON-CLI Solidity 节点

检查日志

一旦完整节点和 Solidity 节点都运行,您就可以查看同步日志。完整节点日志位于 tron_nodes / fullnode / logs / tron.log 下,而 Solidity Node 日志位于 tron_nodes / soliditynode / logs / tron.log下。由于同步,日志会动态更新,完整节点后面的 Solidity Node 1 块。

完整节点(左)和 Solidity Node(右)日志。

完整节点(左)和 Solidity Node(右)日志。

停止节点

运行以下命令可以轻松停止节点:

tron-cli stop --node NODENUMBER

常见用例

1.专用网络节点设置

设置完整节点

tron-cli quick

添加Solidity节点

tron-cli run --nodetype sol

2. 主网节点设置

初始化

tron-cli init

配置到主网

tron-cli config --nettype main

运行完整节点

tron-cli run

3. 高级配置启动节点

初始化

tron-cli init --version latest --reset True

详细配置 (指定参数以覆盖默认值)

tron-cli config --nettype private --fullhttpport 8500 --solhttpport 8600 --eventhttpport 8400 --fullrpcport 58500 --solrpcport 58600 --eventrpcport 58400 --enablememdb True --dbsyncmode async --saveintertx False --savehistorytx False --gridport 18891 --dbname Null --dbusername Null --dbpassword Null

运行 Full/Sol

tron-cli run --nodetype full

4. 私立完整节点 + 事件节点 + Tron-Grid

安装 MongoDB 并创建用户和数据库. 然后初始化.

tron-cli init

_配置(指定参数以覆盖默认值)dbname,dbusername 和 dbpassword 需要设置

tron-cli config --nettype private --fullhttpport 8500 --solhttpport 8600 --eventhttpport 8400 --fullrpcport 58500 --solrpcport 58600 --eventrpcport 58400 --enablememdb True --dbsyncmode async --saveintertx False --savehistorytx False --gridport 18891 --dbname events --dbusername tron --dbpassword 12345678

运行完整节点,事件节点和 Tron-Grid

tron-cli run
tron-cli run --nodetype event
tron-cli run --nodetype grid

5. 主网事件节点 + Tron-Grid

安装 MongoDB 并创建用户和数据库。然后初始化

tron-cli init

_配置(指定参数以覆盖默认值)dbname,dbusername 和 dbpassword 需要设置

tron-cli config --nettype private --fullhttpport 8500 --solhttpport 8600 --eventhttpport 8400 --fullrpcport 58500 --solrpcport 58600 --eventrpcport 58400 --enablememdb True --dbsyncmode async --saveintertx False --savehistorytx False --gridport 18891 --dbname events --dbusername tron --dbpassword 12345678

运行事件节点

tron-cli run --nodetype event

运行 Tron-Grid

tron-cli run --nodetype grid

命令概述

命令
函数
用法示例 1
用法示例 2

tron-cli init --version --reset

启动目录并获取代码。

tron-cli init

tron-cli init --version 3.2.2 --reset True

tron-cli config --nettype ---nettype --fullhttpport --solhttpport --eventhttpport --fullrpcport --solrpcport --eventrpcport --enablememdb --dbsyncmode --saveintertx --savehistorytx --gridport --dbname --dbusername --dbpassword

创建和自定义配置文件。

tron-cli config

tron-cli config --nettype private --fullhttpport 8500 --solhttpport 8600 --eventhttpport 8400 --fullrpcport 58500 --solrpcport 58600 --eventrpcport 58400 --enablememdb True --dbsyncmode async --saveintertx False --savehistorytx False --gridport 18891 --dbname events --dbusername tron --dbpassword 12345678

tron-cli run --nodetype

运行节点。

tron-cli run

tron-cli run --nodetype full

tron-cli stop --node

停止节点。

tron-cli stop

tron-cli stop --node 7777

tron-cli status --node

监控节点状态。

tron-cli status

tron-cli status --node 777

tron-cli quick --reset

快速开始。

tron-cli quick

tron-cli quick -- reset True

tron-cli version

检查安装的 troncli 版本。

tron-cli version

tron-cli version

tron-cli -h, --help

查看帮助手册。

tron-cli -h

tron-cli --help

TRON-CLI


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.