@artblocks/contracts 1.0.3 → 1.0.4

package/contracts/engine/V3/GenArt721CoreV3_Engine_Flex.sol

@@ -3,18 +3,18 @@ pragma solidity 0.8.19;
 
 // Created By: Art Blocks Inc.
 
-import "../../interfaces/0.8.x/IRandomizer_V3CoreBase.sol";
-import "../../interfaces/0.8.x/IAdminACLV0.sol";
-import "../../interfaces/0.8.x/IEngineRegistryV0.sol";
-import "../../interfaces/0.8.x/IGenArt721CoreContractV3_Engine_Flex.sol";
-import "../../interfaces/0.8.x/IGenArt721CoreContractExposesHashSeed.sol";
-import "../../interfaces/0.8.x/IDependencyRegistryCompatibleV0.sol";
-import "../../interfaces/0.8.x/IManifold.sol";
+import "../../interfaces/v0.8.x/IRandomizer_V3CoreBase.sol";
+import "../../interfaces/v0.8.x/IAdminACLV0.sol";
+import "../../interfaces/v0.8.x/IEngineRegistryV0.sol";
+import "../../interfaces/v0.8.x/IGenArt721CoreContractV3_Engine_Flex.sol";
+import "../../interfaces/v0.8.x/IGenArt721CoreContractExposesHashSeed.sol";
+import "../../interfaces/v0.8.x/IDependencyRegistryCompatibleV0.sol";
+import "../../interfaces/v0.8.x/IManifold.sol";
 
 import "@openzeppelin-4.7/contracts/access/Ownable.sol";
-import "../../libs/0.8.x/ERC721_PackedHashSeed.sol";
-import "../../libs/0.8.x/BytecodeStorageV1.sol";
-import "../../libs/0.8.x/Bytes32Strings.sol";
+import "../../libs/v0.8.x/ERC721_PackedHashSeed.sol";
+import "../../libs/v0.8.x/BytecodeStorageV1.sol";
+import "../../libs/v0.8.x/Bytes32Strings.sol";
 
 /**
  * @title Art Blocks Engine Flex ERC-721 core contract, V3.
@@ -184,7 +184,7 @@ contract GenArt721CoreV3_Engine_Flex is
         bool paused;
         string name;
         string artist;
-        string description;
+        address descriptionAddress;
         string website;
         string license;
         string projectBaseURI;
@@ -271,7 +271,7 @@ contract GenArt721CoreV3_Engine_Flex is
     bool public immutable autoApproveArtistSplitProposals;
 
     /// version & type of this core contract
-    bytes32 constant CORE_VERSION = "v3.1.2";
+    bytes32 constant CORE_VERSION = "v3.1.3";
 
     function coreVersion() external pure returns (string memory) {
         return CORE_VERSION.toString();
@@ -1195,6 +1195,13 @@ contract GenArt721CoreV3_Engine_Flex is
     /**
      * @notice Updates description of project `_projectId`.
      * Only artist may call when unlocked, only admin may call when locked.
+     * Note: The BytecodeStorage library is used to store the description to
+     * reduce initial upload cost, however, even minor edits will require an
+     * expensive, entirely new bytecode storage contract to be deployed instead
+     * of relatively cheap updates to already-warm storage slots. This results
+     * in an increased gas cost for minor edits to the description after the
+     * initial upload, but an overall decrease in gas cost for projects with
+     * less than ~3-5 edits (depending on the length of the description).
      * @param _projectId Project ID.
      * @param _projectDescription New project description.
      */
@@ -1214,7 +1221,10 @@ contract GenArt721CoreV3_Engine_Flex is
             "Only artist when unlocked, owner when locked"
         );
         // effects
-        projects[_projectId].description = _projectDescription;
+        // store description in contract bytecode, replacing reference address from
+        // the old storage description with the newly created one
+        projects[_projectId].descriptionAddress = _projectDescription
+            .writeToBytecode();
         emit ProjectUpdated(_projectId, FIELD_PROJECT_DESCRIPTION);
     }
 
