用SI编写"Hello World"智能合约,开启EOS之旅

  • 辉哥
  • 更新于 2018-07-06 16:39
  • 阅读 3508

EOS "Hello World"智能合约

1,摘要

【本文目标】 通过本文实践,能够使用SI(Source Insight)编辑EOS的智能合约代码,并通过编译,执行来测试"Hello World"代码。 【前置条件】 1) 已完成了EOS编译,编译测试成功; 2) 钱包,账号已创建完毕; 钱包名字: duncanwang 打开密码: "PW5K8vabia4Gba7Tos8wVH6XFc7bKYcR9uTfuaPqcNsPyg2HduFou" 钱包已导入系统密钥对: EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV :5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3 已创建账号: wangdenghui 【说明】这个钱包,账号为测试使用,学习者创建自己的账号资源即可。

【技术收获】 1)Source Insight的安装和使用 2)最简EOS智能合约写作 3) 合约代码的编译和执行

2,实践内容

2.1 Source Insight的安装和配置

1)source insight 介绍

EOSIO的智能合约代码采用C++编程语言完成,目前有多款编辑器或者集成IDE环境例如Visual Studio 2017/ Source Insight / Visual Studio Code / UtraEdit等多款 软件支持。对通信背景的人来说,大家特别习惯使用 Source Insight,其关联查看功能确实比其他软件更方便。

Source Insight是如今最好用的语言编辑器之一,支持几乎所有的语言, 如C、C++、ASM、PAS、ASP、HTML,PHP,JSON,Python等常见的,也可以通过导入配置文件的方式支持GO语言(下载地址: https://www.sourceinsight.com/download/ ), 还支持自己定义关键字,Source Insight提供了可快速访问源代码和源信息的功能。

2)Source Insight安装

参考 《三步完成Source Insight 4.0 破解安装》 完成Source Insight版本下载和安装。

3) Source Insight配置

如果要使Source Insight支持Go语言和ABI文件的参考,让字体和背景颜色更适合眼睛,需要做一定的配置。

不愿意自己配置的同学,可以加入知识星球后下载该配置文件,在菜单"Options/Load Configuration"导入"wangdenghui SI 配置.xml"文件,即可快速完成配置工作。

2.2 编写最简智能合约程序

1)建立工程

菜单Project / New Project创建一个命名为Hello的工程。

2)菜单File / New 创建一个"Hello.cpp"的文件

3)编写程序

创建文件后,输入最简程序的内容。本文不解释C++语法和内容,我们的目标是先跑通代码。

#include <eosiolib/eosio.hpp>
#include <string>

using namespace eosio;

class hello : public eosio::contract {
  public:
      using contract::contract;

      /// @abi action 
      void hi( std::string strContent ) {
         print( "Hello ", strContent);
      }
};

EOSIO_ABI( hello, (hi) )

2.3 编译和部署运行

1)Hello.cpp文件上传到EOS编译环境目录下

2)编译合约

eosiocpp -o表示在该目录下产生一个hello的智能合约代码。

eosiocpp -o hello.wast hello.cpp

操作输出,增加了hello.wast文件:

duncanwang@duncanwang:~/eos/build/contracts/hello$ eosiocpp -o hello.wast hello.cpp
duncanwang@duncanwang:~/eos/build/contracts/hello$ ls
CMakeLists.txt  hello.cpp  hello.hi_rc.md  hello_rc.md  hello.wasm  hello.wast

eosiocpp -g hello.abi hello.cpp 输出结果:

duncanwang@duncanwang:~/eos/build/contracts/hello$ eosiocpp -g hello.abi hello.cpp
Generated hello.abi ...

