開(kāi)發(fā)第一個(gè) EOS 智能合約

Hello World!

稍微了解 EOS 系統(tǒng)稿黍，你就會(huì)知道 EOS 的智能合約基于 WebAssembly(WASM) 技術(shù)克蚂，這種技術(shù)在性能和跨平臺(tái)兼容性之間取得了很好的平衡缅茉，通過(guò)將原始代碼編譯成字節(jié)碼，使得代碼可以在多種平臺(tái)的 WASM 虛擬機(jī)（或者叫解釋器）中執(zhí)行纯蛾。得到了蘋(píng)果和谷歌等科技巨頭的支持幸逆，被譽(yù)為下一代互聯(lián)網(wǎng)前端技術(shù)。目前的 WebAssembly 技術(shù)支持 C/C++ 語(yǔ)言闰渔，并開(kāi)發(fā)了 JavaScript 接口席函，并被 Chrome、Edge冈涧、Safari茂附、Firefox 等幾乎所有的主流瀏覽器支持正蛙。

因?yàn)槭褂昧?WebAssembly，目前的 EOS 智能合約只支持 C/C++ 語(yǔ)言营曼，簡(jiǎn)單的智能合約由 3 種文件組成：.hpp文件乒验、.cpp文件、.abi 文件蒂阱。其中 hpp 為 C++ 頭文件锻全，一般用來(lái)定義類及其成員變量與成員函數(shù)。cpp 為 C++ 文件录煤，用來(lái)實(shí)現(xiàn) hpp 中聲明的成員函數(shù)鳄厌，實(shí)現(xiàn)智能合約的業(yè)務(wù)邏輯。abi(Application Binary Interface) 文件為二進(jìn)制接口文件妈踊，文件格式類似 JSON了嚎，用來(lái)定義智能合約與 EOS 系統(tǒng)外部交互的數(shù)據(jù)接口。

如果智能合約的非常簡(jiǎn)單廊营，只有一個(gè) cpp 文件新思，可以省略 hpp 文件，將類與成員定義在 cpp 文件中赘风。abi 文件應(yīng)該由 C++ 程序需要的數(shù)據(jù)庫(kù)空間和外部接口生成夹囚，不過(guò) EOS 開(kāi)發(fā)了 abi 自動(dòng)生成工具，可以根據(jù)智能合約代碼自動(dòng)生成 abi 文件邀窃，減輕了開(kāi)發(fā)工作量荸哟。所以最簡(jiǎn)單的智能合約只需實(shí)現(xiàn) cpp 文件。

image.png

Hello 智能合約

一般的操作系統(tǒng)上手時(shí)瞬捕，慣例是編寫(xiě)一個(gè) Hello World 程序鞍历，是主動(dòng)輸出一句話。但我們不一樣肪虎，我們編寫(xiě)的是一個(gè)智能合約劣砍，智能合約強(qiáng)調(diào)的是互動(dòng)，在 EOS 里叫做 Action扇救，Action 表示別人可以對(duì)合約做什么動(dòng)作刑枝，所有智能合約代碼都是對(duì) Action 的回應(yīng)，是被動(dòng)的迅腔。下面就是第一個(gè) Hello 智能合約：

hello.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, ", name{user} );
      }
};

EOSIO_ABI( hello, (hi) )

我們?cè)诖a中定義了一個(gè)類：hello装畅，這個(gè)類名與合約的賬戶名沒(méi)關(guān)系，類中只有一個(gè)簡(jiǎn)單的方法：

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

這就是 EOS 智能合約里所謂的 Action沧烈，我們定義了一個(gè)叫 hi 的 Action掠兄，參數(shù)是另一個(gè)賬戶名，函數(shù)體是打印一句話，回應(yīng) hello蚂夕。 也就是說(shuō)別的賬戶可以調(diào)用這個(gè)合約的 hi Action迅诬，這個(gè) hello 合約就會(huì)打印一句 hello 來(lái)回應(yīng)。

最后一行代碼：

EOSIO_ABI( hello, (hi) )

EOSIO_ABI 是一個(gè)宏婿牍，將特定類的特定方法暴漏給系統(tǒng)侈贷，成為別的賬戶可以調(diào)用的 Action。

編譯智能合約

我們使用 eosiocpp 工具將寫(xiě)好的 hello.cpp 編譯成為字節(jié)碼文件(.wast)：

$ eosiocpp -o hello.wast hello.cpp

然后使用 eosiocpp 工具自動(dòng)生成 abi 文件：