@@ -1622,7 +1632,12 @@ contract GenArt721CoreV3_Engine_Flex is
         Project storage project = projects[_projectId];
         projectName = project.name;
         artist = project.artist;
-        description = project.description;
+        address projectDescriptionBytecodeAddress = project.descriptionAddress;
+        if (projectDescriptionBytecodeAddress == address(0)) {
+            description = "";
+        } else {
+            description = _readFromBytecode(projectDescriptionBytecodeAddress);
+        }
         website = project.website;
         license = project.license;
     }

package/contracts/engine/V3/forks/GenArt721CoreV3_Engine_Flex_PROOF.sol

@@ -3,17 +3,17 @@ pragma solidity 0.8.19;
 
 // Created By: Art Blocks Inc.
 
-import "../../../interfaces/0.8.x/IRandomizerV2.sol";
-import "../../../interfaces/0.8.x/IAdminACLV0.sol";
-import "../../../interfaces/0.8.x/IEngineRegistryV0.sol";
-import "../../../interfaces/0.8.x/IGenArt721CoreContractV3_Engine_Flex.sol";
-import "../../../interfaces/0.8.x/IDependencyRegistryCompatibleV0.sol";
-import "../../../interfaces/0.8.x/IManifold.sol";
+import "../../../interfaces/v0.8.x/IRandomizerV2.sol";
+import "../../../interfaces/v0.8.x/IAdminACLV0.sol";
+import "../../../interfaces/v0.8.x/IEngineRegistryV0.sol";
+import "../../../interfaces/v0.8.x/IGenArt721CoreContractV3_Engine_Flex.sol";
+import "../../../interfaces/v0.8.x/IDependencyRegistryCompatibleV0.sol";
+import "../../../interfaces/v0.8.x/IManifold.sol";
 
 import "@openzeppelin-4.7/contracts/access/Ownable.sol";