eosiocpp -g产生"hello.abi"文件。 ABI(Application Binary Interface): 应用程序二进制接口 描述了应用程序和操作系统之间,一个应用和它的库之间,或者应用的组成部分之间的低接口。ABI涵盖了各种细节,如:

  • 数据类型的大小、布局和对齐;
  • 调用约定(控制着函数的参数如何传送以及如何接受返回值),例如,是所有的参数都通过栈传递,还是部分参数通过寄存器传递;哪个寄存器用于哪个函数参数;通过栈传递的第一个函数参数是最先push到栈上还是最后;
  • 系统调用的编码和一个应用如何向操作系统进行系统调用;
  • 以及在一个完整的操作系统ABI中[目标文件的二进制格式、程序库等等。 [1] ABI不同于 API ,API定义了源代码和库之间的接口,因此同样的代码可以在支持这个API的任何系统中编译 ,然而ABI允许编译好的目标代码在使用兼容ABI的系统中无需改动就能运行。 ABI掩盖了各种细节。

2.4 部署智能合约

cleos set contract wangdenghui ../hello -p wangdenghui

duncanwang@duncanwang:~/eos/build/contracts/hello$ cleos set contract wangdenghui ../hello -p wangdenghui
Reading WAST/WASM from ../hello/hello.wasm...
Using already assembled WASM...
Publishing contract...
executed transaction: 79830b81c90a22ab42b427ac70ff0c764441d92ea128999712e3376ae6b2460d  4168 bytes  741 us
##         eosio <= eosio::setcode               {"account":"wangdenghui","vmtype":0,"vmversion":0,"code":"0061736d01000000013b0c60027f7e006000017e60...
##         eosio <= eosio::setabi                {"account":"wangdenghui","abi":"0e656f73696f3a3a6162692f312e30000102686900010475736572046e616d650100...
warning: transaction executed locally, but may not be confirmed by the network yet

这个命令序列的结果是,cleos发起一个包含两个操作(actions)的交易(transaction):eosio::setcode和eosio::setabi。 代码定义了合约如何运行,abi描述了参数如何在二进制和json表示之间进行转换。 这个命令最后一个参数是-p wangdenghui。该参数告诉cleos,用wangdenghui账户的active权限签署此操作,就是使用我们先前导入钱包的wangdenghui账户私钥对操作进行签名。

2.5 执行智能合约

cleos push action wangdenghui hi '["World!"]' -p wangdenghui

输出结果有>> "Hello World!"

duncanwang@duncanwang:~/eos/build/contracts/hello$ cleos push action wangdenghui hi '["World!"]' -p wangdenghui
executed transaction: d10de21ee792c4997ae697e5db00ad571cfd67c374e9e9fcb741a2a7046c9e49  104 bytes  830 us
##   wangdenghui <= wangdenghui::hi              {"strContent":"World!"}
>> Hello World!
warning: transaction executed locally, but may not be confirmed by the network yet

【问题】 合约执行并没有输出"hello, World!的内容"

duncanwang@duncanwang:~/eos/build/contracts/hello$ cleos push action wangdenghui hi '["wangdenghui"]' -p wangdenghui
executed transaction: 51ff4e32f556cedfc1a36f79a156a4dce7a5f93aa9037c83e149164189f57ea1  104 bytes  658 us
##   wangdenghui <= wangdenghui::hi              {"user":"wangdenghui"}
warning: transaction executed locally, but may not be confirmed by the network yet

【解决方法】 如果要在终端现实print的结果,需要在配置文件config.ini中,将contracts-console 设为 true,即: contracts-console = true 该配置文件的位置在~/.local/share/eosio/nodeos/config,修改后重启节点。

3,参考

1) Hello World合约 2) Go笔记 1.3 让SourceInsight支持Golang 4) 【许晓笛】怎么看 EOS 的代码最爽? 5) source insight 背景颜色修改 代码字体大小修改 中文注释空格去除

点赞 0
收藏 0
分享

0 条评论

请先 登录 后评论
辉哥
辉哥
0x5bAe...0BE7
HiBlock技术社区上海合伙人,区块链落地产业应用布道者