欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  科技

BAIC佰客云公链发布智能合约开发说明书!

程序员文章站 2022-07-18 14:17:27
BAIC佰客云公链是旨在推进物联网及AI之间数据互联、交易结算、智能合约的去中心化区块链技术平台,也是目前唯一一家实际落地,支持IOT设备上链的物联网公链。已于本月正式上线。...

baic佰客云公链是旨在推进物联网及ai之间数据互联、交易结算、智能合约的去中心化区块链技术平台,也是目前唯一一家实际落地,支持iot设备上链的物联网公链。已于本月正式上线。

目前已经有包括智能手环、智能牙刷、智能炖盅等多个设备上链支持。baic公链是旨在推进物联网及ai设备间数据交易、物物支付、智能合约的去中心化区块链技术平台,也允许开发者在其协议顶端创建iot级别的去中心化应用(dapp)。baic公链希望可以帮助越来越多的iot数据上链,为全球用户打开物联网数字新资产的大门。本日baic佰客云公链正式对外发布智能合约开发说明书,以供开发者参考。

1. 概述

本文对baic公链的智能合约开发的相关知识做简要说明,为智能合约开发提供示例说明。

2. 所需知识背景

2.1. c/c++

baic区块链平台使用web assembly(wasm)执行开发者提供的应用代码。目前最成熟的用于构建应用及wasm代码编译的工具链是clang/llvm及其c/c++编译器。从应用的高性能特性和安全需求出发,c++将成为智能合约开发的最佳语言。

2.2. 开发环境

baic智能合约开发需要在特定的平台环境中开发,开发者至少熟悉其中一个开发环境。 baic支持的开发环境:

ubuntu 16.10 或更高

macos sierra 或更高

3. 环境搭建

开发baci智能合约,开发环境平台需要安装的软件包:

v 安装c++ /boost库

v 安装clang编译器

v 安装baic官方软件包baic-sdk

软件包安装完成后设置环境变量即可。

4. 智能合约开发

本节详细描述baic智能合约的运作机制和开发过程,包括智能合约的代码编写、代码编译、可执行文件生成、文件格式描述等。

4.1. 合约开发基础

4.1.1. 通信模型

baic智能合约通过action及共享内存数据库相互通信。异步通信导致的spam问题将由资源限制算法来解决。通信模型inline保证执行当前的transaction或unwind;无论成功或失败都会有通知。inline 操作的scopes和authorities和原来的transaction一样。

4.1.2. action vs transaction

一个action代表单个操作, 一个transaction是一个或多个action的集合。合约和账户通过action通信。action可以单个地发送,如果希望一次执行批处理也可以集合起来发送。

4.1.3. action名的限定

action的类型实际上是base32编码的64位整数。所以action名的最多10个字符,并且限制在字母a-z,a-z, 0-9, 以及'_' 中。

4.1.4. transaction确认

获得一个transaction哈希并不等于transaction完成,它只表示该节点无报错地接受了,而其他区块生产者很可能也会接受它。但要确认该transaction,你需要在transaction历史中查看含有该transaction的区块数。

4.1.5. 技术限制

transaction需要在1 ms内执行。 transaction的执行时间需要在*小于等于1ms否则transaction将会失败。

最大 30 tps。 目前根据测试公网设置,每个账户最多每秒可发布30个transactions。

4.2. 智能合约文件

4.2.1. hpp

hpp是包含cpp文件所引用的变量、常量、函数的头文件。

4.2.2. cpp

cpp文件是包含合约功能的源文件。

BAIC佰客云公链发布智能合约开发说明书!

从代码中可以看到创建的合约(example)将继承一个基础合约baic::contract,这个合约是baic基础合约,所有的开发的合约都要继承这个合约。

在类中添加方法,作为action操作。例如上面的类中action1/action2方法就是合约的action操作。

baic_abi这个宏是替开发者实现了 apply 函数,使得开发者可以专注于业务逻辑。 开发人员只需要在宏中指定合同中的代码和操作名称,并且所有底层c代码映射逻辑都由宏生成。在第一个参数中填入合约名称(如example),第二个参数是action名称(如(action1)(action2)。

4.2.3. wasm

想要部署到baic区块链上的任何程序都需要先编译成wasm格式。这是区块链目前能接受的格式。

一旦您完成了cpp文件的开发,您可以用clang工具将它编译成一个文本版本的wasm 文件。

简要的生成过程如下:实际使用中要添加相关参数,具体见示例代码。

1. 把源文件编译成bc字节码

$ clang -c example.cpp -o example.bc

2. 把多个bc字节码链接成一个linked.bc文件

$ llvm-link -only-needed -o example.linked.bc example.bc

3. 通过linked.bc文件生成二进制s文件

$ llc -o example.s example.linked.bc

4. 将s文件转成wast文件

$ baic-s2wast -o example.wast -s 16384 example.s

5. 将wast文件编译成wasm文件

$ baic-wast2wasm example.wast example.wasm -n

6. 生成abi文件

$ baic-abigen -destination-file=example.abi -verbose=0 example.hpp

4.2.4. abi

application binary interface (abi)是一个基于json的描述文件,是关于转换json和二进制格式的用户actions的。abi还描述了如何将数据库状态和json的互相转换。一旦您通过abi描述了您的合约,开发者和用户就能够用json和您的合约无缝交互了。生成abi过程见上文。

5. 智能合约演示

5.1. 示例代码 本节中,我们将一步步地构建一个example合约。开始前,先完成上文的所有步骤。

BAIC佰客云公链发布智能合约开发说明书!

示例代码中 action1 和 action2 都是一个动作,一个动作表示单个操作,而一个交易是一个或多个动作的集合。合约和账户以动作的形式进行交流。动作可以单独发送,也可以组合的形式发送。

5.2. 部署步骤

BAIC佰客云公链发布智能合约开发说明书!

附件

合约开发示例也可以参照baic-sdk包中的test示例。合约部署详细流程参照baic区块链智能合约部署流程。baic官方网址:www.baic.io