-import "../../../libs/0.8.x/ERC721_PackedHashSeed.sol";
-import "../../../libs/0.8.x/BytecodeStorageV1.sol";
-import "../../../libs/0.8.x/Bytes32Strings.sol";
+import "../../../libs/v0.8.x/ERC721_PackedHashSeed.sol";
+import "../../../libs/v0.8.x/BytecodeStorageV1.sol";
+import "../../../libs/v0.8.x/Bytes32Strings.sol";
 
 /**
  * @title Art Blocks Engine Flex ERC-721 core contract, V3.

package/contracts/engine/V3/forks/PROHIBITION/AdminACLV0_PROHIBITION.sol

@@ -3,7 +3,7 @@
 pragma solidity 0.8.19;
 
 import "./interfaces/IAdminACLV0_PROHIBITION.sol";
-import "../../../../interfaces/0.8.x/IGenArt721CoreContractV3_Base.sol";
+import "../../../../interfaces/v0.8.x/IGenArt721CoreContractV3_Base.sol";
 
 import "@openzeppelin-4.7/contracts/access/Ownable.sol";
 import "@openzeppelin-4.7/contracts/utils/introspection/ERC165.sol";

package/contracts/engine/V3/forks/PROHIBITION/GenArt721CoreV3_Engine_Flex_PROHIBITION.sol

@@ -6,15 +6,15 @@ pragma solidity 0.8.19;
 import "./interfaces/IAdminACLV0_PROHIBITION.sol";
 import "./interfaces/IGenArt721CoreContractV3_Engine_Flex_PROHIBITION.sol";
 
-import "../../../../interfaces/0.8.x/IRandomizerV2.sol";
-import "../../../../interfaces/0.8.x/IEngineRegistryV0.sol";
-import "../../../../interfaces/0.8.x/IDependencyRegistryCompatibleV0.sol";
-import "../../../../interfaces/0.8.x/IManifold.sol";
+import "../../../../interfaces/v0.8.x/IRandomizerV2.sol";
+import "../../../../interfaces/v0.8.x/IEngineRegistryV0.sol";
+import "../../../../interfaces/v0.8.x/IDependencyRegistryCompatibleV0.sol";
+import "../../../../interfaces/v0.8.x/IManifold.sol";
 
 import "@openzeppelin-4.7/contracts/access/Ownable.sol";
-import "../../../../libs/0.8.x/ERC721_PackedHashSeed.sol";
-import "../../../../libs/0.8.x/BytecodeStorageV1.sol";
-import "../../../../libs/0.8.x/Bytes32Strings.sol";
+import "../../../../libs/v0.8.x/ERC721_PackedHashSeed.sol";
+import "../../../../libs/v0.8.x/BytecodeStorageV1.sol";
+import "../../../../libs/v0.8.x/Bytes32Strings.sol";
 
 /**
  * @title Art Blocks Engine Flex ERC-721 core contract, V3.
@@ -919,7 +919,10 @@ contract GenArt721CoreV3_Engine_Flex_PROHIBITION is
         uint256 _additionalPayeeSecondarySalesPercentage
     ) external {
         _onlyValidProjectId(_projectId);
-        _onlyArtist(_projectId);
+        _onlyArtistOrAdminACL(
+            _projectId,
+            this.proposeArtistPaymentAddressesAndSplits.selector
+        );
         _onlyNonZeroAddress(_artistAddress);
         ProjectFinance storage projectFinance = projectIdToFinancials[
             _projectId
@@ -1124,6 +1127,14 @@ contract GenArt721CoreV3_Engine_Flex_PROHIBITION is
         _onlyNonEmptyString(_projectName);
         _onlyNonZeroAddress(_artistAddress);
         require(!newProjectsForbidden, "New projects forbidden");
+        require(
+            IAdminACLV0_PROHIBITION(address(adminACLContract)).allowed(
+                msg.sender,
+                address(this),
+                this.addProject.selector
+            ),
+            "Only Admin ACL allowed"
+        );
         uint256 projectId = _nextProjectId;
         projectIdToFinancials[projectId].artistAddress = _artistAddress;
         projects[projectId].name = _projectName;
@@ -2117,13 +2128,7 @@ contract GenArt721CoreV3_Engine_Flex_PROHIBITION is
         bytes4 _selector
     ) public returns (bool) {
         return
-            owner() != address(0) &&
-            IAdminACLV0_PROHIBITION(address(adminACLContract)).allowed(
-                _sender,
-                _contract,
-                _selector,
-                type(uint256).max
-            );
+            adminACLAllowed(_sender, _contract, _selector, type(uint256).max);
     }
 
     /**

package/contracts/engine/V3/forks/PROHIBITION/interfaces/IAdminACLV0_PROHIBITION.sol

@@ -3,7 +3,7 @@
 
 pragma solidity ^0.8.0;
 
-import "../../../../../interfaces/0.8.x/IAdminACLV0.sol";
+import "../../../../../interfaces/v0.8.x/IAdminACLV0.sol";
 
 interface IAdminACLV0_PROHIBITION is IAdminACLV0 {
     /**

package/contracts/engine/V3/forks/PROHIBITION/interfaces/IGenArt721CoreContractV3_Engine_Flex_PROHIBITION.sol

@@ -4,7 +4,7 @@
 pragma solidity ^0.8.0;
 
 import "./IAdminACLV0_PROHIBITION.sol";
-import "../../../../../interfaces/0.8.x/IGenArt721CoreContractV3_Engine_Flex.sol";
+import "../../../../../interfaces/v0.8.x/IGenArt721CoreContractV3_Engine_Flex.sol";
 
 /**
  * @title This interface is intended to house interface items that are common

package/contracts/engine-registry/CoreRegistryV1.sol

@@ -2,7 +2,7 @@
 
 pragma solidity 0.8.19;
 
-import "../interfaces/0.8.x/ICoreRegistryV1.sol";
+import "../interfaces/v0.8.x/ICoreRegistryV1.sol";
 import "@openzeppelin-4.7/contracts/access/Ownable.sol";
 import "@openzeppelin-4.7/contracts/utils/structs/EnumerableSet.sol";
 

package/contracts/engine-registry/EngineRegistryV0.sol

@@ -2,7 +2,7 @@
 
 pragma solidity 0.8.19;
 
-import "../interfaces/0.8.x/IEngineRegistryV0.sol";
+import "../interfaces/v0.8.x/IEngineRegistryV0.sol";
 import "@openzeppelin-4.7/contracts/utils/introspection/ERC165.sol";
 
 /**

package/contracts/explorations/GenArt721CoreV3_Explorations.sol

@@ -3,17 +3,17 @@ pragma solidity 0.8.19;
 
 // Created By: Art Blocks Inc.
 
-import "../interfaces/0.8.x/IRandomizerV2.sol";
-import "../interfaces/0.8.x/IAdminACLV0.sol";
-import "../interfaces/0.8.x/IGenArt721CoreContractV3.sol";
-import "../interfaces/0.8.x/IGenArt721CoreContractExposesHashSeed.sol";
-import "../interfaces/0.8.x/IManifold.sol";
+import "../interfaces/v0.8.x/IRandomizerV2.sol";
+import "../interfaces/v0.8.x/IAdminACLV0.sol";
+import "../interfaces/v0.8.x/IGenArt721CoreContractV3.sol";
+import "../interfaces/v0.8.x/IGenArt721CoreContractExposesHashSeed.sol";
+import "../interfaces/v0.8.x/IManifold.sol";
 
 import "@openzeppelin-4.7/contracts/utils/Strings.sol";
 import "@openzeppelin-4.7/contracts/access/Ownable.sol";
-import "../libs/0.8.x/ERC721_PackedHashSeed.sol";
-import "../libs/0.8.x/BytecodeStorageV1.sol";
-import "../libs/0.8.x/Bytes32Strings.sol";
+import "../libs/v0.8.x/ERC721_PackedHashSeed.sol";
+import "../libs/v0.8.x/BytecodeStorageV1.sol";
+import "../libs/v0.8.x/Bytes32Strings.sol";
 
 /**
  * @title Art Blocks ERC-721 core contract, V3_Explorations.
@@ -181,7 +181,7 @@ contract GenArt721CoreV3_Explorations is
         bool paused;
         string name;
         string artist;
-        string description;
+        address descriptionAddress;
         string website;
         string license;
         string projectBaseURI;
@@ -238,7 +238,7 @@ contract GenArt721CoreV3_Explorations is
     /// version & type of this core contract
     /// coreVersion is updated from Flagship V3 core due to minor changes
     /// implemented in the Explorations version of the contract.
-    string public constant coreVersion = "v3.2.1";
+    string public constant coreVersion = "v3.2.3";
     /// coreType remains consistent with flagship V3 core because external &
     /// public functions used for indexing are unchanged.
     string public constant coreType = "GenArt721CoreV3";
@@ -950,6 +950,13 @@ contract GenArt721CoreV3_Explorations is
     /**
      * @notice Updates description of project `_projectId`.
      * Only artist may call when unlocked, only admin may call when locked.
+     * Note: The BytecodeStorage library is used to store the description to
+     * reduce initial upload cost, however, even minor edits will require an
+     * expensive, entirely new bytecode storage contract to be deployed instead
+     * of relatively cheap updates to already-warm storage slots. This results
+     * in an increased gas cost for minor edits to the description after the
+     * initial upload, but an overall decrease in gas cost for projects with
+     * less than ~3-5 edits (depending on the length of the description).
      * @param _projectId Project ID.
      * @param _projectDescription New project description.
      */
