Hyperledger - 超级账本项目

2015 年 12 月,开源世界的旗舰——Linux 基金 会牵头,

联合 30 家初始企业成员(包括 IBM、Accenture、Intel、J.P.Morgan、R3、DAH、DTCC、FUJITSU、HITACHI、SWIFT、 Cisco 等),

共同 宣告 了 Hyperledger 项目的成立。该项目试图打造一个透明、公开、去中 心化的分布式账本项目,作为区块链技术的开源规范和标准,

让更多的应用能更容易的建立 在区块链技术之上。项目官方信息网站在 hyperledger.org

 

目前主要包括三大账本平台项目和若干其它项目。

账本平台项目:

    Fabric:包括 Fabric、Fabric CA、Fabric SDK(包括 Node.Js、Python 和 Java 等语 言)和 fabric-api、fabric-sdk-node、fabric-sdk-py 等,

        目标是区块链的基础核心平台, 支持 pbft 等新的 consensus 机制,支持权限管理,最早由 IBM 和 DAH 发起;

    SawToothLake:包括 arcade、core、dev-tools、validator、mktplace 等。是 Intel 主要 发起和贡献的区块链平台,支持全新的基于硬件芯片的共识机制 Proof of Elapsed Time(PoET)。

    Iroha:账本平台项目,基于 C++ 实现,带有不少面向 Web 和 Mobile 的特性,主要由 Soramitsu 发起和贡献。

其它项目:

    Blockchain Explorer:提供 Web 操作界面,通过界面快速查看查询绑定区块链的状态 (区块个数、交易历史)信息等。

    Cello:提供"Blockchain as a Service" 功能,使用 Cello,管理员可以轻松获取和管理多 条区块链;应用开发者可以无需关心如何搭建和维护区块链。

• BlockChain Explorer 展示和查询区块链块、事务和相关数据的 Web应用

• Fabric 区块链技术的一个实现

• STL - Sawtooth Lake 高度模块化的分布式账本平台

• Iroha 轻量级的分布式账本, 侧重于移动

• Cello BaaS的工具集,帮助创建、管理、终止区块链


开发和提交代码


安装环境

推荐在 Linux(如 Ubuntu 14.04+)或 MacOS 环境中开发代码,并安装如下工具。

git:用来获取代码。

golang 1.6+:

安装成功后需要配置 $GOPATH 等环境变量。

Docker 1.12+:用来支持容器环境,注意 MacOS 下要用 Docker for Mac。

获取代码

首先注册 Linux foundation ID,并登陆 https://gerrit.hyperledger.org/,添加个人 ssh pub key。

查看项目列表,找到对应项目,以 fabric 为例,采用 Clone with commit-msg hook 的方式来 获取。

典型的,执行如下命令获取代码,放到 $GOPATH/src/github.com/hyperledger/ 路径下,其中 LF_ID 替换为你的 Linux foundation id。

    $ mkdir $GOPATH/src/github.com/hyperledger/

    $ cd $GOPATH/src/github.com/hyperledger/

    $ git clone ssh://[email protected]:29418/fabric && scp -p -P 29418 LF_ID@g errit.hyperledger.org:hooks/commit-msg fabric/.git/hooks/

如果没有添加个人 ssh pubkey,则可以通过 https 方式 clone,需要输入用户名和密码信息。

    git clone http://[email protected]/r/fabric && (cd fabric && curl -kLo `git rev-parse --git-dir`/hooks/commit-msg http://[email protected]/r/tools/hoo ks/commit-msg; chmod +x `git rev-parse --git-dir`/hooks/commit-msg)

编译和测试

大部分编译和安装过程都可以利用 Makefile 来执行,包括如下常见操作。

安装 go tools

    执行 $ make gotools

语法格式检查

    执行 $ make linter

编译 peer

    执行 $ make peer

会自动编译生成 Docker 镜像,并生成本地 peer 可执行文件。

注意:有时候会因为获取安装包不稳定而报错,需要执行 make clean ,然后再次执行。

生成 Docker 镜像

    执行 $ make images

执行所有的检查和测试

    执行 $ make checks

执行单元测试

    执行 $ make unit-test

如果要运行某个特定单元测试,则可以通过类似如下格式。

    $ go test -v -run=TestGetFoo

执行 BDD 测试

    需先生成本地 Docker 镜像。

    执行 $ make behave

提交代码

    仍然使用 Linux foundation ID 登录 jira.hyperledger.org,查看有没有未分配的任务,如果对 某个任务感兴趣,可以添加自己为 assignee,如对 FAB-XXX 任务。

    本地创建新的分支 FAB-XXX。

        $ git checkout -b FAB-XXX

     实现任务代码,完成后,执行语法格式检查和测试等,确保所有检查和测试都通过。 提交代码到本地仓库。

         $ git commit -a -s

     会打开一个窗口需要填写 commit 信息,格式一般要求为:

          Simple words to describe main change This fixes #FAB-XXX.

          A more detailed description can be here, with several paragraphs and sentences...

     之后使用 git review 命令推送到远端仓库。

          $ git review

     提交成功后,可以打开 gerrit.hyperledger.org/r/,查看自己最新提交的 patchset 信息,添加 几位 reviewer。

     之后就是等待开发者团队的 review 结果,如果得到通过,则会被项目的 maintainer 们 merge 到主分支。

     否则还需要针对大家提出的建议进一步的修正。

     修正过程跟提交代码过程类似,唯一不同是提交的时候使用

          $ git commit -a --amend

     表示这个提交是对旧提交的一次修订。

 

完整流程

总结,完整的流程如下图所示。

 

Hyperledger 是 Linux 基金会支持的分布式账本平台,这是开源界试图构建一套标准化分布式 账本平台的重要尝试。

类似的项目还包括 以太坊平台、R3 CEV 牵头的 Corda 项目、微软的 bletchley 项目 等。


猜你喜欢

转载自blog.csdn.net/weixin_41926234/article/details/80623491