上一篇我们介绍了如何搭建本地测试节点,它提供了一个智能合约的运行环境。我们还介绍如何使用超级账户eosio
来创建新账户以及载入系统级别的智能合约。通过上一章的学习,大家可能已经对智能合约有了一个比较模糊的概念。这一章将继续为大家讲解,开发智能合约之前,你还需要知道的事。
摘要
这一章,我们将自己上手部署调用一个简单的智能合约hello
,中间会穿插讲解一些相关概念,这些概念虽然很基础,但是对初学者而言,也很重要。
什么是WebAssembly
之前如果大家简单地浏览过eos项目文件夹,就会看到很多.wasm
文件,而wasm就是WebASseMbly的缩写。这里让我们略过Flash、JavaScript和WebAssembly的爱恨情仇(发展演化),直接一句话概括一下:
WebAssembly是一种新的编码方式,可以在现代的网络浏览器中运行。
想象它是一种可以把底层语言文件变得像JS那样,可以直接在浏览器中运行。而且比JS更轻量、更快速、更安全。过程如下图:
还有一个大家在build
eos的过程中看过一百遍的词:LLVM
。
LLVM是一些分模块、可重用的编译工具链。它提供了一种代码编写良好的中间表示(IR)。它在上图中的位置大概是介于第一步和第二步之间。
如果想把C/C++变成WASM文件,就需要先把C/C++代码先变成LLVM中间代码。一旦变换成了LLVM IR之后,就说明LLVM已经理解了代码并会对代码自动地做出一些优化。
而WebAssembly也并不是只有wasm
一种格式,它还有wast
格式。这两者作用是等价的,最大的区别就是wast
是可读文本格式的,而wast
是二进制格式的,他们可以通过工具相互转换。
让我们高度总结一下WebAssembly:
可以让浏览器识别底层语言的神器。
(笔者感觉和以太坊中的编译器作用差不多)。
什么是ABI
玩过以太坊的同学可能对ABI并不陌生,在EOS中ABI的作用也和以太坊中大致类似:
它定义了函数被调用的规则;定义了参数在调用者和被调用者之间是如何传递的。
如果说wasm
文件是产品的话,要想顺利使用这件产品,你还需要一本操作说明书,而ABI
就是这份说明书。
土味智能合约入门:hello
一说入门就要说,这种感觉很low,同时也很“程序员”。感谢雷佳音让我找到了一个并不尴尬的小标题:土味hello。
0. 准备工作
进度保持在我们上一章结束的地方:我们已经学会使用操作eosio账户、创建了新账户testeosio
。
在正文开始之前,请启动nodeos
,相关钱包处于unlock状态。
1. 修改config.ini
找到位于vi ~/Library/Application\ Support/eosio/nodeos/config/
中的config.ini
文件,打开找到下面这句话:
# print contract's output to console (eosio::chain_plugin)
contracts-console = false
把上面的false
改成true
,保存修改退出。这样我们就可以在终端直接看到智能合约的执行情况。
(这里笔者重新启动了nodeos)
2. 创建hello
合约
这里我们用到了一个小工具叫eosiocpp
。eosiocpp是一个c++生成wasm和ABI文件的工具。
eos项目中自带了一个hello合约,为了区分,这里我们创建一个合约叫做hello1
。执行以下语句创建新合约:
eosiocpp -n hello1
它会以样例合约为基础创建一个最简单的合约。看到下图即表示创建成功:
这时在当前文件夹下就可以看到有一个hello1
的文件夹。
进入hello1
文件夹,可以看到里面有两个文件:
➜ hello1 git:(master) ✗ ls
hello1.cpp hello1.hpp
-
hello1.hpp
是智能合约的头文件,可以包含一些变量,常量和函数的声明。 -
hello1.cpp
是合约的源码文件,包含合约的具体实现。
3. 生成wasm和abi文件
进入hello1
文件夹下执行以下命令:
#使用 -o 生成wast文件和wasm文件
eosiocpp -o ./hello1.wast ./hello1.cpp
#使用 -g 生成abi文件
eosiocpp -g ./hello1.abi ./hello1.cpp
这时可以看到在当前文件夹下生成了hello1.wast
、hello1.wasm
和hello1.abi
文件。
4. 部署智能合约
使用我们刚刚生成的文件部署智能合约。输入如下命令:
cleos set contract eosio ./ ./hello1.wast hello1.abi -p eosio@active
这行命令有五个参数:eosio
表示部署合约的账户,./
表示合约所在的文件夹,后面两个参数依次是.wast
和.abi
文件的路径,最后的-p eosio@active
表示权限。
执行成功如下图所示:
调用hello合约
在执行调用命令之前,我们先简单地了解EOS中的一个概念:transaction
和action
。
Action表示单个操作,而transaction是一个或多个action的集合。Action是合约和账户之间进行通信的方式。Action可以单独执行,或者组合组合起来作为一个整体执行。
在官网中我们也可以看到包含一个action和多个action的transaction的例子。
对比来看的话,EOS中的action就相当于以太坊中的transaction。
执行以下命令来调用hello1合约中的hi
方法:(执行的账户是testeosio)
cleos push action eosio hi '["hammer"]' -p testeosio
执行成功就可以看到如下界面:
这时如果我们去看运行nodeos
的终端窗口,可以看到下面的提示:
同样打印出了Hello, hammer
。
总结
这一章我们学习了EOS智能合约在生成、部署以及调用的过程中涉及的相关概念和操作。了解了:
- 什么是webAssembly:翻译C/C++让浏览器也看得懂的神器;
- 什么是ABI:代码的“产品说明书”;
-
如何生成和操作一个简单的智能合约
- 生成wast和abi文件
- 部署合约
- push action调用合约方法
下面一章,我们依然会一边介绍智能合约的相关必备知识,一边带着大家来看一看简单的智能合约语法。