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

forsigner 發(fā)布于2019-06-27 18:54 / 3362人閱讀

摘要：構(gòu)造函數(shù)為空，參數(shù)為智能合約賬戶名。每個(gè)智能合約類都要繼承類類構(gòu)造函數(shù)創(chuàng)建代幣函數(shù)聲明函數(shù)，這個(gè)函數(shù)用來新建一種代幣，并輸入代幣的各種屬性，同時(shí)函數(shù)也是一個(gè)。

詳解 EOS 智能合約的 hpp 文件

為了幫助大家熟悉 EOS 智能合約，EOS 官方提供了一個(gè)代幣（資產(chǎn)）智能合約 Demo —— eosio.token。eosio.token 智能合約目前還不是特別完善，個(gè)別功能還沒有完成。但這個(gè)示例合約給出了 EOS 官方智能合約開發(fā)的標(biāo)準(zhǔn)結(jié)構(gòu)和開發(fā)方法，并且真正的 EOS 代幣也會(huì)借鑒這個(gè)示例合約的邏輯，是 EOS 智能合約入門的經(jīng)典案例。

照例，eosio.token 合約由三個(gè)文件（cpp，hpp，abi）文件組成，本篇文章將為大家講解 eosio.token.hpp 文件。原文件地址：https://github.com/EOSIO/eos/tree/master/contracts/eosio.token

預(yù)處理指令 & 頭文件

代碼的開頭聲明了頭文件，主要是 eos 智能合約的 API 庫。

//預(yù)處理指令，防止文件被重復(fù)包含
#pragma once

//eos 資產(chǎn)（asset）頭文件
#include 
//eos 智能合約 API 庫
#include

構(gòu)造函數(shù)

智能合約的類名可以與智能合約名不同，智能合約的名字是其賬戶名。構(gòu)造函數(shù)為空，參數(shù)為智能合約賬戶名。

   //每個(gè)智能合約類都要繼承 contract 類
   class token : public contract {
      public:
         //類構(gòu)造函數(shù)
         token( account_name self ):contract(self){}

創(chuàng)建代幣函數(shù)(action)

聲明 create 函數(shù)，這個(gè)函數(shù)用來新建一種代幣，并輸入代幣的各種屬性，同時(shí) create 函數(shù)也是一個(gè) action。action 是 eos 智能合約的接口函數(shù)，定義外界可以對智能合約做什么動(dòng)作。

                      //參數(shù)：發(fā)幣者
         void create( account_name issuer,
                      //資產(chǎn)最大數(shù)目
                      asset        maximum_supply,
                      //資產(chǎn)是否可以凍結(jié)
                      uint8_t      issuer_can_freeze,
                      //資產(chǎn)是否可以召回
                      uint8_t      issuer_can_recall,
                      //資產(chǎn)是否可以設(shè)置白名單
                      uint8_t      issuer_can_whitelist );

增發(fā)代幣函數(shù)(action)

聲明 issue 函數(shù)，這個(gè)函數(shù)用來增發(fā)代幣，eosio.token 合約并不是新建了代幣就會(huì)得到代幣，新建的代幣只是存儲(chǔ)了資料，發(fā)幣者要想獲取代幣，需要調(diào)用 issue action 來獲得代幣。

         //參數(shù)：接收新代幣賬戶，新增多少代幣，memo
         void issue( account_name to, asset quantity, string memo );

轉(zhuǎn)賬函數(shù)(action)

聲明 transfer 函數(shù)，這個(gè)函數(shù)用來轉(zhuǎn)賬，是代幣智能合約最常用的函數(shù)。

                        //發(fā)送賬戶
         void transfer( account_name from,
                        //接收賬戶
                        account_name to,
                        //代幣數(shù)量
                        asset        quantity,
                        //memo
                        string       memo );

私有數(shù)據(jù)結(jié)構(gòu)

智能合約需要存儲(chǔ)每種代幣的資料，還要存儲(chǔ)每個(gè)賬戶持有每種代幣的數(shù)量。

      private:
         //account 結(jié)構(gòu)體，單個(gè)記錄賬戶存儲(chǔ)單個(gè)代幣的情況
         struct account {
            //資產(chǎn)余額
            asset    balance;
            //賬戶是否凍結(jié)
            bool     frozen    = false;
            //賬戶是否在白名單
            bool     whitelist = true;
            //設(shè)置賬戶主鍵為代幣名稱
            uint64_t primary_key()const { return balance.symbol.name(); }
         };
         //currency_stats 結(jié)構(gòu)體，記錄當(dāng)代幣狀態(tài)信息
         struct currency_stats {
            //流通量
            asset          supply;
            //最大可流通量
            asset          max_supply;
            //發(fā)幣者
            account_name   issuer;
            //是否可以凍結(jié)
            bool           can_freeze         = true;
            //是否可以召回
            bool           can_recall         = true;
            //是否可以設(shè)置白名單
            bool           can_whitelist      = true;
            //是否已經(jīng)凍結(jié)
            bool           is_frozen          = false;
            //是否已經(jīng)設(shè)置白名單
            bool           enforce_whitelist  = false;
            //設(shè)置主鍵為代幣名稱
            uint64_t primary_key()const { return supply.symbol.name(); }
         };
         //設(shè)置一個(gè)multi_index類型，存儲(chǔ) account 結(jié)構(gòu)體
         typedef eosio::multi_index accounts;
         //設(shè)置一個(gè)multi_index類型，存儲(chǔ) currency_stats 結(jié)構(gòu)體
         typedef eosio::multi_index stats;

私有函數(shù)

合約公有兩個(gè)私有函數(shù)，分別是給賬戶增加某種資產(chǎn)，和給賬戶減少某種資產(chǎn)。

         //增加資產(chǎn)函數(shù)：賬戶，增加數(shù)量，代幣狀態(tài)結(jié)構(gòu)體
         void sub_balance( account_name owner, asset value, const currency_stats& st );
         //減少資產(chǎn)函數(shù):賬戶，減少數(shù)量    ，代幣狀態(tài)結(jié)構(gòu)體
         void add_balance( account_name owner, asset value, const currency_stats& st,
                           //ram 資源支付者
                           account_name ram_payer );

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

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

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

公開課地址：https://ke.qq.com/course/345101