超级帐本Fabric区块链用弹珠游戏Marbles 部署

Marbles 演示

Marbles GitHub地址

关于 Marbles

• 这个应用程序的基础网络是 Hyperledger Fabric，后者是一个 Linux Foundation 项目。您可能想查阅如下操做说明来稍微了解一下 Hyperledger Fabric。
• 本演示旨在帮助开发人员了解链代码的基础知识以及如何使用 Fabric 网络开发应用程序。

• 这是一个很是简单的资产转移演示。多个用户能够建立并相互转移弹珠。

• Marbles - 分支 v4.0 (Latest)（您将看到这个分支！）

  • 兼容 Hyperledger Fabric v1.0.1、v1.0.0 和 v1.0.0-rc1
  • 兼容 IBM Blockchain Bluemix 服务 - IBM Blockchain Platform - Enterprise 计划
    

    ---

应用程序背景

请你们集中注意力，这个应用程序将演示如何利用 Hyperledger Fabric 在许多弹珠全部者之间转移弹珠。
咱们将在 Node.js 中使用一些 GoLang 代码完成此任务。
该应用程序的后端将是在咱们的区块链网络中运行的 GoLang 代码。
从如今开始，这些 GoLang 代码将称为 ‘链代码’ 或 ‘cc’。
该链代码自己会建立一颗弹珠，将它存储到链代码状态中。
该链代码自己能够将数据做为字符串存储在键/值对设置中。
所以，咱们将字符串化 JSON 对象，以便存储更复杂的结构。

弹珠的属性包括：

1. ID（惟一字符串，将用做键）
2. 颜色（字符串，CSS 颜色名称）
3. 尺寸（int，以毫米为单位）
4. 全部者（字符串）

咱们将建立一个基于 Web 的用户界面，它能够设置这些值并将它们存储在区块链中。
这颗弹珠是在区块链存储（也称为帐本）中以键值对的形式建立的。
键为弹珠 ID，值为一个包含（上面列出的）弹珠属性的 JSON 字符串。
与 cc 的交互是经过对网络上的一个节点使用 gRPC 协议来完成的。
gRPC 协议的细节由一个名为 Hyperledger Fabric Client SDK 的 SDK 处理。
请查看下图了解拓扑结构细节。

应用程序通讯流

1. 管理员将在他们的浏览器中与咱们的 Node.js 应用程序 Marbles 进行交互。
2. 此客户端 JS 代码将打开一个与后端 Node.js 应用程序的 Websocket 链接。管理员与该站点交互时，客户端 JS 将消息发送到后端。
3. 读取或写入帐本称为提案。这个提案由 Marbles（经过 SDK）构建，而后发送到一个区块链节点。
4. 该节点将与它的 Marbles 链代码容器进行通讯。链代码将运行/模拟该交易。若是没有问题，它会对该交易进行背书，并将其发回咱们的 Marbles 程序。
5. 而后，Marbles（经过 SDK）将背书后的提案发送到订购服务。订购方未来自整个网络的许多提案打包到一个区块中。而后，它将新的区块广播到网络中的节点。
6. 最后，节点会验证该区块并将它写入本身的帐本中。该交易如今已经生效，全部后续读取都会反映此更改。

1.链代码部分 - 这是在区块链网络上运行的/包含节点的 GoLang 代码。也称为 cc。全部弹珠/区块链交互最终都会在这里进行。这些文件位于 /chaincode 中。
1.客户端 JS 部分 - 这是在用户浏览器中运行的 JavaScript 代码。用户界面交互在这里执行。这些文件位于 /public/js 中。
1.服务器端 JS 部分 - 这是运行应用程序的后端的 JavaScript 代码，即为 Marbles 的核心的 Node.js 代码！有时该代码也称为咱们的节点或服务器代码。它充当 Marbles 管理员与咱们的区块链之间的链接器。这些文件位于 /utils 和 /routes 中。

---

Marbles 设置(大前提npm install执行没问题V*P*N)

0.设置本地环境

安装Fabric环境要求配置

1.下载 Marbles

git clone https://github.com/IBM-Blockchain/marbles.git 
    cd marbles
    git checkout v4.0

2.启动Fabric网络

版本： Hyperledger Fabric v1.0.0
fabric-samples

cd fabric-samples/fabcar
./startFabric.sh
node invoke.js
node query.js

3.安装并实例化Marbles的链代码

npm install
cd ./scripts
./build_marbles_image.sh
node install_chaincode.js
node instantiate_chaincode.js

在实例化链码时可能会遇到如下问题

Error: Cannot find module 'fabric-client/lib/Peer.js'

export NODE_PATH=/root/node_modules
git clone https://github.com/hyperledger/fabric-sdk-node.git
cp -R ~/fabric-sdk-node/fabric-client /root/node_modules/

4.启动 Marbles

npm install gulp -g
npm install
gulp marbles_local

使用 Marbles

启动后访问http://ip:3001