//SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.17;
contract Purchase{
//商品的价格
uint public value;
//卖家地址,可接收转账
address payable public seller;
//买家地址,可接收转账
address payable public buyer;
/*
定义了一个状态enum,标识订单的四种状态*/
enum State{
Created,Locked,Release,Inactive
}
//定义了一个公共状态变量,类型是一个枚举.
Statepublic state;
//定义了一个标识符号,用于判断满足条件,用于校验输入参数的便捷方法
modifier condition(bool condition_){
require(condition_);
_;
}
//定义了一个错误,只有buyer可以调用的方法,如果其他人调用,则触发这个错误.
error OnlyBuyer();
//定义了一个错误,只有seller可以调用的方法,如果其他人调用,则触发这个错误
error OnlySeller();
//只有特定状态才可以调用当前方法,如果其他状态下调用该方法,则触发这个错误
error InvalidState();
//提供的值必须是一个偶数.否则就触发这个错误.
error ValueNotEven();
/*
在添加了这个 onlyBuyer标记的函数体, 首先执行onlyBuyer() 这里的东西,然后再执行函数体中的代码,提高代码的复用性*/
modifier onlyBuyer(){
if(msg.sender != buyer)
revert OnlyBuyer();
_;
}
/*
定义了一个修饰语 onlySeller,标记了这个修饰符的函数的,先执行当前修饰语中的内容,然后再执行之后的代码*/
modifier onlySeller(){
if(msg.sender!=seller){
revert OnlySeller();
}
_;
}
/*
定义了一个修饰符inState ,所有添加了这个修饰语的函数,都必须执行这里的校验逻辑,再执行之后的代码,将统一的状态校验放在一个代码块中,提高代码的复用性*/
modifier inState(State state_){
if(state != state_){
revert InvalidState();
}
_;
}
event Aborted();
event PurchaseConfirmed();
event ItemReceived();
event SellerRefunded();
constructor() payable {
seller = payable(msg.sender);
value = msg.value /2;
if((2 * value)!= msg.value)
revert ValueNotEven();
}
/*
定义了一个供外部调用的abort方法
只有卖家能调用这个方法
只有当前状态为Created才能调用该方法*/
function abort()external onlySeller inState(State.Created){
emit Aborted();
state = State.Inactive;
seller.transfer(address(this).balance);
}
/*
定义了一个供外部调用的确认购买函数, 调用当前方法,要求当前状态必须为已创建,并且当前传递参数中msg.value必须是状态变量value的两倍.
并且当前函数是可以向指定地址转账.
*/
function confirmPurchase()external inState(State.Created) condition(msg.value == (2*value))payable {
emit PurchaseConfirmed();//发送购买确认的事件
buyer = payable(msg.sender);//将调用方地址转为可接收转账的地址,并且将状态修改为已经锁定
state = State.Locked;
}
/*
定义了一个供外部访问的确认已收到的函数, 该方法只允许买家身份调用,并且状态必须为已锁定*/
function confirmReceived()external onlyBuyer inState(State.Locked) {
emit ItemReceived();
state = State.Release;
buyer.transfer(value);//向买家转账value的金额
}
/*
定义了一个供外部访问的退款给卖家的方法. 并且只有卖家可以调用,并且状态必须为release
*/
function refundSeller()external onlySeller inState(State.Release) {
emit SellerRefunded();//发送卖家退款的事件
state = State.Inactive;//将状态设置为失效状态
seller.transfer(3 * value);//给卖家转三倍value的款
}
}