@@ -969,7 +976,10 @@ contract GenArt721CoreV3_Explorations is
             "Only artist when unlocked, owner when locked"
         );
         // effects
-        projects[_projectId].description = _projectDescription;
+        // store description in contract bytecode, replacing reference address from
+        // the old storage description with the newly created one
+        projects[_projectId].descriptionAddress = _projectDescription
+            .writeToBytecode();
         emit ProjectUpdated(_projectId, FIELD_PROJECT_DESCRIPTION);
     }
 
@@ -1360,7 +1370,12 @@ contract GenArt721CoreV3_Explorations is
         Project storage project = projects[_projectId];
         projectName = project.name;
         artist = project.artist;
-        description = project.description;
+        address projectDescriptionBytecodeAddress = project.descriptionAddress;
+        if (projectDescriptionBytecodeAddress == address(0)) {
+            description = "";
+        } else {
+            description = _readFromBytecode(projectDescriptionBytecodeAddress);
+        }
         website = project.website;
         license = project.license;
     }

package/contracts/interfaces/{0.8.x → v0.8.x}/IDependencyRegistryV0.sol

@@ -78,7 +78,7 @@ interface IDependencyRegistryV0 {
      * @notice Returns address with bytecode containing script for
      * dependency type `_dependencyTypes` at script index `_index`.
      */
-    function getDependencyScriptBytecodeAddressAtIndex(
+    function getDependencyScriptBytecodeAddress(
         bytes32 _dependencyType,
         uint256 _index
     ) external view returns (address);
@@ -88,7 +88,7 @@ interface IDependencyRegistryV0 {
      * @param _dependencyType Dependency type to be queried.
      * @param _index Index of script to be queried.
      */
-    function getDependencyScriptAtIndex(
+    function getDependencyScript(
         bytes32 _dependencyType,
         uint256 _index
     ) external view returns (string memory);

package/contracts/interfaces/v0.8.x/IGenArt721CoreContractV3WithSharedRandomizer.sol

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+import "./ISharedRandomizerV0.sol";
+
+/**
+ * @title Interface for accessing a shared randomizer on a core contract.
+ * @notice This interface provides access to a V3 core contract's shared
+ * randomizer. Note that randomizers are configurable by core contract admin,
+ * and therefore may not currently be assigned a shared randomizer. For that
+ * reason, this is a separate interface from `IGenArt721CoreContractV3_Base,
+ * and casting a contract as this interface makes the assumption that the core
+ * contract's randomizer conforms to `ISharedRandomizerV0`.
+ * This interface is expected to be most useful for minters that explicitly
+ * assign hash seeds via mechanisms on the shared randomizer (e.g. Polyptych
+ * minters)
+ */
+interface IGenArt721CoreContractV3WithSharedRandomizer {
+    /// current randomizer contract, that we cast as a shared randomizer
+    function randomizerContract() external returns (ISharedRandomizerV0);
+}

package/contracts/interfaces/{0.8.x → v0.8.x}/IMinterFilterV1.sol

@@ -85,6 +85,13 @@ interface IMinterFilterV1 {
      */
     event CoreRegistryUpdated(address indexed coreRegistry);
 
+    // struct used to return minter info
+    // @dev this is not used for storage of data
+    struct MinterWithType {
+        address minterAddress;
+        string minterType;
+    }
+
     function setMinterForProject(
         uint256 _projectId,
         address _coreContract,
@@ -106,6 +113,16 @@ interface IMinterFilterV1 {
 
     function updateCoreRegistry(address _coreRegistry) external;
 
+    /**
+     * @notice Returns if `_sender` is allowed to call function on `_contract`
+     * with `_selector` selector, according to the MinterFilter's Admin ACL.
+     */
+    function adminACLAllowed(
+        address _sender,
+        address _contract,
+        bytes4 _selector
+    ) external returns (bool);
+
     function minterFilterType() external pure returns (string memory);
 
     function getMinterForProject(
@@ -150,6 +167,15 @@ interface IMinterFilterV1 {
             string memory minterType
         );
 
+    function getAllGloballyApprovedMinters()
+        external
+        view
+        returns (MinterWithType[] memory mintersWithTypes);
+
+    function getAllContractApprovedMinters(
+        address _coreContract
+    ) external view returns (MinterWithType[] memory mintersWithTypes);
+
     /**
      * Owner of contract.
      * @dev This returns the address of the Admin ACL contract.

package/contracts/interfaces/v0.8.x/IRandomizer_V3CoreBase.sol

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Creatd By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+interface IRandomizer_V3CoreBase {
+    /**
+     * @notice This function is intended to be called by a core contract, and
+     * the core contract can be assured that the randomizer will call back to
+     * the calling contract to set the token hash seed for `_tokenId` via
+     * `setTokenHash_8PT`.
+     * @dev This function may revert if hash seed generation is improperly
+     * configured (for example, if in polyptych mode, but no hash seed has been
+     * previously configured).
+     * @dev This function is not specifically gated to any specific caller, but
+     * will only call back to the calling contract, `msg.sender`, to set the
+     * specified token's hash seed.
+     * A third party contract calling this function will not be able to set the
+     * token hash seed on a different core contract.
+     * @param _tokenId The token ID must be assigned a hash.
+     */
+    function assignTokenHash(uint256 _tokenId) external;
+}

package/contracts/interfaces/v0.8.x/ISharedMinterDAExpSettlementV0.sol

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+import "./ISharedMinterDAExpV0.sol";
+
+interface ISharedMinterDAExpSettlementV0 is ISharedMinterDAExpV0 {
+    /// receipt has an updated state
+    event ReceiptUpdated(
+        address indexed _purchaser,
+        uint256 indexed _projectId,
+        address indexed _coreContract,
+        uint24 _numPurchased,
+        uint256 _netPosted
+    );
+
+    /// returns latest purchase price for project `_projectId`, or 0 if no
+    /// purchases have been made.
+    function getProjectLatestPurchasePrice(
+        uint256 _projectId,
+        address _coreContract
+    ) external view returns (uint256 latestPurchasePrice);
+
+    /// returns the number of settleable invocations for project `_projectId`.
+    function getNumSettleableInvocations(
+        uint256 _projectId,
+        address _coreContract
+    ) external view returns (uint256 numSettleableInvocations);
+
+    /// Returns the current excess settlement funds on project `_projectId`
+    /// for address `_walletAddress`.
+    function getProjectExcessSettlementFunds(
+        uint256 _projectId,
+        address _coreContract,
+        address _walletAddress
+    ) external view returns (uint256 excessSettlementFundsInWei);
+}

package/contracts/interfaces/v0.8.x/ISharedMinterDAExpV0.sol

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+interface ISharedMinterDAExpV0 {
+    event SetAuctionDetailsExp(
+        uint256 indexed _projectId,
+        address indexed _coreContract,
+        uint40 _auctionTimestampStart,
+        uint40 _priceDecayHalfLifeSeconds,
+        uint256 _startPrice,
+        uint256 _basePrice
+    );
+    /// Minimum allowed price decay half life seconds updated.
+    event AuctionMinHalfLifeSecondsUpdated(
+        uint256 _minimumPriceDecayHalfLifeSeconds
+    );
+
+    function minimumPriceDecayHalfLifeSeconds() external view returns (uint256);
+
+    function setMinimumPriceDecayHalfLifeSeconds(
+        uint256 _minimumPriceDecayHalfLifeSeconds
+    ) external;
+}

package/contracts/interfaces/v0.8.x/ISharedMinterDALinV0.sol

@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+interface ISharedMinterDALinV0 {
+    event SetAuctionDetailsLin(
+        uint256 indexed _projectId,
+        address indexed _coreContract,
+        uint40 _auctionTimestampStart,
+        uint40 _auctionTimestampEnd,
+        uint256 _startPrice,
+        uint256 _basePrice
+    );
+
+    /// Minimum allowed auction length updated
+    event AuctionMinimumLengthSecondsUpdated(
+        uint256 _minimumAuctionLengthSeconds
+    );
+
+    function minimumAuctionLengthSeconds() external view returns (uint256);
+
+    function setMinimumAuctionLengthSeconds(
+        uint256 _minimumAuctionLengthSeconds
+    ) external;
+}

package/contracts/interfaces/v0.8.x/ISharedMinterDAV0.sol

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+interface ISharedMinterDAV0 {
+    /// Auction details cleared for project `projectId`.
+    event ResetAuctionDetails(
+        uint256 indexed _projectId,
+        address indexed _coreContract
+    );
+
+    // @dev return variables left unnamed because specific minter
+    // implementations may return different values for the same slots
+    function projectAuctionParameters(
+        uint256 _projectId,
+        address _coreContract
+    ) external view returns (uint40, uint40, uint256, uint256);
+}

package/contracts/interfaces/v0.8.x/ISharedMinterHolderV0.sol

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+/**
+ * @title This interface adds support for including token holder gating when purchasing.
+ * @author Art Blocks Inc.
+ */
+interface ISharedMinterHolderV0 {
+    event DelegationRegistryUpdated(address delegationRegistry);
+    /**
+     * @notice Allow holders of NFTs at addresses `_ownedNFTAddresses`, project
+     * IDs `_ownedNFTProjectIds` to mint on project `_projectId`.
+     * `_ownedNFTAddresses` assumed to be aligned with `_ownedNFTProjectIds`.
+     * e.g. Allows holders of project `_ownedNFTProjectIds[0]` on token
+     * contract `_ownedNFTAddresses[0]` to mint.
+     */
+    event AllowedHoldersOfProjects(
+        uint256 indexed _projectId,
+        address indexed _coreContract,
+        address[] _ownedNFTAddresses,
+        uint256[] _ownedNFTProjectIds
+    );
+    /**
+     * @notice Remove holders of NFTs at addresses `_ownedNFTAddresses`,
+     * project IDs `_ownedNFTProjectIds` to mint on project `_projectId`.
+     * `_ownedNFTAddresses` assumed to be aligned with `_ownedNFTProjectIds`.
+     * e.g. Removes holders of project `_ownedNFTProjectIds[0]` on token
+     * contract `_ownedNFTAddresses[0]` from mint allowlist.
+     */
+    event RemovedHoldersOfProjects(
+        uint256 indexed _projectId,
+        address indexed _coreContract,
+        address[] _ownedNFTAddresses,
+        uint256[] _ownedNFTProjectIds
+    );
+
+    // Triggers a purchase of a token from the desired project, to the
+    // TX-sending address, using owned ERC-721 NFT to claim right to purchase.
+    function purchase(
+        uint256 _projectId,
+        address _coreContract,
+        address _ownedNFTAddress,
+        uint256 _ownedNFTTokenId
+    ) external payable returns (uint256 tokenId);
+
+    // Triggers a purchase of a token from the desired project, to the specified
+    // receiving address, using owned ERC-721 NFT to claim right to purchase.
+    function purchaseTo(
+        address _to,
+        uint256 _projectId,
+        address _coreContract,
+        address _ownedNFTAddress,
+        uint256 _ownedNFTTokenId
+    ) external payable returns (uint256 tokenId);
+
+    // Triggers a purchase of a token from the desired project, on behalf of
+    // the provided vault, to the specified receiving address, using owned
+    // ERC-721 NFT to claim right to purchase.
+    function purchaseTo(
+        address _to,
+        uint256 _projectId,
+        address _coreContract,
+        address _ownedNFTAddress,
+        uint256 _ownedNFTTokenId,
+        address _vault
+    ) external payable returns (uint256 tokenId);
+}

package/contracts/interfaces/v0.8.x/ISharedMinterMerkleV0.sol

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+/**
+ * @title This interface adds support for including Merkle proofs when purchasing.
+ * @author Art Blocks Inc.
+ */
+interface ISharedMinterMerkleV0 {
+    /**
+     * @notice Notifies of the contract's default maximum mints allowed per
+     * user for a given project, on this minter. This value can be overridden
+     * by the artist of any project at any time.
+     */
+    event DefaultMaxInvocationsPerAddress(
+        uint256 defaultMaxInvocationsPerAddress
+    );
+    event DelegationRegistryUpdated(address delegationRegistry);
+
+    // Triggers a purchase of a token from the desired project, to the
+    // TX-sending address. Requires Merkle proof.
+    function purchase(
+        uint256 _projectId,
+        address _coreContract,
+        bytes32[] calldata _proof
+    ) external payable returns (uint256 tokenId);
+
+    // Triggers a purchase of a token from the desired project, to the specified
+    // receiving address. Requires Merkle proof.
+    function purchaseTo(
+        address _to,
+        uint256 _projectId,
+        address _coreContract,
+        bytes32[] calldata _proof
+    ) external payable returns (uint256 tokenId);
+
+    // Updates the Merkle root for the desired project.
+    function updateMerkleRoot(
+        uint256 _projectId,
+        address _coreContract,
+        bytes32 _root
+    ) external;
+}