EOS开发(3) -- currency合约分析

currency.png

目录

EOS开发(1) -- 安装及常用工具介绍
EOS开发(2) -- 发布智能合约
EOS开发(3) -- currency合约分析

前一段时间一直在看如何在eos上进行开发,作为一个dapp开发者,最主要的就是去写智能合约和区块链交互,这次分析的主要分支是在dawn-2.x稳定版本,以后eos结构可能也会变，但是不会有特别大的变化

合约结构

currency_contract.png

• 可以看到在contracts合约目录下有个currency目录,这个目录里的内容就是我们所要分析的

• 主要分析是后面三个文件,abi应用程序二进制接口文件,hppc++头文件,cppc++代码逻辑文件

• abi 文件主要是定义接口和整体的结构

• hpp 主要是去引入一些依赖和做一些结构的声明,设计上的事情都放在这里

• cpp 主要就是合约的逻辑了,对于不同的事件 去应用不同的处理逻辑,还包括合约初始化的方法

hpp头文件分析

//eos的头文件依赖
#include   
//定义token的头文件依赖 比如token结构体
#include 
//操作区块链的底层方法的头文件
#include 

namespace currency {
   //定义一个currency token结构 泛型第一个代表token的类型,第二个是token_name
   typedef eosio::token currency_tokens;

   /**
    *  在用户表里存的每一条记录(可以理解成我们数据库里的每一行)
    *  @abi table
    */
   struct account {
      //构造函数 
      account( currency_tokens b = currency_tokens() ):balance(b){}

      
      //key 是 constant 因为每个用户只在每个currency里存在一条
      const uint64_t     key = N(account);
      
      //每个账户里的余额
      currency_tokens     balance;

      //验证余额是否为空方法 c++ struct类似于class 不过默认对成员的访问是public的 class是private的 
      bool  is_empty()const  { return balance.quantity == 0; }
   };

   //账户表记录每个用户当前的状态 
   using accounts = eosio::table;

   //一般token都会涉及到转账的动作 这个就是转账的结构体
   //@abi action
   struct transfer {
      /**
      * 从哪个账户转账
      */
      account_name       from;
      /**
      * 到哪个账户
      */
      account_name       to;
      /**
      * 多少数量的该token
      */
      currency_tokens    quantity;
   };

    //这个接口是给第三方调用的 为了查某个用户的账户信息 如果账户不存在 则会构造一个默认的账户返回(我的理解currency token 为0)
   inline account get_account( account_name owner ) {
      account owned_account;
      accounts::get( owned_account, owner );
      return owned_account;
   }
} 

• 整体分析下来没有什么难以理解的,首先要定义一个currency token那么需要引入token结构体,并声明一个currency_token
• 然后转账设计到账户 需要定义账户的表结构 包括账户名和账户余额
• 账户信息需要存储在区块链上所以引入账户table accounts
• 账户之间会有转账 所以声明一个transfer action
• 然后提供一个接口给第三方 查看某个用户的余额,区块链上的数据公开透明的,这里的账户名owner不是真正的名字,其实是一个hash值,如下

typedef unsigned long long   uint64_t;
typedef uint64_t account_name;

abi文件分析

{
  "types": [{
      "new_type_name": "account_name",
      "type": "name"
    }
  ],
  "structs": [{
      "name": "transfer",
      "base": "",
      "fields": {
        "from": "account_name",
        "to": "account_name",
        "quantity": "uint64"
      }
    },{
      "name": "account",
      "base": "",
      "fields": {
        "key": "name",
        "balance": "uint64"
      }
    }
  ],
  "actions": [{
      "action_name": "transfer",
      "type": "transfer"
    }
  ],
  "tables": [{
      "table_name": "account",
      "type": "account",
      "index_type": "i64",
      "key_names" : ["key"],
      "key_types" : ["name"]
    }
  ]
}

• 可以看到abi里有四种结构 types,structs,actions,tables
• 我看到很多合约types都是一样的,所以暂时先这样写,不做分析,等官方文档通知
• structs可以理解成定义的所有结构,包括转账的transfer结构,account的schema结构
• action对应的是合约的所有事件 这里只有转账一种
• tables对应的是我们所涉及到在区块链上数据的存储,这里账户的信息会存在区块链上

cpp文件分析

#include  /// defines transfer struct (abi)

namespace TOKEN_NAME {
   using namespace eosio;

   // 创建账户的时候 如果检查余额为空则删除
   void store_account( account_name account_to_store, const account& a ) {
      //这个就是上面hpp文件里的判断余额是否为空方法
      if( a.is_empty() ) {
         accounts::remove( a, account_to_store );
      } else {
         //不为空就存到区块链上
         accounts::store( a, account_to_store );
      }
   }

   void apply_currency_transfer( const TOKEN_NAME::transfer& transfer_msg ) {
      //做一些通知
      require_notice( transfer_msg.to, transfer_msg.from );
      //做一些权限的检查
      require_auth( transfer_msg.from );
      //解析message
      auto from = get_account( transfer_msg.from );
      auto to   = get_account( transfer_msg.to );
      //下面的-= +=操作符是重载过的 会自动做上溢出 和下溢出的assert检查 
      from.balance -= transfer_msg.quantity; 
      to.balance   += transfer_msg.quantity; 
      // 更新区块链上的值
      store_account( transfer_msg.from, from );
      store_account( transfer_msg.to, to );
   }

}  // namespace TOKEN_NAME

using namespace TOKEN_NAME;
//下面的c代码是整个程序的入口点
extern "C" {
   //init是在合约发布或者更新的时候去调用的,如果账户不存在则发现1亿的token
    void init()  {
       account owned_account;
       if ( !accounts::get( owned_account, N(currency) )) {
          store_account( N(currency), account( currency_tokens(1000ull*1000ull*1000ull) ) );
       }
    }

    //apply方法实现了该合约对不同事件对应处理程序的分发
    void apply( uint64_t code, uint64_t action ) {
       //code 是这个合约
       if( code == N(currency) ) {
          //事件是transfer 转账 则执行转账的逻辑
          if( action == N(transfer) ) 
             TOKEN_NAME::apply_currency_transfer( current_message< TOKEN_NAME::transfer >() );
       }
    }
}

• 可以看到整体上都挺好理解的,只是代码是c++写的,所以你有可能看着不习惯

总结

• 以上就是对currency合约的整体分析,只代表个人的理解,可能有不正确的地方欢迎指出
• 大学的时候刚开始用的就是c,所以搞起c++不是什么难事,但是用c++开发企业级的代码还是需要下点功夫的
• 以太坊上的合约是不可变的也就是你发布后不能去修改合约代码
• EOS可以支持合约的重新部署,但是向前兼容还要,不兼容就是一个大问题了
• 智能合约开发和传统的开发有点区别,平时我们开发有bug可以滚动发布去修复,但是智能合约不是儿戏,每次改动都可以理解成一次分叉,如果不兼容可能会导致硬分叉,所以在设计之初一定要考虑好 做什么? 怎么做?