正文

EOS基础全家桶（十三）智能合约基础

西柚财经2020-06-30 03:31:00

简介

智能合约是现在区块链的一大特色，而不同的链使用的智能合约的虚拟机各不相同，编码语言也有很大差异。而今天我们开始学习EOS的智能合约，我也是从EOS初期一直开发合约至今，期间踩过无数坑，也在Stack Overflow上提过问（最后自己解决了），在实际生产中也积累了很多经验，所以我会连续几周分多次分享合约开发的经验，今天先来点基础的。

一些C++的编程基础

EOS就是使用C++开发的，这也为它带来了诸多好处，而合约也沿用C++作为开发语言，虽然合约中无法直接使用Boost等框架（你可以自己引入，但这也意味着合约会很大，会占用大量账号的内存），但是我们还是可以使用很多C++的小型库，并伴随着eosio.cdt的发展，融入了更多实用的合约功能。

如果你之前没有使用C系列的开发语言做过开发，比如：C语言、C++或者是C#，那么你需要先学习下C语言的基本语法和数据结构，这里我不做展开，在我们的系列文章的开篇就介绍了我推荐的Learn EOS - c/c++ 教程英文版，有一定英语基础的朋友可以直接看这个，其他朋友也可以在网上找一些C++的入门教程看下。

如果你已经有了一定的C语言基础，那么写合约的话，你会发现需要的基础也并不多，依葫芦画瓢就能写出各种基础功能了，所以，你并不需要担心太多语言上的门槛，毕竟合约只是一个特定环境下运行的程序，你能用到的东西并不会很多。

CDT选择

EOS的早期版本进行合约开发还没有CDT工具，那时的合约借助的是源码中的工具eosiocpp，所以你看2018年的博客，进行合约编译都是用它，但你现在是见不到了。随着官方CDT的迭代，在CDT的1.4版本开始被官方推荐使用，CDT后面也经历了几个大的版本更新，逐步改善合约编写方式，更加趋于简洁、直观。

但是不同的CDT版本，也意味着编译器的不同，所以合约开发也会有所区别，比如一些语法变了，一些库名称变了，增加了一些新的标注……

我们的教程侧重还是介绍最新的语法，所以推荐使用1.6以上的版本。我也会尽量在后面的介绍中补充说明老的CDT的写法，方便大家对照网上其他老博客的合约。

来个HelloWorld

学习任何编程，我们都不能少了Mr.HelloWorld，先来给大家打个招呼吧。

#include 

using namespace eosio;

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

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

基本合约结构及类型

hello合约就是一个最简单的合约了，而且还有一个可调用的action为hi。我们首先还是来介绍下一个合约的程序结构吧。

程序头

包含了引入的头文件、库文件等，还有全局的命名空间的引入等。

#include 

using namespace eosio;

这里eosio库是我们的合约基础库，所有和eos相关的类型和方法，都在这个库里面，而这个库里面eosio.hpp是基础，包含了contract等的定义，所以所有的合约都要引入。

【CDT老版本】早期cdt版本中库名称不是eosio，而是eosiolib

默认的，我们引入了eosio的命名空间，因为eosio的所有内容都是在这个命名空间下的，所以我们全局引入，会方便我们后续的代码编写。

合约类定义

其实就是定义了一个class，继承contract，并通过[[eosio::contract]]标注这个类是一个合约。使用using引入contract也是为了后续代码可以更简洁。

class [[eosio::contract]] hello : public contract{
public:
    using contract::contract;
}

【CDT老版本】早期cdt版本中直接使用了CONTRACT来定义合约类，比如：CONTRACT hello: public contract {}

action定义

写一个public的方法，参数尽量用简单或者是eosio内置的类型定义，无返回值（合约调用无法返回任何结果，除非报错），然后在用[[eosio::action]]标注这个方法是一个合约action就行。

注意：action的名称要求符合name类型的规则，name规则请看下面的常用类型中的说明。

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

因为合约无法调试，所以只能通过print来打印信息，或者直接通过断言抛出异常来进行调试。

【CDT老版本】早期cdt版本中直接使用ACTION来定义方法，比如：ACTION hi( name user ){}

常用类型

类型说明示例name名称类型，账号名、表名、action名都是该类型，只能使用26个小写字母和1到5的数字，特殊可以使用小数点，总长不超过13。name("hi") 或者 "hi"_nasset资产类型，Token都是使用该类型，包含了Token符号和小数位，是一个复合类型，字符形式为1.0000 EOSasset(10000, symbol("TADO", 4)就是1.0000 TADO)uint64_t无符号64位整型，主要数据类型，表主键、name实质都是改类型uint64_t amount = 10000000;

内置常用对象或方法

在合约中，contract基类提供了一些方便的内置对象。

首先是get_self()或者是_self，这个方法可以获取到当前合约所在的账号，比如你把hello合约部署到了helloworld111这个账号，那么get_self()就可以获取到helloworld111。

然后是get_code()或者是_code，这个方法可以获取到当前交易请求的action方法名，这个在进行内联action调用时可以用于判断入口action。

