ERC-721
Overview
Max Total Supply
679 DM01
Holders
214
Market
Volume (24H)
N/A
Min Price (24H)
N/A
Max Price (24H)
N/A
Other Info
Token Contract
Balance
2 DM01Loading...
Loading
Loading...
Loading
Loading...
Loading
# | Exchange | Pair | Price | 24H Volume | % Volume |
---|
Contract Name:
Eve
Compiler Version
v0.8.17+commit.8df45f5f
Optimization Enabled:
Yes with 800 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: Unlicense // Version 0.0.1 pragma solidity ^0.8.17; import "@openzeppelin/contracts/utils/Address.sol"; import "@openzeppelin/contracts/access/AccessControl.sol"; import "@openzeppelin/contracts/access/Ownable.sol"; import "@openzeppelin/contracts/token/common/ERC2981.sol"; import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol"; import "@openzeppelin/contracts/token/ERC721/IERC721.sol"; import "@openzeppelin/contracts/token/ERC721/extensions/IERC721Metadata.sol"; import "@openzeppelin/contracts/token/ERC721/ERC721.sol"; import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Enumerable.sol"; import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Burnable.sol"; import "operator-filter-registry/src/DefaultOperatorFilterer.sol"; import "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol"; import "@openzeppelin/contracts/security/Pausable.sol"; import "@openzeppelin/contracts/utils/structs/BitMaps.sol"; import "./utils.sol"; contract Eve is ERC721, ERC721Enumerable, ERC721Burnable, AccessControl, Ownable, Pausable, ERC2981, DefaultOperatorFilterer { using Address for address; using Strings for uint256; using BitMaps for BitMaps.BitMap; // Roles bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE"); bytes32 public constant STAKER_ROLE = keccak256("STAKER_ROLE"); // Constants address public constant CUSTOM_SUBSCRIPTION = address(0x6438fa583f5f60E37Dcd969D87A515b2b84C4219); uint32 public constant MAX_NFTS = 2000; // Maximum allowed number of NFTs uint32 public constant MAX_MYTHIC_NFTS = 50; // Maximum allowed number of Mythic NFTs uint8 public constant RARITY_COMMON = 1; uint8 public constant RARITY_RARE = 2; uint8 public constant RARITY_EPIC = 3; uint8 public constant RARITY_MYTHIC = 4; // Private variables string private _baseURI_; string private _contractURI; BitMaps.BitMap private _isRare; BitMaps.BitMap private _isEpic; BitMaps.BitMap private _isStaked; // tokenId => stake or not // We use 2 ranges of token IDs: // 0 - 49: Mythic NFTs // 50 - 1999: Normal NFTs uint256 private _nextTokenId; uint256 private _nextMythicTokenId; /// @notice Initializes a new instance of the Eve contract. /// @param defaultAdmin_ The address of the default admin /// @param defaultRoyalty_ The default royalty percentage /// @param baseURI_ The base URI for all NFTs /// @param contractURI_ The URI for the contract metadata constructor( address defaultAdmin_, uint96 defaultRoyalty_, string memory baseURI_, string memory contractURI_ ) ERC721("Eve", "DM01") DefaultOperatorFilterer() { if (defaultAdmin_ == address(0)) { revert Utils.AdminIsZeroAddress(); } _grantRole(DEFAULT_ADMIN_ROLE, defaultAdmin_); if (defaultRoyalty_ == 0) { revert Utils.RoyaltyIsZero(); } _setDefaultRoyalty(defaultAdmin_, defaultRoyalty_); _baseURI_ = baseURI_; _contractURI = contractURI_; _nextTokenId = MAX_MYTHIC_NFTS; } //------------------------------// // NFT Properties // //------------------------------// /// @notice Set the specified NFTs as rare /// @dev Only callable by DEFAULT_ADMIN_ROLE /// @param tokenIds_ An array of tokenIds function setRare( uint256[] calldata tokenIds_ ) external onlyRole(DEFAULT_ADMIN_ROLE) { for (uint256 i = 0; i < tokenIds_.length; ) { _isRare.set(tokenIds_[i]); unchecked { ++i; } } } /// @notice Set the specified NFTs as epic /// @dev Only callable by DEFAULT_ADMIN_ROLE /// @param tokenIds_ An array of tokenIds function setEpic( uint256[] calldata tokenIds_ ) external onlyRole(DEFAULT_ADMIN_ROLE) { for (uint256 i = 0; i < tokenIds_.length; ) { _isEpic.set(tokenIds_[i]); unchecked { ++i; } } } /// @notice Determines the rarity of the specified NFTs /// Should only be called off-chain /// @param tokenIds_ An array of tokenIds to check the rarity of /// @return results An array of rarities of the corresponding tokenIds function getRarities( uint256[] calldata tokenIds_ ) external view returns (uint8[] memory) { uint8[] memory results = new uint8[](tokenIds_.length); for (uint256 i = 0; i < tokenIds_.length; ) { if (_exists(tokenIds_[i])) { results[i] = tokenIds_[i] < MAX_MYTHIC_NFTS ? RARITY_MYTHIC : ( _isEpic.get(tokenIds_[i]) ? RARITY_EPIC : ( _isRare.get(tokenIds_[i]) ? RARITY_RARE : RARITY_COMMON ) ); } unchecked { ++i; } } return results; } //------------------// // Mint // //------------------// /// @dev Mints `tokenId_` and transfers it to `to_`. function _mint(address to_, uint256 tokenId_) internal override(ERC721) { if (totalSupply() >= MAX_NFTS) { revert Utils.NFTQuantityExceedsLimit(); } super._mint(to_, tokenId_); } /// @dev Safely mints a normal NFT and assigns it to the specified address. /// @notice This function can only be called by the contract itself. /// @param to_ The address to assign the minted NFT /// @return tokenId_ The unique token ID of the NFT function _mintNormal(address to_) internal returns (uint256) { if (_nextTokenId >= MAX_NFTS) { revert Utils.NFTQuantityExceedsLimit(); } uint256 tokenId = _nextTokenId; unchecked { ++_nextTokenId; } _mint(to_, tokenId); return tokenId; } /// @dev Safely mints a Mythic NFT and assigns it to the specified address. /// @notice This function can only be called by the contract itself. /// @param to_ The address to assign the minted NFT /// @return tokenId_ The unique token ID of the NFT function _mintMythic(address to_) internal returns (uint256) { if (_nextMythicTokenId >= MAX_MYTHIC_NFTS) { revert Utils.NFTQuantityExceedsLimit(); } uint256 tokenId = _nextMythicTokenId; unchecked { ++_nextMythicTokenId; } _mint(to_, tokenId); return tokenId; } /// @notice Mint a number of normal NFTs to an address /// @dev Only callable by MINTER_ROLE /// @param to_ The address to mint to /// @param quantity_ The quantity of NFTs to mint /// @return tokenIds An array containing the minted tokenIds function mintNormal( address to_, uint256 quantity_ ) external onlyRole(MINTER_ROLE) returns (uint256[] memory) { uint256[] memory tokenIds = new uint256[](quantity_); for (uint256 i = 0; i < quantity_; ) { tokenIds[i] = _mintNormal(to_); unchecked { ++i; } } return tokenIds; } /// @notice Mint a number of Mythic NFTs to an address /// @dev Only callable by MINTER_ROLE /// @param to_ The address to mint to /// @param quantity_ The quantity of Mythic NFTs to mint /// @return tokenIds An array containing the minted tokenIds function mintMythic( address to_, uint256 quantity_ ) external onlyRole(MINTER_ROLE) returns (uint256[] memory) { uint256[] memory tokenIds = new uint256[](quantity_); for (uint256 i = 0; i < quantity_; ) { tokenIds[i] = _mintMythic(to_); unchecked { ++i; } } return tokenIds; } /// @notice Allows developers to mint tokens for testing purposes. /// @param tos_ The addresses to mint to /// @param quantities_ The quantity of Mythic NFTs to mint for each address /// @param isMythics_ Indicate if the corresponding tokens are Mythic for each address function devMint( address[] calldata tos_, uint256[] calldata quantities_, bool[] calldata isMythics_ ) external onlyRole(DEFAULT_ADMIN_ROLE) { uint256 length = tos_.length; if (length != quantities_.length || length != isMythics_.length) { revert Utils.UnmatchedArrayLengths(); } unchecked { for (uint256 i = 0; i < length; ++i) { for (uint256 j = 0; j < quantities_[i]; ++j) { if (isMythics_[i]) { _mintMythic(tos_[i]); } else { _mintNormal(tos_[i]); } } } } } //------------------// // Stake // //------------------// /// @notice Stake specified NFTs /// @dev Only callable by STAKER_ROLE /// @param tokenIds_ An array of tokenIds to stake function stake( uint256[] calldata tokenIds_ ) external onlyRole(STAKER_ROLE) { if (tokenIds_.length == 0) { revert Utils.QuantityIsZero(); } for (uint256 i = 0; i < tokenIds_.length; ) { _isStaked.set(tokenIds_[i]); unchecked { ++i; } } } /// @notice Unstake specified NFTs /// @dev Only callable by STAKER_ROLE /// @param tokenIds_ An array of tokenIds to unstake function unstake( uint256[] calldata tokenIds_ ) external onlyRole(STAKER_ROLE) { if (tokenIds_.length == 0) { revert Utils.QuantityIsZero(); } for (uint256 i = 0; i < tokenIds_.length; ) { _isStaked.unset(tokenIds_[i]); unchecked { ++i; } } } /// @notice Check if the specified NFTs are staked /// @param tokenIds_ An array of tokenIds to check if they are staked /// @return results A boolean array indicating if the corresponding tokenId is staked function isStaked( uint256[] calldata tokenIds_ ) external view returns (bool[] memory) { bool[] memory results = new bool[](tokenIds_.length); for (uint256 i = 0; i < tokenIds_.length; ) { results[i] = _isStaked.get(tokenIds_[i]); unchecked { ++i; } } return results; } //------------------// // Custom overrides // //------------------// /// @dev See {IERC721Metadata-tokenURI}. function tokenURI( uint256 tokenId_ ) public view override(ERC721) returns (string memory) { _requireMinted(tokenId_); string memory __baseURI = _baseURI(); return bytes(__baseURI).length > 0 ? string( abi.encodePacked(__baseURI, tokenId_.toString(), ".json") ) : ""; } /// @dev Returns the base URI for all tokens. function _baseURI() internal view override returns (string memory) { return _baseURI_; } /// @dev Returns the base URI for all tokens. function baseURI() public view returns (string memory) { return _baseURI(); } /// @notice Set the base URI for the NFT metadata /// @dev Only callable by DEFAULT_ADMIN_ROLE /// @param baseURI_ The new base URI function setBaseURI( string calldata baseURI_ ) external onlyRole(DEFAULT_ADMIN_ROLE) { _baseURI_ = baseURI_; } /// @notice Sets the default royalty percentage for all tokens. /// @param receiver_ The address to receive the royalty payment. /// @param feeNumerator_ The royalty percentage, from 0 to 100000. function setDefaultRoyalty( address receiver_, uint96 feeNumerator_ ) external onlyRole(DEFAULT_ADMIN_ROLE) { _setDefaultRoyalty(receiver_, feeNumerator_); } /// @notice Checks if a token with the given ID exists. /// @param tokenId_ The token ID to query. function exists(uint256 tokenId_) external view returns (bool) { return _exists(tokenId_); } /// @notice Returns the next token ID that will be minted. function nextTokenId() external view returns (uint256) { return _nextTokenId; } /// @notice Returns the next Mythic token ID that will be minted. function nextMythicTokenId() external view returns (uint256) { return _nextMythicTokenId; } //--------------------------------------------------// // The following functions are required by Opensea. // //--------------------------------------------------// /// @notice Returns the contract metadata URI. function contractURI() public view returns (string memory) { return _contractURI; } /// @notice Set the contract URI /// @dev Only callable by DEFAULT_ADMIN_ROLE /// @param contractURI_ The new contract URI function setContractURI( string calldata contractURI_ ) external onlyRole(DEFAULT_ADMIN_ROLE) { _contractURI = contractURI_; } /// @dev Checks if the operator_ is a custom filtered operator. /// @param operator_ The operator to check. function _checkFilterOperatorCustom(address operator_) internal view { // Check registry code length to facilitate testing in environments without a deployed registry. if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) { if ( !OPERATOR_FILTER_REGISTRY.isOperatorAllowed( CUSTOM_SUBSCRIPTION, operator_ ) ) { revert OperatorNotAllowed(operator_); } } } /// @dev Modifier to allow function execution only by allowed operators with custom approvals defined at CUSTOM_SUBSCRIPTION. /// @param operator_ The operator to check. modifier onlyAllowedOperatorApprovalCustom(address operator_) { _checkFilterOperatorCustom(operator_); _; } /// @dev Modifier to allow function execution only by allowed operators. /// @param from_ The operator to check. modifier onlyAllowedOperatorCustom(address from_) { // 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) { _checkFilterOperatorCustom(msg.sender); } _; } /// @dev See {IERC721-setApprovalForAll}. function setApprovalForAll( address operator_, bool approved_ ) public override(IERC721, ERC721) onlyAllowedOperatorApproval(operator_) onlyAllowedOperatorApprovalCustom(operator_) { super.setApprovalForAll(operator_, approved_); } /// @dev See {IERC721-approve}. function approve( address operator_, uint256 tokenId_ ) public override(IERC721, ERC721) onlyAllowedOperatorApproval(operator_) onlyAllowedOperatorApprovalCustom(operator_) { super.approve(operator_, tokenId_); } /// @dev See {IERC721-transferFrom}. function transferFrom( address from_, address to_, uint256 tokenId_ ) public override(IERC721, ERC721) onlyAllowedOperator(from_) onlyAllowedOperatorCustom(from_) { super.transferFrom(from_, to_, tokenId_); } /// @dev See {IERC721-safeTransferFrom}. function safeTransferFrom( address from_, address to_, uint256 tokenId_ ) public override(IERC721, ERC721) onlyAllowedOperator(from_) onlyAllowedOperatorCustom(from_) { super.safeTransferFrom(from_, to_, tokenId_); } /// @dev See {IERC721-safeTransferFrom}. function safeTransferFrom( address from_, address to_, uint256 tokenId_, bytes memory data_ ) public override(IERC721, ERC721) onlyAllowedOperator(from_) onlyAllowedOperatorCustom(from_) { super.safeTransferFrom(from_, to_, tokenId_, data_); } //------------------------------------------------------------// // The following functions are for contract ownership // //------------------------------------------------------------// /// @notice Transfer ownership of the contract to a new account /// @dev Can only be called by the current owner /// @param newOwner_ The address of the new owner function transferOwnership( address newOwner_ ) public override(Ownable) onlyRole(DEFAULT_ADMIN_ROLE) { if (newOwner_ == address(0)) { revert Utils.TransferOwnershipToZeroAddress(); } _transferOwnership(newOwner_); } /// @notice Renounce ownership of the contract /// @dev Can only be called by the current owner function renounceOwnership() public override(Ownable) onlyRole(DEFAULT_ADMIN_ROLE) { _transferOwnership(address(0)); } //------------------------------------------------------------// // The following functions are for contract pause // //------------------------------------------------------------// /// @notice Pause the contract function pause() public onlyRole(DEFAULT_ADMIN_ROLE) { _pause(); } /// @notice Unpause the contract function unpause() public onlyRole(DEFAULT_ADMIN_ROLE) { _unpause(); } //------------------------------------------------------------// // The following functions are overrides required by Solidity.// //------------------------------------------------------------// /// @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is /// used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1. function _beforeTokenTransfer( address from_, address to_, uint256 firstTokenId_, uint256 batchSize_ ) internal override(ERC721, ERC721Enumerable) whenNotPaused { uint256 end = firstTokenId_ + batchSize_; for (uint256 tokenId = firstTokenId_; tokenId < end; ) { if (_isStaked.get(tokenId)) { revert Utils.TokenIsStaked(); } unchecked { ++tokenId; } } super._beforeTokenTransfer(from_, to_, firstTokenId_, batchSize_); } /// @dev See {IERC165-supportsInterface}. function supportsInterface( bytes4 interfaceId_ ) public view override(ERC721, ERC721Enumerable, AccessControl, ERC2981) returns (bool) { return interfaceId_ == type(IAccessControl).interfaceId || interfaceId_ == type(IERC165).interfaceId || interfaceId_ == type(IERC721).interfaceId || interfaceId_ == type(IERC721Metadata).interfaceId || interfaceId_ == type(IERC721Enumerable).interfaceId || interfaceId_ == type(IERC2981).interfaceId || super.supportsInterface(interfaceId_); } }
// SPDX-License-Identifier: Unlicense // Version 0.0.1 pragma solidity ^0.8.17; /** * @dev Collection of utility functions */ library Utils { /** * Default admin is zero address */ error AdminIsZeroAddress(); /** * Default owner is zero address */ error OwnerIsZeroAddress(); /** * Royalty is zero */ error RoyaltyIsZero(); /** * The signature is invalid */ error InvalidSignature(); /** * The number of NFTs exceeds the limit */ error NFTQuantityExceedsLimit(); /** * Transfer ownership to zero address */ error TransferOwnershipToZeroAddress(); /** * Unmatched Array lengths */ error UnmatchedArrayLengths(); /** * Contract does not exist at the address */ error ContractDoesNotExist(); /** * Staking Period Is Zero */ error StakingPeriodIsZero(); /** * Quantity Is Zero */ error QuantityIsZero(); /** * Allowed Quantity Is Zero */ error AllowedQuantityIsZero(); /** * Input quantity exceeds allowed quantity */ error ExceedsAllowedQuantity(); /** * The person is not whitelisted */ error NotWhitelisted(); /** * Token Already Staked */ error TokenAlreadyStaked(); /** * Not The Owner Of The Token */ error NotTheOwnerOfTheToken(); /** * Not enough staked Genesis Stones */ error NotEnoughStakedGenesisStones(); /** * Already Minted with the method */ error AlreadyMinted(); /** * Not Staked */ error NotStaked(); /** * Staking Not Completed */ error StakingNotCompleted(); /** * Invalid addrses */ error InvalidAddress(); /** * Token Is Staked */ error TokenIsStaked(); /** * Not A Mythic Stone */ error NotAMythicStone(); /** * Not A Normal Stone */ error NotANormalStone(); /** * Incorrect NFT Id */ error IncorrectNFTId(); /** * Incorrect Data */ error IncorrectData(); function contractExists(address addr) internal view returns (bool) { uint size; assembly { size := extcodesize(addr) } return (size > 0); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/structs/BitMaps.sol) pragma solidity ^0.8.0; /** * @dev Library for managing uint256 to bool mapping in a compact and efficient way, providing the keys are sequential. * Largely inspired by Uniswap's https://github.com/Uniswap/merkle-distributor/blob/master/contracts/MerkleDistributor.sol[merkle-distributor]. */ library BitMaps { struct BitMap { mapping(uint256 => uint256) _data; } /** * @dev Returns whether the bit at `index` is set. */ function get(BitMap storage bitmap, uint256 index) internal view returns (bool) { uint256 bucket = index >> 8; uint256 mask = 1 << (index & 0xff); return bitmap._data[bucket] & mask != 0; } /** * @dev Sets the bit at `index` to the boolean `value`. */ function setTo( BitMap storage bitmap, uint256 index, bool value ) internal { if (value) { set(bitmap, index); } else { unset(bitmap, index); } } /** * @dev Sets the bit at `index`. */ function set(BitMap storage bitmap, uint256 index) internal { uint256 bucket = index >> 8; uint256 mask = 1 << (index & 0xff); bitmap._data[bucket] |= mask; } /** * @dev Unsets the bit at `index`. */ function unset(BitMap storage bitmap, uint256 index) internal { uint256 bucket = index >> 8; uint256 mask = 1 << (index & 0xff); bitmap._data[bucket] &= ~mask; } }
// 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: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/cryptography/MerkleProof.sol) pragma solidity ^0.8.0; /** * @dev These functions deal with verification of Merkle Tree proofs. * * The tree and the proofs can be generated using our * https://github.com/OpenZeppelin/merkle-tree[JavaScript library]. * You will find a quickstart guide in the readme. * * WARNING: You should avoid using leaf values that are 64 bytes long prior to * hashing, or use a hash function other than keccak256 for hashing leaves. * This is because the concatenation of a sorted pair of internal nodes in * the merkle tree could be reinterpreted as a leaf value. * OpenZeppelin's JavaScript library generates merkle trees that are safe * against this attack out of the box. */ library MerkleProof { /** * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree * defined by `root`. For this, a `proof` must be provided, containing * sibling hashes on the branch from the leaf to the root of the tree. Each * pair of leaves and each pair of pre-images are assumed to be sorted. */ function verify( bytes32[] memory proof, bytes32 root, bytes32 leaf ) internal pure returns (bool) { return processProof(proof, leaf) == root; } /** * @dev Calldata version of {verify} * * _Available since v4.7._ */ function verifyCalldata( bytes32[] calldata proof, bytes32 root, bytes32 leaf ) internal pure returns (bool) { return processProofCalldata(proof, leaf) == root; } /** * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt * hash matches the root of the tree. When processing the proof, the pairs * of leafs & pre-images are assumed to be sorted. * * _Available since v4.4._ */ function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { computedHash = _hashPair(computedHash, proof[i]); } return computedHash; } /** * @dev Calldata version of {processProof} * * _Available since v4.7._ */ function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { computedHash = _hashPair(computedHash, proof[i]); } return computedHash; } /** * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a merkle tree defined by * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}. * * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details. * * _Available since v4.7._ */ function multiProofVerify( bytes32[] memory proof, bool[] memory proofFlags, bytes32 root, bytes32[] memory leaves ) internal pure returns (bool) { return processMultiProof(proof, proofFlags, leaves) == root; } /** * @dev Calldata version of {multiProofVerify} * * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details. * * _Available since v4.7._ */ function multiProofVerifyCalldata( bytes32[] calldata proof, bool[] calldata proofFlags, bytes32 root, bytes32[] memory leaves ) internal pure returns (bool) { return processMultiProofCalldata(proof, proofFlags, leaves) == root; } /** * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false * respectively. * * CAUTION: Not all merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer). * * _Available since v4.7._ */ function processMultiProof( bytes32[] memory proof, bool[] memory proofFlags, bytes32[] memory leaves ) internal pure returns (bytes32 merkleRoot) { // This function rebuild the root hash by traversing the tree up from the leaves. The root is rebuilt by // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of // the merkle tree. uint256 leavesLen = leaves.length; uint256 totalHashes = proofFlags.length; // Check proof validity. require(leavesLen + proof.length - 1 == totalHashes, "MerkleProof: invalid multiproof"); // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop". bytes32[] memory hashes = new bytes32[](totalHashes); uint256 leafPos = 0; uint256 hashPos = 0; uint256 proofPos = 0; // At each step, we compute the next hash using two values: // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we // get the next hash. // - depending on the flag, either another value for the "main queue" (merging branches) or an element from the // `proof` array. for (uint256 i = 0; i < totalHashes; i++) { bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]; bytes32 b = proofFlags[i] ? leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++] : proof[proofPos++]; hashes[i] = _hashPair(a, b); } if (totalHashes > 0) { return hashes[totalHashes - 1]; } else if (leavesLen > 0) { return leaves[0]; } else { return proof[0]; } } /** * @dev Calldata version of {processMultiProof}. * * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details. * * _Available since v4.7._ */ function processMultiProofCalldata( bytes32[] calldata proof, bool[] calldata proofFlags, bytes32[] memory leaves ) internal pure returns (bytes32 merkleRoot) { // This function rebuild the root hash by traversing the tree up from the leaves. The root is rebuilt by // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of // the merkle tree. uint256 leavesLen = leaves.length; uint256 totalHashes = proofFlags.length; // Check proof validity. require(leavesLen + proof.length - 1 == totalHashes, "MerkleProof: invalid multiproof"); // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop". bytes32[] memory hashes = new bytes32[](totalHashes); uint256 leafPos = 0; uint256 hashPos = 0; uint256 proofPos = 0; // At each step, we compute the next hash using two values: // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we // get the next hash. // - depending on the flag, either another value for the "main queue" (merging branches) or an element from the // `proof` array. for (uint256 i = 0; i < totalHashes; i++) { bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]; bytes32 b = proofFlags[i] ? leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++] : proof[proofPos++]; hashes[i] = _hashPair(a, b); } if (totalHashes > 0) { return hashes[totalHashes - 1]; } else if (leavesLen > 0) { return leaves[0]; } else { return proof[0]; } } function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) { return a < b ? _efficientHash(a, b) : _efficientHash(b, a); } function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) { /// @solidity memory-safe-assembly assembly { mstore(0x00, a) mstore(0x20, b) value := keccak256(0x00, 0x40) } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.13; import {OperatorFilterer} from "./OperatorFilterer.sol"; /** * @title DefaultOperatorFilterer * @notice Inherits from OperatorFilterer and automatically subscribes to the default OpenSea subscription. */ abstract contract DefaultOperatorFilterer is OperatorFilterer { address constant DEFAULT_SUBSCRIPTION = address(0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6); constructor() OperatorFilterer(DEFAULT_SUBSCRIPTION, true) {} }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/extensions/ERC721Burnable.sol) pragma solidity ^0.8.0; import "../ERC721.sol"; import "../../../utils/Context.sol"; /** * @title ERC721 Burnable Token * @dev ERC721 Token that can be burned (destroyed). */ abstract contract ERC721Burnable is Context, ERC721 { /** * @dev Burns `tokenId`. See {ERC721-_burn}. * * Requirements: * * - The caller must own `tokenId` or be an approved operator. */ function burn(uint256 tokenId) public virtual { //solhint-disable-next-line max-line-length require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved"); _burn(tokenId); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/extensions/ERC721Enumerable.sol) pragma solidity ^0.8.0; import "../ERC721.sol"; import "./IERC721Enumerable.sol"; /** * @dev This implements an optional extension of {ERC721} defined in the EIP that adds * enumerability of all the token ids in the contract as well as all token ids owned by each * account. */ abstract contract ERC721Enumerable is ERC721, IERC721Enumerable { // Mapping from owner to list of owned token IDs mapping(address => mapping(uint256 => uint256)) private _ownedTokens; // Mapping from token ID to index of the owner tokens list mapping(uint256 => uint256) private _ownedTokensIndex; // Array with all token ids, used for enumeration uint256[] private _allTokens; // Mapping from token id to position in the allTokens array mapping(uint256 => uint256) private _allTokensIndex; /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC721) returns (bool) { return interfaceId == type(IERC721Enumerable).interfaceId || super.supportsInterface(interfaceId); } /** * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}. */ function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual override returns (uint256) { require(index < ERC721.balanceOf(owner), "ERC721Enumerable: owner index out of bounds"); return _ownedTokens[owner][index]; } /** * @dev See {IERC721Enumerable-totalSupply}. */ function totalSupply() public view virtual override returns (uint256) { return _allTokens.length; } /** * @dev See {IERC721Enumerable-tokenByIndex}. */ function tokenByIndex(uint256 index) public view virtual override returns (uint256) { require(index < ERC721Enumerable.totalSupply(), "ERC721Enumerable: global index out of bounds"); return _allTokens[index]; } /** * @dev See {ERC721-_beforeTokenTransfer}. */ function _beforeTokenTransfer( address from, address to, uint256 firstTokenId, uint256 batchSize ) internal virtual override { super._beforeTokenTransfer(from, to, firstTokenId, batchSize); if (batchSize > 1) { // Will only trigger during construction. Batch transferring (minting) is not available afterwards. revert("ERC721Enumerable: consecutive transfers not supported"); } uint256 tokenId = firstTokenId; if (from == address(0)) { _addTokenToAllTokensEnumeration(tokenId); } else if (from != to) { _removeTokenFromOwnerEnumeration(from, tokenId); } if (to == address(0)) { _removeTokenFromAllTokensEnumeration(tokenId); } else if (to != from) { _addTokenToOwnerEnumeration(to, tokenId); } } /** * @dev Private function to add a token to this extension's ownership-tracking data structures. * @param to address representing the new owner of the given token ID * @param tokenId uint256 ID of the token to be added to the tokens list of the given address */ function _addTokenToOwnerEnumeration(address to, uint256 tokenId) private { uint256 length = ERC721.balanceOf(to); _ownedTokens[to][length] = tokenId; _ownedTokensIndex[tokenId] = length; } /** * @dev Private function to add a token to this extension's token tracking data structures. * @param tokenId uint256 ID of the token to be added to the tokens list */ function _addTokenToAllTokensEnumeration(uint256 tokenId) private { _allTokensIndex[tokenId] = _allTokens.length; _allTokens.push(tokenId); } /** * @dev Private function to remove a token from this extension's ownership-tracking data structures. Note that * while the token is not assigned a new owner, the `_ownedTokensIndex` mapping is _not_ updated: this allows for * gas optimizations e.g. when performing a transfer operation (avoiding double writes). * This has O(1) time complexity, but alters the order of the _ownedTokens array. * @param from address representing the previous owner of the given token ID * @param tokenId uint256 ID of the token to be removed from the tokens list of the given address */ function _removeTokenFromOwnerEnumeration(address from, uint256 tokenId) private { // To prevent a gap in from's tokens array, we store the last token in the index of the token to delete, and // then delete the last slot (swap and pop). uint256 lastTokenIndex = ERC721.balanceOf(from) - 1; uint256 tokenIndex = _ownedTokensIndex[tokenId]; // When the token to delete is the last token, the swap operation is unnecessary if (tokenIndex != lastTokenIndex) { uint256 lastTokenId = _ownedTokens[from][lastTokenIndex]; _ownedTokens[from][tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token _ownedTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index } // This also deletes the contents at the last position of the array delete _ownedTokensIndex[tokenId]; delete _ownedTokens[from][lastTokenIndex]; } /** * @dev Private function to remove a token from this extension's token tracking data structures. * This has O(1) time complexity, but alters the order of the _allTokens array. * @param tokenId uint256 ID of the token to be removed from the tokens list */ function _removeTokenFromAllTokensEnumeration(uint256 tokenId) private { // To prevent a gap in the tokens array, we store the last token in the index of the token to delete, and // then delete the last slot (swap and pop). uint256 lastTokenIndex = _allTokens.length - 1; uint256 tokenIndex = _allTokensIndex[tokenId]; // When the token to delete is the last token, the swap operation is unnecessary. However, since this occurs so // rarely (when the last minted token is burnt) that we still do the swap here to avoid the gas cost of adding // an 'if' statement (like in _removeTokenFromOwnerEnumeration) uint256 lastTokenId = _allTokens[lastTokenIndex]; _allTokens[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token _allTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index // This also deletes the contents at the last position of the array delete _allTokensIndex[tokenId]; _allTokens.pop(); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/ERC721.sol) pragma solidity ^0.8.0; import "./IERC721.sol"; import "./IERC721Receiver.sol"; import "./extensions/IERC721Metadata.sol"; import "../../utils/Address.sol"; import "../../utils/Context.sol"; import "../../utils/Strings.sol"; import "../../utils/introspection/ERC165.sol"; /** * @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 is Context, ERC165, IERC721, IERC721Metadata { using Address for address; using Strings for uint256; // Token name string private _name; // Token symbol string private _symbol; // Mapping from token ID to owner address mapping(uint256 => address) private _owners; // 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 = _ownerOf(tokenId); 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.ownerOf(tokenId); require(to != owner, "ERC721: approval to current owner"); require( _msgSender() == owner || isApprovedForAll(owner, _msgSender()), "ERC721: approve caller is not token owner or 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 or 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 or 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 the owner of the `tokenId`. Does NOT revert if token doesn't exist */ function _ownerOf(uint256 tokenId) internal view virtual returns (address) { return _owners[tokenId]; } /** * @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 _ownerOf(tokenId) != 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.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, 1); // Check that tokenId was not minted by `_beforeTokenTransfer` hook require(!_exists(tokenId), "ERC721: token already minted"); unchecked { // Will not overflow unless all 2**256 token ids are minted to the same owner. // Given that tokens are minted one by one, it is impossible in practice that // this ever happens. Might change if we allow batch minting. // The ERC fails to describe this case. _balances[to] += 1; } _owners[tokenId] = to; emit Transfer(address(0), to, tokenId); _afterTokenTransfer(address(0), to, tokenId, 1); } /** * @dev Destroys `tokenId`. * The approval is cleared when the token is burned. * This is an internal function that does not check if the sender is authorized to operate on the token. * * Requirements: * * - `tokenId` must exist. * * Emits a {Transfer} event. */ function _burn(uint256 tokenId) internal virtual { address owner = ERC721.ownerOf(tokenId); _beforeTokenTransfer(owner, address(0), tokenId, 1); // Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook owner = ERC721.ownerOf(tokenId); // Clear approvals delete _tokenApprovals[tokenId]; unchecked { // Cannot overflow, as that would require more tokens to be burned/transferred // out than the owner initially received through minting and transferring in. _balances[owner] -= 1; } delete _owners[tokenId]; emit Transfer(owner, address(0), tokenId); _afterTokenTransfer(owner, address(0), tokenId, 1); } /** * @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.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner"); require(to != address(0), "ERC721: transfer to the zero address"); _beforeTokenTransfer(from, to, tokenId, 1); // Check that tokenId was not transferred by `_beforeTokenTransfer` hook require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner"); // Clear approvals from the previous owner delete _tokenApprovals[tokenId]; unchecked { // `_balances[from]` cannot overflow for the same reason as described in `_burn`: // `from`'s balance is the number of token held, which is at least one before the current // transfer. // `_balances[to]` could overflow in the conditions described in `_mint`. That would require // all 2**256 token ids to be minted, which in practice is impossible. _balances[from] -= 1; _balances[to] += 1; } _owners[tokenId] = to; emit Transfer(from, to, tokenId); _afterTokenTransfer(from, to, tokenId, 1); } /** * @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.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. If {ERC721Consecutive} is * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1. * * Calling conditions: * * - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`. * - When `from` is zero, the tokens will be minted for `to`. * - When `to` is zero, ``from``'s tokens will be burned. * - `from` and `to` are never both zero. * - `batchSize` is non-zero. * * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks]. */ function _beforeTokenTransfer( address from, address to, uint256, /* firstTokenId */ uint256 batchSize ) internal virtual { if (batchSize > 1) { if (from != address(0)) { _balances[from] -= batchSize; } if (to != address(0)) { _balances[to] += batchSize; } } } /** * @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is * used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1. * * Calling conditions: * * - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`. * - When `from` is zero, the tokens were minted for `to`. * - When `to` is zero, ``from``'s tokens were burned. * - `from` and `to` are never both zero. * - `batchSize` is non-zero. * * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks]. */ function _afterTokenTransfer( address from, address to, uint256 firstTokenId, uint256 batchSize ) internal virtual {} }
// 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.8.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: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721 * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must * understand this adds an external call which potentially creates a reentrancy vulnerability. * * 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.8.0) (utils/cryptography/ECDSA.sol) pragma solidity ^0.8.0; import "../Strings.sol"; /** * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations. * * These functions can be used to verify that a message was signed by the holder * of the private keys of a given address. */ library ECDSA { enum RecoverError { NoError, InvalidSignature, InvalidSignatureLength, InvalidSignatureS, InvalidSignatureV // Deprecated in v4.8 } function _throwError(RecoverError error) private pure { if (error == RecoverError.NoError) { return; // no error: do nothing } else if (error == RecoverError.InvalidSignature) { revert("ECDSA: invalid signature"); } else if (error == RecoverError.InvalidSignatureLength) { revert("ECDSA: invalid signature length"); } else if (error == RecoverError.InvalidSignatureS) { revert("ECDSA: invalid signature 's' value"); } } /** * @dev Returns the address that signed a hashed message (`hash`) with * `signature` or error string. This address can then be used for verification purposes. * * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures: * this function rejects them by requiring the `s` value to be in the lower * half order, and the `v` value to be either 27 or 28. * * IMPORTANT: `hash` _must_ be the result of a hash operation for the * verification to be secure: it is possible to craft signatures that * recover to arbitrary addresses for non-hashed data. A safe way to ensure * this is by receiving a hash of the original message (which may otherwise * be too long), and then calling {toEthSignedMessageHash} on it. * * Documentation for signature generation: * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js] * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers] * * _Available since v4.3._ */ function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) { if (signature.length == 65) { bytes32 r; bytes32 s; uint8 v; // ecrecover takes the signature parameters, and the only way to get them // currently is to use assembly. /// @solidity memory-safe-assembly assembly { r := mload(add(signature, 0x20)) s := mload(add(signature, 0x40)) v := byte(0, mload(add(signature, 0x60))) } return tryRecover(hash, v, r, s); } else { return (address(0), RecoverError.InvalidSignatureLength); } } /** * @dev Returns the address that signed a hashed message (`hash`) with * `signature`. This address can then be used for verification purposes. * * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures: * this function rejects them by requiring the `s` value to be in the lower * half order, and the `v` value to be either 27 or 28. * * IMPORTANT: `hash` _must_ be the result of a hash operation for the * verification to be secure: it is possible to craft signatures that * recover to arbitrary addresses for non-hashed data. A safe way to ensure * this is by receiving a hash of the original message (which may otherwise * be too long), and then calling {toEthSignedMessageHash} on it. */ function recover(bytes32 hash, bytes memory signature) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, signature); _throwError(error); return recovered; } /** * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately. * * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures] * * _Available since v4.3._ */ function tryRecover( bytes32 hash, bytes32 r, bytes32 vs ) internal pure returns (address, RecoverError) { bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff); uint8 v = uint8((uint256(vs) >> 255) + 27); return tryRecover(hash, v, r, s); } /** * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately. * * _Available since v4.2._ */ function recover( bytes32 hash, bytes32 r, bytes32 vs ) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, r, vs); _throwError(error); return recovered; } /** * @dev Overload of {ECDSA-tryRecover} that receives the `v`, * `r` and `s` signature fields separately. * * _Available since v4.3._ */ function tryRecover( bytes32 hash, uint8 v, bytes32 r, bytes32 s ) internal pure returns (address, RecoverError) { // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most // signatures from current libraries generate a unique signature with an s-value in the lower half order. // // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept // these malleable signatures as well. if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) { return (address(0), RecoverError.InvalidSignatureS); } // If the signature is valid (and not malleable), return the signer address address signer = ecrecover(hash, v, r, s); if (signer == address(0)) { return (address(0), RecoverError.InvalidSignature); } return (signer, RecoverError.NoError); } /** * @dev Overload of {ECDSA-recover} that receives the `v`, * `r` and `s` signature fields separately. */ function recover( bytes32 hash, uint8 v, bytes32 r, bytes32 s ) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, v, r, s); _throwError(error); return recovered; } /** * @dev Returns an Ethereum Signed Message, created from a `hash`. This * produces hash corresponding to the one signed with the * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] * JSON-RPC method as part of EIP-191. * * See {recover}. */ function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) { // 32 is the length in bytes of hash, // enforced by the type signature above return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash)); } /** * @dev Returns an Ethereum Signed Message, created from `s`. This * produces hash corresponding to the one signed with the * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] * JSON-RPC method as part of EIP-191. * * See {recover}. */ function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) { return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", Strings.toString(s.length), s)); } /** * @dev Returns an Ethereum Signed Typed Data, created from a * `domainSeparator` and a `structHash`. This produces hash corresponding * to the one signed with the * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`] * JSON-RPC method as part of EIP-712. * * See {recover}. */ function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) { return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash)); } }
// 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 // 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.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/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.13; import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.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. */ abstract contract OperatorFilterer { error OperatorNotAllowed(address operator); IOperatorFilterRegistry public constant OPERATOR_FILTER_REGISTRY = IOperatorFilterRegistry(0x000000000000AAeB6D7670E522A718067333cd4E); 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)); } } } } 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); } _; } modifier onlyAllowedOperatorApproval(address operator) virtual { _checkFilterOperator(operator); _; } 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) { if (!OPERATOR_FILTER_REGISTRY.isOperatorAllowed(address(this), operator)) { revert OperatorNotAllowed(operator); } } } }
// 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 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.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 (last updated v4.5.0) (token/ERC721/extensions/IERC721Enumerable.sol) pragma solidity ^0.8.0; import "../IERC721.sol"; /** * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension * @dev See https://eips.ethereum.org/EIPS/eip-721 */ interface IERC721Enumerable is IERC721 { /** * @dev Returns the total amount of tokens stored by the contract. */ function totalSupply() external view returns (uint256); /** * @dev Returns a token ID owned by `owner` at a given `index` of its token list. * Use along with {balanceOf} to enumerate all of ``owner``'s tokens. */ function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256); /** * @dev Returns a token ID at a given `index` of all the tokens stored by the contract. * Use along with {totalSupply} to enumerate all tokens. */ function tokenByIndex(uint256 index) 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 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 (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 (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 pragma solidity ^0.8.13; interface IOperatorFilterRegistry { function isOperatorAllowed(address registrant, address operator) external view returns (bool); function register(address registrant) external; function registerAndSubscribe(address registrant, address subscription) external; function registerAndCopyEntries(address registrant, address registrantToCopy) external; function unregister(address addr) external; function updateOperator(address registrant, address operator, bool filtered) external; function updateOperators(address registrant, address[] calldata operators, bool filtered) external; function updateCodeHash(address registrant, bytes32 codehash, bool filtered) external; function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external; function subscribe(address registrant, address registrantToSubscribe) external; function unsubscribe(address registrant, bool copyExistingEntries) external; function subscriptionOf(address addr) external returns (address registrant); function subscribers(address registrant) external returns (address[] memory); function subscriberAt(address registrant, uint256 index) external returns (address); function copyEntriesOf(address registrant, address registrantToCopy) external; function isOperatorFiltered(address registrant, address operator) external returns (bool); function isCodeHashOfFiltered(address registrant, address operatorWithCode) external returns (bool); function isCodeHashFiltered(address registrant, bytes32 codeHash) external returns (bool); function filteredOperators(address addr) external returns (address[] memory); function filteredCodeHashes(address addr) external returns (bytes32[] memory); function filteredOperatorAt(address registrant, uint256 index) external returns (address); function filteredCodeHashAt(address registrant, uint256 index) external returns (bytes32); function isRegistered(address addr) external returns (bool); function codeHashOf(address addr) external returns (bytes32); }
// 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); } } }
{ "optimizer": { "enabled": true, "runs": 800 }, "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } } }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[{"internalType":"address","name":"defaultAdmin_","type":"address"},{"internalType":"uint96","name":"defaultRoyalty_","type":"uint96"},{"internalType":"string","name":"baseURI_","type":"string"},{"internalType":"string","name":"contractURI_","type":"string"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AdminIsZeroAddress","type":"error"},{"inputs":[],"name":"NFTQuantityExceedsLimit","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"OperatorNotAllowed","type":"error"},{"inputs":[],"name":"QuantityIsZero","type":"error"},{"inputs":[],"name":"RoyaltyIsZero","type":"error"},{"inputs":[],"name":"TokenIsStaked","type":"error"},{"inputs":[],"name":"TransferOwnershipToZeroAddress","type":"error"},{"inputs":[],"name":"UnmatchedArrayLengths","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":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","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":"CUSTOM_SUBSCRIPTION","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_MYTHIC_NFTS","outputs":[{"internalType":"uint32","name":"","type":"uint32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_NFTS","outputs":[{"internalType":"uint32","name":"","type":"uint32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MINTER_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":[],"name":"RARITY_COMMON","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"RARITY_EPIC","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"RARITY_MYTHIC","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"RARITY_RARE","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"STAKER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"operator_","type":"address"},{"internalType":"uint256","name":"tokenId_","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"contractURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"tos_","type":"address[]"},{"internalType":"uint256[]","name":"quantities_","type":"uint256[]"},{"internalType":"bool[]","name":"isMythics_","type":"bool[]"}],"name":"devMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId_","type":"uint256"}],"name":"exists","outputs":[{"internalType":"bool","name":"","type":"bool"}],"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":"uint256[]","name":"tokenIds_","type":"uint256[]"}],"name":"getRarities","outputs":[{"internalType":"uint8[]","name":"","type":"uint8[]"}],"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":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","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":"uint256[]","name":"tokenIds_","type":"uint256[]"}],"name":"isStaked","outputs":[{"internalType":"bool[]","name":"","type":"bool[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to_","type":"address"},{"internalType":"uint256","name":"quantity_","type":"uint256"}],"name":"mintMythic","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to_","type":"address"},{"internalType":"uint256","name":"quantity_","type":"uint256"}],"name":"mintNormal","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nextMythicTokenId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nextTokenId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"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":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","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":"nonpayable","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":"nonpayable","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":"baseURI_","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"contractURI_","type":"string"}],"name":"setContractURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"receiver_","type":"address"},{"internalType":"uint96","name":"feeNumerator_","type":"uint96"}],"name":"setDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds_","type":"uint256[]"}],"name":"setEpic","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds_","type":"uint256[]"}],"name":"setRare","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds_","type":"uint256[]"}],"name":"stake","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":"uint256","name":"index","type":"uint256"}],"name":"tokenByIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"tokenOfOwnerByIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"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":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner_","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds_","type":"uint256[]"}],"name":"unstake","outputs":[],"stateMutability":"nonpayable","type":"function"}]
Contract Creation Code
60806040523480156200001157600080fd5b506040516200401538038062004015833981016040819052620000349162000574565b733cc6cdda760b79bafa08df41ecfa224f810dceb660016040518060400160405280600381526020016245766560e81b81525060405180604001604052806004815260200163444d303160e01b8152508160009081620000959190620006ae565b506001620000a48282620006ae565b505050620000c1620000bb620002af60201b60201c565b620002b3565b600b805460ff60a01b191690556daaeb6d7670e522a718067333cd4e3b15620002135780156200016157604051633e9f1edf60e11b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e90637d3e3dbe906044015b600060405180830381600087803b1580156200014257600080fd5b505af115801562000157573d6000803e3d6000fd5b5050505062000213565b6001600160a01b03821615620001b25760405163a0af290360e01b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e9063a0af29039060440162000127565b604051632210724360e11b81523060048201526daaeb6d7670e522a718067333cd4e90634420e48690602401600060405180830381600087803b158015620001f957600080fd5b505af11580156200020e573d6000803e3d6000fd5b505050505b50506001600160a01b0384166200023d5760405163790fe1a560e01b815260040160405180910390fd5b6200024a60008562000305565b826001600160601b031660000362000275576040516315d2dbc160e01b815260040160405180910390fd5b620002818484620003aa565b600e6200028f8382620006ae565b50600f6200029e8282620006ae565b50506032601355506200077a915050565b3390565b600b80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6000828152600a602090815260408083206001600160a01b038516845290915290205460ff16620003a6576000828152600a602090815260408083206001600160a01b03851684529091529020805460ff19166001179055620003653390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45b5050565b6127106001600160601b03821611156200041e5760405162461bcd60e51b815260206004820152602a60248201527f455243323938313a20726f79616c7479206665652077696c6c206578636565646044820152692073616c65507269636560b01b60648201526084015b60405180910390fd5b6001600160a01b038216620004765760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c696420726563656976657200000000000000604482015260640162000415565b604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600c55565b634e487b7160e01b600052604160045260246000fd5b600082601f830112620004d757600080fd5b81516001600160401b0380821115620004f457620004f4620004af565b604051601f8301601f19908116603f011681019082821181831017156200051f576200051f620004af565b816040528381526020925086838588010111156200053c57600080fd5b600091505b8382101562000560578582018301518183018401529082019062000541565b600093810190920192909252949350505050565b600080600080608085870312156200058b57600080fd5b84516001600160a01b0381168114620005a357600080fd5b60208601519094506001600160601b0381168114620005c157600080fd5b60408601519093506001600160401b0380821115620005df57600080fd5b620005ed88838901620004c5565b935060608701519150808211156200060457600080fd5b506200061387828801620004c5565b91505092959194509250565b600181811c908216806200063457607f821691505b6020821081036200065557634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115620006a957600081815260208120601f850160051c81016020861015620006845750805b601f850160051c820191505b81811015620006a55782815560010162000690565b5050505b505050565b81516001600160401b03811115620006ca57620006ca620004af565b620006e281620006db84546200061f565b846200065b565b602080601f8311600181146200071a5760008415620007015750858301515b600019600386901b1c1916600185901b178555620006a5565b600085815260208120601f198616915b828110156200074b578886015182559484019460019091019084016200072a565b50858210156200076a5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b61388b806200078a6000396000f3fe608060405234801561001057600080fd5b50600436106103825760003560e01c80636352211e116101de5780639330d3be1161010f578063c1a54ab5116100ad578063e449f3411161007c578063e449f341146107df578063e8a3d485146107f2578063e985e9c5146107fa578063f2fde38b1461083657600080fd5b8063c1a54ab51461077f578063c87b56dd14610792578063d5391393146107a5578063d547741f146107cc57600080fd5b80639e94bb93116100e95780639e94bb9314610749578063a217fddf14610751578063a22cb46514610759578063b88d4fde1461076c57600080fd5b80639330d3be14610713578063938e3d7b1461072e57806395d89b411461074157600080fd5b806375794a3c1161017c5780638456cb59116101565780638456cb59146106a15780638da5cb5b146106a95780638deda96b146106ba57806391d14854146106da57600080fd5b806375794a3c146106715780637aad87891461067957806382ca466e1461068157600080fd5b806370a08231116101b857806370a0823114610623578063715018a61461063657806371b9faf71461063e5780637493c19f1461065e57600080fd5b80636352211e146105f557806368a437b3146106085780636c0360eb1461061b57600080fd5b80632f2ff15d116102b857806341f43434116102565780634f558e79116102305780634f558e79146105aa5780634f6ccce7146105bd57806355f804b3146105d05780635c975abb146105e357600080fd5b806341f434341461056f57806342842e0e1461058457806342966c681461059757600080fd5b806336568abe1161029257806336568abe146105255780633780b3ed1461053857806338062de81461055f5780633f4ba83a1461056757600080fd5b80632f2ff15d146104f75780632f745c591461050a578063357730291461051d57600080fd5b8063095ea7b31161032557806323b872dd116102ff57806323b872dd14610487578063248a9ca31461049a5780632a55205a146104bd5780632b6de39a146104ef57600080fd5b8063095ea7b31461044f5780630fbf0a931461046257806318160ddd1461047557600080fd5b806306fdde031161036157806306fdde03146103de578063081812fc146103f3578063084849c31461041e578063093d8c641461043157600080fd5b8062c84c201461038757806301ffc9a7146103a657806304634d8d146103c9575b600080fd5b61038f600381565b60405160ff90911681526020015b60405180910390f35b6103b96103b4366004612f84565b610849565b604051901515815260200161039d565b6103dc6103d7366004612fbd565b6108fb565b005b6103e6610915565b60405161039d9190613055565b610406610401366004613068565b6109a7565b6040516001600160a01b03909116815260200161039d565b6103dc61042c3660046130c6565b6109ce565b61043a6107d081565b60405163ffffffff909116815260200161039d565b6103dc61045d366004613108565b610a1e565b6103dc6104703660046130c6565b610a3c565b6008545b60405190815260200161039d565b6103dc610495366004613132565b610ac7565b6104796104a8366004613068565b6000908152600a602052604090206001015490565b6104d06104cb36600461316e565b610b0d565b604080516001600160a01b03909316835260208301919091520161039d565b61038f600481565b6103dc610505366004613190565b610bca565b610479610518366004613108565b610bef565b61043a603281565b6103dc610533366004613190565b610c9c565b6104797fb9e206fa2af7ee1331b72ce58b6d938ac810ce9b5cdb65d35ab723fd67badf9e81565b601454610479565b6103dc610d28565b6104066daaeb6d7670e522a718067333cd4e81565b6103dc610592366004613132565b610d3e565b6103dc6105a5366004613068565b610d7d565b6103b96105b8366004613068565b610df3565b6104796105cb366004613068565b610e12565b6103dc6105de3660046131bc565b610eb6565b600b54600160a01b900460ff166103b9565b610406610603366004613068565b610ece565b6103dc6106163660046130c6565b610f33565b6103e6610f7d565b61047961063136600461322e565b610f8c565b6103dc611026565b61065161064c3660046130c6565b61103b565b60405161039d9190613249565b6103dc61066c366004613290565b61119c565b601354610479565b61038f600181565b61069461068f3660046130c6565b6112b1565b60405161039d919061332a565b6103dc61135b565b600b546001600160a01b0316610406565b6106cd6106c8366004613108565b61136e565b60405161039d9190613364565b6103b96106e8366004613190565b6000918252600a602090815260408084206001600160a01b0393909316845291905290205460ff1690565b610406736438fa583f5f60e37dcd969d87a515b2b84c421981565b6103dc61073c3660046131bc565b611423565b6103e661143b565b61038f600281565b610479600081565b6103dc6107673660046133aa565b61144a565b6103dc61077a3660046133ec565b611468565b6106cd61078d366004613108565b6114b0565b6103e66107a0366004613068565b61155c565b6104797f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a681565b6103dc6107da366004613190565b6115c3565b6103dc6107ed3660046130c6565b6115e8565b6103e6611673565b6103b96108083660046134c8565b6001600160a01b03918216600090815260056020908152604080832093909416825291909152205460ff1690565b6103dc61084436600461322e565b611682565b60006001600160e01b03198216637965db0b60e01b148061087a57506001600160e01b031982166301ffc9a760e01b145b8061089557506001600160e01b031982166380ac58cd60e01b145b806108b057506001600160e01b03198216635b5e139f60e01b145b806108cb57506001600160e01b0319821663780e9d6360e01b145b806108e657506001600160e01b0319821663152a902d60e11b145b806108f557506108f5826116bd565b92915050565b6000610906816116e2565b61091083836116ec565b505050565b606060008054610924906134f2565b80601f0160208091040260200160405190810160405280929190818152602001828054610950906134f2565b801561099d5780601f106109725761010080835404028352916020019161099d565b820191906000526020600020905b81548152906001019060200180831161098057829003601f168201915b5050505050905090565b60006109b282611806565b506000908152600460205260409020546001600160a01b031690565b60006109d9816116e2565b60005b82811015610a1857610a108484838181106109f9576109f961352c565b90506020020135601161186a90919063ffffffff16565b6001016109dc565b50505050565b81610a2881611893565b82610a328161194d565b610a1884846119b6565b7fb9e206fa2af7ee1331b72ce58b6d938ac810ce9b5cdb65d35ab723fd67badf9e610a66816116e2565b6000829003610a885760405163794bd20360e11b815260040160405180910390fd5b60005b82811015610a1857610abf848483818110610aa857610aa861352c565b90506020020135601261186a90919063ffffffff16565b600101610a8b565b826001600160a01b0381163314610ae157610ae133611893565b836001600160a01b0381163314610afb57610afb3361194d565b610b06858585611ac6565b5050505050565b6000828152600d602090815260408083208151808301909252546001600160a01b038116808352600160a01b9091046bffffffffffffffffffffffff16928201929092528291610b8c575060408051808201909152600c546001600160a01b0381168252600160a01b90046bffffffffffffffffffffffff1660208201525b602081015160009061271090610bb0906bffffffffffffffffffffffff1687613558565b610bba919061356f565b91519350909150505b9250929050565b6000828152600a6020526040902060010154610be5816116e2565b6109108383611b3c565b6000610bfa83610f8c565b8210610c735760405162461bcd60e51b815260206004820152602b60248201527f455243373231456e756d657261626c653a206f776e657220696e646578206f7560448201527f74206f6620626f756e647300000000000000000000000000000000000000000060648201526084015b60405180910390fd5b506001600160a01b03919091166000908152600660209081526040808320938352929052205490565b6001600160a01b0381163314610d1a5760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201527f20726f6c657320666f722073656c6600000000000000000000000000000000006064820152608401610c6a565b610d248282611bde565b5050565b6000610d33816116e2565b610d3b611c61565b50565b826001600160a01b0381163314610d5857610d5833611893565b836001600160a01b0381163314610d7257610d723361194d565b610b06858585611cb6565b610d88335b82611cd1565b610dea5760405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608401610c6a565b610d3b81611d50565b6000818152600260205260408120546001600160a01b031615156108f5565b6000610e1d60085490565b8210610e915760405162461bcd60e51b815260206004820152602c60248201527f455243373231456e756d657261626c653a20676c6f62616c20696e646578206f60448201527f7574206f6620626f756e647300000000000000000000000000000000000000006064820152608401610c6a565b60088281548110610ea457610ea461352c565b90600052602060002001549050919050565b6000610ec1816116e2565b600e610a188385836135d7565b6000818152600260205260408120546001600160a01b0316806108f55760405162461bcd60e51b815260206004820152601860248201527f4552433732313a20696e76616c696420746f6b656e20494400000000000000006044820152606401610c6a565b6000610f3e816116e2565b60005b82811015610a1857610f75848483818110610f5e57610f5e61352c565b90506020020135601061186a90919063ffffffff16565b600101610f41565b6060610f87611df3565b905090565b60006001600160a01b03821661100a5760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f74206120766160448201527f6c6964206f776e657200000000000000000000000000000000000000000000006064820152608401610c6a565b506001600160a01b031660009081526003602052604090205490565b6000611031816116e2565b610d3b6000611e02565b606060008267ffffffffffffffff811115611058576110586133d6565b604051908082528060200260200182016040528015611081578160200160208202803683370190505b50905060005b83811015611194576110c88585838181106110a4576110a461352c565b905060200201356000908152600260205260409020546001600160a01b0316151590565b1561118c5760328585838181106110e1576110e161352c565b9050602002013510611162576111198585838181106111025761110261352c565b905060200201356011611e5490919063ffffffff16565b61115b576111498585838181106111325761113261352c565b905060200201356010611e5490919063ffffffff16565b611154576001611165565b6002611165565b6003611165565b60045b8282815181106111775761117761352c565b602002602001019060ff16908160ff16815250505b600101611087565b509392505050565b60006111a7816116e2565b8584811415806111b75750808314155b156111d55760405163febb505d60e01b815260040160405180910390fd5b60005b818110156112a65760005b8787838181106111f5576111f561352c565b9050602002013581101561129d578585838181106112155761121561352c565b905060200201602081019061122a9190613697565b156112645761125e8a8a848181106112445761124461352c565b9050602002016020810190611259919061322e565b611e78565b50611295565b6112938a8a848181106112795761127961352c565b905060200201602081019061128e919061322e565b611eb8565b505b6001016111e3565b506001016111d8565b505050505050505050565b606060008267ffffffffffffffff8111156112ce576112ce6133d6565b6040519080825280602002602001820160405280156112f7578160200160208202803683370190505b50905060005b838110156111945761133185858381811061131a5761131a61352c565b905060200201356012611e5490919063ffffffff16565b8282815181106113435761134361352c565b911515602092830291909101909101526001016112fd565b6000611366816116e2565b610d3b611ef9565b60607f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a661139a816116e2565b60008367ffffffffffffffff8111156113b5576113b56133d6565b6040519080825280602002602001820160405280156113de578160200160208202803683370190505b50905060005b8481101561141a576113f586611e78565b8282815181106114075761140761352c565b60209081029190910101526001016113e4565b50949350505050565b600061142e816116e2565b600f610a188385836135d7565b606060018054610924906134f2565b8161145481611893565b8261145e8161194d565b610a188484611f3c565b836001600160a01b03811633146114825761148233611893565b846001600160a01b038116331461149c5761149c3361194d565b6114a886868686611f47565b505050505050565b60607f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a66114dc816116e2565b60008367ffffffffffffffff8111156114f7576114f76133d6565b604051908082528060200260200182016040528015611520578160200160208202803683370190505b50905060005b8481101561141a5761153786611eb8565b8282815181106115495761154961352c565b6020908102919091010152600101611526565b606061156782611806565b6000611571611df3565b9050600081511161159157604051806020016040528060008152506115bc565b8061159b84611fbf565b6040516020016115ac9291906136b4565b6040516020818303038152906040525b9392505050565b6000828152600a60205260409020600101546115de816116e2565b6109108383611bde565b7fb9e206fa2af7ee1331b72ce58b6d938ac810ce9b5cdb65d35ab723fd67badf9e611612816116e2565b60008290036116345760405163794bd20360e11b815260040160405180910390fd5b60005b82811015610a185761166b8484838181106116545761165461352c565b90506020020135601261205290919063ffffffff16565b600101611637565b6060600f8054610924906134f2565b600061168d816116e2565b6001600160a01b0382166116b45760405163367a8f2960e01b815260040160405180910390fd5b610d2482611e02565b60006001600160e01b0319821663152a902d60e11b14806108f557506108f58261207c565b610d3b81336120a1565b6127106bffffffffffffffffffffffff821611156117725760405162461bcd60e51b815260206004820152602a60248201527f455243323938313a20726f79616c7479206665652077696c6c2065786365656460448201527f2073616c655072696365000000000000000000000000000000000000000000006064820152608401610c6a565b6001600160a01b0382166117c85760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c6964207265636569766572000000000000006044820152606401610c6a565b604080518082019091526001600160a01b039092168083526bffffffffffffffffffffffff9091166020909201829052600160a01b90910217600c55565b6000818152600260205260409020546001600160a01b0316610d3b5760405162461bcd60e51b815260206004820152601860248201527f4552433732313a20696e76616c696420746f6b656e20494400000000000000006044820152606401610c6a565b600881901c600090815260209290925260409091208054600160ff9093169290921b9091179055565b6daaeb6d7670e522a718067333cd4e3b15610d3b57604051633185c44d60e21b81523060048201526001600160a01b03821660248201526daaeb6d7670e522a718067333cd4e9063c6171134906044015b602060405180830381865afa158015611901573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611925919061370b565b610d3b57604051633b79c77360e21b81526001600160a01b0382166004820152602401610c6a565b6daaeb6d7670e522a718067333cd4e3b15610d3b57604051633185c44d60e21b8152736438fa583f5f60e37dcd969d87a515b2b84c421960048201526001600160a01b03821660248201526daaeb6d7670e522a718067333cd4e9063c6171134906044016118e4565b60006119c182610ece565b9050806001600160a01b0316836001600160a01b031603611a2e5760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b6064820152608401610c6a565b336001600160a01b0382161480611a4a5750611a4a8133610808565b611abc5760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000006064820152608401610c6a565b6109108383612116565b611acf33610d82565b611b315760405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608401610c6a565b610910838383612184565b6000828152600a602090815260408083206001600160a01b038516845290915290205460ff16610d24576000828152600a602090815260408083206001600160a01b03851684529091529020805460ff19166001179055611b9a3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000828152600a602090815260408083206001600160a01b038516845290915290205460ff1615610d24576000828152600a602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b611c69612371565b600b805460ff60a01b191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b61091083838360405180602001604052806000815250611468565b600080611cdd83610ece565b9050806001600160a01b0316846001600160a01b03161480611d2457506001600160a01b0380821660009081526005602090815260408083209388168352929052205460ff165b80611d485750836001600160a01b0316611d3d846109a7565b6001600160a01b0316145b949350505050565b6000611d5b82610ece565b9050611d6b8160008460016123cc565b611d7482610ece565b600083815260046020908152604080832080546001600160a01b03199081169091556001600160a01b0385168085526003845282852080546000190190558785526002909352818420805490911690555192935084927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908390a45050565b6060600e8054610924906134f2565b600b80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600881901c600090815260208390526040902054600160ff83161b16151592915050565b6000603263ffffffff1660145410611ea35760405163e0357b3560e01b815260040160405180910390fd5b60148054600181019091556108f5838261243b565b60006107d063ffffffff1660135410611ee45760405163e0357b3560e01b815260040160405180910390fd5b60138054600181019091556108f5838261243b565b611f0161246f565b600b805460ff60a01b1916600160a01b1790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258611c993390565b610d243383836124c9565b611f513383611cd1565b611fb35760405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608401610c6a565b610a1884848484612597565b60606000611fcc83612620565b600101905060008167ffffffffffffffff811115611fec57611fec6133d6565b6040519080825280601f01601f191660200182016040528015612016576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461202057509392505050565b600881901c600090815260209290925260409091208054600160ff9093169290921b199091169055565b60006001600160e01b03198216637965db0b60e01b14806108f557506108f582612702565b6000828152600a602090815260408083206001600160a01b038516845290915290205460ff16610d24576120d481612727565b6120df836020612739565b6040516020016120f0929190613728565b60408051601f198184030181529082905262461bcd60e51b8252610c6a91600401613055565b600081815260046020526040902080546001600160a01b0319166001600160a01b038416908117909155819061214b82610ece565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b826001600160a01b031661219782610ece565b6001600160a01b0316146121fb5760405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b6064820152608401610c6a565b6001600160a01b03821661225d5760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b6064820152608401610c6a565b61226a83838360016123cc565b826001600160a01b031661227d82610ece565b6001600160a01b0316146122e15760405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b6064820152608401610c6a565b600081815260046020908152604080832080546001600160a01b03199081169091556001600160a01b0387811680865260038552838620805460001901905590871680865283862080546001019055868652600290945282852080549092168417909155905184937fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef91a4505050565b600b54600160a01b900460ff166123ca5760405162461bcd60e51b815260206004820152601460248201527f5061757361626c653a206e6f74207061757365640000000000000000000000006044820152606401610c6a565b565b6123d461246f565b60006123e082846137a9565b9050825b8181101561242e57600881901c600090815260126020526040902054600160ff83161b161561242657604051631c4cd71b60e11b815260040160405180910390fd5b6001016123e4565b50610b06858585856128d5565b6107d061244760085490565b106124655760405163e0357b3560e01b815260040160405180910390fd5b610d248282612a16565b600b54600160a01b900460ff16156123ca5760405162461bcd60e51b815260206004820152601060248201527f5061757361626c653a20706175736564000000000000000000000000000000006044820152606401610c6a565b816001600160a01b0316836001600160a01b03160361252a5760405162461bcd60e51b815260206004820152601960248201527f4552433732313a20617070726f766520746f2063616c6c6572000000000000006044820152606401610c6a565b6001600160a01b03838116600081815260056020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6125a2848484612184565b6125ae84848484612baf565b610a185760405162461bcd60e51b815260206004820152603260248201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560448201527f63656976657220696d706c656d656e74657200000000000000000000000000006064820152608401610c6a565b6000807a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008310612669577a184f03e93ff9f4daa797ed6e38ed64bf6a1f010000000000000000830492506040015b6d04ee2d6d415b85acef81000000008310612695576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc1000083106126b357662386f26fc10000830492506010015b6305f5e10083106126cb576305f5e100830492506008015b61271083106126df57612710830492506004015b606483106126f1576064830492506002015b600a83106108f55760010192915050565b60006001600160e01b0319821663780e9d6360e01b14806108f557506108f582612d06565b60606108f56001600160a01b03831660145b60606000612748836002613558565b6127539060026137a9565b67ffffffffffffffff81111561276b5761276b6133d6565b6040519080825280601f01601f191660200182016040528015612795576020820181803683370190505b509050600360fc1b816000815181106127b0576127b061352c565b60200101906001600160f81b031916908160001a905350600f60fb1b816001815181106127df576127df61352c565b60200101906001600160f81b031916908160001a9053506000612803846002613558565b61280e9060016137a9565b90505b6001811115612886576f181899199a1a9b1b9c1cb0b131b232b360811b85600f16601081106128425761284261352c565b1a60f81b8282815181106128585761285861352c565b60200101906001600160f81b031916908160001a90535060049490941c9361287f816137bc565b9050612811565b5083156115bc5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610c6a565b6128e184848484612d56565b60018111156129585760405162461bcd60e51b815260206004820152603560248201527f455243373231456e756d657261626c653a20636f6e736563757469766520747260448201527f616e7366657273206e6f7420737570706f7274656400000000000000000000006064820152608401610c6a565b816001600160a01b0385166129b4576129af81600880546000838152600960205260408120829055600182018355919091527ff3f7a9fe364faab93b216da50a3214154f22a0a2b415b23a84c8169e8b636ee30155565b6129d7565b836001600160a01b0316856001600160a01b0316146129d7576129d78582612dde565b6001600160a01b0384166129f3576129ee81612e7b565b610b06565b846001600160a01b0316846001600160a01b031614610b0657610b068482612f2a565b6001600160a01b038216612a6c5760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f20616464726573736044820152606401610c6a565b6000818152600260205260409020546001600160a01b031615612ad15760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e746564000000006044820152606401610c6a565b612adf6000838360016123cc565b6000818152600260205260409020546001600160a01b031615612b445760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e746564000000006044820152606401610c6a565b6001600160a01b038216600081815260036020908152604080832080546001019055848352600290915280822080546001600160a01b0319168417905551839291907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a45050565b60006001600160a01b0384163b15612cfb57604051630a85bd0160e11b81526001600160a01b0385169063150b7a0290612bf39033908990889088906004016137d3565b6020604051808303816000875af1925050508015612c2e575060408051601f3d908101601f19168201909252612c2b9181019061380f565b60015b612ce1573d808015612c5c576040519150601f19603f3d011682016040523d82523d6000602084013e612c61565b606091505b508051600003612cd95760405162461bcd60e51b815260206004820152603260248201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560448201527f63656976657220696d706c656d656e74657200000000000000000000000000006064820152608401610c6a565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050611d48565b506001949350505050565b60006001600160e01b031982166380ac58cd60e01b1480612d3757506001600160e01b03198216635b5e139f60e01b145b806108f557506301ffc9a760e01b6001600160e01b03198316146108f5565b6001811115610a18576001600160a01b03841615612d9c576001600160a01b03841660009081526003602052604081208054839290612d9690849061382c565b90915550505b6001600160a01b03831615610a18576001600160a01b03831660009081526003602052604081208054839290612dd39084906137a9565b909155505050505050565b60006001612deb84610f8c565b612df5919061382c565b600083815260076020526040902054909150808214612e48576001600160a01b03841660009081526006602090815260408083208584528252808320548484528184208190558352600790915290208190555b5060009182526007602090815260408084208490556001600160a01b039094168352600681528383209183525290812055565b600854600090612e8d9060019061382c565b60008381526009602052604081205460088054939450909284908110612eb557612eb561352c565b906000526020600020015490508060088381548110612ed657612ed661352c565b6000918252602080832090910192909255828152600990915260408082208490558582528120556008805480612f0e57612f0e61383f565b6001900381819060005260206000200160009055905550505050565b6000612f3583610f8c565b6001600160a01b039093166000908152600660209081526040808320868452825280832085905593825260079052919091209190915550565b6001600160e01b031981168114610d3b57600080fd5b600060208284031215612f9657600080fd5b81356115bc81612f6e565b80356001600160a01b0381168114612fb857600080fd5b919050565b60008060408385031215612fd057600080fd5b612fd983612fa1565b915060208301356bffffffffffffffffffffffff81168114612ffa57600080fd5b809150509250929050565b60005b83811015613020578181015183820152602001613008565b50506000910152565b60008151808452613041816020860160208601613005565b601f01601f19169290920160200192915050565b6020815260006115bc6020830184613029565b60006020828403121561307a57600080fd5b5035919050565b60008083601f84011261309357600080fd5b50813567ffffffffffffffff8111156130ab57600080fd5b6020830191508360208260051b8501011115610bc357600080fd5b600080602083850312156130d957600080fd5b823567ffffffffffffffff8111156130f057600080fd5b6130fc85828601613081565b90969095509350505050565b6000806040838503121561311b57600080fd5b61312483612fa1565b946020939093013593505050565b60008060006060848603121561314757600080fd5b61315084612fa1565b925061315e60208501612fa1565b9150604084013590509250925092565b6000806040838503121561318157600080fd5b50508035926020909101359150565b600080604083850312156131a357600080fd5b823591506131b360208401612fa1565b90509250929050565b600080602083850312156131cf57600080fd5b823567ffffffffffffffff808211156131e757600080fd5b818501915085601f8301126131fb57600080fd5b81358181111561320a57600080fd5b86602082850101111561321c57600080fd5b60209290920196919550909350505050565b60006020828403121561324057600080fd5b6115bc82612fa1565b6020808252825182820181905260009190848201906040850190845b8181101561328457835160ff1683529284019291840191600101613265565b50909695505050505050565b600080600080600080606087890312156132a957600080fd5b863567ffffffffffffffff808211156132c157600080fd5b6132cd8a838b01613081565b909850965060208901359150808211156132e657600080fd5b6132f28a838b01613081565b9096509450604089013591508082111561330b57600080fd5b5061331889828a01613081565b979a9699509497509295939492505050565b6020808252825182820181905260009190848201906040850190845b81811015613284578351151583529284019291840191600101613346565b6020808252825182820181905260009190848201906040850190845b8181101561328457835183529284019291840191600101613380565b8015158114610d3b57600080fd5b600080604083850312156133bd57600080fd5b6133c683612fa1565b91506020830135612ffa8161339c565b634e487b7160e01b600052604160045260246000fd5b6000806000806080858703121561340257600080fd5b61340b85612fa1565b935061341960208601612fa1565b925060408501359150606085013567ffffffffffffffff8082111561343d57600080fd5b818701915087601f83011261345157600080fd5b813581811115613463576134636133d6565b604051601f8201601f19908116603f0116810190838211818310171561348b5761348b6133d6565b816040528281528a60208487010111156134a457600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b600080604083850312156134db57600080fd5b6134e483612fa1565b91506131b360208401612fa1565b600181811c9082168061350657607f821691505b60208210810361352657634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b80820281158282048414176108f5576108f5613542565b60008261358c57634e487b7160e01b600052601260045260246000fd5b500490565b601f82111561091057600081815260208120601f850160051c810160208610156135b85750805b601f850160051c820191505b818110156114a8578281556001016135c4565b67ffffffffffffffff8311156135ef576135ef6133d6565b613603836135fd83546134f2565b83613591565b6000601f841160018114613637576000851561361f5750838201355b600019600387901b1c1916600186901b178355610b06565b600083815260209020601f19861690835b828110156136685786850135825560209485019460019092019101613648565b50868210156136855760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b6000602082840312156136a957600080fd5b81356115bc8161339c565b600083516136c6818460208801613005565b8351908301906136da818360208801613005565b7f2e6a736f6e0000000000000000000000000000000000000000000000000000009101908152600501949350505050565b60006020828403121561371d57600080fd5b81516115bc8161339c565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613760816017850160208801613005565b7f206973206d697373696e6720726f6c6520000000000000000000000000000000601791840191820152835161379d816028840160208801613005565b01602801949350505050565b808201808211156108f5576108f5613542565b6000816137cb576137cb613542565b506000190190565b60006001600160a01b038087168352808616602084015250836040830152608060608301526138056080830184613029565b9695505050505050565b60006020828403121561382157600080fd5b81516115bc81612f6e565b818103818111156108f5576108f5613542565b634e487b7160e01b600052603160045260246000fdfea2646970667358221220f851d2b192f1d95c4bab16ff317ca487a205e710b37b928f72de9efb2ec7c42964736f6c63430008110033000000000000000000000000342fe190738e1e1d197a0e62ac385ee82454fcd300000000000000000000000000000000000000000000000000000000000001f4000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000007697066733a2f2f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005068747470733a2f2f676174657761792e70696e6174612e636c6f75642f697066732f516d5a47624a57595a7a353252527259734737464c4e4a4333347a333135506b674d596b42455866547443527a4200000000000000000000000000000000
Deployed Bytecode
0x608060405234801561001057600080fd5b50600436106103825760003560e01c80636352211e116101de5780639330d3be1161010f578063c1a54ab5116100ad578063e449f3411161007c578063e449f341146107df578063e8a3d485146107f2578063e985e9c5146107fa578063f2fde38b1461083657600080fd5b8063c1a54ab51461077f578063c87b56dd14610792578063d5391393146107a5578063d547741f146107cc57600080fd5b80639e94bb93116100e95780639e94bb9314610749578063a217fddf14610751578063a22cb46514610759578063b88d4fde1461076c57600080fd5b80639330d3be14610713578063938e3d7b1461072e57806395d89b411461074157600080fd5b806375794a3c1161017c5780638456cb59116101565780638456cb59146106a15780638da5cb5b146106a95780638deda96b146106ba57806391d14854146106da57600080fd5b806375794a3c146106715780637aad87891461067957806382ca466e1461068157600080fd5b806370a08231116101b857806370a0823114610623578063715018a61461063657806371b9faf71461063e5780637493c19f1461065e57600080fd5b80636352211e146105f557806368a437b3146106085780636c0360eb1461061b57600080fd5b80632f2ff15d116102b857806341f43434116102565780634f558e79116102305780634f558e79146105aa5780634f6ccce7146105bd57806355f804b3146105d05780635c975abb146105e357600080fd5b806341f434341461056f57806342842e0e1461058457806342966c681461059757600080fd5b806336568abe1161029257806336568abe146105255780633780b3ed1461053857806338062de81461055f5780633f4ba83a1461056757600080fd5b80632f2ff15d146104f75780632f745c591461050a578063357730291461051d57600080fd5b8063095ea7b31161032557806323b872dd116102ff57806323b872dd14610487578063248a9ca31461049a5780632a55205a146104bd5780632b6de39a146104ef57600080fd5b8063095ea7b31461044f5780630fbf0a931461046257806318160ddd1461047557600080fd5b806306fdde031161036157806306fdde03146103de578063081812fc146103f3578063084849c31461041e578063093d8c641461043157600080fd5b8062c84c201461038757806301ffc9a7146103a657806304634d8d146103c9575b600080fd5b61038f600381565b60405160ff90911681526020015b60405180910390f35b6103b96103b4366004612f84565b610849565b604051901515815260200161039d565b6103dc6103d7366004612fbd565b6108fb565b005b6103e6610915565b60405161039d9190613055565b610406610401366004613068565b6109a7565b6040516001600160a01b03909116815260200161039d565b6103dc61042c3660046130c6565b6109ce565b61043a6107d081565b60405163ffffffff909116815260200161039d565b6103dc61045d366004613108565b610a1e565b6103dc6104703660046130c6565b610a3c565b6008545b60405190815260200161039d565b6103dc610495366004613132565b610ac7565b6104796104a8366004613068565b6000908152600a602052604090206001015490565b6104d06104cb36600461316e565b610b0d565b604080516001600160a01b03909316835260208301919091520161039d565b61038f600481565b6103dc610505366004613190565b610bca565b610479610518366004613108565b610bef565b61043a603281565b6103dc610533366004613190565b610c9c565b6104797fb9e206fa2af7ee1331b72ce58b6d938ac810ce9b5cdb65d35ab723fd67badf9e81565b601454610479565b6103dc610d28565b6104066daaeb6d7670e522a718067333cd4e81565b6103dc610592366004613132565b610d3e565b6103dc6105a5366004613068565b610d7d565b6103b96105b8366004613068565b610df3565b6104796105cb366004613068565b610e12565b6103dc6105de3660046131bc565b610eb6565b600b54600160a01b900460ff166103b9565b610406610603366004613068565b610ece565b6103dc6106163660046130c6565b610f33565b6103e6610f7d565b61047961063136600461322e565b610f8c565b6103dc611026565b61065161064c3660046130c6565b61103b565b60405161039d9190613249565b6103dc61066c366004613290565b61119c565b601354610479565b61038f600181565b61069461068f3660046130c6565b6112b1565b60405161039d919061332a565b6103dc61135b565b600b546001600160a01b0316610406565b6106cd6106c8366004613108565b61136e565b60405161039d9190613364565b6103b96106e8366004613190565b6000918252600a602090815260408084206001600160a01b0393909316845291905290205460ff1690565b610406736438fa583f5f60e37dcd969d87a515b2b84c421981565b6103dc61073c3660046131bc565b611423565b6103e661143b565b61038f600281565b610479600081565b6103dc6107673660046133aa565b61144a565b6103dc61077a3660046133ec565b611468565b6106cd61078d366004613108565b6114b0565b6103e66107a0366004613068565b61155c565b6104797f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a681565b6103dc6107da366004613190565b6115c3565b6103dc6107ed3660046130c6565b6115e8565b6103e6611673565b6103b96108083660046134c8565b6001600160a01b03918216600090815260056020908152604080832093909416825291909152205460ff1690565b6103dc61084436600461322e565b611682565b60006001600160e01b03198216637965db0b60e01b148061087a57506001600160e01b031982166301ffc9a760e01b145b8061089557506001600160e01b031982166380ac58cd60e01b145b806108b057506001600160e01b03198216635b5e139f60e01b145b806108cb57506001600160e01b0319821663780e9d6360e01b145b806108e657506001600160e01b0319821663152a902d60e11b145b806108f557506108f5826116bd565b92915050565b6000610906816116e2565b61091083836116ec565b505050565b606060008054610924906134f2565b80601f0160208091040260200160405190810160405280929190818152602001828054610950906134f2565b801561099d5780601f106109725761010080835404028352916020019161099d565b820191906000526020600020905b81548152906001019060200180831161098057829003601f168201915b5050505050905090565b60006109b282611806565b506000908152600460205260409020546001600160a01b031690565b60006109d9816116e2565b60005b82811015610a1857610a108484838181106109f9576109f961352c565b90506020020135601161186a90919063ffffffff16565b6001016109dc565b50505050565b81610a2881611893565b82610a328161194d565b610a1884846119b6565b7fb9e206fa2af7ee1331b72ce58b6d938ac810ce9b5cdb65d35ab723fd67badf9e610a66816116e2565b6000829003610a885760405163794bd20360e11b815260040160405180910390fd5b60005b82811015610a1857610abf848483818110610aa857610aa861352c565b90506020020135601261186a90919063ffffffff16565b600101610a8b565b826001600160a01b0381163314610ae157610ae133611893565b836001600160a01b0381163314610afb57610afb3361194d565b610b06858585611ac6565b5050505050565b6000828152600d602090815260408083208151808301909252546001600160a01b038116808352600160a01b9091046bffffffffffffffffffffffff16928201929092528291610b8c575060408051808201909152600c546001600160a01b0381168252600160a01b90046bffffffffffffffffffffffff1660208201525b602081015160009061271090610bb0906bffffffffffffffffffffffff1687613558565b610bba919061356f565b91519350909150505b9250929050565b6000828152600a6020526040902060010154610be5816116e2565b6109108383611b3c565b6000610bfa83610f8c565b8210610c735760405162461bcd60e51b815260206004820152602b60248201527f455243373231456e756d657261626c653a206f776e657220696e646578206f7560448201527f74206f6620626f756e647300000000000000000000000000000000000000000060648201526084015b60405180910390fd5b506001600160a01b03919091166000908152600660209081526040808320938352929052205490565b6001600160a01b0381163314610d1a5760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201527f20726f6c657320666f722073656c6600000000000000000000000000000000006064820152608401610c6a565b610d248282611bde565b5050565b6000610d33816116e2565b610d3b611c61565b50565b826001600160a01b0381163314610d5857610d5833611893565b836001600160a01b0381163314610d7257610d723361194d565b610b06858585611cb6565b610d88335b82611cd1565b610dea5760405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608401610c6a565b610d3b81611d50565b6000818152600260205260408120546001600160a01b031615156108f5565b6000610e1d60085490565b8210610e915760405162461bcd60e51b815260206004820152602c60248201527f455243373231456e756d657261626c653a20676c6f62616c20696e646578206f60448201527f7574206f6620626f756e647300000000000000000000000000000000000000006064820152608401610c6a565b60088281548110610ea457610ea461352c565b90600052602060002001549050919050565b6000610ec1816116e2565b600e610a188385836135d7565b6000818152600260205260408120546001600160a01b0316806108f55760405162461bcd60e51b815260206004820152601860248201527f4552433732313a20696e76616c696420746f6b656e20494400000000000000006044820152606401610c6a565b6000610f3e816116e2565b60005b82811015610a1857610f75848483818110610f5e57610f5e61352c565b90506020020135601061186a90919063ffffffff16565b600101610f41565b6060610f87611df3565b905090565b60006001600160a01b03821661100a5760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f74206120766160448201527f6c6964206f776e657200000000000000000000000000000000000000000000006064820152608401610c6a565b506001600160a01b031660009081526003602052604090205490565b6000611031816116e2565b610d3b6000611e02565b606060008267ffffffffffffffff811115611058576110586133d6565b604051908082528060200260200182016040528015611081578160200160208202803683370190505b50905060005b83811015611194576110c88585838181106110a4576110a461352c565b905060200201356000908152600260205260409020546001600160a01b0316151590565b1561118c5760328585838181106110e1576110e161352c565b9050602002013510611162576111198585838181106111025761110261352c565b905060200201356011611e5490919063ffffffff16565b61115b576111498585838181106111325761113261352c565b905060200201356010611e5490919063ffffffff16565b611154576001611165565b6002611165565b6003611165565b60045b8282815181106111775761117761352c565b602002602001019060ff16908160ff16815250505b600101611087565b509392505050565b60006111a7816116e2565b8584811415806111b75750808314155b156111d55760405163febb505d60e01b815260040160405180910390fd5b60005b818110156112a65760005b8787838181106111f5576111f561352c565b9050602002013581101561129d578585838181106112155761121561352c565b905060200201602081019061122a9190613697565b156112645761125e8a8a848181106112445761124461352c565b9050602002016020810190611259919061322e565b611e78565b50611295565b6112938a8a848181106112795761127961352c565b905060200201602081019061128e919061322e565b611eb8565b505b6001016111e3565b506001016111d8565b505050505050505050565b606060008267ffffffffffffffff8111156112ce576112ce6133d6565b6040519080825280602002602001820160405280156112f7578160200160208202803683370190505b50905060005b838110156111945761133185858381811061131a5761131a61352c565b905060200201356012611e5490919063ffffffff16565b8282815181106113435761134361352c565b911515602092830291909101909101526001016112fd565b6000611366816116e2565b610d3b611ef9565b60607f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a661139a816116e2565b60008367ffffffffffffffff8111156113b5576113b56133d6565b6040519080825280602002602001820160405280156113de578160200160208202803683370190505b50905060005b8481101561141a576113f586611e78565b8282815181106114075761140761352c565b60209081029190910101526001016113e4565b50949350505050565b600061142e816116e2565b600f610a188385836135d7565b606060018054610924906134f2565b8161145481611893565b8261145e8161194d565b610a188484611f3c565b836001600160a01b03811633146114825761148233611893565b846001600160a01b038116331461149c5761149c3361194d565b6114a886868686611f47565b505050505050565b60607f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a66114dc816116e2565b60008367ffffffffffffffff8111156114f7576114f76133d6565b604051908082528060200260200182016040528015611520578160200160208202803683370190505b50905060005b8481101561141a5761153786611eb8565b8282815181106115495761154961352c565b6020908102919091010152600101611526565b606061156782611806565b6000611571611df3565b9050600081511161159157604051806020016040528060008152506115bc565b8061159b84611fbf565b6040516020016115ac9291906136b4565b6040516020818303038152906040525b9392505050565b6000828152600a60205260409020600101546115de816116e2565b6109108383611bde565b7fb9e206fa2af7ee1331b72ce58b6d938ac810ce9b5cdb65d35ab723fd67badf9e611612816116e2565b60008290036116345760405163794bd20360e11b815260040160405180910390fd5b60005b82811015610a185761166b8484838181106116545761165461352c565b90506020020135601261205290919063ffffffff16565b600101611637565b6060600f8054610924906134f2565b600061168d816116e2565b6001600160a01b0382166116b45760405163367a8f2960e01b815260040160405180910390fd5b610d2482611e02565b60006001600160e01b0319821663152a902d60e11b14806108f557506108f58261207c565b610d3b81336120a1565b6127106bffffffffffffffffffffffff821611156117725760405162461bcd60e51b815260206004820152602a60248201527f455243323938313a20726f79616c7479206665652077696c6c2065786365656460448201527f2073616c655072696365000000000000000000000000000000000000000000006064820152608401610c6a565b6001600160a01b0382166117c85760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c6964207265636569766572000000000000006044820152606401610c6a565b604080518082019091526001600160a01b039092168083526bffffffffffffffffffffffff9091166020909201829052600160a01b90910217600c55565b6000818152600260205260409020546001600160a01b0316610d3b5760405162461bcd60e51b815260206004820152601860248201527f4552433732313a20696e76616c696420746f6b656e20494400000000000000006044820152606401610c6a565b600881901c600090815260209290925260409091208054600160ff9093169290921b9091179055565b6daaeb6d7670e522a718067333cd4e3b15610d3b57604051633185c44d60e21b81523060048201526001600160a01b03821660248201526daaeb6d7670e522a718067333cd4e9063c6171134906044015b602060405180830381865afa158015611901573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611925919061370b565b610d3b57604051633b79c77360e21b81526001600160a01b0382166004820152602401610c6a565b6daaeb6d7670e522a718067333cd4e3b15610d3b57604051633185c44d60e21b8152736438fa583f5f60e37dcd969d87a515b2b84c421960048201526001600160a01b03821660248201526daaeb6d7670e522a718067333cd4e9063c6171134906044016118e4565b60006119c182610ece565b9050806001600160a01b0316836001600160a01b031603611a2e5760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b6064820152608401610c6a565b336001600160a01b0382161480611a4a5750611a4a8133610808565b611abc5760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000006064820152608401610c6a565b6109108383612116565b611acf33610d82565b611b315760405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608401610c6a565b610910838383612184565b6000828152600a602090815260408083206001600160a01b038516845290915290205460ff16610d24576000828152600a602090815260408083206001600160a01b03851684529091529020805460ff19166001179055611b9a3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000828152600a602090815260408083206001600160a01b038516845290915290205460ff1615610d24576000828152600a602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b611c69612371565b600b805460ff60a01b191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b61091083838360405180602001604052806000815250611468565b600080611cdd83610ece565b9050806001600160a01b0316846001600160a01b03161480611d2457506001600160a01b0380821660009081526005602090815260408083209388168352929052205460ff165b80611d485750836001600160a01b0316611d3d846109a7565b6001600160a01b0316145b949350505050565b6000611d5b82610ece565b9050611d6b8160008460016123cc565b611d7482610ece565b600083815260046020908152604080832080546001600160a01b03199081169091556001600160a01b0385168085526003845282852080546000190190558785526002909352818420805490911690555192935084927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908390a45050565b6060600e8054610924906134f2565b600b80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600881901c600090815260208390526040902054600160ff83161b16151592915050565b6000603263ffffffff1660145410611ea35760405163e0357b3560e01b815260040160405180910390fd5b60148054600181019091556108f5838261243b565b60006107d063ffffffff1660135410611ee45760405163e0357b3560e01b815260040160405180910390fd5b60138054600181019091556108f5838261243b565b611f0161246f565b600b805460ff60a01b1916600160a01b1790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258611c993390565b610d243383836124c9565b611f513383611cd1565b611fb35760405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608401610c6a565b610a1884848484612597565b60606000611fcc83612620565b600101905060008167ffffffffffffffff811115611fec57611fec6133d6565b6040519080825280601f01601f191660200182016040528015612016576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461202057509392505050565b600881901c600090815260209290925260409091208054600160ff9093169290921b199091169055565b60006001600160e01b03198216637965db0b60e01b14806108f557506108f582612702565b6000828152600a602090815260408083206001600160a01b038516845290915290205460ff16610d24576120d481612727565b6120df836020612739565b6040516020016120f0929190613728565b60408051601f198184030181529082905262461bcd60e51b8252610c6a91600401613055565b600081815260046020526040902080546001600160a01b0319166001600160a01b038416908117909155819061214b82610ece565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b826001600160a01b031661219782610ece565b6001600160a01b0316146121fb5760405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b6064820152608401610c6a565b6001600160a01b03821661225d5760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b6064820152608401610c6a565b61226a83838360016123cc565b826001600160a01b031661227d82610ece565b6001600160a01b0316146122e15760405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b6064820152608401610c6a565b600081815260046020908152604080832080546001600160a01b03199081169091556001600160a01b0387811680865260038552838620805460001901905590871680865283862080546001019055868652600290945282852080549092168417909155905184937fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef91a4505050565b600b54600160a01b900460ff166123ca5760405162461bcd60e51b815260206004820152601460248201527f5061757361626c653a206e6f74207061757365640000000000000000000000006044820152606401610c6a565b565b6123d461246f565b60006123e082846137a9565b9050825b8181101561242e57600881901c600090815260126020526040902054600160ff83161b161561242657604051631c4cd71b60e11b815260040160405180910390fd5b6001016123e4565b50610b06858585856128d5565b6107d061244760085490565b106124655760405163e0357b3560e01b815260040160405180910390fd5b610d248282612a16565b600b54600160a01b900460ff16156123ca5760405162461bcd60e51b815260206004820152601060248201527f5061757361626c653a20706175736564000000000000000000000000000000006044820152606401610c6a565b816001600160a01b0316836001600160a01b03160361252a5760405162461bcd60e51b815260206004820152601960248201527f4552433732313a20617070726f766520746f2063616c6c6572000000000000006044820152606401610c6a565b6001600160a01b03838116600081815260056020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6125a2848484612184565b6125ae84848484612baf565b610a185760405162461bcd60e51b815260206004820152603260248201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560448201527f63656976657220696d706c656d656e74657200000000000000000000000000006064820152608401610c6a565b6000807a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008310612669577a184f03e93ff9f4daa797ed6e38ed64bf6a1f010000000000000000830492506040015b6d04ee2d6d415b85acef81000000008310612695576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc1000083106126b357662386f26fc10000830492506010015b6305f5e10083106126cb576305f5e100830492506008015b61271083106126df57612710830492506004015b606483106126f1576064830492506002015b600a83106108f55760010192915050565b60006001600160e01b0319821663780e9d6360e01b14806108f557506108f582612d06565b60606108f56001600160a01b03831660145b60606000612748836002613558565b6127539060026137a9565b67ffffffffffffffff81111561276b5761276b6133d6565b6040519080825280601f01601f191660200182016040528015612795576020820181803683370190505b509050600360fc1b816000815181106127b0576127b061352c565b60200101906001600160f81b031916908160001a905350600f60fb1b816001815181106127df576127df61352c565b60200101906001600160f81b031916908160001a9053506000612803846002613558565b61280e9060016137a9565b90505b6001811115612886576f181899199a1a9b1b9c1cb0b131b232b360811b85600f16601081106128425761284261352c565b1a60f81b8282815181106128585761285861352c565b60200101906001600160f81b031916908160001a90535060049490941c9361287f816137bc565b9050612811565b5083156115bc5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610c6a565b6128e184848484612d56565b60018111156129585760405162461bcd60e51b815260206004820152603560248201527f455243373231456e756d657261626c653a20636f6e736563757469766520747260448201527f616e7366657273206e6f7420737570706f7274656400000000000000000000006064820152608401610c6a565b816001600160a01b0385166129b4576129af81600880546000838152600960205260408120829055600182018355919091527ff3f7a9fe364faab93b216da50a3214154f22a0a2b415b23a84c8169e8b636ee30155565b6129d7565b836001600160a01b0316856001600160a01b0316146129d7576129d78582612dde565b6001600160a01b0384166129f3576129ee81612e7b565b610b06565b846001600160a01b0316846001600160a01b031614610b0657610b068482612f2a565b6001600160a01b038216612a6c5760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f20616464726573736044820152606401610c6a565b6000818152600260205260409020546001600160a01b031615612ad15760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e746564000000006044820152606401610c6a565b612adf6000838360016123cc565b6000818152600260205260409020546001600160a01b031615612b445760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e746564000000006044820152606401610c6a565b6001600160a01b038216600081815260036020908152604080832080546001019055848352600290915280822080546001600160a01b0319168417905551839291907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a45050565b60006001600160a01b0384163b15612cfb57604051630a85bd0160e11b81526001600160a01b0385169063150b7a0290612bf39033908990889088906004016137d3565b6020604051808303816000875af1925050508015612c2e575060408051601f3d908101601f19168201909252612c2b9181019061380f565b60015b612ce1573d808015612c5c576040519150601f19603f3d011682016040523d82523d6000602084013e612c61565b606091505b508051600003612cd95760405162461bcd60e51b815260206004820152603260248201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560448201527f63656976657220696d706c656d656e74657200000000000000000000000000006064820152608401610c6a565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050611d48565b506001949350505050565b60006001600160e01b031982166380ac58cd60e01b1480612d3757506001600160e01b03198216635b5e139f60e01b145b806108f557506301ffc9a760e01b6001600160e01b03198316146108f5565b6001811115610a18576001600160a01b03841615612d9c576001600160a01b03841660009081526003602052604081208054839290612d9690849061382c565b90915550505b6001600160a01b03831615610a18576001600160a01b03831660009081526003602052604081208054839290612dd39084906137a9565b909155505050505050565b60006001612deb84610f8c565b612df5919061382c565b600083815260076020526040902054909150808214612e48576001600160a01b03841660009081526006602090815260408083208584528252808320548484528184208190558352600790915290208190555b5060009182526007602090815260408084208490556001600160a01b039094168352600681528383209183525290812055565b600854600090612e8d9060019061382c565b60008381526009602052604081205460088054939450909284908110612eb557612eb561352c565b906000526020600020015490508060088381548110612ed657612ed661352c565b6000918252602080832090910192909255828152600990915260408082208490558582528120556008805480612f0e57612f0e61383f565b6001900381819060005260206000200160009055905550505050565b6000612f3583610f8c565b6001600160a01b039093166000908152600660209081526040808320868452825280832085905593825260079052919091209190915550565b6001600160e01b031981168114610d3b57600080fd5b600060208284031215612f9657600080fd5b81356115bc81612f6e565b80356001600160a01b0381168114612fb857600080fd5b919050565b60008060408385031215612fd057600080fd5b612fd983612fa1565b915060208301356bffffffffffffffffffffffff81168114612ffa57600080fd5b809150509250929050565b60005b83811015613020578181015183820152602001613008565b50506000910152565b60008151808452613041816020860160208601613005565b601f01601f19169290920160200192915050565b6020815260006115bc6020830184613029565b60006020828403121561307a57600080fd5b5035919050565b60008083601f84011261309357600080fd5b50813567ffffffffffffffff8111156130ab57600080fd5b6020830191508360208260051b8501011115610bc357600080fd5b600080602083850312156130d957600080fd5b823567ffffffffffffffff8111156130f057600080fd5b6130fc85828601613081565b90969095509350505050565b6000806040838503121561311b57600080fd5b61312483612fa1565b946020939093013593505050565b60008060006060848603121561314757600080fd5b61315084612fa1565b925061315e60208501612fa1565b9150604084013590509250925092565b6000806040838503121561318157600080fd5b50508035926020909101359150565b600080604083850312156131a357600080fd5b823591506131b360208401612fa1565b90509250929050565b600080602083850312156131cf57600080fd5b823567ffffffffffffffff808211156131e757600080fd5b818501915085601f8301126131fb57600080fd5b81358181111561320a57600080fd5b86602082850101111561321c57600080fd5b60209290920196919550909350505050565b60006020828403121561324057600080fd5b6115bc82612fa1565b6020808252825182820181905260009190848201906040850190845b8181101561328457835160ff1683529284019291840191600101613265565b50909695505050505050565b600080600080600080606087890312156132a957600080fd5b863567ffffffffffffffff808211156132c157600080fd5b6132cd8a838b01613081565b909850965060208901359150808211156132e657600080fd5b6132f28a838b01613081565b9096509450604089013591508082111561330b57600080fd5b5061331889828a01613081565b979a9699509497509295939492505050565b6020808252825182820181905260009190848201906040850190845b81811015613284578351151583529284019291840191600101613346565b6020808252825182820181905260009190848201906040850190845b8181101561328457835183529284019291840191600101613380565b8015158114610d3b57600080fd5b600080604083850312156133bd57600080fd5b6133c683612fa1565b91506020830135612ffa8161339c565b634e487b7160e01b600052604160045260246000fd5b6000806000806080858703121561340257600080fd5b61340b85612fa1565b935061341960208601612fa1565b925060408501359150606085013567ffffffffffffffff8082111561343d57600080fd5b818701915087601f83011261345157600080fd5b813581811115613463576134636133d6565b604051601f8201601f19908116603f0116810190838211818310171561348b5761348b6133d6565b816040528281528a60208487010111156134a457600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b600080604083850312156134db57600080fd5b6134e483612fa1565b91506131b360208401612fa1565b600181811c9082168061350657607f821691505b60208210810361352657634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b80820281158282048414176108f5576108f5613542565b60008261358c57634e487b7160e01b600052601260045260246000fd5b500490565b601f82111561091057600081815260208120601f850160051c810160208610156135b85750805b601f850160051c820191505b818110156114a8578281556001016135c4565b67ffffffffffffffff8311156135ef576135ef6133d6565b613603836135fd83546134f2565b83613591565b6000601f841160018114613637576000851561361f5750838201355b600019600387901b1c1916600186901b178355610b06565b600083815260209020601f19861690835b828110156136685786850135825560209485019460019092019101613648565b50868210156136855760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b6000602082840312156136a957600080fd5b81356115bc8161339c565b600083516136c6818460208801613005565b8351908301906136da818360208801613005565b7f2e6a736f6e0000000000000000000000000000000000000000000000000000009101908152600501949350505050565b60006020828403121561371d57600080fd5b81516115bc8161339c565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613760816017850160208801613005565b7f206973206d697373696e6720726f6c6520000000000000000000000000000000601791840191820152835161379d816028840160208801613005565b01602801949350505050565b808201808211156108f5576108f5613542565b6000816137cb576137cb613542565b506000190190565b60006001600160a01b038087168352808616602084015250836040830152608060608301526138056080830184613029565b9695505050505050565b60006020828403121561382157600080fd5b81516115bc81612f6e565b818103818111156108f5576108f5613542565b634e487b7160e01b600052603160045260246000fdfea2646970667358221220f851d2b192f1d95c4bab16ff317ca487a205e710b37b928f72de9efb2ec7c42964736f6c63430008110033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000342fe190738e1e1d197a0e62ac385ee82454fcd300000000000000000000000000000000000000000000000000000000000001f4000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000007697066733a2f2f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005068747470733a2f2f676174657761792e70696e6174612e636c6f75642f697066732f516d5a47624a57595a7a353252527259734737464c4e4a4333347a333135506b674d596b42455866547443527a4200000000000000000000000000000000
-----Decoded View---------------
Arg [0] : defaultAdmin_ (address): 0x342fe190738e1e1D197a0E62aC385Ee82454fCD3
Arg [1] : defaultRoyalty_ (uint96): 500
Arg [2] : baseURI_ (string): ipfs://
Arg [3] : contractURI_ (string): https://gateway.pinata.cloud/ipfs/QmZGbJWYZz52RRrYsG7FLNJC34z315PkgMYkBEXfTtCRzB
-----Encoded View---------------
10 Constructor Arguments found :
Arg [0] : 000000000000000000000000342fe190738e1e1d197a0e62ac385ee82454fcd3
Arg [1] : 00000000000000000000000000000000000000000000000000000000000001f4
Arg [2] : 0000000000000000000000000000000000000000000000000000000000000080
Arg [3] : 00000000000000000000000000000000000000000000000000000000000000c0
Arg [4] : 0000000000000000000000000000000000000000000000000000000000000007
Arg [5] : 697066733a2f2f00000000000000000000000000000000000000000000000000
Arg [6] : 0000000000000000000000000000000000000000000000000000000000000050
Arg [7] : 68747470733a2f2f676174657761792e70696e6174612e636c6f75642f697066
Arg [8] : 732f516d5a47624a57595a7a353252527259734737464c4e4a4333347a333135
Arg [9] : 506b674d596b42455866547443527a4200000000000000000000000000000000
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.