开发第一个EOS智能合约

EOS智能合约的开发需要使用llvmabigen来生成abi文件。 为此eos提供了一个 名为eosiocpp的工具。 在这篇文章中,我们介绍如何使用这个工具来开发、部署并调用 一个EOS版本的hello world智能合约。

这篇文章的代码是在CentOS完成的,但在EOS支持的其他linux发行版上应该也没有问题。 如果你同时也对以太坊开发感兴趣,可以 访问我们的入门级的以太坊教程 以及更进阶的以太坊电商实战教程

智能合约撰写

首先,编写一个ahello.cpp文件 - EOS的合约开发使用C++语言:

1
2
3
# mkdir /home/centos/sc/ahello
# cd /home/centos/sc/ahello
# vim ahello.cpp

将以下内容插入到ahello.cpp文件中:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
#include <eosiolib/eosio.hpp>

#include <eosiolib/print.hpp>
using namespace eosio;

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

/// @abi action
void hi( account_name user ) {
print( "Hello, World", name{user} );
}
};

EOSIO_ABI( hello, (hi) )

接下来,编译并创建一个wast(web程序集)文件和一个abi文件。

1
2
3
# eosiocpp -o ahello.wast ahello.cpp

# eosiocpp -g ahello.abi ahello.cpp

智能合约的部署与交互

在部署合约之前,我们需要创建测试用的钱包、密钥和帐户。

首先,使用EOS客户端cleos创建一个名为scuser钱包,EOS使用钱包管理密钥:

1
2
3
4
5
6
# cleos wallet create -n scuser

Creating wallet: scuser
Save password to use in the future to unlock this wallet.
Without password imported keys will not be retrievable.
"PW5JzRwAUN-----------------------------nAuCRWvHx4XnMPmGf9Kz "

接下来同样使用cleos创建一个密钥对:

1
2
3
4
# cleos create key

Private key: 5KZzUHNFNvf------------------------------vuF5z7d29uAUbsdn
Public key: EOS63ndkvF-----------------------9ZVcByP9nfZcwMLzbMpn

然后将密钥保存在之前创建的钱包scuser中:

1
# cleos wallet import -n scuser 5KZzUHNFNvf---------------------d29uAUbsdn

还需要创建一个额外的账户进行测试:

1
2
3
4
# cleos create key

Private key: 5JbriTGYsnrpNDvL------------------LgniHVgyTnS5ommxo
Public key: EOS8XZoG2248Gu42-------------ps7JoW8tdHQwCsV

然后使用wallet子命令把这第二个密钥也存入钱包:

1
# cleos wallet import -n scuser 5JbriTGYsnrpND----------HVgyTnS5ommxo

接下来,使用create account子命令创建一个账户eosio —— 你需要使用账户与EOS区块链交互:

1
#./cleos create account eosio scuser EOS63ndkvF---------cByP9nfZcwMLzbMpn EOS8XZo-------wJnieps7JoW8tdHQwCsV

现在使用set contract子命令部署智能合约:

1
2
3
4
5
6
7
8
9
# cleos set contract scuser /home/centos/sc/ahello

Reading WAST/WASM from /home/centos/sc/ahello/ahello.wasm...
Using already assembled WASM...
Publishing contract...
executed transaction: 053a4883d9c191c2754656544dd045da17bd869250af13a00284a613eed3d23b 1792 bytes 601 us
# eosio <= eosio::setcode {"account":"scuser","vmtype":0,"vmversion":0,"code":"0061736d01000000013b0c60027f7e006000017e60027e7...
# eosio <= eosio::setabi {"account":"scuser","abi":{"types":[],"structs":[{"name":"hi","base":"","fields":[{"name":"user","ty...
warning: transaction executed locally, but may not be confirmed by the network yet

合约部署成功后,使用push action子命令来执行合约方法hi

1
2
3
4
5
6
7
# cleos push action scuser hi '["user1"]' -p scuser

executed transaction: 9ed2894aef0f476687ad893ed16594588cc7a813c524d4b8497ba9f50793b151 104 bytes 330 us
# scuser <= scuser::hi {"user":"user1"}

>> Hello, World user1
warning: transaction executed locally, but may not be confirmed by the network yet

你应该可以看到类似下图的结果:

eos hello world

代码分析

以上示例代码是EOS智能合约的基本模板。 我们现在将逐步分析上面编写的代码。

1
2
#include <eosiolib/eosio.hpp>
#include <eosiolib/print.hpp>

上述代码引入eos智能合约的头文件。

1
using namespace eosio;

上述代码使用eosio作为默认命名空间,因此在后续代码中可以直接使用诸如 account_name之类的数据类型。

1
class hello:public eosio :: contract {

创建一个hello类,继承自eosio预置的contract。

1
2
3
4
public:
using contract::contract;

/// @abi action

这显示了指定操作时在区块链中实际执行的功能。

1
2
3
4
5
6
      void hi( account_name user ) {
print( "Hello, World", name{user} );
}
};

EOSIO_ABI( hello, (hi) )

EOSIO_ABI是一个包含以前版本中的apply()函数的宏。

在这篇文章中,我们介绍了如何编写一个EOS版本的Hellow World智能合约,希望 有助于你初步了解EOS智能合约的开发。