>

简介

Tendermint 是基于 POS 的一种开源区块链共识算法,其对传统的三轮共识过程做了优化,只需要两轮(prevote,precommit)即可达成共识,因其出色的设计得到了广泛的使用。

本文介绍其简单使用

安装

执行如下命令获取源码并安装

1
2
go get github.com/tendermint/tendermint/cmd/tendermint
go install ./cmd/...

上述命令会把二进制 tendermint 安装在 $GOBIN 目录,安装成功之后,执行 tendermint --help 来查看帮助信息。

如果上述命令没有安装成功,则下载 glide 来进行安装必要的依赖,具体步骤如下:

1
2
3
4
go get github.com/Masterminds/glide
cd $GOPATH/src/github.com/tendermint/tendermint
glide install
go install ./cmd/...

运行

默认情况下,tendermint 使用 $HOME/.tendermint 目录作为所有节点数据目录,可以修改环境变量 $TMROOT 来改变指向。

执行步骤是:先初始化,再运行节点
(1) tendermint init
这一步会创建一个私钥 priv_validator.json,和一个创世文件 genesis.json,这个创世文件包含了公钥。
(2) tendermint node
这一步是运行节点,启动后会自动连接 ABCI app,ABCI app 的侦听端口是 127.0.0.1:46658。 如果 ABCI app 没有启动,那么执行 tendermint node 会提示无法连接,如下:

注意: 这里的 ABCI app 就是指 ABCI Server,而不是 ABCI client, tendermint node 相当于 ABCI client。

tendermint 提供了两个 app server,dummy 和 counter,它们都会侦听 46658 端口(不能同时运行 dummy 和 counter,端口冲突)。
先在其他 terminal 运行 dummy,其会侦听 46658 端口。

启动 dummy 之后,再运行 tendermint node。如果没有安装 dummy 的话,也可以直接在 tendermint 中运行一个进程内的 dummy,这相当于运行了一个单一的 blockchain 节点,如下:

1
2
tendermint init
tendermint node --proxy_app=dummy

记住:这里 dummy 和 counter 名字虽然叫 app,但其相对 tendermint core 而言,是 ABCI Server, 而 tendermint node 则是 ABCI client。

以下的所有 ABCI App 都是值 ABCI Server。

ABCI App 被设计成跨语言的一个模块,作为一个独立的进程存在,也就是说,我们可以用任何语言来编写 ABCI app。比如,我们用其他语言编写了一个符合 ABCI 通信接口的 App,我们可以在指定 tendermint node 时通过 –proxy_app 选项来指定连接到该 App ,比如:

1
tendermint node --proxy_app=/var/run/abci.sock

执行上述命令之后,tendermint 会启动并连接 proxyApp,如果没有指定 –proxy_app,那么默认会连接到 localhost:46658。
注意这里,这里指定了 –proxy_app 的话,会连接该 app 侦听的端口。

此外,tendermint core 除了主动连接上述 proxy_app 的端口之外,还会侦听两个本地端口,分别是 p2p: 46656 和 rpc: 46657。

46656 是 core 节点 peer 之间交互的端口
46657 是 core 节点侦听 rpc 请求的端口。(实质是 app 通过该端口向 core 发送 RPC 请求)

交易

交易通常是由 App 发起的,我们可以通过 curl 命令来模拟发请求给 Tendermint core 的
RPC server,比如:

1
curl http://localhost:46657/broadcast_tx_commit?tx=\"abcd\"

RPC server 返回的结果是 json 格式,想要获得好的显示效果,可以下载 jsonpp 来进行 pretty print。

查看 status

1
curl http://localhost:46657/status | jsonpp

Tendermint Networks

Tendermint 网络中节点有两种类型:validator node 和 non-validator node。

If we want to add more nodes to the network, we have two choices: we can add a new validator node, who will also participate in the consensus by proposing blocks and voting on them, or we can add a new non-validator node, who will not participate directly, but will verify and keep up with the consensus protocol.

当 tendermint core 收到一个 rpc 交易请求,并完成共识之后,会给 app server 发送请求。

如何创建一个 Tendermint App

创建能运行在 tendermint core 上的 application 需要符合 ABCI,因为 core 会按照 ABCI 定义好的请求格式向 APP 发送请求,因此 app 必须能正确处理 ABCI 格式的请求。

因此,我们需要下载安装 ABCI ,步骤如下:

1
go get -u github.com/tendermint/abci/cmd/...

abci 提供了两个简单的 app:dummy 和 counter,还提供了一个 abci-cli 工具(用于向 ABCI server 发送 grpc 请求或者普通的 socket 请求)

ABCI-CLI

tendermint core 中有一个 proxy 包,它提供 NewABCIClient() 函数用来创建一个 abci client, core 用其连接 App ABCI Server

ABCI Server

abci/server 目录中定义了两种 server 类型: socket server 和 grpc server。


如果你对我的文章感兴趣,欢迎留言或者关注我的专栏。

微信公众号:“知辉”

搜索“deliverit”或

扫描二维码