Marbles 演示
关于 Marbles
这个应用程序的基础网络是 Hyperledger Fabric,后者是一个 Linux Foundation 项目。您可能想查阅以下操作说明来稍微了解一下 Hyperledger Fabric。
本演示旨在帮助开发人员了解链代码的基础知识以及如何使用 Fabric 网络开发应用程序。
这是一个非常简单的资产转移演示。多个用户可以创建并相互转移弹珠。
-
Marbles - 分支 v4.0.2 (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 对象,以便存储更复杂的结构。
弹珠的属性包括:
- 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)将背书后的提案发送到订购服务。订购方将来自整个网络的许多提案打包到一个区块中。然后,它将新的区块广播到网络中的节点。
- 最后,节点会验证该区块并将它写入自己的账本中。该交易现在已经生效,所有后续读取都会反映此更改。
链代码部分 - 这是在区块链网络上运行的/包含节点的 GoLang 代码。也称为 cc。所有弹珠/区块链交互最终都会在这里进行。这些文件位于 /chaincode 中。
客户端 JS 部分 - 这是在用户浏览器中运行的 JavaScript 代码。用户界面交互在这里执行。这些文件位于 /public/js 中。
服务器端 JS 部分 - 这是运行应用程序的后端的 JavaScript 代码,即为 Marbles 的核心的 Node.js 代码!有时该代码也称为我们的节点或服务器代码。它充当 Marbles 管理员与我们的区块链之间的连接器。这些文件位于 /utils 和 /routes 中。
Marbles 设置
0.设置本地环境
安装Fabric环境要求配置
1.下载 Marbles
git clone https://github.com/IBM-Blockchain/marbles.git
cd marbles
git checkout v4.0.2
2.启动Fabric网络
版本: Hyperledger Fabric v1.0.0
fabric-samples
cd fabric-samples/fabcar
./startFabric.sh
node enrollAdmin.js
node registerUser.js
node query.js
3.安装并实例化Marbles的链代码
npm install
cd ./scripts
./build_marbles_image.sh
node install_chaincode.js
node instantiate_chaincode.js
4.启动 Marbles
npm install gulp -g
npm install
gulp marbles_local
使用 Marbles
启动后访问http://ip:3001