最新內容會更新在主站深入淺出區塊鏈社群
原文連結:智慧合約語言 Solidity 教程系列2 - 地址型別介紹
智慧合約語言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
目前我們也在招募體驗師,可以點選連結瞭解。
參考文件
深入淺出區塊鏈 - 系統學習區塊鏈,打造最好的區塊鏈技術部落格