【Solidity】支付
以太比的单位
wei、gwei、finney 和 ether 是以太币（Ether）的不同单位。
- wei 是以太币的最小单位，1 ether = 10^18 wei；这是 Solidity 中的默认单位
uint public oneWei = 1 wei;
- gwei 是 wei 的 10^9 倍，1 ether = 10^9 gwei；常用于表示交易费用 (gas price)
uint public oneGwei = 1 gwei;
- finney 是 wei 的 10^15 倍，1 ether = 10^3 finney
uint public oneFinney = 1 finney;
- ether 是 wei 的 10^18 倍；是以太坊的基本单位
uint public oneEther = 1 ether;
payable 修饰符
以下函数需要使用 payable 修饰：① 需要接收以太币的函数；② 需要使用 msg.value / callvalue() 且可被外部访问的函数。
contract Demo {// 使用 payable 修饰构造函数，使合约可以在部署时接收以太币constructor() payable {}// 接收以太币的函数, 必须使用 payable 修饰符function receiveEther() external payable {require(msg.value > 0, "Must send some Ether");}// 提现函数, 将合约中的以太币发送给调用者function withdraw() external {uint amount = address(this).balance;require(amount > 0, "No Ether to withdraw");payable(msg.sender).transfer(amount);}// 获取合约的以太币余额function getBalance() external view returns (uint) {return address(this).balance;}
}
-
设置以太币的数量，部署 Demo 合约
-
调用 getBalance 函数，查看合约的以太币余额
-
设置以太币的数量，调用 receiveEther 函数
-
调用 getBalance 函数，查看合约的以太币余额
-
调用 withdraw 函数，将合约中的以太币发送给调用者
-
再次调用 getBalance 函数，查看合约的以太币余额
receive & fallback 方法
在 Solidity 中，receive & fallback 是一种特殊的函数。它不需要 function 关键字、没有参数、也没有返回值。
特性：
- receive & fallback 函数必须声明为
external，表示只能通过外部调用来触发。 - receive 必须使用
payable修饰符；fallback 可以使用payable修饰符。
receive & fallback 的区别：
- receive：专门用于处理没有附加数据的以太币转账。
- fallback：用于处理所有其他情况，包括调用不存在的函数或接收带有附加数据的以太币转账。如果合约没有定义
receive方法，但定义了payable的 fallback 方法，那么在接收以太币时会调用 fallback 方法。
contract Demo {event Log(string message, address sender, uint value, bytes data);// 定义 receive 方法receive() external payable {emit Log("receive", msg.sender, msg.value, "");}// 定义 fallback 方法fallback() external payable {emit Log("fallback", msg.sender, msg.value, msg.data);}
}
以太币的发送与接收
接收以太币的 3 种形式：
-
编写 payable receive / fallback 方法，以支持直接传入以太币
-
用 payable 修饰 constructor 方法，以支持在部署时传入以太币
-
用 payable 修饰其他方法，以支持在调用方法时传入以太币
contract ReceiveEther {event Received(address, uint, uint);// 接收部署时传入的以太币constructor() payable {}// 接收直接传入的以太币receive() external payable {// 打印发送者、接收的以太币数量、剩余的 gasemit Received(msg.sender, msg.value, gasleft());}// 接收调用方法时传入的以太币function receiveEther() external payable {// 打印发送者、接收的以太币数量、剩余的 gasemit Received(msg.sender, msg.value, gasleft());}
}
-
设置以太币的数量，部署 ReceiveEther 合约；查看事件，可以看到接收的以太币数量
-
设置以太币的数量，调用 receiveEther 函数；查看事件，可以看到接收的以太币数量
用 payable 修饰的 address 变量有 3 个方法发送以太币：
-
transfer：有 2300 gas 的限制；如果转账失败，会回滚交易
-
send：有 2300 gas 的限制；如果转账失败，不会回滚交易，而是返回
false -
call：没有 gas 限制，可以指定 gas 量；如果转账失败，不会回滚交易，而是返回
false
contract SendEther {// 使用 transfer 发送以太币function sendEtherViaTransfer(address payable recipient) external payable {recipient.transfer(msg.value);}// 使用 send 发送以太币function sendEtherViaSend(address payable recipient) external payable {bool success = recipient.send(msg.value);require(success, "Send failed");}// 使用 call 发送以太币 (推荐)function sendEtherViaCall(address payable recipient) external payable {(bool success, ) = recipient.call{value: msg.value}("");require(success, "Call failed");}
}
-
部署 SendEther 合约
-
设置以太币的数量，调用 SendEther 合约的 sendEtherViaTransfer 函数，传入 ReceiveEther 合约的地址；可以看到 ReceiveEther 合约的以太币余额变化
-
设置以太币的数量，调用 SendEther 合约的 sendEtherViaSend 函数，传入 ReceiveEther 合约的地址；可以看到 ReceiveEther 合约的以太币余额变化
-
设置以太币的数量，调用 SendEther 合约的 sendEtherViaCall 函数，传入 ReceiveEther 合约的地址；可以看到 ReceiveEther 合约的以太币余额变化