@artblocks/contracts 0.0.1

package/contracts/interfaces/0.5.x/IBonusContract.sol

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Creatd By: Art Blocks Inc.
+
+pragma solidity ^0.5.0;
+
+interface IBonusContract {
+    function triggerBonus(address _to) external returns (bool);
+
+    function bonusIsActive() external view returns (bool);
+}

package/contracts/interfaces/0.5.x/IGenArt721CoreContractV1.sol

@@ -0,0 +1,91 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.5.0;
+
+interface IGenArt721CoreContractV1 {
+    event Mint(
+        address indexed _to,
+        uint256 indexed _tokenId,
+        uint256 indexed _projectId
+    );
+
+    // getter function of public variable
+    function admin() external view returns (address);
+
+    // getter function of public variable
+    function nextProjectId() external view returns (uint256);
+
+    // getter function of public mapping
+    function tokenIdToProjectId(
+        uint256 tokenId
+    ) external view returns (uint256 projectId);
+
+    function isWhitelisted(address sender) external view returns (bool);
+
+    // @dev this is not available in V0
+    function isMintWhitelisted(address minter) external view returns (bool);
+
+    function projectIdToArtistAddress(
+        uint256 _projectId
+    ) external view returns (address payable);
+
+    function projectIdToAdditionalPayee(
+        uint256 _projectId
+    ) external view returns (address payable);
+
+    function projectIdToAdditionalPayeePercentage(
+        uint256 _projectId
+    ) external view returns (uint256);
+
+    function projectIdToCurrencySymbol(
+        uint256 _projectId
+    ) external view returns (string memory);
+
+    function projectIdToCurrencyAddress(
+        uint256 _projectId
+    ) external view returns (address);
+
+    function projectIdToPricePerTokenInWei(
+        uint256 _projectId
+    ) external view returns (uint256);
+
+    function projectTokenInfo(
+        uint256 _projectId
+    )
+        external
+        view
+        returns (
+            address,
+            uint256,
+            uint256,
+            uint256,
+            bool,
+            address,
+            uint256,
+            string memory,
+            address
+        );
+
+    function artblocksAddress() external view returns (address payable);
+
+    function artblocksPercentage() external view returns (uint256);
+
+    function mint(
+        address _to,
+        uint256 _projectId,
+        address _by
+    ) external returns (uint256 tokenId);
+
+    function getRoyaltyData(
+        uint256 _tokenId
+    )
+        external
+        view
+        returns (
+            address artistAddress,
+            address additionalPayee,
+            uint256 additionalPayeePercentage,
+            uint256 royaltyFeeByID
+        );
+}

package/contracts/interfaces/0.5.x/IGenArt721CoreV2_PBAB.sol

@@ -0,0 +1,92 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Creatd By: Art Blocks Inc.
+
+pragma solidity ^0.5.0;
+
+interface IGenArt721CoreV2_PBAB {
+    /**
+     * @notice Token ID `_tokenId` minted on project ID `_projectId` to `_to`.
+     * @dev NatSpec for events not supported in Solidity ^0.5.0
+     */
+    event Mint(
+        address indexed _to,
+        uint256 indexed _tokenId,
+        uint256 indexed _projectId
+    );
+
+    // getter function of public variable
+    function admin() external view returns (address);
+
+    // getter function of public variable
+    function nextProjectId() external view returns (uint256);
+
+    // getter function of public mapping
+    function tokenIdToProjectId(
+        uint256 tokenId
+    ) external view returns (uint256 projectId);
+
+    function isWhitelisted(address sender) external view returns (bool);
+
+    function projectIdToCurrencySymbol(
+        uint256 _projectId
+    ) external view returns (string memory);
+
+    function projectIdToCurrencyAddress(
+        uint256 _projectId
+    ) external view returns (address);
+
+    function projectIdToArtistAddress(
+        uint256 _projectId
+    ) external view returns (address payable);
+
+    function projectIdToPricePerTokenInWei(
+        uint256 _projectId
+    ) external view returns (uint256);
+
+    function projectIdToAdditionalPayee(
+        uint256 _projectId
+    ) external view returns (address payable);
+
+    function projectIdToAdditionalPayeePercentage(
+        uint256 _projectId
+    ) external view returns (uint256);
+
+    function projectTokenInfo(
+        uint256 _projectId
+    )
+        external
+        view
+        returns (
+            address,
+            uint256,
+            uint256,
+            uint256,
+            bool,
+            address,
+            uint256,
+            string memory,
+            address
+        );
+
+    function renderProviderAddress() external view returns (address payable);
+
+    function renderProviderPercentage() external view returns (uint256);
+
+    function mint(
+        address _to,
+        uint256 _projectId,
+        address _by
+    ) external returns (uint256 tokenId);
+
+    function getRoyaltyData(
+        uint256 _tokenId
+    )
+        external
+        view
+        returns (
+            address artistAddress,
+            address additionalPayee,
+            uint256 additionalPayeePercentage,
+            uint256 royaltyFeeByID
+        );
+}

