【编者按:】Solidity编程语言是一门基于以太坊(Ethereum)的区块链语言。深入浅出Solidity系列文章将介绍该语言的一些特点,希望能给大家带来一些深入的了解。
由于Solidity是基于以太坊(Ethereum)的,故而其语言层面可以直接支持货币支付[1]。
send()
函数
地址对象中的send()
可以向某地址进行支付,下面是一个向合约帐户支付的示例[2]:
pragma solidity ^0.4.0;
//请注意这个仅是Demo,请不要用到正式环境
contract PayTest {
//得到当前合约的余额
function getBalance() returns (uint) {
return this.balance;//0
}
//向当前合约存款
function deposit() payable returns(address addr, uint amount, bool success){
//msg.sender 全局变量,调用合约的发起方
//msg.value 全局变量,调用合约的发起方转发的货币量,以wei为单位。
//send() 执行的结果
return (msg.sender, msg.value, this.send(msg.value));
}
}
示例中提供了两个函数,一个是getBalance()
,用来查看合约帐户当前余额。另一个是deposit()
用来充值到当前合约。
打开浏览器编译器Remix,如下图所示,在区域1
录入上述代码,如果录入的代码没有语法错误,那么我们就能看到区域2
红色的Create
按钮,点击它来创建合约函数调用按钮。
操作成功后,如图二所示,可看到区域1
出现了合约函数对应的getBalance
和deposit
调用按钮。尝试点击getBalance
查看余额,由于当前合约没有钱,将返回0。要进行货币存入需要先点击区域2
的处的小飞机图标,切换到调用合约的发起人,gas,及消息携带的货币量设置界面。我们在区域3
填入3。并点击区域4
的deposit
按钮,这样,我们就成功发送了3个以太币给当前这个合约了。
请注意,上图区域3
仅且只能在所调函数有payable
标识的才可填值,也就是说调用getBalance
时就要清空所填值,否则会报VM Exception: invalid opcode
。
最终结果,可能与下图有所差异,但如果区域2
能看到对应余额变化,就说明操作成功了。
操作成功时,send()
函数返回true
,失败时返回false
。
备注,通过Remix
的测试发现,发送成功,仍然返回false
,原因待查,如果有哪位读者知道,欢迎留言告知。
支付中可能的失败
send()
失败
由于调用者可以强制指定调用堆栈的深度,当调用的栈深超过指定值时,一般是1024;或者接收地址处理支付过程中out of gas
。由于失败,此时的send()
的结果是false
。
合约的fallback()
如果是合约地址,在执行send()
时,会默认关联执行fallback()
(如果存在这个函数)。这是EVM的默认行为,不可被阻止。所以这个函数引起out of gas
或其它失败,整个交易被撤销。由于失败,此时的send()
的结果是false
。
payable标识[3]
细心的读者可能发现在deposit
函数上有一个payable
关键字,如果一个函数需要进行货币操作,必须要带上payable
关键字,这样才能正常接收msg.value
。
关于作者
专注基于以太坊(Ethereum)的相关区块链(Blockchain)技术,了解以太坊,Solidity,Truffle等。个人博客:http://me.tryblockchain.org
-
原文参考:http://solidity.readthedocs.io/en/develop/types.html#address ↩
-
示例代码勿在正式环境中使用,需使用时勿必参考最佳实践:http://solidity.readthedocs.io/en/develop/common-patterns.html ↩
-
更多关于payable标识的信息请查看:http://solidity.readthedocs.io/en/develop/control-structures.html?highlight=payable#expressions-and-control-structures ↩