上一篇文章我介绍了EOS环境搭建,在安装好eos的环境后,接下来要进入的环节也就是智能合约的编写和调试了,学习任何一门语言都是从helloworld开始的,eos也不例外!
(如果想更全面了解EOS技术,建议去看看PDJ孟岩等大佬关于区块链EOS最新技术专家解读与入门点拨实录视频,很有启发,需要的话也可加我扣扣(2082049536)索要)
EOS的样例智能合约给我们提供了一个hello的职能合约写法! 阅读下面的内容之前,要先确保nodeos已经处于启动状态!
智能合约部分知识介绍
在contracts下有大量的样例合约,我们先挑一个最好欺负的合约开始,作为我们的入门!
上图中,可以看到2个关键文件,cpp和abi,其他合约中还有hpp文件,其中熟悉c的朋友当然知道cpp和hpp代表什么,分别代表了c的源码和头文件。
wast文件,默认没有,后面介绍如何生成
wast是eos智能合约运行的代码,可以将c++,c#,go等语言的代码翻译为wast,可以理解为一种类似汇编的低级别语言,更好的被执行。
abi文件
如果做过eth智能合约编写,对abi文件不会陌生,abi是我们调用智能合约的入口,里面定义了action,struct,以及table等关键内容,上述三个可谓是abi文件的三要素!
智能合约操作
账号和钱包操作
之所以先讲账号和钱包操作,是因为后续要使用到钱包和账号!
创建钱包
如果不指定钱包名,直接创建默认钱包,也就是default
cleos wallet create [-n walletname]
192:~ yk$ cleos wallet create
Creating wallet: defaultSave
password to use in the future to unlock this wallet.
Without password imported keys will not be retrievable.
"PW5JvcRVNkDSH1AV2MDdx6o2YyKXX7QGWhTKKQvrLZffPbvyqUxfY"
注意这个创建后的钱包密码一定要备份起来
创建账号
先创建key
192:~ yk$ cleos create key
Private key: 5JLFiS18r3HtB1tVgrx9EYBSxKEBdtUos1yca5D5bq9hwEoCKoT
Public key: EOS87h471dTjN9QU5G1VcBYuoZrxvKxdFu2bYNr1NPYp32EzoyKdE
创建账号语法
cleos create account [OPTIONS] creator name OwnerKey ActiveKey
这时候之前的create key的结果就可以使用了,Ownerkey和activekey代表了两个权限,eos账户管理的设计比较有趣,owner的权限够大,active的权限小一些,先不管它,都统一用之前的公钥就省事了。
192:~ yk$ cleos create account eosio yekai EOS87h471dTjN9QU5G1VcBYuoZrxvKxdFu2bYNr1NPYp32EzoyKdE EOS87h471dTjN9QU5G1VcBYuoZrxvKxdFu2bYNr1NPYp32EzoyKdEexecuted transaction: 73e932daea695369c146c2bc62e3e751c47be62b12cfdae48e735086f5461f2a 352 bytes 102400 cycles# eosio <= eosio::newaccount {"creator":"eosio","name":"yekai","owner":{"threshold":1,"keys":[{"key":"EOS87h471dTjN9QU5G1VcBYuoZr...
这里的yekai就是我要建立的账户名,eosio是创建者,超级用户,以后也是付费用户才能创建账号。
接下来将账号导入钱包
这里的yekai就是我要建立的账户名,eosio是创建者,超级用户,以后也是付费用户才能创建账号。 接下来将账号导入钱包
cleos wallet import [OPTIONS] key
这个key我们使用之前create key得到的私钥
192:~ yk$ cleos wallet import 5JLFiS18r3HtB1tVgrx9EYBSxKEBdtUos1yca5D5bq9hwEoCKoTimported private key for: EOS87h471dTjN9QU5G1VcBYuoZrxvKxdFu2bYNr1NPYp32EzoyKdE
部署合约
接下来应该可以部署合约了,来到hello所在目录
192:hello yk$ ls hello.*hello.abi hello.cpp hello.hi_rc.md当前有hello.abi以及hello.cpp源码文件,还缺少hello.wast文件,可以通过eosiocpp生成!
192:hello yk$ eosiocpp -o hello.wast hello.cpp
会看到很多输出信息,没有错误就ok
192:hello yk$ ls hello.*hello.abi hello.cpp hello.hi_rc.md hello.wast
此时多了一个wast文件,来看看hello源码文件
#includeusing namespace eosio;
class hello : public eosio::contract {
public:
using contract::contract;
/// @abi action
void hi( account_name user ) {
print( "Hello, ", name{user} );
}
};
EOSIO_ABI( hello, (hi) )
这个hello代码中提供了一个 hi的action,action本次先篇先不展开,我们先能调用即可。
先将合约部署:
cleos set contract [OPTIONS] account contract-dir [wast-file] [abi-file]
通过yekai账户来设置合约
192:hello yk$ cleos set contract yekai ../hello/
Reading WAST/WASM from ../hello/hello.wast...
Assembling WASM...
Publishing contract...
executed transaction: c28017f62ae6c6dbbaafa563ea8ded881ee6b79d5be5aa7f1965d1709d51ea4e 4008 bytes 2200576 cycles
# eosio <= eosio::setcode {"account":"yekai","vmtype":0,"vmversion":0,"code":"0061736d0100000001370b60027f7e0060027e7e0060017f...
# eosio <= eosio::setabi {"account":"yekai","abi":{"types":[],"structs":[{"name":"hi","base":"","fields":[{"name":"user","typ...
调用合约
接下来演示一下如何调用合约
cleos push action [OPTIONS] contract action data
这里的contract与账户是一对一的,所以你可以理解为就是账户yekai,后面的action data是要传递的数据。hi需要传递一个账户名字给他
192:hello yk$ cleos push action yekai hi '{"user":"dinglinlin"}'
Error 3030033: transaction should have at least one required authority
Error Details:
transaction must have at least one authorization
192:hello yk$ cleos push action yekai hi '{"user":"dinglinlin"}' -pyekai
executed transaction: 247f64fb75df825c44e94a08d6a051f0a3d4273e37c75727196a6e78a9a75796 232 bytes 102400 cycles
# yekai <= yekai::hi {"user":"dinglinlin"}
>> Hello, dinglinlin
可见调用时需要给定一个账户认证的,也就是-p选项
思考如何扩展?
hello合约展示完了,怎么样证明理解了hello合约呢?能否对hello进行改造,比如再增加一个bye的action,接口传递user和想说的话。
void void hi( account_name user ,string memo )
来尝试一下吧,如果有比理解的可以关注我们,寻求答案!