package/contracts/interfaces/0.5.x/IRandomizer.sol

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Creatd By: Art Blocks Inc.
+
+pragma solidity ^0.5.0;
+
+interface IRandomizer {
+    function returnValue() external view returns (bytes32);
+}

package/contracts/interfaces/0.8.x/IAdminACLV0.sol

@@ -0,0 +1,51 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+interface IAdminACLV0 {
+    /**
+     * @notice Token ID `_tokenId` minted to `_to`.
+     * @param previousSuperAdmin The previous superAdmin address.
+     * @param newSuperAdmin The new superAdmin address.
+     * @param genArt721CoreAddressesToUpdate Array of genArt721Core
+     * addresses to update to the new superAdmin, for indexing purposes only.
+     */
+    event SuperAdminTransferred(
+        address indexed previousSuperAdmin,
+        address indexed newSuperAdmin,
+        address[] genArt721CoreAddressesToUpdate
+    );
+
+    /// Type of the Admin ACL contract, e.g. "AdminACLV0"
+    function AdminACLType() external view returns (string memory);
+
+    /// super admin address
+    function superAdmin() external view returns (address);
+
+    /**
+     * @notice Calls transferOwnership on other contract from this contract.
+     * This is useful for updating to a new AdminACL contract.
+     * @dev this function should be gated to only superAdmin-like addresses.
+     */
+    function transferOwnershipOn(
+        address _contract,
+        address _newAdminACL
+    ) external;
+
+    /**
+     * @notice Calls renounceOwnership on other contract from this contract.
+     * @dev this function should be gated to only superAdmin-like addresses.
+     */
+    function renounceOwnershipOn(address _contract) external;
+
+    /**
+     * @notice Checks if sender `_sender` is allowed to call function with selector
+     * `_selector` on contract `_contract`.
+     */
+    function allowed(
+        address _sender,
+        address _contract,
+        bytes4 _selector
+    ) external returns (bool);
+}

package/contracts/interfaces/0.8.x/IArtblocksRoyaltyOverride.sol

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+
+import "@openzeppelin-4.5/contracts/utils/introspection/IERC165.sol";
+
+pragma solidity ^0.8.0;
+
+/**
+ * @notice Interface for Art Blocks Royalty override.
+ * Supported by the Royalty Registry v1 Engine.
+ * @dev  ref: https://royaltyregistry.xyz / engine-v1.royaltyregistry.eth
+ */
+interface IArtblocksRoyaltyOverride is IERC165 {
+    /**
+     * @notice Gets royalites of token ID `_tokenId` on token contract
+     * `_tokenAddress`.
+     * @param tokenAddress Token contract to be queried.
+     * @param tokenId Token ID to be queried.
+     * @return recipients_ array of royalty recipients
+     * @return bps array of basis points for each recipient, aligned by index
+     * @dev Interface ID:
+     *
+     * bytes4(keccak256('getRoyalties(address,uint256)')) == 0x9ca7dc7a
+     *
+     * => 0x9ca7dc7a = 0x9ca7dc7a
+     */
+    function getRoyalties(
+        address tokenAddress,
+        uint256 tokenId
+    )
+        external
+        view
+        returns (address payable[] memory recipients_, uint256[] memory bps);
+}

