超级账本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
应用程序背景
请大家集中注意力,这个应用程序将演示如何利用 Hyperledger Fabric 在许多弹珠所有者之间转移弹珠。
我们将在 Node.js 中使用一些 GoLang 代码完成此任务。
该应用程序的后端将是在我们的区块链网络中运行的 GoLang 代码。
从现在开始,这些 GoLang 代码将称为 ‘链代码’ 或 ‘cc’。
该链代码本身会创建一颗弹珠,将它存储到链代码状态中。
该链代码本身可以将数据作为字符串存储在键/值对设置中。
因此,我们将字符串化 JSON 对象,以便存储更复杂的结构。
弹珠的属性包括:
- ID(唯一字符串,将用作键)
- 颜色(字符串,CSS 颜色名称)
- 尺寸(int,以毫米为单位)
- 所有者(字符串)
我们将创建一个基于 Web 的用户界面,它可以设置这些值并将它们存储在区块链中。
这颗弹珠是在区块链存储(也称为账本)中以键值对的形式创建的。
键
为弹珠 ID,值
为一个包含(上面列出的)弹珠属性的 JSON 字符串。
与 cc 的交互是通过对网络上的一个节点使用 gRPC 协议来完成的。
gRPC 协议的细节由一个名为 Hyperledger Fabric Client SDK 的 SDK 处理。
请查看下图了解拓扑结构细节。
应用程序通信流
- 管理员将在他们的浏览器中与我们的 Node.js 应用程序 Marbles 进行交互。
- 此客户端 JS 代码将打开一个与后端 Node.js 应用程序的 Websocket 连接。管理员与该站点交互时,客户端 JS 将消息发送到后端。
- 读取或写入账本称为提案。这个提案由 Marbles(通过 SDK)构建,然后发送到一个区块链节点。
- 该节点将与它的 Marbles 链代码容器进行通信。链代码将运行/模拟该交易。如果没有问题,它会对该交易进行背书,并将其发回我们的 Marbles 程序。
- 然后,Marbles(通过 SDK)将背书后的提案发送到订购服务。订购方将来自整个网络的许多提案打包到一个区块中。然后,它将新的区块广播到网络中的节点。
- 最后,节点会验证该区块并将它写入自己的账本中。该交易现在已经生效,所有后续读取都会反映此更改。
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