Convector(a.k.a Convector Smart Contracts)是为企业区块链框架构建的 JavaScript 开发框架。它增强了开发体验,同时帮助开发人员创建更强大,更安全的智能合约系统。它通过链代码和后端一直到前端,允许开发人员以库的形式重用相同的代码库。它基于模型 / 控制器模式,支持 Hyperledger Fabric,并沿着 Fabric 精心设计的模式本地运行。
这篇博客文章介绍了该项目的历史,并重点介绍了沿途开发的挑战和解决方案。
当我们开始研究 Tellus 时,一切都开始了,Tellus 是一个无代码交易设计师,用于在 Hyperledger Fabric 区块链上运行。那时我们有一堆 Golang 智能合约。
我们对开发者体验(DX)的第一印象并不是那么好。有两种方法:init 和 invoke,除了在 invoke 方法上放置 if 条件并使用其中一个参数指示调用的方法之外,没有其他方法可以添加新方法。所有参数都是位置传递的字符串,需要手动解析复杂参数,并且无法在本地测试它。
在项目开始时,Fabric 1.1 增加了对 Javascript 链代码的支持。我们决定尝试一下,希望改善开发人员的体验。不幸的是,它遵循 Golang 链式代码中的相同模式,你仍然需要在日常逻辑中做一些肮脏的工作。我们一直在寻找更好的解决方案,并发现了一篇关于 TheLedger 的库的帖子,该文章在 Typescript 中制作 Fabric 链接代码,它真正改善了原始 Javascript 的内容。
在我们的智能合约从 Golang 迁移到 Javascript 期间出现了一种模式。大多数时候函数按以下顺序执行:
- 1. 解析参数。
- 2. 做一些断言。
- 3. 执行更改。
- 4. 保存更改。
这导致了关于项目计划的一个基本问题:智能合约是否应该快速迁移,或者应该花更多的时间来确定模式并使其足够灵活以适应多个业务案例。这一切都始于项目的 ./src/utils/
。
/** @module @worldsibu/convector-examples-token */
import * as yup from‘yup’;
import {
ConvectorModel,
ReadOnly,
Required,
Validate
} from‘@worldsibu/convector-core-model’;
export class Token extends ConvectorModel {@ReadOnly()
public readonly type =‘io.worldsibu.examples.token’;
@ReadOnly()
@Required()
@Validate(yup.object())
public balances: {[key: string]: number };
@ReadOnly()
@Required()
@Validate(yup.number().moreThan(0))
public totalSupply: number;
@ReadOnly()
@Required()
@Validate(yup.string())
public name: string;
@ReadOnly()
@Required()
@Validate(yup.string())
public symbol: string;
}
对流模型
Fabric 对区块链中存储的数据形状没有限制。你基本上有一个键值映射,其中两个都是字符串,这意味着你可以序列化和存储任何复杂的对象。我们拆开模型以在代码中重用它们。我们刚刚通过了所有必要的参数。
@Invokable()
public async transfer(@Param(yup.string())
tokenId: string,
@Param(yup.string())
to: string,
@Param(yup.number().moreThan(0))
amount: number
) {const token = await Token.getOne(tokenId);
if (token.balances[this.sender] < amount) {throw new Error(‘The sender does not have enough funds’);
}
token.balances[to] = token.balances[to] || 0;
token.balances[to] += amount;
token.balances[this.sender] -= amount;
await token.save();}
Convector 控制器
使用 Fabric,你可以获得函数的类型参数列表。我们不希望在所有函数中一直解析模型,因此我们添加了一些装饰器来验证是否成功满足所有参数类型不变量。这些参数可能是原始的,复杂的甚至是模型。
现在,函数看起来更像是一个控制器。他们在模型描述数据时处理业务逻辑。
现在是时候将所有链代码集成到我们的 Nodejs REST API 中。在这个过程中,我们意识到我们正在服务器上创建一个包装器库来使用 fabric-client lib 调用我的链代码。这是一种非常常见的情况,因此我们寻找一种更好的自动化方法。
我想在服务器上使用相同的控制器和模型文件以及链代码。这样做意味着解耦模型和存储层(Fabric)之间的关系以及控制器和执行操作。
这就是我们意识到 Hyperledger Fabric 只是 Convector 可以支持的多个区块链之一。
适配器和存储发挥作用。
适配器是控制器的底层。控制器定义方法,参数和业务逻辑,而适配器处理如何将调用路由到正确的位置。例如,在我们的 API 中,它使用适配器来调用结构,客户端库并发送交易。
存储提供与模型交互的功能。无论你是要保存,删除还是查询某些内容,都可以与模型本身进行交互,并在后台与指定的服务进行交互。在链代码上,这是 Fabric STUB 对象。在 Nodejs API 中,它可能正在发送查询交易或从 CouchDB 读取。
专业提示:Convector 可以与区块链以外的东西一起使用。例如,配置适配器或模型以调用 API 或其他数据库。
周末变成了创造工具和完善模式的一个月。以下是你今天可以利用的一些工具:
- @worldsibu/convector-common-fabric-helper:使用一些快捷方法(如发送交易或安装链代码)为 fabric-client 包装 Nodejs 库。
- @worldsibu/convector-tool-chaincode-manager:CLI 和 Nodejs 库,用于在区块链上打包和安装对流链代码。这是关键,因为使用 Convector 构建较小的代码片段,此工具将捆绑你的代码。
- @worldsibu/hurley:建立 Fabric 区块链网络的开发环境。在这里阅读更多。
- @worldsibu/convector-cli:新的 convector 项目的快速启动。这是你开始使用新项目的最简单,最快捷的方式。在这里阅读更多。
# Install the CLInpm i -g @worldsibu/convector-cli
# Create a new chaincodes projectconv new mychain -c token
cd mychainnpm i
# Install a dev environmentnpm run env:restart # Install the chaincodenpm run cc:start — token 1
Convector CLI
此外,Convector 已经附带了一个 Fabric 适配器,一个 Fabric 存储,一个 CouchDB 存储和一个模拟适配器(用于单元测试),你可以使用它来无缝地为你的链码创建代码以及 NodeJS 后端,同时创建可以进行的测试包含在 CI/CD 管道中。这在任何现实生活中都至关重要。
可以轻松创建额外的适配器和存储层,我们很高兴看到社区围绕这些工具构建的内容。在我们构建这个的同时,我们继续致力于内部产品的迁移,这有助于在启动之前在现实生活场景中测试框架。
我很高兴我们没有采取这种迁移的简单方法。我们对结果非常满意,发布开源工具的过程令人惊叹。每天看到数百人使用它也是有益的。
Hyperledger Fabric 是一个优秀的区块链框架。它提供的基础架构以安全可靠的方式涵盖了大多数用例。这就是为什么我们认为它也应该为智能合约提供强大的界面,我们希望通过我们在使用它时创建的内部工具回馈社区。
因为我们相信该项目对区块链生态系统中的任何人都有用,所以 Convector 加入了 Hyperledger Labs 计划。我们真的致力于围绕 Convector 建立一个社区,该社区已经超过了 27,000 个下载,并欢迎 Hyperledger 社区的投入。如果你希望参与开源项目,请参阅 GitHub
关于作者 Diego Barahona 是 WorldSibu 的首席技术官和架构师,该公司致力于为非区块链专家创建区块链工具和平台,并使该技术更易于解决业务挑战。
======================================================================
分享一些比特币、以太坊、EOS、Fabric 等区块链相关的交互式在线编程实战教程:
- java 比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与 UTXO 等,同时也详细讲解如何在 Java 代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是 Java 工程师不可多得的比特币开发学习课程。
- php 比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与 UTXO 等,同时也详细讲解如何在 Php 代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是 Php 工程师不可多得的比特币开发学习课程。
- c#比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与 UTXO 等,同时也详细讲解如何在 C#代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是 C# 工程师不可多得的比特币开发学习课程。
- java 以太坊开发教程,主要是针对 java 和 android 程序员进行区块链以太坊开发的 web3j 详解。
- python 以太坊,主要是针对 python 工程师使用 web3.py 进行区块链以太坊开发的详解。
- php 以太坊,主要是介绍使用 php 进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和交易等内容。
- 以太坊入门教程,主要介绍智能合约与 dapp 应用开发,适合入门。
- 以太坊开发进阶教程,主要是介绍使用 node.js、mongodb、区块链、ipfs 实现去中心化电商 DApp 实战,适合进阶。
- ERC721 以太坊通证实战,课程以一个数字艺术品创作与分享 DApp 的实战开发为主线,深入讲解以太坊非同质化通证的概念、标准与开发方案。内容包含 ERC-721 标准的自主实现,讲解 OpenZeppelin 合约代码库二次开发,实战项目采用 Truffle,IPFS,实现了通证以及去中心化的通证交易所。
- C#以太坊,主要讲解如何使用 C# 开发基于.Net 的以太坊应用,包括账户管理、状态与交易、智能合约开发与交互、过滤器和交易等。
- EOS 入门教程,本课程帮助你快速入门 EOS 区块链去中心化应用的开发,内容涵盖 EOS 工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后综合运用各知识点完成一个便签 DApp 的开发。
- 深入浅出玩转 EOS 钱包开发,本课程以手机 EOS 钱包的完整开发过程为主线,深入学习 EOS 区块链应用开发,课程内容即涵盖账户、计算资源、智能合约、动作与交易等 EOS 区块链的核心概念,同时也讲解如何使用 eosjs 和 eosjs-ecc 开发包访问 EOS 区块链,以及如何在 React 前端应用中集成对 EOS 区块链的支持。课程内容深入浅出,非常适合前端工程师深入学习 EOS 区块链应用开发。
- Hyperledger Fabric 区块链开发详解,本课程面向初学者,内容即包含 Hyperledger Fabric 的身份证书与 MSP 服务、权限策略、信道配置与启动、链码通信接口等核心概念,也包含 Fabric 网络设计、nodejs 链码与应用开发的操作实践,是 Nodejs 工程师学习 Fabric 区块链开发的最佳选择。
- Hyperledger Fabric java 区块链开发详解,课程面向初学者,内容即包含 Hyperledger Fabric 的身份证书与 MSP 服务、权限策略、信道配置与启动、链码通信接口等核心概念,也包含 Fabric 网络设计、java 链码与应用开发的操作实践,是 java 工程师学习 Fabric 区块链开发的最佳选择。
- tendermint 区块链开发详解,本课程适合希望使用 tendermint 进行区块链开发的工程师,课程内容即包括 tendermint 应用开发模型中的核心概念,例如 ABCI 接口、默克尔树、多版本状态库等,也包括代币发行等丰富的实操代码,是 go 语言工程师快速入门区块链开发的最佳选择。
汇智网原创翻译,转载请标明出处。这里是如何编写一个企业级 Hyperledger Fabric 开源框架