最后是get_datastream()或者_ds，这个方法获取的是数据流，如果你使用的是复杂类型，或者是自定义类型，那么你无法在方法的参数上直接获取到反序列化的变量值，你必须自己通过数据流来解析。

常用的还有获取当前时间current_time_point()，这个需要引入#include 。

数据持久化

当然，合约里面，我们总会有些功能需要把数据存下来，在链上持久化存储。所以我们就需要定义合约表了。

合约的表存在相应的合约账号中，可以划分表范围(scope)，每个表都有一个主键，uint64_t类型的，还可以有多个其他索引，表的查询都是基于索引的。

这里先提一句，表数据所占用的内存，默认是合约账号的内存，也可以使用其他账号的，但需要权限，这个以后我们再介绍。

我们扩展一下hello合约。

#include 
#include 

using namespace eosio;

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

    hello(name receiver, name code, datastream ds) : contract(receiver, code, ds), friend_table(get_self(), get_self().value)
    {
    }

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

        uint32_t now = current_time_point().sec_since_epoch();

        auto friend_itr = friend_table.find(user.value);
        if (friend_itr == friend_table.end())
        {
            friend_table.emplace(get_self(), [&](auto &f) {
                f.friend_name = user;
                f.visit_time = now;
            });
        }
        else
        {
            friend_table.modify(friend_itr, get_self(), [&](auto &f) {
                f.visit_time = now;
            });
        }
    }

    [[eosio::action]] void nevermeet(name user)
    {
        print("Never see you again, ", user);

        auto friend_itr = friend_table.find(user.value);
        check(friend_itr != friend_table.end(), "I don't know who you are.");

        friend_table.erase(friend_itr);
    }

private:
    struct [[eosio::table]] my_friend
    {
        name friend_name;
        uint64_t visit_time;

        uint64_t primary_key() const { return friend_name.value; }
    };

    typedef eosio::multi_index<"friends"_n, my_friend> friends;

    friends friend_table;
};

可以看到，我们已经扩充了不少东西了，包括构造函数，表定义，多索引表配置，并完善了原先的hi方法，增加了nevermeet方法。

我们现在模拟的是这样一个使用场景，我们遇到一个朋友的时候，就会和他打招呼(调用hi)，如果这个朋友是一个新朋友，就会插入一条记录到我们的朋友表中，如果是一个老朋友了，我们就会更新这个朋友的记录中的访问时间。当我们决定不再见这个朋友了，就是绝交了(调用nevermeet)，我们就会把这个朋友的记录删除。

表定义

首先我们需要声明我们的朋友表。定义一个结构体，然后用[[eosio::table]]标注这个结构体是一个合约表。在结构体里定义一个函数名primary_key，返回uint64_t类型，作为主键的定义。

private:
    struct [[eosio::table]] my_friend
    {
        name friend_name;
        uint64_t visit_time;

        uint64_t primary_key() const { return friend_name.value; }
    };

我们这里声明了一个my_friend的表，合约的表名不在这里定义，所以结构体的名称不必满足name的规则。我们定义了两个字段，friend_name(朋友的名称)和visit_time(拜访时间)，主键我们直接使用了friend_name，这个字段是name类型的，而name类型的实质就是一个uint64_t的类型(所以name的规则那么苛刻)。

【CDT老版本】早期cdt版本中直接使用TABLE来定义合约表，比如：TABLE my_friend{}

多索引表配置

合约里的表都是通过多索引来定义的，这是合约表的结构基础。所以这里才是定义表名和查询索引的地方。

typedef eosio::multi_index<"friends"_n, my_friend> friends;

我们现在只介绍最简单的单索引的定义，以后再介绍多索引的定义方式，这里的"friends"_n就是定义表名，所以使用了name类型，之后my_friend是表的结构类型，typedef实质上就是声明了一个类型别名，名字是friends的类型。

构造函数

构造函数这里并不是必须，但是为了我们能在全局直接使用合约表，所以我们要在构造函数进行表对象的实例化。

public:
    hello(name receiver, name code, datastream ds) : contract(receiver, code, ds), friend_table(get_self(), get_self().value)
    {
    }

private:
    friends friend_table;

这一段是标准合约构造函数，hello(name receiver, name code, datastream ds) : contract(receiver, code, ds)，合约类型实例化时会传入receiver也就是我们的合约账号(一般情况下)，code就是我们的action名称，ds就是数据流。

friend_table(get_self(), get_self().value)这一段就是对我们定义的friend_table变量的实例化，friend_table变量就是我们定义的多索引表的friends类型的实例。在合约里我们就可以直接使用friend_table变量来进行表操作了。实例化时传递的两个参数正是表所在合约的名称和表范围(scope)，这里都使用的是当前合约的名称。

查询记录

查询有多种方式，也就是多索引表提供了多种查询的方式，默认的，使用find和get方法是直接使用主键进行查询，下次我们会介绍使用第二、第三等索引来进行查询。find返回的是指针，数据是否存在，需要通过判断指针是否是指到了表末尾，如果等于表末尾，就说明数据不存在，否则，指针的值就是数据对象。get直接返回的就是数据对象，所以在调用get时，就必须传递数据不存在时的错误信息。

