Libra教程之:Libra testnet使用指南

704 阅读7分钟

Libra testnet网络

Libra的测试网络testnet已经上线了,那么我们该怎么做才能在testnet上给自己转账一千万,从此出任CEO,赢取白富美,走上人生巅峰呢? 跟着我的节奏,来吧。

testnet只是一个测试网络,有的小伙伴在想我是不是可以搭个私链发个币,然后再上交易所呢? 完全没问题,在币圈只有想不到的,没有做不到的,搭私链的问题,我会在文章中最后一个章节讲到。

本文档将指导你完成在Libra区块链上的第一笔交易。 运行之前有一些准备工作要做:

  • 你正在Linux(基于Red Hat或Debian的)或macOS系统上运行。
  • 你的互联网连接稳定。
  • git已安装在你的系统上。
  • Homebrew安装在macOS系统上。
  • yum或者apt-get已安装在Linux系统上。

目前本教程只能正常运行在Linux和macOS环境中,请小伙伴自行检查。

下载和安装Libra

克隆Libra核心存储库

git clone https://github.com/libra/libra.git

checkout testnet分支

git checkout testnet

安装依赖

要设置Libra Core,请切换到libra目录并运行安装脚本以安装依赖,如下所示:

cd libra
./scripts/dev_setup.sh

上面的安装脚本会执行如下操作:

  • 安装rustup:rustup是Rust编程语言的安装程序。
  • 安装所需版本的rust-toolchain。
  • 安装CMake,用来管理构建过程。
  • 安装protoc:protocol buffers的编译器。
  • 安装Go:building protocol buffers。

编译Libra client并连接到Testnet网络

运行下面的命令来编译Libra client和连接到Testnet网络:

./scripts/cli/start_cli_testnet.sh

该命令利用cargo(Rust的包管理器)构建并运行客户端,并将客户端连接到测试网上的验证者节点。

客户端连接到测试网上的节点后,你将看到以下输出。 要随时退出客户端,请使用quit命令。

usage: <command> <args>

Use the following commands:

account | a
  Account operations
query | q
  Query operations
transfer | transferb | t | tb
  <sender_account_address>|<sender_account_ref_id> <receiver_account_address>|<receiver_account_ref_id> <number_of_coins> [gas_unit_price (default=0)] [max_gas_amount (default 10000)] Suffix 'b' is for blocking.
  Transfer coins from account to another.
help | h
  Prints this help
quit | q!
  Exit this client


Please, input commands:

libra%

创建两个A和B的两个账号

之前的文章中,我们一直在讲A转账10个币给B的故事,那么这里我们就来试验一下,到底是怎么转的。

检查libra cli Client是否运行

libra%命令行提示符表示你的Libra CLI客户端正在运行。 要查看account命令的帮助信息,请输入“ account”,如下所示:

libra% account
usage: account <arg>

Use the following args for this command:

create | c
  Create an account. Returns reference ID to use in other operations
list | la
  Print all accounts that were created or loaded
recover | r <file path>
  Recover Libra wallet from the file path
write | w <file name>
  Save Libra wallet mnemonic recovery seed to disk
mint | mintb | m | mb <receiver account> <number of coins>
  Mint coins to the account. Suffix 'b' is for blocking

创建A的账户

请注意,使用CLI创建帐户不会更新区块链,而只会创建本地密钥对。

要创建爱丽丝的帐户,请输入以下命令:

libra%account create

成功样例输出:

>> Creating/retrieving next account from wallet
Created/retrieved account #0 address 3ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a8

0是A帐户的索引,十六进制字符串是A帐户的地址。 索引只是引用A帐户的一种方式。 帐户索引是本地CLI索引,可以在其他CLI命令中使用,以使用户方便地参考他们创建的帐户。 该索引对区块链没有意义。 仅当通过挖矿将钱添加到Alice的帐户中,或者通过其他用户的转账将资金转移到Alice的帐户中时,才会在区块链上创建Alice的帐户。 请注意,你也可以在CLI命令中使用十六进制地址。 帐户索引只是为了方便账户地址的引用。

创建B的账户

同样的方式,我们创建B的账户。

