Merge pull request #504 from ArtBlocks/Serial-English-Auction-Minter

Serial English Auction (nouns-style) minter

contracts/interfaces/0.8.x/IFilteredMinterSEAV0.sol

@@ -0,0 +1,145 @@
+// SPDX-License-Identifier: GPL-3.0
+// Created By: Art Blocks Inc.
+
+import "./IFilteredMinterV2.sol";
+
+pragma solidity ^0.8.0;
+
+/**
+ * @title Interface for MinterSEA, inspired by nouns.wtf.
+ * This interface combines the set of interfaces that add support for
+ * a Serial English Auction Minter.
+ * @author Art Blocks Inc.
+ */
+interface IFilteredMinterSEAV0 is IFilteredMinterV2 {
+    /// Struct that defines a single token English auction
+    struct Auction {
+        // token number of NFT being auctioned
+        uint256 tokenId;
+        // The current highest bid amount (in wei)
+        uint256 currentBid;
+        // The address of the current highest bidder
+        address payable currentBidder;
+        // The time that the auction is scheduled to end
+        // max uint64 ~= 1.8e19 sec ~= 570 billion years
+        uint64 endTime;
+        // Whether or not the auction has been settled
+        bool settled;
+        // Whether or not the auction has been initialized (used to determine
+        // if auction is the default struct)
+        bool initialized;
+    }
+
+    /// Admin-controlled range of allowed auction durations updated
+    event AuctionDurationSecondsRangeUpdated(
+        uint32 minAuctionDurationSeconds,
+        uint32 maxAuctionDurationSeconds
+    );
+
+    /// Admin-controlled minimum bid increment percentage updated
+    event MinterMinBidIncrementPercentageUpdated(
+        uint8 minterMinBidIncrementPercentage
+    );
+
+    /// Admin-controlled time buffer updated
+    event MinterTimeBufferUpdated(uint32 minterTimeBufferSeconds);
+
+    // Admin-controlled refund gas limit updated
+    event MinterRefundGasLimitUpdated(uint16 refundGasLimit);
+
+    /// Artist configured future auction details
+    event ConfiguredFutureAuctions(
+        uint256 indexed projectId,
+        uint64 timestampStart,
+        uint32 auctionDurationSeconds,
+        uint256 basePrice
+    );
+
+    /// Future auction details for project `projectId` reset
+    event ResetAuctionDetails(uint256 indexed projectId);
+
+    /// New token auction created, token created and sent to minter
+    event AuctionInitialized(
+        uint256 indexed tokenId,
+        address indexed bidder,
+        uint256 bidAmount,
+        uint64 endTime
+    );
+
+    /// Successful bid placed on token auction
+    event AuctionBid(
+        uint256 indexed tokenId,
+        address indexed bidder,
+        uint256 bidAmount
+    );
+
+    /// Token auction was settled (token distributed to winner)
+    event AuctionSettled(
+        uint256 indexed tokenId,
+        address indexed winner,
+        uint256 price
+    );
+
+    // Next token ID for project `projectId` updated
+    event ProjectNextTokenUpdated(uint256 indexed projectId, uint256 tokenId);
+
+    // Next token ID for project `projectId` was ejected from the minter
+    // and is no longer populated
+    event ProjectNextTokenEjected(uint256 indexed projectId);
+
+    function configureFutureAuctions(
+        uint256 _projectId,
+        uint256 _timestampStart,
+        uint256 _auctionDurationSeconds,
+        uint256 _basePrice
+    ) external;
+
+    function resetAuctionDetails(uint256 _projectId) external;
+
+    // artist-only function that populates the next token ID to be auctioned
+    // for project `projectId`
+    function tryPopulateNextToken(uint256 _projectId) external;
+
+    function settleAuctionAndCreateBid(
+        uint256 _settleTokenId,
+        uint256 _bidTokenId
+    ) external payable;
+
+    function settleAuction(uint256 _tokenId) external;
+
+    function createBid(uint256 _tokenId) external payable;
+
+    function createBid_l34(uint256 _tokenId) external payable;
+
+    function minterConfigurationDetails()
+        external
+        view
+        returns (
+            uint32 minAuctionDurationSeconds_,
+            uint32 maxAuctionDurationSeconds_,
+            uint8 minterMinBidIncrementPercentage_,
+            uint32 minterTimeBufferSeconds_,
+            uint16 minterRefundGasLimit_
+        );
+
+    function projectConfigurationDetails(
+        uint256 _projectId
+    )
+        external
+        view
+        returns (
+            uint24 maxInvocations,
+            uint64 timestampStart,
+            uint32 auctionDurationSeconds,
+            uint256 basePrice,
+            bool nextTokenNumberIsPopulated,
+            uint24 nextTokenNumber,
+            Auction memory auction
+        );
+
+    function projectActiveAuctionDetails(
+        uint256 _projectId
+    ) external view returns (Auction memory);
+
+    function getTokenToBid(uint256 _projectId) external view returns (uint256);
+}

contracts/interfaces/0.8.x/IWETH.sol

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: GPL-3.0
+
+pragma solidity ^0.8.0;
+
+interface IWETH {
+    function deposit() external payable;
+
+    function withdraw(uint256 wad) external;
+
+    function transfer(address to, uint256 value) external returns (bool);
+}