# 节点

节点是TOP Network区块链网络中提供计算、存储、路由能力的计算机或服务器，不同网络对应不同类型的节点，比如边缘网络的边缘节点等等。由于一台计算机或服务器可以加入不同网络，因此可以担任多种类型的节点。

node命令提供节点进程管理及节点网络信息查询功能，如下表所示：

命令	说明
topio node startNode	启动节点进程。
topio node stopNode	停止节点进程。
topio node reloadNode	TOPIO 升级后，重新载入 TOPIO。
topio node isJoined	查询节点是否成功加入网络。
topio node peers	查询节点可以连接的最大 peer 数量和当前连接的 peer 数量。
topio node nodeP2PAddr	查询节点 P2P 网络 IP 及端口。

# 启动节点进程

矿工注册后，需要启动节点进程，才能够加入 TOP Network 网络，参加选举和工作。

注意

启动节点进程前您需要完成：

步骤 1 矿工注册。

步骤 2 设置 miner key（钱包中有多个 key 或者只有一个有密码的 key 时）。

执行以下命令启动节点进程。

topio node startNode

启动节点后，TOPIO 会自动同步链上数据，查询链上数据同步状态，请参见与链互动中 topio chain syncStatus 命令。

成功返回
```
Start node successfully.
```

失败返回

钱包中有多个 key（owner key 或者 worker key）或者未设置默认 miner key。
```
Please set a miner key by command 'topio miner setMinerKey'
```

矿工未注册。

Start node failed.
T800002276a7d58218ac4978733e5cca927a7d86cb7c87 account has not registered miner.

设置的 miner key 和矿工注册时的 miner key 不一致。

Start node failed.
The minerkey does not match miner account.
T80000FD4f433c036268F17a1b4204eA907E70618d030E account‘s miner key is BN9AVWp3N6M2BFtKQ8MsQjw25Phmq0OFS9RS77xaIDDC8SGBrO03EVPQ0wCjuIl8U3/JDxYAhKLkU7yBi6QxBco=

# 停止节点进程

执行以下命令停止节点进程。

topio node stopNode

# 重新载入TOPIO

执行以下命令重新载入 TOPIO。

topio node reloadNode

# 查询节点是否成功加入网络

矿工注册并启动节点进程入网，入网后进入节点候选池等待选举。

执行以下命令查询节点是否已加入物理网络。

topio node isJoined

若返回 topio not ready，说明 TOPIO 暂未准备好，请等待一分钟后再次运行命令重试。
若返回 YES，则节点入网成功，进入候选池，等待选举；
若返回 No，则节点入网失败，可能因为网络故障，网络抖动。

# 查询节点连接peer信息

查询命令：

topio node peers

返回信息：

peers number: max 12 , now 2

Peer#0：IP 192.168.122.233; miner_account T800002276a7d58218ac4978733e5cca927a7d86cb7c87; Connection quality good/normal/bad 

Peer#1：IP 192.168.122.233; miner_account T8000066ab344963eaa071f9636faac26b0d1a39900325; Connection quality good/normal/bad

节点连接 peer 的数量和节点角色相关，节点加入的网络越多，连接的 peer 数量会相应增加。

# 查询节点P2P网络IP及端口

topio node nodeP2PAddr

返回信息：

tnode://ffffff17236471b087a873b8daf14c840000000090e2bd5f54283eccc94e8d3bf0a81bc0@127.0.0.1:9002

返回信息说明：

参数名称	说明
tnode	节点 P2P 地址。返回示例中"ffffff17236471b087a873b8daf14c840000000090e2bd5f54283eccc94e8d3bf0a81bc0"为 P2P node ID。

# FAQ

节点进程启动后，如何查看节点进程？

执行以下命令查看节点进程：
```
ps -ef |grep topio
```
节点进程包括：daemon process、xnode process、node safebox process。
关机后，如何重启节点进程？
设置 miner key，操作请参见矿工中相关命令说明。
执行以下命令重启节点进程。

```sh
topio node startNode
```

← 矿工 Staking →