【許曉笛】 EOS 智能合約案例解析(3)

philadelphia 發布于2019-06-27 18:54 / 3463人閱讀

摘要：文件地址智能合約文件由部分組成定義類型的別名各個類型的數據結構智能合約的數據結構體李嘉圖條款注格式不支持注釋，上面的雙斜線大家理解就好。是李嘉圖合約，剛剛被加入到智能合約中，官方還沒有進一步說明。

詳解 EOS 智能合約的 abi 文件

這次向大家介紹 eosio.token 智能合約的最后一個文件 —— abi文件。ABI 全稱 Application Binary Interface，中文名“應用程序二進制接口”，顧名思義是一個接口文件，描述了智能合約與上層應用之間的數據交換格式。abi 文件格式類似 JSON，具備很好的可讀性，有利于智能合約工程師與上層應用工程師之間的工作銜接。eosio.token.abi 文件地址： https://github.com/EOSIO/eos/...

EOS 智能合約 abi 文件由 5 部分組成：

{
    "types":[...],              //定義類型的別名
    "structs":[...],            //各個類型的數據結構
    "actions":[...],            //智能合約的 action
    "tables":[...],             //數據結構體
    "ricardian_clauses":[...]   //李嘉圖條款
}

注：JSON 格式不支持注釋，上面的雙斜線大家理解就好。

我們將按照 actions -> structs -> tables -> structs -> types -> ricardian_clauses 的順序了解 EOS 智能合約 abi 的開發方法。

actions

action 部分的作用是聲明智能合約有哪些可以調用的 action。如下所示。

  "actions": [{
      "name": "transfer",
      "type": "transfer",
      "ricardian_contract": ""
    },{
      "name": "issue",
      "type": "issue",
      "ricardian_contract": ""
    }, {
      "name": "create",
      "type": "create",
      "ricardian_contract": ""
    }

  ]

其中每一項的 name 就是 action 的名字，type 用來在 structs 中查找數據結構。ricardian_contract 是李嘉圖合約，剛剛被加入到 EOS 智能合約中，官方還沒有進一步說明。

structs

剛才的只聲明了三個 action 的名稱，我們還要在 structs 里聲明各個 action 需要傳入的參數，如下所示。

  "structs": [{
      "name": "transfer",
      "base": "",
      "fields": [
        {"name":"from", "type":"account_name"},
        {"name":"to", "type":"account_name"},
        {"name":"quantity", "type":"asset"},
        {"name":"memo", "type":"string"}
      ]
    },{
     "name": "create",
     "base": "",
     "fields": [
        {"name":"issuer", "type":"account_name"},
        {"name":"maximum_supply", "type":"asset"},
        {"name":"can_freeze", "type":"uint8"},
        {"name":"can_recall", "type":"uint8"},
        {"name":"can_whitelist", "type":"uint8"}
     ]
  },{
     "name": "issue",
     "base": "",
     "fields": [
        {"name":"to", "type":"account_name"},
        {"name":"quantity", "type":"asset"},
        {"name":"memo", "type":"string"}
     ]
  }
  ]

EOS 系統會根據 actions 部分中聲明的 type ,在 structs 部分尋找對應的數據結構，每個數據結構的 fields 中，會列出每個參數的名稱和類型。

tables

tables 列出了智能合約中需要建立的數據表名稱，以及數據表中所儲存的結構體名稱。

  "tables": [{
      "name": "accounts",
      "type": "account",
      "index_type": "i64",
      "key_names" : ["currency"],
      "key_types" : ["uint64"]
    },{
      "name": "stat",
      "type": "currency_stats",
      "index_type": "i64",
      "key_names" : ["currency"],
      "key_types" : ["uint64"]
    }
  ]

其中的 type 就是數據表中所儲存的結構體名稱。

structs

為什么又回到 structs 了呢，因為不光是 action 里的項目需要在 structs 里列出詳細的數據結構，tables 中的項目也需要。

  "structs": [{
      "name": "account",
      "base": "",
      "fields": [
        {"name":"balance", "type":"asset"},
        {"name":"frozen", "type":"uint8"},
        {"name":"whitelist", "type":"uint8"}
      ]
    },{
      "name": "currency_stats",
      "base": "",
      "fields": [
        {"name":"supply", "type":"asset"},
        {"name":"max_supply", "type":"asset"},
        {"name":"issuer", "type":"account_name"},
        {"name":"can_freeze", "type":"uint8"},
        {"name":"can_recall", "type":"uint8"},
        {"name":"can_whitelist", "type":"uint8"},
        {"name":"is_frozen", "type":"uint8"},
        {"name":"enforce_whitelist", "type":"uint8"}
      ]
    }
  ]

