第6课 用SI编写"Hello World"

作者: 笔名辉哥 | 来源:发表于2018-07-06 16:39 被阅读201次

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

    相关文章

      网友评论

        本文标题:第6课 用SI编写"Hello World"

        本文链接:https://www.haomeiwen.com/subject/bnnpuftx.html