區塊鏈上編程:DApp 開發實戰——來寫個競猜遊戲吧!

本文旨在引導對 DApp 開發感興趣的開發者,構建一個基於以太坊去中心化應用,經過開發一款功能完備的競猜遊戲,邁出 DApp 開發的第一步,經過實例講解 Solidity 語言的經常使用語法,以及前端如何與智能合約進行交互。javascript

若是正在閱讀的你,從未接觸過 DApp 開發也沒關係,能夠先閱讀【區塊鏈上編程:DApp開發簡介】進行前置知識補充。前端


隨着加密貓、FOMO3D 等遊戲的火爆,去中心化應用在遊戲領域遍地開花,下面就帶着你們一塊兒開發一款簡單有趣的 DApp 遊戲,幫助你們熟悉 DApp 開發。本 DApp 實現的合約功能:用戶從 0-6 的數字中,任意組合三位數進行投注,合約計算出 3 位隨機數,根據隨機數的組合規則分別給予用戶不一樣倍數的獎勵,如隨機數爲 AAA ,A 等於 6 則獎勵至少 20 倍投注金額,即獎池全部餘額;A 不等於 6 則獎勵 5 倍投注金額;隨機數爲 AAB,則獎勵 2 倍投注金額;隨機數爲 ABC 則不獎勵,同時用戶可查看獎池餘額和我的投注記錄。java

合約編寫

能夠看出合約須要實現用戶投注、生成隨機數、發放獎勵、獎池餘額查詢的功能,接下來編寫咱們的合約代碼。git

新建Lottery.sol合約文件,聲明合約版本,^表示合約編譯版本爲 0.4.0 至 0.5.0(不含 0.5.0)。程序員

pragma solidity ^0.4.0;
複製代碼

定義合約基本內容,同時聲明最低投注金額。github

contract Lottery {
  uint public betMoney = 10 finney;
}
複製代碼

生成隨機數,經過區塊難度block.difficulty和內置函數keccak256生成隨機數,在EVM中經常使用的數據存儲位置:memorystorage,函數的參數、返回值默認存儲在memory中,狀態變量默認存儲在storage中,咱們能夠經過聲明memorystorage改變默認存儲位置,二者的存儲都須要消耗gas,但storage的開銷遠大於memoryweb

contract Lottery {
  ...
  function generateRandomNumber() private view returns(uint[]) {
    uint[] memory dices = new uint[](3);
    for (uint i = 0; i < 3; i++) {
      dices[i] = uint(keccak256(abi.encodePacked(block.difficulty, now, i))) % 6 + 1;
    }
    return dices;
  }
  ...
}
複製代碼

獲取合約餘額,address類型比較重要的成員屬性主要有balancetransfer,分別爲獲取地址餘額、轉移eth至該地址,默認eth單位是wei編程

contract Lottery {
  ...
  function getBankBalance() public view returns(uint) {
    return address(this).balance;
  }
  ...
}
複製代碼

用戶投注,投注方法須要使用payable關鍵字描述,用來表示能夠接收eth;經過msg.sendermsg.value得到交易發送者地址和當前交易附帶的eth。一般使用require來校驗外部輸入參數,當斷定條件爲false時,則會將剩餘的gas退回,同時回滾交易;assert則用來處理合約內部的邏輯錯誤,當錯誤發生時會消耗掉全部gas,同時回滾交易。瀏覽器