package/contracts/interfaces/0.8.x/IBonusContract.sol

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Creatd By: Art Blocks Inc.
+
+pragma solidity ^0.8.0;
+
+interface IBonusContract {
+    function triggerBonus(address _to) external returns (bool);
+
+    function bonusIsActive() external view returns (bool);
+}

package/contracts/interfaces/0.8.x/IDelegationRegistry.sol

@@ -0,0 +1,221 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.17;
+
+/// @dev Source: https://github.com/0xfoobar/delegation-registry/blob/main/src/IDelegationRegistry.sol
+
+/**
+ * @title An immutable registry contract to be deployed as a standalone primitive
+ * @dev See EIP-5639, new project launches can read previous cold wallet -> hot wallet delegations
+ * from here and integrate those permissions into their flow
+ */
+interface IDelegationRegistry {
+    /// @notice Delegation type
+    enum DelegationType {
+        NONE,
+        ALL,
+        CONTRACT,
+        TOKEN
+    }
+
+    /// @notice Info about a single delegation, used for onchain enumeration
+    struct DelegationInfo {
+        DelegationType type_;
+        address vault;
+        address delegate;
+        address contract_;
+        uint256 tokenId;
+    }
+
+    /// @notice Info about a single contract-level delegation
+    struct ContractDelegation {
+        address contract_;
+        address delegate;
+    }
+
+    /// @notice Info about a single token-level delegation
+    struct TokenDelegation {
+        address contract_;
+        uint256 tokenId;
+        address delegate;
+    }
+
+    /// @notice Emitted when a user delegates their entire wallet
+    event DelegateForAll(address vault, address delegate, bool value);
+
+    /// @notice Emitted when a user delegates a specific contract
+    event DelegateForContract(
+        address vault,
+        address delegate,
+        address contract_,
+        bool value
+    );
+
+    /// @notice Emitted when a user delegates a specific token
+    event DelegateForToken(
+        address vault,
+        address delegate,
+        address contract_,
+        uint256 tokenId,
+        bool value
+    );
+
+    /// @notice Emitted when a user revokes all delegations
+    event RevokeAllDelegates(address vault);
+
+    /// @notice Emitted when a user revoes all delegations for a given delegate
+    event RevokeDelegate(address vault, address delegate);
+
+    /**
+     * -----------  WRITE -----------
+     */
+
+    /**
+     * @notice Allow the delegate to act on your behalf for all contracts
+     * @param delegate The hotwallet to act on your behalf
+     * @param value Whether to enable or disable delegation for this address, true for setting and false for revoking
+     */
+    function delegateForAll(address delegate, bool value) external;
+
+    /**
+     * @notice Allow the delegate to act on your behalf for a specific contract
+     * @param delegate The hotwallet to act on your behalf
+     * @param contract_ The address for the contract you're delegating
+     * @param value Whether to enable or disable delegation for this address, true for setting and false for revoking
+     */
+    function delegateForContract(
+        address delegate,
+        address contract_,
+        bool value
+    ) external;
+
+    /**
+     * @notice Allow the delegate to act on your behalf for a specific token
+     * @param delegate The hotwallet to act on your behalf
+     * @param contract_ The address for the contract you're delegating
+     * @param tokenId The token id for the token you're delegating
+     * @param value Whether to enable or disable delegation for this address, true for setting and false for revoking
+     */
+    function delegateForToken(
+        address delegate,
+        address contract_,
+        uint256 tokenId,
+        bool value
+    ) external;
+
+    /**
+     * @notice Revoke all delegates
+     */
+    function revokeAllDelegates() external;
+
+    /**
+     * @notice Revoke a specific delegate for all their permissions
+     * @param delegate The hotwallet to revoke
+     */
+    function revokeDelegate(address delegate) external;
+
+    /**
+     * @notice Remove yourself as a delegate for a specific vault
+     * @param vault The vault which delegated to the msg.sender, and should be removed
+     */
+    function revokeSelf(address vault) external;
+
+    /**
+     * -----------  READ -----------
+     */
+
+    /**
+     * @notice Returns all active delegations a given delegate is able to claim on behalf of
+     * @param delegate The delegate that you would like to retrieve delegations for
+     * @return info Array of DelegationInfo structs
+     */
+    function getDelegationsByDelegate(
+        address delegate
+    ) external view returns (DelegationInfo[] memory);
+
+    /**
+     * @notice Returns an array of wallet-level delegates for a given vault
+     * @param vault The cold wallet who issued the delegation
+     * @return addresses Array of wallet-level delegates for a given vault
+     */
+    function getDelegatesForAll(
+        address vault
+    ) external view returns (address[] memory);
+
+    /**
+     * @notice Returns an array of contract-level delegates for a given vault and contract
+     * @param vault The cold wallet who issued the delegation
+     * @param contract_ The address for the contract you're delegating
+     * @return addresses Array of contract-level delegates for a given vault and contract
+     */
+    function getDelegatesForContract(
+        address vault,
+        address contract_
+    ) external view returns (address[] memory);
+
+    /**
+     * @notice Returns an array of contract-level delegates for a given vault's token
+     * @param vault The cold wallet who issued the delegation
+     * @param contract_ The address for the contract holding the token
+     * @param tokenId The token id for the token you're delegating
+     * @return addresses Array of contract-level delegates for a given vault's token
+     */
+    function getDelegatesForToken(
+        address vault,
+        address contract_,
+        uint256 tokenId
+    ) external view returns (address[] memory);
+
+    /**
+     * @notice Returns all contract-level delegations for a given vault
+     * @param vault The cold wallet who issued the delegations
+     * @return delegations Array of ContractDelegation structs
+     */
+    function getContractLevelDelegations(
+        address vault
+    ) external view returns (ContractDelegation[] memory delegations);
+
+    /**
+     * @notice Returns all token-level delegations for a given vault
+     * @param vault The cold wallet who issued the delegations
+     * @return delegations Array of TokenDelegation structs
+     */
+    function getTokenLevelDelegations(
+        address vault
+    ) external view returns (TokenDelegation[] memory delegations);
+
+    /**
+     * @notice Returns true if the address is delegated to act on the entire vault
+     * @param delegate The hotwallet to act on your behalf
+     * @param vault The cold wallet who issued the delegation
+     */
+    function checkDelegateForAll(
+        address delegate,
+        address vault
+    ) external view returns (bool);
+
+    /**
+     * @notice Returns true if the address is delegated to act on your behalf for a token contract or an entire vault
+     * @param delegate The hotwallet to act on your behalf
+     * @param contract_ The address for the contract you're delegating
+     * @param vault The cold wallet who issued the delegation
+     */
+    function checkDelegateForContract(
+        address delegate,
+        address vault,
+        address contract_
+    ) external view returns (bool);
+
+    /**
+     * @notice Returns true if the address is delegated to act on your behalf for a specific token, the token's contract or an entire vault
+     * @param delegate The hotwallet to act on your behalf
+     * @param contract_ The address for the contract you're delegating
+     * @param tokenId The token id for the token you're delegating
+     * @param vault The cold wallet who issued the delegation
+     */
+    function checkDelegateForToken(
+        address delegate,
+        address vault,
+        address contract_,
+        uint256 tokenId
+    ) external view returns (bool);
+}

