VNODE节点快速上手指南

官方版本下载

最新的MOAC VNODE软件可以从官方的发布地址下载 release link

配置文件

解压后，其中有vnodeconfig.json文件，主要为配置应用链通讯所用，其内容如下

{
 "ip":"127.0.0.1",
  "ShowToPublic": true,
  "VnodeServiceCfg": "127.0.0.1:50062"
  "SCSservice": true,
  "VnodeBeneficialAddress" : "0xD814F2ac2c4cA49b33066582E4e97EBae02F2aB9"
}

其中参数说明如下：

"ip":

VNODE端的IP，默认为127.0.0.1；

"VnodeServiceCfg":

与AppChain的服务器SCS通讯的VNODE端的IP和端口，默认为localhost：50062，其它SCS通过这个接口与VNODE相连；

"ShowToPublic":

是否在，默认为“./scsdata”；

"SCSservice":

是否允许VNODE提供AppChain信息传递服务，默认为 false；

"VnodeBeneficialAddress":

从AppChain获得奖励的存入帐户地址，可以和VNODE的miner/Account[0]地址不同；

Debian/Ubuntu/CentOS

1. 使用 tar 来解压缩，在当前目录下运行：

./moac

如果要看帮助信息, 使用help参数: ./moac --help

如果要启动交互命令行，运行console参数: ./moac console

主网的存储目录会自动生成，在默认的 $HOME/.moac/ 下面，可以看到下面的信息:

INFO [04-24|11:24:26.506] 86161:IPC endpoint closed: /home/user/.moac/moac.ipc

再打开另一个命令行终端，再次运行：

./moac attach

或者制定ipc文件：

./moac attach $HOME/.moac/moac.ipc

2. 进入命令行（console）后，产生一个新帐号：

   >personal.newAccount()

3. 在命令行提示符下，开始挖矿：

   >miner.start()

4. 在另一个终端上，再次运行MOAC VNODE以连接运行中的节点：

   ./moac attach

5. 在命令行提示符，加载脚本：

   >loadScript("mctest.js")

6. 查看之前挖矿是否获得了mc，注意如果是连接的主网或者测试网，用户仅使用CPU挖矿的话，可能余额没有变化：

   >mc.accounts

7. 产生一个新账号：

   >personal.newAccount()

8. 尝试从帐号0发送交易到帐号1:

   >Send(mc.accounts[0], '', mc.accounts[1], 0.1)

WINDOWS

将文件解压缩到目录下，运行程序

D:\moac-win>moac.exe

1 查看moac帮助

打开命令（cmd）终端，转到MOAC解压目录，在命令行中执行：

D:\moac-win>moac --help

显示帮助信息，包含但不限于以下内容：

查看moac帮助

打开命令（cmd）终端，转到MOAC解压目录，在命令行中执行：

D:\ moac-win>moac --help

显示帮助信息，包含但不限于以下内容：

Start MOAC.... 2
NAME:
 moac - the MOAC-vnode command line interface
 Copyright 2017-2019 The MOAC Foundation
USAGE:
 moac [options] command [command options] [arguments...]
VERSION:
 1.0.12-rc-2b24668f
MOAC CORE OPTIONS:
--config value                      TOML configuration file
--datadir "C:\Users\[userName]\AppData\Roaming\MoacNode" Data directory for the databases and keystore
--keystore                         Directory for the keystore (default = inside the datadir)
--nousb                           Disables monitoring for and managing USB hardware wallets
--networkid value                   Network identifier (integer, 1=Pangu, 2=Testnet) (default: 1)
--testnet                          MOAC test network: pre-configured proof-of-work test network

2 运行节点

打开命令（cmd）终端，转到MOAC当前目录，在命令行中执行：

D:\ moac-win>moac.exe

显示如下信息：

至最后三行显示如下：

INFO [04-01|20:44:42.851] 1:[node/node.go->Node.startIPC]
INFO [04-01|20:44:42.852] 145:IPC endpoint opened: \\.\pipe\moac.ipc
INFO [04-01|20:45:12.846] 152:Block synchronisation started

表示节点安装成功，如果网络正常，就开始同步区块。

系统将MOAC节点默认安装在目录：

C:\Users\[userName]\AppData\Roaming\MoacNode\

该目录下包含两个文件夹：moac和keystore。

3 进入MOAC console界面

系统关机或主动关闭运行中的节点后，如果需要重新启动节点，在命令行中执行：

D:\ moac-win>moac console

之后一直滚屏以同步区块数据。

打开另一个命令（cmd）终端，转到MOAC当前目录，在命令行中执行：

D:\ moac-win>moac attach

该命令行不会主动滚屏，而是等待命令。

4. 挖矿

4.1 建立新账户

挖矿前必须建立一个自己的账户。

进入MOAC console界面，执行命令：

> personal.newAccount()

系统会提示输入一个密码，例如"passwd"，并再次输入相同密码确认后，会显示一个以0x开头的字符串，即为MOAC帐号的公开地址。

系统同时会在以下目录：

C:\Users\[userName]\AppData\Roaming\MoacNode\testnet\keystore

记录一个账号文件。请保存好该文件，并牢记密码，之后用于解密帐号和操作。

4.2 查看账户

进入MOAC console界面，执行命令：

> mc.accounts

可以查看本节点下的所有账号。

4.3 查看账户余额

进入MOAC console界面，执行命令：

> mc.getBalance(mc.accounts[0])

可以查看本节点下的账号余额。0表示第一个账户，也是默认挖矿账户。

或者：导入“mctest.js”的情况下（见4.1），执行命令：

> checkBalance()

该命令用于查看当前节点所有账号的余额。

4.4 查看挖矿状态

进入MOAC console界面，执行命令：

> mc.mining

返回true表明节点正在挖矿，false表明节点没有挖矿。

4.5 开始挖矿

进入MOAC console界面，执行命令：

> miner.start()

挖矿状态下，数据显示有明显不同。

挖到矿之后，可以查看余额

登录MOAC区块链浏览器页面： http://explorer.moac.io。

在搜索栏输入你的挖矿账号地址，会显示该账号的余额等信息。

在搜索栏输入你挖到矿的区块号，会显示该区块的信息。

Miner正是你的账号地址。

4.6 停止挖矿

进入MOAC console界面，执行命令：

> miner.stop()

5. 交易

5.1 读入测试函数

部分功能程序存储在mctest.js里。

进入MOAC console界面，执行命令：

> loadScript("mctest.js")

5.2 交易条件

为执行交易，需要至少两个帐号，其中一个有足够的mc。

如果没有目标账号，可以用步骤2.3.1的命令创建一个本地账号。并用命令：

> mc.accounts

显示当前节点中存储的账号，应该至少有一个挖矿账号。

5.3 交易

进入MOAC console界面，执行命令：

> Send(mc.accounts[0], 'passwd', mc.accounts[1], 0.1)

这个过程需要第一个账号的密码。比如'passwd'，发送额为0.1 mc。

在系统挖矿的情况下，发送应该在下一个区块产生时完成。

系统显示的是以 sha（Sand） 为单位的余额， 1 mc = 1e18 sha。