原 EOS智能合約開發入門

鏈客，專爲開發者而生，有問必答！

此文章來自區塊鏈技術社區，未經容許拒絕轉載。

EOS智能合約的開發須要使用llvm和abigen來生成abi文件。 爲此eos提供了一個 名爲eosiocpp的工具。 在這篇文章中，咱們介紹如何使用這個工具來開發、部署並調用 一個EOS版本的hello world智能合約。

這篇文章的代碼是在CentOS完成的，但在EOS支持的其餘linux發行版上應該也沒有問題。 若是你同時也對以太坊開發感興趣，能夠 訪問咱們的入門級的以太坊教程 以及更進階的以太坊電商實戰教程。

智能合約撰寫
首先，編寫一個ahello.cpp文件 - EOS的合約開發使用C++語言：

mkdir /home/centos/sc/ahello

cd /home/centos/sc/ahello

vim ahello.cpp

將如下內容插入到ahello.cpp文件中：

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文件。

eosiocpp -o ahello.wast ahello.cpp

eosiocpp -g ahello.abi ahello.cpp

智能合約的部署與交互
在部署合約以前，咱們須要建立測試用的錢包、密鑰和賬戶。

首先，使用EOS客戶端cleos建立一個名爲scuser錢包，EOS使用錢包管理密鑰：

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建立一個密鑰對：

cleos create key

Private key: 5KZzUHNFNvf------------------------------vuF5z7d29uAUbsdn
Public key: EOS63ndkvF-----------------------9ZVcByP9nfZcwMLzbMpn
而後將密鑰保存在以前建立的錢包scuser中：

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

還須要建立一個額外的帳戶進行測試：

cleos create key

Private key: 5JbriTGYsnrpNDvL------------------LgniHVgyTnS5ommxo
Public key: EOS8XZoG2248Gu42-------------ps7JoW8tdHQwCsV
而後使用wallet子命令把這第二個密鑰也存入錢包：

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

接下來，使用create account子命令建立一個帳戶eosio —— 你須要使用帳戶與EOS區塊鏈交互：

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

如今使用set contract子命令部署智能合約：

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：

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智能合約的基本模板。 咱們如今將逐步分析上面編寫的代碼。

include <eosiolib/eosio.hpp>

include <eosiolib/print.hpp>

上述代碼引入eos智能合約的頭文件。

using namespace eosio;
上述代碼使用eosio做爲默認命名空間，所以在後續代碼中能夠直接使用諸如 account_name之類的數據類型。

class hello：public eosio :: contract {
建立一個hello類，繼承自eosio預置的contract。

public:
using contract::contract;

/// @abi action
這顯示了指定操做時在區塊鏈中實際執行的功能。

void hi( account_name user ) {
     print( "Hello, World", name{user} );
  }

};

EOSIO_ABI( hello, (hi) )
EOSIO_ABI是一個包含之前版本中的apply()函數的宏。

在這篇文章中，咱們介紹瞭如何編寫一個EOS版本的Hellow World智能合約，但願 有助於你初步瞭解EOS智能合約的開發。