开发学习者 2019-07-01
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期间出现了一种模式。大多数时候函数按以下顺序执行:
这导致了关于项目计划的一个基本问题:智能合约是否应该快速迁移,或者应该花更多的时间来确定模式并使其足够灵活以适应多个业务案例。这一切都始于项目的./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(); }
使用Fabric,你可以获得函数的类型参数列表。我们不希望在所有函数中一直解析模型,因此我们添加了一些装饰器来验证是否成功满足所有参数类型不变量。这些参数可能是原始的,复杂的甚至是模型。
现在,函数看起来更像是一个控制器。他们在模型描述数据时处理业务逻辑。
现在是时候将所有链代码集成到我们的Nodejs REST API中。在这个过程中,我们意识到我们正在服务器上创建一个包装器库来使用fabric-client lib调用我的链代码。这是一种非常常见的情况,因此我们寻找一种更好的自动化方法。
我想在服务器上使用相同的控制器和模型文件以及链代码。这样做意味着解耦模型和存储层(Fabric)之间的关系以及控制器和执行操作。
这就是我们意识到Hyperledger Fabric只是Convector可以支持的多个区块链之一。
适配器和存储发挥作用。
适配器是控制器的底层。控制器定义方法,参数和业务逻辑,而适配器处理如何将调用路由到正确的位置。例如,在我们的API中,它使用适配器来调用结构,客户端库并发送交易。
存储提供与模型交互的功能。无论你是要保存,删除还是查询某些内容,都可以与模型本身进行交互,并在后台与指定的服务进行交互。在链代码上,这是Fabric STUB对象。在Nodejs API中,它可能正在发送查询交易或从CouchDB读取。
专业提示:Convector可以与区块链以外的东西一起使用。例如,配置适配器或模型以调用API或其他数据库。
周末变成了创造工具和完善模式的一个月。以下是你今天可以利用的一些工具:
# 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已经附带了一个Fabric适配器,一个Fabric存储,一个CouchDB存储和一个模拟适配器(用于单元测试),你可以使用它来无缝地为你的链码创建代码以及NodeJS后端,同时创建可以进行的测试包含在CI/CD管道中。这在任何现实生活中都至关重要。
可以轻松创建额外的适配器和存储层,我们很高兴看到社区围绕这些工具构建的内容。在我们构建这个的同时,我们继续致力于内部产品的迁移,这有助于在启动之前在现实生活场景中测试框架。
我很高兴我们没有采取这种迁移的简单方法。我们对结果非常满意,发布开源工具的过程令人惊叹。每天看到数百人使用它也是有益的。
Hyperledger Fabric是一个优秀的区块链框架。它提供的基础架构以安全可靠的方式涵盖了大多数用例。这就是为什么我们认为它也应该为智能合约提供强大的界面,我们希望通过我们在使用它时创建的内部工具回馈社区。
因为我们相信该项目对区块链生态系统中的任何人都有用,所以Convector加入了Hyperledger Labs计划。我们真的致力于围绕Convector建立一个社区,该社区已经超过了27,000个下载,并欢迎Hyperledger社区的投入。如果你希望参与开源项目,请参阅GitHub
关于作者Diego Barahona是WorldSibu的首席技术官和架构师,该公司致力于为非区块链专家创建区块链工具和平台,并使该技术更易于解决业务挑战。
======================================================================
分享一些比特币、以太坊、EOS、Fabric等区块链相关的交互式在线编程实战教程:
汇智网原创翻译,转载请标明出处。这里是如何编写一个企业级Hyperledger Fabric开源框架