@artblocks/contracts 1.1.0 → 1.2.1

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

@@ -4,8 +4,7 @@
 pragma solidity ^0.8.0;
 
 import "./IAdminACLV0.sol";
-/// use the Royalty Registry's IManifold interface for token royalties
-import "./IManifold.sol";
+import "./IGenArt721CoreProjectScriptV1.sol";
 
 /**
  * @title This interface is intended to house interface items that are common
@@ -14,7 +13,131 @@ import "./IManifold.sol";
  * add support the Royalty Registry by default.
  * @author Art Blocks Inc.
  */
-interface IGenArt721CoreContractV3_Base is IManifold {
+interface IGenArt721CoreContractV3_Base is IGenArt721CoreProjectScriptV1 {
+    // This interface emits generic events that contain fields that indicate
+    // which parameter has been updated. This is sufficient for application
+    // state management, while also simplifying the contract and indexing code.
+    // This was done as an alternative to having custom events that emit what
+    // field-values have changed for each event, given that changed values can
+    // be introspected by indexers due to the design of this smart contract
+    // exposing these state changes via publicly viewable fields.
+
+    /**
+     * @notice Event emitted when the Art Blocks Curation Registry contract is updated.
+     * @dev only utilized by subset of V3 core contracts (Art Blocks Curated contracts)
+     * @param artblocksCurationRegistryAddress Address of Art Blocks Curation Registry contract.
+     */
+    event ArtBlocksCurationRegistryContractUpdated(
+        address indexed artblocksCurationRegistryAddress
+    );
+
+    /**
+     * @notice Project's royalty splitter was updated to `_splitter`.
+     * @dev New event in v3.2
+     * @param projectId The project ID.
+     * @param royaltySplitter The new splitter address to receive royalties.
+     */
+    event ProjectRoyaltySplitterUpdated(
+        uint256 indexed projectId,
+        address indexed royaltySplitter
+    );
+
+    // The following fields are used to indicate which contract-level parameter
+    // has been updated in the `PlatformUpdated` event:
+    // @dev only append to the end of this enum in the case of future updates
+    enum PlatformUpdatedFields {
+        FIELD_NEXT_PROJECT_ID, // 0
+        FIELD_NEW_PROJECTS_FORBIDDEN, // 1
+        FIELD_DEFAULT_BASE_URI, // 2
+        FIELD_RANDOMIZER_ADDRESS, // 3
+        FIELD_NEXT_CORE_CONTRACT, // 4
+        FIELD_ARTBLOCKS_DEPENDENCY_REGISTRY_ADDRESS, // 5
+        FIELD_ARTBLOCKS_ON_CHAIN_GENERATOR_ADDRESS, // 6
+        FIELD_PROVIDER_SALES_ADDRESSES, // 7
+        FIELD_PROVIDER_PRIMARY_SALES_PERCENTAGES, // 8
+        FIELD_PROVIDER_SECONDARY_SALES_BPS, // 9
+        FIELD_SPLIT_PROVIDER, // 10
+        FIELD_BYTECODE_STORAGE_READER // 11
+    }
+
+    // The following fields are used to indicate which project-level parameter
+    // has been updated in the `ProjectUpdated` event:
+    // @dev only append to the end of this enum in the case of future updates
+    enum ProjectUpdatedFields {
+        FIELD_PROJECT_COMPLETED, // 0
+        FIELD_PROJECT_ACTIVE, // 1
+        FIELD_PROJECT_ARTIST_ADDRESS, // 2
+        FIELD_PROJECT_PAUSED, // 3
+        FIELD_PROJECT_CREATED, // 4
+        FIELD_PROJECT_NAME, // 5
+        FIELD_PROJECT_ARTIST_NAME, // 6
+        FIELD_PROJECT_SECONDARY_MARKET_ROYALTY_PERCENTAGE, // 7
+        FIELD_PROJECT_DESCRIPTION, // 8
+        FIELD_PROJECT_WEBSITE, // 9
+        FIELD_PROJECT_LICENSE, // 10
+        FIELD_PROJECT_MAX_INVOCATIONS, // 11
+        FIELD_PROJECT_SCRIPT, // 12
+        FIELD_PROJECT_SCRIPT_TYPE, // 13
+        FIELD_PROJECT_ASPECT_RATIO, // 14
+        FIELD_PROJECT_BASE_URI, // 15
+        FIELD_PROJECT_PROVIDER_SECONDARY_FINANCIALS // 16
+    }
+
+    /**
+     * @notice Error codes for the GenArt721 contract. Used by the GenArt721Error
+     * custom error.
+     * @dev only append to the end of this enum in the case of future updates
+     */
+    enum ErrorCodes {
+        OnlyNonZeroAddress, // 0
+        OnlyNonEmptyString, // 1
+        OnlyNonEmptyBytes, // 2
+        TokenDoesNotExist, // 3
+        ProjectDoesNotExist, // 4
+        OnlyUnlockedProjects, // 5
+        OnlyAdminACL, // 6
+        OnlyArtist, // 7
+        OnlyArtistOrAdminACL, // 8
+        OnlyAdminACLOrRenouncedArtist, // 9
+        OnlyMinterContract, // 10
+        MaxInvocationsReached, // 11
+        ProjectMustExistAndBeActive, // 12
+        PurchasesPaused, // 13
+        OnlyRandomizer, // 14
+        TokenHashAlreadySet, // 15
+        NoZeroHashSeed, // 16
+        OverMaxSumOfPercentages, // 17
+        IndexOutOfBounds, // 18
+        OverMaxSumOfBPS, // 19
+        MaxOf100Percent, // 20
+        PrimaryPayeeIsZeroAddress, // 21
+        SecondaryPayeeIsZeroAddress, // 22
+        MustMatchArtistProposal, // 23
+        NewProjectsForbidden, // 24
+        NewProjectsAlreadyForbidden, // 25
+        OnlyArtistOrAdminIfLocked, // 26
+        OverMaxSecondaryRoyaltyPercentage, // 27
+        OnlyMaxInvocationsDecrease, // 28
+        OnlyGteInvocations, // 29
+        ScriptIdOutOfRange, // 30
+        NoScriptsToRemove, // 31
+        ScriptTypeAndVersionFormat, // 32
+        AspectRatioTooLong, // 33
+        AspectRatioNoNumbers, // 34
+        AspectRatioImproperFormat, // 35
+        OnlyNullPlatformProvider, // 36
+        ContractInitialized // 37
+    }
+
+    /**
+     * @notice Emits an error code `_errorCode` in the GenArt721Error event.
+     * @dev Emitting error codes instead of error strings saves significant
+     * contract bytecode size, allowing for more contract functionality within
+     * the 24KB contract size limit.
+     * @param _errorCode The error code to emit. See ErrorCodes enum.
+     */
+    error GenArt721Error(ErrorCodes _errorCode);
+
     /**
      * @notice Token ID `_tokenId` minted to `_to`.
      */
@@ -95,14 +218,6 @@ interface IGenArt721CoreContractV3_Base is IManifold {
         uint256 _projectId
     ) external view returns (address payable);
 
-    function projectIdToAdditionalPayeePrimarySales(
-        uint256 _projectId
-    ) external view returns (address payable);
-
-    function projectIdToAdditionalPayeePrimarySalesPercentage(
-        uint256 _projectId
-    ) external view returns (uint256);
-
     function projectIdToSecondaryMarketRoyaltyPercentage(
         uint256 _projectId
     ) external view returns (uint256);

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

@@ -5,8 +5,61 @@ pragma solidity ^0.8.0;
 
 import "./IAdminACLV0.sol";
 import "./IGenArt721CoreContractV3_Base.sol";
+import "./ISplitProviderV0.sol";
+
+/**
+ * @notice Struct representing Engine contract configuration.
+ * @param tokenName Name of token.
+ * @param tokenSymbol Token symbol.
+ * @param renderProviderAddress address to send render provider revenue to
+ * @param randomizerContract Randomizer contract.
+ * @param splitProviderAddress Address to use as royalty splitter provider for the contract.
+ * @param minterFilterAddress Address of the Minter Filter to set as the Minter
+ * on the contract.
+ * @param startingProjectId The initial next project ID.
+ * @param autoApproveArtistSplitProposals Whether or not to always
+ * auto-approve proposed artist split updates.
+ * @param nullPlatformProvider Enforce always setting zero platform provider fees and addresses.
+ * @param allowArtistProjectActivation Allow artist to activate their own projects.
+ * @dev _startingProjectId should be set to a value much, much less than
+ * max(uint248), but an explicit input type of `uint248` is used as it is
+ * safer to cast up to `uint256` than it is to cast down for the purposes
+ * of setting `_nextProjectId`.
+ */
+struct EngineConfiguration {
+    string tokenName;
+    string tokenSymbol;
+    address renderProviderAddress;
+    address platformProviderAddress;
+    address newSuperAdminAddress;
+    address randomizerContract;
+    address splitProviderAddress;
+    address minterFilterAddress;
+    uint248 startingProjectId;
+    bool autoApproveArtistSplitProposals;
+    bool nullPlatformProvider;
+    bool allowArtistProjectActivation;
+}
 
 interface IGenArt721CoreContractV3_Engine is IGenArt721CoreContractV3_Base {
+    // @dev new function in V3.2
+    /**
+     * @notice Initializes the contract with the provided `engineConfiguration`.
+     * This function should be called atomically, immediately after deployment.
+     * Only callable once. Validation on `engineConfiguration` is performed by caller.
+     * @param engineConfiguration EngineConfiguration to configure the contract with.
+     * @param adminACLContract_ Address of admin access control contract, to be
+     * set as contract owner.
+     * @param defaultBaseURIHost Base URI prefix to initialize default base URI with.
+     * @param bytecodeStorageReaderContract_ Address of the bytecode storage reader contract.
+     */
+    function initialize(
+        EngineConfiguration calldata engineConfiguration,
+        address adminACLContract_,
+        string memory defaultBaseURIHost,
+        address bytecodeStorageReaderContract_
+    ) external;
+
     // @dev new function in V3
     function getPrimaryRevenueSplits(
         uint256 _projectId,
@@ -49,24 +102,49 @@ interface IGenArt721CoreContractV3_Engine is IGenArt721CoreContractV3_Base {
         view
         returns (uint256);
 
-    // @dev The render provider secondary sales royalties payment address
-    function renderProviderSecondarySalesAddress()
+    /** @notice The default render provider payment address for all secondary sales royalty
+     * revenues, for all new projects. Individual project payment info is defined
+     * in each project's ProjectFinance struct.
+     * @return The default render provider payment address for secondary sales royalties.
+     */
+    function defaultRenderProviderSecondarySalesAddress()
         external
         view
         returns (address payable);
 
-    // @dev The platform provider secondary sales royalties payment address
-    function platformProviderSecondarySalesAddress()
+    /** @notice The default platform provider payment address for all secondary sales royalty
+     * revenues, for all new projects. Individual project payment info is defined
+     * in each project's ProjectFinance struct.
+     * @return The default platform provider payment address for secondary sales royalties.
+     */
+    function defaultPlatformProviderSecondarySalesAddress()
         external
         view
         returns (address payable);
 
-    // @dev Basis points of secondary sales allocated to the render provider
-    function renderProviderSecondarySalesBPS() external view returns (uint256);
+    /** @notice The default render provider payment basis points for all secondary sales royalty
+     * revenues, for all new projects. Individual project payment info is defined
+     * in each project's ProjectFinance struct.
+     * @return The default render provider payment basis points for secondary sales royalties.
+     */
+    function defaultRenderProviderSecondarySalesBPS()
+        external
+        view
+        returns (uint256);
 
-    // @dev Basis points of secondary sales allocated to the platform provider
-    function platformProviderSecondarySalesBPS()
+    /** @notice The default platform provider payment basis points for all secondary sales royalty
+     * revenues, for all new projects. Individual project payment info is defined
+     * in each project's ProjectFinance struct.
+     * @return The default platform provider payment basis points for secondary sales royalties.
+     */
+    function defaultPlatformProviderSecondarySalesBPS()
         external
         view
         returns (uint256);
+
+    /**
+     * @notice The address of the current split provider being used by the contract.
+     * @return The address of the current split provider.
+     */
+    function splitProvider() external view returns (ISplitProviderV0);
 }

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

@@ -18,8 +18,8 @@ interface IGenArt721CoreContractV3_Engine_Flex is
      * @notice When an external asset dependency is updated or added, this event is emitted.
      * @param _projectId The project ID of the project that was updated.
      * @param _index The index of the external asset dependency that was updated.
-     * @param _cid The content ID of the external asset dependency. This is an empty string
-     * if the dependency type is ONCHAIN.
+     * @param _cid Field that contains the CID of the dependency if IPFS or ARWEAVE, empty string of ONCHAIN, or a string representation
+     * of the Art Blocks Dependency Registry's `dependencyNameAndVersion` if ART_BLOCKS_DEPENDENCY_REGISTRY.
      * @param _dependencyType The type of the external asset dependency.
      * @param _externalAssetDependencyCount The number of external asset dependencies.
      */
@@ -54,17 +54,31 @@ interface IGenArt721CoreContractV3_Engine_Flex is
     event ProjectExternalAssetDependenciesLocked(uint256 indexed _projectId);
 
     /**
-     * @notice An external asset dependency type. Can be one of IPFS, ARWEAVE, or ONCHAIN.
+     * @notice An external asset dependency type. Can be one of IPFS, ARWEAVE, ONCHAIN, or ART_BLOCKS_DEPENDENCY_REGISTRY.
      */
     enum ExternalAssetDependencyType {
         IPFS,
         ARWEAVE,
-        ONCHAIN
+        ONCHAIN,
+        ART_BLOCKS_DEPENDENCY_REGISTRY
     }
 
     /**
-     * @notice An external asset dependency. This is a struct that contains the CID of the dependency,
-     * the type of the dependency, and the address of the bytecode for this dependency.
+     * @notice Project storage that relate to Flex data.
+     */
+    struct ProjectFlex {
+        bool externalAssetDependenciesLocked;
+        uint24 externalAssetDependencyCount;
+        mapping(uint256 => ExternalAssetDependency) externalAssetDependencies;
+    }
+
+    /**
+     * @notice An external asset dependency, without the retrieved data of any ONCHAIN assets. This reflects what is
+     * stored in this contract's storage.
+     * @param CID field that contains the CID of the dependency if IPFS or ARWEAVE, empty string of ONCHAIN, or a string representation
+     * of the Art Blocks Dependency Registry's `dependencyNameAndVersion` if ART_BLOCKS_DEPENDENCY_REGISTRY.
+     * @param dependencyType field that contains the type of the dependency.
+     * @param bytecodeAddress field that contains the address of the bytecode for this dependency if ONCHAIN, null address otherwise.
      */
     struct ExternalAssetDependency {
         string cid;
@@ -73,8 +87,12 @@ interface IGenArt721CoreContractV3_Engine_Flex is
     }
 
     /**
-     * @notice An external asset dependency with data. This is a convenience struct that contains the CID of the dependency,
-     * the type of the dependency, the address of the bytecode for this dependency, and the data retrieved from this bytecode address.
+     * @notice An external asset dependency with data. This is a convenience struct.
+     * @param CID field that contains the CID of the dependency if IPFS or ARWEAVE, empty string of ONCHAIN, or a string representation
+     * of the Art Blocks Dependency Registry's `dependencyNameAndVersion` if ART_BLOCKS_DEPENDENCY_REGISTRY.
+     * @param dependencyType field that contains the type of the dependency.
+     * @param bytecodeAddress field that contains the address of the bytecode for this dependency if ONCHAIN, null address otherwise.
+     * @param data field that contains the data retrieved from this bytecode address if ONCHAIN, empty string otherwise.
      */
     struct ExternalAssetDependencyWithData {
         string cid;

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

@@ -0,0 +1,141 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+import "./IAdminACLV0.sol";
+import "./IGenArt721CoreContractV3_Engine_PreV3p2.sol";
+
+/**
+ * @title This interface is intended to house interface items that are common
+ * across all GenArt721CoreContractV3 Engine Flex and derivative implementations.
+ * @author Art Blocks Inc.
+ */
+interface IGenArt721CoreContractV3_Engine_Flex_PreV3p2 is
+    IGenArt721CoreContractV3_Engine_PreV3p2
+{
+    /**
+     * @notice When an external asset dependency is updated or added, this event is emitted.
+     * @param _projectId The project ID of the project that was updated.
+     * @param _index The index of the external asset dependency that was updated.
+     * @param _cid The content ID of the external asset dependency. This is an empty string
+     * if the dependency type is ONCHAIN.
+     * @param _dependencyType The type of the external asset dependency.
+     * @param _externalAssetDependencyCount The number of external asset dependencies.
+     */
+    event ExternalAssetDependencyUpdated(
+        uint256 indexed _projectId,
+        uint256 indexed _index,
+        string _cid,
+        ExternalAssetDependencyType _dependencyType,
+        uint24 _externalAssetDependencyCount
+    );
+
+    /**
+     * @notice The project id `_projectId` has had an external asset dependency removed at index `_index`.
+     */
+    event ExternalAssetDependencyRemoved(
+        uint256 indexed _projectId,
+        uint256 indexed _index
+    );
+
+    /**
+     * @notice The preferred gateway for dependency type `_dependencyType` has been updated to `_gatewayAddress`.
+     */
+    event GatewayUpdated(
+        ExternalAssetDependencyType indexed _dependencyType,
+        string _gatewayAddress
+    );
+
+    /**
+     * @notice The project id `_projectId` has had all external asset dependencies locked.
+     * @dev This is a one-way operation. Once locked, the external asset dependencies cannot be updated.
+     */
+    event ProjectExternalAssetDependenciesLocked(uint256 indexed _projectId);
+
+    /**
+     * @notice An external asset dependency type. Can be one of IPFS, ARWEAVE, or ONCHAIN.
+     */
+    enum ExternalAssetDependencyType {
+        IPFS,
+        ARWEAVE,
+        ONCHAIN
+    }
+
+    /**
+     * @notice Project storage that relate to Flex data.
+     */
+    struct ProjectFlex {
+        bool externalAssetDependenciesLocked;
+        uint24 externalAssetDependencyCount;
+        mapping(uint256 => ExternalAssetDependency) externalAssetDependencies;
+    }
+
+    /**
+     * @notice An external asset dependency. This is a struct that contains the CID of the dependency,
+     * the type of the dependency, and the address of the bytecode for this dependency.
+     */
+    struct ExternalAssetDependency {
+        string cid;
+        ExternalAssetDependencyType dependencyType;
+        address bytecodeAddress;
+    }
+
+    /**
+     * @notice An external asset dependency with data. This is a convenience struct that contains the CID of the dependency,
+     * the type of the dependency, the address of the bytecode for this dependency, and the data retrieved from this bytecode address.
+     */
+    struct ExternalAssetDependencyWithData {
+        string cid;
+        ExternalAssetDependencyType dependencyType;
+        address bytecodeAddress;
+        string data;
+    }
+
+    // preferredIPFSGateway is a url string
+    function preferredIPFSGateway() external view returns (string memory);
+
+    // preferredArweaveGateway is a url string
+    function preferredArweaveGateway() external view returns (string memory);
+
+    // updates the preferred IPFS gateway
+    function updateIPFSGateway(string calldata _gateway) external;
+
+    // updates the preferred Arweave gateway
+    function updateArweaveGateway(string calldata _gateway) external;
+
+    // locks the external asset dependencies for a project
+    function lockProjectExternalAssetDependencies(uint256 _projectId) external;
+
+    // updates the external asset dependency for a project at a given index
+    function updateProjectExternalAssetDependency(
+        uint256 _projectId,
+        uint256 _index,
+        string memory _cidOrData,
+        ExternalAssetDependencyType _dependencyType
+    ) external;
+
+    // adds an external asset dependency for a project
+    function addProjectExternalAssetDependency(
+        uint256 _projectId,
+        string memory _cidOrData,
+        ExternalAssetDependencyType _dependencyType
+    ) external;
+
+    // removes an external asset dependency for a project at a given index
+    function removeProjectExternalAssetDependency(
+        uint256 _projectId,
+        uint256 _index
+    ) external;
+
+    // getter function for project external asset dependencies
+    function projectExternalAssetDependencyByIndex(
+        uint256 _projectId,
+        uint256 _index
+    ) external view returns (ExternalAssetDependencyWithData memory);
+
+    // getter function project external asset dependency count
+    function projectExternalAssetDependencyCount(
+        uint256 _projectId
+    ) external view returns (uint256);
+}

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

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+import "./IAdminACLV0.sol";
+import "./IGenArt721CoreContractV3_Base.sol";
+
+// @title This interface is intended to house interface items that were used on the
+// GenArt721CoreContractV3 Engine and derivative implementations prior to v3.2.0.
+// Namely, the platform and render provider secondary sales functions are exposed at the contract-level
+// instead of having only defaults defined at the contract level.
+interface IGenArt721CoreContractV3_Engine_PreV3p2 is
+    IGenArt721CoreContractV3_Base
+{
+    // @dev new function in V3
+    function getPrimaryRevenueSplits(
+        uint256 _projectId,
+        uint256 _price
+    )
+        external
+        view
+        returns (
+            uint256 renderProviderRevenue_,
+            address payable renderProviderAddress_,
+            uint256 platformProviderRevenue_,
+            address payable platformProviderAddress_,
+            uint256 artistRevenue_,
+            address payable artistAddress_,
+            uint256 additionalPayeePrimaryRevenue_,
+            address payable additionalPayeePrimaryAddress_
+        );
+
+    // @dev The render provider primary sales payment address
+    function renderProviderPrimarySalesAddress()
+        external
+        view
+        returns (address payable);
+
+    // @dev The platform provider primary sales payment address
+    function platformProviderPrimarySalesAddress()
+        external
+        view
+        returns (address payable);
+
+    // @dev Percentage of primary sales allocated to the render provider
+    function renderProviderPrimarySalesPercentage()
+        external
+        view
+        returns (uint256);
+
+    // @dev Percentage of primary sales allocated to the platform provider
+    function platformProviderPrimarySalesPercentage()
+        external
+        view
+        returns (uint256);
+
+    // @dev The render provider secondary sales royalties payment address
+    function renderProviderSecondarySalesAddress()
+        external
+        view
+        returns (address payable);
+
+    // @dev The platform provider secondary sales royalties payment address
+    function platformProviderSecondarySalesAddress()
+        external
+        view
+        returns (address payable);
+
+    // @dev Basis points of secondary sales allocated to the render provider
+    function renderProviderSecondarySalesBPS() external view returns (uint256);
+
+    // @dev Basis points of secondary sales allocated to the platform provider
+    function platformProviderSecondarySalesBPS()
+        external
+        view
+        returns (uint256);
+}

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

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+import "./IAdminACLV0.sol";
+
+/**
+ * @title This interface defines a project finance struct that is used in the
+ * GenArt721CoreContractV3 flagship and derivative implementations beginning
+ * with v3.2.0. This struct is intended to house all financial information
+ * related to a project, including royalties, artist splits, and platform
+ * provider splits.
+ * @author Art Blocks Inc.
+ */
+interface IGenArt721CoreContractV3_ProjectFinance {
+    /// packed struct containing project financial information
+    struct ProjectFinance {
+        address payable additionalPayeePrimarySales;
+        // packed uint: max of 95, max uint8 = 255
+        uint8 secondaryMarketRoyaltyPercentage;
+        address payable additionalPayeeSecondarySales;
+        // packed uint: max of 100, max uint8 = 255
+        uint8 additionalPayeeSecondarySalesPercentage;
+        address payable artistAddress;
+        // packed uint: max of 100, max uint8 = 255
+        uint8 additionalPayeePrimarySalesPercentage;
+        address platformProviderSecondarySalesAddress;
+        // packed uint: max of 10_000 max uint16 = 65_535
+        uint16 platformProviderSecondarySalesBPS;
+        address renderProviderSecondarySalesAddress;
+        // packed uint: max of 10_000 max uint16 = 65_535
+        uint16 renderProviderSecondarySalesBPS;
+        // address to send ERC-2981 royalties to
+        address royaltySplitter;
+    }
+
+    /**
+     * @notice View function returning project financial details for project
+     * `_projectId`.
+     * @param _projectId Project ID to be queried.
+     * @return ProjectFinance Project financial details.
+     */
+    function projectIdToFinancials(
+        uint256 _projectId
+    ) external view returns (ProjectFinance memory);
+}

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

@@ -0,0 +1,22 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+pragma solidity ^0.8.0;
+
+/**
+ * @dev This interface is implemented by GenArt721CoreV0, GenArt721CoreV1, and GenArt721CoreV2
+ */
+interface IGenArt721CoreProjectScriptV0 {
+    function projectScriptByIndex(
+        uint256 _projectId,
+        uint256 _index
+    ) external view returns (string memory);
+
+    /**
+     * @dev the return specified here is common across all
+     * pre-v3 core contracts. They all return additional
+     * data as well that varies between contracts but is not
+     * used by the dependency registry.
+     */
+    function projectScriptInfo(
+        uint256 _projectId
+    ) external view returns (string memory scriptJSON, uint256 scriptCount);
+}

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

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+pragma solidity ^0.8.0;
+
+/**
+ * @dev This interface is implemented by GenArt721CoreV3 and above
+ */
+interface IGenArt721CoreProjectScriptV1 {
+    function projectScriptDetails(
+        uint256 _projectId
+    )
+        external
+        view
+        returns (
+            string memory scriptTypeAndVersion,
+            string memory aspectRatio,
+            uint256 scriptCount
+        );
+
+    function projectScriptBytecodeAddressByIndex(
+        uint256 _projectId,
+        uint256 _index
+    ) external view returns (address);
+}

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

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+pragma solidity ^0.8.0;
+
+/**
+ * @dev This interface is implemented by the GenArt721 (GenArt721CoreV0)
+ */
+interface IGenArt721CoreTokenHashProviderV0 {
+    function showTokenHashes(
+        uint256 _tokenId
+    ) external view returns (bytes32[] memory);
+}

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

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+pragma solidity ^0.8.0;
+
+/**
+ * @dev This interface is implemented by GenArt721CoreV1 and above.
+ */
+interface IGenArt721CoreTokenHashProviderV1 {
+    function tokenIdToHash(uint256 tokenId) external view returns (bytes32);
+}