1. 程式人生 > >智能合約語言 Solidity 教程系列2 - 地址類型介紹

智能合約語言 Solidity 教程系列2 - 地址類型介紹

區塊鏈 智能合約

Solidity教程系列第二篇 - Solidity地址類型介紹.
Solidity 系列完整的文章列表請查看分類-Solidity。

寫在前面

Solidity是以太坊智能合約編程語言,閱讀本文前,你應該對以太坊、智能合約有所了解,如果你還不了解,建議你先看以太坊是什麽

本文前半部分是參考Solidity官方文檔(當前最新版本:0.4.20)進行翻譯,後半部分是結合實際合約代碼實例說明類型的使用。

地址類型(Address)

地址類型address是一個值類型,

地址: 20字節(一個以太坊地址的長度),地址類型也有成員,地址是所有合約的基礎
支持的運算符:

  • <=, <, ==, !=, >= 和 >

    註意:從0.5.0開始,合約不再繼承自地址類型,但仍然可以顯式轉換為地址。

地址類型的成員

  • balance 屬性及transfer() 函數
    這裏是地址類型相關成員的快速索引
    balance用來查詢賬戶余額,transfer()用來發送以太幣(以wei為單位)。
    如:

    address x = 0x123;
    address myAddress = this;
    if (x.balance < 10 && myAddress.balance >= 10) x.transfer(10);

    註解:如果x是合約地址,合約的回退函數(fallback 函數)會隨transfer調用一起執行(這個是EVM特性),如果因gas耗光或其他原因失敗,轉移交易會還原並且合約會拋異常停止。

    關於回退函數(fallback 函數),簡單來說它是合約中無函數名函數,下面代碼事例中,進進一步講解回退函數(fallback) 的使用。

  • send() 函數
    send 與transfer對應,但更底層。如果執行失敗,transfer不會因異常停止,而send會返回false。

    警告:send() 執行有一些風險:如果調用棧的深度超過1024或gas耗光,交易都會失敗。因此,為了保證安全,必須檢查send的返回值,如果交易失敗,會回退以太幣。如果用transfer會更好。

  • call(), callcode() 和 delegatecall() 函數
    為了和非ABI協議的合約進行交互,可以使用call() 函數, 它用來向另一個合約發送原始數據,支持任何類型任意數量的參數,每個參數會按規則(ABI協議)打包成32字節並一一拼接到一起。一個例外是:如果第一個參數恰好4個字節,在這種情況下,會被認為根據ABI協議定義的函數器指定的函數簽名而直接使用。如果僅想發送消息體,需要避免第一個參數是4個字節。如下面的例子:

    address nameReg = 0x72ba7d8e73fe8eb666ea66babc8116a41bfb10e2;
    nameReg.call("register", "MyName");
    nameReg.call(bytes4(keccak256("fun(uint256)")), a);

    call函數返回一個bool值,以表明執行成功與否。正常結束返回true,異常終止返回false。但無法獲取到結果數據,因為需要提前知道返回的數據的編碼和數據大小(因不知道對方使用的協議格式,所以也不會知道返回的結果如何解析)。
    還可以提供.gas()修飾器進行調用:

    namReg.call.gas(1000000)("register", "MyName");

    類似還可以提供附帶以太幣:

    nameReg.call.value(1 ether)("register", "MyName");

    修飾器可以混合使用,修飾器調用順序無所謂。

    nameReg.call.gas(1000000).value(1 ether)("register", "MyName");

    註解:目前還不能在重載函數上使用gas或value修飾符,A workaround is to introduce a special case for gas and value and just re-check whether they are present at the point of overload resolution.(這句我怕翻譯的不準確,引用原文)

    同樣我們也可以使用delegatecall(),它與call方法的區別在於,僅僅是代碼會執行,而其它方面,如(存儲,余額等)都是用的當前的合約的數據。delegatecall()方法的目的是用來執行另一個合約中的庫代碼。所以開發者需要保證兩個合約中的存儲變量能兼容,來保證delegatecall()能順利執行。在homestead階段之前,僅有一個受限的callcode()方法可用,但callcode未提供對msg.sender,msg.value的訪問權限。

    上面的這三個方法call(),delegatecall(),callcode()都是底層的消息傳遞調用,最好僅在萬不得已才進行使用,因為他們破壞了Solidity的類型安全。
    .gas() 在call(), callcode() 和 delegatecall() 函數下都可以使用, delegatecall()不支持.value()

    註解:所有合約都繼承了address的成員,因此可以使用this.balance查詢余額。
    callcode不鼓勵使用,以後會移除。

    警告:上述的函數都是底層的函數,使用時要異常小心。當調用一個未知的,可能是惡意的合約時,當你把控制權交給它,它可能回調回你的合約,所以要準備好在調用返回時,應對你的狀態變量可能被惡意篡改的情況。

地址常量(Address Literals)

一個能通過地址合法性檢查(address checksum test)十六進制常量就會被認為是地址,如0xdCad3a6d3569DF655070DEd06cb7A1b2Ccd1D3AF。而不能通過地址合法性檢查的39到41位長的十六進制常量,會提示一個警告,被視為普通的有理數常量。

地址合法性檢查定義在EIP-55

合約事例講解

合約事例代碼

pragma solidity ^0.4.0;

contract AddrTest{
    event logdata(bytes data);
    function() payable {
        logdata(msg.data);
    }

    function getBalance() returns (uint) {
        return this.balance;
    }

    uint score = 0;
    function setScore(uint s) public {
        score = s;
    }

    function getScore() returns ( uint){
        return score;
    }
}

contract CallTest{
    function deposit() payable {
    }

    event logSendEvent(address to, uint value);
    function transferEther(address towho) payable {
        towho.transfer(10);
        logSendEvent(towho, 10);
    }

    function callNoFunc(address addr) returns (bool){
        return addr.call("tinyxiong", 1234);
    }

    function callfunc(address addr) returns (bool){
        bytes4 methodId = bytes4(keccak256("setScore(uint256)"));
        return addr.call(methodId, 100);
    }  

    function getBalance() returns (uint) {
        return this.balance;
    }  
}

參考文檔

Solidity官方文檔-類型

深入淺出區塊鏈 - 系統學習區塊鏈,打造最好的區塊鏈技術博客。

智能合約語言 Solidity 教程系列2 - 地址類型介紹