types

types 部分用來建立類型的別名，比如你想給 account_name 類型建立一個別名：

"types": [{
      "new_type_name": "account_name",
      "type": "name"
    }
  ]

這樣在這個 abi 文件里就可以用 name 來代替 account_name了。

ricardian_clauses

有關李嘉圖條款的部分 EOS 官方還在開發中。

相關文章和視頻推薦

【許曉笛】 EOS智能合約案例解析(1)
【許曉笛】 EOS智能合約案例解析(2)

圓方圓學院匯集大批區塊鏈名師，打造精品的區塊鏈技術課程。在各大平臺都長期有優質免費公開課，歡迎報名收看。
公開課地址：https://ke.qq.com/course/345101

云服務器 GPU云服務器智能合約區塊鏈智能合約技術區塊鏈智能合約開發數據分析案例解析

文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。

轉載請注明本文地址：http://specialneedsforspecialkids.com/yun/24418.html

【許曉笛】 EOS智能合約案例解析(1)

摘要：構造函數為空，參數為智能合約賬戶名。每個智能合約類都要繼承類類構造函數創建代幣函數聲明函數，這個函數用來新建一種代幣，并輸入代幣的各種屬性，同時函數也是一個。詳解 EOS 智能合約的 hpp 文件為了幫助大家熟悉 EOS 智能合約，EOS 官方提供了一個代幣（資產）智能合約 Demo —— eosio.token。eosio.token 智能合約目前還不是特別完善，個別功能還沒有完...

forsigner 2019-06-27 18:54 評論0 收藏0
【許曉笛】 EOS 智能合約案例解析(2)

摘要：相關文章和視頻推薦許曉笛智能合約案例解析許曉笛智能合約案例解析圓方圓學院匯集大批區塊鏈名師，打造精品的區塊鏈技術課程。詳解 EOS 智能合約的 cpp 文件之前的文章介紹了 eosio.token 智能合約的 hpp 文件，這次向大家介紹 eosio.token.cpp 文件，cpp 文件即 C++ 代碼文件，智能合約所有的業務邏輯內容都是在 cpp 文件中實現的。 eosio.t...

mengbo 2019-06-27 18:54 評論0 收藏0
【許曉笛】49行代碼就能發幣？而且EOS連例子都給你了

摘要：相關文章和視頻推薦許曉笛智能合約案例解析圓方圓學院匯集大批區塊鏈名師，打造精品的區塊鏈技術課程。 Daniel Larimer 在他的博客介紹了EOS新的智能合約架構（EOS團隊的開發速度實在是太嚇人，根本追不上）。他給出了最簡單的一個新幣種的智能合約代碼，僅有49行就能完成一個新幣種的開發，一個新的愛息歐就誕生了。讓我們一步一步實現吧。首先實現私有成員，建立一個 account 結...

Freeman 2019-06-27 18:53 評論0 收藏0
【許曉笛】深入理解 EOS 賬戶權限映射

摘要：為了解決這個問題，采取了三步用戶賬戶自定義分級權限。用戶權限與智能合約之間的映射。圖中不難看出，權限是賬戶最高權限，可以執行權限。如果沒有發現任何符合的映射，會直接檢查本次執行是否滿足了權限，若不足，會檢查。到底什么叫智能合約？名詞解釋：本篇文章出現很多 Action 和 Active，Action （動作）為 EOS 中賬戶可以接受的動作，也就是別人可以對你做什么；Active ...

zacklee 2019-06-27 18:55 評論0 收藏0
【許曉笛】EOS 新增的 WebAssembly 解釋器，是什么鬼？

摘要：對于很多沒有中間語言的字節碼的編程語言來說，根本不存在解釋執行與編譯執行的選項，比如傳統只能編譯執行，直接將代碼編譯成為可執行的二進制機器碼，我們電腦上文件就是編譯的成果。 Daniel Larimer 在最近的博客中透露，EOS 新增了官方的 WebAssembly 解釋器，用來解釋執行 WebAssembly 智能合約，加上之前的編譯執行，EOS 智能合約有了兩種執行方式。對于很...

SunZhaopeng 2019-06-27 18:53 評論0 收藏0