>> Creating/retrieving next account from wallet
Created/retrieved account #1 address 8337aac709a41fe6be03cad8878a0d4209740b1608f8a81566c9a7d4b95a2ec7

1是B帐户的索引,十六进制字符串是B帐户的地址。

查看账户列表

使用如下命令来查看你的账户列表:

libra% account list

可能的输出如下:

User account index: 0, address: 3ed8e5fafae4147b2a105a0be2f81972883441cfaaadf93fc0868e7a0253c4a8, sequence number: 0
User account index: 1, address: 8337aac709a41fe6be03cad8878a0d4209740b1608f8a81566c9a7d4b95a2ec7, sequence number: 0

帐户的序列号指示已从该帐户发送的交易数量。 每次执行从该帐户发送的交易并将其存储在区块链中时,它都会增加。

给A和B添加Libra币

testnet的挖矿是通过Faucet完成的。 Faucet是与测试网一起运行的服务。 此服务仅在testnet使用,在mainnet是不存在的。 当然它创建的Libra币是没有现实价值的。 假设你已经创建了分别具有索引0和索引1的A和B的帐户,则可以按照以下步骤将Libra添加到这两个帐户中。

给A添加110 LBR

libra% account mint 0 110

0是A帐户的索引。 110是Libra要添加到A帐户的数量。 成功的mint命令还将在区块链上创建A的帐户。

成功的输出如下:

>> Minting coins
Mint request submitted

请注意,提交请求后,这意味着已将其成功添加到(测试网中验证者节点的)内存池中。 它不一定意味着它将成功完成。 稍后,我们将查询帐户余额以确认mint是否成功。

给B添加40 LBR

同样的我们给B也添加40 LBR。

libra% account mint 1 40

查询余额

我们可以输入如下命令来查询上面的mint是否成功执行:

libra% query balance 0

Balance is: 110

libra% query balance 1

Balance is: 40

转账

最激动人心的时刻到了,我们要开始转账了。 我们会将10 LBR从A的账户转给B。 看下如何操作:

libra% transfer 0 1 10

0 是A的index。

1 是B的index。

10 是要转账的LBR数目。

是不是很简单。它的输出如下:

>> Transferring
Transaction submitted to validator
To query for transaction status, run: query txn_acc_seq 0 0 <fetch_events=true|false>

你可以使用命令查询txn_acc_seq 0 0 true(通过帐户和序列号进行交易)来检索有关刚提交的交易的信息。第一个参数是发送者帐户的本地索引,第二个参数是帐户的序列号。

你刚刚将事务提交到testnet上的验证器节点,该事务已包含在验证器的内存池中。这不一定意味着你的交易已执行。从理论上讲,如果系统运行缓慢或过载,则需要花费一些时间才能看到结果,并且你可能必须通过查询帐户进行多次检查。要查询索引为0的帐户,可以使用命令query account_state 0。

如果你想立马返回交易结果,那么可以使用transferb命令(如下所示)代替transfer命令。它仅在将交易提交到区块链后,transferb才会提交交易并返回到客户端提示。一个例子如下所示:

libra% transferb 0 1 10

查看是否转账成功

libra% query balance 0
Balance is: 100
libra% query balance 1
Balance is: 50

好啦,你的第一个交易完成了。就是这么简单。

搭建私链

如果你不想使用testnet, 那么可以参照如下方法来搭建一个私链。

转到Libra Core repository的根目录,然后运行libra_swarm,如下所示:

$ cd ~/libra
$ cargo run -p libra_swarm -- -s

-p libra_swarm 使用cargo来运行libra_swarm软件包,该软件包启动由一个节点组成的本地区块链。

-s选项启动本地客户端以连接到本地区块链。

要查看用于启动节点并连接到Libra区块链的其他选项,请运行:

$cargo -p libra_swarm -- -h

cargo运行命令可能需要一些时间才能运行。 如果该命令的执行没有错误,则说明你的系统上正在运行Libra CLI客户端实例和Libra验证器节点。 成功执行后,你应该看到包含CLI客户端菜单和libra%提示符的输出。

更多教程请参考 flydean的博客