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

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 背景颜色修改 代码字体大小修改 中文注释空格去除