auto friend_itr = friend_table.find(user.value);
if (friend_itr == friend_table.end())
{
    //数据不存在
}else
{
    //数据存在
}

我们在hi方法中先查询了user是否存在。如果不存在，我们就添加数据，如果存在了，就修改数据中的visit_time字段的值为当前时间。

添加记录

多索引的表对象添加记录使用emplace方法，第一个参数就是内存使用的对象，第二个参数就是添加表对象时的委托方法。

uint32_t now = current_time_point().sec_since_epoch();

auto friend_itr = friend_table.find(user.value);
if (friend_itr == friend_table.end())
{
    friend_table.emplace(get_self(), [&](auto &f) {
        f.friend_name = user;
        f.visit_time = now;
    });
}
else
{
    //数据存在
}

这里先定义了一个变量now来表示当前时间，正是使用的内置方法current_time_point()，这个还是用了它的sec_since_epoch()方法，是为了直接获取秒单位的值。

我们查询后发现这个user的数据不存在，所以就进行插入操作，内存直接使用的合约账号的，所以使用get_self()，然后对表数据对象进行赋值。

修改记录

多索引的表对象修改记录使用modify方法，第一个参数是传递需要修改的数据指针，第二个参数是内存使用的对象，第二个参数就是表对象修改时的委托方法。

friend_table.modify(friend_itr, get_self(), [&](auto &f) {
    f.visit_time = now;
});

我们将查询到的用户对象的指针friend_itr传入，然后内存还是使用合约账号的，委托中，我们只修改visit_time的值(主键是不能修改的)。

删除记录
多索引的表对象删除记录使用erase方法，只有一个参数，就是要删除的对象指针，有返回值，是删除数据后的指针偏移，也就是下一条数据的指针。

auto friend_itr = friend_table.find(user.value);
check(friend_itr != friend_table.end(), "I don't know who you are.");

friend_table.erase(friend_itr);

我们的示例中，将查询到的这条数据直接删除，并为使用变量来接收下一条数据的指针，在连续删除数据时，你会需要获取下一条数据的指针，因为已删除的数据的指针已经失效了。

编译

编译我们再之前也有过介绍，安装了eosio.cdt后，我们就有了eosio-cpp命令，进入到合约文件夹中，直接执行以下命令就会在当前目录生成wasm和abi文件。

eosio-cpp -abigen hello.cpp -o hello.wasm

注意:替换命令中使用的hello.cpp为实际合约代码文件名，而hello.wasm为实际合约的wasm文件名。

当然，编译不通过的时候，你就要看看错误是什么了，这可能会考验一下你的C++功底。

发布

决定了要发布的账号后，记得要购买足够的内存和抵押足够的资源。合约的内存消耗我们可以大致这样估算，看下编译好了的合约wasm文件有多大，然后乘以10，就是你发布到链上大概所需的内存大小了。

发布合约我们使用cleos set contract命令，其后跟合约账号名和合约目录，为了方便，我建议你把合约的目录名保持和合约文件名一致。

cleos set contract helloworld111 ./hello -p helloworld111

这里我们给出的代码是将hello目录下的hello合约发布到helloworld111。我这里的文件夹是hello，里面的abi和wasm也都是hello，这样你不用手动指定合约文件了。

总结

至此，我想大家应该对合约的编写有了一个大致的了解了，至少你可以参照着写个简单的合约出来了，这其中还有很多技巧和高级用法，我会在后续的文章中继续和大家分享。

更多内容请关注微信公众号

EOS基础全家桶（十三）智能合约基础

免责声明：本文版权归原作者所有，不代表MyToken(www.mytokencap.com)观点和立场；如有关于内容、版权等问题，请与我们联系。

关于MyToken：https://www.mytokencap.com/aboutus本文链接：https://www.mytokencap.com/news/145862.html

上一篇:慕辰解币：6.30 BTC 行情分析及建议

下一篇:“叫好不叫坐”的 DeFi，正在酝酿下一个爆发点？

专访Amber Group合伙人Annabelle：一路寻梦，从华尔街到加密金融 | 「女神节」特辑

今天，是 105 个国际妇女节。

比特币（BTC）的半衰期是什么｜它会影响价格吗？

从2020年底到2021年，比特币价格上涨，最终突破50,000美元大关。有多种因素影响比特币价格市场，但主要因素之一是半衰期。但是，对于不熟悉加密货币的人来说，有许多人不知道半衰期是什么以及它是如何工作的。因此，最新数字货币财经交易行情数据的区块链技术官网公益平台。

比特币跌破5万关口，空头情绪较浓

今日快讯：日内恐慌与贪婪指数为77（昨日为84），贪婪程度有所缓解，等级仍为极度贪婪。注：恐慌指数阈值为0-100，包含指标：波动性（25%）＋市场交易量（25%）＋社交媒体热度（15%）＋市场调查（15%）＋比特币在整最新数字货币财经交易行情数据的区块链技术官网公益平台。