$ eosiocpp -g hello.abi hello.cpp
Generated hello.abi

看一下生成的 abi 文件內(nèi)容：

{
  "____comment": "This file was generated by eosio-abigen. DO NOT EDIT - 2018-04-16T13:37:55",
  "types": [],
  "structs": [{
      "name": "hi",
      "base": "",
      "fields": [{
          "name": "user",
          "type": "account_name"
        }
      ]
    }
  ],
  "actions": [{
      "name": "hi",
      "type": "hi",
      "ricardian_contract": "# CONTRACT FOR hello::hi## ACTION NAME: hi\n 
      ### Parameters### Parameters\nInput paramters:Input paramters:\n 
      \n 
      * `user` (string to include in the output)* `user` (string to include in the output)\n
      \n 
      Implied parameters: Implied parameters: \n 
      \n 
      * `account_name` (name of the party invoking and signing the contract)* `account_name` (name of the party invoking and signing the contract)\n 
      \n 
      ### Intent### Intent\n 
      INTENT. The intention of the author and the invoker of this contract is to print output. It shall have no other effect.INTENT. The intention of the author and the invoker of this contract is to print output. It shall have no other effect.\n 
      \n 
      ### Term### Term\n 
      TERM. This Contract expires at the conclusion of code execution.TERM. This Contract expires at the conclusion of code execution.\n" 
    }
  ],
  "tables": [],
  "ricardian_clauses": [

   ...
   ...
   ...

  ]
}

我們省略了 ricardian_clauses 牍汹，也就是李嘉圖條款部分(李嘉圖合約指的是人與機(jī)器都能讀懂的合同铐维，EOS 最近才將其加入智能合約中)。我們看到 abi 文件中已經(jīng)聲明了 hi 這個(gè) Action慎菲，并說(shuō)明了這個(gè) Action 的李嘉圖合約嫁蛇，大概意思是本合約的輸入為一串字符（user），本合約意圖是打印輸出露该，沒(méi)有其他效果睬棚。

上傳智能合約

上傳智能合約之前，我們要先給智能合約建立一個(gè)賬戶 EOS 里賬戶和智能合約是一一對(duì)應(yīng)的解幼。使用 EOS 的 cleos 命令行工具創(chuàng)建賬戶：

$ cleos create account eosio hello.code EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4 EOS7ijWCBmoXBi3CgtK7DJxentZZeTkeUnaSDvyro9dq7Sd1C3dC4

命令中抑党，hello.code 就是這個(gè)智能合約的賬戶名，EOS系統(tǒng)的賬戶名要求 12 字符以內(nèi)撵摆。后面兩個(gè)公鑰是在本地測(cè)試網(wǎng)絡(luò)中有建立賬戶權(quán)限的公鑰（對(duì)應(yīng)本地測(cè)試網(wǎng)絡(luò)中的 eosio 賬戶）底靠。

然后就可以上傳智能合約了：

$ cleos set contract hello.code ../hello -p hello.code

使用智能合約

我們使用 user 賬戶調(diào)用 hello.code 的 hi Action:

$ cleos push action hello.code hi '["user"]' -p user

hello.code 表示執(zhí)行 hello.code 合約，hi 表示執(zhí)行合約里的 hi Action特铝，'["user"]' 是根據(jù) abi 寫(xiě)的傳入?yún)?shù)暑中， -p 參數(shù)表示使用哪個(gè)賬戶的權(quán)限 (permission)。

以下是系統(tǒng)回應(yīng)：

executed transaction: 4c10c1426c16b1656e802f3302677594731b380b18a44851d38e8b5275072857  244 bytes  1000 cycles
#    hello.code <= hello.code::hi               {"user":"user"}
>> Hello, user

說(shuō)明執(zhí)行了 hello.code 合約的 hi Action鲫剿，并且系統(tǒng)輸出為 Hello, user,智能合約成功對(duì) Action 進(jìn)行了回應(yīng)鳄逾。

相關(guān)文章和視頻推薦

【許曉笛】EOS 新增的 WebAssembly 解釋器，是什么鬼灵莲？
http://www.reibang.com/p/06f86dd434ad

圓方圓學(xué)院匯集大批區(qū)塊鏈名師雕凹，打造精品的區(qū)塊鏈技術(shù)課程。 在各大平臺(tái)都長(zhǎng)期有優(yōu)質(zhì)免費(fèi)公開(kāi)課政冻，歡迎報(bào)名收看枚抵。

公開(kāi)課地址：https://ke.qq.com/course/345101