Feature Tip: Add private address tag to any address under My Name Tag !
ERC-721
Overview
Max Total Supply
785 GRAILS5
Holders
522
Market
Volume (24H)
N/A
Min Price (24H)
N/A
Max Price (24H)
N/A
Other Info
Token Contract
Balance
0 GRAILS5Loading...
Loading
Loading...
Loading
Loading...
Loading
# | Exchange | Pair | Price | 24H Volume | % Volume |
---|
Contract Name:
Grails5
Compiler Version
v0.8.21+commit.d9974bed
Optimization Enabled:
Yes with 9999 runs
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT // Copyright 2023 SolidifyLabs pragma solidity ^0.8.15; import {Address} from "openzeppelin-contracts/utils/Address.sol"; import {IGenArt721CoreContractV3_Mintable} from "solidifylabs/artblocks/IGenArt721CoreContractV3_Mintable.sol"; import { GenArt721CoreV3_Engine_Flex_PROOF, ArtblocksWithMinterFilterV2ProjectPoolSellable, ArtblocksProjectPoolSellable, MinterFilterV2, ProjectPoolSellable } from "solidifylabs/presets/pool/ArtblocksProjectPoolSellable.sol"; /** * @notice Grails V * @author David Huber (@cxkoda) * @custom:reviewer Arran Schlosberg (@divergencearran) */ contract Grails5 is ArtblocksWithMinterFilterV2ProjectPoolSellable { using Address for address payable; // ================================================================================================================= // Constants // ================================================================================================================= uint256 internal immutable _project13ArtblocksProjectId; // ================================================================================================================= // Storage // ================================================================================================================= address payable public primaryReceiver; // ================================================================================================================= // Construction // ================================================================================================================= constructor( ProjectPoolSellable.Init memory init, GenArt721CoreV3_Engine_Flex_PROOF flex_, MinterFilterV2 filter_, address payable primaryReceiver_, uint256 project13ArtblocksProjectId ) ArtblocksWithMinterFilterV2ProjectPoolSellable(init, flex_, filter_) { primaryReceiver = primaryReceiver_; _project13ArtblocksProjectId = project13ArtblocksProjectId; } /** * @inheritdoc ArtblocksProjectPoolSellable */ function _isLongformProject(uint128 projectId) internal view virtual override returns (bool) { return projectId == 13; } function isLongformProject(uint128 projectId) external view returns (bool) { return _isLongformProject(projectId); } /** * @inheritdoc ArtblocksProjectPoolSellable * @dev This function is tightly coupled to the implementation of `_isLongformProject`. Any changes there MUST be * reflected here. */ function _artblocksProjectId(uint128 projectId) internal view virtual override returns (uint256) { assert(_isLongformProject(projectId)); // This is safe since we only have one ArtBlock project. return _project13ArtblocksProjectId; } function artblocksProjectId(uint128 projectId) external view returns (uint256) { return _artblocksProjectId(projectId); } /** * @inheritdoc ProjectPoolSellable */ function _numProjects() internal view virtual override returns (uint128) { return 18; } /** * @notice Returns the number of projects. */ function numProjects() external view returns (uint128) { return _numProjects(); } /** * @inheritdoc ProjectPoolSellable */ function _maxNumPerProject(uint128 projectId) internal view virtual override returns (uint64) { return [180, 50, 50, 50, 50, 50, 50, 50, 50, 50, 50, 50, 36, 150, 50, 50, 50, 150][projectId]; } /** * @notice Returns the max number of tokens per project. */ function maxNumPerProject(uint128 projectId) external view returns (uint64) { return _maxNumPerProject(projectId); } function _handleSale(address to, uint64 num, bytes calldata data) internal virtual override { super._handleSale(to, num, data); primaryReceiver.sendValue(msg.value); } /** * @notice Set the primary receiver of funds */ function setPrimaryReceiver(address payable newPrimaryReceiver) public onlyRole(DEFAULT_STEERING_ROLE) { primaryReceiver = newPrimaryReceiver; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value ) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract. * * _Available since v4.8._ */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata, string memory errorMessage ) internal view returns (bytes memory) { if (success) { if (returndata.length == 0) { // only check isContract if the call was successful and the return data is empty // otherwise we already know that it was a contract require(isContract(target), "Address: call to non-contract"); } return returndata; } else { _revert(returndata, errorMessage); } } /** * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason or using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { _revert(returndata, errorMessage); } } function _revert(bytes memory returndata, string memory errorMessage) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } }
// SPDX-License-Identifier: MIT pragma solidity >=0.8.0; /** * @notice IGenArt721CoreContractV3 minting interface */ interface IGenArt721CoreContractV3_Mintable { function mint_Ecf(address to, uint256 projectId, address sender) external returns (uint256 _tokenId); }
// SPDX-License-Identifier: MIT // Copyright 2023 PROOF Holdings Inc pragma solidity ^0.8.15; import {ERC721A} from "ethier/erc721/ERC721ACommon.sol"; import {GenArt721CoreV3_Engine_Flex_PROOF} from "artblocks-contracts/engine/V3/forks/GenArt721CoreV3_Engine_Flex_PROOF.sol"; import {MinterFilterV2} from "artblocks-contracts/minter-suite/MinterFilter/MinterFilterV2.sol"; import {ISharedMinterRequired} from "artblocks-contracts/interfaces/v0.8.x/ISharedMinterRequired.sol"; import {artblocksTokenID} from "solidifylabs/artblocks/TokenIDMapping.sol"; import {IGenArt721CoreContractV3_Mintable} from "solidifylabs/artblocks/IGenArt721CoreContractV3_Mintable.sol"; import {ProjectPoolSellable} from "./ProjectPoolSellable.sol"; /** * @title ArtBlocks enabled Project Pool Sellable * @notice A pool of sequentially indexed, sellable projects with ArtBlocks support and max supply * @author David Huber (@cxkoda) * @custom:reviewer Arran Schlosberg (@divergencearran) * @custom:reviewer Josh Laird (@jbmlaird) */ abstract contract ArtblocksProjectPoolSellable is ProjectPoolSellable { // ================================================================================================================= // Constants // ================================================================================================================= /** * @notice The ArtBlocks engine flex contract. */ GenArt721CoreV3_Engine_Flex_PROOF public immutable flex; // ================================================================================================================= // Construction // ================================================================================================================= constructor(Init memory init, GenArt721CoreV3_Engine_Flex_PROOF flex_) ProjectPoolSellable(init) { flex = flex_; } // ================================================================================================================= // Configuration // ================================================================================================================= /** * @notice Returns true iff the project is a longform project. */ function _isLongformProject(uint128 projectId) internal view virtual returns (bool); /** * @notice Returns the ArtBlocks engine project IDs for the longform projects. */ function _artblocksProjectId(uint128 projectId) internal view virtual returns (uint256); // ================================================================================================================= // Selling // ================================================================================================================= /** * @notice Handles the minting of a token from a given project. * @dev Mints from the associated ArtBlocks project if the project is a longform project and locks the token in the * contract. */ function _handleProjectMinted(uint256 tokenId, uint128 projectId, uint64 edition) internal virtual override { super._handleProjectMinted(tokenId, projectId, edition); if (_isLongformProject(projectId)) { _mintArtblocksToken(_artblocksProjectId(projectId)); } } function _mintArtblocksToken(uint256 artblocksProjectId) internal virtual; // ================================================================================================================= // Metadata // ================================================================================================================= /** * @inheritdoc ERC721A */ function tokenURI(uint256 tokenId) public view virtual override returns (string memory) { TokenInfo memory info = tokenInfo(tokenId); if (_isLongformProject(info.projectId)) { return flex.tokenURI(artblocksTokenID(_artblocksProjectId(info.projectId), info.edition)); } return super.tokenURI(tokenId); } /** * @notice Helper function that returns true if the token belongs to a longform project. */ function _isLongformToken(uint256 tokenId) internal view virtual returns (bool) { return _isLongformProject(tokenInfo(tokenId).projectId); } // ================================================================================================================= // Inheritance resolution // ================================================================================================================= // Artblocks does not permit partners to have operator filtering on any of their tokens (even if they are wrapped // like in this contract). We therefore selectively enable/disable the filtering based on the project type. function transferFrom(address from, address to, uint256 tokenId) public payable virtual override { if (_isLongformToken(tokenId)) { ERC721A.transferFrom(from, to, tokenId); } else { ProjectPoolSellable.transferFrom(from, to, tokenId); } } function safeTransferFrom(address from, address to, uint256 tokenId) public payable virtual override { if (_isLongformToken(tokenId)) { ERC721A.safeTransferFrom(from, to, tokenId); } else { ProjectPoolSellable.safeTransferFrom(from, to, tokenId); } } function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public payable virtual override { if (_isLongformToken(tokenId)) { ERC721A.safeTransferFrom(from, to, tokenId, data); } else { ProjectPoolSellable.safeTransferFrom(from, to, tokenId, data); } } function approve(address operator, uint256 tokenId) public payable virtual override { if (_isLongformToken(tokenId)) { ERC721A.approve(operator, tokenId); } else { ProjectPoolSellable.approve(operator, tokenId); } } function setApprovalForAll(address operator, bool approved) public virtual override { // Excluding any filtering here since `approvalForAll` will also affect Artblocks tokens. ERC721A.setApprovalForAll(operator, approved); } } abstract contract ArtblocksCoreV3MintableProjectPoolSellable is ArtblocksProjectPoolSellable { /** * @notice The ArtBlocks engine flex contract or a minter multiplexer. */ IGenArt721CoreContractV3_Mintable public immutable flexMintGateway; constructor( Init memory init, GenArt721CoreV3_Engine_Flex_PROOF flex_, IGenArt721CoreContractV3_Mintable flexMintGateway_ ) ArtblocksProjectPoolSellable(init, flex_) { flexMintGateway = flexMintGateway_; } function _mintArtblocksToken(uint256 artblocksProjectId) internal virtual override { flexMintGateway.mint_Ecf({to: address(this), projectId: artblocksProjectId, sender: address(this)}); } } abstract contract ArtblocksWithMinterFilterV2ProjectPoolSellable is ArtblocksProjectPoolSellable, ISharedMinterRequired { /** */ MinterFilterV2 public immutable minterFilter; constructor(Init memory init, GenArt721CoreV3_Engine_Flex_PROOF flex_, MinterFilterV2 minterFilter_) ArtblocksProjectPoolSellable(init, flex_) { minterFilter = minterFilter_; } function _mintArtblocksToken(uint256 artblocksProjectId) internal virtual override { minterFilter.mint_joo({ to: address(this), projectId: artblocksProjectId, coreContract: address(flex), sender: address(this) }); } function minterType() external pure returns (string memory) { return "ArtblocksWithMinterFilterV2ProjectPoolSellable"; } function minterFilterAddress() external view returns (address) { return address(minterFilter); } }
// SPDX-License-Identifier: MIT // Copyright (c) 2022 the ethier authors (github.com/divergencetech/ethier) pragma solidity >=0.8.0 <0.9.0; import {ERC721A} from "erc721a/contracts/ERC721A.sol"; import {ERC2981} from "@openzeppelin/contracts/token/common/ERC2981.sol"; import {AccessControlEnumerable} from "../utils/AccessControlEnumerable.sol"; import {AccessControlPausable} from "../utils/AccessControlPausable.sol"; import {ERC4906} from "./ERC4906.sol"; /** @notice An ERC721A contract with common functionality: - Pausable with toggling functions exposed to Owner only - ERC2981 royalties */ contract ERC721ACommon is ERC721A, AccessControlPausable, ERC2981, ERC4906 { constructor( address admin, address steerer, string memory name, string memory symbol, address payable royaltyReciever, uint96 royaltyBasisPoints ) ERC721A(name, symbol) { _setDefaultRoyalty(royaltyReciever, royaltyBasisPoints); _grantRole(DEFAULT_ADMIN_ROLE, admin); _grantRole(DEFAULT_STEERING_ROLE, steerer); } /// @notice Requires that the token exists. modifier tokenExists(uint256 tokenId) { require(ERC721A._exists(tokenId), "ERC721ACommon: Token doesn't exist"); _; } /// @notice Requires that msg.sender owns or is approved for the token. modifier onlyApprovedOrOwner(uint256 tokenId) { require( _ownershipOf(tokenId).addr == _msgSender() || getApproved(tokenId) == _msgSender(), "ERC721ACommon: Not approved nor owner" ); _; } function _beforeTokenTransfers( address from, address to, uint256 startTokenId, uint256 quantity ) internal virtual override { require(!paused(), "ERC721ACommon: paused"); super._beforeTokenTransfers(from, to, startTokenId, quantity); } /// @notice Overrides supportsInterface as required by inheritance. function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721A, AccessControlEnumerable, ERC2981, ERC4906) returns (bool) { return ERC721A.supportsInterface(interfaceId) || ERC2981.supportsInterface(interfaceId) || AccessControlEnumerable.supportsInterface(interfaceId) || ERC4906.supportsInterface(interfaceId); } /// @notice Sets the royalty receiver and percentage (in units of basis /// points = 0.01%). function setDefaultRoyalty(address receiver, uint96 basisPoints) public virtual onlyRole(DEFAULT_STEERING_ROLE) { _setDefaultRoyalty(receiver, basisPoints); } function emitMetadataUpdateForAll() external onlyRole(DEFAULT_STEERING_ROLE) { // EIP4906 is unfortunately quite vague on whether the `toTokenId` in // the following event is included or not. We hence use `totalSupply()` // to ensure that the last actual `tokenId` is included in any case. _refreshMetadata(0, totalSupply()); } }
// SPDX-License-Identifier: LGPL-3.0-only pragma solidity ^0.8.17; // Created By: Art Blocks Inc. import "../../../interfaces/v0.8.x/IRandomizerV2.sol"; import "../../../interfaces/v0.8.x/IAdminACLV0.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/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. * @author Art Blocks Inc. * @notice Privileged Roles and Ownership: * This contract is designed to be managed, with progressively limited powers * as a project progresses from active to locked. * Privileged roles and abilities are controlled by the admin ACL contract and * artists. Both of these roles hold extensive power and can arbitrarily * control and modify portions of projects, dependent upon project state. After * a project is locked, important project metadata fields are locked including * the project name, artist name, and script and display details. Edition size * can never be increased. * Care must be taken to ensure that the admin ACL contract and artist * addresses are secure behind a multi-sig or other access control mechanism. * ---------------------------------------------------------------------------- * The following functions are restricted to the Admin ACL contract: * - updateArtblocksDependencyRegistryAddress * - updateProviderSalesAddresses * - updateProviderPrimarySalesPercentages (up to 100%) * - updateProviderSecondarySalesBPS (up to 100%) * - updateMinterContract * - updateRandomizerAddress * - toggleProjectIsActive * - addProject * - forbidNewProjects (forever forbidding new projects) * - updateDefaultBaseURI (used to initialize new project base URIs) * - updateIPFSGateway * - updateArweaveGateway * ---------------------------------------------------------------------------- * The following functions are restricted to either the the Artist address or * the Admin ACL contract, only when the project is not locked: * - updateProjectName * - updateProjectArtistName * - updateProjectLicense * - Change project script via addProjectScript, updateProjectScript, * and removeProjectLastScript * - updateProjectScriptType * - updateProjectAspectRatio * ---------------------------------------------------------------------------- * The following functions are restricted to only the Artist or Admin ACL * contract of a valid project ID: * - proposeArtistPaymentAddressesAndSplits (Note that this has to be accepted * by adminAcceptArtistAddressesAndSplits to take effect, which is restricted * to the Admin ACL contract, or the artist if the core contract owner has * renounced ownership. Also note that a proposal will be automatically * accepted if the artist only proposes changed payee percentages without * modifying any payee addresses, or is only removing payee addresses, or * if the global config `autoApproveArtistSplitProposals` is set to `true`.) * - toggleProjectIsPaused (note the artist can still mint while paused) * - updateProjectSecondaryMarketRoyaltyPercentage (up to * ARTIST_MAX_SECONDARY_ROYALTY_PERCENTAGE percent) * - updateProjectWebsite * - updateProjectMaxInvocations (to a number greater than or equal to the * current number of invocations, and less than current project maximum * invocations) * - updateProjectBaseURI (controlling the base URI for tokens in the project) * ---------------------------------------------------------------------------- * The following function is restricted to either the Admin ACL contract, or * the Artist address if the core contract owner has renounced ownership: * - adminAcceptArtistAddressesAndSplits * - updateProjectArtistAddress (owner ultimately controlling the project and * its and-on revenue, unless owner has renounced ownership) * ---------------------------------------------------------------------------- * The following function is restricted to the artist when a project is * unlocked, and only callable by Admin ACL contract when a project is locked: * - updateProjectDescription * ---------------------------------------------------------------------------- * The following functions for managing external asset dependencies are restricted * to projects with external asset dependencies that are unlocked: * - lockProjectExternalAssetDependencies * - updateProjectExternalAssetDependency * - removeProjectExternalAssetDependency * - addProjectExternalAssetDependency * ---------------------------------------------------------------------------- * The following function is restricted to owner calling directly: * - transferOwnership * - renounceOwnership * ---------------------------------------------------------------------------- * The following configuration variables are set at time of contract deployment, * and not modifiable thereafter (immutable after the point of deployment): * - (bool) autoApproveArtistSplitProposals * ---------------------------------------------------------------------------- * Additional admin and artist privileged roles may be described on minters, * registries, and other contracts that may interact with this core contract. */ contract GenArt721CoreV3_Engine_Flex_PROOF is ERC721_PackedHashSeed, Ownable, IDependencyRegistryCompatibleV0, IManifold, IGenArt721CoreContractV3_Engine_Flex { using BytecodeStorageWriter for string; using Bytes32Strings for bytes32; uint256 constant ONE_HUNDRED = 100; uint256 constant ONE_MILLION = 1_000_000; uint24 constant ONE_MILLION_UINT24 = 1_000_000; uint256 constant FOUR_WEEKS_IN_SECONDS = 2_419_200; uint8 constant AT_CHARACTER_CODE = uint8(bytes1("@")); // 0x40 // numeric constants uint256 constant MAX_PROVIDER_SECONDARY_SALES_BPS = 10000; // 10_000 BPS = 100% uint256 constant ARTIST_MAX_SECONDARY_ROYALTY_PERCENTAGE = 95; // 95% // This contract 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. // // The following fields are used to indicate which contract-level parameter // has been updated in the `PlatformUpdated` event: bytes32 constant FIELD_NEXT_PROJECT_ID = "nextProjectId"; bytes32 constant FIELD_NEW_PROJECTS_FORBIDDEN = "newProjectsForbidden"; bytes32 constant FIELD_DEFAULT_BASE_URI = "defaultBaseURI"; bytes32 constant FIELD_RANDOMIZER_ADDRESS = "randomizerAddress"; bytes32 constant FIELD_ARTBLOCKS_DEPENDENCY_REGISTRY_ADDRESS = "dependencyRegistryAddress"; bytes32 constant FIELD_PROVIDER_SALES_ADDRESSES = "providerSalesAddresses"; bytes32 constant FIELD_PROVIDER_PRIMARY_SALES_PERCENTAGES = "providerPrimaryPercentages"; bytes32 constant FIELD_PROVIDER_SECONDARY_SALES_BPS = "providerSecondaryBPS"; // The following fields are used to indicate which project-level parameter // has been updated in the `ProjectUpdated` event: bytes32 constant FIELD_PROJECT_COMPLETED = "completed"; bytes32 constant FIELD_PROJECT_ACTIVE = "active"; bytes32 constant FIELD_PROJECT_ARTIST_ADDRESS = "artistAddress"; bytes32 constant FIELD_PROJECT_PAUSED = "paused"; bytes32 constant FIELD_PROJECT_CREATED = "created"; bytes32 constant FIELD_PROJECT_NAME = "name"; bytes32 constant FIELD_PROJECT_ARTIST_NAME = "artistName"; bytes32 constant FIELD_PROJECT_SECONDARY_MARKET_ROYALTY_PERCENTAGE = "royaltyPercentage"; bytes32 constant FIELD_PROJECT_DESCRIPTION = "description"; bytes32 constant FIELD_PROJECT_WEBSITE = "website"; bytes32 constant FIELD_PROJECT_LICENSE = "license"; bytes32 constant FIELD_PROJECT_MAX_INVOCATIONS = "maxInvocations"; bytes32 constant FIELD_PROJECT_SCRIPT = "script"; bytes32 constant FIELD_PROJECT_SCRIPT_TYPE = "scriptType"; bytes32 constant FIELD_PROJECT_ASPECT_RATIO = "aspectRatio"; bytes32 constant FIELD_PROJECT_BASE_URI = "baseURI"; /// Dependency registry managed by Art Blocks address public artblocksDependencyRegistryAddress; /// current randomizer contract IRandomizerV2 public randomizerContract; /// append-only array of all randomizer contract addresses ever used by /// this contract address[] private _historicalRandomizerAddresses; /// admin ACL contract IAdminACLV0 public adminACLContract; struct Project { uint24 invocations; uint24 maxInvocations; uint24 scriptCount; // max uint64 ~= 1.8e19 sec ~= 570 billion years uint64 completedTimestamp; bool active; bool paused; string name; string artist; string description; string website; string license; string projectBaseURI; bytes32 scriptTypeAndVersion; string aspectRatio; // mapping from script index to address storing script in bytecode mapping(uint256 => address) scriptBytecodeAddresses; bool externalAssetDependenciesLocked; uint24 externalAssetDependencyCount; mapping(uint256 => ExternalAssetDependency) externalAssetDependencies; } mapping(uint256 => Project) projects; string public preferredIPFSGateway; string public preferredArweaveGateway; /// 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; } // Project financials mapping mapping(uint256 => ProjectFinance) projectIdToFinancials; /// hash of artist's proposed payment updates to be approved by admin mapping(uint256 => bytes32) public proposedArtistAddressesAndSplitsHash; /// The render provider payment address for all primary sales revenues /// (packed) address payable public renderProviderPrimarySalesAddress; /// Percentage of primary sales revenue allocated to the render provider /// (packed) // packed uint: max of 100, max uint8 = 255 uint8 private _renderProviderPrimarySalesPercentage = 10; /// The platform provider payment address for all primary sales revenues /// (packed) address payable public platformProviderPrimarySalesAddress; /// Percentage of primary sales revenue allocated to the platform provider /// (packed) // packed uint: max of 100, max uint8 = 255 uint8 private _platformProviderPrimarySalesPercentage = 10; /// The render provider payment address for all secondary sales royalty /// revenues address payable public renderProviderSecondarySalesAddress; /// Basis Points of secondary sales royalties allocated to the /// render provider uint256 public renderProviderSecondarySalesBPS = 250; /// The platform provider payment address for all secondary sales royalty /// revenues address payable public platformProviderSecondarySalesAddress; /// Basis Points of secondary sales royalties allocated to the /// platform provider uint256 public platformProviderSecondarySalesBPS = 250; /// single minter allowed for this core contract address public minterContract; /// starting (initial) project ID on this contract uint256 public immutable startingProjectId; /// next project ID to be created uint248 private _nextProjectId; /// bool indicating if adding new projects is forbidden; /// default behavior is to allow new projects bool public newProjectsForbidden; /// configuration variable (determined at time of deployment) /// that determines whether or not admin approval^ should be required /// to accept artist address change proposals, or if these proposals /// should always auto-approve, as determined by the business process /// requirements of the Engine partner using this contract. /// /// ^does not apply in the case where contract-ownership itself is revoked bool public immutable autoApproveArtistSplitProposals; /// version & type of this core contract bytes32 constant CORE_VERSION = "v3.1.6"; function coreVersion() external pure returns (string memory) { return CORE_VERSION.toString(); } bytes32 constant CORE_TYPE = "GenArt721CoreV3_Engine_Flex"; function coreType() external pure returns (string memory) { return CORE_TYPE.toString(); } /// default base URI to initialize all new project projectBaseURI values to string public defaultBaseURI; function _onlyUnlockedProjectExternalAssetDependencies( uint256 _projectId ) internal view { require( !projects[_projectId].externalAssetDependenciesLocked, "External dependencies locked" ); } function _onlyNonZeroAddress(address _address) internal pure { require(_address != address(0), "Must input non-zero address"); } function _onlyNonEmptyString(string memory _string) internal pure { require(bytes(_string).length != 0, "Must input non-empty string"); } function _onlyValidTokenId(uint256 _tokenId) internal view { require(_exists(_tokenId), "Token ID does not exist"); } function _onlyValidProjectId(uint256 _projectId) internal view { require( (_projectId >= startingProjectId) && (_projectId < _nextProjectId), "Project ID does not exist" ); } function _onlyUnlocked(uint256 _projectId) internal view { // Note: calling `_projectUnlocked` enforces that the `_projectId` // passed in is valid.` require(_projectUnlocked(_projectId), "Only if unlocked"); } function _onlyAdminACL(bytes4 _selector) internal { require( adminACLAllowed(msg.sender, address(this), _selector), "Only Admin ACL allowed" ); } function _onlyArtistOrAdminACL( uint256 _projectId, bytes4 _selector ) internal { require( msg.sender == projectIdToFinancials[_projectId].artistAddress || adminACLAllowed(msg.sender, address(this), _selector), "Only artist or Admin ACL allowed" ); } /** * This modifier allows the artist of a project to call a function if the * owner of the contract has renounced ownership. This is to allow the * contract to continue to function if the owner decides to renounce * ownership. */ function _onlyAdminACLOrRenouncedArtist( uint256 _projectId, bytes4 _selector ) internal { require( adminACLAllowed(msg.sender, address(this), _selector) || (owner() == address(0) && msg.sender == projectIdToFinancials[_projectId].artistAddress), "Only Admin ACL allowed, or artist if owner has renounced" ); } /** * @notice Initializes contract. * @param _tokenName Name of token. * @param _tokenSymbol Token symbol. * @param _randomizerContract Randomizer contract. * @param _adminACLContract Address of admin access control contract, to be * set as contract owner. * @param _startingProjectId The initial next project ID. * @param _autoApproveArtistSplitProposals Whether or not to always * auto-approve proposed artist split updates. * @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`. */ constructor( string memory _tokenName, string memory _tokenSymbol, address _renderProviderAddress, address _platformProviderAddress, address _randomizerContract, address _adminACLContract, uint248 _startingProjectId, bool _autoApproveArtistSplitProposals ) ERC721_PackedHashSeed(_tokenName, _tokenSymbol) { _onlyNonZeroAddress(_renderProviderAddress); _onlyNonZeroAddress(_platformProviderAddress); _onlyNonZeroAddress(_randomizerContract); _onlyNonZeroAddress(_adminACLContract); // setup immutable `autoApproveArtistSplitProposals` config autoApproveArtistSplitProposals = _autoApproveArtistSplitProposals; // record contracts starting project ID // casting-up is safe startingProjectId = uint256(_startingProjectId); _updateProviderSalesAddresses( _renderProviderAddress, _renderProviderAddress, _platformProviderAddress, _platformProviderAddress ); _updateRandomizerAddress(_randomizerContract); // set AdminACL management contract as owner _transferOwnership(_adminACLContract); // initialize default base URI _updateDefaultBaseURI( string.concat( "https://token.artblocks.io/", toHexString(address(this)), "/" ) ); // initialize next project ID _nextProjectId = _startingProjectId; emit PlatformUpdated(FIELD_NEXT_PROJECT_ID); // @dev follow-on action: This contract does not self-register. A core // registry owner must register contract in a subsequent call. } /** * @notice Updates preferredIPFSGateway to `_gateway`. */ function updateIPFSGateway(string calldata _gateway) public { _onlyAdminACL(this.updateIPFSGateway.selector); preferredIPFSGateway = _gateway; emit GatewayUpdated(ExternalAssetDependencyType.IPFS, _gateway); } /** * @notice Updates preferredArweaveGateway to `_gateway`. */ function updateArweaveGateway(string calldata _gateway) public { _onlyAdminACL(this.updateArweaveGateway.selector); preferredArweaveGateway = _gateway; emit GatewayUpdated(ExternalAssetDependencyType.ARWEAVE, _gateway); } /** * @notice Locks external asset dependencies for project `_projectId`. */ function lockProjectExternalAssetDependencies(uint256 _projectId) external { _onlyUnlockedProjectExternalAssetDependencies(_projectId); _onlyArtistOrAdminACL( _projectId, this.lockProjectExternalAssetDependencies.selector ); projects[_projectId].externalAssetDependenciesLocked = true; emit ProjectExternalAssetDependenciesLocked(_projectId); } /** * @notice Updates external asset dependency for project `_projectId`. * @param _projectId Project to be updated. * @param _index Asset index. * @param _cidOrData Asset cid (Content identifier) or data string to be translated into bytecode. * @param _dependencyType Asset dependency type. * 0 - IPFS * 1 - ARWEAVE * 2 - ONCHAIN */ function updateProjectExternalAssetDependency( uint256 _projectId, uint256 _index, string memory _cidOrData, ExternalAssetDependencyType _dependencyType ) external { _onlyUnlockedProjectExternalAssetDependencies(_projectId); _onlyArtistOrAdminACL( _projectId, this.updateProjectExternalAssetDependency.selector ); uint24 assetCount = projects[_projectId].externalAssetDependencyCount; require(_index < assetCount, "Asset index out of range"); ExternalAssetDependency storage _oldDependency = projects[_projectId] .externalAssetDependencies[_index]; ExternalAssetDependencyType _oldDependencyType = _oldDependency .dependencyType; projects[_projectId] .externalAssetDependencies[_index] .dependencyType = _dependencyType; // if the incoming dependency type is onchain, we need to write the data to bytecode if (_dependencyType == ExternalAssetDependencyType.ONCHAIN) { if (_oldDependencyType != ExternalAssetDependencyType.ONCHAIN) { // we only need to set the cid to an empty string if we are replacing an offchain asset // an onchain asset will already have an empty cid projects[_projectId].externalAssetDependencies[_index].cid = ""; } projects[_projectId] .externalAssetDependencies[_index] .bytecodeAddress = _cidOrData.writeToBytecode(); // we don't want to emit data, so we emit the cid as an empty string _cidOrData = ""; } else { projects[_projectId] .externalAssetDependencies[_index] .cid = _cidOrData; } emit ExternalAssetDependencyUpdated( _projectId, _index, _cidOrData, _dependencyType, assetCount ); } /** * @notice Removes external asset dependency for project `_projectId` at index `_index`. * Removal is done by swapping the element to be removed with the last element in the array, then deleting this last element. * Assets with indices higher than `_index` can have their indices adjusted as a result of this operation. * @param _projectId Project to be updated. * @param _index Asset index */ function removeProjectExternalAssetDependency( uint256 _projectId, uint256 _index ) external { _onlyUnlockedProjectExternalAssetDependencies(_projectId); _onlyArtistOrAdminACL( _projectId, this.removeProjectExternalAssetDependency.selector ); uint24 assetCount = projects[_projectId].externalAssetDependencyCount; require(_index < assetCount, "Asset index out of range"); uint24 lastElementIndex = assetCount - 1; // copy last element to index of element to be removed projects[_projectId].externalAssetDependencies[_index] = projects[ _projectId ].externalAssetDependencies[lastElementIndex]; delete projects[_projectId].externalAssetDependencies[lastElementIndex]; projects[_projectId].externalAssetDependencyCount = lastElementIndex; emit ExternalAssetDependencyRemoved(_projectId, _index); } /** * @notice Adds external asset dependency for project `_projectId`. * @param _projectId Project to be updated. * @param _cidOrData Asset cid (Content identifier) or data string to be translated into bytecode. * @param _dependencyType Asset dependency type. * 0 - IPFS * 1 - ARWEAVE * 2 - ONCHAIN */ function addProjectExternalAssetDependency( uint256 _projectId, string memory _cidOrData, ExternalAssetDependencyType _dependencyType ) external { _onlyUnlockedProjectExternalAssetDependencies(_projectId); _onlyArtistOrAdminACL( _projectId, this.addProjectExternalAssetDependency.selector ); uint24 assetCount = projects[_projectId].externalAssetDependencyCount; address _bytecodeAddress = address(0); // if the incoming dependency type is onchain, we need to write the data to bytecode if (_dependencyType == ExternalAssetDependencyType.ONCHAIN) { _bytecodeAddress = _cidOrData.writeToBytecode(); // we don't want to emit data, so we emit the cid as an empty string _cidOrData = ""; } ExternalAssetDependency memory asset = ExternalAssetDependency({ cid: _cidOrData, dependencyType: _dependencyType, bytecodeAddress: _bytecodeAddress }); projects[_projectId].externalAssetDependencies[assetCount] = asset; projects[_projectId].externalAssetDependencyCount = assetCount + 1; emit ExternalAssetDependencyUpdated( _projectId, assetCount, _cidOrData, _dependencyType, assetCount + 1 ); } /** * @notice Mints a token from project `_projectId` and sets the * token's owner to `_to`. Hash may or may not be assigned to the token * during the mint transaction, depending on the randomizer contract. * @param _to Address to be the minted token's owner. * @param _projectId Project ID to mint a token on. * @param _by Purchaser of minted token. * @return _tokenId The ID of the minted token. * @dev sender must be the allowed minterContract * @dev name of function is optimized for gas usage */ function mint_Ecf( address _to, uint256 _projectId, address _by ) external returns (uint256 _tokenId) { // CHECKS require(msg.sender == minterContract, "Must mint from minter contract"); Project storage project = projects[_projectId]; // load invocations into memory uint24 invocationsBefore = project.invocations; uint24 invocationsAfter; unchecked { // invocationsBefore guaranteed <= maxInvocations <= 1_000_000, // 1_000_000 << max uint24, so no possible overflow invocationsAfter = invocationsBefore + 1; } uint24 maxInvocations = project.maxInvocations; require( invocationsBefore < maxInvocations, "Must not exceed max invocations" ); require( project.active || _by == projectIdToFinancials[_projectId].artistAddress, "Project must exist and be active" ); require( !project.paused || _by == projectIdToFinancials[_projectId].artistAddress, "Purchases are paused." ); // EFFECTS // increment project's invocations project.invocations = invocationsAfter; uint256 thisTokenId; unchecked { // invocationsBefore is uint24 << max uint256. In production use, // _projectId * ONE_MILLION must be << max uint256, otherwise // tokenIdToProjectId function become invalid. // Therefore, no risk of overflow thisTokenId = (_projectId * ONE_MILLION) + invocationsBefore; } // mark project as completed if hit max invocations if (invocationsAfter == maxInvocations) { _completeProject(_projectId); } // INTERACTIONS _mint(_to, thisTokenId); // token hash is updated by the randomizer contract on V3 randomizerContract.assignTokenHash(thisTokenId); // Do not need to also log `projectId` in event, as the `projectId` for // a given token can be derived from the `tokenId` with: // projectId = tokenId / 1_000_000 emit Mint(_to, thisTokenId); return thisTokenId; } /** * @notice Sets the hash seed for a given token ID `_tokenId`. * May only be called by the current randomizer contract. * May only be called for tokens that have not already been assigned a * non-zero hash. * @param _tokenId Token ID to set the hash for. * @param _hashSeed Hash seed to set for the token ID. Only last 12 bytes * will be used. * @dev gas-optimized function name because called during mint sequence * @dev if a separate event is required when the token hash is set, e.g. * for indexing purposes, it must be emitted by the randomizer. This is to * minimize gas when minting. */ function setTokenHash_8PT(uint256 _tokenId, bytes32 _hashSeed) external { _onlyValidTokenId(_tokenId); OwnerAndHashSeed storage ownerAndHashSeed = _ownersAndHashSeeds[ _tokenId ]; require( msg.sender == address(randomizerContract), "Only randomizer may set" ); require( ownerAndHashSeed.hashSeed == bytes12(0), "Token hash already set" ); require(_hashSeed != bytes12(0), "No zero hash seed"); ownerAndHashSeed.hashSeed = bytes12(_hashSeed); } /** * @notice Allows owner (AdminACL) to revoke ownership of the contract. * Note that the contract is intended to continue to function after the * owner renounces ownership, but no new projects will be able to be added. * Renouncing ownership will leave the contract without an owner, * thereby removing any functionality that is only available to the * owner/AdminACL contract. The same is true for any dependent contracts * that also integrate with the owner/AdminACL contract (e.g. potentially * minter suite contracts, registry contracts, etc.). * After renouncing ownership, artists will be in control of updates to * their payment addresses and splits (see modifier * onlyAdminACLOrRenouncedArtist`). * While there is no currently intended reason to call this method based on * typical Engine partner business practices, this method exists to allow * artists to continue to maintain the limited set of contract * functionality that exists post-project-lock in an environment in which * there is no longer an admin maintaining this smart contract. * @dev This function is intended to be called directly by the AdminACL, * not by an address allowed by the AdminACL contract. */ function renounceOwnership() public override onlyOwner { // broadcast that new projects are no longer allowed (if not already) _forbidNewProjects(); // renounce ownership viw Ownable Ownable.renounceOwnership(); } /** * @notice Updates reference to Art Blocks Dependency Registry contract. * @param _artblocksDependencyRegistryAddress Address of new Dependency * Registry. */ function updateArtblocksDependencyRegistryAddress( address _artblocksDependencyRegistryAddress ) external { _onlyAdminACL(this.updateArtblocksDependencyRegistryAddress.selector); _onlyNonZeroAddress(_artblocksDependencyRegistryAddress); artblocksDependencyRegistryAddress = _artblocksDependencyRegistryAddress; emit PlatformUpdated(FIELD_ARTBLOCKS_DEPENDENCY_REGISTRY_ADDRESS); } /** * @notice Updates sales addresses for the platform and render providers to * the input parameters. * @param _renderProviderPrimarySalesAddress Address of new primary sales * payment address. * @param _renderProviderSecondarySalesAddress Address of new secondary sales * payment address. * @param _platformProviderPrimarySalesAddress Address of new primary sales * payment address. * @param _platformProviderSecondarySalesAddress Address of new secondary sales * payment address. */ function updateProviderSalesAddresses( address payable _renderProviderPrimarySalesAddress, address payable _renderProviderSecondarySalesAddress, address payable _platformProviderPrimarySalesAddress, address payable _platformProviderSecondarySalesAddress ) external { _onlyAdminACL(this.updateProviderSalesAddresses.selector); _onlyNonZeroAddress(_renderProviderPrimarySalesAddress); _onlyNonZeroAddress(_renderProviderSecondarySalesAddress); _onlyNonZeroAddress(_platformProviderPrimarySalesAddress); _onlyNonZeroAddress(_platformProviderSecondarySalesAddress); _updateProviderSalesAddresses( _renderProviderPrimarySalesAddress, _renderProviderSecondarySalesAddress, _platformProviderPrimarySalesAddress, _platformProviderSecondarySalesAddress ); } /** * @notice Updates the render and platform provider primary sales revenue percentage to * the provided inputs. * @param renderProviderPrimarySalesPercentage_ New primary sales revenue % for the render provider * @param platformProviderPrimarySalesPercentage_ New primary sales revenue % for the platform provider * percentage. */ function updateProviderPrimarySalesPercentages( uint256 renderProviderPrimarySalesPercentage_, uint256 platformProviderPrimarySalesPercentage_ ) external { _onlyAdminACL(this.updateProviderPrimarySalesPercentages.selector); // Validate that the sum of the proposed %s, does not exceed 100%. require( (renderProviderPrimarySalesPercentage_ + platformProviderPrimarySalesPercentage_) <= ONE_HUNDRED, "Max sum of ONE_HUNDRED %" ); // Casting to `uint8` here is safe due check above, which does not allow // overflow as of solidity version ^0.8.0. _renderProviderPrimarySalesPercentage = uint8( renderProviderPrimarySalesPercentage_ ); _platformProviderPrimarySalesPercentage = uint8( platformProviderPrimarySalesPercentage_ ); emit PlatformUpdated(FIELD_PROVIDER_PRIMARY_SALES_PERCENTAGES); } /** * @notice Updates render and platform provider secondary sales royalty Basis Points to * the provided inputs. * @param _renderProviderSecondarySalesBPS New secondary sales royalty Basis * points. * @param _platformProviderSecondarySalesBPS New secondary sales royalty Basis * points. * @dev Due to secondary royalties being ultimately enforced via social * consensus, no hard upper limit is imposed on the BPS value, other than * <= 100% royalty, which would not make mathematical sense. Realistically, * changing this value is expected to either never occur, or be a rare * occurrence. */ function updateProviderSecondarySalesBPS( uint256 _renderProviderSecondarySalesBPS, uint256 _platformProviderSecondarySalesBPS ) external { _onlyAdminACL(this.updateProviderSecondarySalesBPS.selector); // Validate that the sum of the proposed provider BPS, does not exceed 10_000 BPS. require( (_renderProviderSecondarySalesBPS + _platformProviderSecondarySalesBPS) <= MAX_PROVIDER_SECONDARY_SALES_BPS, "Over max sum of BPS" ); renderProviderSecondarySalesBPS = _renderProviderSecondarySalesBPS; platformProviderSecondarySalesBPS = _platformProviderSecondarySalesBPS; emit PlatformUpdated(FIELD_PROVIDER_SECONDARY_SALES_BPS); } /** * @notice Updates minter to `_address`. * @param _address Address of new minter. */ function updateMinterContract(address _address) external { _onlyAdminACL(this.updateMinterContract.selector); _onlyNonZeroAddress(_address); minterContract = _address; emit MinterUpdated(_address); } /** * @notice Updates randomizer to `_randomizerAddress`. * @param _randomizerAddress Address of new randomizer. */ function updateRandomizerAddress(address _randomizerAddress) external { _onlyAdminACL(this.updateRandomizerAddress.selector); _onlyNonZeroAddress(_randomizerAddress); _updateRandomizerAddress(_randomizerAddress); } /** * @notice Toggles project `_projectId` as active/inactive. * @param _projectId Project ID to be toggled. */ function toggleProjectIsActive(uint256 _projectId) external { _onlyAdminACL(this.toggleProjectIsActive.selector); _onlyValidProjectId(_projectId); projects[_projectId].active = !projects[_projectId].active; emit ProjectUpdated(_projectId, FIELD_PROJECT_ACTIVE); } /** * @notice Artist proposes updated set of artist address, additional payee * addresses, and percentage splits for project `_projectId`. Addresses and * percentages do not have to all be changed, but they must all be defined * as a complete set. * Note that if the artist is only proposing a change to the payee percentage * splits, without modifying the payee addresses, the proposal will be * automatically approved and the new splits will become active immediately. * Automatic approval will also be granted if the artist is only removing * additional payee addresses, without adding any new ones. * Also note that if `autoApproveArtistSplitProposals` is true, proposals * will always be auto-approved, regardless of what is being changed. * Also note that if the artist is proposing sending funds to the zero * address, this function will revert and the proposal will not be created. * @param _projectId Project ID. * @param _artistAddress Artist address that controls the project, and may * receive payments. * @param _additionalPayeePrimarySales Address that may receive a * percentage split of the artist's primary sales revenue. * @param _additionalPayeePrimarySalesPercentage Percent of artist's * portion of primary sale revenue that will be split to address * `_additionalPayeePrimarySales`. * @param _additionalPayeeSecondarySales Address that may receive a percentage * split of the secondary sales royalties. * @param _additionalPayeeSecondarySalesPercentage Percent of artist's portion * of secondary sale royalties that will be split to address * `_additionalPayeeSecondarySales`. * @dev `_artistAddress` must be a valid address (non-zero-address), but it * is intentionally allowable for `_additionalPayee{Primary,Secondaary}Sales` * and their associated percentages to be zero'd out by the controlling artist. */ function proposeArtistPaymentAddressesAndSplits( uint256 _projectId, address payable _artistAddress, address payable _additionalPayeePrimarySales, uint256 _additionalPayeePrimarySalesPercentage, address payable _additionalPayeeSecondarySales, uint256 _additionalPayeeSecondarySalesPercentage ) external { _onlyValidProjectId(_projectId); _onlyArtistOrAdminACL( _projectId, this.proposeArtistPaymentAddressesAndSplits.selector ); _onlyNonZeroAddress(_artistAddress); ProjectFinance storage projectFinance = projectIdToFinancials[ _projectId ]; // checks require( _additionalPayeePrimarySalesPercentage <= ONE_HUNDRED && _additionalPayeeSecondarySalesPercentage <= ONE_HUNDRED, "Max of 100%" ); require( _additionalPayeePrimarySalesPercentage == 0 || _additionalPayeePrimarySales != address(0), "Primary payee is zero address" ); require( _additionalPayeeSecondarySalesPercentage == 0 || _additionalPayeeSecondarySales != address(0), "Secondary payee is zero address" ); // effects // emit event for off-chain indexing // note: always emit a proposal event, even in the pathway of // automatic approval, to simplify indexing expectations emit ProposedArtistAddressesAndSplits( _projectId, _artistAddress, _additionalPayeePrimarySales, _additionalPayeePrimarySalesPercentage, _additionalPayeeSecondarySales, _additionalPayeeSecondarySalesPercentage ); // automatically accept if no proposed addresses modifications, or if // the proposal only removes payee addresses, or if contract is set to // always auto-approve. // store proposal hash on-chain, only if not automatic accept bool automaticAccept = autoApproveArtistSplitProposals; if (!automaticAccept) { // block scope to avoid stack too deep error bool artistUnchanged = _artistAddress == projectFinance.artistAddress; bool additionalPrimaryUnchangedOrRemoved = (_additionalPayeePrimarySales == projectFinance.additionalPayeePrimarySales) || (_additionalPayeePrimarySales == address(0)); bool additionalSecondaryUnchangedOrRemoved = (_additionalPayeeSecondarySales == projectFinance.additionalPayeeSecondarySales) || (_additionalPayeeSecondarySales == address(0)); automaticAccept = artistUnchanged && additionalPrimaryUnchangedOrRemoved && additionalSecondaryUnchangedOrRemoved; } if (automaticAccept) { // clear any previously proposed values proposedArtistAddressesAndSplitsHash[_projectId] = bytes32(0); // update storage // artist address can change during automatic accept if // autoApproveArtistSplitProposals is true projectFinance.artistAddress = _artistAddress; projectFinance .additionalPayeePrimarySales = _additionalPayeePrimarySales; // safe to cast as uint8 as max is 100%, max uint8 is 255 projectFinance.additionalPayeePrimarySalesPercentage = uint8( _additionalPayeePrimarySalesPercentage ); projectFinance .additionalPayeeSecondarySales = _additionalPayeeSecondarySales; // safe to cast as uint8 as max is 100%, max uint8 is 255 projectFinance.additionalPayeeSecondarySalesPercentage = uint8( _additionalPayeeSecondarySalesPercentage ); // emit event for off-chain indexing emit AcceptedArtistAddressesAndSplits(_projectId); } else { proposedArtistAddressesAndSplitsHash[_projectId] = keccak256( abi.encode( _artistAddress, _additionalPayeePrimarySales, _additionalPayeePrimarySalesPercentage, _additionalPayeeSecondarySales, _additionalPayeeSecondarySalesPercentage ) ); } } /** * @notice Admin accepts a proposed set of updated artist address, * additional payee addresses, and percentage splits for project * `_projectId`. Addresses and percentages do not have to all be changed, * but they must all be defined as a complete set. * @param _projectId Project ID. * @param _artistAddress Artist address that controls the project, and may * receive payments. * @param _additionalPayeePrimarySales Address that may receive a * percentage split of the artist's primary sales revenue. * @param _additionalPayeePrimarySalesPercentage Percent of artist's * portion of primary sale revenue that will be split to address * `_additionalPayeePrimarySales`. * @param _additionalPayeeSecondarySales Address that may receive a percentage * split of the secondary sales royalties. * @param _additionalPayeeSecondarySalesPercentage Percent of artist's portion * of secondary sale royalties that will be split to address * `_additionalPayeeSecondarySales`. * @dev this must be called by the Admin ACL contract, and must only accept * the most recent proposed values for a given project (validated on-chain * by comparing the hash of the proposed and accepted values). * @dev `_artistAddress` must be a valid address (non-zero-address), but it * is intentionally allowable for `_additionalPayee{Primary,Secondaary}Sales` * and their associated percentages to be zero'd out by the controlling artist. */ function adminAcceptArtistAddressesAndSplits( uint256 _projectId, address payable _artistAddress, address payable _additionalPayeePrimarySales, uint256 _additionalPayeePrimarySalesPercentage, address payable _additionalPayeeSecondarySales, uint256 _additionalPayeeSecondarySalesPercentage ) external { _onlyValidProjectId(_projectId); _onlyAdminACLOrRenouncedArtist( _projectId, this.adminAcceptArtistAddressesAndSplits.selector ); _onlyNonZeroAddress(_artistAddress); // checks require( proposedArtistAddressesAndSplitsHash[_projectId] == keccak256( abi.encode( _artistAddress, _additionalPayeePrimarySales, _additionalPayeePrimarySalesPercentage, _additionalPayeeSecondarySales, _additionalPayeeSecondarySalesPercentage ) ), "Must match artist proposal" ); // effects ProjectFinance storage projectFinance = projectIdToFinancials[ _projectId ]; projectFinance.artistAddress = _artistAddress; projectFinance .additionalPayeePrimarySales = _additionalPayeePrimarySales; projectFinance.additionalPayeePrimarySalesPercentage = uint8( _additionalPayeePrimarySalesPercentage ); projectFinance .additionalPayeeSecondarySales = _additionalPayeeSecondarySales; projectFinance.additionalPayeeSecondarySalesPercentage = uint8( _additionalPayeeSecondarySalesPercentage ); // clear proposed values proposedArtistAddressesAndSplitsHash[_projectId] = bytes32(0); // emit event for off-chain indexing emit AcceptedArtistAddressesAndSplits(_projectId); } /** * @notice Updates artist of project `_projectId` to `_artistAddress`. * This is to only be used in the event that the artist address is * compromised or sanctioned. * @param _projectId Project ID. * @param _artistAddress New artist address. */ function updateProjectArtistAddress( uint256 _projectId, address payable _artistAddress ) external { _onlyValidProjectId(_projectId); _onlyAdminACLOrRenouncedArtist( _projectId, this.updateProjectArtistAddress.selector ); _onlyNonZeroAddress(_artistAddress); projectIdToFinancials[_projectId].artistAddress = _artistAddress; emit ProjectUpdated(_projectId, FIELD_PROJECT_ARTIST_ADDRESS); } /** * @notice Toggles paused state of project `_projectId`. * @param _projectId Project ID to be toggled. */ function toggleProjectIsPaused(uint256 _projectId) external { _onlyValidProjectId(_projectId); _onlyArtistOrAdminACL(_projectId, this.toggleProjectIsPaused.selector); projects[_projectId].paused = !projects[_projectId].paused; emit ProjectUpdated(_projectId, FIELD_PROJECT_PAUSED); } /** * @notice Adds new project `_projectName` by `_artistAddress`. * @param _projectName Project name. * @param _artistAddress Artist's address. * @dev token price now stored on minter */ function addProject( string memory _projectName, address payable _artistAddress ) external { _onlyAdminACL(this.addProject.selector); _onlyNonEmptyString(_projectName); _onlyNonZeroAddress(_artistAddress); require(!newProjectsForbidden, "New projects forbidden"); uint256 projectId = _nextProjectId; projectIdToFinancials[projectId].artistAddress = _artistAddress; projects[projectId].name = _projectName; projects[projectId].paused = true; projects[projectId].maxInvocations = ONE_MILLION_UINT24; projects[projectId].projectBaseURI = defaultBaseURI; _nextProjectId = uint248(projectId) + 1; emit ProjectUpdated(projectId, FIELD_PROJECT_CREATED); } /** * @notice Forever forbids new projects from being added to this contract. */ function forbidNewProjects() external { _onlyAdminACL(this.forbidNewProjects.selector); require(!newProjectsForbidden, "Already forbidden"); _forbidNewProjects(); } /** * @notice Updates name of project `_projectId` to be `_projectName`. * @param _projectId Project ID. * @param _projectName New project name. */ function updateProjectName( uint256 _projectId, string memory _projectName ) external { _onlyUnlocked(_projectId); _onlyArtistOrAdminACL(_projectId, this.updateProjectName.selector); _onlyNonEmptyString(_projectName); projects[_projectId].name = _projectName; emit ProjectUpdated(_projectId, FIELD_PROJECT_NAME); } /** * @notice Updates artist name for project `_projectId` to be * `_projectArtistName`. * @param _projectId Project ID. * @param _projectArtistName New artist name. */ function updateProjectArtistName( uint256 _projectId, string memory _projectArtistName ) external { _onlyUnlocked(_projectId); _onlyArtistOrAdminACL( _projectId, this.updateProjectArtistName.selector ); _onlyNonEmptyString(_projectArtistName); projects[_projectId].artist = _projectArtistName; emit ProjectUpdated(_projectId, FIELD_PROJECT_ARTIST_NAME); } /** * @notice Updates artist secondary market royalties for project * `_projectId` to be `_secondMarketRoyalty` percent. * This DOES NOT include the secondary market royalty percentages collected * by the issuing platform; it is only the total percentage of royalties * that will be split to artist and additionalSecondaryPayee. * @param _projectId Project ID. * @param _secondMarketRoyalty Percent of secondary sales revenue that will * be split to artist and additionalSecondaryPayee. This must be less than * or equal to ARTIST_MAX_SECONDARY_ROYALTY_PERCENTAGE percent. */ function updateProjectSecondaryMarketRoyaltyPercentage( uint256 _projectId, uint256 _secondMarketRoyalty ) external { _onlyValidProjectId(_projectId); _onlyArtistOrAdminACL( _projectId, this.updateProjectSecondaryMarketRoyaltyPercentage.selector ); require( _secondMarketRoyalty <= ARTIST_MAX_SECONDARY_ROYALTY_PERCENTAGE, "Over max percent" ); projectIdToFinancials[_projectId] .secondaryMarketRoyaltyPercentage = uint8(_secondMarketRoyalty); emit ProjectUpdated( _projectId, FIELD_PROJECT_SECONDARY_MARKET_ROYALTY_PERCENTAGE ); } /** * @notice Updates description of project `_projectId`. * Only artist may call when unlocked, only admin may call when locked. * @param _projectId Project ID. * @param _projectDescription New project description. */ function updateProjectDescription( uint256 _projectId, string memory _projectDescription ) external { // checks require( _projectUnlocked(_projectId) ? msg.sender == projectIdToFinancials[_projectId].artistAddress : adminACLAllowed( msg.sender, address(this), this.updateProjectDescription.selector ), "Only artist when unlocked, owner when locked" ); // effects projects[_projectId].description = _projectDescription; emit ProjectUpdated(_projectId, FIELD_PROJECT_DESCRIPTION); } /** * @notice Updates website of project `_projectId` to be `_projectWebsite`. * @param _projectId Project ID. * @param _projectWebsite New project website. * @dev It is intentionally allowed for this to be set to the empty string. */ function updateProjectWebsite( uint256 _projectId, string memory _projectWebsite ) external { _onlyValidProjectId(_projectId); _onlyArtistOrAdminACL(_projectId, this.updateProjectWebsite.selector); projects[_projectId].website = _projectWebsite; emit ProjectUpdated(_projectId, FIELD_PROJECT_WEBSITE); } /** * @notice Updates license for project `_projectId`. * @param _projectId Project ID. * @param _projectLicense New project license. */ function updateProjectLicense( uint256 _projectId, string memory _projectLicense ) external { _onlyUnlocked(_projectId); _onlyArtistOrAdminACL(_projectId, this.updateProjectLicense.selector); _onlyNonEmptyString(_projectLicense); projects[_projectId].license = _projectLicense; emit ProjectUpdated(_projectId, FIELD_PROJECT_LICENSE); } /** * @notice Updates maximum invocations for project `_projectId` to * `_maxInvocations`. Maximum invocations may only be decreased by the * artist, and must be greater than or equal to current invocations. * New projects are created with maximum invocations of 1 million by * default. * @param _projectId Project ID. * @param _maxInvocations New maximum invocations. */ function updateProjectMaxInvocations( uint256 _projectId, uint24 _maxInvocations ) external { _onlyValidProjectId(_projectId); _onlyArtistOrAdminACL( _projectId, this.updateProjectMaxInvocations.selector ); // CHECKS Project storage project = projects[_projectId]; uint256 _invocations = project.invocations; require( (_maxInvocations < project.maxInvocations), "Only maxInvocations decrease" ); require(_maxInvocations >= _invocations, "Only gte invocations"); // EFFECTS project.maxInvocations = _maxInvocations; emit ProjectUpdated(_projectId, FIELD_PROJECT_MAX_INVOCATIONS); // register completed timestamp if action completed the project if (_maxInvocations == _invocations) { _completeProject(_projectId); } } /** * @notice Adds a script to project `_projectId`. * @param _projectId Project to be updated. * @param _script Script to be added. Required to be a non-empty string, * but no further validation is performed. */ function addProjectScript( uint256 _projectId, string memory _script ) external { _onlyUnlocked(_projectId); _onlyArtistOrAdminACL(_projectId, this.addProjectScript.selector); _onlyNonEmptyString(_script); Project storage project = projects[_projectId]; // store script in contract bytecode project.scriptBytecodeAddresses[project.scriptCount] = _script .writeToBytecode(); project.scriptCount = project.scriptCount + 1; emit ProjectUpdated(_projectId, FIELD_PROJECT_SCRIPT); } /** * @notice Updates script for project `_projectId` at script ID `_scriptId`. * @param _projectId Project to be updated. * @param _scriptId Script ID to be updated. * @param _script The updated script value. Required to be a non-empty * string, but no further validation is performed. */ function updateProjectScript( uint256 _projectId, uint256 _scriptId, string memory _script ) external { _onlyUnlocked(_projectId); _onlyArtistOrAdminACL(_projectId, this.updateProjectScript.selector); _onlyNonEmptyString(_script); Project storage project = projects[_projectId]; require(_scriptId < project.scriptCount, "scriptId out of range"); // store script in contract bytecode, replacing reference address from // the contract that no longer exists with the newly created one project.scriptBytecodeAddresses[_scriptId] = _script.writeToBytecode(); emit ProjectUpdated(_projectId, FIELD_PROJECT_SCRIPT); } /** * @notice Removes last script from project `_projectId`. * @param _projectId Project to be updated. */ function removeProjectLastScript(uint256 _projectId) external { _onlyUnlocked(_projectId); _onlyArtistOrAdminACL( _projectId, this.removeProjectLastScript.selector ); Project storage project = projects[_projectId]; require(project.scriptCount > 0, "No scripts to remove"); // delete reference to contract address that no longer exists delete project.scriptBytecodeAddresses[project.scriptCount - 1]; unchecked { project.scriptCount = project.scriptCount - 1; } emit ProjectUpdated(_projectId, FIELD_PROJECT_SCRIPT); } /** * @notice Updates script type for project `_projectId`. * @param _projectId Project to be updated. * @param _scriptTypeAndVersion Script type and version e.g. "[email protected]", * as bytes32 encoded string. */ function updateProjectScriptType( uint256 _projectId, bytes32 _scriptTypeAndVersion ) external { _onlyUnlocked(_projectId); _onlyArtistOrAdminACL( _projectId, this.updateProjectScriptType.selector ); Project storage project = projects[_projectId]; // require exactly one @ symbol in _scriptTypeAndVersion require( _scriptTypeAndVersion.containsExactCharacterQty( AT_CHARACTER_CODE, uint8(1) ), "must contain exactly one @" ); project.scriptTypeAndVersion = _scriptTypeAndVersion; emit ProjectUpdated(_projectId, FIELD_PROJECT_SCRIPT_TYPE); } /** * @notice Updates project's aspect ratio. * @param _projectId Project to be updated. * @param _aspectRatio Aspect ratio to be set. Intended to be string in the * format of a decimal, e.g. "1" for square, "1.77777778" for 16:9, etc., * allowing for a maximum of 10 digits and one (optional) decimal separator. */ function updateProjectAspectRatio( uint256 _projectId, string memory _aspectRatio ) external { _onlyUnlocked(_projectId); _onlyArtistOrAdminACL( _projectId, this.updateProjectAspectRatio.selector ); _onlyNonEmptyString(_aspectRatio); // Perform more detailed input validation for aspect ratio. bytes memory aspectRatioBytes = bytes(_aspectRatio); uint256 bytesLength = aspectRatioBytes.length; require(bytesLength <= 11, "Aspect ratio format too long"); bool hasSeenDecimalSeparator = false; bool hasSeenNumber = false; for (uint256 i; i < bytesLength; i++) { bytes1 character = aspectRatioBytes[i]; // Allow as many #s as desired. if (character >= 0x30 && character <= 0x39) { // 9-0 // We need to ensure there is at least 1 `9-0` occurrence. hasSeenNumber = true; continue; } if (character == 0x2E) { // . // Allow no more than 1 `.` occurrence. if (!hasSeenDecimalSeparator) { hasSeenDecimalSeparator = true; continue; } } revert("Improperly formatted aspect ratio"); } require(hasSeenNumber, "Aspect ratio has no numbers"); projects[_projectId].aspectRatio = _aspectRatio; emit ProjectUpdated(_projectId, FIELD_PROJECT_ASPECT_RATIO); } /** * @notice Updates base URI for project `_projectId` to `_newBaseURI`. * This is the controlling base URI for all tokens in the project. The * contract-level defaultBaseURI is only used when initializing new * projects. * @param _projectId Project to be updated. * @param _newBaseURI New base URI. */ function updateProjectBaseURI( uint256 _projectId, string memory _newBaseURI ) external { _onlyValidProjectId(_projectId); _onlyArtistOrAdminACL(_projectId, this.updateProjectBaseURI.selector); _onlyNonEmptyString(_newBaseURI); projects[_projectId].projectBaseURI = _newBaseURI; emit ProjectUpdated(_projectId, FIELD_PROJECT_BASE_URI); } /** * @notice Updates default base URI to `_defaultBaseURI`. The * contract-level defaultBaseURI is only used when initializing new * projects. Token URIs are determined by their project's `projectBaseURI`. * @param _defaultBaseURI New default base URI. */ function updateDefaultBaseURI(string memory _defaultBaseURI) external { _onlyAdminACL(this.updateDefaultBaseURI.selector); _onlyNonEmptyString(_defaultBaseURI); _updateDefaultBaseURI(_defaultBaseURI); } /** * @notice Next project ID to be created on this contract. * @return uint256 Next project ID. */ function nextProjectId() external view returns (uint256) { return _nextProjectId; } /** * @notice Returns token hash for token ID `_tokenId`. Returns null if hash * has not been set. * @param _tokenId Token ID to be queried. * @return bytes32 Token hash. * @dev token hash is the keccak256 hash of the stored hash seed */ function tokenIdToHash(uint256 _tokenId) external view returns (bytes32) { bytes12 _hashSeed = _ownersAndHashSeeds[_tokenId].hashSeed; if (_hashSeed == 0) { return 0; } return keccak256(abi.encode(_hashSeed)); } /** * @notice Returns token hash **seed** for token ID `_tokenId`. Returns * null if hash seed has not been set. The hash seed id the bytes12 value * which is hashed to produce the token hash. * @param _tokenId Token ID to be queried. * @return bytes12 Token hash seed. * @dev token hash seed is keccak256 hashed to give the token hash */ function tokenIdToHashSeed( uint256 _tokenId ) external view returns (bytes12) { return _ownersAndHashSeeds[_tokenId].hashSeed; } /** * @notice View function returning the render provider portion of * primary sales, in percent. * @return uint256 The render provider portion of primary sales, * in percent. */ function renderProviderPrimarySalesPercentage() external view returns (uint256) { return _renderProviderPrimarySalesPercentage; } /** * @notice View function returning the platform provider portion of * primary sales, in percent. * @return uint256 The platform provider portion of primary sales, * in percent. */ function platformProviderPrimarySalesPercentage() external view returns (uint256) { return _platformProviderPrimarySalesPercentage; } /** * @notice View function returning Artist's address for project * `_projectId`. * @param _projectId Project ID to be queried. * @return address Artist's address. */ function projectIdToArtistAddress( uint256 _projectId ) external view returns (address payable) { return projectIdToFinancials[_projectId].artistAddress; } /** * @notice View function returning Artist's secondary market royalty * percentage for project `_projectId`. * This does not include render/platform providers portions of secondary * market royalties. * @param _projectId Project ID to be queried. * @return uint256 Artist's secondary market royalty percentage. */ function projectIdToSecondaryMarketRoyaltyPercentage( uint256 _projectId ) external view returns (uint256) { return projectIdToFinancials[_projectId].secondaryMarketRoyaltyPercentage; } /** * @notice View function returning Artist's additional payee address for * primary sales, for project `_projectId`. * @param _projectId Project ID to be queried. * @return address Artist's additional payee address for primary sales. */ function projectIdToAdditionalPayeePrimarySales( uint256 _projectId ) external view returns (address payable) { return projectIdToFinancials[_projectId].additionalPayeePrimarySales; } /** * @notice View function returning Artist's additional payee primary sales * percentage, for project `_projectId`. * @param _projectId Project ID to be queried. * @return uint256 Artist's additional payee primary sales percentage. */ function projectIdToAdditionalPayeePrimarySalesPercentage( uint256 _projectId ) external view returns (uint256) { return projectIdToFinancials[_projectId] .additionalPayeePrimarySalesPercentage; } /** * @notice View function returning Artist's additional payee address for * secondary sales, for project `_projectId`. * @param _projectId Project ID to be queried. * @return address payable Artist's additional payee address for secondary * sales. */ function projectIdToAdditionalPayeeSecondarySales( uint256 _projectId ) external view returns (address payable) { return projectIdToFinancials[_projectId].additionalPayeeSecondarySales; } /** * @notice View function returning Artist's additional payee secondary * sales percentage, for project `_projectId`. * @param _projectId Project ID to be queried. * @return uint256 Artist's additional payee secondary sales percentage. */ function projectIdToAdditionalPayeeSecondarySalesPercentage( uint256 _projectId ) external view returns (uint256) { return projectIdToFinancials[_projectId] .additionalPayeeSecondarySalesPercentage; } /** * @notice Returns project details for project `_projectId`. * @param _projectId Project to be queried. * @return projectName Name of project * @return artist Artist of project * @return description Project description * @return website Project website * @return license Project license * @dev this function was named projectDetails prior to V3 core contract. */ function projectDetails( uint256 _projectId ) external view returns ( string memory projectName, string memory artist, string memory description, string memory website, string memory license ) { Project storage project = projects[_projectId]; projectName = project.name; artist = project.artist; description = project.description; website = project.website; license = project.license; } /** * @notice Returns project state data for project `_projectId`. * @param _projectId Project to be queried * @return invocations Current number of invocations * @return maxInvocations Maximum allowed invocations * @return active Boolean representing if project is currently active * @return paused Boolean representing if project is paused * @return completedTimestamp zero if project not complete, otherwise * timestamp of project completion. * @return locked Boolean representing if project is locked * @dev price and currency info are located on minter contracts */ function projectStateData( uint256 _projectId ) external view returns ( uint256 invocations, uint256 maxInvocations, bool active, bool paused, uint256 completedTimestamp, bool locked ) { Project storage project = projects[_projectId]; invocations = project.invocations; maxInvocations = project.maxInvocations; active = project.active; paused = project.paused; completedTimestamp = project.completedTimestamp; locked = !_projectUnlocked(_projectId); } /** * @notice Returns artist payment information for project `_projectId`. * @param _projectId Project to be queried * @return artistAddress Project Artist's address * @return additionalPayeePrimarySales Additional payee address for primary * sales * @return additionalPayeePrimarySalesPercentage Percentage of artist revenue * to be sent to the additional payee address for primary sales * @return additionalPayeeSecondarySales Additional payee address for secondary * sales royalties * @return additionalPayeeSecondarySalesPercentage Percentage of artist revenue * to be sent to the additional payee address for secondary sales royalties * @return secondaryMarketRoyaltyPercentage Royalty percentage to be sent to * combination of artist and additional payee. This does not include the * platform's percentage of secondary sales royalties, which is defined as * the sum of `renderProviderSecondarySalesBPS` * and `platformProviderSecondarySalesBPS`. */ function projectArtistPaymentInfo( uint256 _projectId ) external view returns ( address artistAddress, address additionalPayeePrimarySales, uint256 additionalPayeePrimarySalesPercentage, address additionalPayeeSecondarySales, uint256 additionalPayeeSecondarySalesPercentage, uint256 secondaryMarketRoyaltyPercentage ) { ProjectFinance storage projectFinance = projectIdToFinancials[ _projectId ]; artistAddress = projectFinance.artistAddress; additionalPayeePrimarySales = projectFinance .additionalPayeePrimarySales; additionalPayeePrimarySalesPercentage = projectFinance .additionalPayeePrimarySalesPercentage; additionalPayeeSecondarySales = projectFinance .additionalPayeeSecondarySales; additionalPayeeSecondarySalesPercentage = projectFinance .additionalPayeeSecondarySalesPercentage; secondaryMarketRoyaltyPercentage = projectFinance .secondaryMarketRoyaltyPercentage; } /** * @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 override(IGenArt721CoreContractV3_Base, IDependencyRegistryCompatibleV0) returns ( string memory scriptTypeAndVersion, string memory aspectRatio, uint256 scriptCount ) { Project storage project = projects[_projectId]; scriptTypeAndVersion = project.scriptTypeAndVersion.toString(); aspectRatio = project.aspectRatio; scriptCount = project.scriptCount; } /** * @notice Returns address with bytecode containing project script for * project `_projectId` at script index `_index`. */ function projectScriptBytecodeAddressByIndex( uint256 _projectId, uint256 _index ) external view returns (address) { return projects[_projectId].scriptBytecodeAddresses[_index]; } /** * @notice Returns script for project `_projectId` at script index `_index`. * @param _projectId Project to be queried. * @param _index Index of script to be queried. */ function projectScriptByIndex( uint256 _projectId, uint256 _index ) external view returns (string memory) { Project storage project = projects[_projectId]; // If trying to access an out-of-index script, return the empty string. if (_index >= project.scriptCount) { return ""; } return _readFromBytecode(project.scriptBytecodeAddresses[_index]); } /** * @notice Returns base URI for project `_projectId`. * @param _projectId Project to be queried. * @return projectBaseURI Base URI for project */ function projectURIInfo( uint256 _projectId ) external view returns (string memory projectBaseURI) { projectBaseURI = projects[_projectId].projectBaseURI; } /** * @notice Backwards-compatible (pre-V3) function returning if `_minter` is * minterContract. * @param _minter Address to be queried. * @return bool Boolean representing if `_minter` is minterContract. */ function isMintWhitelisted(address _minter) external view returns (bool) { return (minterContract == _minter); } /** * @notice Gets qty of randomizers in history of all randomizers used by * this core contract. If a randomizer is switched away from then back to, * it will show up in the history twice. * @return randomizerHistoryCount Count of randomizers in history */ function numHistoricalRandomizers() external view returns (uint256) { return _historicalRandomizerAddresses.length; } /** * @notice Gets address of randomizer at index `_index` in history of all * randomizers used by this core contract. Index is zero-based. * @param _index Historical index of randomizer to be queried. * @return randomizerAddress Address of randomizer at index `_index`. * @dev If a randomizer is switched away from and then switched back to, it * will show up in the history twice. */ function getHistoricalRandomizerAt( uint256 _index ) external view returns (address) { require( _index < _historicalRandomizerAddresses.length, "Index out of bounds" ); return _historicalRandomizerAddresses[_index]; } /** * @notice Gets royalty Basis Points (BPS) for token ID `_tokenId`. * This conforms to the IManifold interface designated in the Royalty * Registry's RoyaltyEngineV1.sol contract. * ref: https://github.com/manifoldxyz/royalty-registry-solidity * @param _tokenId Token ID to be queried. * @return recipients Array of royalty payment recipients * @return bps Array of Basis Points (BPS) allocated to each recipient, * aligned by index. * @dev reverts if invalid _tokenId * @dev only returns recipients that have a non-zero BPS allocation */ function getRoyalties( uint256 _tokenId ) external view returns (address payable[] memory recipients, uint256[] memory bps) { _onlyValidTokenId(_tokenId); // initialize arrays with maximum potential length recipients = new address payable[](4); bps = new uint256[](4); uint256 projectId = tokenIdToProjectId(_tokenId); ProjectFinance storage projectFinance = projectIdToFinancials[ projectId ]; // load values into memory uint256 royaltyPercentageForArtistAndAdditional = projectFinance .secondaryMarketRoyaltyPercentage; uint256 additionalPayeePercentage = projectFinance .additionalPayeeSecondarySalesPercentage; // calculate BPS = percentage * 100 uint256 artistBPS = (ONE_HUNDRED - additionalPayeePercentage) * royaltyPercentageForArtistAndAdditional; uint256 additionalBPS = additionalPayeePercentage * royaltyPercentageForArtistAndAdditional; uint256 renderProviderBPS = renderProviderSecondarySalesBPS; uint256 platformProviderBPS = platformProviderSecondarySalesBPS; // populate arrays uint256 payeeCount; if (artistBPS > 0) { recipients[payeeCount] = projectFinance.artistAddress; bps[payeeCount++] = artistBPS; } if (additionalBPS > 0) { recipients[payeeCount] = projectFinance .additionalPayeeSecondarySales; bps[payeeCount++] = additionalBPS; } if (renderProviderBPS > 0) { recipients[payeeCount] = renderProviderSecondarySalesAddress; bps[payeeCount++] = renderProviderBPS; } if (platformProviderBPS > 0) { recipients[payeeCount] = platformProviderSecondarySalesAddress; bps[payeeCount++] = platformProviderBPS; } // trim arrays if necessary if (4 > payeeCount) { assembly { let decrease := sub(4, payeeCount) mstore(recipients, sub(mload(recipients), decrease)) mstore(bps, sub(mload(bps), decrease)) } } return (recipients, bps); } /** * @notice View function that returns appropriate revenue splits between * different render provider, platform provider, Artist, and Artist's * additional primary sales payee given a sale price of `_price` on * project `_projectId`. * This always returns four revenue amounts and four addresses, but if a * revenue is zero for either Artist or additional payee, the corresponding * address returned will also be null (for gas optimization). * Does not account for refund if user overpays for a token (minter should * handle a refund of the difference, if appropriate). * Some minters may have alternative methods of splitting payments, in * which case they should implement their own payment splitting logic. * @param _projectId Project ID to be queried. * @param _price Sale price of token. * @return renderProviderRevenue_ amount of revenue to be sent to the * render provider * @return renderProviderAddress_ address to send render provider revenue to * @return platformProviderRevenue_ amount of revenue to be sent to the * platform provider * @return platformProviderAddress_ address to send platform provider revenue to * @return artistRevenue_ amount of revenue to be sent to Artist * @return artistAddress_ address to send Artist revenue to. Will be null * if no revenue is due to artist (gas optimization). * @return additionalPayeePrimaryRevenue_ amount of revenue to be sent to * additional payee for primary sales * @return additionalPayeePrimaryAddress_ address to send Artist's * additional payee for primary sales revenue to. Will be null if no * revenue is due to additional payee for primary sales (gas optimization). * @dev this always returns four addresses and four revenues, but if the * revenue is zero, the corresponding address will be address(0). It is up * to the contract performing the revenue split to handle this * appropriately. */ 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_ ) { ProjectFinance storage projectFinance = projectIdToFinancials[ _projectId ]; // calculate revenues – this is a three-way split between the // render provider, the platform provider, and the artist, and // is safe to perform this given that in the case of loss of // precision Solidity will round down. uint256 projectFunds = _price; renderProviderRevenue_ = (_price * uint256(_renderProviderPrimarySalesPercentage)) / ONE_HUNDRED; // renderProviderRevenue_ percentage is always <=100, so guaranteed to never underflow projectFunds -= renderProviderRevenue_; platformProviderRevenue_ = (_price * uint256(_platformProviderPrimarySalesPercentage)) / ONE_HUNDRED; // platformProviderRevenue_ percentage is always <=100, so guaranteed to never underflow projectFunds -= platformProviderRevenue_; additionalPayeePrimaryRevenue_ = (projectFunds * projectFinance.additionalPayeePrimarySalesPercentage) / ONE_HUNDRED; // projectIdToAdditionalPayeePrimarySalesPercentage is always // <=100, so guaranteed to never underflow artistRevenue_ = projectFunds - additionalPayeePrimaryRevenue_; // set addresses from storage renderProviderAddress_ = renderProviderPrimarySalesAddress; platformProviderAddress_ = platformProviderPrimarySalesAddress; if (artistRevenue_ > 0) { artistAddress_ = projectFinance.artistAddress; } if (additionalPayeePrimaryRevenue_ > 0) { additionalPayeePrimaryAddress_ = projectFinance .additionalPayeePrimarySales; } } /** * @notice Returns external asset dependency for project `_projectId` at index `_index`. * If the dependencyType is ONCHAIN, the `data` field will contain the extrated bytecode data and `cid` * will be an empty string. Conversly, for any other dependencyType, the `data` field will be an empty string * and the `bytecodeAddress` will point to the zero address. */ function projectExternalAssetDependencyByIndex( uint256 _projectId, uint256 _index ) external view returns (ExternalAssetDependencyWithData memory) { ExternalAssetDependency storage _dependency = projects[_projectId] .externalAssetDependencies[_index]; address _bytecodeAddress = _dependency.bytecodeAddress; return ExternalAssetDependencyWithData({ dependencyType: _dependency.dependencyType, cid: _dependency.cid, bytecodeAddress: _bytecodeAddress, data: (_dependency.dependencyType == ExternalAssetDependencyType.ONCHAIN) ? _readFromBytecode(_bytecodeAddress) : "" }); } /** * @notice Returns external asset dependency count for project `_projectId` at index `_index`. */ function projectExternalAssetDependencyCount( uint256 _projectId ) external view returns (uint256) { return uint256(projects[_projectId].externalAssetDependencyCount); } /** * @notice Backwards-compatible (pre-V3) getter returning contract admin * @return address Address of contract admin (same as owner) */ function admin() external view returns (address) { return owner(); } /** * @notice Gets the project ID for a given `_tokenId`. * @param _tokenId Token ID to be queried. * @return _projectId Project ID for given `_tokenId`. */ function tokenIdToProjectId( uint256 _tokenId ) public pure returns (uint256 _projectId) { return _tokenId / ONE_MILLION; } /** * @notice Convenience function that returns whether `_sender` is allowed * to call function with selector `_selector` on contract `_contract`, as * determined by this contract's current Admin ACL contract. Expected use * cases include minter contracts checking if caller is allowed to call * admin-gated functions on minter contracts. * @param _sender Address of the sender calling function with selector * `_selector` on contract `_contract`. * @param _contract Address of the contract being called by `_sender`. * @param _selector Function selector of the function being called by * `_sender`. * @return bool Whether `_sender` is allowed to call function with selector * `_selector` on contract `_contract`. * @dev assumes the Admin ACL contract is the owner of this contract, which * is expected to always be true. * @dev adminACLContract is expected to either be null address (if owner * has renounced ownership), or conform to IAdminACLV0 interface. Check for * null address first to avoid revert when admin has renounced ownership. */ function adminACLAllowed( address _sender, address _contract, bytes4 _selector ) public returns (bool) { return owner() != address(0) && adminACLContract.allowed(_sender, _contract, _selector); } /** * @notice Returns contract owner. Set to deployer's address by default on * contract deployment. * @return address Address of contract owner. * @dev ref: https://docs.openzeppelin.com/contracts/4.x/api/access#Ownable * @dev owner role was called `admin` prior to V3 core contract */ function owner() public view override(Ownable, IGenArt721CoreContractV3_Base) returns (address) { return Ownable.owner(); } /** * @notice Gets token URI for token ID `_tokenId`. * @param _tokenId Token ID to be queried. * @return string URI of token ID `_tokenId`. * @dev token URIs are the concatenation of the project base URI and the * token ID. */ function tokenURI( uint256 _tokenId ) public view override returns (string memory) { _onlyValidTokenId(_tokenId); string memory _projectBaseURI = projects[tokenIdToProjectId(_tokenId)] .projectBaseURI; return string.concat(_projectBaseURI, toString(_tokenId)); } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface( bytes4 interfaceId ) public view virtual override returns (bool) { return interfaceId == type(IManifold).interfaceId || super.supportsInterface(interfaceId); } /** * @notice Forbids new projects from being created * @dev only performs operation and emits event if contract is not already * forbidding new projects. */ function _forbidNewProjects() internal { if (!newProjectsForbidden) { newProjectsForbidden = true; emit PlatformUpdated(FIELD_NEW_PROJECTS_FORBIDDEN); } } /** * @notice Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. * @param newOwner New owner. * @dev owner role was called `admin` prior to V3 core contract. * @dev Overrides and wraps OpenZeppelin's _transferOwnership function to * also update adminACLContract for improved introspection. */ function _transferOwnership(address newOwner) internal override { Ownable._transferOwnership(newOwner); adminACLContract = IAdminACLV0(newOwner); } /** * @notice Updates sales addresses for the platform and render providers to * the input parameters. * @param _renderProviderPrimarySalesAddress Address of new primary sales * payment address. * @param _renderProviderSecondarySalesAddress Address of new secondary sales * payment address. * @param _platformProviderPrimarySalesAddress Address of new primary sales * payment address. * @param _platformProviderSecondarySalesAddress Address of new secondary sales * payment address. * @dev Note that this method does not check that the input address is * not `address(0)`, as it is expected that callers of this method should * perform input validation where applicable. */ function _updateProviderSalesAddresses( address _renderProviderPrimarySalesAddress, address _renderProviderSecondarySalesAddress, address _platformProviderPrimarySalesAddress, address _platformProviderSecondarySalesAddress ) internal { platformProviderPrimarySalesAddress = payable( _platformProviderPrimarySalesAddress ); platformProviderSecondarySalesAddress = payable( _platformProviderSecondarySalesAddress ); renderProviderPrimarySalesAddress = payable( _renderProviderPrimarySalesAddress ); renderProviderSecondarySalesAddress = payable( _renderProviderSecondarySalesAddress ); emit PlatformUpdated(FIELD_PROVIDER_SALES_ADDRESSES); } /** * @notice Updates randomizer address to `_randomizerAddress`. * @param _randomizerAddress New randomizer address. * @dev Note that this method does not check that the input address is * not `address(0)`, as it is expected that callers of this method should * perform input validation where applicable. */ function _updateRandomizerAddress(address _randomizerAddress) internal { randomizerContract = IRandomizerV2(_randomizerAddress); // populate historical randomizer array _historicalRandomizerAddresses.push(_randomizerAddress); emit PlatformUpdated(FIELD_RANDOMIZER_ADDRESS); } /** * @notice Updates default base URI to `_defaultBaseURI`. * When new projects are added, their `projectBaseURI` is automatically * initialized to `_defaultBaseURI`. * @param _defaultBaseURI New default base URI. * @dev Note that this method does not check that the input string is not * the empty string, as it is expected that callers of this method should * perform input validation where applicable. */ function _updateDefaultBaseURI(string memory _defaultBaseURI) internal { defaultBaseURI = _defaultBaseURI; emit PlatformUpdated(FIELD_DEFAULT_BASE_URI); } /** * @notice Internal function to complete a project. * @param _projectId Project ID to be completed. */ function _completeProject(uint256 _projectId) internal { projects[_projectId].completedTimestamp = uint64(block.timestamp); emit ProjectUpdated(_projectId, FIELD_PROJECT_COMPLETED); } /** * @notice Internal function that returns whether a project is unlocked. * Projects automatically lock four weeks after they are completed. * Projects are considered completed when they have been invoked the * maximum number of times. * @param _projectId Project ID to be queried. * @return bool true if project is unlocked, false otherwise. * @dev This also enforces that the `_projectId` passed in is valid. */ function _projectUnlocked(uint256 _projectId) internal view returns (bool) { _onlyValidProjectId(_projectId); uint256 projectCompletedTimestamp = projects[_projectId] .completedTimestamp; bool projectOpen = projectCompletedTimestamp == 0; return projectOpen || (block.timestamp - projectCompletedTimestamp < FOUR_WEEKS_IN_SECONDS); } /** * Helper for calling `BytecodeStorageReader` external library reader method, * added for bytecode size reduction purposes. */ function _readFromBytecode( address _address ) internal view returns (string memory) { return BytecodeStorageReader.readFromBytecode(_address); } // strings library from OpenZeppelin, modified for no constants bytes16 private _HEX_SYMBOLS = "0123456789abcdef"; uint8 private _ADDRESS_LENGTH = 20; /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { // Inspired by OraclizeAPI's implementation - MIT licence // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol if (value == 0) { return "0"; } uint256 temp = value; uint256 digits; while (temp != 0) { digits++; temp /= 10; } bytes memory buffer = new bytes(digits); while (value != 0) { digits -= 1; buffer[digits] = bytes1(uint8(48 + uint256(value % 10))); value /= 10; } return string(buffer); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString( uint256 value, uint256 length ) internal view returns (string memory) { bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = _HEX_SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "hex length insufficient"); return string(buffer); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation. */ function toHexString(address addr) internal view returns (string memory) { return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH); } }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. // @dev fixed to specific solidity version for clarity and for more clear // source code verification purposes. pragma solidity ^0.8.17; import {IMinterFilterV1} from "../../interfaces/v0.8.x/IMinterFilterV1.sol"; import {ISharedMinterV0} from "../../interfaces/v0.8.x/ISharedMinterV0.sol"; import {IGenArt721CoreContractV3_Base} from "../../interfaces/v0.8.x/IGenArt721CoreContractV3_Base.sol"; import {ICoreRegistryV1} from "../../interfaces/v0.8.x/ICoreRegistryV1.sol"; import {IAdminACLV0} from "../../interfaces/v0.8.x/IAdminACLV0.sol"; import {Bytes32Strings} from "../../libs/v0.8.x/Bytes32Strings.sol"; import {Ownable} from "@openzeppelin-4.7/contracts/access/Ownable.sol"; import {EnumerableMap} from "@openzeppelin-4.7/contracts/utils/structs/EnumerableMap.sol"; import {EnumerableSet} from "@openzeppelin-4.7/contracts/utils/structs/EnumerableSet.sol"; import {Math} from "@openzeppelin-4.7/contracts/utils/math/Math.sol"; /** * @title MinterFilterV2 * @dev At the time of deployment, this contract is intended to be used with * core contracts that implement IGenArt721CoreContractV3_Base. * @author Art Blocks Inc. * @notice This Minter Filter V2 contract allows minters to be set on a * per-project basis, for any registered core contract. This minter filter does * not extend the previous version of the minter filters, as the previous * version is not compatible with multiple core contracts. * * This contract is designed to be managed by an Admin ACL contract, as well as * delegated privileges to core contract artists and Admin ACL contracts. * These roles hold extensive power and can arbitrarily control and modify * how a project's tokens may be minted. * Care must be taken to ensure that the admin ACL contract and artist * addresses are secure behind a multi-sig or other access control mechanism. * ---------------------------------------------------------------------------- * The following functions are restricted as allowed by this contract's Admin * ACL: * - updateCoreRegistry * - approveMinterGlobally * - revokeMinterGlobally * ---------------------------------------------------------------------------- * The following functions are restricted as allowed by each core contract's * Admin ACL contract: * - approveMinterForContract * - revokeMinterForContract * - removeMintersForProjectsOnContract * ---------------------------------------------------------------------------- * The following functions are restricted as allowed by each core contract's * Admin ACL contract, or to the artist address of the project: * - setMinterForProject * - removeMinterForProject * ---------------------------------------------------------------------------- * Additional admin and artist privileged roles may be described on minters, * registries, and other contracts that may interact with this contract. */ contract MinterFilterV2 is Ownable, IMinterFilterV1 { // add Enumerable Map, Enumerable Set methods using EnumerableMap for EnumerableMap.UintToAddressMap; using EnumerableSet for EnumerableSet.AddressSet; // add Bytes32Strings methods using Bytes32Strings for bytes32; /// @notice Version of this minter filter contract // @dev use function minterFilterVersion to get this as a string bytes32 constant MINTER_FILTER_VERSION = "v2.0.0"; /// @notice Type of this minter filter contract // @dev use function minterFilterType to get this as a string bytes32 constant MINTER_FILTER_TYPE = "MinterFilterV2"; /// @notice Admin ACL contract for this minter filter IAdminACLV0 public adminACLContract; /** * @notice Core registry, that tracks all registered core contracts */ ICoreRegistryV1 public coreRegistry; /// @notice Minter address => qty projects across all core contracts currently /// using the minter mapping(address minterAddress => uint256 numProjects) public numProjectsUsingMinter; /** * @notice Enumerable Set of globally approved minters. * This is a Set of addresses that are approved to mint on any * project, for any core contract. * @dev note that contract admins can extend a separate Set of minters for * their core contract via the `approveMinterForContract` function. */ EnumerableSet.AddressSet private _globallyApprovedMinters; /** * @notice Mapping of core contract addresses to Enumerable Sets of approved * minters for that core contract. * @dev note that contract admins can extend this Set for their core * contract by via the `approveMinterForContract` function, and can remove * minters from this Set via the `revokeMinterForContract` function. */ mapping(address coreContract => EnumerableSet.AddressSet approvedMintersForContract) private _contractApprovedMinters; /** * @notice Mapping of core contract addresses to Enumerable Maps of project IDs to * minter addresses. */ mapping(address coreContract => EnumerableMap.UintToAddressMap projectIdToMinterAddress) private _minterForProject; /** * @notice Function to validate an address is non-zero. * @param address_ Address to validate */ function _onlyNonZeroAddress(address address_) internal pure { require(address_ != address(0), "Only non-zero address"); } /** * @notice Function to restrict access to only AdminACL allowed calls * on this minter filter's admin ACL contract. * @param selector function selector to be checked */ function _onlyAdminACL(bytes4 selector) internal { require( adminACLAllowed(msg.sender, address(this), selector), "Only Admin ACL allowed" ); } /** * @notice Function to restrict access to only AdminACL allowed calls * on a given core contract. * @dev defers to the ACL contract used by the core contract * @param coreContract core contract address * @param selector function selector to be checked */ function _onlyCoreAdminACL(address coreContract, bytes4 selector) internal { require( IGenArt721CoreContractV3_Base(coreContract).adminACLAllowed({ _sender: msg.sender, _contract: address(this), _selector: selector }), "Only Core AdminACL allowed" ); } /** * @notice Function to restrict access to only core AdminACL or the project artist. * @dev Defers to the ACL contract used by the core contract * @param coreContract core contract address * @param selector function selector to be checked */ function _onlyCoreAdminACLOrArtist( uint256 projectId, address coreContract, bytes4 selector ) internal { IGenArt721CoreContractV3_Base genArtCoreContract_Base = IGenArt721CoreContractV3_Base( coreContract ); require( (msg.sender == genArtCoreContract_Base.projectIdToArtistAddress(projectId)) || ( genArtCoreContract_Base.adminACLAllowed({ _sender: msg.sender, _contract: address(this), _selector: selector }) ), "Only Artist or Core Admin ACL" ); } /** * @notice Function to restrict access to only core contracts registered with the * currently configured core registry. This is used to prevent non-registered core * contracts from being used with this minter filter. * @param coreContract core contract address */ function _onlyRegisteredCoreContract(address coreContract) internal view { // @dev use core registry to check if core contract is registered require( coreRegistry.isRegisteredContract(coreContract), "Only registered core contract" ); } /** * @notice Function to restrict access to only valid project IDs. * @param projectId Project ID to validate. * @param coreContract core contract address */ function _onlyValidProjectId( uint256 projectId, address coreContract ) internal view { IGenArt721CoreContractV3_Base genArtCoreContract = IGenArt721CoreContractV3_Base( coreContract ); require( (projectId >= genArtCoreContract.startingProjectId()) && (projectId < genArtCoreContract.nextProjectId()), "Only valid project ID" ); } /** * @notice Function to check if minter is globally approved or approved for a core contract. * @param coreContract core contract address * @param minter Minter to validate. */ function _onlyApprovedMinter( address coreContract, address minter ) internal view { require( isApprovedMinterForContract({ coreContract: coreContract, minter: minter }), "Only approved minters" ); } /** * @notice Initializes contract to be a Minter for `genArt721Address`. * @param adminACLContract_ Address of admin access control contract, to be * set as contract owner. * @param coreRegistry_ Address of core registry contract. */ constructor(address adminACLContract_, address coreRegistry_) { // set AdminACL management contract as owner _transferOwnership(adminACLContract_); // set core registry contract _updateCoreRegistry(coreRegistry_); emit Deployed(); } /** * @notice returns the version of this minter filter contract */ function minterFilterVersion() external pure returns (string memory) { return MINTER_FILTER_VERSION.toString(); } /** * @notice returns the type of this minter filter contract */ function minterFilterType() external pure returns (string memory) { return MINTER_FILTER_TYPE.toString(); } /** * @notice Updates the core registry contract to be used by this contract. * Only callable as allowed by AdminACL of this contract. * @param coreRegistry_ Address of the new core registry contract. */ function updateCoreRegistry(address coreRegistry_) external { _onlyAdminACL(this.updateCoreRegistry.selector); _updateCoreRegistry(coreRegistry_); } /** * @notice Globally approves minter `minter` to be available for * minting on any project, for any core contract. * Only callable as allowed by AdminACL of this contract. * @dev Reverts if minter is already globally approved, or does not * implement minterType(). * @param minter Minter to be approved. */ function approveMinterGlobally(address minter) external { _onlyAdminACL(this.approveMinterGlobally.selector); // @dev add() return true if the value was added to the set require( _globallyApprovedMinters.add(minter), "Minter already approved" ); emit MinterApprovedGlobally({ minter: minter, minterType: ISharedMinterV0(minter).minterType() }); } /** * @notice Removes previously globally approved minter `minter` * from the list of globally approved minters. * Only callable as allowed by AdminACL of this contract. * Reverts if minter is not globally approved. * @dev intentionally do not check if minter is still in use by any * project, meaning that any projects currently using the minter will * continue to be able to use it. If existing projects should be forced * to discontinue using a minter, the minter may be removed by the minter * filter admin in bulk via the `removeMintersForProjectsOnContract` * function. * @param minter Minter to remove. */ function revokeMinterGlobally(address minter) external { _onlyAdminACL(this.revokeMinterGlobally.selector); // @dev remove() returns true only if the value was already in the Set require( _globallyApprovedMinters.remove(minter), "Only previously approved minter" ); emit MinterRevokedGlobally(minter); } /** * @notice Approves minter `minter` to be available for minting on * any project on core contarct `coreContract`. * Only callable as allowed by AdminACL of core contract `coreContract`. * Reverts if core contract is not registered, if minter is already * approved for the contract, or if minter does not implement minterType(). * @param coreContract Core contract to approve minter for. * @param minter Minter to be approved. */ function approveMinterForContract( address coreContract, address minter ) external { _onlyRegisteredCoreContract(coreContract); _onlyCoreAdminACL({ coreContract: coreContract, selector: this.approveMinterForContract.selector }); // @dev add() returns true if the value was added to the Set require( _contractApprovedMinters[coreContract].add(minter), "Minter already approved" ); emit MinterApprovedForContract({ coreContract: coreContract, minter: minter, minterType: ISharedMinterV0(minter).minterType() }); } /** * @notice Removes previously approved minter `minter` from the * list of approved minters on core contract `coreContract`. * Only callable as allowed by AdminACL of core contract `coreContract`. * Reverts if core contract is not registered, or if minter is not approved * on contract. * @dev intentionally does not check if minter is still in use by any * project, meaning that any projects currently using the minter will * continue to be able to use it. If existing projects should be forced * to discontinue using a minter, the minter may be removed by the contract * admin in bulk via the `removeMintersForProjectsOnContract` function. * @param coreContract Core contract to remove minter from. * @param minter Minter to remove. */ function revokeMinterForContract( address coreContract, address minter ) external { _onlyRegisteredCoreContract(coreContract); _onlyCoreAdminACL({ coreContract: coreContract, selector: this.revokeMinterForContract.selector }); // @dev intentionally do not check if minter is still in use by any // project, since it is possible that a different contract's project is // using the minter // @dev remove() returns true only if the value was already in the Set require( _contractApprovedMinters[coreContract].remove(minter), "Only previously approved minter" ); emit MinterRevokedForContract({ coreContract: coreContract, minter: minter }); } /** * @notice Sets minter for project `projectId` on contract `coreContract` * to minter `minter`. * Only callable by the project's artist or as allowed by AdminACL of * core contract `coreContract`. * Reverts if: * - core contract is not registered * - minter is not approved globally on this minter filter or for the * project's core contract * - project is not valid on the core contract * - function is called by an address other than the project's artist * or a sender allowed by the core contract's admin ACL * - minter does not implement minterType() * @param projectId Project ID to set minter for. * @param coreContract Core contract of project. * @param minter Minter to be the project's minter. */ function setMinterForProject( uint256 projectId, address coreContract, address minter ) external { /// CHECKS _onlyRegisteredCoreContract(coreContract); _onlyCoreAdminACLOrArtist({ projectId: projectId, coreContract: coreContract, selector: this.setMinterForProject.selector }); _onlyApprovedMinter({coreContract: coreContract, minter: minter}); _onlyValidProjectId({projectId: projectId, coreContract: coreContract}); /// EFFECTS // decrement number of projects using a previous minter (bool hasPreviousMinter, address previousMinter) = _minterForProject[ coreContract ].tryGet(projectId); if (hasPreviousMinter) { numProjectsUsingMinter[previousMinter]--; } // assign new minter numProjectsUsingMinter[minter]++; _minterForProject[coreContract].set(projectId, minter); emit ProjectMinterRegistered({ projectId: projectId, coreContract: coreContract, minter: minter, minterType: ISharedMinterV0(minter).minterType() }); } /** * @notice Updates project `projectId` on contract `coreContract` to have * no configured minter. * Only callable by the project's artist or as allowed by AdminACL of * core contract `coreContract`. * Reverts if: * - core contract is not registered * - project does not already have a minter assigned * - function is called by an address other than the project's artist * or a sender allowed by the core contract's admin ACL * @param projectId Project ID to remove minter for. * @param coreContract Core contract of project. * @dev requires project to have an assigned minter */ function removeMinterForProject( uint256 projectId, address coreContract ) external { _onlyRegisteredCoreContract(coreContract); _onlyCoreAdminACLOrArtist({ projectId: projectId, coreContract: coreContract, selector: this.removeMinterForProject.selector }); // @dev this will revert if project does not have a minter _removeMinterForProject({ projectId: projectId, coreContract: coreContract }); } /** * @notice Updates an array of project IDs to have no configured minter. * Only callable as allowed by AdminACL of core contract `coreContract`. * Reverts if the core contract is not registered, or if any project does * not already have a minter assigned. * @param projectIds Array of project IDs to remove minters for. * @param coreContract Core contract of projects. * @dev caution with respect to single tx gas limits */ function removeMintersForProjectsOnContract( uint256[] calldata projectIds, address coreContract ) external { _onlyRegisteredCoreContract(coreContract); _onlyCoreAdminACL({ coreContract: coreContract, selector: this.removeMintersForProjectsOnContract.selector }); uint256 numProjects = projectIds.length; for (uint256 i; i < numProjects; ) { _removeMinterForProject({ projectId: projectIds[i], coreContract: coreContract }); unchecked { ++i; } } } /** * @notice Mint a token from project `projectId` on contract * `coreContract` to `to`, originally purchased by `sender`. * @param to The new token's owner. * @param projectId Project ID to mint a new token on. * @param sender Address purchasing a new token. * @param coreContract Core contract of project. * @return tokenId Token ID of minted token * @dev reverts w/nonexistent key error when project has no assigned minter * @dev does not check if core contract is registered, for gas efficiency * and because project must have already been assigned a minter, which * requires the core contract to have been previously registered. If core * contract was unregistered but the project still has an assigned minter, * minting will remain possible. * @dev function name is optimized for gas. */ function mint_joo( address to, uint256 projectId, address coreContract, address sender ) external returns (uint256 tokenId) { // CHECKS // minter is the project's minter require( msg.sender == _minterForProject[coreContract].get(projectId), "Only assigned minter" ); // INTERACTIONS tokenId = IGenArt721CoreContractV3_Base(coreContract).mint_Ecf({ _to: to, _projectId: projectId, _by: sender }); return tokenId; } /** * @notice Gets the assigned minter for project `projectId` on core * contract `coreContract`. * Reverts if project does not have an assigned minter. * @param projectId Project ID to query. * @param coreContract Core contract of project. * @return address Minter address assigned to project * @dev requires project to have an assigned minter * @dev this function intentionally does not check that the core contract * is registered, since it must have been registered at the time the * project was assigned a minter */ function getMinterForProject( uint256 projectId, address coreContract ) external view returns (address) { // @dev use tryGet to control revert message if no minter assigned (bool hasMinter, address currentMinter) = _minterForProject[ coreContract ].tryGet(projectId); require(hasMinter, "No minter assigned"); return currentMinter; } /** * @notice Queries if project `projectId` on core contract `coreContract` * has an assigned minter. * @param projectId Project ID to query. * @param coreContract Core contract of project. * @return bool true if project has an assigned minter, else false * @dev requires project to have an assigned minter * @dev this function intentionally does not check that the core contract * is registered, since it must have been registered at the time the * project was assigned a minter */ function projectHasMinter( uint256 projectId, address coreContract ) external view returns (bool) { (bool hasMinter, ) = _minterForProject[coreContract].tryGet(projectId); return hasMinter; } /** * @notice Gets quantity of projects on a given core contract that have * assigned minters. * @param coreContract Core contract to query. * @return uint256 quantity of projects that have assigned minters * @dev this function intentionally does not check that the core contract * is registered, since it must have been registered at the time the * project was assigned a minter */ function getNumProjectsOnContractWithMinters( address coreContract ) external view returns (uint256) { return _minterForProject[coreContract].length(); } /** * @notice Get project ID and minter address at index `index` of * enumerable map. * @param coreContract Core contract to query. * @param index enumerable map index to query. * @return projectId project ID at index `index` * @return minterAddress minter address for project at index `index` * @return minterType minter type of minter at minterAddress * @dev index must be < quantity of projects that have assigned minters, * otherwise reverts * @dev reverts if minter does not implement minterType() function * @dev this function intentionally does not check that the core contract * is registered, since it must have been registered at the time the * project was assigned a minter */ function getProjectAndMinterInfoOnContractAt( address coreContract, uint256 index ) external view returns ( uint256 projectId, address minterAddress, string memory minterType ) { // @dev at() reverts if index is out of bounds (projectId, minterAddress) = _minterForProject[coreContract].at(index); minterType = ISharedMinterV0(minterAddress).minterType(); } /** * @notice View that returns if a core contract is registered with the * core registry, allowing this minter filter to service it. * @param coreContract core contract address to be checked * @return bool true if core contract is registered, else false */ function isRegisteredCoreContract( address coreContract ) external view override returns (bool) { return coreRegistry.isRegisteredContract(coreContract); } /** * @notice Gets all projects on core contract `coreContract` that are * using minter `minter`. * Warning: Unbounded gas limit. This function is gas-intensive and should * only be used for off-chain queries. Alternatively, the subgraph indexing * layer may be used to query these values. * @param coreContract core contract to query * @param minter minter to query */ function getProjectsOnContractUsingMinter( address coreContract, address minter ) external view returns (uint256[] memory projectIds) { EnumerableMap.UintToAddressMap storage minterMap = _minterForProject[ coreContract ]; // initialize arrays with maximum potential length // @dev use lesser of num projects using minter across all contracts // and number of projects on the contract with minters assigned, since // both values represent an upper bound on the number of projects that // could be using the minter on the contract uint256 maxNumProjects = Math.min( numProjectsUsingMinter[minter], minterMap.length() ); projectIds = new uint256[](maxNumProjects); // iterate over all projects on contract, adding to array if using // `minter` uint256 numProjects = minterMap.length(); uint256 numProjectsOnContractUsingMinter; for (uint256 i; i < numProjects; ) { (uint256 projectId, address minter_) = minterMap.at(i); unchecked { if (minter_ == minter) { projectIds[numProjectsOnContractUsingMinter++] = projectId; } ++i; } } // trim array if necessary if (maxNumProjects > numProjectsOnContractUsingMinter) { assembly ("memory-safe") { mstore(projectIds, numProjectsOnContractUsingMinter) } } return projectIds; } /** * @notice Gets all minters that are globally approved on this minter * filter. Returns an array of MinterWithType structs, which contain the * minter address and minter type. * This function has unbounded gas, and should only be used for off-chain * queries. * Alternatively, the subgraph indexing layer may be used to query these * values. * @return mintersWithTypes Array of MinterWithType structs, which contain * the minter address and minter type. */ function getAllGloballyApprovedMinters() external view returns (MinterWithType[] memory mintersWithTypes) { // initialize arrays with appropriate length uint256 numMinters = _globallyApprovedMinters.length(); mintersWithTypes = new MinterWithType[](numMinters); // iterate over all globally approved minters, adding to array for (uint256 i; i < numMinters; ) { address minterAddress = _globallyApprovedMinters.at(i); // @dev we know minterType() does not revert, because it was called // when globally approving the minter string memory minterType = ISharedMinterV0(minterAddress) .minterType(); mintersWithTypes[i] = MinterWithType({ minterAddress: minterAddress, minterType: minterType }); unchecked { ++i; } } } /** * @notice Gets all minters that are approved for a specific core contract. * Returns an array of MinterWithType structs, which contain the minter * address and minter type. * This function has unbounded gas, and should only be used for off-chain * queries. * @param coreContract Core contract to query. * @return mintersWithTypes Array of MinterWithType structs, which contain * the minter address and minter type. */ function getAllContractApprovedMinters( address coreContract ) external view returns (MinterWithType[] memory mintersWithTypes) { // initialize arrays with appropriate length EnumerableSet.AddressSet storage contractApprovedMinters = _contractApprovedMinters[ coreContract ]; uint256 numMinters = contractApprovedMinters.length(); mintersWithTypes = new MinterWithType[](numMinters); // iterate over all minters approved for a given contract, adding to // array for (uint256 i; i < numMinters; ) { address minterAddress = contractApprovedMinters.at(i); // @dev we know minterType() does not revert, because it was called // when approving the minter for a contract string memory minterType = ISharedMinterV0(minterAddress) .minterType(); mintersWithTypes[i] = MinterWithType({ minterAddress: minterAddress, minterType: minterType }); unchecked { ++i; } } } /** * @notice Convenience function that returns whether `sender` is allowed * to call function with selector `selector` on contract `contract`, as * determined by this contract's current Admin ACL contract. Expected use * cases include minter contracts checking if caller is allowed to call * admin-gated functions on minter contracts. * @param sender Address of the sender calling function with selector * `selector` on contract `contract`. * @param contract_ Address of the contract being called by `sender`. * @param selector Function selector of the function being called by * `sender`. * @return bool Whether `sender` is allowed to call function with selector * `selector` on contract `contract`. * @dev assumes the Admin ACL contract is the owner of this contract, which * is expected to always be true. * @dev adminACLContract is expected to not be null address (owner cannot * renounce ownership on this contract), and conform to IAdminACLV0 * interface. */ function adminACLAllowed( address sender, address contract_, bytes4 selector ) public returns (bool) { return adminACLContract.allowed({ _sender: sender, _contract: contract_, _selector: selector }); } /** * @notice Returns whether `minter` is globally approved to mint tokens * on any contract. * @param minter Address of minter to check. */ function isGloballyApprovedMinter( address minter ) public view returns (bool) { return _globallyApprovedMinters.contains(minter); } /** * @notice Returns whether `minter` is approved to mint tokens on * core contract `coreContract`. * @param coreContract Address of core contract to check. * @param minter Address of minter to check. */ function isApprovedMinterForContract( address coreContract, address minter ) public view returns (bool) { return isGloballyApprovedMinter(minter) || _contractApprovedMinters[coreContract].contains(minter); } /** * @notice Returns contract owner. Set to deployer's address by default on * contract deployment. * @return address Address of contract owner. * @dev ref: https://docs.openzeppelin.com/contracts/4.x/api/access#Ownable * @dev owner role was called `admin` prior to V3 core contract */ function owner() public view override(Ownable, IMinterFilterV1) returns (address) { return Ownable.owner(); } /// @dev override to prevent renouncing ownership /// @dev not permission gated since this immediately reverts function renounceOwnership() public pure override { revert("Cannot renounce ownership"); } /** * @notice Updates project `projectId` to have no configured minter * Reverts if project does not already have an assigned minter. * @param projectId Project ID to remove minter. * @param coreContract Core contract of project. * @dev requires project to have an assigned minter * @dev this function intentionally does not check that the core contract * is registered, since it must have been registered at the time the * project was assigned a minter */ function _removeMinterForProject( uint256 projectId, address coreContract ) internal { // remove minter for project and emit // @dev `minterForProject.get()` reverts tx if no minter set for project numProjectsUsingMinter[ _minterForProject[coreContract].get(projectId, "No minter assigned") ]--; _minterForProject[coreContract].remove(projectId); emit ProjectMinterRemoved({ projectId: projectId, coreContract: coreContract }); } /** * @notice Transfers ownership of the contract to a new account (`owner`). * Internal function without access restriction. * @param owner_ New owner. * @dev owner role was called `admin` prior to V3 core contract. * @dev Overrides and wraps OpenZeppelin's _transferOwnership function to * also update adminACLContract for improved introspection. */ function _transferOwnership(address owner_) internal override { Ownable._transferOwnership(owner_); adminACLContract = IAdminACLV0(owner_); } /** * @notice Updates this contract's core registry contract to * `coreRegistry`. * @param coreRegistry_ New core registry contract address. */ function _updateCoreRegistry(address coreRegistry_) internal { _onlyNonZeroAddress(coreRegistry_); coreRegistry = ICoreRegistryV1(coreRegistry_); emit CoreRegistryUpdated(coreRegistry_); } }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.0; /** * @title ISharedMinterRequired * @notice This interface contains the minimum required interface for a shared * minter contract. All custom, one-off minter contracts should implement this * interface. */ interface ISharedMinterRequired { // Function returns the minter type, and is called by the MinterFilter for // metadata purposes. function minterType() external view returns (string memory); // Function returns the minter's associated shared minter filter address, // and is called by subgraph indexing service for entity relation purposes. function minterFilterAddress() external returns (address); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; uint256 constant ARTBLOCKS_ENGINE_PROJECT_MULTIPLIER = 1_000_000; /** * @notice Converts an Artblocks projectId + editionId (i.e. the ID of the token within the given project) to a tokenId. */ function artblocksTokenID(uint256 projectId, uint256 editionId) pure returns (uint256) { return (projectId * ARTBLOCKS_ENGINE_PROJECT_MULTIPLIER) + editionId; }
// SPDX-License-Identifier: MIT // Copyright 2023 PROOF Holdings Inc pragma solidity ^0.8.15; import {ERC721A, ERC721ACommon, BaseTokenURI, ERC721ACommonBaseTokenURI} from "ethier/erc721/BaseTokenURI.sol"; import {ERC721ACommonOperatorFilterOS} from "solidifylabs/ethier/erc721/ERC721ACommonOperatorFilterOS.sol"; import {SellableERC721ACommon} from "solidifylabs/sellers/sellable/SellableERC721ACommon.sol"; import {SellableERC721ACommonByProjectID} from "solidifylabs/sellers/sellable/SellableERC721ACommonByProjectID.sol"; /** * @title Project Pool Sellable * @notice A pool of sequentially indexed, sellable projects with max supply * @author David Huber (@cxkoda) * @custom:reviewer Arran Schlosberg (@divergencearran) * @custom:reviewer Josh Laird (@jbmlaird) */ abstract contract ProjectPoolSellable is ERC721ACommonBaseTokenURI, ERC721ACommonOperatorFilterOS, SellableERC721ACommonByProjectID { // ================================================================================================================= // Errors // ================================================================================================================= /** * @notice Thrown if a user attempts to purchase tokens from an exhausted project. */ error ProjectExhausted(uint128 projectId); /** * @notice Thrown if a user attempts to purchase tokens from an invalid project. */ error InvalidProject(uint128 projectId); // ================================================================================================================= // Construction // ================================================================================================================= struct Init { address admin; address steerer; string name; string symbol; string baseURI; address payable royaltyReciever; uint96 royaltyBasisPoints; } constructor(Init memory init) ERC721ACommon(init.admin, init.steerer, init.name, init.symbol, init.royaltyReciever, init.royaltyBasisPoints) BaseTokenURI(init.baseURI) {} // ================================================================================================================= // Configuration // ================================================================================================================= /** * @notice Returns the number of available project. * @dev Intended to be implemented by the inheriting contract. */ function _numProjects() internal view virtual returns (uint128); /** * @notice Returns the number of tokens than can be minted per project. * @param projectId The project ID in `[0, _numProjects())`. * @dev Intended to be implemented by the inheriting contract. */ function _maxNumPerProject(uint128 projectId) internal view virtual returns (uint64); // ================================================================================================================= // Selling // ================================================================================================================= /** * @inheritdoc SellableERC721ACommonByProjectID * @dev Ensures that the configured project bounds are not exceeded. */ function _handleProjectMinted( /* tokenId */ uint256, uint128 projectId, uint64 edition) internal virtual override { if (projectId >= _numProjects()) { revert InvalidProject(projectId); } if (edition >= _maxNumPerProject(projectId)) { revert ProjectExhausted(projectId); } } // ================================================================================================================= // Metadata // ================================================================================================================= /** * @notice Returns all tokenIds for a given project. * @dev Intended for front-end consumption and not optimised for gas. */ function tokenIdsByProjectId(uint128 projectId) external view returns (uint256[] memory) { uint256[] memory tokenIds = new uint256[](numPurchasedPerProject(projectId)); uint256 cursor; uint256 supply = totalSupply(); for (uint256 tokenId = 0; tokenId < supply; ++tokenId) { if (tokenInfo(tokenId).projectId == projectId) { tokenIds[cursor++] = tokenId; } } return tokenIds; } /** * @notice Returns the number of tokens purchased for each project. * @dev Intended for front-end consumption and not optimised for gas. */ function numPurchasedPerProject() external view returns (uint64[] memory) { uint128 num = _numProjects(); uint64[] memory numPurchased = new uint64[](num); for (uint128 i = 0; i < num; i++) { numPurchased[i] = numPurchasedPerProject(i); } return numPurchased; } // ================================================================================================================= // Inheritance resolution // ================================================================================================================= function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721ACommon, ERC721ACommonBaseTokenURI, SellableERC721ACommon) returns (bool) { return ERC721ACommonBaseTokenURI.supportsInterface(interfaceId); } function _baseURI() internal view virtual override(ERC721A, ERC721ACommonBaseTokenURI) returns (string memory) { return ERC721ACommonBaseTokenURI._baseURI(); } function setApprovalForAll(address operator, bool approved) public virtual override(ERC721A, ERC721ACommonOperatorFilterOS) { ERC721ACommonOperatorFilterOS.setApprovalForAll(operator, approved); } function approve(address operator, uint256 tokenId) public payable virtual override(ERC721A, ERC721ACommonOperatorFilterOS) { ERC721ACommonOperatorFilterOS.approve(operator, tokenId); } function transferFrom(address from, address to, uint256 tokenId) public payable virtual override(ERC721A, ERC721ACommonOperatorFilterOS) { ERC721ACommonOperatorFilterOS.transferFrom(from, to, tokenId); } function safeTransferFrom(address from, address to, uint256 tokenId) public payable virtual override(ERC721A, ERC721ACommonOperatorFilterOS) { ERC721ACommonOperatorFilterOS.safeTransferFrom(from, to, tokenId); } function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public payable virtual override(ERC721A, ERC721ACommonOperatorFilterOS) { ERC721ACommonOperatorFilterOS.safeTransferFrom(from, to, tokenId, data); } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.2.3 // Creator: Chiru Labs pragma solidity ^0.8.4; import './IERC721A.sol'; /** * @dev Interface of ERC721 token receiver. */ interface ERC721A__IERC721Receiver { function onERC721Received( address operator, address from, uint256 tokenId, bytes calldata data ) external returns (bytes4); } /** * @title ERC721A * * @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721) * Non-Fungible Token Standard, including the Metadata extension. * Optimized for lower gas during batch mints. * * Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...) * starting from `_startTokenId()`. * * Assumptions: * * - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply. * - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256). */ contract ERC721A is IERC721A { // Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364). struct TokenApprovalRef { address value; } // ============================================================= // CONSTANTS // ============================================================= // Mask of an entry in packed address data. uint256 private constant _BITMASK_ADDRESS_DATA_ENTRY = (1 << 64) - 1; // The bit position of `numberMinted` in packed address data. uint256 private constant _BITPOS_NUMBER_MINTED = 64; // The bit position of `numberBurned` in packed address data. uint256 private constant _BITPOS_NUMBER_BURNED = 128; // The bit position of `aux` in packed address data. uint256 private constant _BITPOS_AUX = 192; // Mask of all 256 bits in packed address data except the 64 bits for `aux`. uint256 private constant _BITMASK_AUX_COMPLEMENT = (1 << 192) - 1; // The bit position of `startTimestamp` in packed ownership. uint256 private constant _BITPOS_START_TIMESTAMP = 160; // The bit mask of the `burned` bit in packed ownership. uint256 private constant _BITMASK_BURNED = 1 << 224; // The bit position of the `nextInitialized` bit in packed ownership. uint256 private constant _BITPOS_NEXT_INITIALIZED = 225; // The bit mask of the `nextInitialized` bit in packed ownership. uint256 private constant _BITMASK_NEXT_INITIALIZED = 1 << 225; // The bit position of `extraData` in packed ownership. uint256 private constant _BITPOS_EXTRA_DATA = 232; // Mask of all 256 bits in a packed ownership except the 24 bits for `extraData`. uint256 private constant _BITMASK_EXTRA_DATA_COMPLEMENT = (1 << 232) - 1; // The mask of the lower 160 bits for addresses. uint256 private constant _BITMASK_ADDRESS = (1 << 160) - 1; // The maximum `quantity` that can be minted with {_mintERC2309}. // This limit is to prevent overflows on the address data entries. // For a limit of 5000, a total of 3.689e15 calls to {_mintERC2309} // is required to cause an overflow, which is unrealistic. uint256 private constant _MAX_MINT_ERC2309_QUANTITY_LIMIT = 5000; // The `Transfer` event signature is given by: // `keccak256(bytes("Transfer(address,address,uint256)"))`. bytes32 private constant _TRANSFER_EVENT_SIGNATURE = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef; // ============================================================= // STORAGE // ============================================================= // The next token ID to be minted. uint256 private _currentIndex; // The number of tokens burned. uint256 private _burnCounter; // Token name string private _name; // Token symbol string private _symbol; // Mapping from token ID to ownership details // An empty struct value does not necessarily mean the token is unowned. // See {_packedOwnershipOf} implementation for details. // // Bits Layout: // - [0..159] `addr` // - [160..223] `startTimestamp` // - [224] `burned` // - [225] `nextInitialized` // - [232..255] `extraData` mapping(uint256 => uint256) private _packedOwnerships; // Mapping owner address to address data. // // Bits Layout: // - [0..63] `balance` // - [64..127] `numberMinted` // - [128..191] `numberBurned` // - [192..255] `aux` mapping(address => uint256) private _packedAddressData; // Mapping from token ID to approved address. mapping(uint256 => TokenApprovalRef) private _tokenApprovals; // Mapping from owner to operator approvals mapping(address => mapping(address => bool)) private _operatorApprovals; // ============================================================= // CONSTRUCTOR // ============================================================= constructor(string memory name_, string memory symbol_) { _name = name_; _symbol = symbol_; _currentIndex = _startTokenId(); } // ============================================================= // TOKEN COUNTING OPERATIONS // ============================================================= /** * @dev Returns the starting token ID. * To change the starting token ID, please override this function. */ function _startTokenId() internal view virtual returns (uint256) { return 0; } /** * @dev Returns the next token ID to be minted. */ function _nextTokenId() internal view virtual returns (uint256) { return _currentIndex; } /** * @dev Returns the total number of tokens in existence. * Burned tokens will reduce the count. * To get the total number of tokens minted, please see {_totalMinted}. */ function totalSupply() public view virtual override returns (uint256) { // Counter underflow is impossible as _burnCounter cannot be incremented // more than `_currentIndex - _startTokenId()` times. unchecked { return _currentIndex - _burnCounter - _startTokenId(); } } /** * @dev Returns the total amount of tokens minted in the contract. */ function _totalMinted() internal view virtual returns (uint256) { // Counter underflow is impossible as `_currentIndex` does not decrement, // and it is initialized to `_startTokenId()`. unchecked { return _currentIndex - _startTokenId(); } } /** * @dev Returns the total number of tokens burned. */ function _totalBurned() internal view virtual returns (uint256) { return _burnCounter; } // ============================================================= // ADDRESS DATA OPERATIONS // ============================================================= /** * @dev Returns the number of tokens in `owner`'s account. */ function balanceOf(address owner) public view virtual override returns (uint256) { if (owner == address(0)) revert BalanceQueryForZeroAddress(); return _packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens minted by `owner`. */ function _numberMinted(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens burned by or on behalf of `owner`. */ function _numberBurned(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). */ function _getAux(address owner) internal view returns (uint64) { return uint64(_packedAddressData[owner] >> _BITPOS_AUX); } /** * Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). * If there are multiple variables, please pack them into a uint64. */ function _setAux(address owner, uint64 aux) internal virtual { uint256 packed = _packedAddressData[owner]; uint256 auxCasted; // Cast `aux` with assembly to avoid redundant masking. assembly { auxCasted := aux } packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX); _packedAddressData[owner] = packed; } // ============================================================= // IERC165 // ============================================================= /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified) * to learn more about how these ids are created. * * This function call must use less than 30000 gas. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { // The interface IDs are constants representing the first 4 bytes // of the XOR of all function selectors in the interface. // See: [ERC165](https://eips.ethereum.org/EIPS/eip-165) // (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`) return interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165. interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721. interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata. } // ============================================================= // IERC721Metadata // ============================================================= /** * @dev Returns the token collection name. */ function name() public view virtual override returns (string memory) { return _name; } /** * @dev Returns the token collection symbol. */ function symbol() public view virtual override returns (string memory) { return _symbol; } /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) public view virtual override returns (string memory) { if (!_exists(tokenId)) revert URIQueryForNonexistentToken(); string memory baseURI = _baseURI(); return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : ''; } /** * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each * token will be the concatenation of the `baseURI` and the `tokenId`. Empty * by default, it can be overridden in child contracts. */ function _baseURI() internal view virtual returns (string memory) { return ''; } // ============================================================= // OWNERSHIPS OPERATIONS // ============================================================= /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) public view virtual override returns (address) { return address(uint160(_packedOwnershipOf(tokenId))); } /** * @dev Gas spent here starts off proportional to the maximum mint batch size. * It gradually moves to O(1) as tokens get transferred around over time. */ function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnershipOf(tokenId)); } /** * @dev Returns the unpacked `TokenOwnership` struct at `index`. */ function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnerships[index]); } /** * @dev Initializes the ownership slot minted at `index` for efficiency purposes. */ function _initializeOwnershipAt(uint256 index) internal virtual { if (_packedOwnerships[index] == 0) { _packedOwnerships[index] = _packedOwnershipOf(index); } } /** * Returns the packed ownership data of `tokenId`. */ function _packedOwnershipOf(uint256 tokenId) private view returns (uint256) { uint256 curr = tokenId; unchecked { if (_startTokenId() <= curr) if (curr < _currentIndex) { uint256 packed = _packedOwnerships[curr]; // If not burned. if (packed & _BITMASK_BURNED == 0) { // Invariant: // There will always be an initialized ownership slot // (i.e. `ownership.addr != address(0) && ownership.burned == false`) // before an unintialized ownership slot // (i.e. `ownership.addr == address(0) && ownership.burned == false`) // Hence, `curr` will not underflow. // // We can directly compare the packed value. // If the address is zero, packed will be zero. while (packed == 0) { packed = _packedOwnerships[--curr]; } return packed; } } } revert OwnerQueryForNonexistentToken(); } /** * @dev Returns the unpacked `TokenOwnership` struct from `packed`. */ function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) { ownership.addr = address(uint160(packed)); ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP); ownership.burned = packed & _BITMASK_BURNED != 0; ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA); } /** * @dev Packs ownership data into a single uint256. */ function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`. result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags)) } } /** * @dev Returns the `nextInitialized` flag set if `quantity` equals 1. */ function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) { // For branchless setting of the `nextInitialized` flag. assembly { // `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`. result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1)) } } // ============================================================= // APPROVAL OPERATIONS // ============================================================= /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the * zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) public payable virtual override { address owner = ownerOf(tokenId); if (_msgSenderERC721A() != owner) if (!isApprovedForAll(owner, _msgSenderERC721A())) { revert ApprovalCallerNotOwnerNorApproved(); } _tokenApprovals[tokenId].value = to; emit Approval(owner, to, tokenId); } /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) public view virtual override returns (address) { if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken(); return _tokenApprovals[tokenId].value; } /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} * for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool approved) public virtual override { _operatorApprovals[_msgSenderERC721A()][operator] = approved; emit ApprovalForAll(_msgSenderERC721A(), operator, approved); } /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll}. */ function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) { return _operatorApprovals[owner][operator]; } /** * @dev Returns whether `tokenId` exists. * * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}. * * Tokens start existing when they are minted. See {_mint}. */ function _exists(uint256 tokenId) internal view virtual returns (bool) { return _startTokenId() <= tokenId && tokenId < _currentIndex && // If within bounds, _packedOwnerships[tokenId] & _BITMASK_BURNED == 0; // and not burned. } /** * @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`. */ function _isSenderApprovedOrOwner( address approvedAddress, address owner, address msgSender ) private pure returns (bool result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean. msgSender := and(msgSender, _BITMASK_ADDRESS) // `msgSender == owner || msgSender == approvedAddress`. result := or(eq(msgSender, owner), eq(msgSender, approvedAddress)) } } /** * @dev Returns the storage slot and value for the approved address of `tokenId`. */ function _getApprovedSlotAndAddress(uint256 tokenId) private view returns (uint256 approvedAddressSlot, address approvedAddress) { TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId]; // The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`. assembly { approvedAddressSlot := tokenApproval.slot approvedAddress := sload(approvedAddressSlot) } } // ============================================================= // TRANSFER OPERATIONS // ============================================================= /** * @dev Transfers `tokenId` from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) public payable virtual override { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner(); (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId); // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A())) if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved(); if (to == address(0)) revert TransferToZeroAddress(); _beforeTokenTransfers(from, to, tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // We can directly increment and decrement the balances. --_packedAddressData[from]; // Updates: `balance -= 1`. ++_packedAddressData[to]; // Updates: `balance += 1`. // Updates: // - `address` to the next owner. // - `startTimestamp` to the timestamp of transfering. // - `burned` to `false`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData( to, _BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked) ); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } emit Transfer(from, to, tokenId); _afterTokenTransfers(from, to, tokenId, 1); } /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom( address from, address to, uint256 tokenId ) public payable virtual override { safeTransferFrom(from, to, tokenId, ''); } /** * @dev Safely transfers `tokenId` token from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes memory _data ) public payable virtual override { transferFrom(from, to, tokenId); if (to.code.length != 0) if (!_checkContractOnERC721Received(from, to, tokenId, _data)) { revert TransferToNonERC721ReceiverImplementer(); } } /** * @dev Hook that is called before a set of serially-ordered token IDs * are about to be transferred. This includes minting. * And also called before burning one token. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _beforeTokenTransfers( address from, address to, uint256 startTokenId, uint256 quantity ) internal virtual {} /** * @dev Hook that is called after a set of serially-ordered token IDs * have been transferred. This includes minting. * And also called after one token has been burned. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` has been * transferred to `to`. * - When `from` is zero, `tokenId` has been minted for `to`. * - When `to` is zero, `tokenId` has been burned by `from`. * - `from` and `to` are never both zero. */ function _afterTokenTransfers( address from, address to, uint256 startTokenId, uint256 quantity ) internal virtual {} /** * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract. * * `from` - Previous owner of the given token ID. * `to` - Target address that will receive the token. * `tokenId` - Token ID to be transferred. * `_data` - Optional data to send along with the call. * * Returns whether the call correctly returned the expected magic value. */ function _checkContractOnERC721Received( address from, address to, uint256 tokenId, bytes memory _data ) private returns (bool) { try ERC721A__IERC721Receiver(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns ( bytes4 retval ) { return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector; } catch (bytes memory reason) { if (reason.length == 0) { revert TransferToNonERC721ReceiverImplementer(); } else { assembly { revert(add(32, reason), mload(reason)) } } } } // ============================================================= // MINT OPERATIONS // ============================================================= /** * @dev Mints `quantity` tokens and transfers them to `to`. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {Transfer} event for each mint. */ function _mint(address to, uint256 quantity) internal virtual { uint256 startTokenId = _currentIndex; if (quantity == 0) revert MintZeroQuantity(); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are incredibly unrealistic. // `balance` and `numberMinted` have a maximum limit of 2**64. // `tokenId` has a maximum limit of 2**256. unchecked { // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1); // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); uint256 toMasked; uint256 end = startTokenId + quantity; // Use assembly to loop and emit the `Transfer` event for gas savings. // The duplicated `log4` removes an extra check and reduces stack juggling. // The assembly, together with the surrounding Solidity code, have been // delicately arranged to nudge the compiler into producing optimized opcodes. assembly { // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. toMasked := and(to, _BITMASK_ADDRESS) // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. 0, // `address(0)`. toMasked, // `to`. startTokenId // `tokenId`. ) // The `iszero(eq(,))` check ensures that large values of `quantity` // that overflows uint256 will make the loop run out of gas. // The compiler will optimize the `iszero` away for performance. for { let tokenId := add(startTokenId, 1) } iszero(eq(tokenId, end)) { tokenId := add(tokenId, 1) } { // Emit the `Transfer` event. Similar to above. log4(0, 0, _TRANSFER_EVENT_SIGNATURE, 0, toMasked, tokenId) } } if (toMasked == 0) revert MintToZeroAddress(); _currentIndex = end; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev Mints `quantity` tokens and transfers them to `to`. * * This function is intended for efficient minting only during contract creation. * * It emits only one {ConsecutiveTransfer} as defined in * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309), * instead of a sequence of {Transfer} event(s). * * Calling this function outside of contract creation WILL make your contract * non-compliant with the ERC721 standard. * For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309 * {ConsecutiveTransfer} event is only permissible during contract creation. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {ConsecutiveTransfer} event. */ function _mintERC2309(address to, uint256 quantity) internal virtual { uint256 startTokenId = _currentIndex; if (to == address(0)) revert MintToZeroAddress(); if (quantity == 0) revert MintZeroQuantity(); if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) revert MintERC2309QuantityExceedsLimit(); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are unrealistic due to the above check for `quantity` to be below the limit. unchecked { // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1); // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to); _currentIndex = startTokenId + quantity; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev Safely mints `quantity` tokens and transfers them to `to`. * * Requirements: * * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called for each safe transfer. * - `quantity` must be greater than 0. * * See {_mint}. * * Emits a {Transfer} event for each mint. */ function _safeMint( address to, uint256 quantity, bytes memory _data ) internal virtual { _mint(to, quantity); unchecked { if (to.code.length != 0) { uint256 end = _currentIndex; uint256 index = end - quantity; do { if (!_checkContractOnERC721Received(address(0), to, index++, _data)) { revert TransferToNonERC721ReceiverImplementer(); } } while (index < end); // Reentrancy protection. if (_currentIndex != end) revert(); } } } /** * @dev Equivalent to `_safeMint(to, quantity, '')`. */ function _safeMint(address to, uint256 quantity) internal virtual { _safeMint(to, quantity, ''); } // ============================================================= // BURN OPERATIONS // ============================================================= /** * @dev Equivalent to `_burn(tokenId, false)`. */ function _burn(uint256 tokenId) internal virtual { _burn(tokenId, false); } /** * @dev Destroys `tokenId`. * The approval is cleared when the token is burned. * * Requirements: * * - `tokenId` must exist. * * Emits a {Transfer} event. */ function _burn(uint256 tokenId, bool approvalCheck) internal virtual { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); address from = address(uint160(prevOwnershipPacked)); (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId); if (approvalCheck) { // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A())) if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved(); } _beforeTokenTransfers(from, address(0), tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // Updates: // - `balance -= 1`. // - `numberBurned += 1`. // // We can directly decrement the balance, and increment the number burned. // This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`. _packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1; // Updates: // - `address` to the last owner. // - `startTimestamp` to the timestamp of burning. // - `burned` to `true`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData( from, (_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked) ); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } emit Transfer(from, address(0), tokenId); _afterTokenTransfers(from, address(0), tokenId, 1); // Overflow not possible, as _burnCounter cannot be exceed _currentIndex times. unchecked { _burnCounter++; } } // ============================================================= // EXTRA DATA OPERATIONS // ============================================================= /** * @dev Directly sets the extra data for the ownership data `index`. */ function _setExtraDataAt(uint256 index, uint24 extraData) internal virtual { uint256 packed = _packedOwnerships[index]; if (packed == 0) revert OwnershipNotInitializedForExtraData(); uint256 extraDataCasted; // Cast `extraData` with assembly to avoid redundant masking. assembly { extraDataCasted := extraData } packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA); _packedOwnerships[index] = packed; } /** * @dev Called during each token transfer to set the 24bit `extraData` field. * Intended to be overridden by the cosumer contract. * * `previousExtraData` - the value of `extraData` before transfer. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _extraData( address from, address to, uint24 previousExtraData ) internal view virtual returns (uint24) {} /** * @dev Returns the next extra data for the packed ownership data. * The returned result is shifted into position. */ function _nextExtraData( address from, address to, uint256 prevOwnershipPacked ) private view returns (uint256) { uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA); return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA; } // ============================================================= // OTHER OPERATIONS // ============================================================= /** * @dev Returns the message sender (defaults to `msg.sender`). * * If you are writing GSN compatible contracts, you need to override this function. */ function _msgSenderERC721A() internal view virtual returns (address) { return msg.sender; } /** * @dev Converts a uint256 to its ASCII string decimal representation. */ function _toString(uint256 value) internal pure virtual returns (string memory str) { assembly { // The maximum value of a uint256 contains 78 digits (1 byte per digit), but // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned. // We will need 1 word for the trailing zeros padding, 1 word for the length, // and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0. let m := add(mload(0x40), 0xa0) // Update the free memory pointer to allocate. mstore(0x40, m) // Assign the `str` to the end. str := sub(m, 0x20) // Zeroize the slot after the string. mstore(str, 0) // Cache the end of the memory to calculate the length later. let end := str // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. // prettier-ignore for { let temp := value } 1 {} { str := sub(str, 1) // Write the character to the pointer. // The ASCII index of the '0' character is 48. mstore8(str, add(48, mod(temp, 10))) // Keep dividing `temp` until zero. temp := div(temp, 10) // prettier-ignore if iszero(temp) { break } } let length := sub(end, str) // Move the pointer 32 bytes leftwards to make room for the length. str := sub(str, 0x20) // Store the length. mstore(str, length) } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (token/common/ERC2981.sol) pragma solidity ^0.8.0; import "../../interfaces/IERC2981.sol"; import "../../utils/introspection/ERC165.sol"; /** * @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information. * * Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for * specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first. * * Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the * fee is specified in basis points by default. * * IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See * https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to * voluntarily pay royalties together with sales, but note that this standard is not yet widely supported. * * _Available since v4.5._ */ abstract contract ERC2981 is IERC2981, ERC165 { struct RoyaltyInfo { address receiver; uint96 royaltyFraction; } RoyaltyInfo private _defaultRoyaltyInfo; mapping(uint256 => RoyaltyInfo) private _tokenRoyaltyInfo; /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) { return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId); } /** * @inheritdoc IERC2981 */ function royaltyInfo(uint256 _tokenId, uint256 _salePrice) public view virtual override returns (address, uint256) { RoyaltyInfo memory royalty = _tokenRoyaltyInfo[_tokenId]; if (royalty.receiver == address(0)) { royalty = _defaultRoyaltyInfo; } uint256 royaltyAmount = (_salePrice * royalty.royaltyFraction) / _feeDenominator(); return (royalty.receiver, royaltyAmount); } /** * @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a * fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an * override. */ function _feeDenominator() internal pure virtual returns (uint96) { return 10000; } /** * @dev Sets the royalty information that all ids in this contract will default to. * * Requirements: * * - `receiver` cannot be the zero address. * - `feeNumerator` cannot be greater than the fee denominator. */ function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual { require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice"); require(receiver != address(0), "ERC2981: invalid receiver"); _defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator); } /** * @dev Removes default royalty information. */ function _deleteDefaultRoyalty() internal virtual { delete _defaultRoyaltyInfo; } /** * @dev Sets the royalty information for a specific token id, overriding the global default. * * Requirements: * * - `receiver` cannot be the zero address. * - `feeNumerator` cannot be greater than the fee denominator. */ function _setTokenRoyalty( uint256 tokenId, address receiver, uint96 feeNumerator ) internal virtual { require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice"); require(receiver != address(0), "ERC2981: Invalid parameters"); _tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator); } /** * @dev Resets royalty information for the token id back to the global default. */ function _resetTokenRoyalty(uint256 tokenId) internal virtual { delete _tokenRoyaltyInfo[tokenId]; } }
// SPDX-License-Identifier: MIT // Copyright (c) 2023 the ethier authors (github.com/divergencetech/ethier) pragma solidity >=0.8.0 <0.9.0; import {AccessControlEnumerable as ACE} from "@openzeppelin/contracts/access/AccessControlEnumerable.sol"; contract AccessControlEnumerable is ACE { /// @notice The default role intended to perform access-restricted actions. /// @dev We are using this instead of DEFAULT_ADMIN_ROLE because the latter /// is intended to grant/revoke roles and will be secured differently. bytes32 public constant DEFAULT_STEERING_ROLE = keccak256("DEFAULT_STEERING_ROLE"); /// @dev Overrides supportsInterface so that inheriting contracts can /// reference this contract instead of OZ's version for further overrides. function supportsInterface(bytes4 interfaceId) public view virtual override(ACE) returns (bool) { return ACE.supportsInterface(interfaceId); } }
// SPDX-License-Identifier: MIT // Copyright (c) 2021 the ethier authors (github.com/divergencetech/ethier) pragma solidity >=0.8.0 <0.9.0; import {Pausable} from "@openzeppelin/contracts/security/Pausable.sol"; import {AccessControlEnumerable} from "./AccessControlEnumerable.sol"; /// @notice A Pausable contract that can only be toggled by a member of the /// STEERING role. contract AccessControlPausable is AccessControlEnumerable, Pausable { /// @notice Pauses the contract. function pause() public onlyRole(DEFAULT_STEERING_ROLE) { Pausable._pause(); } /// @notice Unpauses the contract. function unpause() public onlyRole(DEFAULT_STEERING_ROLE) { Pausable._unpause(); } }
// SPDX-License-Identifier: CC0-1.0 pragma solidity ^0.8.0; import {IERC165, ERC165} from "@openzeppelin/contracts/utils/introspection/ERC165.sol"; interface IERC4906Events { /// @dev This event emits when the metadata of a token is changed. /// So that the third-party platforms such as NFT market could /// timely update the images and related attributes of the NFT. event MetadataUpdate(uint256 _tokenId); /// @dev This event emits when the metadata of a range of tokens is changed. /// So that the third-party platforms such as NFT market could /// timely update the images and related attributes of the NFTs. event BatchMetadataUpdate(uint256 _fromTokenId, uint256 _toTokenId); } /// @title EIP-721 Metadata Update Extension // solhint-disable-next-line no-empty-blocks interface IERC4906 is IERC165, IERC4906Events { } contract ERC4906 is IERC4906, ERC165 { function _refreshMetadata(uint256 tokenId) internal { emit MetadataUpdate(tokenId); } function _refreshMetadata(uint256 fromTokenId, uint256 toTokenId) internal { emit BatchMetadataUpdate(fromTokenId, toTokenId); } /// @dev See {IERC165-supportsInterface}. function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) { return interfaceId == bytes4(0x49064906) || ERC165.supportsInterface(interfaceId); } }
// SPDX-License-Identifier: LGPL-3.0-only // Creatd By: Art Blocks Inc. pragma solidity ^0.8.0; import "./IGenArt721CoreContractV3_Base.sol"; import "./IRandomizer_V3CoreBase.sol"; interface IRandomizerV2 is IRandomizer_V3CoreBase { // The core contract that may interact with this randomizer contract. function genArt721Core() external view returns (IGenArt721CoreContractV3_Base); }
// 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); }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.0; import "./IAdminACLV0.sol"; import "./IGenArt721CoreContractV3_Engine.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 is IGenArt721CoreContractV3_Engine { /** * @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 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); }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.19; 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 ); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; /// @dev Royalty Registry interface, used to support the Royalty Registry. /// @dev Source: https://github.com/manifoldxyz/royalty-registry-solidity/blob/main/contracts/specs/IManifold.sol /// @author: manifold.xyz /** * @dev Royalty interface for creator core classes */ interface IManifold { /** * @dev Get royalites of a token. Returns list of receivers and basisPoints * * bytes4(keccak256('getRoyalties(uint256)')) == 0xbb3bafd6 * * => 0xbb3bafd6 = 0xbb3bafd6 */ function getRoyalties( uint256 tokenId ) external view returns (address payable[] memory, uint256[] memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol) pragma solidity ^0.8.0; import "../utils/Context.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract Ownable is Context { address private _owner; event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the deployer as the initial owner. */ constructor() { _transferOwnership(_msgSender()); } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _checkOwner(); _; } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if the sender is not the owner. */ function _checkOwner() internal view virtual { require(owner() == _msgSender(), "Ownable: caller is not the owner"); } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions anymore. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby removing any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/ERC721.sol) pragma solidity ^0.8.0; import "@openzeppelin-4.7/contracts/token/ERC721/IERC721.sol"; import "@openzeppelin-4.7/contracts/token/ERC721/IERC721Receiver.sol"; import "@openzeppelin-4.7/contracts/token/ERC721/extensions/IERC721Metadata.sol"; import "@openzeppelin-4.7/contracts/utils/Address.sol"; import "@openzeppelin-4.7/contracts/utils/Context.sol"; import "@openzeppelin-4.7/contracts/utils/Strings.sol"; import "@openzeppelin-4.7/contracts/utils/introspection/ERC165.sol"; /** * @dev Forked version of the OpenZeppelin v4.7.1 ERC721 contract. Utilizes a * struct to pack owner and hash seed into a single storage slot. * --------------------- * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including * the Metadata extension, but not including the Enumerable extension, which is available separately as * {ERC721Enumerable}. */ contract ERC721_PackedHashSeed is Context, ERC165, IERC721, IERC721Metadata { using Address for address; using Strings for uint256; // Token name string private _name; // Token symbol string private _symbol; /// struct to pack a token owner and hash seed into same storage slot struct OwnerAndHashSeed { // 20 bytes for address of token's owner address owner; // remaining 12 bytes allocated to token hash seed bytes12 hashSeed; } /// mapping of token ID to OwnerAndHashSeed /// @dev visibility internal so inheriting contracts can access mapping(uint256 => OwnerAndHashSeed) internal _ownersAndHashSeeds; // Mapping owner address to token count mapping(address => uint256) private _balances; // Mapping from token ID to approved address mapping(uint256 => address) private _tokenApprovals; // Mapping from owner to operator approvals mapping(address => mapping(address => bool)) private _operatorApprovals; /** * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection. */ constructor(string memory name_, string memory symbol_) { _name = name_; _symbol = symbol_; } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface( bytes4 interfaceId ) public view virtual override(ERC165, IERC165) returns (bool) { return interfaceId == type(IERC721).interfaceId || interfaceId == type(IERC721Metadata).interfaceId || super.supportsInterface(interfaceId); } /** * @dev See {IERC721-balanceOf}. */ function balanceOf( address owner ) public view virtual override returns (uint256) { require( owner != address(0), "ERC721: address zero is not a valid owner" ); return _balances[owner]; } /** * @dev See {IERC721-ownerOf}. */ function ownerOf( uint256 tokenId ) public view virtual override returns (address) { address owner = _ownersAndHashSeeds[tokenId].owner; require(owner != address(0), "ERC721: invalid token ID"); return owner; } /** * @dev See {IERC721Metadata-name}. */ function name() public view virtual override returns (string memory) { return _name; } /** * @dev See {IERC721Metadata-symbol}. */ function symbol() public view virtual override returns (string memory) { return _symbol; } /** * @dev See {IERC721Metadata-tokenURI}. */ function tokenURI( uint256 tokenId ) public view virtual override returns (string memory) { _requireMinted(tokenId); string memory baseURI = _baseURI(); return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : ""; } /** * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each * token will be the concatenation of the `baseURI` and the `tokenId`. Empty * by default, can be overridden in child contracts. */ function _baseURI() internal view virtual returns (string memory) { return ""; } /** * @dev See {IERC721-approve}. */ function approve(address to, uint256 tokenId) public virtual override { address owner = ERC721_PackedHashSeed.ownerOf(tokenId); require(to != owner, "ERC721: approval to current owner"); require( _msgSender() == owner || isApprovedForAll(owner, _msgSender()), "ERC721: approve caller is not token owner nor approved for all" ); _approve(to, tokenId); } /** * @dev See {IERC721-getApproved}. */ function getApproved( uint256 tokenId ) public view virtual override returns (address) { _requireMinted(tokenId); return _tokenApprovals[tokenId]; } /** * @dev See {IERC721-setApprovalForAll}. */ function setApprovalForAll( address operator, bool approved ) public virtual override { _setApprovalForAll(_msgSender(), operator, approved); } /** * @dev See {IERC721-isApprovedForAll}. */ function isApprovedForAll( address owner, address operator ) public view virtual override returns (bool) { return _operatorApprovals[owner][operator]; } /** * @dev See {IERC721-transferFrom}. */ function transferFrom( address from, address to, uint256 tokenId ) public virtual override { //solhint-disable-next-line max-line-length require( _isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved" ); _transfer(from, to, tokenId); } /** * @dev See {IERC721-safeTransferFrom}. */ function safeTransferFrom( address from, address to, uint256 tokenId ) public virtual override { safeTransferFrom(from, to, tokenId, ""); } /** * @dev See {IERC721-safeTransferFrom}. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes memory data ) public virtual override { require( _isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner nor approved" ); _safeTransfer(from, to, tokenId, data); } /** * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients * are aware of the ERC721 protocol to prevent tokens from being forever locked. * * `data` is additional data, it has no specified format and it is sent in call to `to`. * * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g. * implement alternative mechanisms to perform token transfer, such as signature-based. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function _safeTransfer( address from, address to, uint256 tokenId, bytes memory data ) internal virtual { _transfer(from, to, tokenId); require( _checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer" ); } /** * @dev Returns whether `tokenId` exists. * * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}. * * Tokens start existing when they are minted (`_mint`), * and stop existing when they are burned (`_burn`). */ function _exists(uint256 tokenId) internal view virtual returns (bool) { return _ownersAndHashSeeds[tokenId].owner != address(0); } /** * @dev Returns whether `spender` is allowed to manage `tokenId`. * * Requirements: * * - `tokenId` must exist. */ function _isApprovedOrOwner( address spender, uint256 tokenId ) internal view virtual returns (bool) { address owner = ERC721_PackedHashSeed.ownerOf(tokenId); return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender); } /** * @dev Safely mints `tokenId` and transfers it to `to`. * * Requirements: * * - `tokenId` must not exist. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function _safeMint(address to, uint256 tokenId) internal virtual { _safeMint(to, tokenId, ""); } /** * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is * forwarded in {IERC721Receiver-onERC721Received} to contract recipients. */ function _safeMint( address to, uint256 tokenId, bytes memory data ) internal virtual { _mint(to, tokenId); require( _checkOnERC721Received(address(0), to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer" ); } /** * @dev Mints `tokenId` and transfers it to `to`. * * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible * * Requirements: * * - `tokenId` must not exist. * - `to` cannot be the zero address. * * Emits a {Transfer} event. */ function _mint(address to, uint256 tokenId) internal virtual { require(to != address(0), "ERC721: mint to the zero address"); require(!_exists(tokenId), "ERC721: token already minted"); _beforeTokenTransfer(address(0), to, tokenId); _balances[to] += 1; _ownersAndHashSeeds[tokenId].owner = to; emit Transfer(address(0), to, tokenId); _afterTokenTransfer(address(0), to, tokenId); } /** * @dev Destroys `tokenId`. * The approval is cleared when the token is burned. * * Requirements: * * - `tokenId` must exist. * * Emits a {Transfer} event. */ function _burn(uint256 tokenId) internal virtual { address owner = ERC721_PackedHashSeed.ownerOf(tokenId); _beforeTokenTransfer(owner, address(0), tokenId); // Clear approvals _approve(address(0), tokenId); _balances[owner] -= 1; delete _ownersAndHashSeeds[tokenId].owner; emit Transfer(owner, address(0), tokenId); _afterTokenTransfer(owner, address(0), tokenId); } /** * @dev Transfers `tokenId` from `from` to `to`. * As opposed to {transferFrom}, this imposes no restrictions on msg.sender. * * Requirements: * * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * * Emits a {Transfer} event. */ function _transfer( address from, address to, uint256 tokenId ) internal virtual { require( ERC721_PackedHashSeed.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner" ); require(to != address(0), "ERC721: transfer to the zero address"); _beforeTokenTransfer(from, to, tokenId); // Clear approvals from the previous owner _approve(address(0), tokenId); _balances[from] -= 1; _balances[to] += 1; _ownersAndHashSeeds[tokenId].owner = to; emit Transfer(from, to, tokenId); _afterTokenTransfer(from, to, tokenId); } /** * @dev Approve `to` to operate on `tokenId` * * Emits an {Approval} event. */ function _approve(address to, uint256 tokenId) internal virtual { _tokenApprovals[tokenId] = to; emit Approval(ERC721_PackedHashSeed.ownerOf(tokenId), to, tokenId); } /** * @dev Approve `operator` to operate on all of `owner` tokens * * Emits an {ApprovalForAll} event. */ function _setApprovalForAll( address owner, address operator, bool approved ) internal virtual { require(owner != operator, "ERC721: approve to caller"); _operatorApprovals[owner][operator] = approved; emit ApprovalForAll(owner, operator, approved); } /** * @dev Reverts if the `tokenId` has not been minted yet. */ function _requireMinted(uint256 tokenId) internal view virtual { require(_exists(tokenId), "ERC721: invalid token ID"); } /** * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address. * The call is not executed if the target address is not a contract. * * @param from address representing the previous owner of the given token ID * @param to target address that will receive the tokens * @param tokenId uint256 ID of the token to be transferred * @param data bytes optional data to send along with the call * @return bool whether the call correctly returned the expected magic value */ function _checkOnERC721Received( address from, address to, uint256 tokenId, bytes memory data ) private returns (bool) { if (to.isContract()) { try IERC721Receiver(to).onERC721Received( _msgSender(), from, tokenId, data ) returns (bytes4 retval) { return retval == IERC721Receiver.onERC721Received.selector; } catch (bytes memory reason) { if (reason.length == 0) { revert( "ERC721: transfer to non ERC721Receiver implementer" ); } else { /// @solidity memory-safe-assembly assembly { revert(add(32, reason), mload(reason)) } } } } else { return true; } } /** * @dev Hook that is called before any token transfer. This includes minting * and burning. * * Calling conditions: * * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, ``from``'s `tokenId` will be burned. * - `from` and `to` are never both zero. * * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks]. */ function _beforeTokenTransfer( address from, address to, uint256 tokenId ) internal virtual {} /** * @dev Hook that is called after any transfer of tokens. This includes * minting and burning. * * Calling conditions: * * - when `from` and `to` are both non-zero. * - `from` and `to` are never both zero. * * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks]. */ function _afterTokenTransfer( address from, address to, uint256 tokenId ) internal virtual {} }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.0; /** * @title Art Blocks Script Storage Library * @notice Utilize contract bytecode as persistent storage for large chunks of script string data. * This library is intended to have an external deployed copy that is released in the future, * and, as such, has been designed to support both updated V1 (versioned, with purging removed) * reads as well as backwards-compatible reads for both a) the unversioned "V0" storage contracts * which were deployed by the original version of this libary and b) contracts that were deployed * using one of the SSTORE2 implementations referenced below. * For these pre-V1 storage contracts (which themselves did not have any explicit versioning semantics) * backwards-compatible reads are optimistic, and only expected to work for contracts actually * deployed by the original version of this library – and may fail ungracefully if attempted to be * used to read from other contracts. * This library is split into two components, intended to be updated in tandem, and thus included * here in the same source file. One component is an internal library that is intended to be embedded * directly into other contracts and provides all _write_ functionality. The other is a public library * that is intended to be deployed as a standalone contract and provides all _read_ functionality. * * @author Art Blocks Inc. * @author Modified from 0xSequence (https://github.com/0xsequence/sstore2/blob/master/contracts/SSTORE2.sol) * @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/SSTORE2.sol) * * @dev Compared to the above two rerferenced libraries, this contracts-as-storage implementation makes a few * notably different design decisions: * - uses the `string` data type for input/output on reads, rather than speaking in bytes directly * - stores the "writer" address (library user) in the deployed contract bytes, which is useful for * on-chain introspection and provenance purposes * - stores a very simple versioning string in the deployed contract bytes, which captures the version * of the library that was used to deploy the storage contract and useful for supporting future * compatibility management as this library evolves (e.g. in response to EOF v1 migration plans) * Also, given that much of this library is written in assembly, this library makes use of a slightly * different convention (when compared to the rest of the Art Blocks smart contract repo) around * pre-defining return values in some cases in order to simplify need to directly memory manage these * return values. */ /** * @title Art Blocks Script Storage Library (Public, Reads) * @author Art Blocks Inc. * @notice The public library for reading from storage contracts. This library is intended to be deployed as a * standalone contract, and provides all _read_ functionality. */ library BytecodeStorageReader { // Define the set of known valid version strings that may be stored in the deployed storage contract bytecode // note: These are all intentionally exactly 32-bytes and are null-terminated. Null-termination is used due // to this being the standard expected formatting in common web3 tooling such as ethers.js. Please see // the following for additional context: https://docs.ethers.org/v5/api/utils/strings/#Bytes32String // Used for storage contracts that were deployed by an unknown source bytes32 public constant UNKNOWN_VERSION_STRING = "UNKNOWN_VERSION_STRING_________ "; // Pre-dates versioning string, so this doesn't actually exist in any deployed contracts, // but is useful for backwards-compatible semantics with original version of this library bytes32 public constant V0_VERSION_STRING = "BytecodeStorage_V0.0.0_________ "; // The first versioned storage contract, deployed by an updated version of this library bytes32 public constant V1_VERSION_STRING = "BytecodeStorage_V1.0.0_________ "; // The current version of this library. bytes32 public constant CURRENT_VERSION = V1_VERSION_STRING; //---------------------------------------------------------------------------------------------------------------// // Starting Index | Size | Ending Index | Description // //---------------------------------------------------------------------------------------------------------------// // 0 | N/A | 0 | // // 0 | 1 | 1 | single byte opcode for making the storage contract non-executable // // 1 | 32 | 33 | the 32 byte slot used for storing a basic versioning string // // 33 | 32 | 65 | the 32 bytes for storing the deploying contract's (0-padded) address // //---------------------------------------------------------------------------------------------------------------// // Define the offset for where the "meta bytes" end, and the "data bytes" begin. Note that this is a manually // calculated value, and must be updated if the above table is changed. It is expected that tests will fail // loudly if these values are not updated in-step with eachother. uint256 private constant VERSION_OFFSET = 1; uint256 private constant ADDRESS_OFFSET = 33; uint256 private constant DATA_OFFSET = 65; // Define the set of known *historic* offset values for where the "meta bytes" end, and the "data bytes" begin. // SSTORE2 deployed storage contracts take the general format of: // concat(0x00, data) // note: this is true for both variants of the SSTORE2 library uint256 private constant SSTORE2_DATA_OFFSET = 1; // V0 deployed storage contracts take the general format of: // concat(gated-cleanup-logic, deployer-address, data) uint256 private constant V0_ADDRESS_OFFSET = 72; uint256 private constant V0_DATA_OFFSET = 104; // V1 deployed storage contracts take the general format of: // concat(invalid opcode, version, deployer-address, data) uint256 private constant V1_ADDRESS_OFFSET = ADDRESS_OFFSET; uint256 private constant V1_DATA_OFFSET = DATA_OFFSET; /*////////////////////////////////////////////////////////////// READ LOGIC //////////////////////////////////////////////////////////////*/ /** * @notice Read a string from contract bytecode * @param _address address of deployed contract with bytecode stored in the V0 or V1 format * @return data string read from contract bytecode * @dev This function performs input validation that the contract to read is in an expected format */ function readFromBytecode( address _address ) public view returns (string memory data) { uint256 dataOffset = _bytecodeDataOffsetAt(_address); return string(readBytesFromBytecode(_address, dataOffset)); } /** * @notice Read the bytes from contract bytecode that was written to the EVM using SSTORE2 * @param _address address of deployed contract with bytecode stored in the SSTORE2 format * @return data bytes read from contract bytecode * @dev This function performs no input validation on the provided contract, * other than that there is content to read (but not that its a "storage contract") */ function readBytesFromSSTORE2Bytecode( address _address ) public view returns (bytes memory data) { return readBytesFromBytecode(_address, SSTORE2_DATA_OFFSET); } /** * @notice Read the bytes from contract bytecode, with an explicitly provided starting offset * @param _address address of deployed contract with bytecode stored in the V0 or V1 format * @param _offset offset to read from in contract bytecode, explicitly provided (not calculated) * @return data bytes read from contract bytecode * @dev This function performs no input validation on the provided contract, * other than that there is content to read (but not that its a "storage contract") */ function readBytesFromBytecode( address _address, uint256 _offset ) public view returns (bytes memory data) { // get the size of the bytecode uint256 bytecodeSize = _bytecodeSizeAt(_address); // handle case where address contains code < _offset if (bytecodeSize < _offset) { revert("ContractAsStorage: Read Error"); } // handle case where address contains code >= dataOffset // decrement by dataOffset to account for header info uint256 size; unchecked { size = bytecodeSize - _offset; } assembly { // allocate free memory data := mload(0x40) // update free memory pointer // use and(x, not(0x1f) as cheaper equivalent to sub(x, mod(x, 0x20)). // adding 0x1f to size + logic above ensures the free memory pointer // remains word-aligned, following the Solidity convention. mstore(0x40, add(data, and(add(add(size, 0x20), 0x1f), not(0x1f)))) // store length of data in first 32 bytes mstore(data, size) // copy code to memory, excluding the deployer-address extcodecopy(_address, add(data, 0x20), _offset, size) } } /** * @notice Get address for deployer for given contract bytecode * @param _address address of deployed contract with bytecode stored in the V0 or V1 format * @return writerAddress address read from contract bytecode */ function getWriterAddressForBytecode( address _address ) public view returns (address) { // get the size of the data uint256 bytecodeSize = _bytecodeSizeAt(_address); // the dataOffset for the bytecode uint256 addressOffset = _bytecodeAddressOffsetAt(_address); // handle case where address contains code < addressOffset + 32 (address takes a whole slot) if (bytecodeSize < (addressOffset + 32)) { revert("ContractAsStorage: Read Error"); } assembly { // allocate free memory let writerAddress := mload(0x40) // shift free memory pointer by one slot mstore(0x40, add(mload(0x40), 0x20)) // copy the 32-byte address of the data contract writer to memory // note: this relies on the assumption noted at the top-level of // this file that the storage layout for the deployed // contracts-as-storage contract looks like:: // | invalid opcode | version-string (unless v0) | deployer-address (padded) | data | extcodecopy( _address, writerAddress, addressOffset, 0x20 // full 32-bytes, as address is expected to be zero-padded ) return( writerAddress, 0x20 // return size is entire slot, as it is zero-padded ) } } /** * @notice Get version for given contract bytecode * @param _address address of deployed contract with bytecode stored in the V0 or V1 format * @return version version read from contract bytecode */ function getLibraryVersionForBytecode( address _address ) public view returns (bytes32) { return _bytecodeVersionAt(_address); } /*////////////////////////////////////////////////////////////// INTERNAL HELPER LOGIC //////////////////////////////////////////////////////////////*/ /** * @notice Returns the size of the bytecode at address `_address` * @param _address address that may or may not contain bytecode * @return size size of the bytecode code at `_address` */ function _bytecodeSizeAt( address _address ) private view returns (uint256 size) { assembly { size := extcodesize(_address) } if (size == 0) { revert("ContractAsStorage: Read Error"); } } /** * @notice Returns the offset of the data in the bytecode at address `_address` * @param _address address that may or may not contain bytecode * @return dataOffset offset of data in bytecode if a known version, otherwise 0 */ function _bytecodeDataOffsetAt( address _address ) private view returns (uint256 dataOffset) { bytes32 version = _bytecodeVersionAt(_address); if (version == V1_VERSION_STRING) { dataOffset = V1_DATA_OFFSET; } else if (version == V0_VERSION_STRING) { dataOffset = V0_DATA_OFFSET; } else { // unknown version, revert revert("ContractAsStorage: Unsupported Version"); } } /** * @notice Returns the offset of the address in the bytecode at address `_address` * @param _address address that may or may not contain bytecode * @return addressOffset offset of address in bytecode if a known version, otherwise 0 */ function _bytecodeAddressOffsetAt( address _address ) private view returns (uint256 addressOffset) { bytes32 version = _bytecodeVersionAt(_address); if (version == V1_VERSION_STRING) { addressOffset = V1_ADDRESS_OFFSET; } else if (version == V0_VERSION_STRING) { addressOffset = V0_ADDRESS_OFFSET; } else { // unknown version, revert revert("ContractAsStorage: Unsupported Version"); } } /** * @notice Get version string for given contract bytecode * @param _address address of deployed contract with bytecode stored in the V0 or V1 format * @return version version string read from contract bytecode */ function _bytecodeVersionAt( address _address ) private view returns (bytes32 version) { // get the size of the data uint256 bytecodeSize = _bytecodeSizeAt(_address); // handle case where address contains code < minimum expected version string size, // by returning early with the unknown version string if (bytecodeSize < (VERSION_OFFSET + 32)) { return UNKNOWN_VERSION_STRING; } assembly { // allocate free memory let versionString := mload(0x40) // shift free memory pointer by one slot mstore(0x40, add(mload(0x40), 0x20)) // copy the 32-byte version string of the bytecode library to memory // note: this relies on the assumption noted at the top-level of // this file that the storage layout for the deployed // contracts-as-storage contract looks like: // | invalid opcode | version-string (unless v0) | deployer-address (padded) | data | extcodecopy( _address, versionString, VERSION_OFFSET, 0x20 // 32-byte version string ) // note: must check against literal strings, as Yul does not allow for // dynamic strings in switch statements. switch mload(versionString) case "BytecodeStorage_V1.0.0_________ " { version := V1_VERSION_STRING } case 0x2060486000396000513314601057fe5b60013614601957fe5b6000357fff0000 { // the v0 variant of this library pre-dates formal versioning w/ version strings, // so we check the first 32 bytes of the execution bytecode itself which // is static and known across all storage contracts deployed with the first version // of this library. version := V0_VERSION_STRING } default { version := UNKNOWN_VERSION_STRING } } } } /** * @title Art Blocks Script Storage Library (Internal, Writes) * @author Art Blocks Inc. * @notice The internal library for writing to storage contracts. This library is intended to be deployed * within library client contracts that use this library to perform _write_ operations on storage. */ library BytecodeStorageWriter { /*////////////////////////////////////////////////////////////// WRITE LOGIC //////////////////////////////////////////////////////////////*/ /** * @notice Write a string to contract bytecode * @param _data string to be written to contract. No input validation is performed on this parameter. * @param address_ address of deployed contract with bytecode stored in the V0 or V1 format */ function writeToBytecode( string memory _data ) internal returns (address address_) { // prefix bytecode with bytes memory creationCode = abi.encodePacked( //---------------------------------------------------------------------------------------------------------------// // Opcode | Opcode + Arguments | Description | Stack View // //---------------------------------------------------------------------------------------------------------------// // a.) creation code returns all code in the contract except for the first 11 (0B in hex) bytes, as these 11 // bytes are the creation code itself which we do not want to store in the deployed storage contract result //---------------------------------------------------------------------------------------------------------------// // 0x60 | 0x60_0B | PUSH1 11 | codeOffset // // 0x59 | 0x59 | MSIZE | 0 codeOffset // // 0x81 | 0x81 | DUP2 | codeOffset 0 codeOffset // // 0x38 | 0x38 | CODESIZE | codeSize codeOffset 0 codeOffset // // 0x03 | 0x03 | SUB | (codeSize - codeOffset) 0 codeOffset // // 0x80 | 0x80 | DUP | (codeSize - codeOffset) (codeSize - codeOffset) 0 codeOffset // // 0x92 | 0x92 | SWAP3 | codeOffset (codeSize - codeOffset) 0 (codeSize - codeOffset) // // 0x59 | 0x59 | MSIZE | 0 codeOffset (codeSize - codeOffset) 0 (codeSize - codeOffset) // // 0x39 | 0x39 | CODECOPY | 0 (codeSize - codeOffset) // // 0xF3 | 0xF3 | RETURN | // //---------------------------------------------------------------------------------------------------------------// // (11 bytes) hex"60_0B_59_81_38_03_80_92_59_39_F3", //---------------------------------------------------------------------------------------------------------------// // b.) ensure that the deployed storage contract is non-executeable (first opcode is the `invalid` opcode) //---------------------------------------------------------------------------------------------------------------// //---------------------------------------------------------------------------------------------------------------// // 0xFE | 0xFE | INVALID | // //---------------------------------------------------------------------------------------------------------------// // (1 byte) hex"FE", //---------------------------------------------------------------------------------------------------------------// // c.) store the version string, which is already represented as a 32-byte value //---------------------------------------------------------------------------------------------------------------// // (32 bytes) BytecodeStorageReader.CURRENT_VERSION, //---------------------------------------------------------------------------------------------------------------// // d.) store the deploying-contract's address with 0-padding to fit a 20-byte address into a 32-byte slot //---------------------------------------------------------------------------------------------------------------// // (12 bytes) hex"00_00_00_00_00_00_00_00_00_00_00_00", // (20 bytes) address(this), // uploaded data (stored as bytecode) comes last _data ); assembly { // deploy a new contract with the generated creation code. // start 32 bytes into creationCode to avoid copying the byte length. address_ := create(0, add(creationCode, 0x20), mload(creationCode)) } // address must be non-zero if contract was deployed successfully require(address_ != address(0), "ContractAsStorage: Write Error"); } }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. // Inspired by: https://ethereum.stackexchange.com/a/123950/103422 pragma solidity ^0.8.0; /** * @dev Operations on bytes32 data type, dealing with conversion to string. */ library Bytes32Strings { /** * @notice Intended to convert a `bytes32`-encoded string literal to `string`. * Trims zero padding to arrive at original string literal. */ function toString( bytes32 source ) internal pure returns (string memory result) { uint8 length; while (source[length] != 0 && length < 32) { length++; } assembly { // free memory pointer result := mload(0x40) // update free memory pointer to new "memory end" // (offset is 64-bytes: 32 for length, 32 for data) mstore(0x40, add(result, 0x40)) // store length in first 32-byte memory slot mstore(result, length) // write actual data in second 32-byte memory slot mstore(add(result, 0x20), source) } } /** * @notice Intended to check if a `bytes32`-encoded string contains a given * character with UTF-8 character code `utf8CharCode exactly `targetQty` * times. Does not support searching for multi-byte characters, only * characters with UTF-8 character codes < 0x80. */ function containsExactCharacterQty( bytes32 source, uint8 utf8CharCode, uint8 targetQty ) internal pure returns (bool) { uint8 _occurrences; uint8 i; for (i; i < 32; ) { uint8 _charCode = uint8(source[i]); // if not a null byte, or a multi-byte UTF-8 character, check match if (_charCode != 0 && _charCode < 0x80) { if (_charCode == utf8CharCode) { unchecked { // no risk of overflow since max 32 iterations < max uin8=255 ++_occurrences; } } } unchecked { // no risk of overflow since max 32 iterations < max uin8=255 ++i; } } return _occurrences == targetQty; } }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.0; import "./ICoreRegistryV1.sol"; import "./IAdminACLV0.sol"; /** * @title IMinterFilterV1 * @author Art Blocks Inc. * @notice Interface for a new minter filter contract. * This interface does not extend the previous version of the minter filter * interface, as the previous version is not compatible with the new * minter filter architecture. * @dev This interface is for a minter filter that supports multiple core * contracts, and allows for a minter to be set on a per-project basis. */ interface IMinterFilterV1 { /** * @notice Emitted when contract is deployed to notify indexing services * of the new contract deployment. */ event Deployed(); /** * @notice Globally approved minter `minter`. */ event MinterApprovedGlobally(address indexed minter, string minterType); /** * @notice Globally revoked minter `minter`. * @dev contract owner may still approve this minter on a per-contract * basis. */ event MinterRevokedGlobally(address indexed minter); /** * @notice Approved minter `minter` on core contract * `coreContract`. */ event MinterApprovedForContract( address indexed coreContract, address indexed minter, string minterType ); /** * @notice Revoked minter `minter` on core contract `coreContract`. * @dev minter filter owner may still globally approve this minter for all * contracts. */ event MinterRevokedForContract( address indexed coreContract, address indexed minter ); /** * @notice Minter at address `minter` set as minter for project * `projectId` on core contract `coreContract`. */ event ProjectMinterRegistered( uint256 indexed projectId, address indexed coreContract, address indexed minter, string minterType ); /** * @notice Minter removed for project `projectId` on core contract * `coreContract`. */ event ProjectMinterRemoved( uint256 indexed projectId, address indexed coreContract ); /** * @notice Admin ACL contract updated to `adminACLContract`. */ event AdminACLUpdated(address indexed adminACLContract); /** * @notice Core Registry contract updated to `coreRegistry`. */ 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, address minter ) external; function removeMinterForProject( uint256 projectId, address coreContract ) external; // @dev function name is optimized for gas function mint_joo( address to, uint256 projectId, address coreContract, address sender ) external returns (uint256); 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( uint256 projectId, address coreContract ) external view returns (address); function projectHasMinter( uint256 projectId, address coreContract ) external view returns (bool); /** * @notice View that returns if a core contract is registered with the * core registry, allowing this minter filter to service it. * @param coreContract core contract address to be checked */ function isRegisteredCoreContract( address coreContract ) external view returns (bool); /// Address of current core registry contract function coreRegistry() external view returns (ICoreRegistryV1); /// The current admin ACL contract function adminACLContract() external view returns (IAdminACLV0); /// The quantity of projects on a core contract that have assigned minters function getNumProjectsOnContractWithMinters( address coreContract ) external view returns (uint256); function getProjectAndMinterInfoOnContractAt( address coreContract, uint256 index ) external view returns ( uint256 projectId, address minterAddress, 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. */ function owner() external view returns (address); }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.0; import {ISharedMinterRequired} from "./ISharedMinterRequired.sol"; /** * @title ISharedMinterV0 * @notice This interface extends the minimum required interface for a shared * minter contract to add additional functionality that is generally available * for all shared minter contracts on the shared minter filter. * @dev Custom, one-off minter contracts that are not globally approved may * choose to not implement this interface, but should still implement the * ISharedMinterRequired interface. */ interface ISharedMinterV0 is ISharedMinterRequired { // Sets the local max invocations for a given project, checking that the provided max invocations is // less than or equal to the global max invocations for the project set on the core contract. // This does not impact the max invocations value defined on the core contract. function manuallyLimitProjectMaxInvocations( uint256 projectId, address coreContract, uint24 maxInvocations ) external; // Called to make the minter contract aware of the max invocations for a // given project. function syncProjectMaxInvocationsToCore( uint256 projectId, address coreContract ) external; // Gets if token price is configured, token price in wei, currency symbol, // and currency address, assuming this is project's minter. // Supersedes any defined core price. function getPriceInfo( uint256 projectId, address coreContract ) external view returns ( bool isConfigured, uint256 tokenPriceInWei, string memory currencySymbol, address currencyAddress ); }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.0; import "./IAdminACLV0.sol"; /// use the Royalty Registry's IManifold interface for token royalties import "./IManifold.sol"; /** * @title This interface is intended to house interface items that are common * across all GenArt721CoreContractV3 flagship and derivative implementations. * This interface extends the IManifold royalty interface in order to * add support the Royalty Registry by default. * @author Art Blocks Inc. */ interface IGenArt721CoreContractV3_Base is IManifold { /** * @notice Token ID `_tokenId` minted to `_to`. */ event Mint(address indexed _to, uint256 indexed _tokenId); /** * @notice currentMinter updated to `_currentMinter`. * @dev Implemented starting with V3 core */ event MinterUpdated(address indexed _currentMinter); /** * @notice Platform updated on bytes32-encoded field `_field`. */ event PlatformUpdated(bytes32 indexed _field); /** * @notice Project ID `_projectId` updated on bytes32-encoded field * `_update`. */ event ProjectUpdated(uint256 indexed _projectId, bytes32 indexed _update); event ProposedArtistAddressesAndSplits( uint256 indexed _projectId, address _artistAddress, address _additionalPayeePrimarySales, uint256 _additionalPayeePrimarySalesPercentage, address _additionalPayeeSecondarySales, uint256 _additionalPayeeSecondarySalesPercentage ); event AcceptedArtistAddressesAndSplits(uint256 indexed _projectId); // version and type of the core contract // coreVersion is a string of the form "0.x.y" function coreVersion() external view returns (string memory); // coreType is a string of the form "GenArt721CoreV3" function coreType() external view returns (string memory); // owner (pre-V3 was named admin) of contract // this is expected to be an Admin ACL contract for V3 function owner() external view returns (address); // Admin ACL contract for V3, will be at the address owner() function adminACLContract() external returns (IAdminACLV0); // backwards-compatible (pre-V3) admin - equal to owner() function admin() external view returns (address); /** * Function determining if _sender is allowed to call function with * selector _selector on contract `_contract`. Intended to be used with * peripheral contracts such as minters, as well as internally by the * core contract itself. */ function adminACLAllowed( address _sender, address _contract, bytes4 _selector ) external returns (bool); /// getter function of public variable function startingProjectId() external view returns (uint256); // 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); // @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 projectIdToAdditionalPayeePrimarySales( uint256 _projectId ) external view returns (address payable); function projectIdToAdditionalPayeePrimarySalesPercentage( uint256 _projectId ) external view returns (uint256); function projectIdToSecondaryMarketRoyaltyPercentage( uint256 _projectId ) external view returns (uint256); function projectURIInfo( uint256 _projectId ) external view returns (string memory projectBaseURI); // @dev new function in V3 function projectStateData( uint256 _projectId ) external view returns ( uint256 invocations, uint256 maxInvocations, bool active, bool paused, uint256 completedTimestamp, bool locked ); function projectDetails( uint256 _projectId ) external view returns ( string memory projectName, string memory artist, string memory description, string memory website, string memory license ); function projectScriptDetails( uint256 _projectId ) external view returns ( string memory scriptTypeAndVersion, string memory aspectRatio, uint256 scriptCount ); function projectScriptByIndex( uint256 _projectId, uint256 _index ) external view returns (string memory); function tokenIdToHash(uint256 _tokenId) external view returns (bytes32); // function to set a token's hash (must be guarded) function setTokenHash_8PT(uint256 _tokenId, bytes32 _hash) external; // @dev gas-optimized signature in V3 for `mint` function mint_Ecf( address _to, uint256 _projectId, address _by ) external returns (uint256 tokenId); }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.0; import "./IEngineRegistryV0.sol"; interface ICoreRegistryV1 is IEngineRegistryV0 { function registerContracts( address[] calldata contractAddresses, bytes32[] calldata coreVersions, bytes32[] calldata coreTypes ) external; function unregisterContracts(address[] calldata contractAddresses) external; function getNumRegisteredContracts() external view returns (uint256); function getRegisteredContractAt( uint256 index ) external view returns (address); function isRegisteredContract( address contractAddress ) external view returns (bool isRegistered); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/structs/EnumerableMap.sol) pragma solidity ^0.8.0; import "./EnumerableSet.sol"; /** * @dev Library for managing an enumerable variant of Solidity's * https://solidity.readthedocs.io/en/latest/types.html#mapping-types[`mapping`] * type. * * Maps have the following properties: * * - Entries are added, removed, and checked for existence in constant time * (O(1)). * - Entries are enumerated in O(n). No guarantees are made on the ordering. * * ``` * contract Example { * // Add the library methods * using EnumerableMap for EnumerableMap.UintToAddressMap; * * // Declare a set state variable * EnumerableMap.UintToAddressMap private myMap; * } * ``` * * The following map types are supported: * * - `uint256 -> address` (`UintToAddressMap`) since v3.0.0 * - `address -> uint256` (`AddressToUintMap`) since v4.6.0 * - `bytes32 -> bytes32` (`Bytes32ToBytes32`) since v4.6.0 * - `uint256 -> uint256` (`UintToUintMap`) since v4.7.0 * - `bytes32 -> uint256` (`Bytes32ToUintMap`) since v4.7.0 * * [WARNING] * ==== * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure unusable. * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info. * * In order to clean an EnumerableMap, you can either remove all elements one by one or create a fresh instance using an array of EnumerableMap. * ==== */ library EnumerableMap { using EnumerableSet for EnumerableSet.Bytes32Set; // To implement this library for multiple types with as little code // repetition as possible, we write it in terms of a generic Map type with // bytes32 keys and values. // The Map implementation uses private functions, and user-facing // implementations (such as Uint256ToAddressMap) are just wrappers around // the underlying Map. // This means that we can only create new EnumerableMaps for types that fit // in bytes32. struct Bytes32ToBytes32Map { // Storage of keys EnumerableSet.Bytes32Set _keys; mapping(bytes32 => bytes32) _values; } /** * @dev Adds a key-value pair to a map, or updates the value for an existing * key. O(1). * * Returns true if the key was added to the map, that is if it was not * already present. */ function set( Bytes32ToBytes32Map storage map, bytes32 key, bytes32 value ) internal returns (bool) { map._values[key] = value; return map._keys.add(key); } /** * @dev Removes a key-value pair from a map. O(1). * * Returns true if the key was removed from the map, that is if it was present. */ function remove(Bytes32ToBytes32Map storage map, bytes32 key) internal returns (bool) { delete map._values[key]; return map._keys.remove(key); } /** * @dev Returns true if the key is in the map. O(1). */ function contains(Bytes32ToBytes32Map storage map, bytes32 key) internal view returns (bool) { return map._keys.contains(key); } /** * @dev Returns the number of key-value pairs in the map. O(1). */ function length(Bytes32ToBytes32Map storage map) internal view returns (uint256) { return map._keys.length(); } /** * @dev Returns the key-value pair stored at position `index` in the map. O(1). * * Note that there are no guarantees on the ordering of entries inside the * array, and it may change when more entries are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(Bytes32ToBytes32Map storage map, uint256 index) internal view returns (bytes32, bytes32) { bytes32 key = map._keys.at(index); return (key, map._values[key]); } /** * @dev Tries to returns the value associated with `key`. O(1). * Does not revert if `key` is not in the map. */ function tryGet(Bytes32ToBytes32Map storage map, bytes32 key) internal view returns (bool, bytes32) { bytes32 value = map._values[key]; if (value == bytes32(0)) { return (contains(map, key), bytes32(0)); } else { return (true, value); } } /** * @dev Returns the value associated with `key`. O(1). * * Requirements: * * - `key` must be in the map. */ function get(Bytes32ToBytes32Map storage map, bytes32 key) internal view returns (bytes32) { bytes32 value = map._values[key]; require(value != 0 || contains(map, key), "EnumerableMap: nonexistent key"); return value; } /** * @dev Same as {_get}, with a custom error message when `key` is not in the map. * * CAUTION: This function is deprecated because it requires allocating memory for the error * message unnecessarily. For custom revert reasons use {_tryGet}. */ function get( Bytes32ToBytes32Map storage map, bytes32 key, string memory errorMessage ) internal view returns (bytes32) { bytes32 value = map._values[key]; require(value != 0 || contains(map, key), errorMessage); return value; } // UintToUintMap struct UintToUintMap { Bytes32ToBytes32Map _inner; } /** * @dev Adds a key-value pair to a map, or updates the value for an existing * key. O(1). * * Returns true if the key was added to the map, that is if it was not * already present. */ function set( UintToUintMap storage map, uint256 key, uint256 value ) internal returns (bool) { return set(map._inner, bytes32(key), bytes32(value)); } /** * @dev Removes a value from a set. O(1). * * Returns true if the key was removed from the map, that is if it was present. */ function remove(UintToUintMap storage map, uint256 key) internal returns (bool) { return remove(map._inner, bytes32(key)); } /** * @dev Returns true if the key is in the map. O(1). */ function contains(UintToUintMap storage map, uint256 key) internal view returns (bool) { return contains(map._inner, bytes32(key)); } /** * @dev Returns the number of elements in the map. O(1). */ function length(UintToUintMap storage map) internal view returns (uint256) { return length(map._inner); } /** * @dev Returns the element stored at position `index` in the set. O(1). * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(UintToUintMap storage map, uint256 index) internal view returns (uint256, uint256) { (bytes32 key, bytes32 value) = at(map._inner, index); return (uint256(key), uint256(value)); } /** * @dev Tries to returns the value associated with `key`. O(1). * Does not revert if `key` is not in the map. */ function tryGet(UintToUintMap storage map, uint256 key) internal view returns (bool, uint256) { (bool success, bytes32 value) = tryGet(map._inner, bytes32(key)); return (success, uint256(value)); } /** * @dev Returns the value associated with `key`. O(1). * * Requirements: * * - `key` must be in the map. */ function get(UintToUintMap storage map, uint256 key) internal view returns (uint256) { return uint256(get(map._inner, bytes32(key))); } /** * @dev Same as {get}, with a custom error message when `key` is not in the map. * * CAUTION: This function is deprecated because it requires allocating memory for the error * message unnecessarily. For custom revert reasons use {tryGet}. */ function get( UintToUintMap storage map, uint256 key, string memory errorMessage ) internal view returns (uint256) { return uint256(get(map._inner, bytes32(key), errorMessage)); } // UintToAddressMap struct UintToAddressMap { Bytes32ToBytes32Map _inner; } /** * @dev Adds a key-value pair to a map, or updates the value for an existing * key. O(1). * * Returns true if the key was added to the map, that is if it was not * already present. */ function set( UintToAddressMap storage map, uint256 key, address value ) internal returns (bool) { return set(map._inner, bytes32(key), bytes32(uint256(uint160(value)))); } /** * @dev Removes a value from a set. O(1). * * Returns true if the key was removed from the map, that is if it was present. */ function remove(UintToAddressMap storage map, uint256 key) internal returns (bool) { return remove(map._inner, bytes32(key)); } /** * @dev Returns true if the key is in the map. O(1). */ function contains(UintToAddressMap storage map, uint256 key) internal view returns (bool) { return contains(map._inner, bytes32(key)); } /** * @dev Returns the number of elements in the map. O(1). */ function length(UintToAddressMap storage map) internal view returns (uint256) { return length(map._inner); } /** * @dev Returns the element stored at position `index` in the set. O(1). * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(UintToAddressMap storage map, uint256 index) internal view returns (uint256, address) { (bytes32 key, bytes32 value) = at(map._inner, index); return (uint256(key), address(uint160(uint256(value)))); } /** * @dev Tries to returns the value associated with `key`. O(1). * Does not revert if `key` is not in the map. * * _Available since v3.4._ */ function tryGet(UintToAddressMap storage map, uint256 key) internal view returns (bool, address) { (bool success, bytes32 value) = tryGet(map._inner, bytes32(key)); return (success, address(uint160(uint256(value)))); } /** * @dev Returns the value associated with `key`. O(1). * * Requirements: * * - `key` must be in the map. */ function get(UintToAddressMap storage map, uint256 key) internal view returns (address) { return address(uint160(uint256(get(map._inner, bytes32(key))))); } /** * @dev Same as {get}, with a custom error message when `key` is not in the map. * * CAUTION: This function is deprecated because it requires allocating memory for the error * message unnecessarily. For custom revert reasons use {tryGet}. */ function get( UintToAddressMap storage map, uint256 key, string memory errorMessage ) internal view returns (address) { return address(uint160(uint256(get(map._inner, bytes32(key), errorMessage)))); } // AddressToUintMap struct AddressToUintMap { Bytes32ToBytes32Map _inner; } /** * @dev Adds a key-value pair to a map, or updates the value for an existing * key. O(1). * * Returns true if the key was added to the map, that is if it was not * already present. */ function set( AddressToUintMap storage map, address key, uint256 value ) internal returns (bool) { return set(map._inner, bytes32(uint256(uint160(key))), bytes32(value)); } /** * @dev Removes a value from a set. O(1). * * Returns true if the key was removed from the map, that is if it was present. */ function remove(AddressToUintMap storage map, address key) internal returns (bool) { return remove(map._inner, bytes32(uint256(uint160(key)))); } /** * @dev Returns true if the key is in the map. O(1). */ function contains(AddressToUintMap storage map, address key) internal view returns (bool) { return contains(map._inner, bytes32(uint256(uint160(key)))); } /** * @dev Returns the number of elements in the map. O(1). */ function length(AddressToUintMap storage map) internal view returns (uint256) { return length(map._inner); } /** * @dev Returns the element stored at position `index` in the set. O(1). * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(AddressToUintMap storage map, uint256 index) internal view returns (address, uint256) { (bytes32 key, bytes32 value) = at(map._inner, index); return (address(uint160(uint256(key))), uint256(value)); } /** * @dev Tries to returns the value associated with `key`. O(1). * Does not revert if `key` is not in the map. */ function tryGet(AddressToUintMap storage map, address key) internal view returns (bool, uint256) { (bool success, bytes32 value) = tryGet(map._inner, bytes32(uint256(uint160(key)))); return (success, uint256(value)); } /** * @dev Returns the value associated with `key`. O(1). * * Requirements: * * - `key` must be in the map. */ function get(AddressToUintMap storage map, address key) internal view returns (uint256) { return uint256(get(map._inner, bytes32(uint256(uint160(key))))); } /** * @dev Same as {get}, with a custom error message when `key` is not in the map. * * CAUTION: This function is deprecated because it requires allocating memory for the error * message unnecessarily. For custom revert reasons use {tryGet}. */ function get( AddressToUintMap storage map, address key, string memory errorMessage ) internal view returns (uint256) { return uint256(get(map._inner, bytes32(uint256(uint160(key))), errorMessage)); } // Bytes32ToUintMap struct Bytes32ToUintMap { Bytes32ToBytes32Map _inner; } /** * @dev Adds a key-value pair to a map, or updates the value for an existing * key. O(1). * * Returns true if the key was added to the map, that is if it was not * already present. */ function set( Bytes32ToUintMap storage map, bytes32 key, uint256 value ) internal returns (bool) { return set(map._inner, key, bytes32(value)); } /** * @dev Removes a value from a set. O(1). * * Returns true if the key was removed from the map, that is if it was present. */ function remove(Bytes32ToUintMap storage map, bytes32 key) internal returns (bool) { return remove(map._inner, key); } /** * @dev Returns true if the key is in the map. O(1). */ function contains(Bytes32ToUintMap storage map, bytes32 key) internal view returns (bool) { return contains(map._inner, key); } /** * @dev Returns the number of elements in the map. O(1). */ function length(Bytes32ToUintMap storage map) internal view returns (uint256) { return length(map._inner); } /** * @dev Returns the element stored at position `index` in the set. O(1). * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(Bytes32ToUintMap storage map, uint256 index) internal view returns (bytes32, uint256) { (bytes32 key, bytes32 value) = at(map._inner, index); return (key, uint256(value)); } /** * @dev Tries to returns the value associated with `key`. O(1). * Does not revert if `key` is not in the map. */ function tryGet(Bytes32ToUintMap storage map, bytes32 key) internal view returns (bool, uint256) { (bool success, bytes32 value) = tryGet(map._inner, key); return (success, uint256(value)); } /** * @dev Returns the value associated with `key`. O(1). * * Requirements: * * - `key` must be in the map. */ function get(Bytes32ToUintMap storage map, bytes32 key) internal view returns (uint256) { return uint256(get(map._inner, key)); } /** * @dev Same as {get}, with a custom error message when `key` is not in the map. * * CAUTION: This function is deprecated because it requires allocating memory for the error * message unnecessarily. For custom revert reasons use {tryGet}. */ function get( Bytes32ToUintMap storage map, bytes32 key, string memory errorMessage ) internal view returns (uint256) { return uint256(get(map._inner, key, errorMessage)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/structs/EnumerableSet.sol) pragma solidity ^0.8.0; /** * @dev Library for managing * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive * types. * * Sets have the following properties: * * - Elements are added, removed, and checked for existence in constant time * (O(1)). * - Elements are enumerated in O(n). No guarantees are made on the ordering. * * ``` * contract Example { * // Add the library methods * using EnumerableSet for EnumerableSet.AddressSet; * * // Declare a set state variable * EnumerableSet.AddressSet private mySet; * } * ``` * * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`) * and `uint256` (`UintSet`) are supported. * * [WARNING] * ==== * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure unusable. * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info. * * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an array of EnumerableSet. * ==== */ library EnumerableSet { // To implement this library for multiple types with as little code // repetition as possible, we write it in terms of a generic Set type with // bytes32 values. // The Set implementation uses private functions, and user-facing // implementations (such as AddressSet) are just wrappers around the // underlying Set. // This means that we can only create new EnumerableSets for types that fit // in bytes32. struct Set { // Storage of set values bytes32[] _values; // Position of the value in the `values` array, plus 1 because index 0 // means a value is not in the set. mapping(bytes32 => uint256) _indexes; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function _add(Set storage set, bytes32 value) private returns (bool) { if (!_contains(set, value)) { set._values.push(value); // The value is stored at length-1, but we add 1 to all indexes // and use 0 as a sentinel value set._indexes[value] = set._values.length; return true; } else { return false; } } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function _remove(Set storage set, bytes32 value) private returns (bool) { // We read and store the value's index to prevent multiple reads from the same storage slot uint256 valueIndex = set._indexes[value]; if (valueIndex != 0) { // Equivalent to contains(set, value) // To delete an element from the _values array in O(1), we swap the element to delete with the last one in // the array, and then remove the last element (sometimes called as 'swap and pop'). // This modifies the order of the array, as noted in {at}. uint256 toDeleteIndex = valueIndex - 1; uint256 lastIndex = set._values.length - 1; if (lastIndex != toDeleteIndex) { bytes32 lastValue = set._values[lastIndex]; // Move the last value to the index where the value to delete is set._values[toDeleteIndex] = lastValue; // Update the index for the moved value set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex } // Delete the slot where the moved value was stored set._values.pop(); // Delete the index for the deleted slot delete set._indexes[value]; return true; } else { return false; } } /** * @dev Returns true if the value is in the set. O(1). */ function _contains(Set storage set, bytes32 value) private view returns (bool) { return set._indexes[value] != 0; } /** * @dev Returns the number of values on the set. O(1). */ function _length(Set storage set) private view returns (uint256) { return set._values.length; } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function _at(Set storage set, uint256 index) private view returns (bytes32) { return set._values[index]; } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function _values(Set storage set) private view returns (bytes32[] memory) { return set._values; } // Bytes32Set struct Bytes32Set { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _add(set._inner, value); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _remove(set._inner, value); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) { return _contains(set._inner, value); } /** * @dev Returns the number of values in the set. O(1). */ function length(Bytes32Set storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) { return _at(set._inner, index); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(Bytes32Set storage set) internal view returns (bytes32[] memory) { return _values(set._inner); } // AddressSet struct AddressSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(AddressSet storage set, address value) internal returns (bool) { return _add(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(AddressSet storage set, address value) internal returns (bool) { return _remove(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(AddressSet storage set, address value) internal view returns (bool) { return _contains(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns the number of values in the set. O(1). */ function length(AddressSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(AddressSet storage set, uint256 index) internal view returns (address) { return address(uint160(uint256(_at(set._inner, index)))); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(AddressSet storage set) internal view returns (address[] memory) { bytes32[] memory store = _values(set._inner); address[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } // UintSet struct UintSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(UintSet storage set, uint256 value) internal returns (bool) { return _add(set._inner, bytes32(value)); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(UintSet storage set, uint256 value) internal returns (bool) { return _remove(set._inner, bytes32(value)); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(UintSet storage set, uint256 value) internal view returns (bool) { return _contains(set._inner, bytes32(value)); } /** * @dev Returns the number of values on the set. O(1). */ function length(UintSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(UintSet storage set, uint256 index) internal view returns (uint256) { return uint256(_at(set._inner, index)); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(UintSet storage set) internal view returns (uint256[] memory) { bytes32[] memory store = _values(set._inner); uint256[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/math/Math.sol) pragma solidity ^0.8.0; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { enum Rounding { Down, // Toward negative infinity Up, // Toward infinity Zero // Toward zero } /** * @dev Returns the largest of two numbers. */ function max(uint256 a, uint256 b) internal pure returns (uint256) { return a >= b ? a : b; } /** * @dev Returns the smallest of two numbers. */ function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /** * @dev Returns the average of two numbers. The result is rounded towards * zero. */ function average(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b) / 2 can overflow. return (a & b) + (a ^ b) / 2; } /** * @dev Returns the ceiling of the division of two numbers. * * This differs from standard division with `/` in that it rounds up instead * of rounding down. */ function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b - 1) / b can overflow on addition, so we distribute. return a == 0 ? 0 : (a - 1) / b + 1; } /** * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0 * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) * with further edits by Uniswap Labs also under MIT license. */ function mulDiv( uint256 x, uint256 y, uint256 denominator ) internal pure returns (uint256 result) { unchecked { // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256 // variables such that product = prod1 * 2^256 + prod0. uint256 prod0; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod0 := mul(x, y) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { return prod0 / denominator; } // Make sure the result is less than 2^256. Also prevents denominator == 0. require(denominator > prod1); /////////////////////////////////////////////// // 512 by 256 division. /////////////////////////////////////////////// // Make division exact by subtracting the remainder from [prod1 prod0]. uint256 remainder; assembly { // Compute remainder using mulmod. remainder := mulmod(x, y, denominator) // Subtract 256 bit number from 512 bit number. prod1 := sub(prod1, gt(remainder, prod0)) prod0 := sub(prod0, remainder) } // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1. // See https://cs.stackexchange.com/q/138556/92363. // Does not overflow because the denominator cannot be zero at this stage in the function. uint256 twos = denominator & (~denominator + 1); assembly { // Divide denominator by twos. denominator := div(denominator, twos) // Divide [prod1 prod0] by twos. prod0 := div(prod0, twos) // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one. twos := add(div(sub(0, twos), twos), 1) } // Shift in bits from prod1 into prod0. prod0 |= prod1 * twos; // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for // four bits. That is, denominator * inv = 1 mod 2^4. uint256 inverse = (3 * denominator) ^ 2; // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works // in modular arithmetic, doubling the correct bits in each step. inverse *= 2 - denominator * inverse; // inverse mod 2^8 inverse *= 2 - denominator * inverse; // inverse mod 2^16 inverse *= 2 - denominator * inverse; // inverse mod 2^32 inverse *= 2 - denominator * inverse; // inverse mod 2^64 inverse *= 2 - denominator * inverse; // inverse mod 2^128 inverse *= 2 - denominator * inverse; // inverse mod 2^256 // Because the division is now exact we can divide by multiplying with the modular inverse of denominator. // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1 // is no longer required. result = prod0 * inverse; return result; } } /** * @notice Calculates x * y / denominator with full precision, following the selected rounding direction. */ function mulDiv( uint256 x, uint256 y, uint256 denominator, Rounding rounding ) internal pure returns (uint256) { uint256 result = mulDiv(x, y, denominator); if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) { result += 1; } return result; } /** * @dev Returns the square root of a number. It the number is not a perfect square, the value is rounded down. * * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11). */ function sqrt(uint256 a) internal pure returns (uint256) { if (a == 0) { return 0; } // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target. // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have // `msb(a) <= a < 2*msb(a)`. // We also know that `k`, the position of the most significant bit, is such that `msb(a) = 2**k`. // This gives `2**k < a <= 2**(k+1)` → `2**(k/2) <= sqrt(a) < 2 ** (k/2+1)`. // Using an algorithm similar to the msb conmputation, we are able to compute `result = 2**(k/2)` which is a // good first aproximation of `sqrt(a)` with at least 1 correct bit. uint256 result = 1; uint256 x = a; if (x >> 128 > 0) { x >>= 128; result <<= 64; } if (x >> 64 > 0) { x >>= 64; result <<= 32; } if (x >> 32 > 0) { x >>= 32; result <<= 16; } if (x >> 16 > 0) { x >>= 16; result <<= 8; } if (x >> 8 > 0) { x >>= 8; result <<= 4; } if (x >> 4 > 0) { x >>= 4; result <<= 2; } if (x >> 2 > 0) { result <<= 1; } // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128, // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision // into the expected uint128 result. unchecked { result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; return min(result, a / result); } } /** * @notice Calculates sqrt(a), following the selected rounding direction. */ function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) { uint256 result = sqrt(a); if (rounding == Rounding.Up && result * result < a) { result += 1; } return result; } }
// SPDX-License-Identifier: MIT // Copyright (c) 2023 the ethier authors (github.com/divergencetech/ethier) pragma solidity >=0.8.0 <0.9.0; import {AccessControlEnumerable} from "../utils/AccessControlEnumerable.sol"; import {ERC721A, ERC721ACommon} from "./ERC721ACommon.sol"; /** * @notice ERC721 extension that implements a commonly used _baseURI() function * to return an URL prefix that can be set by the contract steerer. */ contract BaseTokenURI is AccessControlEnumerable { /** * @notice Base token URI used as a prefix by tokenURI(). */ string private _baseTokenURI; constructor(string memory baseTokenURI_) { _setBaseTokenURI(baseTokenURI_); } /** * @notice Sets the base token URI prefix. * @dev Only callable by the contract steerer. */ function setBaseTokenURI(string memory baseTokenURI_) public onlyRole(DEFAULT_STEERING_ROLE) { _setBaseTokenURI(baseTokenURI_); } /** * @notice Sets the base token URI prefix. */ function _setBaseTokenURI(string memory baseTokenURI_) internal virtual { _baseTokenURI = baseTokenURI_; } /** * @notice Returns the `baseTokenURI`. */ function baseTokenURI() public view virtual returns (string memory) { return _baseTokenURI; } /** * @notice Returns the base token URI * without any additional characters (e.g. a slash). */ function _baseURI() internal view virtual returns (string memory) { return _baseTokenURI; } } /** * @notice ERC721ACommon extension that adds BaseTokenURI. */ abstract contract ERC721ACommonBaseTokenURI is ERC721ACommon, BaseTokenURI { /** * @notice Overrides supportsInterface as required by inheritance. */ function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721ACommon, AccessControlEnumerable) returns (bool) { return ERC721ACommon.supportsInterface(interfaceId) || AccessControlEnumerable.supportsInterface(interfaceId); } /** * @dev Inheritance resolution. */ function _baseURI() internal view virtual override(ERC721A, BaseTokenURI) returns (string memory) { return BaseTokenURI._baseURI(); } }
// SPDX-License-Identifier: MIT // Copyright (c) 2023 SolidifyLabs pragma solidity >=0.8.0 <0.9.0; import {Address} from "@openzeppelin/contracts/utils/Address.sol"; import {OperatorFilterer} from "operator-filter-registry/src/OperatorFilterer.sol"; import {OperatorFilterRegistry} from "operator-filter-registry/src/OperatorFilterRegistry.sol"; import { CANONICAL_CORI_SUBSCRIPTION, CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS } from "operator-filter-registry/src/lib/Constants.sol"; import {ERC721A, ERC721ACommon} from "ethier/erc721/ERC721ACommon.sol"; address constant BLUR_SUBSCRIPTION = 0x9dC5EE2D52d014f8b81D662FA8f4CA525F27cD6b; /** * @notice Extends OpenSea's DefaultOperatorFilterer, using BLUR_SUBSCRIPTION if available. */ abstract contract DefaultOperatorFilterer is OperatorFilterer { constructor() OperatorFilterer(_defaultSubscription(), true) {} /** * @notice Returns the default subscription address. * @dev The blur subscription is used if it is registered, otherwise the canonical OS subscription is used. */ function _defaultSubscription() private view returns (address) { if ( CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS.code.length > 0 // Using OperatorFilterRegistry instead of IOperatorFilterRegistry as the function on the interface is // not view. && OperatorFilterRegistry(CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS).isRegistered(BLUR_SUBSCRIPTION) ) { return BLUR_SUBSCRIPTION; } return CANONICAL_CORI_SUBSCRIPTION; } } /** * @notice ERC721ACommon extension that adds Opensea's operator filtering. */ abstract contract ERC721ACommonOperatorFilterOS is ERC721ACommon, DefaultOperatorFilterer { using Address for address; /** * @notice Calling the operator filter registry with given calldata. * @dev The registry contract did not foresee role-based contract access * control - only the contract itself, or its (EIP-173) owner is allowed to * change subscription settings. To work around this, we enforce * authorisation here and forward arbitrary calldata to the registry. * Use with care! */ function callOperatorFilterRegistry(bytes calldata cdata) external onlyRole(DEFAULT_STEERING_ROLE) returns (bytes memory) { return address(OPERATOR_FILTER_REGISTRY).functionCall(cdata); } // ========================================================================= // Operator filtering // ========================================================================= function setApprovalForAll(address operator, bool approved) public virtual override onlyAllowedOperatorApproval(operator) { super.setApprovalForAll(operator, approved); } function approve(address operator, uint256 tokenId) public payable virtual override onlyAllowedOperatorApproval(operator) { super.approve(operator, tokenId); } function transferFrom(address from, address to, uint256 tokenId) public payable virtual override onlyAllowedOperator(from) { super.transferFrom(from, to, tokenId); } function safeTransferFrom(address from, address to, uint256 tokenId) public payable virtual override onlyAllowedOperator(from) { super.safeTransferFrom(from, to, tokenId); } function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public payable virtual override onlyAllowedOperator(from) { super.safeTransferFrom(from, to, tokenId, data); } }
// SPDX-License-Identifier: MIT // Copyright 2023 PROOF Holdings Inc pragma solidity >=0.8.0 <0.9.0; import {ERC721ACommon} from "ethier/erc721/ERC721ACommon.sol"; import {AccessControlEnumerable, BaseSellable} from "./BaseSellable.sol"; /** * @notice Base contract for sellable ERC721ACommon tokens. */ abstract contract SellableERC721ACommon is BaseSellable, ERC721ACommon { /** * @inheritdoc BaseSellable */ function _handleSale(address to, uint64 num, bytes calldata) internal virtual override { _mint(to, num); } function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721ACommon, AccessControlEnumerable) returns (bool) { return ERC721ACommon.supportsInterface(interfaceId) || AccessControlEnumerable.supportsInterface(interfaceId); } }
// SPDX-License-Identifier: MIT // Copyright 2023 Proof Holdings Inc. pragma solidity >=0.8.0 <0.9.0; import {ISellable} from "solidifylabs/sellers/interfaces/ISellable.sol"; import {SellableERC721ACommon} from "solidifylabs/sellers/sellable/SellableERC721ACommon.sol"; /** * @notice Library for encoding and decoding purchase data for the Diamond Exhibition sellers. */ library PurchaseByProjectIDLib { function encodePurchaseData(uint128[] memory ids) internal pure returns (bytes memory) { return abi.encode(ids); } function decodePurchaseData(bytes memory data) internal pure returns (uint128[] memory) { return abi.decode(data, (uint128[])); } } /** * @notice Token information module for SellableERC721ACommonByProjectID. * @dev Separated for testability. * @author David Huber (@cxkoda) * @custom:reviewer Arran Schlosberg (@divergencearran) * @custom:reviewer Josh Laird (@jbmlaird) */ contract TokenInfoManager { /** * @notice Encodes token information. * @param projectId the ID of the project associated with the token. * @param edition the edition of the token within the given project. * @param extra extra information. */ struct TokenInfo { uint128 projectId; uint64 edition; bytes8 extra; } /** * @notice Stores token information. */ mapping(uint256 => TokenInfo) private _infos; /** * @notice Returns the token information for the given token IDs. * @dev Intended for off-chain use only. */ function tokenInfos(uint256[] calldata tokenIds) external view returns (TokenInfo[] memory) { TokenInfo[] memory infos = new TokenInfo[](tokenIds.length); for (uint256 i = 0; i < tokenIds.length; ++i) { infos[i] = tokenInfo(tokenIds[i]); } return infos; } /** * @notice Returns the token information for the given token ID. */ function tokenInfo(uint256 tokenId) public view returns (TokenInfo memory) { return _infos[tokenId]; } /** * @notice Sets the token information for the given token ID. */ function _setTokenInfo(uint256 tokenId, TokenInfo memory info) internal { _infos[tokenId] = info; } } /** * @dev Interface to indicate that the sellable handles purchase data with project IDs. */ interface ISellableByProjectID is ISellable {} /** * @notice A sellable ERC721 contract that assigns a project ID to each token. * @author David Huber (@cxkoda) * @custom:reviewer Arran Schlosberg (@divergencearran) * @custom:reviewer Josh Laird (@jbmlaird) */ abstract contract SellableERC721ACommonByProjectID is SellableERC721ACommon, TokenInfoManager, ISellableByProjectID { // ========================================================================= // Storage // ================================================================================================================= /** * @notice The number of tokens minted per project. */ mapping(uint128 => uint64) private _numPurchasedPerProject; /** * @inheritdoc SellableERC721ACommon * @dev Mints tokens with given project IDs encoded in the purchase data. */ function _handleSale(address to, uint64 num, bytes calldata data) internal virtual override { uint128[] memory projectIds = PurchaseByProjectIDLib.decodePurchaseData(data); assert(projectIds.length == num); uint256 tokenId = _nextTokenId(); for (uint256 i = 0; i < num; ++i) { // effects uint128 projectId = projectIds[i]; uint64 edition = _numPurchasedPerProject[projectId]++; _setTokenInfo(tokenId, TokenInfo({projectId: projectId, edition: edition, extra: bytes8(0)})); // interactions _handleProjectMinted(tokenId, projectId, edition); tokenId++; } super._handleSale(to, num, data); } /** * @notice Hook called when a token with a given project ID is minted. */ function _handleProjectMinted(uint256 tokenId, uint128 projectId, uint64 edition) internal virtual {} /** * @notice Returns the number of tokens minted for a given project. */ function numPurchasedPerProject(uint128 projectId) public view returns (uint64) { return _numPurchasedPerProject[projectId]; } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.2.3 // Creator: Chiru Labs pragma solidity ^0.8.4; /** * @dev Interface of ERC721A. */ interface IERC721A { /** * The caller must own the token or be an approved operator. */ error ApprovalCallerNotOwnerNorApproved(); /** * The token does not exist. */ error ApprovalQueryForNonexistentToken(); /** * Cannot query the balance for the zero address. */ error BalanceQueryForZeroAddress(); /** * Cannot mint to the zero address. */ error MintToZeroAddress(); /** * The quantity of tokens minted must be more than zero. */ error MintZeroQuantity(); /** * The token does not exist. */ error OwnerQueryForNonexistentToken(); /** * The caller must own the token or be an approved operator. */ error TransferCallerNotOwnerNorApproved(); /** * The token must be owned by `from`. */ error TransferFromIncorrectOwner(); /** * Cannot safely transfer to a contract that does not implement the * ERC721Receiver interface. */ error TransferToNonERC721ReceiverImplementer(); /** * Cannot transfer to the zero address. */ error TransferToZeroAddress(); /** * The token does not exist. */ error URIQueryForNonexistentToken(); /** * The `quantity` minted with ERC2309 exceeds the safety limit. */ error MintERC2309QuantityExceedsLimit(); /** * The `extraData` cannot be set on an unintialized ownership slot. */ error OwnershipNotInitializedForExtraData(); // ============================================================= // STRUCTS // ============================================================= struct TokenOwnership { // The address of the owner. address addr; // Stores the start time of ownership with minimal overhead for tokenomics. uint64 startTimestamp; // Whether the token has been burned. bool burned; // Arbitrary data similar to `startTimestamp` that can be set via {_extraData}. uint24 extraData; } // ============================================================= // TOKEN COUNTERS // ============================================================= /** * @dev Returns the total number of tokens in existence. * Burned tokens will reduce the count. * To get the total number of tokens minted, please see {_totalMinted}. */ function totalSupply() external view returns (uint256); // ============================================================= // IERC165 // ============================================================= /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified) * to learn more about how these ids are created. * * This function call must use less than 30000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); // ============================================================= // IERC721 // ============================================================= /** * @dev Emitted when `tokenId` token is transferred from `from` to `to`. */ event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. */ event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables or disables * (`approved`) `operator` to manage all of its assets. */ event ApprovalForAll(address indexed owner, address indexed operator, bool approved); /** * @dev Returns the number of tokens in `owner`'s account. */ function balanceOf(address owner) external view returns (uint256 balance); /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) external view returns (address owner); /** * @dev Safely transfers `tokenId` token from `from` to `to`, * checking first that contract recipients are aware of the ERC721 protocol * to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be have been allowed to move * this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes calldata data ) external payable; /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom( address from, address to, uint256 tokenId ) external payable; /** * @dev Transfers `tokenId` from `from` to `to`. * * WARNING: Usage of this method is discouraged, use {safeTransferFrom} * whenever possible. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) external payable; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the * zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external payable; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} * for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool _approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll}. */ function isApprovedForAll(address owner, address operator) external view returns (bool); // ============================================================= // IERC721Metadata // ============================================================= /** * @dev Returns the token collection name. */ function name() external view returns (string memory); /** * @dev Returns the token collection symbol. */ function symbol() external view returns (string memory); /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) external view returns (string memory); // ============================================================= // IERC2309 // ============================================================= /** * @dev Emitted when tokens in `fromTokenId` to `toTokenId` * (inclusive) is transferred from `from` to `to`, as defined in the * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard. * * See {_mintERC2309} for more details. */ event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (interfaces/IERC2981.sol) pragma solidity ^0.8.0; import "../utils/introspection/IERC165.sol"; /** * @dev Interface for the NFT Royalty Standard. * * A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal * support for royalty payments across all NFT marketplaces and ecosystem participants. * * _Available since v4.5._ */ interface IERC2981 is IERC165 { /** * @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of * exchange. The royalty amount is denominated and should be paid in that same unit of exchange. */ function royaltyInfo(uint256 tokenId, uint256 salePrice) external view returns (address receiver, uint256 royaltyAmount); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol) pragma solidity ^0.8.0; import "./IERC165.sol"; /** * @dev Implementation of the {IERC165} interface. * * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check * for the additional interface id that will be supported. For example: * * ```solidity * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId); * } * ``` * * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation. */ abstract contract ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IERC165).interfaceId; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (access/AccessControlEnumerable.sol) pragma solidity ^0.8.0; import "./IAccessControlEnumerable.sol"; import "./AccessControl.sol"; import "../utils/structs/EnumerableSet.sol"; /** * @dev Extension of {AccessControl} that allows enumerating the members of each role. */ abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl { using EnumerableSet for EnumerableSet.AddressSet; mapping(bytes32 => EnumerableSet.AddressSet) private _roleMembers; /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns one of the accounts that have `role`. `index` must be a * value between 0 and {getRoleMemberCount}, non-inclusive. * * Role bearers are not sorted in any particular way, and their ordering may * change at any point. * * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure * you perform all queries on the same block. See the following * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post] * for more information. */ function getRoleMember(bytes32 role, uint256 index) public view virtual override returns (address) { return _roleMembers[role].at(index); } /** * @dev Returns the number of accounts that have `role`. Can be used * together with {getRoleMember} to enumerate all bearers of a role. */ function getRoleMemberCount(bytes32 role) public view virtual override returns (uint256) { return _roleMembers[role].length(); } /** * @dev Overload {_grantRole} to track enumerable memberships */ function _grantRole(bytes32 role, address account) internal virtual override { super._grantRole(role, account); _roleMembers[role].add(account); } /** * @dev Overload {_revokeRole} to track enumerable memberships */ function _revokeRole(bytes32 role, address account) internal virtual override { super._revokeRole(role, account); _roleMembers[role].remove(account); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol) pragma solidity ^0.8.0; import "../utils/Context.sol"; /** * @dev Contract module which allows children to implement an emergency stop * mechanism that can be triggered by an authorized account. * * This module is used through inheritance. It will make available the * modifiers `whenNotPaused` and `whenPaused`, which can be applied to * the functions of your contract. Note that they will not be pausable by * simply including this module, only once the modifiers are put in place. */ abstract contract Pausable is Context { /** * @dev Emitted when the pause is triggered by `account`. */ event Paused(address account); /** * @dev Emitted when the pause is lifted by `account`. */ event Unpaused(address account); bool private _paused; /** * @dev Initializes the contract in unpaused state. */ constructor() { _paused = false; } /** * @dev Modifier to make a function callable only when the contract is not paused. * * Requirements: * * - The contract must not be paused. */ modifier whenNotPaused() { _requireNotPaused(); _; } /** * @dev Modifier to make a function callable only when the contract is paused. * * Requirements: * * - The contract must be paused. */ modifier whenPaused() { _requirePaused(); _; } /** * @dev Returns true if the contract is paused, and false otherwise. */ function paused() public view virtual returns (bool) { return _paused; } /** * @dev Throws if the contract is paused. */ function _requireNotPaused() internal view virtual { require(!paused(), "Pausable: paused"); } /** * @dev Throws if the contract is not paused. */ function _requirePaused() internal view virtual { require(paused(), "Pausable: not paused"); } /** * @dev Triggers stopped state. * * Requirements: * * - The contract must not be paused. */ function _pause() internal virtual whenNotPaused { _paused = true; emit Paused(_msgSender()); } /** * @dev Returns to normal state. * * Requirements: * * - The contract must be paused. */ function _unpause() internal virtual whenPaused { _paused = false; emit Unpaused(_msgSender()); } }
// 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; }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.0; import "./IAdminACLV0.sol"; import "./IGenArt721CoreContractV3_Base.sol"; interface IGenArt721CoreContractV3_Engine 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); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Context.sol) pragma solidity ^0.8.0; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/IERC721.sol) pragma solidity ^0.8.0; import "../../utils/introspection/IERC165.sol"; /** * @dev Required interface of an ERC721 compliant contract. */ interface IERC721 is IERC165 { /** * @dev Emitted when `tokenId` token is transferred from `from` to `to`. */ event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. */ event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets. */ event ApprovalForAll(address indexed owner, address indexed operator, bool approved); /** * @dev Returns the number of tokens in ``owner``'s account. */ function balanceOf(address owner) external view returns (uint256 balance); /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) external view returns (address owner); /** * @dev Safely transfers `tokenId` token from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes calldata data ) external; /** * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients * are aware of the ERC721 protocol to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId ) external; /** * @dev Transfers `tokenId` token from `from` to `to`. * * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) external; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool _approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll} */ function isApprovedForAll(address owner, address operator) external view returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol) pragma solidity ^0.8.0; /** * @title ERC721 token receiver interface * @dev Interface for any contract that wants to support safeTransfers * from ERC721 asset contracts. */ interface IERC721Receiver { /** * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom} * by `operator` from `from`, this function is called. * * It must return its Solidity selector to confirm the token transfer. * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted. * * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`. */ function onERC721Received( address operator, address from, uint256 tokenId, bytes calldata data ) external returns (bytes4); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol) pragma solidity ^0.8.0; import "../IERC721.sol"; /** * @title ERC-721 Non-Fungible Token Standard, optional metadata extension * @dev See https://eips.ethereum.org/EIPS/eip-721 */ interface IERC721Metadata is IERC721 { /** * @dev Returns the token collection name. */ function name() external view returns (string memory); /** * @dev Returns the token collection symbol. */ function symbol() external view returns (string memory); /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) external view returns (string memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCall(target, data, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value ) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); require(isContract(target), "Address: call to non-contract"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { require(isContract(target), "Address: static call to non-contract"); (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { require(isContract(target), "Address: delegate call to non-contract"); (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol) pragma solidity ^0.8.0; /** * @dev String operations. */ library Strings { bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef"; uint8 private constant _ADDRESS_LENGTH = 20; /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { // Inspired by OraclizeAPI's implementation - MIT licence // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol if (value == 0) { return "0"; } uint256 temp = value; uint256 digits; while (temp != 0) { digits++; temp /= 10; } bytes memory buffer = new bytes(digits); while (value != 0) { digits -= 1; buffer[digits] = bytes1(uint8(48 + uint256(value % 10))); value /= 10; } return string(buffer); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { if (value == 0) { return "0x00"; } uint256 temp = value; uint256 length = 0; while (temp != 0) { length++; temp >>= 8; } return toHexString(value, length); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = _HEX_SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "Strings: hex length insufficient"); return string(buffer); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation. */ function toHexString(address addr) internal pure returns (string memory) { return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol) pragma solidity ^0.8.0; import "./IERC165.sol"; /** * @dev Implementation of the {IERC165} interface. * * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check * for the additional interface id that will be supported. For example: * * ```solidity * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId); * } * ``` * * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation. */ abstract contract ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IERC165).interfaceId; } }
// SPDX-License-Identifier: LGPL-3.0-only // Created By: Art Blocks Inc. pragma solidity ^0.8.0; 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; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.13; import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.sol"; import {CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS} from "./lib/Constants.sol"; /** * @title OperatorFilterer * @notice Abstract contract whose constructor automatically registers and optionally subscribes to or copies another * registrant's entries in the OperatorFilterRegistry. * @dev This smart contract is meant to be inherited by token contracts so they can use the following: * - `onlyAllowedOperator` modifier for `transferFrom` and `safeTransferFrom` methods. * - `onlyAllowedOperatorApproval` modifier for `approve` and `setApprovalForAll` methods. * Please note that if your token contract does not provide an owner with EIP-173, it must provide * administration methods on the contract itself to interact with the registry otherwise the subscription * will be locked to the options set during construction. */ abstract contract OperatorFilterer { /// @dev Emitted when an operator is not allowed. error OperatorNotAllowed(address operator); IOperatorFilterRegistry public constant OPERATOR_FILTER_REGISTRY = IOperatorFilterRegistry(CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS); /// @dev The constructor that is called when the contract is being deployed. constructor(address subscriptionOrRegistrantToCopy, bool subscribe) { // If an inheriting token contract is deployed to a network without the registry deployed, the modifier // will not revert, but the contract will need to be registered with the registry once it is deployed in // order for the modifier to filter addresses. if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) { if (subscribe) { OPERATOR_FILTER_REGISTRY.registerAndSubscribe(address(this), subscriptionOrRegistrantToCopy); } else { if (subscriptionOrRegistrantToCopy != address(0)) { OPERATOR_FILTER_REGISTRY.registerAndCopyEntries(address(this), subscriptionOrRegistrantToCopy); } else { OPERATOR_FILTER_REGISTRY.register(address(this)); } } } } /** * @dev A helper function to check if an operator is allowed. */ modifier onlyAllowedOperator(address from) virtual { // Allow spending tokens from addresses with balance // Note that this still allows listings and marketplaces with escrow to transfer tokens if transferred // from an EOA. if (from != msg.sender) { _checkFilterOperator(msg.sender); } _; } /** * @dev A helper function to check if an operator approval is allowed. */ modifier onlyAllowedOperatorApproval(address operator) virtual { _checkFilterOperator(operator); _; } /** * @dev A helper function to check if an operator is allowed. */ function _checkFilterOperator(address operator) internal view virtual { // Check registry code length to facilitate testing in environments without a deployed registry. if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) { // under normal circumstances, this function will revert rather than return false, but inheriting contracts // may specify their own OperatorFilterRegistry implementations, which may behave differently if (!OPERATOR_FILTER_REGISTRY.isOperatorAllowed(address(this), operator)) { revert OperatorNotAllowed(operator); } } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.13; import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.sol"; import {Ownable} from "openzeppelin-contracts/access/Ownable.sol"; import {EnumerableSet} from "openzeppelin-contracts/utils/structs/EnumerableSet.sol"; import {OperatorFilterRegistryErrorsAndEvents} from "./OperatorFilterRegistryErrorsAndEvents.sol"; /** * @title OperatorFilterRegistry * @notice Borrows heavily from the QQL BlacklistOperatorFilter contract: * https://github.com/qql-art/contracts/blob/main/contracts/BlacklistOperatorFilter.sol * @notice This contracts allows tokens or token owners to register specific addresses or codeHashes that may be * * restricted according to the isOperatorAllowed function. */ contract OperatorFilterRegistry is IOperatorFilterRegistry, OperatorFilterRegistryErrorsAndEvents { using EnumerableSet for EnumerableSet.AddressSet; using EnumerableSet for EnumerableSet.Bytes32Set; /// @dev initialized accounts have a nonzero codehash (see https://eips.ethereum.org/EIPS/eip-1052) /// Note that this will also be a smart contract's codehash when making calls from its constructor. bytes32 constant EOA_CODEHASH = keccak256(""); mapping(address => EnumerableSet.AddressSet) private _filteredOperators; mapping(address => EnumerableSet.Bytes32Set) private _filteredCodeHashes; mapping(address => address) private _registrations; mapping(address => EnumerableSet.AddressSet) private _subscribers; /** * @notice Restricts method caller to the address or EIP-173 "owner()" */ modifier onlyAddressOrOwner(address addr) { if (msg.sender != addr) { try Ownable(addr).owner() returns (address owner) { if (msg.sender != owner) { revert OnlyAddressOrOwner(); } } catch (bytes memory reason) { if (reason.length == 0) { revert NotOwnable(); } else { /// @solidity memory-safe-assembly assembly { revert(add(32, reason), mload(reason)) } } } } _; } /** * @notice Returns true if operator is not filtered for a given token, either by address or codeHash. Also returns * true if supplied registrant address is not registered. * Note that this method will *revert* if an operator or its codehash is filtered with an error that is * more informational than a false boolean, so smart contracts that query this method for informational * purposes will need to wrap in a try/catch or perform a low-level staticcall in order to handle the case * that an operator is filtered. */ function isOperatorAllowed(address registrant, address operator) external view returns (bool) { address registration = _registrations[registrant]; if (registration != address(0)) { EnumerableSet.AddressSet storage filteredOperatorsRef; EnumerableSet.Bytes32Set storage filteredCodeHashesRef; filteredOperatorsRef = _filteredOperators[registration]; filteredCodeHashesRef = _filteredCodeHashes[registration]; if (filteredOperatorsRef.contains(operator)) { revert AddressFiltered(operator); } if (operator.code.length > 0) { bytes32 codeHash = operator.codehash; if (filteredCodeHashesRef.contains(codeHash)) { revert CodeHashFiltered(operator, codeHash); } } } return true; } ////////////////// // AUTH METHODS // ////////////////// /** * @notice Registers an address with the registry. May be called by address itself or by EIP-173 owner. */ function register(address registrant) external onlyAddressOrOwner(registrant) { if (_registrations[registrant] != address(0)) { revert AlreadyRegistered(); } _registrations[registrant] = registrant; emit RegistrationUpdated(registrant, true); } /** * @notice Unregisters an address with the registry and removes its subscription. May be called by address itself or by EIP-173 owner. * Note that this does not remove any filtered addresses or codeHashes. * Also note that any subscriptions to this registrant will still be active and follow the existing filtered addresses and codehashes. */ function unregister(address registrant) external onlyAddressOrOwner(registrant) { address registration = _registrations[registrant]; if (registration == address(0)) { revert NotRegistered(registrant); } if (registration != registrant) { _subscribers[registration].remove(registrant); emit SubscriptionUpdated(registrant, registration, false); } _registrations[registrant] = address(0); emit RegistrationUpdated(registrant, false); } /** * @notice Registers an address with the registry and "subscribes" to another address's filtered operators and codeHashes. */ function registerAndSubscribe(address registrant, address subscription) external onlyAddressOrOwner(registrant) { address registration = _registrations[registrant]; if (registration != address(0)) { revert AlreadyRegistered(); } if (registrant == subscription) { revert CannotSubscribeToSelf(); } address subscriptionRegistration = _registrations[subscription]; if (subscriptionRegistration == address(0)) { revert NotRegistered(subscription); } if (subscriptionRegistration != subscription) { revert CannotSubscribeToRegistrantWithSubscription(subscription); } _registrations[registrant] = subscription; _subscribers[subscription].add(registrant); emit RegistrationUpdated(registrant, true); emit SubscriptionUpdated(registrant, subscription, true); } /** * @notice Registers an address with the registry and copies the filtered operators and codeHashes from another * address without subscribing. */ function registerAndCopyEntries(address registrant, address registrantToCopy) external onlyAddressOrOwner(registrant) { if (registrantToCopy == registrant) { revert CannotCopyFromSelf(); } address registration = _registrations[registrant]; if (registration != address(0)) { revert AlreadyRegistered(); } address registrantRegistration = _registrations[registrantToCopy]; if (registrantRegistration == address(0)) { revert NotRegistered(registrantToCopy); } _registrations[registrant] = registrant; emit RegistrationUpdated(registrant, true); _copyEntries(registrant, registrantToCopy); } /** * @notice Update an operator address for a registered address - when filtered is true, the operator is filtered. */ function updateOperator(address registrant, address operator, bool filtered) external onlyAddressOrOwner(registrant) { address registration = _registrations[registrant]; if (registration == address(0)) { revert NotRegistered(registrant); } if (registration != registrant) { revert CannotUpdateWhileSubscribed(registration); } EnumerableSet.AddressSet storage filteredOperatorsRef = _filteredOperators[registrant]; if (!filtered) { bool removed = filteredOperatorsRef.remove(operator); if (!removed) { revert AddressNotFiltered(operator); } } else { bool added = filteredOperatorsRef.add(operator); if (!added) { revert AddressAlreadyFiltered(operator); } } emit OperatorUpdated(registrant, operator, filtered); } /** * @notice Update a codeHash for a registered address - when filtered is true, the codeHash is filtered. * Note that this will allow adding the bytes32(0) codehash, which could result in unexpected behavior, * since calling `isCodeHashFiltered` will return true for bytes32(0), which is the codeHash of any * un-initialized account. Since un-initialized accounts have no code, the registry will not validate * that an un-initalized account's codeHash is not filtered. By the time an account is able to * act as an operator (an account is initialized or a smart contract exclusively in the context of its * constructor), it will have a codeHash of EOA_CODEHASH, which cannot be filtered. */ function updateCodeHash(address registrant, bytes32 codeHash, bool filtered) external onlyAddressOrOwner(registrant) { if (codeHash == EOA_CODEHASH) { revert CannotFilterEOAs(); } address registration = _registrations[registrant]; if (registration == address(0)) { revert NotRegistered(registrant); } if (registration != registrant) { revert CannotUpdateWhileSubscribed(registration); } EnumerableSet.Bytes32Set storage filteredCodeHashesRef = _filteredCodeHashes[registrant]; if (!filtered) { bool removed = filteredCodeHashesRef.remove(codeHash); if (!removed) { revert CodeHashNotFiltered(codeHash); } } else { bool added = filteredCodeHashesRef.add(codeHash); if (!added) { revert CodeHashAlreadyFiltered(codeHash); } } emit CodeHashUpdated(registrant, codeHash, filtered); } /** * @notice Update multiple operators for a registered address - when filtered is true, the operators will be filtered. Reverts on duplicates. */ function updateOperators(address registrant, address[] calldata operators, bool filtered) external onlyAddressOrOwner(registrant) { address registration = _registrations[registrant]; if (registration == address(0)) { revert NotRegistered(registrant); } if (registration != registrant) { revert CannotUpdateWhileSubscribed(registration); } EnumerableSet.AddressSet storage filteredOperatorsRef = _filteredOperators[registrant]; uint256 operatorsLength = operators.length; if (!filtered) { for (uint256 i = 0; i < operatorsLength;) { address operator = operators[i]; bool removed = filteredOperatorsRef.remove(operator); if (!removed) { revert AddressNotFiltered(operator); } unchecked { ++i; } } } else { for (uint256 i = 0; i < operatorsLength;) { address operator = operators[i]; bool added = filteredOperatorsRef.add(operator); if (!added) { revert AddressAlreadyFiltered(operator); } unchecked { ++i; } } } emit OperatorsUpdated(registrant, operators, filtered); } /** * @notice Update multiple codeHashes for a registered address - when filtered is true, the codeHashes will be filtered. Reverts on duplicates. * Note that this will allow adding the bytes32(0) codehash, which could result in unexpected behavior, * since calling `isCodeHashFiltered` will return true for bytes32(0), which is the codeHash of any * un-initialized account. Since un-initialized accounts have no code, the registry will not validate * that an un-initalized account's codeHash is not filtered. By the time an account is able to * act as an operator (an account is initialized or a smart contract exclusively in the context of its * constructor), it will have a codeHash of EOA_CODEHASH, which cannot be filtered. */ function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external onlyAddressOrOwner(registrant) { address registration = _registrations[registrant]; if (registration == address(0)) { revert NotRegistered(registrant); } if (registration != registrant) { revert CannotUpdateWhileSubscribed(registration); } EnumerableSet.Bytes32Set storage filteredCodeHashesRef = _filteredCodeHashes[registrant]; uint256 codeHashesLength = codeHashes.length; if (!filtered) { for (uint256 i = 0; i < codeHashesLength;) { bytes32 codeHash = codeHashes[i]; bool removed = filteredCodeHashesRef.remove(codeHash); if (!removed) { revert CodeHashNotFiltered(codeHash); } unchecked { ++i; } } } else { for (uint256 i = 0; i < codeHashesLength;) { bytes32 codeHash = codeHashes[i]; if (codeHash == EOA_CODEHASH) { revert CannotFilterEOAs(); } bool added = filteredCodeHashesRef.add(codeHash); if (!added) { revert CodeHashAlreadyFiltered(codeHash); } unchecked { ++i; } } } emit CodeHashesUpdated(registrant, codeHashes, filtered); } /** * @notice Subscribe an address to another registrant's filtered operators and codeHashes. Will remove previous * subscription if present. * Note that accounts with subscriptions may go on to subscribe to other accounts - in this case, * subscriptions will not be forwarded. Instead the former subscription's existing entries will still be * used. */ function subscribe(address registrant, address newSubscription) external onlyAddressOrOwner(registrant) { if (registrant == newSubscription) { revert CannotSubscribeToSelf(); } if (newSubscription == address(0)) { revert CannotSubscribeToZeroAddress(); } address registration = _registrations[registrant]; if (registration == address(0)) { revert NotRegistered(registrant); } if (registration == newSubscription) { revert AlreadySubscribed(newSubscription); } address newSubscriptionRegistration = _registrations[newSubscription]; if (newSubscriptionRegistration == address(0)) { revert NotRegistered(newSubscription); } if (newSubscriptionRegistration != newSubscription) { revert CannotSubscribeToRegistrantWithSubscription(newSubscription); } if (registration != registrant) { _subscribers[registration].remove(registrant); emit SubscriptionUpdated(registrant, registration, false); } _registrations[registrant] = newSubscription; _subscribers[newSubscription].add(registrant); emit SubscriptionUpdated(registrant, newSubscription, true); } /** * @notice Unsubscribe an address from its current subscribed registrant, and optionally copy its filtered operators and codeHashes. */ function unsubscribe(address registrant, bool copyExistingEntries) external onlyAddressOrOwner(registrant) { address registration = _registrations[registrant]; if (registration == address(0)) { revert NotRegistered(registrant); } if (registration == registrant) { revert NotSubscribed(); } _subscribers[registration].remove(registrant); _registrations[registrant] = registrant; emit SubscriptionUpdated(registrant, registration, false); if (copyExistingEntries) { _copyEntries(registrant, registration); } } /** * @notice Copy filtered operators and codeHashes from a different registrantToCopy to addr. */ function copyEntriesOf(address registrant, address registrantToCopy) external onlyAddressOrOwner(registrant) { if (registrant == registrantToCopy) { revert CannotCopyFromSelf(); } address registration = _registrations[registrant]; if (registration == address(0)) { revert NotRegistered(registrant); } if (registration != registrant) { revert CannotUpdateWhileSubscribed(registration); } address registrantRegistration = _registrations[registrantToCopy]; if (registrantRegistration == address(0)) { revert NotRegistered(registrantToCopy); } _copyEntries(registrant, registrantToCopy); } /// @dev helper to copy entries from registrantToCopy to registrant and emit events function _copyEntries(address registrant, address registrantToCopy) private { EnumerableSet.AddressSet storage filteredOperatorsRef = _filteredOperators[registrantToCopy]; EnumerableSet.Bytes32Set storage filteredCodeHashesRef = _filteredCodeHashes[registrantToCopy]; uint256 filteredOperatorsLength = filteredOperatorsRef.length(); uint256 filteredCodeHashesLength = filteredCodeHashesRef.length(); for (uint256 i = 0; i < filteredOperatorsLength;) { address operator = filteredOperatorsRef.at(i); bool added = _filteredOperators[registrant].add(operator); if (added) { emit OperatorUpdated(registrant, operator, true); } unchecked { ++i; } } for (uint256 i = 0; i < filteredCodeHashesLength;) { bytes32 codehash = filteredCodeHashesRef.at(i); bool added = _filteredCodeHashes[registrant].add(codehash); if (added) { emit CodeHashUpdated(registrant, codehash, true); } unchecked { ++i; } } } ////////////////// // VIEW METHODS // ////////////////// /** * @notice Get the subscription address of a given registrant, if any. */ function subscriptionOf(address registrant) external view returns (address subscription) { subscription = _registrations[registrant]; if (subscription == address(0)) { revert NotRegistered(registrant); } else if (subscription == registrant) { subscription = address(0); } } /** * @notice Get the set of addresses subscribed to a given registrant. * Note that order is not guaranteed as updates are made. */ function subscribers(address registrant) external view returns (address[] memory) { return _subscribers[registrant].values(); } /** * @notice Get the subscriber at a given index in the set of addresses subscribed to a given registrant. * Note that order is not guaranteed as updates are made. */ function subscriberAt(address registrant, uint256 index) external view returns (address) { return _subscribers[registrant].at(index); } /** * @notice Returns true if operator is filtered by a given address or its subscription. */ function isOperatorFiltered(address registrant, address operator) external view returns (bool) { address registration = _registrations[registrant]; if (registration != registrant) { return _filteredOperators[registration].contains(operator); } return _filteredOperators[registrant].contains(operator); } /** * @notice Returns true if a codeHash is filtered by a given address or its subscription. */ function isCodeHashFiltered(address registrant, bytes32 codeHash) external view returns (bool) { address registration = _registrations[registrant]; if (registration != registrant) { return _filteredCodeHashes[registration].contains(codeHash); } return _filteredCodeHashes[registrant].contains(codeHash); } /** * @notice Returns true if the hash of an address's code is filtered by a given address or its subscription. */ function isCodeHashOfFiltered(address registrant, address operatorWithCode) external view returns (bool) { bytes32 codeHash = operatorWithCode.codehash; address registration = _registrations[registrant]; if (registration != registrant) { return _filteredCodeHashes[registration].contains(codeHash); } return _filteredCodeHashes[registrant].contains(codeHash); } /** * @notice Returns true if an address has registered */ function isRegistered(address registrant) external view returns (bool) { return _registrations[registrant] != address(0); } /** * @notice Returns a list of filtered operators for a given address or its subscription. */ function filteredOperators(address registrant) external view returns (address[] memory) { address registration = _registrations[registrant]; if (registration != registrant) { return _filteredOperators[registration].values(); } return _filteredOperators[registrant].values(); } /** * @notice Returns the set of filtered codeHashes for a given address or its subscription. * Note that order is not guaranteed as updates are made. */ function filteredCodeHashes(address registrant) external view returns (bytes32[] memory) { address registration = _registrations[registrant]; if (registration != registrant) { return _filteredCodeHashes[registration].values(); } return _filteredCodeHashes[registrant].values(); } /** * @notice Returns the filtered operator at the given index of the set of filtered operators for a given address or * its subscription. * Note that order is not guaranteed as updates are made. */ function filteredOperatorAt(address registrant, uint256 index) external view returns (address) { address registration = _registrations[registrant]; if (registration != registrant) { return _filteredOperators[registration].at(index); } return _filteredOperators[registrant].at(index); } /** * @notice Returns the filtered codeHash at the given index of the list of filtered codeHashes for a given address or * its subscription. * Note that order is not guaranteed as updates are made. */ function filteredCodeHashAt(address registrant, uint256 index) external view returns (bytes32) { address registration = _registrations[registrant]; if (registration != registrant) { return _filteredCodeHashes[registration].at(index); } return _filteredCodeHashes[registrant].at(index); } /** * @dev Convenience method to compute the code hash of an arbitrary contract */ function codeHashOf(address a) external view returns (bytes32) { return a.codehash; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.13; address constant CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS = 0x000000000000AAeB6D7670E522A718067333cd4E; address constant CANONICAL_CORI_SUBSCRIPTION = 0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6;
// SPDX-License-Identifier: MIT // Copyright 2023 PROOF Holdings Inc pragma solidity >=0.8.0 <0.9.0; import {AccessControlEnumerable} from "ethier/utils/AccessControlEnumerable.sol"; import {ReentrancyGuard} from "openzeppelin-contracts/security/ReentrancyGuard.sol"; import {ISellable} from "../interfaces/ISellable.sol"; /** * @notice A base contract for selling content via authorised sellers. */ abstract contract BaseSellable is ISellable, AccessControlEnumerable, ReentrancyGuard { /** * @notice Authorised sellers. */ bytes32 public constant AUTHORISED_SELLER_ROLE = keccak256("AUTHORISED_SELLER_ROLE"); /** * @notice A role that cannot be granted or revoked. * @dev Used to lock in members of the `AUTHORISED_SELLER_ROLE` role. */ bytes32 private constant _NOOP_ROLE = keccak256("NOOP_ROLE"); constructor() { _setRoleAdmin(AUTHORISED_SELLER_ROLE, DEFAULT_STEERING_ROLE); _setRoleAdmin(_NOOP_ROLE, _NOOP_ROLE); } /** * @notice Handles the sale of sellable content via an authorised seller. * @dev Delegates the implementation to `_handleSale`. */ function handleSale(address to, uint64 num, bytes calldata data) external payable onlyRole(AUTHORISED_SELLER_ROLE) nonReentrant { _handleSale(to, num, data); } /** * @notice Handles the sale of sellable content. */ function _handleSale(address to, uint64 num, bytes calldata data) internal virtual; /** * @notice Locks the `AUTHORISED_SELLER_ROLE` role. */ function lockSellers() external onlyRole(DEFAULT_STEERING_ROLE) { _lockSellers(); } /** * @notice Locks the `AUTHORISED_SELLER_ROLE` role. */ function _lockSellers() internal { _setRoleAdmin(AUTHORISED_SELLER_ROLE, _NOOP_ROLE); } /** * @notice Revokes approval for all sellers. */ function _revokeAllSellers() internal { uint256 num = getRoleMemberCount(AUTHORISED_SELLER_ROLE); for (uint256 i = 0; i < num; i++) { // Akin to a popFront address seller = getRoleMember(AUTHORISED_SELLER_ROLE, 0); _revokeRole(AUTHORISED_SELLER_ROLE, seller); } } }
// SPDX-License-Identifier: MIT // Copyright 2023 PROOF Holdings Inc pragma solidity >=0.8.0 <0.9.0; /** * @notice Basic interface for a contract providing sellable content. */ interface ISellable { /** * @notice Handles the sale of sellable content. * @dev This is usually only callable by Sellers. */ function handleSale(address to, uint64 num, bytes calldata data) external payable; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165 { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol) pragma solidity ^0.8.0; import "./IAccessControl.sol"; /** * @dev External interface of AccessControlEnumerable declared to support ERC165 detection. */ interface IAccessControlEnumerable is IAccessControl { /** * @dev Returns one of the accounts that have `role`. `index` must be a * value between 0 and {getRoleMemberCount}, non-inclusive. * * Role bearers are not sorted in any particular way, and their ordering may * change at any point. * * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure * you perform all queries on the same block. See the following * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post] * for more information. */ function getRoleMember(bytes32 role, uint256 index) external view returns (address); /** * @dev Returns the number of accounts that have `role`. Can be used * together with {getRoleMember} to enumerate all bearers of a role. */ function getRoleMemberCount(bytes32 role) external view returns (uint256); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (access/AccessControl.sol) pragma solidity ^0.8.0; import "./IAccessControl.sol"; import "../utils/Context.sol"; import "../utils/Strings.sol"; import "../utils/introspection/ERC165.sol"; /** * @dev Contract module that allows children to implement role-based access * control mechanisms. This is a lightweight version that doesn't allow enumerating role * members except through off-chain means by accessing the contract event logs. Some * applications may benefit from on-chain enumerability, for those cases see * {AccessControlEnumerable}. * * Roles are referred to by their `bytes32` identifier. These should be exposed * in the external API and be unique. The best way to achieve this is by * using `public constant` hash digests: * * ``` * bytes32 public constant MY_ROLE = keccak256("MY_ROLE"); * ``` * * Roles can be used to represent a set of permissions. To restrict access to a * function call, use {hasRole}: * * ``` * function foo() public { * require(hasRole(MY_ROLE, msg.sender)); * ... * } * ``` * * Roles can be granted and revoked dynamically via the {grantRole} and * {revokeRole} functions. Each role has an associated admin role, and only * accounts that have a role's admin role can call {grantRole} and {revokeRole}. * * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means * that only accounts with this role will be able to grant or revoke other * roles. More complex role relationships can be created by using * {_setRoleAdmin}. * * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to * grant and revoke this role. Extra precautions should be taken to secure * accounts that have been granted it. */ abstract contract AccessControl is Context, IAccessControl, ERC165 { struct RoleData { mapping(address => bool) members; bytes32 adminRole; } mapping(bytes32 => RoleData) private _roles; bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00; /** * @dev Modifier that checks that an account has a specific role. Reverts * with a standardized message including the required role. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ * * _Available since v4.1._ */ modifier onlyRole(bytes32 role) { _checkRole(role); _; } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) public view virtual override returns (bool) { return _roles[role].members[account]; } /** * @dev Revert with a standard message if `_msgSender()` is missing `role`. * Overriding this function changes the behavior of the {onlyRole} modifier. * * Format of the revert message is described in {_checkRole}. * * _Available since v4.6._ */ function _checkRole(bytes32 role) internal view virtual { _checkRole(role, _msgSender()); } /** * @dev Revert with a standard message if `account` is missing `role`. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ */ function _checkRole(bytes32 role, address account) internal view virtual { if (!hasRole(role, account)) { revert( string( abi.encodePacked( "AccessControl: account ", Strings.toHexString(account), " is missing role ", Strings.toHexString(uint256(role), 32) ) ) ); } } /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) { return _roles[role].adminRole; } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. * * May emit a {RoleGranted} event. */ function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _grantRole(role, account); } /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. * * May emit a {RoleRevoked} event. */ function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _revokeRole(role, account); } /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been revoked `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. * * May emit a {RoleRevoked} event. */ function renounceRole(bytes32 role, address account) public virtual override { require(account == _msgSender(), "AccessControl: can only renounce roles for self"); _revokeRole(role, account); } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. Note that unlike {grantRole}, this function doesn't perform any * checks on the calling account. * * May emit a {RoleGranted} event. * * [WARNING] * ==== * This function should only be called from the constructor when setting * up the initial roles for the system. * * Using this function in any other way is effectively circumventing the admin * system imposed by {AccessControl}. * ==== * * NOTE: This function is deprecated in favor of {_grantRole}. */ function _setupRole(bytes32 role, address account) internal virtual { _grantRole(role, account); } /** * @dev Sets `adminRole` as ``role``'s admin role. * * Emits a {RoleAdminChanged} event. */ function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual { bytes32 previousAdminRole = getRoleAdmin(role); _roles[role].adminRole = adminRole; emit RoleAdminChanged(role, previousAdminRole, adminRole); } /** * @dev Grants `role` to `account`. * * Internal function without access restriction. * * May emit a {RoleGranted} event. */ function _grantRole(bytes32 role, address account) internal virtual { if (!hasRole(role, account)) { _roles[role].members[account] = true; emit RoleGranted(role, account, _msgSender()); } } /** * @dev Revokes `role` from `account`. * * Internal function without access restriction. * * May emit a {RoleRevoked} event. */ function _revokeRole(bytes32 role, address account) internal virtual { if (hasRole(role, account)) { _roles[role].members[account] = false; emit RoleRevoked(role, account, _msgSender()); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/structs/EnumerableSet.sol) // This file was procedurally generated from scripts/generate/templates/EnumerableSet.js. pragma solidity ^0.8.0; /** * @dev Library for managing * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive * types. * * Sets have the following properties: * * - Elements are added, removed, and checked for existence in constant time * (O(1)). * - Elements are enumerated in O(n). No guarantees are made on the ordering. * * ``` * contract Example { * // Add the library methods * using EnumerableSet for EnumerableSet.AddressSet; * * // Declare a set state variable * EnumerableSet.AddressSet private mySet; * } * ``` * * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`) * and `uint256` (`UintSet`) are supported. * * [WARNING] * ==== * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure * unusable. * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info. * * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an * array of EnumerableSet. * ==== */ library EnumerableSet { // To implement this library for multiple types with as little code // repetition as possible, we write it in terms of a generic Set type with // bytes32 values. // The Set implementation uses private functions, and user-facing // implementations (such as AddressSet) are just wrappers around the // underlying Set. // This means that we can only create new EnumerableSets for types that fit // in bytes32. struct Set { // Storage of set values bytes32[] _values; // Position of the value in the `values` array, plus 1 because index 0 // means a value is not in the set. mapping(bytes32 => uint256) _indexes; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function _add(Set storage set, bytes32 value) private returns (bool) { if (!_contains(set, value)) { set._values.push(value); // The value is stored at length-1, but we add 1 to all indexes // and use 0 as a sentinel value set._indexes[value] = set._values.length; return true; } else { return false; } } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function _remove(Set storage set, bytes32 value) private returns (bool) { // We read and store the value's index to prevent multiple reads from the same storage slot uint256 valueIndex = set._indexes[value]; if (valueIndex != 0) { // Equivalent to contains(set, value) // To delete an element from the _values array in O(1), we swap the element to delete with the last one in // the array, and then remove the last element (sometimes called as 'swap and pop'). // This modifies the order of the array, as noted in {at}. uint256 toDeleteIndex = valueIndex - 1; uint256 lastIndex = set._values.length - 1; if (lastIndex != toDeleteIndex) { bytes32 lastValue = set._values[lastIndex]; // Move the last value to the index where the value to delete is set._values[toDeleteIndex] = lastValue; // Update the index for the moved value set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex } // Delete the slot where the moved value was stored set._values.pop(); // Delete the index for the deleted slot delete set._indexes[value]; return true; } else { return false; } } /** * @dev Returns true if the value is in the set. O(1). */ function _contains(Set storage set, bytes32 value) private view returns (bool) { return set._indexes[value] != 0; } /** * @dev Returns the number of values on the set. O(1). */ function _length(Set storage set) private view returns (uint256) { return set._values.length; } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function _at(Set storage set, uint256 index) private view returns (bytes32) { return set._values[index]; } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function _values(Set storage set) private view returns (bytes32[] memory) { return set._values; } // Bytes32Set struct Bytes32Set { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _add(set._inner, value); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _remove(set._inner, value); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) { return _contains(set._inner, value); } /** * @dev Returns the number of values in the set. O(1). */ function length(Bytes32Set storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) { return _at(set._inner, index); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(Bytes32Set storage set) internal view returns (bytes32[] memory) { bytes32[] memory store = _values(set._inner); bytes32[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } // AddressSet struct AddressSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(AddressSet storage set, address value) internal returns (bool) { return _add(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(AddressSet storage set, address value) internal returns (bool) { return _remove(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(AddressSet storage set, address value) internal view returns (bool) { return _contains(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns the number of values in the set. O(1). */ function length(AddressSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(AddressSet storage set, uint256 index) internal view returns (address) { return address(uint160(uint256(_at(set._inner, index)))); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(AddressSet storage set) internal view returns (address[] memory) { bytes32[] memory store = _values(set._inner); address[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } // UintSet struct UintSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(UintSet storage set, uint256 value) internal returns (bool) { return _add(set._inner, bytes32(value)); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(UintSet storage set, uint256 value) internal returns (bool) { return _remove(set._inner, bytes32(value)); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(UintSet storage set, uint256 value) internal view returns (bool) { return _contains(set._inner, bytes32(value)); } /** * @dev Returns the number of values in the set. O(1). */ function length(UintSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(UintSet storage set, uint256 index) internal view returns (uint256) { return uint256(_at(set._inner, index)); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(UintSet storage set) internal view returns (uint256[] memory) { bytes32[] memory store = _values(set._inner); uint256[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Context.sol) pragma solidity ^0.8.0; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165 { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.13; interface IOperatorFilterRegistry { /** * @notice Returns true if operator is not filtered for a given token, either by address or codeHash. Also returns * true if supplied registrant address is not registered. */ function isOperatorAllowed(address registrant, address operator) external view returns (bool); /** * @notice Registers an address with the registry. May be called by address itself or by EIP-173 owner. */ function register(address registrant) external; /** * @notice Registers an address with the registry and "subscribes" to another address's filtered operators and codeHashes. */ function registerAndSubscribe(address registrant, address subscription) external; /** * @notice Registers an address with the registry and copies the filtered operators and codeHashes from another * address without subscribing. */ function registerAndCopyEntries(address registrant, address registrantToCopy) external; /** * @notice Unregisters an address with the registry and removes its subscription. May be called by address itself or by EIP-173 owner. * Note that this does not remove any filtered addresses or codeHashes. * Also note that any subscriptions to this registrant will still be active and follow the existing filtered addresses and codehashes. */ function unregister(address addr) external; /** * @notice Update an operator address for a registered address - when filtered is true, the operator is filtered. */ function updateOperator(address registrant, address operator, bool filtered) external; /** * @notice Update multiple operators for a registered address - when filtered is true, the operators will be filtered. Reverts on duplicates. */ function updateOperators(address registrant, address[] calldata operators, bool filtered) external; /** * @notice Update a codeHash for a registered address - when filtered is true, the codeHash is filtered. */ function updateCodeHash(address registrant, bytes32 codehash, bool filtered) external; /** * @notice Update multiple codeHashes for a registered address - when filtered is true, the codeHashes will be filtered. Reverts on duplicates. */ function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external; /** * @notice Subscribe an address to another registrant's filtered operators and codeHashes. Will remove previous * subscription if present. * Note that accounts with subscriptions may go on to subscribe to other accounts - in this case, * subscriptions will not be forwarded. Instead the former subscription's existing entries will still be * used. */ function subscribe(address registrant, address registrantToSubscribe) external; /** * @notice Unsubscribe an address from its current subscribed registrant, and optionally copy its filtered operators and codeHashes. */ function unsubscribe(address registrant, bool copyExistingEntries) external; /** * @notice Get the subscription address of a given registrant, if any. */ function subscriptionOf(address addr) external returns (address registrant); /** * @notice Get the set of addresses subscribed to a given registrant. * Note that order is not guaranteed as updates are made. */ function subscribers(address registrant) external returns (address[] memory); /** * @notice Get the subscriber at a given index in the set of addresses subscribed to a given registrant. * Note that order is not guaranteed as updates are made. */ function subscriberAt(address registrant, uint256 index) external returns (address); /** * @notice Copy filtered operators and codeHashes from a different registrantToCopy to addr. */ function copyEntriesOf(address registrant, address registrantToCopy) external; /** * @notice Returns true if operator is filtered by a given address or its subscription. */ function isOperatorFiltered(address registrant, address operator) external returns (bool); /** * @notice Returns true if the hash of an address's code is filtered by a given address or its subscription. */ function isCodeHashOfFiltered(address registrant, address operatorWithCode) external returns (bool); /** * @notice Returns true if a codeHash is filtered by a given address or its subscription. */ function isCodeHashFiltered(address registrant, bytes32 codeHash) external returns (bool); /** * @notice Returns a list of filtered operators for a given address or its subscription. */ function filteredOperators(address addr) external returns (address[] memory); /** * @notice Returns the set of filtered codeHashes for a given address or its subscription. * Note that order is not guaranteed as updates are made. */ function filteredCodeHashes(address addr) external returns (bytes32[] memory); /** * @notice Returns the filtered operator at the given index of the set of filtered operators for a given address or * its subscription. * Note that order is not guaranteed as updates are made. */ function filteredOperatorAt(address registrant, uint256 index) external returns (address); /** * @notice Returns the filtered codeHash at the given index of the list of filtered codeHashes for a given address or * its subscription. * Note that order is not guaranteed as updates are made. */ function filteredCodeHashAt(address registrant, uint256 index) external returns (bytes32); /** * @notice Returns true if an address has registered */ function isRegistered(address addr) external returns (bool); /** * @dev Convenience method to compute the code hash of an arbitrary contract */ function codeHashOf(address addr) external returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol) pragma solidity ^0.8.0; import "../utils/Context.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract Ownable is Context { address private _owner; event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the deployer as the initial owner. */ constructor() { _transferOwnership(_msgSender()); } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _checkOwner(); _; } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if the sender is not the owner. */ function _checkOwner() internal view virtual { require(owner() == _msgSender(), "Ownable: caller is not the owner"); } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions anymore. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby removing any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.13; contract OperatorFilterRegistryErrorsAndEvents { /// @notice Emitted when trying to register an address that has no code. error CannotFilterEOAs(); /// @notice Emitted when trying to add an address that is already filtered. error AddressAlreadyFiltered(address operator); /// @notice Emitted when trying to remove an address that is not filtered. error AddressNotFiltered(address operator); /// @notice Emitted when trying to add a codehash that is already filtered. error CodeHashAlreadyFiltered(bytes32 codeHash); /// @notice Emitted when trying to remove a codehash that is not filtered. error CodeHashNotFiltered(bytes32 codeHash); /// @notice Emitted when the caller is not the address or EIP-173 "owner()" error OnlyAddressOrOwner(); /// @notice Emitted when the registrant is not registered. error NotRegistered(address registrant); /// @notice Emitted when the registrant is already registered. error AlreadyRegistered(); /// @notice Emitted when the registrant is already subscribed. error AlreadySubscribed(address subscription); /// @notice Emitted when the registrant is not subscribed. error NotSubscribed(); /// @notice Emitted when trying to update a registration where the registrant is already subscribed. error CannotUpdateWhileSubscribed(address subscription); /// @notice Emitted when trying to subscribe to itself. error CannotSubscribeToSelf(); /// @notice Emitted when trying to subscribe to the zero address. error CannotSubscribeToZeroAddress(); /// @notice Emitted when trying to register and the contract is not ownable (EIP-173 "owner()") error NotOwnable(); /// @notice Emitted when an address is filtered. error AddressFiltered(address filtered); /// @notice Emitted when a codeHash is filtered. error CodeHashFiltered(address account, bytes32 codeHash); /// @notice Emited when trying to register to a registrant with a subscription. error CannotSubscribeToRegistrantWithSubscription(address registrant); /// @notice Emitted when trying to copy a registration from itself. error CannotCopyFromSelf(); /// @notice Emitted when a registration is updated. event RegistrationUpdated(address indexed registrant, bool indexed registered); /// @notice Emitted when an operator is updated. event OperatorUpdated(address indexed registrant, address indexed operator, bool indexed filtered); /// @notice Emitted when multiple operators are updated. event OperatorsUpdated(address indexed registrant, address[] operators, bool indexed filtered); /// @notice Emitted when a codeHash is updated. event CodeHashUpdated(address indexed registrant, bytes32 indexed codeHash, bool indexed filtered); /// @notice Emitted when multiple codeHashes are updated. event CodeHashesUpdated(address indexed registrant, bytes32[] codeHashes, bool indexed filtered); /// @notice Emitted when a subscription is updated. event SubscriptionUpdated(address indexed registrant, address indexed subscription, bool indexed subscribed); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (security/ReentrancyGuard.sol) pragma solidity ^0.8.0; /** * @dev Contract module that helps prevent reentrant calls to a function. * * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier * available, which can be applied to functions to make sure there are no nested * (reentrant) calls to them. * * Note that because there is a single `nonReentrant` guard, functions marked as * `nonReentrant` may not call one another. This can be worked around by making * those functions `private`, and then adding `external` `nonReentrant` entry * points to them. * * TIP: If you would like to learn more about reentrancy and alternative ways * to protect against it, check out our blog post * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul]. */ abstract contract ReentrancyGuard { // Booleans are more expensive than uint256 or any type that takes up a full // word because each write operation emits an extra SLOAD to first read the // slot's contents, replace the bits taken up by the boolean, and then write // back. This is the compiler's defense against contract upgrades and // pointer aliasing, and it cannot be disabled. // The values being non-zero value makes deployment a bit more expensive, // but in exchange the refund on every call to nonReentrant will be lower in // amount. Since refunds are capped to a percentage of the total // transaction's gas, it is best to keep them low in cases like this one, to // increase the likelihood of the full refund coming into effect. uint256 private constant _NOT_ENTERED = 1; uint256 private constant _ENTERED = 2; uint256 private _status; constructor() { _status = _NOT_ENTERED; } /** * @dev Prevents a contract from calling itself, directly or indirectly. * Calling a `nonReentrant` function from another `nonReentrant` * function is not supported. It is possible to prevent this from happening * by making the `nonReentrant` function external, and making it call a * `private` function that does the actual work. */ modifier nonReentrant() { _nonReentrantBefore(); _; _nonReentrantAfter(); } function _nonReentrantBefore() private { // On the first call to nonReentrant, _status will be _NOT_ENTERED require(_status != _ENTERED, "ReentrancyGuard: reentrant call"); // Any calls to nonReentrant after this point will fail _status = _ENTERED; } function _nonReentrantAfter() private { // By storing the original value once again, a refund is triggered (see // https://eips.ethereum.org/EIPS/eip-2200) _status = _NOT_ENTERED; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol) pragma solidity ^0.8.0; /** * @dev External interface of AccessControl declared to support ERC165 detection. */ interface IAccessControl { /** * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole` * * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite * {RoleAdminChanged} not being emitted signaling this. * * _Available since v3.1._ */ event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole); /** * @dev Emitted when `account` is granted `role`. * * `sender` is the account that originated the contract call, an admin role * bearer except when using {AccessControl-_setupRole}. */ event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Emitted when `account` is revoked `role`. * * `sender` is the account that originated the contract call: * - if using `revokeRole`, it is the admin role bearer * - if using `renounceRole`, it is the role bearer (i.e. `account`) */ event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) external view returns (bool); /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {AccessControl-_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) external view returns (bytes32); /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function grantRole(bytes32 role, address account) external; /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function revokeRole(bytes32 role, address account) external; /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been granted `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. */ function renounceRole(bytes32 role, address account) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol) pragma solidity ^0.8.0; import "./math/Math.sol"; /** * @dev String operations. */ library Strings { bytes16 private constant _SYMBOLS = "0123456789abcdef"; uint8 private constant _ADDRESS_LENGTH = 20; /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { unchecked { uint256 length = Math.log10(value) + 1; string memory buffer = new string(length); uint256 ptr; /// @solidity memory-safe-assembly assembly { ptr := add(buffer, add(32, length)) } while (true) { ptr--; /// @solidity memory-safe-assembly assembly { mstore8(ptr, byte(mod(value, 10), _SYMBOLS)) } value /= 10; if (value == 0) break; } return buffer; } } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { unchecked { return toHexString(value, Math.log256(value) + 1); } } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = _SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "Strings: hex length insufficient"); return string(buffer); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation. */ function toHexString(address addr) internal pure returns (string memory) { return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol) pragma solidity ^0.8.0; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { enum Rounding { Down, // Toward negative infinity Up, // Toward infinity Zero // Toward zero } /** * @dev Returns the largest of two numbers. */ function max(uint256 a, uint256 b) internal pure returns (uint256) { return a > b ? a : b; } /** * @dev Returns the smallest of two numbers. */ function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /** * @dev Returns the average of two numbers. The result is rounded towards * zero. */ function average(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b) / 2 can overflow. return (a & b) + (a ^ b) / 2; } /** * @dev Returns the ceiling of the division of two numbers. * * This differs from standard division with `/` in that it rounds up instead * of rounding down. */ function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b - 1) / b can overflow on addition, so we distribute. return a == 0 ? 0 : (a - 1) / b + 1; } /** * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0 * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) * with further edits by Uniswap Labs also under MIT license. */ function mulDiv( uint256 x, uint256 y, uint256 denominator ) internal pure returns (uint256 result) { unchecked { // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256 // variables such that product = prod1 * 2^256 + prod0. uint256 prod0; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod0 := mul(x, y) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { return prod0 / denominator; } // Make sure the result is less than 2^256. Also prevents denominator == 0. require(denominator > prod1); /////////////////////////////////////////////// // 512 by 256 division. /////////////////////////////////////////////// // Make division exact by subtracting the remainder from [prod1 prod0]. uint256 remainder; assembly { // Compute remainder using mulmod. remainder := mulmod(x, y, denominator) // Subtract 256 bit number from 512 bit number. prod1 := sub(prod1, gt(remainder, prod0)) prod0 := sub(prod0, remainder) } // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1. // See https://cs.stackexchange.com/q/138556/92363. // Does not overflow because the denominator cannot be zero at this stage in the function. uint256 twos = denominator & (~denominator + 1); assembly { // Divide denominator by twos. denominator := div(denominator, twos) // Divide [prod1 prod0] by twos. prod0 := div(prod0, twos) // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one. twos := add(div(sub(0, twos), twos), 1) } // Shift in bits from prod1 into prod0. prod0 |= prod1 * twos; // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for // four bits. That is, denominator * inv = 1 mod 2^4. uint256 inverse = (3 * denominator) ^ 2; // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works // in modular arithmetic, doubling the correct bits in each step. inverse *= 2 - denominator * inverse; // inverse mod 2^8 inverse *= 2 - denominator * inverse; // inverse mod 2^16 inverse *= 2 - denominator * inverse; // inverse mod 2^32 inverse *= 2 - denominator * inverse; // inverse mod 2^64 inverse *= 2 - denominator * inverse; // inverse mod 2^128 inverse *= 2 - denominator * inverse; // inverse mod 2^256 // Because the division is now exact we can divide by multiplying with the modular inverse of denominator. // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1 // is no longer required. result = prod0 * inverse; return result; } } /** * @notice Calculates x * y / denominator with full precision, following the selected rounding direction. */ function mulDiv( uint256 x, uint256 y, uint256 denominator, Rounding rounding ) internal pure returns (uint256) { uint256 result = mulDiv(x, y, denominator); if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) { result += 1; } return result; } /** * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down. * * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11). */ function sqrt(uint256 a) internal pure returns (uint256) { if (a == 0) { return 0; } // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target. // // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`. // // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)` // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))` // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)` // // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit. uint256 result = 1 << (log2(a) >> 1); // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128, // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision // into the expected uint128 result. unchecked { result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; return min(result, a / result); } } /** * @notice Calculates sqrt(a), following the selected rounding direction. */ function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = sqrt(a); return result + (rounding == Rounding.Up && result * result < a ? 1 : 0); } } /** * @dev Return the log in base 2, rounded down, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 128; } if (value >> 64 > 0) { value >>= 64; result += 64; } if (value >> 32 > 0) { value >>= 32; result += 32; } if (value >> 16 > 0) { value >>= 16; result += 16; } if (value >> 8 > 0) { value >>= 8; result += 8; } if (value >> 4 > 0) { value >>= 4; result += 4; } if (value >> 2 > 0) { value >>= 2; result += 2; } if (value >> 1 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 2, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log2(value); return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0); } } /** * @dev Return the log in base 10, rounded down, of a positive value. * Returns 0 if given 0. */ function log10(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >= 10**64) { value /= 10**64; result += 64; } if (value >= 10**32) { value /= 10**32; result += 32; } if (value >= 10**16) { value /= 10**16; result += 16; } if (value >= 10**8) { value /= 10**8; result += 8; } if (value >= 10**4) { value /= 10**4; result += 4; } if (value >= 10**2) { value /= 10**2; result += 2; } if (value >= 10**1) { result += 1; } } return result; } /** * @dev Return the log in base 10, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log10(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log10(value); return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0); } } /** * @dev Return the log in base 256, rounded down, of a positive value. * Returns 0 if given 0. * * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string. */ function log256(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 16; } if (value >> 64 > 0) { value >>= 64; result += 8; } if (value >> 32 > 0) { value >>= 32; result += 4; } if (value >> 16 > 0) { value >>= 16; result += 2; } if (value >> 8 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 10, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log256(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log256(value); return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0); } } }
{ "remappings": [ "solidifylabs/presets/=/home/dave/solidifylabs/solidifylabs/contracts/presets/src/", "solidifylabs/artblocks/=/home/dave/solidifylabs/solidifylabs/contracts/artblocks/src/", "artblocks-contracts/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/artblocks-contracts_7f0af677/packages/contracts/contracts/", "artblocks-contracts_root/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/artblocks-contracts_7f0af677/", "openzeppelin-contracts-4-7-0/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/openzeppelin-contracts_4-7-0_exact_remap/contracts/", "openzeppelin-contracts_root-4-7-0/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/openzeppelin-contracts_4-7-0_exact_remap/", "@openzeppelin-4-7-0/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/openzeppelin-contracts_4-7-0_exact_remap/", "@openzeppelin-4.7/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/openzeppelin-contracts_4-7-0_exact_remap/", "solidifylabs/ethier/=/home/dave/solidifylabs/solidifylabs/contracts/ethier/src/", "ERC721A/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/ERC721A_4-2-3/contracts/", "ERC721A_root/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/ERC721A_4-2-3/", "erc721a/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/ERC721A_4-2-3/", "ethier/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/ethier_0-55-0/contracts/", "ethier_root/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/ethier_0-55-0/", "@divergencetech/ethier/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/ethier_0-55-0/", "openzeppelin-contracts/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/openzeppelin-contracts_4-8-1/contracts/", "openzeppelin-contracts_root/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/openzeppelin-contracts_4-8-1/", "@openzeppelin/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/openzeppelin-contracts_4-8-1/", "operator-filter-registry/src/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/operator-filter-registry_1-4-1/src/", "operator-filter-registry_root/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/operator-filter-registry_1-4-1/", "solidifylabs/redemption/=/home/dave/solidifylabs/solidifylabs/contracts/redemption/src/", "solidifylabs/sellers/=/home/dave/solidifylabs/solidifylabs/contracts/sellers/src/", "delegation-registry/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/delegation-registry_40d367d7/src/", "delegation-registry_root/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/delegation-registry_40d367d7/", "solidifylabs/artblocks_test/=/home/dave/solidifylabs/solidifylabs/contracts/artblocks/test/", "solidifylabs/constants/=/home/dave/solidifylabs/solidifylabs/contracts/constants/src/", "ds-test/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/ds-test_013e6c64/src/", "ds-test_root/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/ds-test_013e6c64/", "forge-std/=/home/dave/.cache/bazel/_bazel_dave/1a5ef124e5847560f6bb614f5401924c/external/forge-std_1-7-3/src/" ], "optimizer": { "enabled": true, "runs": 9999 }, "metadata": { "useLiteralContent": false, "bytecodeHash": "ipfs", "appendCBOR": true }, "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } }, "evmVersion": "paris", "libraries": {} }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[{"components":[{"internalType":"address","name":"admin","type":"address"},{"internalType":"address","name":"steerer","type":"address"},{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"baseURI","type":"string"},{"internalType":"address payable","name":"royaltyReciever","type":"address"},{"internalType":"uint96","name":"royaltyBasisPoints","type":"uint96"}],"internalType":"struct ProjectPoolSellable.Init","name":"init","type":"tuple"},{"internalType":"contract GenArt721CoreV3_Engine_Flex_PROOF","name":"flex_","type":"address"},{"internalType":"contract MinterFilterV2","name":"filter_","type":"address"},{"internalType":"address payable","name":"primaryReceiver_","type":"address"},{"internalType":"uint256","name":"project13ArtblocksProjectId","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[{"internalType":"uint128","name":"projectId","type":"uint128"}],"name":"InvalidProject","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"OperatorNotAllowed","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[{"internalType":"uint128","name":"projectId","type":"uint128"}],"name":"ProjectExhausted","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_toTokenId","type":"uint256"}],"name":"BatchMetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"toTokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"ConsecutiveTransfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"MetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"inputs":[],"name":"AUTHORISED_SELLER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_STEERING_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"OPERATOR_FILTER_REGISTRY","outputs":[{"internalType":"contract IOperatorFilterRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint128","name":"projectId","type":"uint128"}],"name":"artblocksProjectId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseTokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes","name":"cdata","type":"bytes"}],"name":"callOperatorFilterRegistry","outputs":[{"internalType":"bytes","name":"","type":"bytes"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"emitMetadataUpdateForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"flex","outputs":[{"internalType":"contract GenArt721CoreV3_Engine_Flex_PROOF","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint64","name":"num","type":"uint64"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"handleSale","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint128","name":"projectId","type":"uint128"}],"name":"isLongformProject","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lockSellers","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint128","name":"projectId","type":"uint128"}],"name":"maxNumPerProject","outputs":[{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"minterFilter","outputs":[{"internalType":"contract MinterFilterV2","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"minterFilterAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"minterType","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"numProjects","outputs":[{"internalType":"uint128","name":"","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint128","name":"projectId","type":"uint128"}],"name":"numPurchasedPerProject","outputs":[{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"numPurchasedPerProject","outputs":[{"internalType":"uint64[]","name":"","type":"uint64[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"primaryReceiver","outputs":[{"internalType":"address payable","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"baseTokenURI_","type":"string"}],"name":"setBaseTokenURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"basisPoints","type":"uint96"}],"name":"setDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address payable","name":"newPrimaryReceiver","type":"address"}],"name":"setPrimaryReceiver","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint128","name":"projectId","type":"uint128"}],"name":"tokenIdsByProjectId","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenInfo","outputs":[{"components":[{"internalType":"uint128","name":"projectId","type":"uint128"},{"internalType":"uint64","name":"edition","type":"uint64"},{"internalType":"bytes8","name":"extra","type":"bytes8"}],"internalType":"struct TokenInfoManager.TokenInfo","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"tokenInfos","outputs":[{"components":[{"internalType":"uint128","name":"projectId","type":"uint128"},{"internalType":"uint64","name":"edition","type":"uint64"},{"internalType":"bytes8","name":"extra","type":"bytes8"}],"internalType":"struct TokenInfoManager.TokenInfo[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"}]
Contract Creation Code
60e06040523480156200001157600080fd5b5060405162004f5238038062004f5283398101604081905262000034916200078a565b84848482828162000044620002d9565b6001826080015183600001518460200151856040015186606001518760a001518860c00151838381600290816200007c919062000969565b5060036200008b828262000969565b506000805550506001600a55620000d27fe0fb75b40f2731fce9fd08fd8e51c7db44b9ffb2e43369a2734fc1a121a6b30760008051602062004f32833981519152620003b1565b620000fe7fd83ac62169e315c6fc3ecdb2c5b6ae75284053b2c2f2fb9fc715ba380283e94280620003b1565b600b805460ff19169055620001148282620003fc565b6200012160008762000501565b6200013c60008051602062004f328339815191528662000501565b50505050505062000153816200052c60201b60201c565b506daaeb6d7670e522a718067333cd4e3b1562000299578015620001e757604051633e9f1edf60e11b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e90637d3e3dbe906044015b600060405180830381600087803b158015620001c857600080fd5b505af1158015620001dd573d6000803e3d6000fd5b5050505062000299565b6001600160a01b03821615620002385760405163a0af290360e01b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e9063a0af290390604401620001ad565b604051632210724360e11b81523060048201526daaeb6d7670e522a718067333cd4e90634420e48690602401600060405180830381600087803b1580156200027f57600080fd5b505af115801562000294573d6000803e3d6000fd5b505050505b5050506001600160a01b0390811660805291821660a05250601180546001600160a01b03191695909116949094179093555060c0525062000a6092505050565b60006daaeb6d7670e522a718067333cd4e3b1580159062000379575060405163c3c5a54760e01b8152739dc5ee2d52d014f8b81d662fa8f4ca525f27cd6b60048201526daaeb6d7670e522a718067333cd4e9063c3c5a54790602401602060405180830381865afa15801562000353573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000379919062000a35565b15620003985750739dc5ee2d52d014f8b81d662fa8f4ca525f27cd6b90565b50733cc6cdda760b79bafa08df41ecfa224f810dceb690565b600082815260086020526040808220600101805490849055905190918391839186917fbd79b86ffe0ab8e8776151514217cd7cacd52c909f66475c3af44e129f0b00ff9190a4505050565b6127106001600160601b0382161115620004705760405162461bcd60e51b815260206004820152602a60248201527f455243323938313a20726f79616c7479206665652077696c6c206578636565646044820152692073616c65507269636560b01b60648201526084015b60405180910390fd5b6001600160a01b038216620004c85760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c696420726563656976657200000000000000604482015260640162000467565b604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600c55565b6200050d82826200053e565b6000828152600960205260409020620005279082620005e2565b505050565b600e6200053a828262000969565b5050565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff166200053a5760008281526008602090815260408083206001600160a01b03851684529091529020805460ff191660011790556200059e3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000620005f9836001600160a01b03841662000602565b90505b92915050565b60008181526001830160205260408120546200064b57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155620005fc565b506000620005fc565b634e487b7160e01b600052604160045260246000fd5b60405160e081016001600160401b03811182821017156200068f576200068f62000654565b60405290565b604051601f8201601f191681016001600160401b0381118282101715620006c057620006c062000654565b604052919050565b80516001600160a01b0381168114620006e057600080fd5b919050565b600082601f830112620006f757600080fd5b81516001600160401b0381111562000713576200071362000654565b602062000729601f8301601f1916820162000695565b82815285828487010111156200073e57600080fd5b60005b838110156200075e57858101830151828201840152820162000741565b506000928101909101919091529392505050565b80516001600160601b0381168114620006e057600080fd5b600080600080600060a08688031215620007a357600080fd5b85516001600160401b0380821115620007bb57600080fd5b9087019060e0828a031215620007d057600080fd5b620007da6200066a565b620007e583620006c8565b8152620007f560208401620006c8565b60208201526040830151828111156200080d57600080fd5b6200081b8b828601620006e5565b6040830152506060830151828111156200083457600080fd5b620008428b828601620006e5565b6060830152506080830151828111156200085b57600080fd5b620008698b828601620006e5565b6080830152506200087d60a08401620006c8565b60a08201526200089060c0840162000772565b60c08201529650620008a891505060208701620006c8565b9350620008b860408701620006c8565b9250620008c860608701620006c8565b9150608086015190509295509295909350565b600181811c90821680620008f057607f821691505b6020821081036200091157634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156200052757600081815260208120601f850160051c81016020861015620009405750805b601f850160051c820191505b8181101562000961578281556001016200094c565b505050505050565b81516001600160401b0381111562000985576200098562000654565b6200099d81620009968454620008db565b8462000917565b602080601f831160018114620009d55760008415620009bc5750858301515b600019600386901b1c1916600185901b17855562000961565b600085815260208120601f198616915b8281101562000a0657888601518255948401946001909101908401620009e5565b508582101562000a255787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b60006020828403121562000a4857600080fd5b8151801515811462000a5957600080fd5b9392505050565b60805160a05160c05161448662000aac6000396000611fdf0152600081816103fc01528181610a6601526135e00152600081816106b70152818161168d01526135b001526144866000f3fe6080604052600436106103345760003560e01c80635c975abb116101b0578063a217fddf116100ec578063d547741f11610095578063e985e9c51161006f578063e985e9c514610a8a578063e9d1e8ac14610ad3578063ec490d5914610ae8578063edcddc6714610b0857600080fd5b8063d547741f14610a22578063d547cfb714610a42578063dd85582f14610a5757600080fd5b8063c87b56dd116100c6578063c87b56dd14610907578063ca15c87314610927578063cc33c8751461094757600080fd5b8063a217fddf146108bf578063a22cb465146108d4578063b88d4fde146108f457600080fd5b80637d49ceb911610159578063899308a811610133578063899308a8146108245780639010d07c1461084457806391d148541461086457806395d89b41146108aa57600080fd5b80637d49ceb9146107da5780638222b7d7146107fa5780638456cb591461080f57600080fd5b80636d147a6d1161018a5780636d147a6d1461076d5780636f267c371461079a57806370a08231146107ba57600080fd5b80635c975abb1461070857806361d3eb35146107205780636352211e1461074d57600080fd5b8063248a9ca31161027f5780633dcc23a01161022857806342842e0e1161020257806342842e0e1461069257806351b1dbef146106a55780635a067baa146106d95780635ada5c55146106f557600080fd5b80633dcc23a01461063b5780633f4ba83a1461065b57806341f434341461067057600080fd5b806330176e131161025957806330176e13146105c757806331c23d20146105e757806336568abe1461061b57600080fd5b8063248a9ca3146105385780632a55205a146105685780632f2ff15d146105a757600080fd5b80630dc3b909116102e15780631d23354a116102bb5780631d23354a146104ee5780631db721851461050357806323b872dd1461052557600080fd5b80630dc3b9091461043157806310a2c73d1461047357806318160ddd146104d557600080fd5b8063081812fc11610312578063081812fc146103b257806308d94188146103ea578063095ea7b31461041e57600080fd5b806301ffc9a71461033957806304634d8d1461036e57806306fdde0314610390575b600080fd5b34801561034557600080fd5b506103596103543660046137b7565b610b28565b60405190151581526020015b60405180910390f35b34801561037a57600080fd5b5061038e6103893660046137e9565b610b39565b005b34801561039c57600080fd5b506103a5610b72565b6040516103659190613883565b3480156103be57600080fd5b506103d26103cd366004613896565b610c04565b6040516001600160a01b039091168152602001610365565b3480156103f657600080fd5b506103d27f000000000000000000000000000000000000000000000000000000000000000081565b61038e61042c3660046138af565b610c61565b34801561043d57600080fd5b506104657fe0fb75b40f2731fce9fd08fd8e51c7db44b9ffb2e43369a2734fc1a121a6b30781565b604051908152602001610365565b34801561047f57600080fd5b506104bc61048e3660046138f9565b6fffffffffffffffffffffffffffffffff1660009081526010602052604090205467ffffffffffffffff1690565b60405167ffffffffffffffff9091168152602001610365565b3480156104e157600080fd5b5060015460005403610465565b3480156104fa57600080fd5b5061038e610c87565b34801561050f57600080fd5b50610518610cbc565b6040516103659190613916565b61038e610533366004613964565b610d97565b34801561054457600080fd5b50610465610553366004613896565b60009081526008602052604090206001015490565b34801561057457600080fd5b506105886105833660046139a5565b610dbb565b604080516001600160a01b039093168352602083019190915201610365565b3480156105b357600080fd5b5061038e6105c23660046139c7565b610e9a565b3480156105d357600080fd5b5061038e6105e2366004613ab2565b610ebf565b3480156105f357600080fd5b506104657f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf7681565b34801561062757600080fd5b5061038e6106363660046139c7565b610ef2565b34801561064757600080fd5b506103a5610656366004613b3d565b610f7f565b34801561066757600080fd5b5061038e611003565b34801561067c57600080fd5b506103d26daaeb6d7670e522a718067333cd4e81565b61038e6106a0366004613964565b611035565b3480156106b157600080fd5b506103d27f000000000000000000000000000000000000000000000000000000000000000081565b3480156106e557600080fd5b5060405160128152602001610365565b61038e610703366004613b7f565b61105e565b34801561071457600080fd5b50600b5460ff16610359565b34801561072c57600080fd5b5061074061073b3660046138f9565b6110ad565b6040516103659190613bed565b34801561075957600080fd5b506103d2610768366004613896565b611276565b34801561077957600080fd5b5061078d610788366004613c25565b611281565b6040516103659190613c9a565b3480156107a657600080fd5b5061038e6107b5366004613d2e565b6113fd565b3480156107c657600080fd5b506104656107d5366004613d2e565b611462565b3480156107e657600080fd5b506104656107f53660046138f9565b6114ca565b34801561080657600080fd5b5061038e6114d5565b34801561081b57600080fd5b5061038e611516565b34801561083057600080fd5b506011546103d2906001600160a01b031681565b34801561085057600080fd5b506103d261085f3660046139a5565b611548565b34801561087057600080fd5b5061035961087f3660046139c7565b60009182526008602090815260408084206001600160a01b0393909316845291905290205460ff1690565b3480156108b657600080fd5b506103a5611567565b3480156108cb57600080fd5b50610465600081565b3480156108e057600080fd5b5061038e6108ef366004613d59565b611576565b61038e610902366004613d87565b611580565b34801561091357600080fd5b506103a5610922366004613896565b6115b1565b34801561093357600080fd5b50610465610942366004613896565b61174a565b34801561095357600080fd5b50610a15610962366004613896565b604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff81168452700100000000000000000000000000000000810467ffffffffffffffff16918401919091527801000000000000000000000000000000000000000000000000900460c01b7fffffffffffffffff000000000000000000000000000000000000000000000000169082015290565b6040516103659190613e07565b348015610a2e57600080fd5b5061038e610a3d3660046139c7565b611761565b348015610a4e57600080fd5b506103a5611786565b348015610a6357600080fd5b507f00000000000000000000000000000000000000000000000000000000000000006103d2565b348015610a9657600080fd5b50610359610aa5366004613e66565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b348015610adf57600080fd5b506103a5611795565b348015610af457600080fd5b506104bc610b033660046138f9565b6117b5565b348015610b1457600080fd5b50610359610b233660046138f9565b6117c0565b6000610b33826117dd565b92915050565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76610b63816117f7565b610b6d8383611801565b505050565b606060028054610b8190613e94565b80601f0160208091040260200160405190810160405280929190818152602001828054610bad90613e94565b8015610bfa5780601f10610bcf57610100808354040283529160200191610bfa565b820191906000526020600020905b815481529060010190602001808311610bdd57829003601f168201915b5050505050905090565b6000610c0f8261192c565b610c45576040517fcf4700e400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b506000908152600660205260409020546001600160a01b031690565b610c6a8161196c565b15610c7d57610c798282611a42565b5050565b610c798282611b13565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76610cb1816117f7565b610cb9611b1d565b50565b60408051601280825261026082019092526060919060009082602082016102408036833701905050905060005b826fffffffffffffffffffffffffffffffff16816fffffffffffffffffffffffffffffffff161015610d90576fffffffffffffffffffffffffffffffff811660009081526010602052604090205467ffffffffffffffff1682826fffffffffffffffffffffffffffffffff1681518110610d6557610d65613ee7565b67ffffffffffffffff9092166020928302919091019091015280610d8881613f45565b915050610ce9565b5092915050565b610da08161196c565b15610db057610b6d838383611b69565b610b6d838383611d8d565b6000828152600d602090815260408083208151808301909252546001600160a01b038116808352740100000000000000000000000000000000000000009091046bffffffffffffffffffffffff16928201929092528291610e5c575060408051808201909152600c546001600160a01b03811682527401000000000000000000000000000000000000000090046bffffffffffffffffffffffff1660208201525b602081015160009061271090610e80906bffffffffffffffffffffffff1687613f74565b610e8a9190613f8b565b91519350909150505b9250929050565b600082815260086020526040902060010154610eb5816117f7565b610b6d8383611d98565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76610ee9816117f7565b610c7982611dba565b6001600160a01b0381163314610f755760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201527f20726f6c657320666f722073656c66000000000000000000000000000000000060648201526084015b60405180910390fd5b610c798282611dc6565b60607f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76610fab816117f7565b610ffb84848080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152506daaeb6d7670e522a718067333cd4e93925050611de89050565b949350505050565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf7661102d816117f7565b610cb9611e2c565b61103e8161196c565b1561104e57610b6d838383611e7e565b610b6d838383611e99565b905090565b7fe0fb75b40f2731fce9fd08fd8e51c7db44b9ffb2e43369a2734fc1a121a6b307611088816117f7565b611090611ea4565b61109c85858585611efd565b6110a66001600a55565b5050505050565b606060006110e3836fffffffffffffffffffffffffffffffff1660009081526010602052604090205467ffffffffffffffff1690565b67ffffffffffffffff1667ffffffffffffffff811115611105576111056139ec565b60405190808252806020026020018201604052801561112e578160200160208202803683370190505b5090506000806111416001546000540390565b905060005b8181101561126c57856fffffffffffffffffffffffffffffffff1661121982604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff8116845267ffffffffffffffff700100000000000000000000000000000000820416918401919091527fffffffffffffffff000000000000000000000000000000000000000000000000780100000000000000000000000000000000000000000000000090910460c01b169082015290565b516fffffffffffffffffffffffffffffffff160361125c5780848461123d81613fc6565b95508151811061124f5761124f613ee7565b6020026020010181815250505b61126581613fc6565b9050611146565b5091949350505050565b6000610b3382611f1f565b606060008267ffffffffffffffff81111561129e5761129e6139ec565b6040519080825280602002602001820160405280156112e957816020015b60408051606081018252600080825260208083018290529282015282526000199092019101816112bc5790505b50905060005b838110156113f5576113c785858381811061130c5761130c613ee7565b90506020020135604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff8116845267ffffffffffffffff700100000000000000000000000000000000820416918401919091527fffffffffffffffff000000000000000000000000000000000000000000000000780100000000000000000000000000000000000000000000000090910460c01b169082015290565b8282815181106113d9576113d9613ee7565b6020026020010181905250806113ee90613fc6565b90506112ef565b509392505050565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76611427816117f7565b50601180547fffffffffffffffffffffffff0000000000000000000000000000000000000000166001600160a01b0392909216919091179055565b60006001600160a01b0382166114a4576040517f8f4eb60400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b506001600160a01b031660009081526005602052604090205467ffffffffffffffff1690565b6000610b3382611fb8565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf766114ff816117f7565b610cb960006115116001546000540390565b612003565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76611540816117f7565b610cb9612040565b6000828152600960205260408120611560908361207d565b9392505050565b606060038054610b8190613e94565b610c798282612089565b6115898261196c565b1561159f5761159a848484846120f5565b6115ab565b6115ab84848484612152565b50505050565b6060600061166d83604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff8116845267ffffffffffffffff700100000000000000000000000000000000820416918401919091527fffffffffffffffff000000000000000000000000000000000000000000000000780100000000000000000000000000000000000000000000000090910460c01b169082015290565b80519091506fffffffffffffffffffffffffffffffff16600d03611741577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663c87b56dd6116de6116ca8460000151611fb8565b846020015167ffffffffffffffff1661215e565b6040518263ffffffff1660e01b81526004016116fc91815260200190565b600060405180830381865afa158015611719573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526115609190810190613fe0565b61156083612178565b6000818152600960205260408120610b3390612214565b60008281526008602052604090206001015461177c816117f7565b610b6d8383611dc6565b6060600e8054610b8190613e94565b60606040518060600160405280602e8152602001614423602e9139905090565b6000610b338261221e565b60006fffffffffffffffffffffffffffffffff8216600d14610b33565b60006117e8826122e7565b80610b335750610b338261231f565b610cb9813361232a565b6127106bffffffffffffffffffffffff821611156118875760405162461bcd60e51b815260206004820152602a60248201527f455243323938313a20726f79616c7479206665652077696c6c2065786365656460448201527f2073616c655072696365000000000000000000000000000000000000000000006064820152608401610f6c565b6001600160a01b0382166118dd5760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c6964207265636569766572000000000000006044820152606401610f6c565b604080518082019091526001600160a01b039092168083526bffffffffffffffffffffffff90911660209092018290527401000000000000000000000000000000000000000090910217600c55565b6000805482108015610b335750506000908152600460205260409020547c0100000000000000000000000000000000000000000000000000000000161590565b6000610b33611a2983604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff8116845267ffffffffffffffff700100000000000000000000000000000000820416918401919091527fffffffffffffffff000000000000000000000000000000000000000000000000780100000000000000000000000000000000000000000000000090910460c01b169082015290565b516fffffffffffffffffffffffffffffffff16600d1490565b6000611a4d82611276565b9050336001600160a01b03821614611a9f57611a698133610aa5565b611a9f576040517fcfb3b94200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008281526006602052604080822080547fffffffffffffffffffffffff0000000000000000000000000000000000000000166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b610c79828261239f565b611b677fe0fb75b40f2731fce9fd08fd8e51c7db44b9ffb2e43369a2734fc1a121a6b3077fd83ac62169e315c6fc3ecdb2c5b6ae75284053b2c2f2fb9fc715ba380283e9426123b3565b565b6000611b7482611f1f565b9050836001600160a01b0316816001600160a01b031614611bc1576040517fa114810000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008281526006602052604090208054338082146001600160a01b03881690911417611c2757611bf18633610aa5565b611c27576040517f59c896be00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b038516611c67576040517fea553b3400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b611c7486868660016123fe565b8015611c7f57600082555b6001600160a01b038681166000908152600560205260408082208054600019019055918716808252919020805460010190554260a01b177c0200000000000000000000000000000000000000000000000000000000176000858152600460205260408120919091557c020000000000000000000000000000000000000000000000000000000084169003611d4357600184016000818152600460205260408120549003611d41576000548114611d415760008181526004602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a45b505050505050565b610b6d838383612451565b611da28282612476565b6000828152600960205260409020610b6d9082612518565b600e610c79828261409d565b611dd0828261252d565b6000828152600960205260409020610b6d90826125b0565b6060611560838360006040518060400160405280601e81526020017f416464726573733a206c6f772d6c6576656c2063616c6c206661696c656400008152506125c5565b611e346126b7565b600b805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b610b6d83838360405180602001604052806000815250611580565b610b6d838383612709565b6002600a5403611ef65760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606401610f6c565b6002600a55565b611f098484848461272e565b6011546115ab906001600160a01b031634612925565b600081600054811015611f8657600081815260046020526040812054907c010000000000000000000000000000000000000000000000000000000082169003611f84575b80600003611560575060001901600081815260046020526040902054611f63565b505b6040517fdf2d9b4200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60006fffffffffffffffffffffffffffffffff8216600d14611fdc57611fdc61415d565b507f0000000000000000000000000000000000000000000000000000000000000000919050565b60408051838152602081018390527f6bd5c950a8d8df17f772f5af37cb3655737899cbf903264b9795592da439661c910160405180910390a15050565b612048612a3e565b600b805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258611e613390565b60006115608383612a91565b3360008181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b612100848484610d97565b6001600160a01b0383163b156115ab5761211c84848484612abb565b6115ab576040517fd1a57ed600000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6115ab84848484612c06565b60008161216e620f424085613f74565b611560919061418c565b60606121838261192c565b6121b9576040517fa14c4b5000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60006121c3612c2c565b905080516000036121e35760405180602001604052806000815250611560565b806121ed84612c36565b6040516020016121fe92919061419f565b6040516020818303038152906040529392505050565b6000610b33825490565b604080516102408101825260b48152603260208201819052918101829052606081018290526080810182905260a0810182905260c0810182905260e081018290526101008101829052610120810182905261014081018290526101608101829052602461018082015260966101a082018190526101c082018390526101e082018390526102008201929092526102208101919091526000906fffffffffffffffffffffffffffffffff8316601281106122d9576122d9613ee7565b602002015160ff1692915050565b60006122f282612c7a565b80612301575061230182612d5b565b8061231057506123108261231f565b80610b335750610b3382612db1565b6000610b3382612e48565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff16610c795761235d81612e9e565b612368836020612eb0565b6040516020016123799291906141ce565b60408051601f198184030181529082905262461bcd60e51b8252610f6c91600401613883565b816123a9816130d9565b610b6d8383611a42565b600082815260086020526040808220600101805490849055905190918391839186917fbd79b86ffe0ab8e8776151514217cd7cacd52c909f66475c3af44e129f0b00ff9190a4505050565b600b5460ff161561159a5760405162461bcd60e51b815260206004820152601560248201527f45524337323141436f6d6d6f6e3a2070617573656400000000000000000000006044820152606401610f6c565b826001600160a01b038116331461246b5761246b336130d9565b6115ab848484611b69565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff16610c795760008281526008602090815260408083206001600160a01b03851684529091529020805460ff191660011790556124d43390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000611560836001600160a01b0384166131c4565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff1615610c795760008281526008602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000611560836001600160a01b038416613213565b60608247101561263d5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f60448201527f722063616c6c00000000000000000000000000000000000000000000000000006064820152608401610f6c565b600080866001600160a01b03168587604051612659919061424f565b60006040518083038185875af1925050503d8060008114612696576040519150601f19603f3d011682016040523d82523d6000602084013e61269b565b606091505b50915091506126ac87838387613306565b979650505050505050565b600b5460ff16611b675760405162461bcd60e51b815260206004820152601460248201527f5061757361626c653a206e6f74207061757365640000000000000000000000006044820152606401610f6c565b826001600160a01b038116331461272357612723336130d9565b6115ab848484611e7e565b600061276f83838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061337f92505050565b90508367ffffffffffffffff1681511461278b5761278b61415d565b60008054905b8567ffffffffffffffff168110156129185760008382815181106127b7576127b7613ee7565b6020908102919091018101516fffffffffffffffffffffffffffffffff81166000908152601090925260408220805491935067ffffffffffffffff90911690826128008361426b565b82546101009290920a67ffffffffffffffff818102199093169183160217909155604080516060810182526fffffffffffffffffffffffffffffffff8681168252848416602080840191825260008486018181528c8252600f90925294909420925183549151945160c01c78010000000000000000000000000000000000000000000000000277ffffffffffffffffffffffffffffffffffffffffffffffff95909616700100000000000000000000000000000000027fffffffffffffffff000000000000000000000000000000000000000000000000909216921691909117179190911691909117905590506128f8848383613395565b8361290281613fc6565b94505050508061291190613fc6565b9050612791565b50611d85868686866133cb565b804710156129755760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e63650000006044820152606401610f6c565b6000826001600160a01b03168260405160006040518083038185875af1925050503d80600081146129c2576040519150601f19603f3d011682016040523d82523d6000602084013e6129c7565b606091505b5050905080610b6d5760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d617920686176652072657665727465640000000000006064820152608401610f6c565b600b5460ff1615611b675760405162461bcd60e51b815260206004820152601060248201527f5061757361626c653a20706175736564000000000000000000000000000000006044820152606401610f6c565b6000826000018281548110612aa857612aa8613ee7565b9060005260206000200154905092915050565b6040517f150b7a020000000000000000000000000000000000000000000000000000000081526000906001600160a01b0385169063150b7a0290612b09903390899088908890600401614288565b6020604051808303816000875af1925050508015612b44575060408051601f3d908101601f19168201909252612b41918101906142c4565b60015b612bbb573d808015612b72576040519150601f19603f3d011682016040523d82523d6000602084013e612b77565b606091505b508051600003612bb3576040517fd1a57ed600000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b805181602001fd5b7fffffffff00000000000000000000000000000000000000000000000000000000167f150b7a0200000000000000000000000000000000000000000000000000000000149050610ffb565b836001600160a01b0381163314612c2057612c20336130d9565b6110a6858585856120f5565b60606110596133df565b606060a06040510180604052602081039150506000815280825b600183039250600a81066030018353600a900480612c505750819003601f19909101908152919050565b60007f01ffc9a7000000000000000000000000000000000000000000000000000000007fffffffff0000000000000000000000000000000000000000000000000000000083161480612d0d57507f80ac58cd000000000000000000000000000000000000000000000000000000007fffffffff000000000000000000000000000000000000000000000000000000008316145b80610b335750507fffffffff00000000000000000000000000000000000000000000000000000000167f5b5e139f000000000000000000000000000000000000000000000000000000001490565b60007fffffffff0000000000000000000000000000000000000000000000000000000082167f2a55205a000000000000000000000000000000000000000000000000000000001480610b335750610b338261231f565b60007fffffffff0000000000000000000000000000000000000000000000000000000082167f49064906000000000000000000000000000000000000000000000000000000001480610b3357507f01ffc9a7000000000000000000000000000000000000000000000000000000007fffffffff00000000000000000000000000000000000000000000000000000000831614610b33565b60007fffffffff0000000000000000000000000000000000000000000000000000000082167f5a05180f000000000000000000000000000000000000000000000000000000001480610b335750610b33826133e9565b6060610b336001600160a01b03831660145b60606000612ebf836002613f74565b612eca90600261418c565b67ffffffffffffffff811115612ee257612ee26139ec565b6040519080825280601f01601f191660200182016040528015612f0c576020820181803683370190505b5090507f300000000000000000000000000000000000000000000000000000000000000081600081518110612f4357612f43613ee7565b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916908160001a9053507f780000000000000000000000000000000000000000000000000000000000000081600181518110612fa657612fa6613ee7565b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916908160001a9053506000612fe2846002613f74565b612fed90600161418c565b90505b600181111561308a577f303132333435363738396162636465660000000000000000000000000000000085600f166010811061302e5761302e613ee7565b1a60f81b82828151811061304457613044613ee7565b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916908160001a90535060049490941c93613083816142e1565b9050612ff0565b5083156115605760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610f6c565b6daaeb6d7670e522a718067333cd4e3b15610cb9576040517fc61711340000000000000000000000000000000000000000000000000000000081523060048201526001600160a01b03821660248201526daaeb6d7670e522a718067333cd4e9063c617113490604401602060405180830381865afa15801561315f573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061318391906142f8565b610cb9576040517fede71dcc0000000000000000000000000000000000000000000000000000000081526001600160a01b0382166004820152602401610f6c565b600081815260018301602052604081205461320b57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610b33565b506000610b33565b600081815260018301602052604081205480156132fc576000613237600183614315565b855490915060009061324b90600190614315565b90508181146132b057600086600001828154811061326b5761326b613ee7565b906000526020600020015490508087600001848154811061328e5761328e613ee7565b6000918252602080832090910192909255918252600188019052604090208390555b85548690806132c1576132c1614328565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610b33565b6000915050610b33565b6060831561337557825160000361336e576001600160a01b0385163b61336e5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610f6c565b5081610ffb565b610ffb8383613480565b606081806020019051810190610b339190614357565b6133a08383836134aa565b6fffffffffffffffffffffffffffffffff8216600d03610b6d57610b6d6133c683611fb8565b613573565b6115ab848467ffffffffffffffff1661364b565b6060611059611786565b60007fffffffff0000000000000000000000000000000000000000000000000000000082167f7965db0b000000000000000000000000000000000000000000000000000000001480610b3357507f01ffc9a7000000000000000000000000000000000000000000000000000000007fffffffff00000000000000000000000000000000000000000000000000000000831614610b33565b8151156134905781518083602001fd5b8060405162461bcd60e51b8152600401610f6c9190613883565b60126fffffffffffffffffffffffffffffffff83161061350a576040517f2fcb00a20000000000000000000000000000000000000000000000000000000081526fffffffffffffffffffffffffffffffff83166004820152602401610f6c565b6135138261221e565b67ffffffffffffffff168167ffffffffffffffff1610610b6d576040517f2df57d980000000000000000000000000000000000000000000000000000000081526fffffffffffffffffffffffffffffffff83166004820152602401610f6c565b6040517d5f340000000000000000000000000000000000000000000000000000000081523060048201819052602482018390526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116604484015260648301919091527f00000000000000000000000000000000000000000000000000000000000000001690615f34906084016020604051808303816000875af1158015613627573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c799190614409565b6000805490829003613689576040517fb562e8dd00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b61369660008483856123fe565b6001600160a01b03831660008181526005602090815260408083208054680100000000000000018802019055848352600490915281206001851460e11b4260a01b178317905582840190839083907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a4600183015b81811461374557808360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600080a460010161370d565b5081600003613780576040517f2e07630000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60005550505050565b7fffffffff0000000000000000000000000000000000000000000000000000000081168114610cb957600080fd5b6000602082840312156137c957600080fd5b813561156081613789565b6001600160a01b0381168114610cb957600080fd5b600080604083850312156137fc57600080fd5b8235613807816137d4565b915060208301356bffffffffffffffffffffffff8116811461382857600080fd5b809150509250929050565b60005b8381101561384e578181015183820152602001613836565b50506000910152565b6000815180845261386f816020860160208601613833565b601f01601f19169290920160200192915050565b6020815260006115606020830184613857565b6000602082840312156138a857600080fd5b5035919050565b600080604083850312156138c257600080fd5b82356138cd816137d4565b946020939093013593505050565b6fffffffffffffffffffffffffffffffff81168114610cb957600080fd5b60006020828403121561390b57600080fd5b8135611560816138db565b6020808252825182820181905260009190848201906040850190845b8181101561395857835167ffffffffffffffff1683529284019291840191600101613932565b50909695505050505050565b60008060006060848603121561397957600080fd5b8335613984816137d4565b92506020840135613994816137d4565b929592945050506040919091013590565b600080604083850312156139b857600080fd5b50508035926020909101359150565b600080604083850312156139da57600080fd5b823591506020830135613828816137d4565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b604051601f8201601f1916810167ffffffffffffffff81118282101715613a4457613a446139ec565b604052919050565b600067ffffffffffffffff821115613a6657613a666139ec565b50601f01601f191660200190565b6000613a87613a8284613a4c565b613a1b565b9050828152838383011115613a9b57600080fd5b828260208301376000602084830101529392505050565b600060208284031215613ac457600080fd5b813567ffffffffffffffff811115613adb57600080fd5b8201601f81018413613aec57600080fd5b610ffb84823560208401613a74565b60008083601f840112613b0d57600080fd5b50813567ffffffffffffffff811115613b2557600080fd5b602083019150836020828501011115610e9357600080fd5b60008060208385031215613b5057600080fd5b823567ffffffffffffffff811115613b6757600080fd5b613b7385828601613afb565b90969095509350505050565b60008060008060608587031215613b9557600080fd5b8435613ba0816137d4565b9350602085013567ffffffffffffffff8082168214613bbe57600080fd5b90935060408601359080821115613bd457600080fd5b50613be187828801613afb565b95989497509550505050565b6020808252825182820181905260009190848201906040850190845b8181101561395857835183529284019291840191600101613c09565b60008060208385031215613c3857600080fd5b823567ffffffffffffffff80821115613c5057600080fd5b818501915085601f830112613c6457600080fd5b813581811115613c7357600080fd5b8660208260051b8501011115613c8857600080fd5b60209290920196919550909350505050565b6020808252825182820181905260009190848201906040850190845b8181101561395857613d1b83855180516fffffffffffffffffffffffffffffffff16825260208082015167ffffffffffffffff16908301526040908101517fffffffffffffffff00000000000000000000000000000000000000000000000016910152565b9284019260609290920191600101613cb6565b600060208284031215613d4057600080fd5b8135611560816137d4565b8015158114610cb957600080fd5b60008060408385031215613d6c57600080fd5b8235613d77816137d4565b9150602083013561382881613d4b565b60008060008060808587031215613d9d57600080fd5b8435613da8816137d4565b93506020850135613db8816137d4565b925060408501359150606085013567ffffffffffffffff811115613ddb57600080fd5b8501601f81018713613dec57600080fd5b613dfb87823560208401613a74565b91505092959194509250565b81516fffffffffffffffffffffffffffffffff16815260208083015167ffffffffffffffff16908201526040808301517fffffffffffffffff000000000000000000000000000000000000000000000000169082015260608101610b33565b60008060408385031215613e7957600080fd5b8235613e84816137d4565b91506020830135613828816137d4565b600181811c90821680613ea857607f821691505b602082108103613ee1577f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b50919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b60006fffffffffffffffffffffffffffffffff808316818103613f6a57613f6a613f16565b6001019392505050565b8082028115828204841417610b3357610b33613f16565b600082613fc1577f4e487b7100000000000000000000000000000000000000000000000000000000600052601260045260246000fd5b500490565b60006000198203613fd957613fd9613f16565b5060010190565b600060208284031215613ff257600080fd5b815167ffffffffffffffff81111561400957600080fd5b8201601f8101841361401a57600080fd5b8051614028613a8282613a4c565b81815285602083850101111561403d57600080fd5b61404e826020830160208601613833565b95945050505050565b601f821115610b6d57600081815260208120601f850160051c8101602086101561407e5750805b601f850160051c820191505b81811015611d855782815560010161408a565b815167ffffffffffffffff8111156140b7576140b76139ec565b6140cb816140c58454613e94565b84614057565b602080601f83116001811461410057600084156140e85750858301515b600019600386901b1c1916600185901b178555611d85565b600085815260208120601f198616915b8281101561412f57888601518255948401946001909101908401614110565b508582101561414d5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052600160045260246000fd5b80820180821115610b3357610b33613f16565b600083516141b1818460208801613833565b8351908301906141c5818360208801613833565b01949350505050565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351614206816017850160208801613833565b7f206973206d697373696e6720726f6c65200000000000000000000000000000006017918401918201528351614243816028840160208801613833565b01602801949350505050565b60008251614261818460208701613833565b9190910192915050565b600067ffffffffffffffff808316818103613f6a57613f6a613f16565b60006001600160a01b038087168352808616602084015250836040830152608060608301526142ba6080830184613857565b9695505050505050565b6000602082840312156142d657600080fd5b815161156081613789565b6000816142f0576142f0613f16565b506000190190565b60006020828403121561430a57600080fd5b815161156081613d4b565b81810381811115610b3357610b33613f16565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603160045260246000fd5b6000602080838503121561436a57600080fd5b825167ffffffffffffffff8082111561438257600080fd5b818501915085601f83011261439657600080fd5b8151818111156143a8576143a86139ec565b8060051b91506143b9848301613a1b565b81815291830184019184810190888411156143d357600080fd5b938501935b838510156143fd57845192506143ed836138db565b82825293850193908501906143d8565b98975050505050505050565b60006020828403121561441b57600080fd5b505191905056fe417274626c6f636b73576974684d696e74657246696c746572563250726f6a656374506f6f6c53656c6c61626c65a2646970667358221220bbdf110a6c18ef4689054474236e820e538e7da68e817312ca1f2c5d6505672064736f6c634300081500331e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf7600000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000294fed5f1d3d30cfa6fe86a937dc3141eec8bc6d000000000000000000000000a2ccfe293bc2cdd78d8166a82d1e18cd2148122b000000000000000000000000b81fbcbd325473bfc6f28643c8dd0fb0bda5f3b2000000000000000000000000000000000000000000000000000000000000000600000000000000000000000070c71b539bdcb5b59edd42a500fd95bdec96265000000000000000000000000032220f07dbcd18149f619f28cd09fd911cc0372d00000000000000000000000000000000000000000000000000000000000000e000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000160000000000000000000000000431e0ae9e2c40f60a6773afbe4a1659a9c078d1100000000000000000000000000000000000000000000000000000000000002ee0000000000000000000000000000000000000000000000000000000000000008477261696c7320560000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007475241494c533500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002868747470733a2f2f6d657461646174612e70726f6f662e78797a2f677261696c732d762f6172742f000000000000000000000000000000000000000000000000
Deployed Bytecode
0x6080604052600436106103345760003560e01c80635c975abb116101b0578063a217fddf116100ec578063d547741f11610095578063e985e9c51161006f578063e985e9c514610a8a578063e9d1e8ac14610ad3578063ec490d5914610ae8578063edcddc6714610b0857600080fd5b8063d547741f14610a22578063d547cfb714610a42578063dd85582f14610a5757600080fd5b8063c87b56dd116100c6578063c87b56dd14610907578063ca15c87314610927578063cc33c8751461094757600080fd5b8063a217fddf146108bf578063a22cb465146108d4578063b88d4fde146108f457600080fd5b80637d49ceb911610159578063899308a811610133578063899308a8146108245780639010d07c1461084457806391d148541461086457806395d89b41146108aa57600080fd5b80637d49ceb9146107da5780638222b7d7146107fa5780638456cb591461080f57600080fd5b80636d147a6d1161018a5780636d147a6d1461076d5780636f267c371461079a57806370a08231146107ba57600080fd5b80635c975abb1461070857806361d3eb35146107205780636352211e1461074d57600080fd5b8063248a9ca31161027f5780633dcc23a01161022857806342842e0e1161020257806342842e0e1461069257806351b1dbef146106a55780635a067baa146106d95780635ada5c55146106f557600080fd5b80633dcc23a01461063b5780633f4ba83a1461065b57806341f434341461067057600080fd5b806330176e131161025957806330176e13146105c757806331c23d20146105e757806336568abe1461061b57600080fd5b8063248a9ca3146105385780632a55205a146105685780632f2ff15d146105a757600080fd5b80630dc3b909116102e15780631d23354a116102bb5780631d23354a146104ee5780631db721851461050357806323b872dd1461052557600080fd5b80630dc3b9091461043157806310a2c73d1461047357806318160ddd146104d557600080fd5b8063081812fc11610312578063081812fc146103b257806308d94188146103ea578063095ea7b31461041e57600080fd5b806301ffc9a71461033957806304634d8d1461036e57806306fdde0314610390575b600080fd5b34801561034557600080fd5b506103596103543660046137b7565b610b28565b60405190151581526020015b60405180910390f35b34801561037a57600080fd5b5061038e6103893660046137e9565b610b39565b005b34801561039c57600080fd5b506103a5610b72565b6040516103659190613883565b3480156103be57600080fd5b506103d26103cd366004613896565b610c04565b6040516001600160a01b039091168152602001610365565b3480156103f657600080fd5b506103d27f000000000000000000000000a2ccfe293bc2cdd78d8166a82d1e18cd2148122b81565b61038e61042c3660046138af565b610c61565b34801561043d57600080fd5b506104657fe0fb75b40f2731fce9fd08fd8e51c7db44b9ffb2e43369a2734fc1a121a6b30781565b604051908152602001610365565b34801561047f57600080fd5b506104bc61048e3660046138f9565b6fffffffffffffffffffffffffffffffff1660009081526010602052604090205467ffffffffffffffff1690565b60405167ffffffffffffffff9091168152602001610365565b3480156104e157600080fd5b5060015460005403610465565b3480156104fa57600080fd5b5061038e610c87565b34801561050f57600080fd5b50610518610cbc565b6040516103659190613916565b61038e610533366004613964565b610d97565b34801561054457600080fd5b50610465610553366004613896565b60009081526008602052604090206001015490565b34801561057457600080fd5b506105886105833660046139a5565b610dbb565b604080516001600160a01b039093168352602083019190915201610365565b3480156105b357600080fd5b5061038e6105c23660046139c7565b610e9a565b3480156105d357600080fd5b5061038e6105e2366004613ab2565b610ebf565b3480156105f357600080fd5b506104657f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf7681565b34801561062757600080fd5b5061038e6106363660046139c7565b610ef2565b34801561064757600080fd5b506103a5610656366004613b3d565b610f7f565b34801561066757600080fd5b5061038e611003565b34801561067c57600080fd5b506103d26daaeb6d7670e522a718067333cd4e81565b61038e6106a0366004613964565b611035565b3480156106b157600080fd5b506103d27f000000000000000000000000294fed5f1d3d30cfa6fe86a937dc3141eec8bc6d81565b3480156106e557600080fd5b5060405160128152602001610365565b61038e610703366004613b7f565b61105e565b34801561071457600080fd5b50600b5460ff16610359565b34801561072c57600080fd5b5061074061073b3660046138f9565b6110ad565b6040516103659190613bed565b34801561075957600080fd5b506103d2610768366004613896565b611276565b34801561077957600080fd5b5061078d610788366004613c25565b611281565b6040516103659190613c9a565b3480156107a657600080fd5b5061038e6107b5366004613d2e565b6113fd565b3480156107c657600080fd5b506104656107d5366004613d2e565b611462565b3480156107e657600080fd5b506104656107f53660046138f9565b6114ca565b34801561080657600080fd5b5061038e6114d5565b34801561081b57600080fd5b5061038e611516565b34801561083057600080fd5b506011546103d2906001600160a01b031681565b34801561085057600080fd5b506103d261085f3660046139a5565b611548565b34801561087057600080fd5b5061035961087f3660046139c7565b60009182526008602090815260408084206001600160a01b0393909316845291905290205460ff1690565b3480156108b657600080fd5b506103a5611567565b3480156108cb57600080fd5b50610465600081565b3480156108e057600080fd5b5061038e6108ef366004613d59565b611576565b61038e610902366004613d87565b611580565b34801561091357600080fd5b506103a5610922366004613896565b6115b1565b34801561093357600080fd5b50610465610942366004613896565b61174a565b34801561095357600080fd5b50610a15610962366004613896565b604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff81168452700100000000000000000000000000000000810467ffffffffffffffff16918401919091527801000000000000000000000000000000000000000000000000900460c01b7fffffffffffffffff000000000000000000000000000000000000000000000000169082015290565b6040516103659190613e07565b348015610a2e57600080fd5b5061038e610a3d3660046139c7565b611761565b348015610a4e57600080fd5b506103a5611786565b348015610a6357600080fd5b507f000000000000000000000000a2ccfe293bc2cdd78d8166a82d1e18cd2148122b6103d2565b348015610a9657600080fd5b50610359610aa5366004613e66565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b348015610adf57600080fd5b506103a5611795565b348015610af457600080fd5b506104bc610b033660046138f9565b6117b5565b348015610b1457600080fd5b50610359610b233660046138f9565b6117c0565b6000610b33826117dd565b92915050565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76610b63816117f7565b610b6d8383611801565b505050565b606060028054610b8190613e94565b80601f0160208091040260200160405190810160405280929190818152602001828054610bad90613e94565b8015610bfa5780601f10610bcf57610100808354040283529160200191610bfa565b820191906000526020600020905b815481529060010190602001808311610bdd57829003601f168201915b5050505050905090565b6000610c0f8261192c565b610c45576040517fcf4700e400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b506000908152600660205260409020546001600160a01b031690565b610c6a8161196c565b15610c7d57610c798282611a42565b5050565b610c798282611b13565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76610cb1816117f7565b610cb9611b1d565b50565b60408051601280825261026082019092526060919060009082602082016102408036833701905050905060005b826fffffffffffffffffffffffffffffffff16816fffffffffffffffffffffffffffffffff161015610d90576fffffffffffffffffffffffffffffffff811660009081526010602052604090205467ffffffffffffffff1682826fffffffffffffffffffffffffffffffff1681518110610d6557610d65613ee7565b67ffffffffffffffff9092166020928302919091019091015280610d8881613f45565b915050610ce9565b5092915050565b610da08161196c565b15610db057610b6d838383611b69565b610b6d838383611d8d565b6000828152600d602090815260408083208151808301909252546001600160a01b038116808352740100000000000000000000000000000000000000009091046bffffffffffffffffffffffff16928201929092528291610e5c575060408051808201909152600c546001600160a01b03811682527401000000000000000000000000000000000000000090046bffffffffffffffffffffffff1660208201525b602081015160009061271090610e80906bffffffffffffffffffffffff1687613f74565b610e8a9190613f8b565b91519350909150505b9250929050565b600082815260086020526040902060010154610eb5816117f7565b610b6d8383611d98565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76610ee9816117f7565b610c7982611dba565b6001600160a01b0381163314610f755760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201527f20726f6c657320666f722073656c66000000000000000000000000000000000060648201526084015b60405180910390fd5b610c798282611dc6565b60607f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76610fab816117f7565b610ffb84848080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152506daaeb6d7670e522a718067333cd4e93925050611de89050565b949350505050565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf7661102d816117f7565b610cb9611e2c565b61103e8161196c565b1561104e57610b6d838383611e7e565b610b6d838383611e99565b905090565b7fe0fb75b40f2731fce9fd08fd8e51c7db44b9ffb2e43369a2734fc1a121a6b307611088816117f7565b611090611ea4565b61109c85858585611efd565b6110a66001600a55565b5050505050565b606060006110e3836fffffffffffffffffffffffffffffffff1660009081526010602052604090205467ffffffffffffffff1690565b67ffffffffffffffff1667ffffffffffffffff811115611105576111056139ec565b60405190808252806020026020018201604052801561112e578160200160208202803683370190505b5090506000806111416001546000540390565b905060005b8181101561126c57856fffffffffffffffffffffffffffffffff1661121982604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff8116845267ffffffffffffffff700100000000000000000000000000000000820416918401919091527fffffffffffffffff000000000000000000000000000000000000000000000000780100000000000000000000000000000000000000000000000090910460c01b169082015290565b516fffffffffffffffffffffffffffffffff160361125c5780848461123d81613fc6565b95508151811061124f5761124f613ee7565b6020026020010181815250505b61126581613fc6565b9050611146565b5091949350505050565b6000610b3382611f1f565b606060008267ffffffffffffffff81111561129e5761129e6139ec565b6040519080825280602002602001820160405280156112e957816020015b60408051606081018252600080825260208083018290529282015282526000199092019101816112bc5790505b50905060005b838110156113f5576113c785858381811061130c5761130c613ee7565b90506020020135604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff8116845267ffffffffffffffff700100000000000000000000000000000000820416918401919091527fffffffffffffffff000000000000000000000000000000000000000000000000780100000000000000000000000000000000000000000000000090910460c01b169082015290565b8282815181106113d9576113d9613ee7565b6020026020010181905250806113ee90613fc6565b90506112ef565b509392505050565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76611427816117f7565b50601180547fffffffffffffffffffffffff0000000000000000000000000000000000000000166001600160a01b0392909216919091179055565b60006001600160a01b0382166114a4576040517f8f4eb60400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b506001600160a01b031660009081526005602052604090205467ffffffffffffffff1690565b6000610b3382611fb8565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf766114ff816117f7565b610cb960006115116001546000540390565b612003565b7f1e4c11efbd6a865b1cba79eea33d1b33c1394d834190605ed6a14c71c480bf76611540816117f7565b610cb9612040565b6000828152600960205260408120611560908361207d565b9392505050565b606060038054610b8190613e94565b610c798282612089565b6115898261196c565b1561159f5761159a848484846120f5565b6115ab565b6115ab84848484612152565b50505050565b6060600061166d83604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff8116845267ffffffffffffffff700100000000000000000000000000000000820416918401919091527fffffffffffffffff000000000000000000000000000000000000000000000000780100000000000000000000000000000000000000000000000090910460c01b169082015290565b80519091506fffffffffffffffffffffffffffffffff16600d03611741577f000000000000000000000000294fed5f1d3d30cfa6fe86a937dc3141eec8bc6d6001600160a01b031663c87b56dd6116de6116ca8460000151611fb8565b846020015167ffffffffffffffff1661215e565b6040518263ffffffff1660e01b81526004016116fc91815260200190565b600060405180830381865afa158015611719573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526115609190810190613fe0565b61156083612178565b6000818152600960205260408120610b3390612214565b60008281526008602052604090206001015461177c816117f7565b610b6d8383611dc6565b6060600e8054610b8190613e94565b60606040518060600160405280602e8152602001614423602e9139905090565b6000610b338261221e565b60006fffffffffffffffffffffffffffffffff8216600d14610b33565b60006117e8826122e7565b80610b335750610b338261231f565b610cb9813361232a565b6127106bffffffffffffffffffffffff821611156118875760405162461bcd60e51b815260206004820152602a60248201527f455243323938313a20726f79616c7479206665652077696c6c2065786365656460448201527f2073616c655072696365000000000000000000000000000000000000000000006064820152608401610f6c565b6001600160a01b0382166118dd5760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c6964207265636569766572000000000000006044820152606401610f6c565b604080518082019091526001600160a01b039092168083526bffffffffffffffffffffffff90911660209092018290527401000000000000000000000000000000000000000090910217600c55565b6000805482108015610b335750506000908152600460205260409020547c0100000000000000000000000000000000000000000000000000000000161590565b6000610b33611a2983604080516060808201835260008083526020808401829052928401819052938452600f82529282902082519384018352546fffffffffffffffffffffffffffffffff8116845267ffffffffffffffff700100000000000000000000000000000000820416918401919091527fffffffffffffffff000000000000000000000000000000000000000000000000780100000000000000000000000000000000000000000000000090910460c01b169082015290565b516fffffffffffffffffffffffffffffffff16600d1490565b6000611a4d82611276565b9050336001600160a01b03821614611a9f57611a698133610aa5565b611a9f576040517fcfb3b94200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008281526006602052604080822080547fffffffffffffffffffffffff0000000000000000000000000000000000000000166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b610c79828261239f565b611b677fe0fb75b40f2731fce9fd08fd8e51c7db44b9ffb2e43369a2734fc1a121a6b3077fd83ac62169e315c6fc3ecdb2c5b6ae75284053b2c2f2fb9fc715ba380283e9426123b3565b565b6000611b7482611f1f565b9050836001600160a01b0316816001600160a01b031614611bc1576040517fa114810000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008281526006602052604090208054338082146001600160a01b03881690911417611c2757611bf18633610aa5565b611c27576040517f59c896be00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b038516611c67576040517fea553b3400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b611c7486868660016123fe565b8015611c7f57600082555b6001600160a01b038681166000908152600560205260408082208054600019019055918716808252919020805460010190554260a01b177c0200000000000000000000000000000000000000000000000000000000176000858152600460205260408120919091557c020000000000000000000000000000000000000000000000000000000084169003611d4357600184016000818152600460205260408120549003611d41576000548114611d415760008181526004602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a45b505050505050565b610b6d838383612451565b611da28282612476565b6000828152600960205260409020610b6d9082612518565b600e610c79828261409d565b611dd0828261252d565b6000828152600960205260409020610b6d90826125b0565b6060611560838360006040518060400160405280601e81526020017f416464726573733a206c6f772d6c6576656c2063616c6c206661696c656400008152506125c5565b611e346126b7565b600b805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b610b6d83838360405180602001604052806000815250611580565b610b6d838383612709565b6002600a5403611ef65760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606401610f6c565b6002600a55565b611f098484848461272e565b6011546115ab906001600160a01b031634612925565b600081600054811015611f8657600081815260046020526040812054907c010000000000000000000000000000000000000000000000000000000082169003611f84575b80600003611560575060001901600081815260046020526040902054611f63565b505b6040517fdf2d9b4200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60006fffffffffffffffffffffffffffffffff8216600d14611fdc57611fdc61415d565b507f0000000000000000000000000000000000000000000000000000000000000006919050565b60408051838152602081018390527f6bd5c950a8d8df17f772f5af37cb3655737899cbf903264b9795592da439661c910160405180910390a15050565b612048612a3e565b600b805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258611e613390565b60006115608383612a91565b3360008181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b612100848484610d97565b6001600160a01b0383163b156115ab5761211c84848484612abb565b6115ab576040517fd1a57ed600000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6115ab84848484612c06565b60008161216e620f424085613f74565b611560919061418c565b60606121838261192c565b6121b9576040517fa14c4b5000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60006121c3612c2c565b905080516000036121e35760405180602001604052806000815250611560565b806121ed84612c36565b6040516020016121fe92919061419f565b6040516020818303038152906040529392505050565b6000610b33825490565b604080516102408101825260b48152603260208201819052918101829052606081018290526080810182905260a0810182905260c0810182905260e081018290526101008101829052610120810182905261014081018290526101608101829052602461018082015260966101a082018190526101c082018390526101e082018390526102008201929092526102208101919091526000906fffffffffffffffffffffffffffffffff8316601281106122d9576122d9613ee7565b602002015160ff1692915050565b60006122f282612c7a565b80612301575061230182612d5b565b8061231057506123108261231f565b80610b335750610b3382612db1565b6000610b3382612e48565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff16610c795761235d81612e9e565b612368836020612eb0565b6040516020016123799291906141ce565b60408051601f198184030181529082905262461bcd60e51b8252610f6c91600401613883565b816123a9816130d9565b610b6d8383611a42565b600082815260086020526040808220600101805490849055905190918391839186917fbd79b86ffe0ab8e8776151514217cd7cacd52c909f66475c3af44e129f0b00ff9190a4505050565b600b5460ff161561159a5760405162461bcd60e51b815260206004820152601560248201527f45524337323141436f6d6d6f6e3a2070617573656400000000000000000000006044820152606401610f6c565b826001600160a01b038116331461246b5761246b336130d9565b6115ab848484611b69565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff16610c795760008281526008602090815260408083206001600160a01b03851684529091529020805460ff191660011790556124d43390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000611560836001600160a01b0384166131c4565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff1615610c795760008281526008602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000611560836001600160a01b038416613213565b60608247101561263d5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f60448201527f722063616c6c00000000000000000000000000000000000000000000000000006064820152608401610f6c565b600080866001600160a01b03168587604051612659919061424f565b60006040518083038185875af1925050503d8060008114612696576040519150601f19603f3d011682016040523d82523d6000602084013e61269b565b606091505b50915091506126ac87838387613306565b979650505050505050565b600b5460ff16611b675760405162461bcd60e51b815260206004820152601460248201527f5061757361626c653a206e6f74207061757365640000000000000000000000006044820152606401610f6c565b826001600160a01b038116331461272357612723336130d9565b6115ab848484611e7e565b600061276f83838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061337f92505050565b90508367ffffffffffffffff1681511461278b5761278b61415d565b60008054905b8567ffffffffffffffff168110156129185760008382815181106127b7576127b7613ee7565b6020908102919091018101516fffffffffffffffffffffffffffffffff81166000908152601090925260408220805491935067ffffffffffffffff90911690826128008361426b565b82546101009290920a67ffffffffffffffff818102199093169183160217909155604080516060810182526fffffffffffffffffffffffffffffffff8681168252848416602080840191825260008486018181528c8252600f90925294909420925183549151945160c01c78010000000000000000000000000000000000000000000000000277ffffffffffffffffffffffffffffffffffffffffffffffff95909616700100000000000000000000000000000000027fffffffffffffffff000000000000000000000000000000000000000000000000909216921691909117179190911691909117905590506128f8848383613395565b8361290281613fc6565b94505050508061291190613fc6565b9050612791565b50611d85868686866133cb565b804710156129755760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e63650000006044820152606401610f6c565b6000826001600160a01b03168260405160006040518083038185875af1925050503d80600081146129c2576040519150601f19603f3d011682016040523d82523d6000602084013e6129c7565b606091505b5050905080610b6d5760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d617920686176652072657665727465640000000000006064820152608401610f6c565b600b5460ff1615611b675760405162461bcd60e51b815260206004820152601060248201527f5061757361626c653a20706175736564000000000000000000000000000000006044820152606401610f6c565b6000826000018281548110612aa857612aa8613ee7565b9060005260206000200154905092915050565b6040517f150b7a020000000000000000000000000000000000000000000000000000000081526000906001600160a01b0385169063150b7a0290612b09903390899088908890600401614288565b6020604051808303816000875af1925050508015612b44575060408051601f3d908101601f19168201909252612b41918101906142c4565b60015b612bbb573d808015612b72576040519150601f19603f3d011682016040523d82523d6000602084013e612b77565b606091505b508051600003612bb3576040517fd1a57ed600000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b805181602001fd5b7fffffffff00000000000000000000000000000000000000000000000000000000167f150b7a0200000000000000000000000000000000000000000000000000000000149050610ffb565b836001600160a01b0381163314612c2057612c20336130d9565b6110a6858585856120f5565b60606110596133df565b606060a06040510180604052602081039150506000815280825b600183039250600a81066030018353600a900480612c505750819003601f19909101908152919050565b60007f01ffc9a7000000000000000000000000000000000000000000000000000000007fffffffff0000000000000000000000000000000000000000000000000000000083161480612d0d57507f80ac58cd000000000000000000000000000000000000000000000000000000007fffffffff000000000000000000000000000000000000000000000000000000008316145b80610b335750507fffffffff00000000000000000000000000000000000000000000000000000000167f5b5e139f000000000000000000000000000000000000000000000000000000001490565b60007fffffffff0000000000000000000000000000000000000000000000000000000082167f2a55205a000000000000000000000000000000000000000000000000000000001480610b335750610b338261231f565b60007fffffffff0000000000000000000000000000000000000000000000000000000082167f49064906000000000000000000000000000000000000000000000000000000001480610b3357507f01ffc9a7000000000000000000000000000000000000000000000000000000007fffffffff00000000000000000000000000000000000000000000000000000000831614610b33565b60007fffffffff0000000000000000000000000000000000000000000000000000000082167f5a05180f000000000000000000000000000000000000000000000000000000001480610b335750610b33826133e9565b6060610b336001600160a01b03831660145b60606000612ebf836002613f74565b612eca90600261418c565b67ffffffffffffffff811115612ee257612ee26139ec565b6040519080825280601f01601f191660200182016040528015612f0c576020820181803683370190505b5090507f300000000000000000000000000000000000000000000000000000000000000081600081518110612f4357612f43613ee7565b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916908160001a9053507f780000000000000000000000000000000000000000000000000000000000000081600181518110612fa657612fa6613ee7565b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916908160001a9053506000612fe2846002613f74565b612fed90600161418c565b90505b600181111561308a577f303132333435363738396162636465660000000000000000000000000000000085600f166010811061302e5761302e613ee7565b1a60f81b82828151811061304457613044613ee7565b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916908160001a90535060049490941c93613083816142e1565b9050612ff0565b5083156115605760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610f6c565b6daaeb6d7670e522a718067333cd4e3b15610cb9576040517fc61711340000000000000000000000000000000000000000000000000000000081523060048201526001600160a01b03821660248201526daaeb6d7670e522a718067333cd4e9063c617113490604401602060405180830381865afa15801561315f573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061318391906142f8565b610cb9576040517fede71dcc0000000000000000000000000000000000000000000000000000000081526001600160a01b0382166004820152602401610f6c565b600081815260018301602052604081205461320b57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610b33565b506000610b33565b600081815260018301602052604081205480156132fc576000613237600183614315565b855490915060009061324b90600190614315565b90508181146132b057600086600001828154811061326b5761326b613ee7565b906000526020600020015490508087600001848154811061328e5761328e613ee7565b6000918252602080832090910192909255918252600188019052604090208390555b85548690806132c1576132c1614328565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610b33565b6000915050610b33565b6060831561337557825160000361336e576001600160a01b0385163b61336e5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610f6c565b5081610ffb565b610ffb8383613480565b606081806020019051810190610b339190614357565b6133a08383836134aa565b6fffffffffffffffffffffffffffffffff8216600d03610b6d57610b6d6133c683611fb8565b613573565b6115ab848467ffffffffffffffff1661364b565b6060611059611786565b60007fffffffff0000000000000000000000000000000000000000000000000000000082167f7965db0b000000000000000000000000000000000000000000000000000000001480610b3357507f01ffc9a7000000000000000000000000000000000000000000000000000000007fffffffff00000000000000000000000000000000000000000000000000000000831614610b33565b8151156134905781518083602001fd5b8060405162461bcd60e51b8152600401610f6c9190613883565b60126fffffffffffffffffffffffffffffffff83161061350a576040517f2fcb00a20000000000000000000000000000000000000000000000000000000081526fffffffffffffffffffffffffffffffff83166004820152602401610f6c565b6135138261221e565b67ffffffffffffffff168167ffffffffffffffff1610610b6d576040517f2df57d980000000000000000000000000000000000000000000000000000000081526fffffffffffffffffffffffffffffffff83166004820152602401610f6c565b6040517d5f340000000000000000000000000000000000000000000000000000000081523060048201819052602482018390526001600160a01b037f000000000000000000000000294fed5f1d3d30cfa6fe86a937dc3141eec8bc6d8116604484015260648301919091527f000000000000000000000000a2ccfe293bc2cdd78d8166a82d1e18cd2148122b1690615f34906084016020604051808303816000875af1158015613627573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c799190614409565b6000805490829003613689576040517fb562e8dd00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b61369660008483856123fe565b6001600160a01b03831660008181526005602090815260408083208054680100000000000000018802019055848352600490915281206001851460e11b4260a01b178317905582840190839083907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a4600183015b81811461374557808360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600080a460010161370d565b5081600003613780576040517f2e07630000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60005550505050565b7fffffffff0000000000000000000000000000000000000000000000000000000081168114610cb957600080fd5b6000602082840312156137c957600080fd5b813561156081613789565b6001600160a01b0381168114610cb957600080fd5b600080604083850312156137fc57600080fd5b8235613807816137d4565b915060208301356bffffffffffffffffffffffff8116811461382857600080fd5b809150509250929050565b60005b8381101561384e578181015183820152602001613836565b50506000910152565b6000815180845261386f816020860160208601613833565b601f01601f19169290920160200192915050565b6020815260006115606020830184613857565b6000602082840312156138a857600080fd5b5035919050565b600080604083850312156138c257600080fd5b82356138cd816137d4565b946020939093013593505050565b6fffffffffffffffffffffffffffffffff81168114610cb957600080fd5b60006020828403121561390b57600080fd5b8135611560816138db565b6020808252825182820181905260009190848201906040850190845b8181101561395857835167ffffffffffffffff1683529284019291840191600101613932565b50909695505050505050565b60008060006060848603121561397957600080fd5b8335613984816137d4565b92506020840135613994816137d4565b929592945050506040919091013590565b600080604083850312156139b857600080fd5b50508035926020909101359150565b600080604083850312156139da57600080fd5b823591506020830135613828816137d4565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b604051601f8201601f1916810167ffffffffffffffff81118282101715613a4457613a446139ec565b604052919050565b600067ffffffffffffffff821115613a6657613a666139ec565b50601f01601f191660200190565b6000613a87613a8284613a4c565b613a1b565b9050828152838383011115613a9b57600080fd5b828260208301376000602084830101529392505050565b600060208284031215613ac457600080fd5b813567ffffffffffffffff811115613adb57600080fd5b8201601f81018413613aec57600080fd5b610ffb84823560208401613a74565b60008083601f840112613b0d57600080fd5b50813567ffffffffffffffff811115613b2557600080fd5b602083019150836020828501011115610e9357600080fd5b60008060208385031215613b5057600080fd5b823567ffffffffffffffff811115613b6757600080fd5b613b7385828601613afb565b90969095509350505050565b60008060008060608587031215613b9557600080fd5b8435613ba0816137d4565b9350602085013567ffffffffffffffff8082168214613bbe57600080fd5b90935060408601359080821115613bd457600080fd5b50613be187828801613afb565b95989497509550505050565b6020808252825182820181905260009190848201906040850190845b8181101561395857835183529284019291840191600101613c09565b60008060208385031215613c3857600080fd5b823567ffffffffffffffff80821115613c5057600080fd5b818501915085601f830112613c6457600080fd5b813581811115613c7357600080fd5b8660208260051b8501011115613c8857600080fd5b60209290920196919550909350505050565b6020808252825182820181905260009190848201906040850190845b8181101561395857613d1b83855180516fffffffffffffffffffffffffffffffff16825260208082015167ffffffffffffffff16908301526040908101517fffffffffffffffff00000000000000000000000000000000000000000000000016910152565b9284019260609290920191600101613cb6565b600060208284031215613d4057600080fd5b8135611560816137d4565b8015158114610cb957600080fd5b60008060408385031215613d6c57600080fd5b8235613d77816137d4565b9150602083013561382881613d4b565b60008060008060808587031215613d9d57600080fd5b8435613da8816137d4565b93506020850135613db8816137d4565b925060408501359150606085013567ffffffffffffffff811115613ddb57600080fd5b8501601f81018713613dec57600080fd5b613dfb87823560208401613a74565b91505092959194509250565b81516fffffffffffffffffffffffffffffffff16815260208083015167ffffffffffffffff16908201526040808301517fffffffffffffffff000000000000000000000000000000000000000000000000169082015260608101610b33565b60008060408385031215613e7957600080fd5b8235613e84816137d4565b91506020830135613828816137d4565b600181811c90821680613ea857607f821691505b602082108103613ee1577f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b50919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b60006fffffffffffffffffffffffffffffffff808316818103613f6a57613f6a613f16565b6001019392505050565b8082028115828204841417610b3357610b33613f16565b600082613fc1577f4e487b7100000000000000000000000000000000000000000000000000000000600052601260045260246000fd5b500490565b60006000198203613fd957613fd9613f16565b5060010190565b600060208284031215613ff257600080fd5b815167ffffffffffffffff81111561400957600080fd5b8201601f8101841361401a57600080fd5b8051614028613a8282613a4c565b81815285602083850101111561403d57600080fd5b61404e826020830160208601613833565b95945050505050565b601f821115610b6d57600081815260208120601f850160051c8101602086101561407e5750805b601f850160051c820191505b81811015611d855782815560010161408a565b815167ffffffffffffffff8111156140b7576140b76139ec565b6140cb816140c58454613e94565b84614057565b602080601f83116001811461410057600084156140e85750858301515b600019600386901b1c1916600185901b178555611d85565b600085815260208120601f198616915b8281101561412f57888601518255948401946001909101908401614110565b508582101561414d5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052600160045260246000fd5b80820180821115610b3357610b33613f16565b600083516141b1818460208801613833565b8351908301906141c5818360208801613833565b01949350505050565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351614206816017850160208801613833565b7f206973206d697373696e6720726f6c65200000000000000000000000000000006017918401918201528351614243816028840160208801613833565b01602801949350505050565b60008251614261818460208701613833565b9190910192915050565b600067ffffffffffffffff808316818103613f6a57613f6a613f16565b60006001600160a01b038087168352808616602084015250836040830152608060608301526142ba6080830184613857565b9695505050505050565b6000602082840312156142d657600080fd5b815161156081613789565b6000816142f0576142f0613f16565b506000190190565b60006020828403121561430a57600080fd5b815161156081613d4b565b81810381811115610b3357610b33613f16565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603160045260246000fd5b6000602080838503121561436a57600080fd5b825167ffffffffffffffff8082111561438257600080fd5b818501915085601f83011261439657600080fd5b8151818111156143a8576143a86139ec565b8060051b91506143b9848301613a1b565b81815291830184019184810190888411156143d357600080fd5b938501935b838510156143fd57845192506143ed836138db565b82825293850193908501906143d8565b98975050505050505050565b60006020828403121561441b57600080fd5b505191905056fe417274626c6f636b73576974684d696e74657246696c746572563250726f6a656374506f6f6c53656c6c61626c65a2646970667358221220bbdf110a6c18ef4689054474236e820e538e7da68e817312ca1f2c5d6505672064736f6c63430008150033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
00000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000294fed5f1d3d30cfa6fe86a937dc3141eec8bc6d000000000000000000000000a2ccfe293bc2cdd78d8166a82d1e18cd2148122b000000000000000000000000b81fbcbd325473bfc6f28643c8dd0fb0bda5f3b2000000000000000000000000000000000000000000000000000000000000000600000000000000000000000070c71b539bdcb5b59edd42a500fd95bdec96265000000000000000000000000032220f07dbcd18149f619f28cd09fd911cc0372d00000000000000000000000000000000000000000000000000000000000000e000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000160000000000000000000000000431e0ae9e2c40f60a6773afbe4a1659a9c078d1100000000000000000000000000000000000000000000000000000000000002ee0000000000000000000000000000000000000000000000000000000000000008477261696c7320560000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007475241494c533500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002868747470733a2f2f6d657461646174612e70726f6f662e78797a2f677261696c732d762f6172742f000000000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : init (tuple): System.Collections.Generic.List`1[Nethereum.ABI.FunctionEncoding.ParameterOutput]
Arg [1] : flex_ (address): 0x294fED5F1D3D30cfA6Fe86A937dC3141EEc8bC6d
Arg [2] : filter_ (address): 0xa2ccfE293bc2CDD78D8166a82D1e18cD2148122b
Arg [3] : primaryReceiver_ (address): 0xb81FbcBD325473bFc6f28643C8dd0fb0bdA5F3B2
Arg [4] : project13ArtblocksProjectId (uint256): 6
-----Encoded View---------------
19 Constructor Arguments found :
Arg [0] : 00000000000000000000000000000000000000000000000000000000000000a0
Arg [1] : 000000000000000000000000294fed5f1d3d30cfa6fe86a937dc3141eec8bc6d
Arg [2] : 000000000000000000000000a2ccfe293bc2cdd78d8166a82d1e18cd2148122b
Arg [3] : 000000000000000000000000b81fbcbd325473bfc6f28643c8dd0fb0bda5f3b2
Arg [4] : 0000000000000000000000000000000000000000000000000000000000000006
Arg [5] : 00000000000000000000000070c71b539bdcb5b59edd42a500fd95bdec962650
Arg [6] : 00000000000000000000000032220f07dbcd18149f619f28cd09fd911cc0372d
Arg [7] : 00000000000000000000000000000000000000000000000000000000000000e0
Arg [8] : 0000000000000000000000000000000000000000000000000000000000000120
Arg [9] : 0000000000000000000000000000000000000000000000000000000000000160
Arg [10] : 000000000000000000000000431e0ae9e2c40f60a6773afbe4a1659a9c078d11
Arg [11] : 00000000000000000000000000000000000000000000000000000000000002ee
Arg [12] : 0000000000000000000000000000000000000000000000000000000000000008
Arg [13] : 477261696c732056000000000000000000000000000000000000000000000000
Arg [14] : 0000000000000000000000000000000000000000000000000000000000000007
Arg [15] : 475241494c533500000000000000000000000000000000000000000000000000
Arg [16] : 0000000000000000000000000000000000000000000000000000000000000028
Arg [17] : 68747470733a2f2f6d657461646174612e70726f6f662e78797a2f677261696c
Arg [18] : 732d762f6172742f000000000000000000000000000000000000000000000000
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A token is a representation of an on-chain or off-chain asset. The token page shows information such as price, total supply, holders, transfers and social links. Learn more about this page in our Knowledge Base.