EOS开发入门



  在上一篇文章《EOS开发环境搭建》中,我们已经完成了EOS开发环境的搭建,本次为大家带来的是EOS开发入门的相关内容。

1. EOS的合约开发基础

  智能合约是一种旨在以信息化方式传播、验证或执行合同的计算机协议。智能合约允许在没有第三方的情况下进行可信交易,这些交易可追踪且不可逆转。

1.1 所需知识

  • 熟悉或了解C++14的基本语法,这部分技能需要掌握,短时间内无法搞定。
  • 了解abi(The Application Binary Interface)文件,基于json格式的,描述合约的接口

1.2 c++与智能合约部分语法

  • require_auth——
    require_auth(name user): 验证用户是否有签名
  • [[eosio::action]] action声明的特殊标记
  • asset 是eos官方提供的一个结构体,内部主要有2个元素:amountsymbol
  • eosio_assert( expr, "errmsg" ) 验证表达式是否位置,类似于以太坊的assert
  • [[eosio::table]] table声明的特殊标记,在结构体声明中使用
  • multi_index 是eos提供的一个数据库存储结构,可以支持多个索引,同样有增删改查接口
struct [[eosio::table]] task {
         uint64_t    taskID;
         name        creator; 
         name        worker;
         asset       bonus;
         uint8_t     status = 0;
         string      remark;
         string      comment;

         uint64_t primary_key()const { return taskID; }
      };

      typedef eosio::multi_index< "tasks"_n, task > tasks;
      //tasks 是最终的表名字,task是结构体名字
  • multi_index可以使用 findemplacemodifyearse四个接口,使用时需要先用tasks定义变量
tasks tk( _code, _code.value );

    tk.emplace( creator, [&](auto &t){
        t.creator = creator;
        t.worker  = worker;
        t.taskID  = tk.available_primary_key();//主键自动增长
        t.bonus   = taskBonus;
        t.remark  = memo;
    });

1.3 理解abi文件

  这是一个空的abi文件

{
   "version": "eosio::abi/1.0",
   "types": [],
   "structs": [],
   "actions": [],
   "tables": [],
   "ricardian_clauses": [],
   "abi_extensions": [],
   "___comment" : ""
}
  • types 新类型定义
  • structs 合约内结构体定义
  • actions 合约内动作定义,注意在合约中需要使用特殊的标记才能在abi中得到
  • tables 合约内表结构定义,注意在合约中需要使用特殊的标记才能在abi中得到
  • ricardian_clauses 李嘉图条款
  • abi_extensions 扩展

  其中structsactionstables可以认为是abi文件的三要素,每个合约内可以有多个action,每个action会执行这样那样的逻辑,需要借助结构体的结构将信息存储或变更保存在区块链中,这个保存的数据我们类比为传统数据库中的表,也就是tables。我们学习智能合约编写主要要写什么?其实就是写一个一个action,类似于rpc中的微服务。与传统数据库编程一样,我们同样也是围绕着table做增删改查操作。

2. EOS的hello智能合约

2.1 编写hello合约

  • 合约代码如下
#include <eosiolib/eosio.hpp>
#include <eosiolib/print.hpp>

using namespace eosio;

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

      [[eosio::action]]
      void hi( name user ) {
         print( "Hello, ", user);
      }
};

EOSIO_DISPATCH( hello, (hi))

上例中hello是我们的类名,需要继承eos为我们提供的基类contract,[[eosio::action]]是一个特殊用法,定义一个action必须在函数声明前加上此标记。hi这个函数就是一个 action,本例实现的就是一个打招呼的action,根据输入的不同用户进行打招呼。

EOSIO_DISPATCH( hello, (hi)) 是生成action的关键,EOSIO_DISPATCH是eos提供的宏,hello显然就是类名,(hi)就是要生成的action,如果多个action,采用相同格式在后面添加。

2.2 hello合约的部署和调用

  • 使用eosio-cpp编译hello合约,这个就来自于cdt工具包
eosio-cpp -o hello.wasm hello.cpp --abigen

image

  • 创建hello合约账户
cleos create account eosio hello YOUR_PUBLIC_KEY -p eosio@active
  • 部署hello合约
cleos set contract hello ./hello -p hello@active

image

  • 调用hello合约
//先创建一个普通账户bob
cleos create account eosio bob YOUR_PUBLIC_KEY -p eosio@active
//bob调用hello合约的hi动作
cleos push action hello hi '["bob"]' -p bob@active

image

  到这一步,一个简单的hello智能合约就部署并调用完成了,快来试试吧。下次将为大家分享关于EOS开发实战的内容,敬请关注。




image

内容来源于网络如有侵权请私信删除
你还没有登录,请先登录注册
  • 还没有人评论,欢迎说说您的想法!