package/contracts/interfaces/0.8.x/IDependencyRegistryCompatibleV0.sol

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+pragma solidity ^0.8.17;
+
+interface IDependencyRegistryCompatibleV0 {
+    /// Dependency registry managed by Art Blocks
+    function artblocksDependencyRegistryAddress()
+        external
+        view
+        returns (address);
+
+    /**
+     * @notice Returns script information for project `_projectId`.
+     * @param _projectId Project to be queried.
+     * @return scriptTypeAndVersion Project's script type and version
+     * (e.g. "p5js(atSymbol)1.0.0")
+     * @return aspectRatio Aspect ratio of project (e.g. "1" for square,
+     * "1.77777778" for 16:9, etc.)
+     * @return scriptCount Count of scripts for project
+     */
+    function projectScriptDetails(
+        uint256 _projectId
+    )
+        external
+        view
+        returns (
+            string memory scriptTypeAndVersion,
+            string memory aspectRatio,
+            uint256 scriptCount
+        );
+}

package/contracts/interfaces/0.8.x/IDependencyRegistryV0.sol

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+pragma solidity ^0.8.17;
+
+interface IDependencyRegistryV0 {
+    event SupportedCoreContractAdded(address indexed _coreContractAddress);
+
+    event SupportedCoreContractRemoved(address indexed _coreContractAddress);
+
+    event ProjectDependencyTypeOverrideAdded(
+        address indexed _coreContractAddress,
+        uint256 indexed _projectId,
+        bytes32 _dependencyType
+    );
+
+    event ProjectDependencyTypeOverrideRemoved(
+        address indexed _coreContractAddress,
+        uint256 indexed _projectId
+    );
+
+    event DependencyAdded(
+        bytes32 indexed _dependencyType,
+        string _preferredCDN,
+        string _preferredRepository,
+        string _referenceWebsite
+    );
+
+    event DependencyRemoved(bytes32 indexed _dependencyType);
+
+    event DependencyReferenceWebsiteUpdated(
+        bytes32 indexed _dependencyType,
+        string _referenceWebsite
+    );
+
+    event DependencyPreferredCDNUpdated(
+        bytes32 indexed _dependencyType,
+        string _preferredCDN
+    );
+
+    event DependencyPreferredRepositoryUpdated(
+        bytes32 indexed _dependencyType,
+        string _preferredRepository
+    );
+
+    event DependencyAdditionalCDNUpdated(
+        bytes32 indexed _dependencyType,
+        string _additionalCDN,
+        uint256 _additionalCDNIndex
+    );
+
+    event DependencyAdditionalCDNRemoved(
+        bytes32 indexed _dependencyType,
+        uint256 indexed _additionalCDNIndex
+    );
+
+    event DependencyAdditionalRepositoryUpdated(
+        bytes32 indexed _dependencyType,
+        string _additionalRepository,
+        uint256 _additionalRepositoryIndex
+    );
+
+    event DependencyAdditionalRepositoryRemoved(
+        bytes32 indexed _dependencyType,
+        uint256 indexed _additionalRepositoryIndex
+    );
+
+    event DependencyScriptUpdated(bytes32 indexed _dependencyType);
+
+    /**
+     * @notice Returns the count of scripts for dependency `_dependencyType`.
+     * @param _dependencyType Dependency type to be queried.
+     */
+    function getDependencyScriptCount(
+        bytes32 _dependencyType
+    ) external view returns (uint256);
+
+    /**
+     * @notice Returns address with bytecode containing script for
+     * dependency type `_dependencyTypes` at script index `_index`.
+     */
+    function getDependencyScriptBytecodeAddressAtIndex(
+        bytes32 _dependencyType,
+        uint256 _index
+    ) external view returns (address);
+
+    /**
+     * @notice Returns script for dependency type `_dependencyType` at script index `_index`.
+     * @param _dependencyType Dependency type to be queried.
+     * @param _index Index of script to be queried.
+     */
+    function getDependencyScriptAtIndex(
+        bytes32 _dependencyType,
+        uint256 _index
+    ) external view returns (string memory);
+}

package/contracts/interfaces/0.8.x/IEngineRegistryV0.sol

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Created By: Art Blocks Inc.
+pragma solidity ^0.8.17;
+
+interface IEngineRegistryV0 {
+    /// ADDRESS
+    /**
+     * @notice contract has been registered as a contract that is powered by the Art Blocks Engine.
+     */
+    event ContractRegistered(
+        address indexed _contractAddress,
+        bytes32 _coreVersion,
+        bytes32 _coreType
+    );
+
+    /// ADDRESS
+    /**
+     * @notice contract has been unregistered as a contract that is powered by the Art Blocks Engine.
+     */
+    event ContractUnregistered(address indexed _contractAddress);
+
+    /**
+     * @notice Emits a `ContractRegistered` event with the provided information.
+     * @dev this function should be gated to only deployer addresses.
+     */
+    function registerContract(
+        address _contractAddress,
+        bytes32 _coreVersion,
+        bytes32 _coreType
+    ) external;
+
+    /**
+     * @notice Emits a `ContractUnregistered` event with the provided information, validating that the provided
+     *         address was indeed previously registered.
+     * @dev this function should be gated to only deployer addresses.
+     */
+    function unregisterContract(address _contractAddress) external;
+}