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

Posted 2022-02-17 一路追寻

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