本篇主要涉及的內容有：

1、前置概念介紹；

2、土味智慧合約入門：hello；

3、呼叫hello合約。

1、前置概念介紹

1.1  什麼是WebAssembly

之前如果大家簡單地瀏覽過eos專案資料夾，就會看到很多`.wasm`檔案，而wasm就是WebASseMbly的縮寫。這裡讓我們略過Flash、JavaScript和WebAssembly的愛恨情仇（發展演化），直接一句話概括一下：‘WebAssembly’是一種新的編碼方式，可以在現代的網路瀏覽器中執行。

想象它是一種可以把底層語言檔案變得像JS那樣，可以直接在瀏覽器中執行。而且比JS更輕量、更快速、更安全。過程如下圖：

還有一個大家在`build` eos的過程中看過一百遍的詞：`LLVM`。

LLVM是一些分模組、可重用的編譯工具鏈。它提供了一種程式碼編寫良好的中間表示（IR）。它在上圖中的位置大概是介於第一步和第二步之間。如果想把C/C++變成WASM檔案，就需要先把C/C++程式碼先變成LLVM中間程式碼。一旦變換成了LLVM IR之後，就說明LLVM已經理解了程式碼並會對程式碼自動地做出一些優化。而WebAssembly也並不是只有`wasm`一種格式，它還有`wast`格式。這兩者作用是等價的，最大的區別就是`wast`是可讀文字格式的，而`wasm`是二進位制格式的，他們可以通過工具相互轉換。

讓我們高度總結一下WebAssembly：可以讓瀏覽器識別底層語言的神器。（筆者感覺和以太坊中的編譯器作用差不多）。

1.2  什麼是ABI

玩過以太坊的同學可能對ABI並不陌生，在EOS中ABI的作用也和以太坊中大致類似：

它定義了函式被呼叫的規則；定義了引數在呼叫者和被呼叫者之間是如何傳遞的。如果說`wasm`檔案是產品的話，要想順利使用這件產品，你還需要一本操作說明書，而`ABI`就是這份說明書。

2、土味智慧合約入門：hello

一說入門就要說<hello world>，這種感覺很low，同時也很“程式設計師”。感謝雷佳音讓我找到了一個並不尷尬的小標題：土味hello。

2.0   準備工作

進度保持在我們上一篇結束的地方：我們已經學會使用操作eosio賬戶、建立了新賬戶`testeosio`。在正文開始之前，請啟動`nodeos`，相關錢包處於unlock狀態。

2.1  修改`config.ini`

找到位於vim ~/Library/Application\Support/eosio/nodeos/config/中的`config.ini`檔案，開啟找到下面這句話：

# print contract's output to console (eosio::chain_plugin)
contracts-console = false

把上面的`false`改成`true`，儲存修改退出。這樣我們就可以在終端直接看到智慧合約的執行情況。（這裡筆者重新啟動了nodeos）

2.2  建立`hello`合約

這裡我們用到了一個小工具叫`eosiocpp`。eosiocpp是一個c++生成wasm和ABI檔案的工具。eos專案中自帶了一個hello合約，為了區分，這裡我們建立一個合約叫做`hello1`。執行以下語句建立新合約：

eosiocpp -n hello1

它會以樣例合約為基礎建立一個最簡單的合約。看到下面即表示建立成功：

這時在當前資料夾下就可以看到有一個`hello1`的資料夾。進入`hello1`資料夾，可以看到裡面有兩個檔案：

➜  hello1 git:(master) ✗ ls
hello1.cpp hello1.hpp

• `hello1.hpp`是智慧合約的標頭檔案，可以包含一些變數，常量和函式的宣告。

• `hello1.cpp`是合約的原始碼檔案，包含合約的具體實現。

2.3  生成wasm和abi檔案

進入`hello1`資料夾下執行以下命令：

#使用 -o 生成wast檔案和wasm檔案
eosiocpp -o ./hello1.wast ./hello1.cpp

#使用 -g 生成abi檔案
eosiocpp -g ./hello1.abi ./hello1.cpp

這時可以看到在當前資料夾下生成了`hello1.wast`、`hello1.wasm`和`hello1.abi`檔案。

2.4  部署智慧合約

使用我們剛剛生成的檔案部署智慧合約。輸入如下命令：

cleos set contract eosio ./ ./hello1.wast hello1.abi -p [email protected]

這行命令有五個引數：`eosio`表示部署合約的賬戶，`./`表示合約所在的資料夾，後面兩個引數依次是`.wast`和`.abi`檔案的路徑，最後的`-p [email protected]`表示許可權。執行成功如下圖所示：

3、呼叫hello合約

在執行呼叫命令之前，我們先簡單地瞭解EOS中的一個概念：`transaction`和`action`。

Action表示單個操作。而transaction是一個或多個action的集合。Action是合約和賬戶之間進行通訊的方式。Action可以單獨執行，或者組合組合起來作為一個整體執行。

在官網中我們也可以看到包含一個action和多個action的transaction的例子。對比來看的話，EOS中的action就相當於以太坊中的transaction。執行以下命令來呼叫hello1合約中的`hi`方法：（執行的賬戶是testeosio）

cleos push action eosio hi '["hammer"]' -p testeosio

執行成功就可以看到如下介面:

這時如果我們去看執行`nodeos`的終端視窗，可以看到下面的提示：

同樣打印出了`Hello, hammer`