Feature/1706 english auction

contracts/FeralfileEnglishAuction.sol

@@ -0,0 +1,315 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.13;
+
+import "@openzeppelin/contracts/utils/Strings.sol";
+import "@openzeppelin/contracts/access/Ownable.sol";
+
+import "./IFeralfileSaleData.sol";
+import "./ECDSASigner.sol";
+import "./IFeralfileVault.sol";
+
+contract IFeralfileExhibitionV4 is IFeralfileSaleData {
+    function buyArtworks(
+        bytes32 r_,
+        bytes32 s_,
+        uint8 v_,
+        SaleData calldata saleData_
+    ) external payable {}
+}
+
+contract FeralfileEnglishAuction is Ownable, IFeralfileSaleData, ECDSASigner {
+    struct Auction {
+        uint256 id;
+        uint256 startAt;
+        uint256 endAt;
+        uint256 extendDuration;
+        uint256 extendThreshold;
+        uint256 minIncreaseFactor;
+        uint256 minIncreaseAmount;
+        uint256 minPrice;
+        bool isSettled;
+    }
+
+    struct Bid {
+        address bidder;
+        uint256 amount;
+        bool fromFeralFile;
+    }
+
+    struct AuctionStatus {
+        Bid highestBid;
+        uint256 endAt;
+        bool isSettled;
+    }
+
+    mapping(uint256 => Auction) public auctions;
+    mapping(uint256 => Bid) public highestBids;
+
+    constructor(address signer_) ECDSASigner(signer_) {}
+
+    function renounceOwnership() public override onlyOwner {}
+
+    function ongoingAuction(uint256 id_) external view returns (bool) {
+        require(
+            auctions[id_].id > 0,
+            "FeralfileEnglishAuction: auction not found"
+        );
+
+        return
+            auctions[id_].startAt <= block.timestamp &&
+            auctions[id_].endAt > block.timestamp;
+    }
+
+    function registerAuctions(Auction[] calldata auctions_) external onlyOwner {
+        for (uint256 i = 0; i < auctions_.length; i++) {
+            Auction memory auction_ = auctions[auctions_[i].id];
+
+            require(
+                auction_.id == 0,
+                "FeralfileEnglishAuction: auction already exist"
+            );
+
+            require(
+                auctions_[i].id > 0,
+                "FeralfileEnglishAuction: invalid auction id"
+            );
+
+            require(
+                auctions_[i].startAt >= block.timestamp &&
+                    auctions_[i].endAt > block.timestamp,
+                "FeralfileEnglishAuction: auction start time and end time should be in the future"
+            );
+
+            require(
+                auctions_[i].endAt > auctions_[i].startAt,
+                "FeralfileEnglishAuction: auction end time should be after start time"
+            );
+
+            require(
+                auctions_[i].minIncreaseFactor > 0,
+                "FeralfileEnglishAuction: auction min increase factor should be greater than 0"
+            );
+
+            require(
+                auctions_[i].minIncreaseAmount > 0,
+                "FeralfileEnglishAuction: auction min increase amount should be greater than 0"
+            );
+
+            require(
+                auctions_[i].minPrice > 0,
+                "FeralfileEnglishAuction: auction min price should be greater than 0"
+            );
+
+            auctions[auctions_[i].id] = auctions_[i];
+        }
+    }
+
+    function listAuctionStatus(
+        uint256[] memory auctionIDs_
+    ) external view returns (AuctionStatus[] memory) {
+        AuctionStatus[] memory results = new AuctionStatus[](auctionIDs_.length);
+        for (uint i = 0; i < auctionIDs_.length; i++) {
+            Auction memory auction_ = auctions[auctionIDs_[i]];
+            results[i].highestBid = highestBids[auctionIDs_[i]];
+            results[i].endAt = auction_.endAt;
+            results[i].isSettled = auction_.isSettled;
+        }
+        return results;
+    }
+
+    function isValidNewBid(
+        uint256 auctionID_,
+        uint256 amount_
+    ) external view returns (bool) {
+        Auction memory auction_ = auctions[auctionID_];
+        Bid memory highestBid_ = highestBids[auctionID_];
+        _validateNewBid(auction_, highestBid_, amount_);
+        return true;
+    }
+
+    function _validateNewBid(
+        Auction memory auction_,
+        Bid memory highestBid_,
+        uint256 amount_
+    ) internal view {
+        // make sure the auction exist
+        require(auction_.id > 0, "FeralfileEnglishAuction: auction not found");
+        // check if auction is on going
+        require(
+            auction_.startAt <= block.timestamp &&
+                block.timestamp < auction_.endAt,
+            "FeralfileEnglishAuction: auction not started or ended"
+        );
+        // check if auction is not settled
+        require(
+            !auction_.isSettled,
+            "FeralfileEnglishAuction: auction already settled"
+        );
+
+        if (highestBid_.amount > 0) {
+            // check bidding amount follow the minimum increment
+            uint256 minIncreaseAmount_ = (highestBid_.amount *
+                auction_.minIncreaseFactor) / 100;
+            if (minIncreaseAmount_ < auction_.minIncreaseAmount) {
+                minIncreaseAmount_ = auction_.minIncreaseAmount;
+            }
+            require(
+                amount_ >= highestBid_.amount + minIncreaseAmount_,
+                "FeralfileEnglishAuction: bid amount should follow the minimum increment"
+            );
+        } else {
+            // check bidding amount follow the minimum price
+            require(
+                amount_ >= auction_.minPrice,
+                "FeralfileEnglishAuction: bid amount should be greater than minimum price"
+            );
+        }
+    }
+
+    function _placeBid(
+        uint256 auctionID_,
+        address bidder_,
+        uint256 amount_,
+        bool fromFeralFile_
+    ) private {
+        Auction memory auction_ = auctions[auctionID_];
+        Bid memory highestBid_ = highestBids[auctionID_];
+        // verify the bid is valid
+        _validateNewBid(auction_, highestBid_, amount_);
+        // replace the new bid to bid map
+        highestBids[auctionID_] = Bid({
+            bidder: bidder_,
+            amount: amount_,
+            fromFeralFile: fromFeralFile_
+        });
+        // if the gap to end time is lower than threshold, update the auction end time to block.timestamp + extend duration
+        if (auction_.endAt - block.timestamp <= auction_.extendThreshold) {
+            auctions[auctionID_].endAt =
+                block.timestamp +
+                auction_.extendDuration;
+        }
+        // transfer last winning bid amount to last bidder if fromFeralFile is false
+        if (!highestBid_.fromFeralFile && highestBid_.amount > 0) {
+            payable(highestBid_.bidder).transfer(highestBid_.amount);
+        }
+        // emit new bid event
+        emit NewBid(auctionID_, bidder_, amount_, fromFeralFile_);
+    }
+
+    function placeBid(uint256 auctionID_) external payable {
+        _placeBid(auctionID_, msg.sender, msg.value, false);
+    }
+
+    function placeSignedBid(
+        uint256 auctionID_,
+        address bidder_,
+        uint256 amount_,
+        uint256 expiryTime_,
+        bytes32 r_,
+        bytes32 s_,
+        uint8 v_
+    ) external {
+        require(
+            expiryTime_ > block.timestamp,
+            "FeralfileEnglishAuction: signature is expired"
+        );
+        bytes32 message_ = keccak256(
+            abi.encode(
+                block.chainid,
+                address(this),
+                auctionID_,
+                bidder_,
+                amount_,
+                expiryTime_
+            )
+        );
+        require(
+            isValidSignature(message_, r_, s_, v_),
+            "FeralfileEnglishAuction: invalid signature"
+        );
+
+        _placeBid(auctionID_, bidder_, amount_, true);
+    }
+
+    function settleAuction(
+        uint256 auctionID_,
+        address tokenAddr_,
+        address vaultAddr_,
+        SaleData memory saleData_,
+        bytes32 r_,
+        bytes32 s_,
+        uint8 v_
+    ) external onlyOwner {
+        require(
+            saleData_.payByVaultContract,
+            "FeralfileEnglishAuction: saleData.payByVaultContract should be true"
+        );
+        Bid memory highestBid_ = highestBids[auctionID_];
+        require(
+            saleData_.destination == highestBid_.bidder,
+            "FeralfileEnglishAuction: saleData_.destination is different from highest bid bidder"
+        );
+        Auction memory auction_ = auctions[auctionID_];
+
+        _settleAuctionFund(auction_, highestBid_, vaultAddr_);
+
+        IFeralfileExhibitionV4(tokenAddr_).buyArtworks(r_, s_, v_, saleData_);
+
+        emit AuctionSettled(
+            auctionID_,
+            tokenAddr_,
+            highestBid_.bidder,
+            highestBid_.amount
+        );
+    }
+
+    function settleAuctionFund(
+        uint256 auctionID_,
+        address vaultAddr_
+    ) external onlyOwner {
+        Auction memory auction_ = auctions[auctionID_];
+        Bid memory highestBid_ = highestBids[auctionID_];
+        _settleAuctionFund(auction_, highestBid_, vaultAddr_);
+    }
+
+    function _settleAuctionFund(
+        Auction memory auction_,
+        Bid memory highestBid_,
+        address vaultAddr_
+    ) private {
+        require(auction_.id != 0, "FeralfileEnglishAuction: auction not found");
+        require(
+            auction_.endAt <= block.timestamp,
+            "FeralfileEnglishAuction: auction not ended"
+        );
+        require(
+            !auction_.isSettled,
+            "FeralfileEnglishAuction: auction already settled"
+        );
+        require(
+            highestBid_.bidder != address(0),
+            "FeralfileEnglishAuction: no bid"
+        );
+
+        auctions[auction_.id].isSettled = true;
+
+        // transfer winning bid amount to Feral File Vault contract if winning bid is crypto bid
+        if (!highestBid_.fromFeralFile && highestBid_.amount > 0) {
+            payable(vaultAddr_).transfer(highestBid_.amount);
+        }
+    }
+
+    event NewBid(
+        uint256 indexed auctionId,
+        address indexed bidder,
+        uint256 indexed amount,
+        bool fromFeralFile
+    );
+
+    event AuctionSettled(
+        uint256 indexed auctionId,
+        address indexed contractAddress,
+        address indexed winner,
+        uint256 amount
+    );
+}

migrations/251_feralfile_english_auction.js

@@ -0,0 +1,11 @@
+var FeralfileEnglishAuction = artifacts.require("FeralfileEnglishAuction");
+
+const argv = require("minimist")(process.argv.slice(2), {
+    string: ["exhibition_signer"],
+});
+
+module.exports = function (deployer) {
+    let exhibition_signer =
+        argv.exhibition_signer || "0xdB33365a8730de2F7574ff1189fB9D337bF4c36d";
+    deployer.deploy(FeralfileEnglishAuction, exhibition_signer);
+};