Tendermint 中文文档

# 入门指南

# 第一个 Tendermint 应用

作为一个通用的区块链引擎，Tendermint 与您想要运行的应用程序无关。因此，要运行一个完整的区块链来做一些有用的事情，您必须启动两个程序：一个是 Tenderint Core，另一个是您的应用程序，它可以用任何编程语言编写。回想一下介绍 ABCI， Tendermint Core 处理所有的 p2p 和协商一致的东西，当它们需要验证时，或者当它们准备提交到一个块时，就会将交易转发给应用程序。

在本指南中，我们将向您展示一些如何使用 Tendermint 运行应用程序的示例。

# 安装

我们将使用的第一个应用程序是用 Go 编写的。要安装它们，您需要安装 Go 并将 $GOPATH/bin 放在 $PATH 中；更多信息请参见此处。

然后运行

go get github.com/tendermint/tendermint
cd $GOPATH/src/github.com/tendermint/tendermint
make get_tools
make get_vendor_deps
make install_abci
1
2
3
4
5

现在应该安装了 abci-cli；您将看到两个命令(counter 和 kvstore)，它们是用 Go 编写的示例应用程序。下面是用 JavaScript 编写的应用程序。

现在，让我们运行一些应用程序！

# KVStore - 第一个例子

kvstore 应用程序是一个 默克尔树，它只存储所有交易。如果交易包含 =，例如：key=value，然后 value 存储在默克尔树的 key 下。否则，完整的交易字节存储为键和值。

让我们启动一个 kvstore 应用程序。

abci-cli kvstore
1

在另一个终端，我们可以开始 Tendermint。如果你从未使用过 Tendermint，请使用：

tendermint init
tendermint node
1
2

如果您使用过 Tendermint，您可能希望通过运行 tendermint unsafe_reset_all 来重置新区块链的数据。然后你可以运行 tendermint node 来启动tendermint，并连接到应用程序。详情请参阅 Tendermint 使用指南。

你应该看看 Tendermint！我们可以得到我们的 Tendermint 节点的状态如下：

curl -s localhost:26657/status
1

-s 只是沉默 curl。为了得到更好的输出，可以将结果导入到 jq 或 json_pp 之类的工具中。

现在让我们将一些交易发送到 kvstore。

curl -s 'localhost:26657/broadcast_tx_commit?tx="abcd"'
1

注意 url 周围的单引号(')，这确保 bash 不会转义双引号(")。这个命令发送了一个带有字节 abcd 的交易，因此 abcd 将作为键和值存储在默克尔树中。响应应该是这样的：

{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "check_tx": {},
    "deliver_tx": {
      "tags": [
        {
          "key": "YXBwLmNyZWF0b3I=",
          "value": "amFl"
        },
        {
          "key": "YXBwLmtleQ==",
          "value": "YWJjZA=="
        }
      ]
    },
    "hash": "9DF66553F98DE3C26E3C3317A3E4CED54F714E39",
    "height": 14
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

我们可以通过查询应用程序来确认我们的交易是否正常工作，以及是否存储了值:

curl -s 'localhost:26657/abci_query?data="abcd"'
1

结果应该如下：

{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "response": {
      "log": "exists",
      "index": "-1",
      "key": "YWJjZA==",
      "value": "YWJjZA=="
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12

注意结果中的 value (YWJjZA==)；这是 abcd ASCII 的 base64 编码。您可以在 python2 shell 中运行 "YWJjZA==".decode('base64') 来验证这一点，或者在 python3 shell 中运行 import codecs; codecs.decode("YWJjZA==", 'base64').decode('ascii')。 请继续关注将来的版本，该版本使输出更具可读性。

现在让我们尝试设置一个不同的键和值：

curl -s 'localhost:26657/broadcast_tx_commit?tx="name=satoshi"'
1

现在，如果我们查询 name，应该会得到 satoshi 或 base64 的 c2F0b3NoaQ==：

curl -s 'localhost:26657/abci_query?data="name"'
1

尝试一些其他交易和查询，以确保一切正常工作！

# Counter - 另一个例子

现在我们已经掌握了窍门，让我们尝试另一个应用程序，counter 应用程序。

计数器应用程序不使用默克尔树，它只计算我们发送交易或提交状态的次数。

这个应用程序有两种模式：serial=off 和 serial=on。

当 serial=on 时，交易必须是一个以大端编码的递增整数，从 0 开始。

如果 serial=off，则对交易没有限制。

在活动的区块链中，交易在提交到块之前收集到内存中。为了避免在无效的交易上浪费资源，ABCI 提供了 CheckTx 消息，应用程序开发人员可以使用它来接受或拒绝交易，然后再将交易存储在内存中或传递给其他节点。

在这个计数器应用程序的实例中，使用 serial=on，CheckTx 只允许整数大于最后提交的整数的交易。

让我们终止之前的 tendermint 实例和 kvstore 应用程序，并启动计数器应用程序。我们可以使用一个标记启用 serial=on：

abci-cli counter --serial
1

在另一个窗口，重置，然后开始 Tendermint：

tendermint unsafe_reset_all
tendermint node
1
2

同样，您可以看到块流过去。让我们发送一些交易。由于我们设置了 serial=on，第一个交易必须是数字 0：

curl localhost:26657/broadcast_tx_commit?tx=0x00
1

注意空响应(因此成功)。下一个交易必须是数字 1。如果相反，我们试图发送一个 5，我们得到一个错误：

> curl localhost:26657/broadcast_tx_commit?tx=0x05
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "check_tx": {},
    "deliver_tx": {
      "code": 2,
      "log": "Invalid nonce. Expected 1, got 5"
    },
    "hash": "33B93DFF98749B0D6996A70F64071347060DC19C",
    "height": 34
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

但如果我们发送一个 1，它又会工作:

> curl localhost:26657/broadcast_tx_commit?tx=0x01
{
  "jsonrpc": "2.0",
  "id": "",
  "result": {
    "check_tx": {},
    "deliver_tx": {},
    "hash": "F17854A977F6FA7EEA1BD758E296710B86F72F3D",
    "height": 60
  }
}
1
2
3
4
5
6
7
8
9
10
11

有关 broadcast_tx API 的详细信息，请参阅 Tendermint 使用指南。

# CounterJS - 另一种语言的例子

我们还想用另一种语言运行应用程序 - 在本例中，我们将运行 counter 的 Javascript 版本。要运行它，您需要 [安装] node](https://nodejs.org/en/download/)。

您还需要从此处获取相关的存储库，然后安装它:

git clone https://github.com/tendermint/js-abci.git
cd js-abci
npm install abci
1
2
3

终止之前的 counter 和 tendermint 过程。现在运行应用程序：

node example/counter.js
1

在另一个窗口，重置并启动 tendermint：

tendermint unsafe_reset_all
tendermint node
1
2

再一次，您应该看到块流出 - 但现在，我们的应用程序是用 Javascript 编写的!尝试发送一些交易，像以前一样 - 结果应该是相同的：

# ok
curl localhost:26657/broadcast_tx_commit?tx=0x00
# invalid nonce
curl localhost:26657/broadcast_tx_commit?tx=0x05
# ok
curl localhost:26657/broadcast_tx_commit?tx=0x01
1
2
3
4
5
6

平滑的，是吗？

← 使用 ABCI-CLI →