相信很多朋友已经在使用Substrate2.0构建自己的runtime模块,但官方Substrate开发者中心还没有2.0版本的教程。
在本文中,我整理总结了如何使用Substrate2.0启动一个区块链网络,并使用你选择的验证者/管理者集合。
你需要:
一个Linux或Mac操作系统下的命令行客户端
Git
你将学习到:
从源代码编译一个Substrate节点
为区块链网络中的验证人生成ed25519密钥对
创建和编辑chainspecjson文件
编译所需工具
Substrate是一个开源区块链开发框架,用来构建你自己的区块链,以及可以用来开发各种各样的去中心化应用程序。
目前Substrate没有提供二进制安装包,因此必须从源代码中编译它,这可能是一个耗时的过程。
Substrate仓库会经常更新,请确保参加此网络的每个节点都有同样版本的Substrate以保证成功。在实践中,类似但不完全相同的版本通常可以正常工作,但是依靠这个通常会让人感到沮丧。
我们将使用master分支的这个commit来获取更多的一致性。
首次操作
首先,我们将通过gitclone下载Substrate代码。目前还没有v2.0的分支。
gitclonehttps://github.com/paritytech/substrate
cdsubstrate
仓库中包含一个名为subkey的工具,我们需要用它来生成和检查密钥对。让我们先编译它。--force选项意味着我们将移除之前安装的版本,重新安装此版本。
cargoinstall--force--pathsubkeysubkey
现在让我们编译我们将要运行的区块链节点。由于Substrate是一个框架,使用它编写自定义的runtime代码。之前写过文章详细涵盖了这方面的内容。
辽宁省“十四五”规划:利用区块链等技术 建设面向消费品行业的服务平台:2月1日,辽宁省政府新闻办召开贯彻省“两会”精神新闻发布会。会议指出,“十四五”期间,辽宁省工信厅将加强新一代信息技术与制造业融合,用数字经济为优势产业赋能增效,打造一批典型应用场景,布局一批智能工厂、智能车间,加快培育网络化协同、智能化制造等新模式新业态。利用区块链等技术,建设面向消费品行业的服务平台,扩大个性化定制产品占比。(辽宁日报)[2021/2/2 18:41:19]
Substrate仓库本身已经有两个随时可以运行的节点环境。
第一个在node目录,它包含了许多功能,可以构建实际可运行的区块链。事实上,它看起来和Polkadot类似,它也是基于Substrate构建的。
第二个是在node-template目录下的最小化runtime代码。我们将在本文中使用节点模板node-template,因为它比较简单,通常是编写自定义runtime的起点。
#切换到node-template目录
cdnode-template
#确保你的rusttoolchain是最新的
./scripts/init.sh
#编译本地节点版本
cargobuild
下次更新
更新或改变Substrate版本时,这个过程类似,但构建速度更快。
cdnode-template
./scripts/init.sh
cargobuild
提示:如果想要node-template安装在可执行文件路径下,你可以在上一步使用cargoinstall代替cargobuild。
Alice和Bob启动区块链
在我们生成自己的密钥并启动一个真正特定的Substrate网络之前,让我们了解下基础知识,首先使用一个预先定义的网络规范,称为local,使用两个预先定义的密钥,称为Alice和Bob。
Alice首先启动
声音 | 华夏时报总编辑:如果谁能用区块链做出比肩比特币的技术 也许就是下一个世界首富:据新浪财经报道,在第十二届中国经济媒体高层峰会上,华夏时报总编辑水皮表示,未来新技术的应用也许会出现我们意想不到的投资机会,那就是5G带来的区块链技术的应用,“区块链”三个字,由于局信息会上这么一堂课,又一次引起了全民的冲动。我们华夏时报前两年也干过两届区块链论坛,但这个东西技术上的确是有一定的难度,现象级的产品开发是需要过程的,到现在为止比特币是最成功的现象级的应用,有没有能跟比特币比肩的技术?如果谁能做出这个突破谁就牛大了,也许就是下一个中国首富、世界首富。[2019/12/1]
Alice应该从Substrate仓库的根目录运行此命令。
#如果你仍然在node-template/目录
cd..
#启动节点
./target/debug/node-template
--base-path/tmp/alice
--chain=local
--alice
我们了解一下这些命令选项的含义:
--base-path指定一个目录,Substrate用它来存储与此链有关的所有数据。如果目录不存在,将创建它。如果已经存在其它区块链的数据,启动将会报错。这种情况下,要么清除目录,要么选择不同的目录。
--chain=local指定要使用的链规范。有几个预先准备的选项,包括local,dev等,但我们要指定自己的chainspec文件。
--alice指定我们正在使用预定义的Alice密钥作为此节点的验证者。这里是和v1.0的不同之处,v2.0使用这个快捷方式替代v1.0中--nameAlice--validator,同时Alice的会话密钥会被添加到keystore文件中。
chainspec文件和keystore文件,这两个我们将在稍后阶段说明。
当节点启动后,你应该看到类似下面的输出:
2019-09-0407:25:11SubstrateNode
动态 | 央行上海总部:发展区块链技术 远离虚拟货币炒作:金色财经报道,11月25日消息,中国人民银行上海总部微信公众号推文,区块链不等于虚拟货币,发展区块链技术,远离虚拟货币炒作。[2019/11/25]
2019-09-0407:25:11version2.0.0-d8589ad-x86_64-macos
2019-09-0407:25:11byAnonymous,2017,2018
2019-09-0407:25:11Chainspecification:LocalTestnet
2019-09-0407:25:11Nodename:Alice
2019-09-0407:25:11Roles:AUTHORITY
2019-09-0407:25:11InitializingGenesisblock/state(state:0x2b2e…9b06,header-hash:0x7d3d…f9e9)
2019-09-0407:25:11LoadingGRANDPAauthoritysetfromgenesisonwhatappearstobefirststartup.
2019-09-0407:25:11Loadedblock-time=BabeConfiguration{slot_duration:10000,c:(1,4),median_required_blocks:1000}secondsfromgenesisonfirst-launch
2019-09-0407:25:11CreatingemptyBABEepochchangesonwhatappearstobefirststartup.
2019-09-0407:25:11Highestknownblockat#0
2019-09-0407:25:11UsingdefaultprotocolID"sup"becausenoneisconfiguredinthechainspecs
2019-09-0407:25:11Localnodeidentityis:QmbqmYrUEMcPFqnKjBAjZXgZBgpFs9Xsp5zhpbPXtENngE
声音 | 王钦敏:有效应用区块链等技术 为金融市场提供新业务模式:据经济参考报报道,“2019普惠金融高峰论坛” 6月28日在北京举行。第十二届全国政协副主席、国家电子政务专家委员会主任王钦敏在发言中指出,各行各业+互联网”已成了创新发展的普遍选择。面向金融供给侧结构性改革的课题,有必要利用新技术创新传统金融行业所提供的产品和服务,以提升效率、降低风险和运营成本。特别是有效应用大数据、区块链、云计算、人工智能等新一代信息技术,为金融市场提供新业务模式、新信息平台、新产品服务。[2019/6/29]
2019-09-0407:25:16Idle(0peers),best:#0(0x7d3d…f9e9),finalized#0(0x7d3d…f9e9),?0?0
你可以通过节点在命令行中产生的输出了解很多信息。需要注意的几行:
Nodename:Alice显示指定的节点名称,这里是预定义的Alice
Localnodeidentityis:QmbqmYrUEMcPFqnKjBAjZXgZBgpFs9Xsp5zhpbPXtENngE节点ID,Bob节点启动时需要依赖此ID
还有一些选项,大家可以通过./target/debug/node-template--help去了解,比如:
--port30333指定节点将监听的p2p端口。默认是30333,如果Bob的节点在同一物理机上运行,就需要明确指定一个不同的端口。
--ws-external默认情况下,节点监听9944端口上的RPC连接,只有本地主机的连接会被接受,但你可以通过指定它改变此行为。你也可以通过指定--ws-port12345更改端口。
--rpc-cors指定允许访问HTTP和WSRPC服务器的浏览器来源Origins。它是以逗号分隔的来源列表。all值将禁用来源验证。默认是允许localhost,https://polkadot.js.org和https://substrate-ui.parity.io这些来源。此处有个坑!在--dev模式下运行时,默认设置为允许所有来源。
连接UI
动态 | 新任南非总统儿子看好区块链技术 并将发起南非首所区块链大学:据Beincrypto消息,新当选的南非总统的儿子Tumelo Ramaphosa是非洲区块链的倡导者,看好加密货币有可能为非洲大陆的无银行账户提供银行服务,在其父亲的宣誓就职仪式上穿了比特币主题的袜子。并且今年,Tumelo将领导发起南非第一所面向年轻企业家的区块链大学。他希望通过教育,可以为南非、非洲大陆其他地区和美国等其他地区蓬勃发展的区块链产业搭建桥梁。[2019/5/27]
有一个很好的图形用户界面,称为PolkadotJsAppsUI,可以用它连接你的节点。之前写过文章详细涵盖了这方面的内容。
点击链接会跳转到该UI的官方页面,非常方便,但与你正在运行的Substrate版本相比可能已经过时。在UI页面过期的情况下,你可以通过从github获取代码在本地运行该应用。一般来说,其仓库中的指令将是你的最佳指南,但大致过程应该是这样的。
#抓取代码
gitclonehttps://github.com/polkadot-js/apps
cdapps
#安装依赖
yarn
#启动项目
yarnrunstart
你会注意到,在命令行和用户界面中,还没有产生任何块。一旦另一个验证者加入网络,将开始生成区块。
Bob加入
现在,Alice节点已经启动并运行,Bob可以通过引导节点来加入网络。他的启动命令类似下面:
./target/debug/node-template
--base-path/tmp/bob
--chain=local
--bob
--bootnodes/ip4//tcp//p2p/
上面已经解释了大多数这些选项,但有几个要注意的地方:
如果这两个节点在同一物理机器上运行,Bob必须指定一个不同的路径--base-path和端口--port。
--bootnodes选项,Bob必须正确指定以下三项:
Alice的IP地址,格式192.168.1.1
Alice的端口,可能为30333
Alice节点ID,从上面日志输出中复制(QmbqmYrUEMcPFqnKjBAjZXgZBgpFs9Xsp5zhpbPXtENngE)
如果所有进展顺利,在几秒之后,节点应该相互连接,开始生成区块。你应该看到类似下面的内容:
Idle(1peers),best:#1(0x9f1b…9b57),finalized#1(0x28be…45e5),?1.7kiB/s?1.4kiB/s
此行显示,Bob有对等节点Alice(1peers),它们产生了一个区块(best:#1(0x9f1b…9b57)),并且区块已被最终确定/敲定(finalized#1(0x28be…45e5))。
这也是v2.0和v1.0的区别之处。v2.0的节点模板中增加引用了Grandpa模块来做最终一致性,而在v1.0的网络中,只有创世区块会被最终敲定,v1.0的节点模板中没有最终一致性模块。
生成密钥
现在我们知道了基本原理和命令行选项,是时候生成我们自己的密钥而不是使用众所周知的Alice和Bob密钥。
每个想要加入这个区块链网络的人,都可以使用我们之前提到的subkey工具,或PolkadotJSAppsUI生成自己的密钥。在本文中,我们将使用RPC调用。该小节是本文更有价值的一部分内容。
生成key
对于大多数想要运行验证节点的用户,可以使用author_rotateKeys这个RPC调用。该RPC调用将生成会话密钥sessionkey,并返回其公钥publickey。命令如下:
curl-H'Content-Type:application/json'--data'{“jsonrpc”:“2.0”,“method”:“author_rotateKeys”,“id”:1}'localhost:9933
导入keystore
如果会话密钥需要匹配固定种子seed,则可以按类型单独设置它们。RPC调用需要密钥种子和密钥类型。此处列出了Substrate中默认支持的类型。命令如下:
curl-H'Content-Type:application/json'--data'{"jsonrpc":"2.0","method":"author_insertKey","params":,"id":1}'localhost:9933
KEY_TYPE-需要用4个字符的类型标识符替换,比如:ed25
SEED-是密钥的种子seed
PUBLIC-给定密钥的公钥
启动你的私有区块链
上一次,我们使用--chain=local这是一个预定义的chainspec,它将Alice和Bob指定为验证人以及许多其他的默认值。本节将介绍如何创建自己的chainspec。
创建chainspec
我们不是从头开始完全编写chainpec,而是对我们之前使用的那个进行一些修改。
首先,我们需要将chainspec导出到json文件。
./target/debug/node-templatebuild-spec--chain=local>customSpec.json
我们刚创建的文件包含几个字段,人们可以通过探索它们来学习很多东西。目前,最长的字段是一个十六进制编码的数据,它是我们runtime的wasm的二进制。
我们感兴趣的部分,是像这样的验证人地址:
"consensus":{
"authorities":[
"5FA9nQDVg267DEd8m1ZypXLBnvN7SFxYwV7ndqSYGiN9TTpu",
"5GoNkf6WdbxCFnPdAnYYQyCjAKPJgLNxXwPjwTh6DGg6gN3E",
],
"code":
}
我们需要做的就是将列出的验证人地址更改为我们在上一步中生成的地址。
注意:应该由一个人执行这些步骤,并共享生成的文件给其他验证人。因为从rust->wasm的构建不是“可重现的”,每个人都会得到一个略有不同的wasmblob,如果每个参与者自己生成文件,这将破坏共识。
准备好chainspec后,将其转换为“raw”chainspec。regular和raw之间的区别只是所有字段在"raw"chainspec中编码为了十六进制。
./target/debug/node-templatebuild-spec--chaincustomSpec.json--raw>customSpecRaw.json
最后与网络中的所有其他验证人共享customSpecRaw.json。
启动链
你已完成所有必要的准备工作,现在准备好启动链。此过程非常类似于之前以Alice和Bob的身份启动链。
从干净的目录开始非常重要,如果你打算使用之前的目录,请删除该目录中的所有内容。
第一位参与者启动节点:
./target/debug/node-template
--chain./customSpecRaw.json
--validator
--namelester
以下是我们启动Alice时的一些不同之处。
--validator表示节点将参与出块而不是仅仅同步网络数据。
--name给节点取个可读性高的名字。
后续验证人现在可以像Bob之前一样加入网络,确保使用新的chainspec和密钥。你可以使用网络中任意已有的节点引导,而不仅是之前的节点。
小结
恭喜你!你已启动了自己的区块链!
在本文中,你学会了编译节点模板,生成自己的公私钥对,创建一个自定义的链,使用这些密钥对,并根据自定义chainspec和节点模板启动了一个私有区块链网络。
郑重声明: 本文版权归原作者所有, 转载文章仅为传播更多信息之目的, 如作者信息标记有误, 请第一时间联系我们修改或删除, 多谢。