IOV Weave SDK快速教程 - 基于Tendermint的区块链开发框架

IOV Weave SDK是一个基于Tendermint共识引擎的区块链开发框架,Weave提供了 很多常用功能的预置模块用于你自己的区块链,同时也支持自定义扩展。

Weave的一些亮点包括基于Merkle树的数据存储、高度灵活的扩展支持系统以及 核心逻辑的定制(例如手续费机制及签名验证机制)。Weave也支持利用创世 文件进行定制的能力。此外,在键-值库之上,Weave还提供了一个简单的对象关系 映射层(ORM),可以支持二级索引。Weave还包含了动态迁移功能,利用链上 交易就可以切换某些逻辑模块的启用或关闭。

1、预置模块

要快速掌握区块链和数字货币应用开发,推荐汇智网的 区块链开发系列在线教程。 内容涵盖比特币、以太坊、EOS、超级账本、Tendermint等多种主流区块链 平台, 同时支持Java、C#、Python、PHP、JavaScript、Dart等多种开发 语言。

Weave开发框架内置了开发一个应用区块链所需的常用功能模块:

  • Cash:钱包模块,支持代币及手续费扣除
  • Sigs:签名模块,用于验证ed25519签名
  • Multisig:多签模块,用于多签名合约的支持,允许修改成员隶属关系
  • AtomicSwap:原子交换模块,支持跨链的原子交换
  • Escrow:托管模块,仲裁者可以安全地持有代币,或者基于超时规则释放托管资金
  • Governance:治理模块,管理链上提议的治理规则的选举,或者直接修改应用参数
  • PaymentChannels:单向支付通道模块,实现微支付和链上结算
  • Distribution:分配模块,利用配置信息在多个参与者之间分配收入,可用于分配手续费收入
  • Batch:批处理模块,用于将多个交易整合为单一原子操作,一个应用场景就是单一链上交换
  • Validators:验证人模块,用于PoA共识上下文中的验证人集合更新,使用多签或链上选举模块
  • Username:用户名模块,将用户名映射为链上地址,支持反向查询
  • MessageFee:消息手续费模块,用于对抗垃圾信息
  • Utils:工具模块,包含一组常用的辅助功能

2、Weave开发框架概述

要使用Weave开发框架,需要两个组件:

  • blog:weave提供的定制ABCI博客应用
  • tendermint:区块链共识引擎

如果你还没接触过Tendermint,建议参考汇智网的Tendermint开发详解。 Weave的应用通信框架如下:

1
2
3
+---------+                     +------------+                      +----------+
| blog | <- (local) ABCI -> | Tendermint | <- websocket -> | client |
+---------+ +------------+ +----------+

blog和tendermint运行在同一台计算机上,通过二进制TCP/IP协议或UNIX套接字通信,这两者 结合在一起构成了区块链。在实际的生产环境中,你可能会有多个计算机运行这一后端,彼此 之间通过自调节的p2p gossip协议通信来实现状态的复制。对于应用开发而言,一个节点就够了, 但是单一节点是没有容错能力的。

你可以使用任何websocket客户端连接tendermint的rpc,不过我们还是推荐使用 IOV core, 毕竟它和Weave是同一家的产品,对Weave开发框架的支持更好。

在安装上述两个组件之前,需要在你的计算机上先安装如下组件:

  • golang 1.11.4+
  • tendermint 0.31.5
  • weave
  • docker

然后克隆blog代码库并根据兼容表 检出兼容的版本。例如:

1
2
3
4
5
6
7
8
9
# cd into to your workspace that is not in your $GOPATH
git clone https://github.com/iov-one/blog-tutorial
cd blog-tutorial
make install
# test it built properly
tendermint version
# 0.3X.X-YYYYYYYY
blog version
# v0.1X.X-YYYYYYYY

3、初始化应用区块链

在启动区块链之前,我们需要利用创世区块设置初始状态。tendermint和blog都有一个 目录来保存配置信息和内部数据库状态。默认目录为:~/.tendermint~/.blog。 不过为了简化考虑,我们将所有配置信息放到同一个目录。

首先,创建一个默认的创世文件、用来签名区块的私钥以及默认的配置文件:

1
2
3
4
# make sure you really don't care what was in this directory and...
rm -rf ~/.blog
# initialize state on default folder ~/.blog
make inittm

你可以浏览一下这个目录,其中最重要的是~/.blog/config/genesis.json,在配置 文件~/.blog/config/config.toml中也包含了很多选项。

在启动区块链之前,我们要为刚创建的账户添加一批代币,同时也要启用索引器,这样 我们就可以按id搜索交易了。但是我们没有直接修改配置文件,而是用如下的命令:

1
blog init CASH bech32:tiov1qrw95py2x7fzjw25euuqlj6dq6t0jahe7rh8wp

确保你输入的地址和上面一致。这个账户现在就有代币了。在运行上述命令之后,你也可以 看一下~/.blog/config/genesis.json。 比较重要的修改是”app_state”。

你可能会问,这个地址是哪里来的。这是一个使用如下的测试助记词生成的演示账户:

1
dad kiss slogan offer outer bomb usual dream awkward jeans enlist mansion

账户的派生路径为:m/44'/988'/0'

4、启动应用区块链

我们已经有了私钥,并且进行了配置,现在可以启动我们的blog应用区块链了:

1
2
3
# start the tendermint with default config
make runtm
blog start

上面的命令连接tcp://localhost:26658,如果你希望使用unix套接字,可以 使用如下命令:

1
2
tendermint node --home ~/.blog --proxy_app=unix://$HOME/abci.socket > ~/.blog/tendermint.log &
blog start -bind=unix://$HOME/abci.socket

打开一个新的终端窗口,使用命令tail -f ~/.blog/tendermint.log,就可以 看到我们的blog区块链节点的输出了:

weave log


原文链接:IOV Weave SDK

汇智网翻译整理,转载请标明出处