contract Lottery {
  ...
  function bet() public payable {
    uint amount = msg.value;
    require(amount >= betMoney, 'bet money not less than 10 finney');
    require(address(this).balance >= amount * 20, 'contract money not enough to pay reward');

    uint[] memory dices = generateRandomNumber();
    require(dices.length == 3, 'dices illegal');

    address addr = msg.sender;
    bool isReward = false;
    uint reward = 0;

    if ((dices[0] == dices[1]) && (dices[1] == dices[2]) && (dices[0] == 6)) {
      isReward = true;
      reward = address(this).balance;
    } else if ((dices[0] == dices[1]) && (dices[1] == dices[2]) && (dices[0] != 6)) {
      isReward = true;
      reward = amount * 5;
    } else if ((dices[0] == dices[1]) || (dices[0] == dices[2]) || (dices[1] == dices[2])) {
      isReward = true;
      reward = amount * 2;
    }

    if (isReward) {
      addr.transfer(reward);
    }
  }
  ...
複製代碼

定義事件,經過合約內部觸發事件,web3 監聽到事件回調進行相應邏輯處理,從而進行頁面 UI 更新;同時前端也能夠經過對應事件名稱獲取日誌信息。安全

contract Lottery {
  ...
  event BetList(
    address addr,
    uint amount,
    bool isReward,
    uint reward,
    uint[] dices
  );

  function bet() public payable {
    ...
    emit BetList(addr, amount, isReward, reward, dices);
  }
  ...
複製代碼

與合約進行交互

至此,咱們已經寫完了合約代碼,前端頁面實現就不在此贅述,主要介紹如何使用 web3 與合約交互,這裏使用到的 web3 版本是 1.0,web3 1.0 和 0.2x.x 的 API 調用方式差異較大,1.0 的 API 支持異步調用。

安裝 Metamask 瀏覽器插件後,會在瀏覽器頁面內注入一個 web3 實例。檢測頁面中是否存在 web3 實例,若是不存在則鏈接本身的實例。

import Web3 from 'web3';

if (typeof web3 !== 'undefined') {
  web3 = new Web3(web3.currentProvider);
} else {
  web3 = new Web3(new Web3.providers.HttpProvider(NODE_NRL));
}
複製代碼

傳入合約 ABI,合約地址,實例化合約對象。

this.contract = new web3.eth.Contract(
  CONTRACT_ABI,
  CONTRACT_ADDR,
);
複製代碼

調用合約中的投注方法,經過try catch能夠捕獲到 Metamask 彈窗取消交易操做。

userBet = async () => {
  try {
    await this.contract.methods
      .bet(
        ...
      )
      .send({
        from: ACCOUNT,
        value: MONEY,
      });
  } catch (error) {
    ...
  }
}
複製代碼

查詢記錄的日誌,能夠經過指定事件名稱、區塊高度及過濾條件來進行日誌查詢,值得注意的是,在合約內不能查詢到日誌信息。

queryEvent = async () => {
  const event = await this.contract.getPastEvents(
    EVENT_NAME,
    {
      filter: {},
      fromBlock: 0,
      toBlock: 'latest',
    }
  )
}
複製代碼

功能拓展

好比修改用戶投注金額及充值這類敏感操做,就須要管理員的權限來進行操做。一樣地,咱們也能夠拓展贊助商的功能,經過充值獎池的累計金額排名來展現贊助商的廣告,這裏就不作展開了。

定義修飾器,在構造函數裏設置管理員地址,將建立合約的帳戶設置爲管理員。

contract Lottery {
  ...
  address public owner;

  modifier onlyOwner() {
    require(owner == msg.sender);
    _;
  }

  constructor() public {
    owner = msg.sender;
  }
  ...
}
複製代碼

實現修改投注金額的功能,僅管理員帳戶可觸發。

contract Lottery {
  ...
  function setBetMoney(uint _betMoney) public onlyOwner {
    betMoney = _betMoney;
  }

  function deposit() public payable onlyOwner {}
  ...
}
複製代碼

總結

當前隨機數的實現經過鏈上信息生成,這種生成隨機數的方式容易受到不誠實的節點攻擊。下一篇文章將經過多個實例介紹相應的第三方工具庫的使用(Oricalize、SafeMath、OpenZepplin),生成安全的隨機數。

參考資料


前置文章:

區塊鏈上編程:DApp開發簡介

(掘金社區連接點此)


文 / ielapp

一個簡單的程序員

編 / 熒聲

本文已由做者受權發佈,版權屬於創宇前端。歡迎註明出處轉載本文。本文連接:knownsec-fed.com/2018-10-07-…

想要訂閱更多來自知道創宇開發一線的分享,請搜索關注咱們的微信公衆號:創宇前端(KnownsecFED)。歡迎留言討論,咱們會盡量回復。

感謝您的閱讀。

相關文章
相關標籤/搜索