Overview
ETH Balance
0 ETH
ETH Value
$0.00More Info
Private Name Tags
ContractCreator
TokenTracker
| Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
|---|---|---|---|---|---|---|---|---|---|
Latest 25 internal transactions (View All)
Advanced mode:
| Parent Transaction Hash | Block | From | To | |||
|---|---|---|---|---|---|---|
| 287154267 | 122 days ago | 2.82045023 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150674 | 122 days ago | 0.001 ETH | ||||
| 287150672 | 122 days ago | 0.001 ETH | ||||
| 287150672 | 122 days ago | 0.001 ETH | ||||
| 287150672 | 122 days ago | 0.001 ETH | ||||
| 287150672 | 122 days ago | 0.001 ETH |
Loading...
Loading
Contract Source Code Verified (Exact Match)
Contract Name:
Zoo_Eve
Compiler Version
v0.8.24+commit.e11b9ed9
Optimization Enabled:
Yes with 200 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity)
/** *Submitted for verification at Arbiscan.io on 2024-12-16 */ // Sources flattened with hardhat v2.22.13 https://hardhat.org // SPDX-License-Identifier: Apache-2.0 AND CC0-1.0 AND MIT AND UNLICENSED // File @openzeppelin/contracts/utils/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol) pragma solidity ^0.8.20; /** * @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; } function _contextSuffixLength() internal view virtual returns (uint256) { return 0; } } // File @openzeppelin/contracts/access/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol) pragma solidity ^0.8.20; /** * @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. * * The initial owner is set to the address provided by the deployer. 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; /** * @dev The caller account is not authorized to perform an operation. */ error OwnableUnauthorizedAccount(address account); /** * @dev The owner is not a valid owner account. (eg. `address(0)`) */ error OwnableInvalidOwner(address owner); event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the address provided by the deployer as the initial owner. */ constructor(address initialOwner) { if (initialOwner == address(0)) { revert OwnableInvalidOwner(address(0)); } _transferOwnership(initialOwner); } /** * @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 { if (owner() != _msgSender()) { revert OwnableUnauthorizedAccount(_msgSender()); } } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby disabling 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 { if (newOwner == address(0)) { revert OwnableInvalidOwner(address(0)); } _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); } } // File @openzeppelin/contracts/utils/introspection/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol) pragma solidity ^0.8.20; /** * @dev Interface of the ERC-165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[ERC]. * * 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[ERC 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); } // File @openzeppelin/contracts/interfaces/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC2981.sol) pragma solidity ^0.8.20; /** * @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. */ 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. * * NOTE: ERC-2981 allows setting the royalty to 100% of the price. In that case all the price would be sent to the * royalty receiver and 0 tokens to the seller. Contracts dealing with royalty should consider empty transfers. */ function royaltyInfo( uint256 tokenId, uint256 salePrice ) external view returns (address receiver, uint256 royaltyAmount); } // File @openzeppelin/contracts/utils/introspection/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/ERC165.sol) pragma solidity ^0.8.20; /** * @dev Implementation of the {IERC165} interface. * * Contracts that want to implement ERC-165 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); * } * ``` */ abstract contract ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) { return interfaceId == type(IERC165).interfaceId; } } // File @openzeppelin/contracts/token/common/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/common/ERC2981.sol) pragma solidity ^0.8.20; /** * @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 ERC. Marketplaces are expected to * voluntarily pay royalties together with sales, but note that this standard is not yet widely supported. */ abstract contract ERC2981 is IERC2981, ERC165 { struct RoyaltyInfo { address receiver; uint96 royaltyFraction; } RoyaltyInfo private _defaultRoyaltyInfo; mapping(uint256 tokenId => RoyaltyInfo) private _tokenRoyaltyInfo; /** * @dev The default royalty set is invalid (eg. (numerator / denominator) >= 1). */ error ERC2981InvalidDefaultRoyalty(uint256 numerator, uint256 denominator); /** * @dev The default royalty receiver is invalid. */ error ERC2981InvalidDefaultRoyaltyReceiver(address receiver); /** * @dev The royalty set for an specific `tokenId` is invalid (eg. (numerator / denominator) >= 1). */ error ERC2981InvalidTokenRoyalty(uint256 tokenId, uint256 numerator, uint256 denominator); /** * @dev The royalty receiver for `tokenId` is invalid. */ error ERC2981InvalidTokenRoyaltyReceiver(uint256 tokenId, address receiver); /** * @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 returns (address receiver, uint256 amount) { RoyaltyInfo storage _royaltyInfo = _tokenRoyaltyInfo[tokenId]; address royaltyReceiver = _royaltyInfo.receiver; uint96 royaltyFraction = _royaltyInfo.royaltyFraction; if (royaltyReceiver == address(0)) { royaltyReceiver = _defaultRoyaltyInfo.receiver; royaltyFraction = _defaultRoyaltyInfo.royaltyFraction; } uint256 royaltyAmount = (salePrice * royaltyFraction) / _feeDenominator(); return (royaltyReceiver, 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 { uint256 denominator = _feeDenominator(); if (feeNumerator > denominator) { // Royalty fee will exceed the sale price revert ERC2981InvalidDefaultRoyalty(feeNumerator, denominator); } if (receiver == address(0)) { revert ERC2981InvalidDefaultRoyaltyReceiver(address(0)); } _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 { uint256 denominator = _feeDenominator(); if (feeNumerator > denominator) { // Royalty fee will exceed the sale price revert ERC2981InvalidTokenRoyalty(tokenId, feeNumerator, denominator); } if (receiver == address(0)) { revert ERC2981InvalidTokenRoyaltyReceiver(tokenId, address(0)); } _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]; } } // File @openzeppelin/contracts/utils/cryptography/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/Hashes.sol) pragma solidity ^0.8.20; /** * @dev Library of standard hash functions. * * _Available since v5.1._ */ library Hashes { /** * @dev Commutative Keccak256 hash of a sorted pair of bytes32. Frequently used when working with merkle proofs. * * NOTE: Equivalent to the `standardNodeHash` in our https://github.com/OpenZeppelin/merkle-tree[JavaScript library]. */ function commutativeKeccak256(bytes32 a, bytes32 b) internal pure returns (bytes32) { return a < b ? _efficientKeccak256(a, b) : _efficientKeccak256(b, a); } /** * @dev Implementation of keccak256(abi.encode(a, b)) that doesn't allocate or expand memory. */ function _efficientKeccak256(bytes32 a, bytes32 b) private pure returns (bytes32 value) { assembly ("memory-safe") { mstore(0x00, a) mstore(0x20, b) value := keccak256(0x00, 0x40) } } } // File @openzeppelin/contracts/utils/cryptography/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/MerkleProof.sol) // This file was procedurally generated from scripts/generate/templates/MerkleProof.js. pragma solidity ^0.8.20; /** * @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. * * IMPORTANT: Consider memory side-effects when using custom hashing functions * that access memory in an unsafe way. * * NOTE: This library supports proof verification for merkle trees built using * custom _commutative_ hashing functions (i.e. `H(a, b) == H(b, a)`). Proving * leaf inclusion in trees built using non-commutative hashing functions requires * additional logic that is not supported by this library. */ library MerkleProof { /** *@dev The multiproof provided is not valid. */ error MerkleProofInvalidMultiproof(); /** * @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. * * This version handles proofs in memory with the default hashing function. */ function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) { return processProof(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 leaves & pre-images are assumed to be sorted. * * This version handles proofs in memory with the default hashing function. */ function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { computedHash = Hashes.commutativeKeccak256(computedHash, proof[i]); } return computedHash; } /** * @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. * * This version handles proofs in memory with a custom hashing function. */ function verify( bytes32[] memory proof, bytes32 root, bytes32 leaf, function(bytes32, bytes32) view returns (bytes32) hasher ) internal view returns (bool) { return processProof(proof, leaf, hasher) == 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 leaves & pre-images are assumed to be sorted. * * This version handles proofs in memory with a custom hashing function. */ function processProof( bytes32[] memory proof, bytes32 leaf, function(bytes32, bytes32) view returns (bytes32) hasher ) internal view returns (bytes32) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { computedHash = hasher(computedHash, proof[i]); } return computedHash; } /** * @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. * * This version handles proofs in calldata with the default hashing function. */ 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 leaves & pre-images are assumed to be sorted. * * This version handles proofs in calldata with the default hashing function. */ function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { computedHash = Hashes.commutativeKeccak256(computedHash, proof[i]); } return computedHash; } /** * @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. * * This version handles proofs in calldata with a custom hashing function. */ function verifyCalldata( bytes32[] calldata proof, bytes32 root, bytes32 leaf, function(bytes32, bytes32) view returns (bytes32) hasher ) internal view returns (bool) { return processProofCalldata(proof, leaf, hasher) == 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 leaves & pre-images are assumed to be sorted. * * This version handles proofs in calldata with a custom hashing function. */ function processProofCalldata( bytes32[] calldata proof, bytes32 leaf, function(bytes32, bytes32) view returns (bytes32) hasher ) internal view returns (bytes32) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { computedHash = hasher(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}. * * This version handles multiproofs in memory with the default hashing function. * * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details. * * NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`. * The `leaves` must be validated independently. See {processMultiProof}. */ function multiProofVerify( bytes32[] memory proof, bool[] memory proofFlags, bytes32 root, bytes32[] memory leaves ) internal pure returns (bool) { return processMultiProof(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. * * This version handles multiproofs in memory with the default hashing function. * * 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). * * NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op, * and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not * validating the leaves elsewhere. */ function processMultiProof( bytes32[] memory proof, bool[] memory proofFlags, bytes32[] memory leaves ) internal pure returns (bytes32 merkleRoot) { // This function rebuilds 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 proofFlagsLen = proofFlags.length; // Check proof validity. if (leavesLen + proof.length != proofFlagsLen + 1) { revert MerkleProofInvalidMultiproof(); } // 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[](proofFlagsLen); 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 from the "main queue" (merging branches) or an element from the // `proof` array. for (uint256 i = 0; i < proofFlagsLen; i++) { bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]; bytes32 b = proofFlags[i] ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]) : proof[proofPos++]; hashes[i] = Hashes.commutativeKeccak256(a, b); } if (proofFlagsLen > 0) { if (proofPos != proof.length) { revert MerkleProofInvalidMultiproof(); } unchecked { return hashes[proofFlagsLen - 1]; } } else if (leavesLen > 0) { return leaves[0]; } else { return proof[0]; } } /** * @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}. * * This version handles multiproofs in memory with a custom hashing function. * * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details. * * NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`. * The `leaves` must be validated independently. See {processMultiProof}. */ function multiProofVerify( bytes32[] memory proof, bool[] memory proofFlags, bytes32 root, bytes32[] memory leaves, function(bytes32, bytes32) view returns (bytes32) hasher ) internal view returns (bool) { return processMultiProof(proof, proofFlags, leaves, hasher) == 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. * * This version handles multiproofs in memory with a custom hashing function. * * 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). * * NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op, * and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not * validating the leaves elsewhere. */ function processMultiProof( bytes32[] memory proof, bool[] memory proofFlags, bytes32[] memory leaves, function(bytes32, bytes32) view returns (bytes32) hasher ) internal view returns (bytes32 merkleRoot) { // This function rebuilds 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 proofFlagsLen = proofFlags.length; // Check proof validity. if (leavesLen + proof.length != proofFlagsLen + 1) { revert MerkleProofInvalidMultiproof(); } // 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[](proofFlagsLen); 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 from the "main queue" (merging branches) or an element from the // `proof` array. for (uint256 i = 0; i < proofFlagsLen; i++) { bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]; bytes32 b = proofFlags[i] ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]) : proof[proofPos++]; hashes[i] = hasher(a, b); } if (proofFlagsLen > 0) { if (proofPos != proof.length) { revert MerkleProofInvalidMultiproof(); } unchecked { return hashes[proofFlagsLen - 1]; } } else if (leavesLen > 0) { return leaves[0]; } else { return proof[0]; } } /** * @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}. * * This version handles multiproofs in calldata with the default hashing function. * * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details. * * NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`. * The `leaves` must be validated independently. See {processMultiProofCalldata}. */ 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. * * This version handles multiproofs in calldata with the default hashing function. * * 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). * * NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op, * and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not * validating the leaves elsewhere. */ function processMultiProofCalldata( bytes32[] calldata proof, bool[] calldata proofFlags, bytes32[] memory leaves ) internal pure returns (bytes32 merkleRoot) { // This function rebuilds 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 proofFlagsLen = proofFlags.length; // Check proof validity. if (leavesLen + proof.length != proofFlagsLen + 1) { revert MerkleProofInvalidMultiproof(); } // 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[](proofFlagsLen); 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 from the "main queue" (merging branches) or an element from the // `proof` array. for (uint256 i = 0; i < proofFlagsLen; i++) { bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]; bytes32 b = proofFlags[i] ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]) : proof[proofPos++]; hashes[i] = Hashes.commutativeKeccak256(a, b); } if (proofFlagsLen > 0) { if (proofPos != proof.length) { revert MerkleProofInvalidMultiproof(); } unchecked { return hashes[proofFlagsLen - 1]; } } else if (leavesLen > 0) { return leaves[0]; } else { return proof[0]; } } /** * @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}. * * This version handles multiproofs in calldata with a custom hashing function. * * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details. * * NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`. * The `leaves` must be validated independently. See {processMultiProofCalldata}. */ function multiProofVerifyCalldata( bytes32[] calldata proof, bool[] calldata proofFlags, bytes32 root, bytes32[] memory leaves, function(bytes32, bytes32) view returns (bytes32) hasher ) internal view returns (bool) { return processMultiProofCalldata(proof, proofFlags, leaves, hasher) == 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. * * This version handles multiproofs in calldata with a custom hashing function. * * 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). * * NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op, * and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not * validating the leaves elsewhere. */ function processMultiProofCalldata( bytes32[] calldata proof, bool[] calldata proofFlags, bytes32[] memory leaves, function(bytes32, bytes32) view returns (bytes32) hasher ) internal view returns (bytes32 merkleRoot) { // This function rebuilds 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 proofFlagsLen = proofFlags.length; // Check proof validity. if (leavesLen + proof.length != proofFlagsLen + 1) { revert MerkleProofInvalidMultiproof(); } // 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[](proofFlagsLen); 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 from the "main queue" (merging branches) or an element from the // `proof` array. for (uint256 i = 0; i < proofFlagsLen; i++) { bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]; bytes32 b = proofFlags[i] ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]) : proof[proofPos++]; hashes[i] = hasher(a, b); } if (proofFlagsLen > 0) { if (proofPos != proof.length) { revert MerkleProofInvalidMultiproof(); } unchecked { return hashes[proofFlagsLen - 1]; } } else if (leavesLen > 0) { return leaves[0]; } else { return proof[0]; } } } // File @pythnetwork/pyth-sdk-solidity/[email protected] // Original license: SPDX_License_Identifier: Apache-2.0 pragma solidity ^0.8.0; /// @title IPythEvents contains the events that Pyth contract emits. /// @dev This interface can be used for listening to the updates for off-chain and testing purposes. interface IPythEvents { /// @dev Emitted when the price feed with `id` has received a fresh update. /// @param id The Pyth Price Feed ID. /// @param publishTime Publish time of the given price update. /// @param price Price of the given price update. /// @param conf Confidence interval of the given price update. event PriceFeedUpdate( bytes32 indexed id, uint64 publishTime, int64 price, uint64 conf ); } // File @pythnetwork/pyth-sdk-solidity/[email protected] // Original license: SPDX_License_Identifier: Apache-2.0 pragma solidity ^0.8.0; contract PythStructs { // A price with a degree of uncertainty, represented as a price +- a confidence interval. // // The confidence interval roughly corresponds to the standard error of a normal distribution. // Both the price and confidence are stored in a fixed-point numeric representation, // `x * (10^expo)`, where `expo` is the exponent. // // Please refer to the documentation at https://docs.pyth.network/documentation/pythnet-price-feeds/best-practices for how // to how this price safely. struct Price { // Price int64 price; // Confidence interval around the price uint64 conf; // Price exponent int32 expo; // Unix timestamp describing when the price was published uint publishTime; } // PriceFeed represents a current aggregate price from pyth publisher feeds. struct PriceFeed { // The price ID. bytes32 id; // Latest available price Price price; // Latest available exponentially-weighted moving average price Price emaPrice; } } // File @pythnetwork/pyth-sdk-solidity/[email protected] // Original license: SPDX_License_Identifier: Apache-2.0 pragma solidity ^0.8.0; /// @title Consume prices from the Pyth Network (https://pyth.network/). /// @dev Please refer to the guidance at https://docs.pyth.network/documentation/pythnet-price-feeds/best-practices for how to consume prices safely. /// @author Pyth Data Association interface IPyth is IPythEvents { /// @notice Returns the price of a price feed without any sanity checks. /// @dev This function returns the most recent price update in this contract without any recency checks. /// This function is unsafe as the returned price update may be arbitrarily far in the past. /// /// Users of this function should check the `publishTime` in the price to ensure that the returned price is /// sufficiently recent for their application. If you are considering using this function, it may be /// safer / easier to use `getPriceNoOlderThan`. /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely. function getPriceUnsafe( bytes32 id ) external view returns (PythStructs.Price memory price); /// @notice Returns the price that is no older than `age` seconds of the current time. /// @dev This function is a sanity-checked version of `getPriceUnsafe` which is useful in /// applications that require a sufficiently-recent price. Reverts if the price wasn't updated sufficiently /// recently. /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely. function getPriceNoOlderThan( bytes32 id, uint age ) external view returns (PythStructs.Price memory price); /// @notice Returns the exponentially-weighted moving average price of a price feed without any sanity checks. /// @dev This function returns the same price as `getEmaPrice` in the case where the price is available. /// However, if the price is not recent this function returns the latest available price. /// /// The returned price can be from arbitrarily far in the past; this function makes no guarantees that /// the returned price is recent or useful for any particular application. /// /// Users of this function should check the `publishTime` in the price to ensure that the returned price is /// sufficiently recent for their application. If you are considering using this function, it may be /// safer / easier to use either `getEmaPrice` or `getEmaPriceNoOlderThan`. /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely. function getEmaPriceUnsafe( bytes32 id ) external view returns (PythStructs.Price memory price); /// @notice Returns the exponentially-weighted moving average price that is no older than `age` seconds /// of the current time. /// @dev This function is a sanity-checked version of `getEmaPriceUnsafe` which is useful in /// applications that require a sufficiently-recent price. Reverts if the price wasn't updated sufficiently /// recently. /// @return price - please read the documentation of PythStructs.Price to understand how to use this safely. function getEmaPriceNoOlderThan( bytes32 id, uint age ) external view returns (PythStructs.Price memory price); /// @notice Update price feeds with given update messages. /// This method requires the caller to pay a fee in wei; the required fee can be computed by calling /// `getUpdateFee` with the length of the `updateData` array. /// Prices will be updated if they are more recent than the current stored prices. /// The call will succeed even if the update is not the most recent. /// @dev Reverts if the transferred fee is not sufficient or the updateData is invalid. /// @param updateData Array of price update data. function updatePriceFeeds(bytes[] calldata updateData) external payable; /// @notice Wrapper around updatePriceFeeds that rejects fast if a price update is not necessary. A price update is /// necessary if the current on-chain publishTime is older than the given publishTime. It relies solely on the /// given `publishTimes` for the price feeds and does not read the actual price update publish time within `updateData`. /// /// This method requires the caller to pay a fee in wei; the required fee can be computed by calling /// `getUpdateFee` with the length of the `updateData` array. /// /// `priceIds` and `publishTimes` are two arrays with the same size that correspond to senders known publishTime /// of each priceId when calling this method. If all of price feeds within `priceIds` have updated and have /// a newer or equal publish time than the given publish time, it will reject the transaction to save gas. /// Otherwise, it calls updatePriceFeeds method to update the prices. /// /// @dev Reverts if update is not needed or the transferred fee is not sufficient or the updateData is invalid. /// @param updateData Array of price update data. /// @param priceIds Array of price ids. /// @param publishTimes Array of publishTimes. `publishTimes[i]` corresponds to known `publishTime` of `priceIds[i]` function updatePriceFeedsIfNecessary( bytes[] calldata updateData, bytes32[] calldata priceIds, uint64[] calldata publishTimes ) external payable; /// @notice Returns the required fee to update an array of price updates. /// @param updateData Array of price update data. /// @return feeAmount The required fee in Wei. function getUpdateFee( bytes[] calldata updateData ) external view returns (uint feeAmount); /// @notice Parse `updateData` and return price feeds of the given `priceIds` if they are all published /// within `minPublishTime` and `maxPublishTime`. /// /// You can use this method if you want to use a Pyth price at a fixed time and not the most recent price; /// otherwise, please consider using `updatePriceFeeds`. This method may store the price updates on-chain, if they /// are more recent than the current stored prices. /// /// This method requires the caller to pay a fee in wei; the required fee can be computed by calling /// `getUpdateFee` with the length of the `updateData` array. /// /// /// @dev Reverts if the transferred fee is not sufficient or the updateData is invalid or there is /// no update for any of the given `priceIds` within the given time range. /// @param updateData Array of price update data. /// @param priceIds Array of price ids. /// @param minPublishTime minimum acceptable publishTime for the given `priceIds`. /// @param maxPublishTime maximum acceptable publishTime for the given `priceIds`. /// @return priceFeeds Array of the price feeds corresponding to the given `priceIds` (with the same order). function parsePriceFeedUpdates( bytes[] calldata updateData, bytes32[] calldata priceIds, uint64 minPublishTime, uint64 maxPublishTime ) external payable returns (PythStructs.PriceFeed[] memory priceFeeds); /// @notice Similar to `parsePriceFeedUpdates` but ensures the updates returned are /// the first updates published in minPublishTime. That is, if there are multiple updates for a given timestamp, /// this method will return the first update. This method may store the price updates on-chain, if they /// are more recent than the current stored prices. /// /// /// @dev Reverts if the transferred fee is not sufficient or the updateData is invalid or there is /// no update for any of the given `priceIds` within the given time range and uniqueness condition. /// @param updateData Array of price update data. /// @param priceIds Array of price ids. /// @param minPublishTime minimum acceptable publishTime for the given `priceIds`. /// @param maxPublishTime maximum acceptable publishTime for the given `priceIds`. /// @return priceFeeds Array of the price feeds corresponding to the given `priceIds` (with the same order). function parsePriceFeedUpdatesUnique( bytes[] calldata updateData, bytes32[] calldata priceIds, uint64 minPublishTime, uint64 maxPublishTime ) external payable returns (PythStructs.PriceFeed[] memory priceFeeds); } // File contracts/main-contracts/KingdomlyFeeContract.sol // Original license: SPDX_License_Identifier: UNLICENSED pragma solidity ^0.8.24; error InsufficientUpdateFee(uint256 requiredFee); error ContractNotVerified(address contractAddress); contract KingdomlyFeeContract is Ownable { uint256 private cachedOneDollarInWei; uint256 private maxPriceAgeInSeconds; IPyth pyth; bytes32 ethUsdPriceId; constructor(address _pyth, bytes32 _ethUsdPriceId) Ownable(msg.sender) { pyth = IPyth(_pyth); ethUsdPriceId = _ethUsdPriceId; maxPriceAgeInSeconds = 60 * 60 * 24; } function getOneDollarInWei() public view returns (uint256) { try pyth.getPriceNoOlderThan(ethUsdPriceId, maxPriceAgeInSeconds) returns (PythStructs.Price memory price) { uint256 ethPrice18Decimals = (uint256(uint64(price.price)) * (10 ** 18)) / (10 ** uint8(uint32(-1 * price.expo))); uint256 oneDollarInWei = ((10 ** 18) * (10 ** 18)) / ethPrice18Decimals; return oneDollarInWei; } catch { return cachedOneDollarInWei; } } function updateOracleAndGetOneDollarInWei( bytes[] calldata pythPriceUpdate ) public payable returns (uint256) { uint256 updateFee = pyth.getUpdateFee(pythPriceUpdate); if (msg.value != updateFee) { revert InsufficientUpdateFee(updateFee); } pyth.updatePriceFeeds{value: msg.value}(pythPriceUpdate); cachedOneDollarInWei = getOneDollarInWei(); return cachedOneDollarInWei; } function updateMaxPriceAgeInSeconds( uint256 _maxPriceAgeInSeconds ) public onlyOwner { maxPriceAgeInSeconds = _maxPriceAgeInSeconds; } } // File contracts/utils/IDelegateRegistry.sol // Original license: SPDX_License_Identifier: CC0-1.0 pragma solidity >=0.8.13; /** * @title IDelegateRegistry * @custom:version 2.0 * @custom:author foobar (0xfoobar) * @notice A standalone immutable registry storing delegated permissions from one address to another */ interface IDelegateRegistry { /// @notice Delegation type, NONE is used when a delegation does not exist or is revoked enum DelegationType { NONE, ALL, CONTRACT, ERC721, ERC20, ERC1155 } /// @notice Struct for returning delegations struct Delegation { DelegationType type_; address to; address from; bytes32 rights; address contract_; uint256 tokenId; uint256 amount; } /// @notice Emitted when an address delegates or revokes rights for their entire wallet event DelegateAll( address indexed from, address indexed to, bytes32 rights, bool enable ); /// @notice Emitted when an address delegates or revokes rights for a contract address event DelegateContract( address indexed from, address indexed to, address indexed contract_, bytes32 rights, bool enable ); /// @notice Emitted when an address delegates or revokes rights for an ERC721 tokenId event DelegateERC721( address indexed from, address indexed to, address indexed contract_, uint256 tokenId, bytes32 rights, bool enable ); /// @notice Emitted when an address delegates or revokes rights for an amount of ERC20 tokens event DelegateERC20( address indexed from, address indexed to, address indexed contract_, bytes32 rights, uint256 amount ); /// @notice Emitted when an address delegates or revokes rights for an amount of an ERC1155 tokenId event DelegateERC1155( address indexed from, address indexed to, address indexed contract_, uint256 tokenId, bytes32 rights, uint256 amount ); /// @notice Thrown if multicall calldata is malformed error MulticallFailed(); /** * ----------- WRITE ----------- */ /** * @notice Call multiple functions in the current contract and return the data from all of them if they all succeed * @param data The encoded function data for each of the calls to make to this contract * @return results The results from each of the calls passed in via data */ function multicall( bytes[] calldata data ) external payable returns (bytes[] memory results); /** * @notice Allow the delegate to act on behalf of `msg.sender` for all contracts * @param to The address to act as delegate * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param enable Whether to enable or disable this delegation, true delegates and false revokes * @return delegationHash The unique identifier of the delegation */ function delegateAll( address to, bytes32 rights, bool enable ) external payable returns (bytes32 delegationHash); /** * @notice Allow the delegate to act on behalf of `msg.sender` for a specific contract * @param to The address to act as delegate * @param contract_ The contract whose rights are being delegated * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param enable Whether to enable or disable this delegation, true delegates and false revokes * @return delegationHash The unique identifier of the delegation */ function delegateContract( address to, address contract_, bytes32 rights, bool enable ) external payable returns (bytes32 delegationHash); /** * @notice Allow the delegate to act on behalf of `msg.sender` for a specific ERC721 token * @param to The address to act as delegate * @param contract_ The contract whose rights are being delegated * @param tokenId The token id to delegate * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param enable Whether to enable or disable this delegation, true delegates and false revokes * @return delegationHash The unique identifier of the delegation */ function delegateERC721( address to, address contract_, uint256 tokenId, bytes32 rights, bool enable ) external payable returns (bytes32 delegationHash); /** * @notice Allow the delegate to act on behalf of `msg.sender` for a specific amount of ERC20 tokens * @dev The actual amount is not encoded in the hash, just the existence of a amount (since it is an upper bound) * @param to The address to act as delegate * @param contract_ The address for the fungible token contract * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param amount The amount to delegate, > 0 delegates and 0 revokes * @return delegationHash The unique identifier of the delegation */ function delegateERC20( address to, address contract_, bytes32 rights, uint256 amount ) external payable returns (bytes32 delegationHash); /** * @notice Allow the delegate to act on behalf of `msg.sender` for a specific amount of ERC1155 tokens * @dev The actual amount is not encoded in the hash, just the existence of a amount (since it is an upper bound) * @param to The address to act as delegate * @param contract_ The address of the contract that holds the token * @param tokenId The token id to delegate * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param amount The amount of that token id to delegate, > 0 delegates and 0 revokes * @return delegationHash The unique identifier of the delegation */ function delegateERC1155( address to, address contract_, uint256 tokenId, bytes32 rights, uint256 amount ) external payable returns (bytes32 delegationHash); /** * ----------- CHECKS ----------- */ /** * @notice Check if `to` is a delegate of `from` for the entire wallet * @param to The potential delegate address * @param from The potential address who delegated rights * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return valid Whether delegate is granted to act on the from's behalf */ function checkDelegateForAll( address to, address from, bytes32 rights ) external view returns (bool); /** * @notice Check if `to` is a delegate of `from` for the specified `contract_` or the entire wallet * @param to The delegated address to check * @param contract_ The specific contract address being checked * @param from The cold wallet who issued the delegation * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return valid Whether delegate is granted to act on from's behalf for entire wallet or that specific contract */ function checkDelegateForContract( address to, address from, address contract_, bytes32 rights ) external view returns (bool); /** * @notice Check if `to` is a delegate of `from` for the specific `contract` and `tokenId`, the entire `contract_`, or the entire wallet * @param to The delegated address to check * @param contract_ The specific contract address being checked * @param tokenId The token id for the token to delegating * @param from The wallet that issued the delegation * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return valid Whether delegate is granted to act on from's behalf for entire wallet, that contract, or that specific tokenId */ function checkDelegateForERC721( address to, address from, address contract_, uint256 tokenId, bytes32 rights ) external view returns (bool); /** * @notice Returns the amount of ERC20 tokens the delegate is granted rights to act on the behalf of * @param to The delegated address to check * @param contract_ The address of the token contract * @param from The cold wallet who issued the delegation * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return balance The delegated balance, which will be 0 if the delegation does not exist */ function checkDelegateForERC20( address to, address from, address contract_, bytes32 rights ) external view returns (uint256); /** * @notice Returns the amount of a ERC1155 tokens the delegate is granted rights to act on the behalf of * @param to The delegated address to check * @param contract_ The address of the token contract * @param tokenId The token id to check the delegated amount of * @param from The cold wallet who issued the delegation * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return balance The delegated balance, which will be 0 if the delegation does not exist */ function checkDelegateForERC1155( address to, address from, address contract_, uint256 tokenId, bytes32 rights ) external view returns (uint256); /** * ----------- ENUMERATIONS ----------- */ /** * @notice Returns all enabled delegations a given delegate has received * @param to The address to retrieve delegations for * @return delegations Array of Delegation structs */ function getIncomingDelegations( address to ) external view returns (Delegation[] memory delegations); /** * @notice Returns all enabled delegations an address has given out * @param from The address to retrieve delegations for * @return delegations Array of Delegation structs */ function getOutgoingDelegations( address from ) external view returns (Delegation[] memory delegations); /** * @notice Returns all hashes associated with enabled delegations an address has received * @param to The address to retrieve incoming delegation hashes for * @return delegationHashes Array of delegation hashes */ function getIncomingDelegationHashes( address to ) external view returns (bytes32[] memory delegationHashes); /** * @notice Returns all hashes associated with enabled delegations an address has given out * @param from The address to retrieve outgoing delegation hashes for * @return delegationHashes Array of delegation hashes */ function getOutgoingDelegationHashes( address from ) external view returns (bytes32[] memory delegationHashes); /** * @notice Returns the delegations for a given array of delegation hashes * @param delegationHashes is an array of hashes that correspond to delegations * @return delegations Array of Delegation structs, return empty structs for nonexistent or revoked delegations */ function getDelegationsFromHashes( bytes32[] calldata delegationHashes ) external view returns (Delegation[] memory delegations); /** * ----------- STORAGE ACCESS ----------- */ /** * @notice Allows external contracts to read arbitrary storage slots */ function readSlot(bytes32 location) external view returns (bytes32); /** * @notice Allows external contracts to read an arbitrary array of storage slots */ function readSlots( bytes32[] calldata locations ) external view returns (bytes32[] memory); } // File erc721a/contracts/[email protected] // Original license: SPDX_License_Identifier: MIT // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; /** * @dev Interface of ERC721A. */ interface IERC721A { /** * The caller must own the token or be an approved operator. */ error ApprovalCallerNotOwnerNorApproved(); /** * The token does not exist. */ error ApprovalQueryForNonexistentToken(); /** * Cannot query the balance for the zero address. */ error BalanceQueryForZeroAddress(); /** * Cannot mint to the zero address. */ error MintToZeroAddress(); /** * The quantity of tokens minted must be more than zero. */ error MintZeroQuantity(); /** * The token does not exist. */ error OwnerQueryForNonexistentToken(); /** * The caller must own the token or be an approved operator. */ error TransferCallerNotOwnerNorApproved(); /** * The token must be owned by `from`. */ error TransferFromIncorrectOwner(); /** * Cannot safely transfer to a contract that does not implement the * ERC721Receiver interface. */ error TransferToNonERC721ReceiverImplementer(); /** * Cannot transfer to the zero address. */ error TransferToZeroAddress(); /** * The token does not exist. */ error URIQueryForNonexistentToken(); /** * The `quantity` minted with ERC2309 exceeds the safety limit. */ error MintERC2309QuantityExceedsLimit(); /** * The `extraData` cannot be set on an unintialized ownership slot. */ error OwnershipNotInitializedForExtraData(); /** * `_sequentialUpTo()` must be greater than `_startTokenId()`. */ error SequentialUpToTooSmall(); /** * The `tokenId` of a sequential mint exceeds `_sequentialUpTo()`. */ error SequentialMintExceedsLimit(); /** * Spot minting requires a `tokenId` greater than `_sequentialUpTo()`. */ error SpotMintTokenIdTooSmall(); /** * Cannot mint over a token that already exists. */ error TokenAlreadyExists(); /** * The feature is not compatible with spot mints. */ error NotCompatibleWithSpotMints(); // ============================================================= // STRUCTS // ============================================================= struct TokenOwnership { // The address of the owner. address addr; // Stores the start time of ownership with minimal overhead for tokenomics. uint64 startTimestamp; // Whether the token has been burned. bool burned; // Arbitrary data similar to `startTimestamp` that can be set via {_extraData}. uint24 extraData; } // ============================================================= // TOKEN COUNTERS // ============================================================= /** * @dev Returns the total number of tokens in existence. * Burned tokens will reduce the count. * To get the total number of tokens minted, please see {_totalMinted}. */ function totalSupply() external view returns (uint256); // ============================================================= // IERC165 // ============================================================= /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified) * to learn more about how these ids are created. * * This function call must use less than 30000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); // ============================================================= // IERC721 // ============================================================= /** * @dev Emitted when `tokenId` token is transferred from `from` to `to`. */ event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. */ event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables or disables * (`approved`) `operator` to manage all of its assets. */ event ApprovalForAll(address indexed owner, address indexed operator, bool approved); /** * @dev Returns the number of tokens in `owner`'s account. */ function balanceOf(address owner) external view returns (uint256 balance); /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) external view returns (address owner); /** * @dev Safely transfers `tokenId` token from `from` to `to`, * checking first that contract recipients are aware of the ERC721 protocol * to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be have been allowed to move * this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes calldata data ) external payable; /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom( address from, address to, uint256 tokenId ) external payable; /** * @dev Transfers `tokenId` from `from` to `to`. * * WARNING: Usage of this method is discouraged, use {safeTransferFrom} * whenever possible. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) external payable; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the * zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external payable; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} * for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool _approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll}. */ function isApprovedForAll(address owner, address operator) external view returns (bool); // ============================================================= // IERC721Metadata // ============================================================= /** * @dev Returns the token collection name. */ function name() external view returns (string memory); /** * @dev Returns the token collection symbol. */ function symbol() external view returns (string memory); /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) external view returns (string memory); // ============================================================= // IERC2309 // ============================================================= /** * @dev Emitted when tokens in `fromTokenId` to `toTokenId` * (inclusive) is transferred from `from` to `to`, as defined in the * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard. * * See {_mintERC2309} for more details. */ event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to); } // File erc721a/contracts/[email protected] // Original license: SPDX_License_Identifier: MIT // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; /** * @dev Interface of ERC721 token receiver. */ interface ERC721A__IERC721Receiver { function onERC721Received( address operator, address from, uint256 tokenId, bytes calldata data ) external returns (bytes4); } /** * @title ERC721A * * @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721) * Non-Fungible Token Standard, including the Metadata extension. * Optimized for lower gas during batch mints. * * Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...) * starting from `_startTokenId()`. * * The `_sequentialUpTo()` function can be overriden to enable spot mints * (i.e. non-consecutive mints) for `tokenId`s greater than `_sequentialUpTo()`. * * Assumptions: * * - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply. * - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256). */ contract ERC721A is IERC721A { // Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364). struct TokenApprovalRef { address value; } // ============================================================= // CONSTANTS // ============================================================= // Mask of an entry in packed address data. uint256 private constant _BITMASK_ADDRESS_DATA_ENTRY = (1 << 64) - 1; // The bit position of `numberMinted` in packed address data. uint256 private constant _BITPOS_NUMBER_MINTED = 64; // The bit position of `numberBurned` in packed address data. uint256 private constant _BITPOS_NUMBER_BURNED = 128; // The bit position of `aux` in packed address data. uint256 private constant _BITPOS_AUX = 192; // Mask of all 256 bits in packed address data except the 64 bits for `aux`. uint256 private constant _BITMASK_AUX_COMPLEMENT = (1 << 192) - 1; // The bit position of `startTimestamp` in packed ownership. uint256 private constant _BITPOS_START_TIMESTAMP = 160; // The bit mask of the `burned` bit in packed ownership. uint256 private constant _BITMASK_BURNED = 1 << 224; // The bit position of the `nextInitialized` bit in packed ownership. uint256 private constant _BITPOS_NEXT_INITIALIZED = 225; // The bit mask of the `nextInitialized` bit in packed ownership. uint256 private constant _BITMASK_NEXT_INITIALIZED = 1 << 225; // The bit position of `extraData` in packed ownership. uint256 private constant _BITPOS_EXTRA_DATA = 232; // Mask of all 256 bits in a packed ownership except the 24 bits for `extraData`. uint256 private constant _BITMASK_EXTRA_DATA_COMPLEMENT = (1 << 232) - 1; // The mask of the lower 160 bits for addresses. uint256 private constant _BITMASK_ADDRESS = (1 << 160) - 1; // The maximum `quantity` that can be minted with {_mintERC2309}. // This limit is to prevent overflows on the address data entries. // For a limit of 5000, a total of 3.689e15 calls to {_mintERC2309} // is required to cause an overflow, which is unrealistic. uint256 private constant _MAX_MINT_ERC2309_QUANTITY_LIMIT = 5000; // The `Transfer` event signature is given by: // `keccak256(bytes("Transfer(address,address,uint256)"))`. bytes32 private constant _TRANSFER_EVENT_SIGNATURE = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef; // ============================================================= // STORAGE // ============================================================= // The next token ID to be minted. uint256 private _currentIndex; // The number of tokens burned. uint256 private _burnCounter; // Token name string private _name; // Token symbol string private _symbol; // Mapping from token ID to ownership details // An empty struct value does not necessarily mean the token is unowned. // See {_packedOwnershipOf} implementation for details. // // Bits Layout: // - [0..159] `addr` // - [160..223] `startTimestamp` // - [224] `burned` // - [225] `nextInitialized` // - [232..255] `extraData` mapping(uint256 => uint256) private _packedOwnerships; // Mapping owner address to address data. // // Bits Layout: // - [0..63] `balance` // - [64..127] `numberMinted` // - [128..191] `numberBurned` // - [192..255] `aux` mapping(address => uint256) private _packedAddressData; // Mapping from token ID to approved address. mapping(uint256 => TokenApprovalRef) private _tokenApprovals; // Mapping from owner to operator approvals mapping(address => mapping(address => bool)) private _operatorApprovals; // The amount of tokens minted above `_sequentialUpTo()`. // We call these spot mints (i.e. non-sequential mints). uint256 private _spotMinted; // ============================================================= // CONSTRUCTOR // ============================================================= constructor(string memory name_, string memory symbol_) { _name = name_; _symbol = symbol_; _currentIndex = _startTokenId(); if (_sequentialUpTo() < _startTokenId()) _revert(SequentialUpToTooSmall.selector); } // ============================================================= // TOKEN COUNTING OPERATIONS // ============================================================= /** * @dev Returns the starting token ID for sequential mints. * * Override this function to change the starting token ID for sequential mints. * * Note: The value returned must never change after any tokens have been minted. */ function _startTokenId() internal view virtual returns (uint256) { return 0; } /** * @dev Returns the maximum token ID (inclusive) for sequential mints. * * Override this function to return a value less than 2**256 - 1, * but greater than `_startTokenId()`, to enable spot (non-sequential) mints. * * Note: The value returned must never change after any tokens have been minted. */ function _sequentialUpTo() internal view virtual returns (uint256) { return type(uint256).max; } /** * @dev Returns the next token ID to be minted. */ function _nextTokenId() internal view virtual returns (uint256) { return _currentIndex; } /** * @dev Returns the total number of tokens in existence. * Burned tokens will reduce the count. * To get the total number of tokens minted, please see {_totalMinted}. */ function totalSupply() public view virtual override returns (uint256 result) { // Counter underflow is impossible as `_burnCounter` cannot be incremented // more than `_currentIndex + _spotMinted - _startTokenId()` times. unchecked { // With spot minting, the intermediate `result` can be temporarily negative, // and the computation must be unchecked. result = _currentIndex - _burnCounter - _startTokenId(); if (_sequentialUpTo() != type(uint256).max) result += _spotMinted; } } /** * @dev Returns the total amount of tokens minted in the contract. */ function _totalMinted() internal view virtual returns (uint256 result) { // Counter underflow is impossible as `_currentIndex` does not decrement, // and it is initialized to `_startTokenId()`. unchecked { result = _currentIndex - _startTokenId(); if (_sequentialUpTo() != type(uint256).max) result += _spotMinted; } } /** * @dev Returns the total number of tokens burned. */ function _totalBurned() internal view virtual returns (uint256) { return _burnCounter; } /** * @dev Returns the total number of tokens that are spot-minted. */ function _totalSpotMinted() internal view virtual returns (uint256) { return _spotMinted; } // ============================================================= // ADDRESS DATA OPERATIONS // ============================================================= /** * @dev Returns the number of tokens in `owner`'s account. */ function balanceOf(address owner) public view virtual override returns (uint256) { if (owner == address(0)) _revert(BalanceQueryForZeroAddress.selector); return _packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens minted by `owner`. */ function _numberMinted(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens burned by or on behalf of `owner`. */ function _numberBurned(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). */ function _getAux(address owner) internal view returns (uint64) { return uint64(_packedAddressData[owner] >> _BITPOS_AUX); } /** * Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). * If there are multiple variables, please pack them into a uint64. */ function _setAux(address owner, uint64 aux) internal virtual { uint256 packed = _packedAddressData[owner]; uint256 auxCasted; // Cast `aux` with assembly to avoid redundant masking. assembly { auxCasted := aux } packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX); _packedAddressData[owner] = packed; } // ============================================================= // IERC165 // ============================================================= /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified) * to learn more about how these ids are created. * * This function call must use less than 30000 gas. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { // The interface IDs are constants representing the first 4 bytes // of the XOR of all function selectors in the interface. // See: [ERC165](https://eips.ethereum.org/EIPS/eip-165) // (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`) return interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165. interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721. interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata. } // ============================================================= // IERC721Metadata // ============================================================= /** * @dev Returns the token collection name. */ function name() public view virtual override returns (string memory) { return _name; } /** * @dev Returns the token collection symbol. */ function symbol() public view virtual override returns (string memory) { return _symbol; } /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) public view virtual override returns (string memory) { if (!_exists(tokenId)) _revert(URIQueryForNonexistentToken.selector); string memory baseURI = _baseURI(); return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : ''; } /** * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each * token will be the concatenation of the `baseURI` and the `tokenId`. Empty * by default, it can be overridden in child contracts. */ function _baseURI() internal view virtual returns (string memory) { return ''; } // ============================================================= // OWNERSHIPS OPERATIONS // ============================================================= /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) public view virtual override returns (address) { return address(uint160(_packedOwnershipOf(tokenId))); } /** * @dev Gas spent here starts off proportional to the maximum mint batch size. * It gradually moves to O(1) as tokens get transferred around over time. */ function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnershipOf(tokenId)); } /** * @dev Returns the unpacked `TokenOwnership` struct at `index`. */ function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnerships[index]); } /** * @dev Returns whether the ownership slot at `index` is initialized. * An uninitialized slot does not necessarily mean that the slot has no owner. */ function _ownershipIsInitialized(uint256 index) internal view virtual returns (bool) { return _packedOwnerships[index] != 0; } /** * @dev Initializes the ownership slot minted at `index` for efficiency purposes. */ function _initializeOwnershipAt(uint256 index) internal virtual { if (_packedOwnerships[index] == 0) { _packedOwnerships[index] = _packedOwnershipOf(index); } } /** * @dev Returns the packed ownership data of `tokenId`. */ function _packedOwnershipOf(uint256 tokenId) private view returns (uint256 packed) { if (_startTokenId() <= tokenId) { packed = _packedOwnerships[tokenId]; if (tokenId > _sequentialUpTo()) { if (_packedOwnershipExists(packed)) return packed; _revert(OwnerQueryForNonexistentToken.selector); } // If the data at the starting slot does not exist, start the scan. if (packed == 0) { if (tokenId >= _currentIndex) _revert(OwnerQueryForNonexistentToken.selector); // Invariant: // There will always be an initialized ownership slot // (i.e. `ownership.addr != address(0) && ownership.burned == false`) // before an unintialized ownership slot // (i.e. `ownership.addr == address(0) && ownership.burned == false`) // Hence, `tokenId` will not underflow. // // We can directly compare the packed value. // If the address is zero, packed will be zero. for (;;) { unchecked { packed = _packedOwnerships[--tokenId]; } if (packed == 0) continue; if (packed & _BITMASK_BURNED == 0) return packed; // Otherwise, the token is burned, and we must revert. // This handles the case of batch burned tokens, where only the burned bit // of the starting slot is set, and remaining slots are left uninitialized. _revert(OwnerQueryForNonexistentToken.selector); } } // Otherwise, the data exists and we can skip the scan. // This is possible because we have already achieved the target condition. // This saves 2143 gas on transfers of initialized tokens. // If the token is not burned, return `packed`. Otherwise, revert. if (packed & _BITMASK_BURNED == 0) return packed; } _revert(OwnerQueryForNonexistentToken.selector); } /** * @dev Returns the unpacked `TokenOwnership` struct from `packed`. */ function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) { ownership.addr = address(uint160(packed)); ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP); ownership.burned = packed & _BITMASK_BURNED != 0; ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA); } /** * @dev Packs ownership data into a single uint256. */ function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`. result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags)) } } /** * @dev Returns the `nextInitialized` flag set if `quantity` equals 1. */ function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) { // For branchless setting of the `nextInitialized` flag. assembly { // `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`. result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1)) } } // ============================================================= // APPROVAL OPERATIONS // ============================================================= /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. See {ERC721A-_approve}. * * Requirements: * * - The caller must own the token or be an approved operator. */ function approve(address to, uint256 tokenId) public payable virtual override { _approve(to, tokenId, true); } /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) public view virtual override returns (address) { if (!_exists(tokenId)) _revert(ApprovalQueryForNonexistentToken.selector); return _tokenApprovals[tokenId].value; } /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} * for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool approved) public virtual override { _operatorApprovals[_msgSenderERC721A()][operator] = approved; emit ApprovalForAll(_msgSenderERC721A(), operator, approved); } /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll}. */ function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) { return _operatorApprovals[owner][operator]; } /** * @dev Returns whether `tokenId` exists. * * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}. * * Tokens start existing when they are minted. See {_mint}. */ function _exists(uint256 tokenId) internal view virtual returns (bool result) { if (_startTokenId() <= tokenId) { if (tokenId > _sequentialUpTo()) return _packedOwnershipExists(_packedOwnerships[tokenId]); if (tokenId < _currentIndex) { uint256 packed; while ((packed = _packedOwnerships[tokenId]) == 0) --tokenId; result = packed & _BITMASK_BURNED == 0; } } } /** * @dev Returns whether `packed` represents a token that exists. */ function _packedOwnershipExists(uint256 packed) private pure returns (bool result) { assembly { // The following is equivalent to `owner != address(0) && burned == false`. // Symbolically tested. result := gt(and(packed, _BITMASK_ADDRESS), and(packed, _BITMASK_BURNED)) } } /** * @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`. */ function _isSenderApprovedOrOwner( address approvedAddress, address owner, address msgSender ) private pure returns (bool result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean. msgSender := and(msgSender, _BITMASK_ADDRESS) // `msgSender == owner || msgSender == approvedAddress`. result := or(eq(msgSender, owner), eq(msgSender, approvedAddress)) } } /** * @dev Returns the storage slot and value for the approved address of `tokenId`. */ function _getApprovedSlotAndAddress(uint256 tokenId) private view returns (uint256 approvedAddressSlot, address approvedAddress) { TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId]; // The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`. assembly { approvedAddressSlot := tokenApproval.slot approvedAddress := sload(approvedAddressSlot) } } // ============================================================= // TRANSFER OPERATIONS // ============================================================= /** * @dev Transfers `tokenId` from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) public payable virtual override { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); // Mask `from` to the lower 160 bits, in case the upper bits somehow aren't clean. from = address(uint160(uint256(uint160(from)) & _BITMASK_ADDRESS)); if (address(uint160(prevOwnershipPacked)) != from) _revert(TransferFromIncorrectOwner.selector); (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId); // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A())) if (!isApprovedForAll(from, _msgSenderERC721A())) _revert(TransferCallerNotOwnerNorApproved.selector); _beforeTokenTransfers(from, to, tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // We can directly increment and decrement the balances. --_packedAddressData[from]; // Updates: `balance -= 1`. ++_packedAddressData[to]; // Updates: `balance += 1`. // Updates: // - `address` to the next owner. // - `startTimestamp` to the timestamp of transfering. // - `burned` to `false`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData( to, _BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked) ); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS; assembly { // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. from, // `from`. toMasked, // `to`. tokenId // `tokenId`. ) } if (toMasked == 0) _revert(TransferToZeroAddress.selector); _afterTokenTransfers(from, to, tokenId, 1); } /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom( address from, address to, uint256 tokenId ) public payable virtual override { safeTransferFrom(from, to, tokenId, ''); } /** * @dev Safely transfers `tokenId` token from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes memory _data ) public payable virtual override { transferFrom(from, to, tokenId); if (to.code.length != 0) if (!_checkContractOnERC721Received(from, to, tokenId, _data)) { _revert(TransferToNonERC721ReceiverImplementer.selector); } } /** * @dev Hook that is called before a set of serially-ordered token IDs * are about to be transferred. This includes minting. * And also called before burning one token. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _beforeTokenTransfers( address from, address to, uint256 startTokenId, uint256 quantity ) internal virtual {} /** * @dev Hook that is called after a set of serially-ordered token IDs * have been transferred. This includes minting. * And also called after one token has been burned. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` has been * transferred to `to`. * - When `from` is zero, `tokenId` has been minted for `to`. * - When `to` is zero, `tokenId` has been burned by `from`. * - `from` and `to` are never both zero. */ function _afterTokenTransfers( address from, address to, uint256 startTokenId, uint256 quantity ) internal virtual {} /** * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract. * * `from` - Previous owner of the given token ID. * `to` - Target address that will receive the token. * `tokenId` - Token ID to be transferred. * `_data` - Optional data to send along with the call. * * Returns whether the call correctly returned the expected magic value. */ function _checkContractOnERC721Received( address from, address to, uint256 tokenId, bytes memory _data ) private returns (bool) { try ERC721A__IERC721Receiver(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns ( bytes4 retval ) { return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector; } catch (bytes memory reason) { if (reason.length == 0) { _revert(TransferToNonERC721ReceiverImplementer.selector); } assembly { revert(add(32, reason), mload(reason)) } } } // ============================================================= // MINT OPERATIONS // ============================================================= /** * @dev Mints `quantity` tokens and transfers them to `to`. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {Transfer} event for each mint. */ function _mint(address to, uint256 quantity) internal virtual { uint256 startTokenId = _currentIndex; if (quantity == 0) _revert(MintZeroQuantity.selector); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are incredibly unrealistic. // `balance` and `numberMinted` have a maximum limit of 2**64. // `tokenId` has a maximum limit of 2**256. unchecked { // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1); // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS; if (toMasked == 0) _revert(MintToZeroAddress.selector); uint256 end = startTokenId + quantity; uint256 tokenId = startTokenId; if (end - 1 > _sequentialUpTo()) _revert(SequentialMintExceedsLimit.selector); do { assembly { // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. 0, // `address(0)`. toMasked, // `to`. tokenId // `tokenId`. ) } // The `!=` check ensures that large values of `quantity` // that overflows uint256 will make the loop run out of gas. } while (++tokenId != end); _currentIndex = end; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev Mints `quantity` tokens and transfers them to `to`. * * This function is intended for efficient minting only during contract creation. * * It emits only one {ConsecutiveTransfer} as defined in * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309), * instead of a sequence of {Transfer} event(s). * * Calling this function outside of contract creation WILL make your contract * non-compliant with the ERC721 standard. * For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309 * {ConsecutiveTransfer} event is only permissible during contract creation. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {ConsecutiveTransfer} event. */ function _mintERC2309(address to, uint256 quantity) internal virtual { uint256 startTokenId = _currentIndex; if (to == address(0)) _revert(MintToZeroAddress.selector); if (quantity == 0) _revert(MintZeroQuantity.selector); if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) _revert(MintERC2309QuantityExceedsLimit.selector); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are unrealistic due to the above check for `quantity` to be below the limit. unchecked { // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1); // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); if (startTokenId + quantity - 1 > _sequentialUpTo()) _revert(SequentialMintExceedsLimit.selector); emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to); _currentIndex = startTokenId + quantity; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev Safely mints `quantity` tokens and transfers them to `to`. * * Requirements: * * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called for each safe transfer. * - `quantity` must be greater than 0. * * See {_mint}. * * Emits a {Transfer} event for each mint. */ function _safeMint( address to, uint256 quantity, bytes memory _data ) internal virtual { _mint(to, quantity); unchecked { if (to.code.length != 0) { uint256 end = _currentIndex; uint256 index = end - quantity; do { if (!_checkContractOnERC721Received(address(0), to, index++, _data)) { _revert(TransferToNonERC721ReceiverImplementer.selector); } } while (index < end); // This prevents reentrancy to `_safeMint`. // It does not prevent reentrancy to `_safeMintSpot`. if (_currentIndex != end) revert(); } } } /** * @dev Equivalent to `_safeMint(to, quantity, '')`. */ function _safeMint(address to, uint256 quantity) internal virtual { _safeMint(to, quantity, ''); } /** * @dev Mints a single token at `tokenId`. * * Note: A spot-minted `tokenId` that has been burned can be re-minted again. * * Requirements: * * - `to` cannot be the zero address. * - `tokenId` must be greater than `_sequentialUpTo()`. * - `tokenId` must not exist. * * Emits a {Transfer} event for each mint. */ function _mintSpot(address to, uint256 tokenId) internal virtual { if (tokenId <= _sequentialUpTo()) _revert(SpotMintTokenIdTooSmall.selector); uint256 prevOwnershipPacked = _packedOwnerships[tokenId]; if (_packedOwnershipExists(prevOwnershipPacked)) _revert(TokenAlreadyExists.selector); _beforeTokenTransfers(address(0), to, tokenId, 1); // Overflows are incredibly unrealistic. // The `numberMinted` for `to` is incremented by 1, and has a max limit of 2**64 - 1. // `_spotMinted` is incremented by 1, and has a max limit of 2**256 - 1. unchecked { // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `true` (as `quantity == 1`). _packedOwnerships[tokenId] = _packOwnershipData( to, _nextInitializedFlag(1) | _nextExtraData(address(0), to, prevOwnershipPacked) ); // Updates: // - `balance += 1`. // - `numberMinted += 1`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += (1 << _BITPOS_NUMBER_MINTED) | 1; // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS; if (toMasked == 0) _revert(MintToZeroAddress.selector); assembly { // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. 0, // `address(0)`. toMasked, // `to`. tokenId // `tokenId`. ) } ++_spotMinted; } _afterTokenTransfers(address(0), to, tokenId, 1); } /** * @dev Safely mints a single token at `tokenId`. * * Note: A spot-minted `tokenId` that has been burned can be re-minted again. * * Requirements: * * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}. * - `tokenId` must be greater than `_sequentialUpTo()`. * - `tokenId` must not exist. * * See {_mintSpot}. * * Emits a {Transfer} event. */ function _safeMintSpot( address to, uint256 tokenId, bytes memory _data ) internal virtual { _mintSpot(to, tokenId); unchecked { if (to.code.length != 0) { uint256 currentSpotMinted = _spotMinted; if (!_checkContractOnERC721Received(address(0), to, tokenId, _data)) { _revert(TransferToNonERC721ReceiverImplementer.selector); } // This prevents reentrancy to `_safeMintSpot`. // It does not prevent reentrancy to `_safeMint`. if (_spotMinted != currentSpotMinted) revert(); } } } /** * @dev Equivalent to `_safeMintSpot(to, tokenId, '')`. */ function _safeMintSpot(address to, uint256 tokenId) internal virtual { _safeMintSpot(to, tokenId, ''); } // ============================================================= // APPROVAL OPERATIONS // ============================================================= /** * @dev Equivalent to `_approve(to, tokenId, false)`. */ function _approve(address to, uint256 tokenId) internal virtual { _approve(to, tokenId, false); } /** * @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: * * - `tokenId` must exist. * * Emits an {Approval} event. */ function _approve( address to, uint256 tokenId, bool approvalCheck ) internal virtual { address owner = ownerOf(tokenId); if (approvalCheck && _msgSenderERC721A() != owner) if (!isApprovedForAll(owner, _msgSenderERC721A())) { _revert(ApprovalCallerNotOwnerNorApproved.selector); } _tokenApprovals[tokenId].value = to; emit Approval(owner, to, tokenId); } // ============================================================= // BURN OPERATIONS // ============================================================= /** * @dev Equivalent to `_burn(tokenId, false)`. */ function _burn(uint256 tokenId) internal virtual { _burn(tokenId, false); } /** * @dev Destroys `tokenId`. * The approval is cleared when the token is burned. * * Requirements: * * - `tokenId` must exist. * * Emits a {Transfer} event. */ function _burn(uint256 tokenId, bool approvalCheck) internal virtual { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); address from = address(uint160(prevOwnershipPacked)); (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId); if (approvalCheck) { // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A())) if (!isApprovedForAll(from, _msgSenderERC721A())) _revert(TransferCallerNotOwnerNorApproved.selector); } _beforeTokenTransfers(from, address(0), tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // Updates: // - `balance -= 1`. // - `numberBurned += 1`. // // We can directly decrement the balance, and increment the number burned. // This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`. _packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1; // Updates: // - `address` to the last owner. // - `startTimestamp` to the timestamp of burning. // - `burned` to `true`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData( from, (_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked) ); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } emit Transfer(from, address(0), tokenId); _afterTokenTransfers(from, address(0), tokenId, 1); // Overflow not possible, as `_burnCounter` cannot be exceed `_currentIndex + _spotMinted` times. unchecked { _burnCounter++; } } // ============================================================= // EXTRA DATA OPERATIONS // ============================================================= /** * @dev Directly sets the extra data for the ownership data `index`. */ function _setExtraDataAt(uint256 index, uint24 extraData) internal virtual { uint256 packed = _packedOwnerships[index]; if (packed == 0) _revert(OwnershipNotInitializedForExtraData.selector); uint256 extraDataCasted; // Cast `extraData` with assembly to avoid redundant masking. assembly { extraDataCasted := extraData } packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA); _packedOwnerships[index] = packed; } /** * @dev Called during each token transfer to set the 24bit `extraData` field. * Intended to be overridden by the cosumer contract. * * `previousExtraData` - the value of `extraData` before transfer. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _extraData( address from, address to, uint24 previousExtraData ) internal view virtual returns (uint24) {} /** * @dev Returns the next extra data for the packed ownership data. * The returned result is shifted into position. */ function _nextExtraData( address from, address to, uint256 prevOwnershipPacked ) private view returns (uint256) { uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA); return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA; } // ============================================================= // OTHER OPERATIONS // ============================================================= /** * @dev Returns the message sender (defaults to `msg.sender`). * * If you are writing GSN compatible contracts, you need to override this function. */ function _msgSenderERC721A() internal view virtual returns (address) { return msg.sender; } /** * @dev Converts a uint256 to its ASCII string decimal representation. */ function _toString(uint256 value) internal pure virtual returns (string memory str) { assembly { // The maximum value of a uint256 contains 78 digits (1 byte per digit), but // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned. // We will need 1 word for the trailing zeros padding, 1 word for the length, // and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0. let m := add(mload(0x40), 0xa0) // Update the free memory pointer to allocate. mstore(0x40, m) // Assign the `str` to the end. str := sub(m, 0x20) // Zeroize the slot after the string. mstore(str, 0) // Cache the end of the memory to calculate the length later. let end := str // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. // prettier-ignore for { let temp := value } 1 {} { str := sub(str, 1) // Write the character to the pointer. // The ASCII index of the '0' character is 48. mstore8(str, add(48, mod(temp, 10))) // Keep dividing `temp` until zero. temp := div(temp, 10) // prettier-ignore if iszero(temp) { break } } let length := sub(end, str) // Move the pointer 32 bytes leftwards to make room for the length. str := sub(str, 0x20) // Store the length. mstore(str, length) } } /** * @dev For more efficient reverts. */ function _revert(bytes4 errorSelector) internal pure { assembly { mstore(0x00, errorSelector) revert(0x00, 0x04) } } } // File contracts/main-contracts/Zoo_Eve.sol // Original license: SPDX_License_Identifier: UNLICENSED pragma solidity ^0.8.24; error MintInactive(); error Unauthorized(address caller); error InvalidOperation(string reason); error ExceedsMaxSupply(uint256 requested, uint256 available); error InsufficientEther(uint256 required, uint256 provided); error ExceedsMaxPerWallet(uint256 requested, uint256 allowed); error ExceedsMintQuota(uint256 requested, uint256 allowed); error ExceedsMaxMintGroupSupply(uint256 requested, uint256 available); // Remove when allowlist is off error MintGroupInactive(uint256 mintId); // Remove when allowlist is off error NotInPresale(address caller, uint256 mintId); // Remove when allowlist is off error MintGroupDoesNotExist(uint256 mintId); // Remove when allowlist is off error ArrayLengthMismatch(); // Remove when allowlist is off error InvalidKingdomlyFeeContract(); error InvalidMintCode(); error MintCodeAlreadyUsed(); contract Zoo_Eve is ERC721A, ERC2981, Ownable { event BatchMetadataUpdate( uint256 indexed fromTokenId, uint256 indexed toTokenId ); event TokensMinted( address indexed recipient, uint256 amount, uint256 mintId ); event TokensDelegateMinted( address indexed vault, address indexed hotWallet, uint256 amount, uint256 mintId ); event SalePriceChanged(uint256 indexed mintId, uint256 newPrice); event MaxMintPerWalletChanged( uint256 newMaxMintPerWallet, uint256 mintGroupId ); event PreSaleMintStatusChanged(bool status, uint256 mintGroupId); event PreSaleMintScheduledStartTimestampChanged( uint256 timestamp, uint256 mintGroupId ); event KingdomlyFeeContractChanged(address feeContractAddress); struct BaseVariables { string name; string symbol; address ownerPayoutAddress; string initialBaseURI; uint256 maxSupply; } //Base variables mapping(address => uint256) private pendingBalances; uint256 public maxSupply; uint256 public immutable threeDollarsInCents; bool public contractMintLive = false; uint256 public scheduledMintLiveTimestamp = 0; string public baseURI; address public feeAddress; address public ownerPayoutAddress; address public kingdomlyAdmin; KingdomlyFeeContract public kingdomlyFeeContract; mapping(bytes32 => bool) public claimedMintCode; bytes32 public mintRoot; //Map pairings. mapping(uint256 => uint256) public maxMintPerWallet; mapping(uint256 => uint256) public mintPrice; mapping(uint256 => uint256) public maxSupplyPerMintGroup; mapping(uint256 => uint256) public mintGroupMints; mapping(address => mapping(uint256 => uint256)) private addressMints; // Added address mints for mint group cap mapping(uint256 => mapping(address => uint256)) public mintQuotas; // Changed presale checker to mintQuotas for individual addresses mapping(uint256 => bool) public contractPresaleActive; mapping(uint256 => uint256) public presaleScheduledStartTimestamp; uint256[] public activeMintGroups; //Array to get all active mint groups. Remove when allowlist is off constructor( //Base variables BaseVariables memory _baseVariables, //Allowlist variables uint256[] memory _maxMintPerWallet, // Turn into uint256 if allowlist is off uint256[] memory _maxSupplyPerMintGroup, // Remove if allowlist is off uint256[] memory _mintPrice, // Turn into uint256 if allowlist is off //Royalties variables uint96 _royaltyPercentage, // Remove if royalties is off address _kingdomlyAdmin, KingdomlyFeeContract _kingdomlyFeeContract, bytes32 _mintRoot ) ERC721A(_baseVariables.name, _baseVariables.symbol) Ownable(msg.sender) { //Error handler to check if map pairs each other. Remove if allowlist is off if ( _maxMintPerWallet.length != _maxSupplyPerMintGroup.length && _maxMintPerWallet.length != _mintPrice.length ) { revert ArrayLengthMismatch(); } //Remove if allowlist is off uint256 totalMaxSupplyPerMintGroup = 0; for (uint256 i = 0; i < _maxSupplyPerMintGroup.length; i++) { totalMaxSupplyPerMintGroup += _maxSupplyPerMintGroup[i]; maxSupplyPerMintGroup[i] = _maxSupplyPerMintGroup[i]; maxMintPerWallet[i] = _maxMintPerWallet[i]; mintPrice[i] = _mintPrice[i]; mintGroupMints[i] = 0; activeMintGroups.push(i); } //Checker if max supply per mint group exceeds total max supply. Remove if allowlist is off if (totalMaxSupplyPerMintGroup > _baseVariables.maxSupply) { revert InvalidOperation({ reason: "Max supply per mint group exceeds total max supply" }); } //Base variables maxSupply = _baseVariables.maxSupply; baseURI = _baseVariables.initialBaseURI; ownerPayoutAddress = _baseVariables.ownerPayoutAddress; feeAddress = 0x428Deb81A93BeD820068724eb1fCc7503d71e417; // Setting up royalties and affiliate percentage _setDefaultRoyalty( _baseVariables.ownerPayoutAddress, _royaltyPercentage ); // FEE Variables kingdomlyAdmin = _kingdomlyAdmin; kingdomlyFeeContract = _kingdomlyFeeContract; threeDollarsInCents = 300; // $3 * 100 = 300 mintRoot = _mintRoot; } // ###################### Modifiers ###################### /** * @dev Ensures the caller is the Kingdomly Admin. */ modifier isKingdomlyAdmin() { if (msg.sender != kingdomlyAdmin) { revert Unauthorized(msg.sender); } _; } //===================================START Allowlist Functions===================================// // Initializer for new mint groups for all maps function initializeNewMintGroup(uint256 mintId) internal { mintPrice[mintId] = 0; maxMintPerWallet[mintId] = 0; maxSupplyPerMintGroup[mintId] = 0; mintGroupMints[mintId] = 0; activeMintGroups.push(mintId); } function isMintGroupActive(uint256 mintId) private view returns (bool) { for (uint256 i = 0; i < activeMintGroups.length; i++) { if (activeMintGroups[i] == mintId) { return true; } } return false; } function mintLive() public view returns (bool) { if (!contractMintLive) { if ( scheduledMintLiveTimestamp == 0 || block.timestamp <= scheduledMintLiveTimestamp ) { return false; } } return true; } // Changes the max mint per mint group. Only the contract owner can call this function. Remove this function if allowlist is off function setNewMaxPerMintGroup( uint256 mintId, uint256 newMax ) public onlyOwner { //Checks if mintId already exists inside activeMintGroups. This allows the contract to adjust the mappings for new mint groups if (!isMintGroupActive(mintId)) { initializeNewMintGroup(mintId); } // Checker if new max exceeds total supply uint256 totalMaxMintPerMG = 0; for (uint256 i = 0; i < activeMintGroups.length; i++) { if (activeMintGroups[i] == mintId) { totalMaxMintPerMG += newMax; // Use the new max for the specified mintId } else { totalMaxMintPerMG += maxSupplyPerMintGroup[activeMintGroups[i]]; } } if (totalMaxMintPerMG > maxSupply) { revert InvalidOperation({ reason: "New supply per mint group exceeds total supply." }); } maxSupplyPerMintGroup[mintId] = newMax; } // Changed add to presale to set mint quota for individual addresses. function setMintQuota( address[] memory addressToAdd, uint256 mintId, uint256[] memory _mintQuotas ) external onlyOwner { //Checks if mintId already exists inside activeMintGroups. This allows the contract to adjust the mappings for new mint groups if (!isMintGroupActive(mintId)) { initializeNewMintGroup(mintId); } for (uint256 i = 0; i < addressToAdd.length; i++) { mintQuotas[mintId][addressToAdd[i]] = _mintQuotas[i]; } } // Control the presale status function stopOrStartpresaleMint( bool presaleStatus, uint256 mintId ) public onlyOwner { //Checks if mintId already exists inside activeMintGroups. if (!isMintGroupActive(mintId)) { revert MintGroupDoesNotExist({mintId: mintId}); } contractPresaleActive[mintId] = presaleStatus; if (presaleStatus == false) { presaleScheduledStartTimestamp[mintId] = 0; } emit PreSaleMintStatusChanged(presaleStatus, mintId); } function schedulePresaleMintStart( uint256 startTimestamp, uint256 mintId ) public onlyOwner { if (!isMintGroupActive(mintId)) { revert MintGroupDoesNotExist({mintId: mintId}); } presaleScheduledStartTimestamp[mintId] = startTimestamp; emit PreSaleMintScheduledStartTimestampChanged(startTimestamp, mintId); } //Checker whether presale is already active both on timestmap and the mapping function presaleActive(uint256 mintId) public view returns (bool) { if (!contractPresaleActive[mintId]) { if ( presaleScheduledStartTimestamp[mintId] == 0 || block.timestamp <= presaleScheduledStartTimestamp[mintId] ) { return false; } } return true; } //===================================END Allowlist Functions===================================// // Sets the maximum number of tokens that can be minted in a batch. Only the contract owner can call this function. function setMaxMintPerWallet( uint256 newMaxMintPerWallet, uint256 mintGroupId ) public onlyOwner { maxMintPerWallet[mintGroupId] = newMaxMintPerWallet; emit MaxMintPerWalletChanged(newMaxMintPerWallet, mintGroupId); } // Changes the price to mint a token. Only the contract owner can call this function. function changeSalePrice( uint256 newmintPrice, uint256 mintId ) public onlyOwner { //Checks if mintId already exists inside activeMintGroups. This allows the contract to adjust the mappings for new mint groups if (!isMintGroupActive(mintId)) { initializeNewMintGroup(mintId); } mintPrice[mintId] = newmintPrice; emit SalePriceChanged(mintId, newmintPrice); } //===================================START Airdrop Functions===================================// // Modified airdrop function to charge the owner threeDollarsEth per mint function airdropNFTs( address[] memory recipients, uint256[] memory amounts ) external payable onlyOwner returns (uint256 totalCharge) { if (recipients.length != amounts.length) { revert InvalidOperation({ reason: "Mismatch between recipients and amounts" }); } uint256 totalNFTToMint = 0; for (uint256 i = 0; i < amounts.length; i++) { totalNFTToMint += amounts[i]; } totalCharge = quoteAirdropFees(totalNFTToMint); if (msg.value < totalCharge) { revert InvalidOperation({ reason: "Not enough Ether sent for the airdrop charge" }); } pendingBalances[feeAddress] += totalCharge; // Fee goes to the fee address for (uint256 j = 0; j < recipients.length; j++) { uint256 amount = amounts[j]; if (totalSupply() + amount > maxSupply) { revert InvalidOperation({reason: "Airdrop exceeds max supply"}); } _safeMint(recipients[j], amount); // Mint NFTs to recipients } _refundExcessEther(totalCharge); } //===================================END Airdrop Functions===================================// //===================================START Mint Functions===================================// function canMintCheck( uint256 amount, uint256 mintId, address minterAddress ) public view returns (bool) { if ( amount + addressMints[minterAddress][mintId] > maxMintPerWallet[mintId] ) { return false; } if (amount == 0) { return false; } // Pre-conditions checks if (!mintLive()) { return false; } if (!contractPresaleActive[mintId]) { if ( presaleScheduledStartTimestamp[mintId] == 0 || block.timestamp <= presaleScheduledStartTimestamp[mintId] ) { return false; } } if (mintId != 0) { if (mintQuotas[mintId][minterAddress] == 0) { return false; } if (amount > mintQuotas[mintId][minterAddress]) { return false; } } if (mintGroupMints[mintId] + amount > maxSupplyPerMintGroup[mintId]) { return false; } if (totalSupply() + amount > maxSupply) { return false; } return true; } // Cleaner and more efficient batchMint function function batchMint( uint256 amount, uint256 mintId, // Remove if allowlist is off bytes32[] calldata proof, bytes32 mintCode ) external payable returns (uint256 totalCostWithFee) { // Checker for connected wallet if (claimedMintCode[mintCode]) { revert MintCodeAlreadyUsed(); } if ( amount + addressMints[msg.sender][mintId] > maxMintPerWallet[mintId] ) { revert ExceedsMaxPerWallet({ requested: amount, allowed: maxMintPerWallet[mintId] - addressMints[msg.sender][mintId] }); } if (!MerkleProof.verify(proof, mintRoot, mintCode)) { revert InvalidMintCode(); } claimedMintCode[mintCode] = true; addressMints[msg.sender][mintId] += amount; // NOTE: Checks and Effects should always be before (avoid reentrancy!) totalCostWithFee = _batchMint(msg.sender, amount, mintId); emit TokensMinted(msg.sender, amount, mintId); _refundExcessEther(totalCostWithFee); } //==================START Delegate Functions==================// address constant DELEGATE_REGISTRY = 0x00000000000000447e69651d841bD8D104Bed493; function canDelegateMintCheck( uint256 amount, uint256 mintId, address vault, address minterAddress ) public view returns (bool) { if ( !IDelegateRegistry(DELEGATE_REGISTRY).checkDelegateForContract( minterAddress, vault, address(this), "" ) ) { return false; } if (amount + addressMints[vault][mintId] > maxMintPerWallet[mintId]) { return false; } if (amount == 0) { return false; } // Pre-conditions checks if (!mintLive()) { return false; } if (!contractPresaleActive[mintId]) { if ( presaleScheduledStartTimestamp[mintId] == 0 || block.timestamp <= presaleScheduledStartTimestamp[mintId] ) { return false; } } if (mintId != 0) { if (mintQuotas[mintId][minterAddress] == 0) { return false; } if (amount > mintQuotas[mintId][minterAddress]) { return false; } } if (mintGroupMints[mintId] + amount > maxSupplyPerMintGroup[mintId]) { return false; } if (totalSupply() + amount > maxSupply) { return false; } return true; } function delegatedMint( uint256 amount, uint256 mintId, address vault, bytes32[] calldata proof, bytes32 mintCode ) external payable returns (uint256 totalCostWithFee) { if (claimedMintCode[mintCode]) { revert MintCodeAlreadyUsed(); } if ( !IDelegateRegistry(DELEGATE_REGISTRY).checkDelegateForContract( msg.sender, vault, address(this), "" ) ) { revert Unauthorized(vault); } // Checker for vault wallet if (amount + addressMints[vault][mintId] > maxMintPerWallet[mintId]) { revert ExceedsMaxPerWallet({ requested: amount, allowed: maxMintPerWallet[mintId] - addressMints[vault][mintId] }); } if (!MerkleProof.verify(proof, mintRoot, mintCode)) { revert InvalidMintCode(); } claimedMintCode[mintCode] = true; addressMints[vault][mintId] += amount; // NOTE: Checks and Effects should always be before (avoid reentrancy!) totalCostWithFee = _batchMint(vault, amount, mintId); emit TokensDelegateMinted(vault, msg.sender, amount, mintId); _refundExcessEther(totalCostWithFee); } //==================START Internal Mint Functions==================// function _batchMint( address delegatedCaller, uint256 amount, uint256 mintId ) internal returns (uint256) { if (amount == 0) { revert InvalidOperation({reason: "Amount must be greater than 0"}); } // Pre-conditions checks if (!mintLive()) { revert MintInactive(); } if (!contractPresaleActive[mintId]) { if ( presaleScheduledStartTimestamp[mintId] == 0 || block.timestamp <= presaleScheduledStartTimestamp[mintId] ) { revert MintGroupInactive({mintId: mintId}); } } if (mintId != 0) { if (mintQuotas[mintId][delegatedCaller] == 0) { revert NotInPresale({caller: delegatedCaller, mintId: mintId}); } if (amount > mintQuotas[mintId][delegatedCaller]) { revert ExceedsMintQuota({ requested: amount, allowed: mintQuotas[mintId][delegatedCaller] }); } mintQuotas[mintId][delegatedCaller] -= amount; } if (mintGroupMints[mintId] + amount > maxSupplyPerMintGroup[mintId]) { revert ExceedsMaxMintGroupSupply({ requested: amount, available: maxSupplyPerMintGroup[mintId] - mintGroupMints[mintId] }); } if (totalSupply() + amount > maxSupply) { revert ExceedsMaxSupply({ requested: amount, available: maxSupply - totalSupply() }); } // Calculate fees, check if we have enough msg.value (uint256 totalCostWithFee, uint256 feeAmount) = quoteBatchMint( mintId, amount ); if (msg.value < totalCostWithFee) { revert InsufficientEther({ required: totalCostWithFee, provided: msg.value }); } // Update balances pendingBalances[feeAddress] += feeAmount; pendingBalances[ownerPayoutAddress] += totalCostWithFee - feeAmount; // Finalize minting mintGroupMints[mintId] += amount; _safeMint(msg.sender, amount); return totalCostWithFee; } // @notice Quote the total cost of minting a batch of tokens // @dev This is the same price for both the owner and the delegate // @param mintId The mint group ID // @param amount The number of tokens to mint // @return totalCostWithFee The total cost of minting the batch, including the fee // @return feeAmount The fee amount only for minting the batch function quoteBatchMint( uint256 mintId, uint256 amount ) public view returns (uint256 totalCostWithFee, uint256 feeAmount) { uint256 totalCost = mintPrice[mintId] * amount; feeAmount = ((totalCost * 3) / 100) + (threeDollarsEth() * amount); // 3% + 3$ fee totalCostWithFee = totalCost + feeAmount; } // @notice Quote the total cost of airdropping a batch of tokens // @param amount The number of tokens to mint // @return totalAirdropCostWithFee The total cost of minting the batch ($0.33 per nft) function quoteAirdropFees( uint256 amount ) public view returns (uint256 totalAirdropCostWithFee) { totalAirdropCostWithFee = (threeDollarsEth() * amount * 11) / 100; // UPDATE: Changed airdrop fees to be $0.33 instead. } //==================END Delegate Functions==================// //===================================END Mint Functions===================================// //===================================START Base Functions===================================// // Changes the minting status. Only the contract owner can call this function. function changeMintStatus(bool status) public onlyOwner { if (contractMintLive == status) { revert InvalidOperation({ reason: "Mint status is already the one you entered" }); } if (status == false) { scheduledMintLiveTimestamp = 0; } contractMintLive = status; } function setMintLiveTimestamp(uint256 timestamp) public onlyOwner { scheduledMintLiveTimestamp = timestamp; } // Sets the base URI for the token metadata. Only the contract owner can call this function. function setBaseURI(string memory newBaseURI) public onlyOwner { baseURI = newBaseURI; emit BatchMetadataUpdate(1, type(uint256).max); // Signal that all token metadata has been updated } function _withdrawFor(address user) internal returns (uint256 payout) { payout = pendingBalances[user]; pendingBalances[user] = 0; (bool success, ) = payable(user).call{value: payout}(""); if (!success) { revert InvalidOperation({reason: "Withdraw Transfer Failed"}); } } // Allows the contract owner to withdraw the funds that have been paid into the contract. function withdrawMintFunds() public { _withdrawFor(ownerPayoutAddress); _withdrawFor(feeAddress); } // Allows the fee address to withdraw their portion of the funds. function withdrawFeeFunds() public { _withdrawFor(feeAddress); } // Internal function to refund excess Ether sent in a transaction function _refundExcessEther(uint256 totalCharge) internal { uint256 excess = msg.value - totalCharge; if (excess > 0) { (bool success, ) = payable(msg.sender).call{value: excess}(""); if (!success) { pendingBalances[msg.sender] += excess; } } } // Returns the base URI for the token metadata. function _baseURI() internal view override returns (string memory) { return baseURI; } // Checks the balance pending withdrawal for the sender. function checkPendingBalance() public view returns (uint256) { return pendingBalances[msg.sender]; } function checkPendingBalanceFor( address user ) public view returns (uint256) { return pendingBalances[user]; } // Overrides the start token ID function from the ERC721A contract. function _startTokenId() internal view virtual override returns (uint256) { return 1; } function supportsInterface( bytes4 interfaceId ) public view override(ERC721A, ERC2981) returns (bool) { return ERC721A.supportsInterface(interfaceId) || ERC2981.supportsInterface(interfaceId); } //===================================END Base Functions===================================// // ###################### Kingdomly Admin Functions ###################### function setNewKingdomlyFeeContract( KingdomlyFeeContract _kingdomlyFeeContract ) external isKingdomlyAdmin { if (address(_kingdomlyFeeContract) == address(0)) revert InvalidKingdomlyFeeContract(); kingdomlyFeeContract = _kingdomlyFeeContract; emit KingdomlyFeeContractChanged(address(_kingdomlyFeeContract)); } function getKingdomlyFeeContract() external view returns (KingdomlyFeeContract) { return kingdomlyFeeContract; } // ###################### Fee Functions ###################### function getOneDollarInWei() internal view returns (uint256) { return kingdomlyFeeContract.getOneDollarInWei(); } function threeDollarsEth() public view returns (uint256) { return (getOneDollarInWei() * threeDollarsInCents) / 100; } }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"address","name":"ownerPayoutAddress","type":"address"},{"internalType":"string","name":"initialBaseURI","type":"string"},{"internalType":"uint256","name":"maxSupply","type":"uint256"}],"internalType":"struct Zoo_Eve.BaseVariables","name":"_baseVariables","type":"tuple"},{"internalType":"uint256[]","name":"_maxMintPerWallet","type":"uint256[]"},{"internalType":"uint256[]","name":"_maxSupplyPerMintGroup","type":"uint256[]"},{"internalType":"uint256[]","name":"_mintPrice","type":"uint256[]"},{"internalType":"uint96","name":"_royaltyPercentage","type":"uint96"},{"internalType":"address","name":"_kingdomlyAdmin","type":"address"},{"internalType":"contract KingdomlyFeeContract","name":"_kingdomlyFeeContract","type":"address"},{"internalType":"bytes32","name":"_mintRoot","type":"bytes32"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"ArrayLengthMismatch","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidDefaultRoyalty","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidDefaultRoyaltyReceiver","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidTokenRoyalty","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidTokenRoyaltyReceiver","type":"error"},{"inputs":[{"internalType":"uint256","name":"requested","type":"uint256"},{"internalType":"uint256","name":"available","type":"uint256"}],"name":"ExceedsMaxMintGroupSupply","type":"error"},{"inputs":[{"internalType":"uint256","name":"requested","type":"uint256"},{"internalType":"uint256","name":"allowed","type":"uint256"}],"name":"ExceedsMaxPerWallet","type":"error"},{"inputs":[{"internalType":"uint256","name":"requested","type":"uint256"},{"internalType":"uint256","name":"available","type":"uint256"}],"name":"ExceedsMaxSupply","type":"error"},{"inputs":[{"internalType":"uint256","name":"requested","type":"uint256"},{"internalType":"uint256","name":"allowed","type":"uint256"}],"name":"ExceedsMintQuota","type":"error"},{"inputs":[{"internalType":"uint256","name":"required","type":"uint256"},{"internalType":"uint256","name":"provided","type":"uint256"}],"name":"InsufficientEther","type":"error"},{"inputs":[],"name":"InvalidKingdomlyFeeContract","type":"error"},{"inputs":[],"name":"InvalidMintCode","type":"error"},{"inputs":[{"internalType":"string","name":"reason","type":"string"}],"name":"InvalidOperation","type":"error"},{"inputs":[],"name":"MintCodeAlreadyUsed","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[{"internalType":"uint256","name":"mintId","type":"uint256"}],"name":"MintGroupDoesNotExist","type":"error"},{"inputs":[{"internalType":"uint256","name":"mintId","type":"uint256"}],"name":"MintGroupInactive","type":"error"},{"inputs":[],"name":"MintInactive","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"NotCompatibleWithSpotMints","type":"error"},{"inputs":[{"internalType":"address","name":"caller","type":"address"},{"internalType":"uint256","name":"mintId","type":"uint256"}],"name":"NotInPresale","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"SequentialMintExceedsLimit","type":"error"},{"inputs":[],"name":"SequentialUpToTooSmall","type":"error"},{"inputs":[],"name":"SpotMintTokenIdTooSmall","type":"error"},{"inputs":[],"name":"TokenAlreadyExists","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"inputs":[{"internalType":"address","name":"caller","type":"address"}],"name":"Unauthorized","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":"uint256","name":"fromTokenId","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"toTokenId","type":"uint256"}],"name":"BatchMetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"toTokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"ConsecutiveTransfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"feeContractAddress","type":"address"}],"name":"KingdomlyFeeContractChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"newMaxMintPerWallet","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"mintGroupId","type":"uint256"}],"name":"MaxMintPerWalletChanged","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":"uint256","name":"timestamp","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"mintGroupId","type":"uint256"}],"name":"PreSaleMintScheduledStartTimestampChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"status","type":"bool"},{"indexed":false,"internalType":"uint256","name":"mintGroupId","type":"uint256"}],"name":"PreSaleMintStatusChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"mintId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"newPrice","type":"uint256"}],"name":"SalePriceChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"vault","type":"address"},{"indexed":true,"internalType":"address","name":"hotWallet","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"mintId","type":"uint256"}],"name":"TokensDelegateMinted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"recipient","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"mintId","type":"uint256"}],"name":"TokensMinted","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"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"activeMintGroups","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"recipients","type":"address[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"airdropNFTs","outputs":[{"internalType":"uint256","name":"totalCharge","type":"uint256"}],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","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":"amount","type":"uint256"},{"internalType":"uint256","name":"mintId","type":"uint256"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"},{"internalType":"bytes32","name":"mintCode","type":"bytes32"}],"name":"batchMint","outputs":[{"internalType":"uint256","name":"totalCostWithFee","type":"uint256"}],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"mintId","type":"uint256"},{"internalType":"address","name":"vault","type":"address"},{"internalType":"address","name":"minterAddress","type":"address"}],"name":"canDelegateMintCheck","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"mintId","type":"uint256"},{"internalType":"address","name":"minterAddress","type":"address"}],"name":"canMintCheck","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"status","type":"bool"}],"name":"changeMintStatus","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newmintPrice","type":"uint256"},{"internalType":"uint256","name":"mintId","type":"uint256"}],"name":"changeSalePrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"checkPendingBalance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"checkPendingBalanceFor","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"claimedMintCode","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"contractMintLive","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"contractPresaleActive","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"mintId","type":"uint256"},{"internalType":"address","name":"vault","type":"address"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"},{"internalType":"bytes32","name":"mintCode","type":"bytes32"}],"name":"delegatedMint","outputs":[{"internalType":"uint256","name":"totalCostWithFee","type":"uint256"}],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"feeAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getKingdomlyFeeContract","outputs":[{"internalType":"contract KingdomlyFeeContract","name":"","type":"address"}],"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":[],"name":"kingdomlyAdmin","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"kingdomlyFeeContract","outputs":[{"internalType":"contract KingdomlyFeeContract","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"maxMintPerWallet","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"maxSupplyPerMintGroup","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"mintGroupMints","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"mintLive","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"mintPrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"","type":"address"}],"name":"mintQuotas","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"mintRoot","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"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":"ownerPayoutAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"mintId","type":"uint256"}],"name":"presaleActive","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"presaleScheduledStartTimestamp","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"quoteAirdropFees","outputs":[{"internalType":"uint256","name":"totalAirdropCostWithFee","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"mintId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"quoteBatchMint","outputs":[{"internalType":"uint256","name":"totalCostWithFee","type":"uint256"},{"internalType":"uint256","name":"feeAmount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"startTimestamp","type":"uint256"},{"internalType":"uint256","name":"mintId","type":"uint256"}],"name":"schedulePresaleMintStart","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"scheduledMintLiveTimestamp","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","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":"newBaseURI","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxMintPerWallet","type":"uint256"},{"internalType":"uint256","name":"mintGroupId","type":"uint256"}],"name":"setMaxMintPerWallet","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"timestamp","type":"uint256"}],"name":"setMintLiveTimestamp","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"addressToAdd","type":"address[]"},{"internalType":"uint256","name":"mintId","type":"uint256"},{"internalType":"uint256[]","name":"_mintQuotas","type":"uint256[]"}],"name":"setMintQuota","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract KingdomlyFeeContract","name":"_kingdomlyFeeContract","type":"address"}],"name":"setNewKingdomlyFeeContract","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"mintId","type":"uint256"},{"internalType":"uint256","name":"newMax","type":"uint256"}],"name":"setNewMaxPerMintGroup","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"presaleStatus","type":"bool"},{"internalType":"uint256","name":"mintId","type":"uint256"}],"name":"stopOrStartpresaleMint","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":[],"name":"threeDollarsEth","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"threeDollarsInCents","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":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdrawFeeFunds","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdrawMintFunds","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
60a0604052600e805460ff191690555f600f553480156200001e575f80fd5b5060405162003f1338038062003f13833981016040819052620000419162000679565b875160208901513391906002620000598382620007f5565b506003620000688282620007f5565b5060015f5550506001600160a01b0381166200009e57604051631e4fbdf760e01b81525f60048201526024015b60405180910390fd5b620000a98162000318565b508551875114158015620000bf57508451875114155b15620000de5760405163512509d360e11b815260040160405180910390fd5b5f805b8751811015620001f457878181518110620001005762000100620008c1565b602002602001015182620001159190620008d5565b91508781815181106200012c576200012c620008c1565b602002602001015160195f8381526020019081526020015f20819055508881815181106200015e576200015e620008c1565b602002602001015160175f8381526020019081526020015f2081905550868181518110620001905762000190620008c1565b6020908102919091018101515f83815260188352604080822092909255601a9092528120819055601f805460018181018355919092527fa03837a25210ee280c2113ff4b77ca23440b19d4866cca721c801278fd08d80790910182905501620000e1565b508860800151811115620002675760405163e066a8d760e01b815260206004820152603260248201527f4d617820737570706c7920706572206d696e742067726f7570206578636565646044820152717320746f74616c206d617820737570706c7960701b606482015260840162000095565b6080890151600d556060890151601090620002839082620007f5565b506040890151601280546001600160a01b0383166001600160a01b0319918216179091556011805490911673428deb81a93bed820068724eb1fcc7503d71e417179055620002d2908662000369565b50601380546001600160a01b039485166001600160a01b031991821617909155601480549390941692169190911790915561012c60805260165550620008fb9350505050565b600b80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b6127106001600160601b038216811015620003aa57604051636f483d0960e01b81526001600160601b03831660048201526024810182905260440162000095565b6001600160a01b038316620003d557604051635b6cc80560e11b81525f600482015260240162000095565b50604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600955565b634e487b7160e01b5f52604160045260245ffd5b60405160a081016001600160401b03811182821017156200044857620004486200040f565b60405290565b604051601f8201601f191681016001600160401b03811182821017156200047957620004796200040f565b604052919050565b5f82601f83011262000491575f80fd5b81516001600160401b03811115620004ad57620004ad6200040f565b6020620004c3601f8301601f191682016200044e565b8281528582848701011115620004d7575f80fd5b5f5b83811015620004f6578581018301518282018401528201620004d9565b505f928101909101919091529392505050565b80516001600160a01b038116811462000520575f80fd5b919050565b5f60a0828403121562000536575f80fd5b6200054062000423565b82519091506001600160401b03808211156200055a575f80fd5b620005688583860162000481565b835260208401519150808211156200057e575f80fd5b6200058c8583860162000481565b60208401526200059f6040850162000509565b60408401526060840151915080821115620005b8575f80fd5b50620005c78482850162000481565b6060830152506080820151608082015292915050565b5f82601f830112620005ed575f80fd5b815160206001600160401b038211156200060b576200060b6200040f565b8160051b6200061c8282016200044e565b928352848101820192828101908785111562000636575f80fd5b83870192505b8483101562000657578251825291830191908301906200063c565b979650505050505050565b80516001600160601b038116811462000520575f80fd5b5f805f805f805f80610100898b03121562000692575f80fd5b88516001600160401b0380821115620006a9575f80fd5b620006b78c838d0162000525565b995060208b0151915080821115620006cd575f80fd5b620006db8c838d01620005dd565b985060408b0151915080821115620006f1575f80fd5b620006ff8c838d01620005dd565b975060608b015191508082111562000715575f80fd5b50620007248b828c01620005dd565b9550506200073560808a0162000662565b93506200074560a08a0162000509565b92506200075560c08a0162000509565b915060e089015190509295985092959890939650565b600181811c908216806200078057607f821691505b6020821081036200079f57634e487b7160e01b5f52602260045260245ffd5b50919050565b601f821115620007f057805f5260205f20601f840160051c81016020851015620007cc5750805b601f840160051c820191505b81811015620007ed575f8155600101620007d8565b50505b505050565b81516001600160401b038111156200081157620008116200040f565b62000829816200082284546200076b565b84620007a5565b602080601f8311600181146200085f575f8415620008475750858301515b5f19600386901b1c1916600185901b178555620008b9565b5f85815260208120601f198616915b828110156200088f578886015182559484019460019091019084016200086e565b5085821015620008ad57878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b634e487b7160e01b5f52603260045260245ffd5b80820180821115620008f557634e487b7160e01b5f52601160045260245ffd5b92915050565b6080516135f86200091b5f395f81816104e1015261196c01526135f85ff3fe60806040526004361061039d575f3560e01c80638da5cb5b116101de578063d5abeb0111610108578063e8656fcc1161009d578063f30874ea1161006d578063f30874ea14610aea578063f34657ec14610aff578063f72171f114610b1e578063fea414b614610b3d575f80fd5b8063e8656fcc14610a79578063e985e9c514610a8d578063efe8232814610aac578063f2fde38b14610acb575f80fd5b8063e5fd1145116100d8578063e5fd1145146109df578063e6087db014610a0a578063e690f9eb14610a35578063e6a72acf14610a4e575f80fd5b8063d5abeb0114610976578063d7a0e8be1461098b578063db0dbb711461099e578063e213b5f6146109cc575f80fd5b8063ae4e49421161017e578063c82e474b1161014e578063c82e474b1461090f578063c87b56dd1461092e578063ce55c66a1461094d578063d028c20f14610961575f80fd5b8063ae4e49421461089f578063b3978a86146108be578063b80f8fb4146108dd578063b88d4fde146108fc575f80fd5b806395d89b41116101b957806395d89b4114610839578063a22cb4651461084d578063a75c3ad91461086c578063a8ddf8f614610880575f80fd5b80638da5cb5b146107eb578063905d7b331461080857806393a248411461081c575f80fd5b806331f72d77116102ca57806363691c931161025f578063715018a61161022f578063715018a61461076b57806371fa656a1461077f5780637bd4f071146107ad57806380348242146107cc575f80fd5b806363691c93146106e55780636c0360eb146107045780636e75e2e21461071857806370a082311461074c575f80fd5b80634a5bd2fd1161029a5780634a5bd2fd1461066957806355f804b314610688578063581636dd146106a75780636352211e146106c6575f80fd5b806331f72d77146105f9578063412753581461061857806342842e0e14610637578063483f0a821461064a575f80fd5b806317d791d01161034057806322644f061161031057806322644f061461056a57806323b872dd1461057d57806324a663c3146105905780632a55205a146105bb575f80fd5b806317d791d0146104d057806318160ddd146105035780631f4663421461051757806322536c0314610536575f80fd5b8063081812fc1161037b578063081812fc1461043a578063095ea7b31461047157806311f7acb91461048657806316da3bc6146104a5575f80fd5b806301d2718e146103a157806301ffc9a7146103ea57806306fdde0314610419575b5f80fd5b3480156103ac575f80fd5b506103d76103bb366004612c9c565b601c60209081525f928352604080842090915290825290205481565b6040519081526020015b60405180910390f35b3480156103f5575f80fd5b50610409610404366004612cdf565b610b5d565b60405190151581526020016103e1565b348015610424575f80fd5b5061042d610b7c565b6040516103e19190612d47565b348015610445575f80fd5b50610459610454366004612d59565b610c0c565b6040516001600160a01b0390911681526020016103e1565b61048461047f366004612d70565b610c45565b005b348015610491575f80fd5b506104846104a0366004612d9a565b610c55565b3480156104b0575f80fd5b506103d76104bf366004612d59565b60176020525f908152604090205481565b3480156104db575f80fd5b506103d77f000000000000000000000000000000000000000000000000000000000000000081565b34801561050e575f80fd5b506103d7610d79565b348015610522575f80fd5b50610484610531366004612dba565b610d85565b348015610541575f80fd5b50610555610550366004612d9a565b610e2d565b604080519283526020830191909152016103e1565b6103d7610578366004612e16565b610e96565b61048461058b366004612e83565b611119565b34801561059b575f80fd5b506103d76105aa366004612d59565b60196020525f908152604090205481565b3480156105c6575f80fd5b506105da6105d5366004612d9a565b611273565b604080516001600160a01b0390931683526020830191909152016103e1565b348015610604575f80fd5b50610484610613366004612d59565b6112f8565b348015610623575f80fd5b50601154610459906001600160a01b031681565b610484610645366004612e83565b611305565b348015610655575f80fd5b506103d7610664366004612d59565b611324565b348015610674575f80fd5b50610409610683366004612d59565b611343565b348015610693575f80fd5b506104846106a2366004612f5b565b611393565b3480156106b2575f80fd5b506104846106c1366004613094565b6113d9565b3480156106d1575f80fd5b506104596106e0366004612d59565b611471565b3480156106f0575f80fd5b50601354610459906001600160a01b031681565b34801561070f575f80fd5b5061042d61147b565b348015610723575f80fd5b506103d7610732366004612dba565b6001600160a01b03165f908152600c602052604090205490565b348015610757575f80fd5b506103d7610766366004612dba565b611507565b348015610776575f80fd5b5061048461154b565b34801561078a575f80fd5b50610409610799366004612d59565b60156020525f908152604090205460ff1681565b3480156107b8575f80fd5b506104846107c7366004612d9a565b61155e565b3480156107d7575f80fd5b506104846107e6366004612d9a565b6115b5565b3480156107f6575f80fd5b50600b546001600160a01b0316610459565b348015610813575f80fd5b5061048461162d565b348015610827575f80fd5b506014546001600160a01b0316610459565b348015610844575f80fd5b5061042d61165b565b348015610858575f80fd5b50610484610867366004613109565b61166a565b348015610877575f80fd5b506104846116d5565b34801561088b575f80fd5b5061048461089a366004613135565b6116ea565b3480156108aa575f80fd5b50601254610459906001600160a01b031681565b3480156108c9575f80fd5b506104846108d8366004613150565b611781565b3480156108e8575f80fd5b506103d76108f7366004612d59565b61181b565b61048461090a36600461316c565b611846565b34801561091a575f80fd5b50610484610929366004612d9a565b611881565b348015610939575f80fd5b5061042d610948366004612d59565b6118ef565b348015610958575f80fd5b506103d7611967565b34801561096c575f80fd5b506103d760165481565b348015610981575f80fd5b506103d7600d5481565b6103d76109993660046131e7565b6119ac565b3480156109a9575f80fd5b506104096109b8366004612d59565b601d6020525f908152604090205460ff1681565b6103d76109da36600461323d565b611b39565b3480156109ea575f80fd5b506103d76109f9366004612d59565b601a6020525f908152604090205481565b348015610a15575f80fd5b506103d7610a24366004612d59565b601e6020525f908152604090205481565b348015610a40575f80fd5b50600e546104099060ff1681565b348015610a59575f80fd5b506103d7610a68366004612d59565b60186020525f908152604090205481565b348015610a84575f80fd5b50610409611d4a565b348015610a98575f80fd5b50610409610aa736600461329d565b611d77565b348015610ab7575f80fd5b50601454610459906001600160a01b031681565b348015610ad6575f80fd5b50610484610ae5366004612dba565b611da4565b348015610af5575f80fd5b506103d7600f5481565b348015610b0a575f80fd5b50610409610b193660046132c9565b611dde565b348015610b29575f80fd5b50610409610b383660046132ff565b611f4f565b348015610b48575f80fd5b50335f908152600c60205260409020546103d7565b5f610b6782612158565b80610b765750610b76826121a5565b92915050565b606060028054610b8b90613346565b80601f0160208091040260200160405190810160405280929190818152602001828054610bb790613346565b8015610c025780601f10610bd957610100808354040283529160200191610c02565b820191905f5260205f20905b815481529060010190602001808311610be557829003601f168201915b5050505050905090565b5f610c16826121d9565b610c2a57610c2a6333d1c03960e21b612223565b505f908152600660205260409020546001600160a01b031690565b610c518282600161222b565b5050565b610c5d6122cc565b610c66826122f9565b610c7357610c7382612341565b5f805b601f54811015610cf65783601f8281548110610c9457610c94613378565b905f5260205f20015403610cb357610cac83836133a0565b9150610cee565b60195f601f8381548110610cc957610cc9613378565b905f5260205f20015481526020019081526020015f205482610ceb91906133a0565b91505b600101610c76565b50600d54811115610d675760405163e066a8d760e01b815260206004820152602f60248201527f4e657720737570706c7920706572206d696e742067726f75702065786365656460448201526e39903a37ba30b61039bab838363c9760891b60648201526084015b60405180910390fd5b505f9182526019602052604090912055565b6001545f54035f190190565b6013546001600160a01b03163314610db25760405163472511eb60e11b8152336004820152602401610d5e565b6001600160a01b038116610dd95760405163547e168960e01b815260040160405180910390fd5b601480546001600160a01b0319166001600160a01b0383169081179091556040519081527f65b193217dd691927510cfa45296799f4dc5a6b0d113a7f1863661cd57b1587f9060200160405180910390a150565b5f8281526018602052604081205481908190610e4a9085906133b3565b905083610e55611967565b610e5f91906133b3565b6064610e6c8360036133b3565b610e7691906133ca565b610e8091906133a0565b9150610e8c82826133a0565b9250509250929050565b5f8181526015602052604081205460ff1615610ec557604051632312107960e21b815260040160405180910390fd5b604051638988eea960e01b81523360048201526001600160a01b03861660248201523060448201525f60648201526c447e69651d841bd8d104bed49390638988eea990608401602060405180830381865afa158015610f26573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610f4a91906133e9565b610f725760405163472511eb60e11b81526001600160a01b0386166004820152602401610d5e565b5f868152601760209081526040808320546001600160a01b0389168452601b83528184208a855290925290912054610faa90896133a0565b1115611009576001600160a01b0385165f908152601b602090815260408083208984528252808320546017909252909120548891610fe791613404565b6040516303e635fb60e11b815260048101929092526024820152604401610d5e565b6110498484808060200260200160405190810160405280939291908181526020018383602002808284375f920191909152505060165491508590506123a3565b611066576040516305fbe2b760e01b815260040160405180910390fd5b5f828152601560209081526040808320805460ff191660011790556001600160a01b0388168352601b8252808320898452909152812080548992906110ac9084906133a0565b909155506110bd90508588886123b8565b604080518981526020810189905291925033916001600160a01b038816917fce55cbb6a167cf85969795eda1f8d0a2e0152274849017210ca560bd3c963f7f910160405180910390a361110f81612728565b9695505050505050565b5f611123826127b0565b6001600160a01b0394851694909150811684146111495761114962a1148160e81b612223565b5f8281526006602052604090208054338082146001600160a01b0388169091141761118c576111788633611d77565b61118c5761118c632ce44b5f60e11b612223565b8015611196575f82555b6001600160a01b038681165f9081526005602052604080822080545f19019055918716808252919020805460010190554260a01b17600160e11b175f85815260046020526040812091909155600160e11b8416900361122257600184015f818152600460205260408120549003611220575f548114611220575f8181526004602052604090208490555b505b6001600160a01b0385168481887fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef5f80a4805f0361126a5761126a633a954ecd60e21b612223565b50505050505050565b5f828152600a6020526040812080548291906001600160a01b03811690600160a01b90046001600160601b0316816112c65750506009546001600160a01b03811690600160a01b90046001600160601b03165b5f6127106112dd6001600160601b038416896133b3565b6112e791906133ca565b9295509193505050505b9250929050565b6113006122cc565b600f55565b61131f83838360405180602001604052805f815250611846565b505050565b601f8181548110611333575f80fd5b5f91825260209091200154905081565b5f818152601d602052604081205460ff1661138b575f828152601e6020526040902054158061137f57505f828152601e60205260409020544211155b1561138b57505f919050565b506001919050565b61139b6122cc565b60106113a7828261345b565b506040515f19906001907f6bd5c950a8d8df17f772f5af37cb3655737899cbf903264b9795592da439661c905f90a350565b6113e16122cc565b6113ea826122f9565b6113f7576113f782612341565b5f5b835181101561146b5781818151811061141457611414613378565b6020026020010151601c5f8581526020019081526020015f205f86848151811061144057611440613378565b6020908102919091018101516001600160a01b031682528101919091526040015f20556001016113f9565b50505050565b5f610b76826127b0565b6010805461148890613346565b80601f01602080910402602001604051908101604052809291908181526020018280546114b490613346565b80156114ff5780601f106114d6576101008083540402835291602001916114ff565b820191905f5260205f20905b8154815290600101906020018083116114e257829003601f168201915b505050505081565b5f6001600160a01b038216611526576115266323d3ad8160e21b612223565b506001600160a01b03165f9081526005602052604090205467ffffffffffffffff1690565b6115536122cc565b61155c5f612849565b565b6115666122cc565b5f8181526017602090815260409182902084905581518481529081018390527fd6255c9c7b77c2a54f193e4634719645ef0fbdc4816638350b099b15a4ebca7f91015b60405180910390a15050565b6115bd6122cc565b6115c6816122f9565b6115e657604051635831017d60e01b815260048101829052602401610d5e565b5f818152601e602090815260409182902084905581518481529081018390527fb024af7f651e94348c4e66cfe71f68a3f246eff857f95f105766bc15f4ea84fc91016115a9565b601254611642906001600160a01b031661289a565b50601154611658906001600160a01b031661289a565b50565b606060038054610b8b90613346565b335f8181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b601154611658906001600160a01b031661289a565b6116f26122cc565b600e5481151560ff9091161515036117605760405163e066a8d760e01b815260206004820152602a60248201527f4d696e742073746174757320697320616c726561647920746865206f6e6520796044820152691bdd48195b9d195c995960b21b6064820152608401610d5e565b8015155f0361176e575f600f555b600e805460ff1916911515919091179055565b6117896122cc565b611792816122f9565b6117b257604051635831017d60e01b815260048101829052602401610d5e565b5f818152601d60205260408120805460ff191684151590811790915590036117e3575f818152601e60205260408120555b604080518315158152602081018390527fd88af4ad8d3188d34ada8f4e850b4b6b3b2610392d5c8ffffa63b28ae831da5491016115a9565b5f606482611827611967565b61183191906133b3565b61183c90600b6133b3565b610b7691906133ca565b611851848484611119565b6001600160a01b0383163b1561146b5761186d84848484612952565b61146b5761146b6368d2bf6b60e11b612223565b6118896122cc565b611892816122f9565b61189f5761189f81612341565b5f81815260186020526040908190208390555181907fa7e52343431f792020e7cb8411a08014688ca11782fd5709fa2531b3d74ba457906118e39085815260200190565b60405180910390a25050565b60606118fa826121d9565b61190e5761190e630a14c4b560e41b612223565b5f611917612a2d565b905080515f036119355760405180602001604052805f815250611960565b8061193f84612a3c565b60405160200161195092919061351b565b6040516020818303038152906040525b9392505050565b5f60647f0000000000000000000000000000000000000000000000000000000000000000611993612a7f565b61199d91906133b3565b6119a791906133ca565b905090565b5f8181526015602052604081205460ff16156119db57604051632312107960e21b815260040160405180910390fd5b5f85815260176020908152604080832054338452601b835281842089855290925290912054611a0a90886133a0565b1115611a3e57335f908152601b602090815260408083208884528252808320546017909252909120548791610fe791613404565b611a7e8484808060200260200160405190810160405280939291908181526020018383602002808284375f920191909152505060165491508590506123a3565b611a9b576040516305fbe2b760e01b815260040160405180910390fd5b5f828152601560209081526040808320805460ff19166001179055338352601b825280832088845290915281208054889290611ad89084906133a0565b90915550611ae990503387876123b8565b604080518881526020810188905291925033917f2e8ac5177a616f2aec08c3048f5021e4e9743ece034e8d83ba5caf76688bb475910160405180910390a2611b3081612728565b95945050505050565b5f611b426122cc565b8151835114611ba45760405163e066a8d760e01b815260206004820152602760248201527f4d69736d61746368206265747765656e20726563697069656e747320616e6420604482015266616d6f756e747360c81b6064820152608401610d5e565b5f805b8351811015611bdf57838181518110611bc257611bc2613378565b602002602001015182611bd591906133a0565b9150600101611ba7565b50611be98161181b565b915081341015611c515760405163e066a8d760e01b815260206004820152602c60248201527f4e6f7420656e6f7567682045746865722073656e7420666f722074686520616960448201526b7264726f702063686172676560a01b6064820152608401610d5e565b6011546001600160a01b03165f908152600c602052604081208054849290611c7a9084906133a0565b909155505f90505b8451811015611d39575f848281518110611c9e57611c9e613378565b60200260200101519050600d5481611cb4610d79565b611cbe91906133a0565b1115611d0d5760405163e066a8d760e01b815260206004820152601a60248201527f41697264726f702065786365656473206d617820737570706c790000000000006044820152606401610d5e565b611d30868381518110611d2257611d22613378565b602002602001015182612aea565b50600101611c82565b50611d4382612728565b5092915050565b600e545f9060ff16611d7157600f541580611d675750600f544211155b15611d7157505f90565b50600190565b6001600160a01b039182165f90815260076020908152604080832093909416825291909152205460ff1690565b611dac6122cc565b6001600160a01b038116611dd557604051631e4fbdf760e01b81525f6004820152602401610d5e565b61165881612849565b5f828152601760209081526040808320546001600160a01b0385168452601b8352818420868552909252822054611e1590866133a0565b1115611e2257505f611960565b835f03611e3057505f611960565b611e38611d4a565b611e4357505f611960565b5f838152601d602052604090205460ff16611e8b575f838152601e60205260409020541580611e7f57505f838152601e60205260409020544211155b15611e8b57505f611960565b8215611ef0575f838152601c602090815260408083206001600160a01b03861684529091528120549003611ec057505f611960565b5f838152601c602090815260408083206001600160a01b0386168452909152902054841115611ef057505f611960565b5f83815260196020908152604080832054601a90925290912054611f159086906133a0565b1115611f2257505f611960565b600d5484611f2e610d79565b611f3891906133a0565b1115611f4557505f611960565b5060019392505050565b604051638988eea960e01b81526001600160a01b038083166004830152831660248201523060448201525f60648201819052906c447e69651d841bd8d104bed49390638988eea990608401602060405180830381865afa158015611fb5573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611fd991906133e9565b611fe457505f612150565b5f848152601760209081526040808320546001600160a01b0387168452601b83528184208885529092529091205461201c90876133a0565b111561202957505f612150565b845f0361203757505f612150565b61203f611d4a565b61204a57505f612150565b5f848152601d602052604090205460ff16612092575f848152601e6020526040902054158061208657505f848152601e60205260409020544211155b1561209257505f612150565b83156120f7575f848152601c602090815260408083206001600160a01b038616845290915281205490036120c757505f612150565b5f848152601c602090815260408083206001600160a01b03861684529091529020548511156120f757505f612150565b5f84815260196020908152604080832054601a9092529091205461211c9087906133a0565b111561212957505f612150565b600d5485612135610d79565b61213f91906133a0565b111561214c57505f612150565b5060015b949350505050565b5f6301ffc9a760e01b6001600160e01b03198316148061218857506380ac58cd60e01b6001600160e01b03198316145b80610b765750506001600160e01b031916635b5e139f60e01b1490565b5f6001600160e01b0319821663152a902d60e11b1480610b7657506301ffc9a760e01b6001600160e01b0319831614610b76565b5f8160011161221e575f5482101561221e575f5b505f82815260046020526040812054908190036122145761220d83613549565b92506121ed565b600160e01b161590505b919050565b805f5260045ffd5b5f61223583611471565b905081801561224d5750336001600160a01b03821614155b156122705761225c8133611d77565b612270576122706367d9dca160e11b612223565b5f8381526006602052604080822080546001600160a01b0319166001600160a01b0388811691821790925591518693918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a450505050565b600b546001600160a01b0316331461155c5760405163118cdaa760e01b8152336004820152602401610d5e565b5f805b601f548110156123395782601f828154811061231a5761231a613378565b905f5260205f200154036123315750600192915050565b6001016122fc565b505f92915050565b5f8181526018602090815260408083208390556017825280832083905560198252808320839055601a9091528120819055601f805460018101825591527fa03837a25210ee280c2113ff4b77ca23440b19d4866cca721c801278fd08d8070155565b5f826123af8584612b03565b14949350505050565b5f825f036124095760405163e066a8d760e01b815260206004820152601d60248201527f416d6f756e74206d7573742062652067726561746572207468616e20300000006044820152606401610d5e565b612411611d4a565b61242e57604051630d0ca57160e21b815260040160405180910390fd5b5f828152601d602052604090205460ff1661248b575f828152601e6020526040902054158061246a57505f828152601e60205260409020544211155b1561248b57604051632bf6312360e01b815260048101839052602401610d5e565b811561258b575f828152601c602090815260408083206001600160a01b038816845290915281205490036124e45760405163043374df60e21b81526001600160a01b038516600482015260248101839052604401610d5e565b5f828152601c602090815260408083206001600160a01b0388168452909152902054831115612554575f828152601c602090815260408083206001600160a01b03881684529091529081902054905163ed0fcc5760e01b8152610d5e918591600401918252602082015260400190565b5f828152601c602090815260408083206001600160a01b038816845290915281208054859290612585908490613404565b90915550505b5f82815260196020908152604080832054601a909252909120546125b09085906133a0565b11156125fd575f828152601a602090815260408083205460199092529091205484916125db91613404565b60405163cc3f2f1b60e01b815260048101929092526024820152604401610d5e565b600d5483612609610d79565b61261391906133a0565b11156126515782612622610d79565b600d5461262f9190613404565b60405163adc3cee560e01b815260048101929092526024820152604401610d5e565b5f8061265d8486610e2d565b915091508134101561268b5760405163c108422360e01b815260048101839052346024820152604401610d5e565b6011546001600160a01b03165f908152600c6020526040812080548392906126b49084906133a0565b909155506126c490508183613404565b6012546001600160a01b03165f908152600c6020526040812080549091906126ed9084906133a0565b90915550505f848152601a60205260408120805487929061270f9084906133a0565b9091555061271f90503386612aea565b50949350505050565b5f6127338234613404565b90508015610c51576040515f90339083908381818185875af1925050503d805f811461277a576040519150601f19603f3d011682016040523d82523d5f602084013e61277f565b606091505b505090508061131f57335f908152600c6020526040812080548492906127a69084906133a0565b9091555050505050565b5f8160011161283957505f81815260046020526040902054805f03612827575f5482106127e7576127e7636f96cda160e11b612223565b5b505f19015f8181526004602052604090205480156127e857600160e01b81165f0361281257919050565b612822636f96cda160e11b612223565b6127e8565b600160e01b81165f0361283957919050565b61221e636f96cda160e11b612223565b600b80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b6001600160a01b0381165f818152600c6020526040808220805490839055905190929083908381818185875af1925050503d805f81146128f5576040519150601f19603f3d011682016040523d82523d5f602084013e6128fa565b606091505b505090508061294c5760405163e066a8d760e01b815260206004820152601860248201527f5769746864726177205472616e73666572204661696c656400000000000000006044820152606401610d5e565b50919050565b604051630a85bd0160e11b81525f906001600160a01b0385169063150b7a029061298690339089908890889060040161355e565b6020604051808303815f875af19250505080156129c0575060408051601f3d908101601f191682019092526129bd91810190613590565b60015b612a13573d8080156129ed576040519150601f19603f3d011682016040523d82523d5f602084013e6129f2565b606091505b5080515f03612a0b57612a0b6368d2bf6b60e11b612223565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050612150565b606060108054610b8b90613346565b606060a06040510180604052602081039150505f815280825b600183039250600a81066030018353600a900480612a555750819003601f19909101908152919050565b60145460408051635a04434360e11b815290515f926001600160a01b03169163b40886869160048083019260209291908290030181865afa158015612ac6573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906119a791906135ab565b610c51828260405180602001604052805f815250612b45565b5f81815b8451811015612b3d57612b3382868381518110612b2657612b26613378565b6020026020010151612ba5565b9150600101612b07565b509392505050565b612b4f8383612bce565b6001600160a01b0383163b1561131f575f548281035b612b775f868380600101945086612952565b612b8b57612b8b6368d2bf6b60e11b612223565b818110612b6557815f5414612b9e575f80fd5b5050505050565b5f818310612bbf575f828152602084905260409020611960565b505f9182526020526040902090565b5f805490829003612be957612be963b562e8dd60e01b612223565b5f8181526004602090815260408083206001600160a01b0387164260a01b6001881460e11b17811790915580845260059092528220805468010000000000000001860201905590819003612c4657612c46622e076360e81b612223565b818301825b80835f7fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef5f80a4818160010191508103612c4b57505f5550505050565b6001600160a01b0381168114611658575f80fd5b5f8060408385031215612cad575f80fd5b823591506020830135612cbf81612c88565b809150509250929050565b6001600160e01b031981168114611658575f80fd5b5f60208284031215612cef575f80fd5b813561196081612cca565b5f5b83811015612d14578181015183820152602001612cfc565b50505f910152565b5f8151808452612d33816020860160208601612cfa565b601f01601f19169290920160200192915050565b602081525f6119606020830184612d1c565b5f60208284031215612d69575f80fd5b5035919050565b5f8060408385031215612d81575f80fd5b8235612d8c81612c88565b946020939093013593505050565b5f8060408385031215612dab575f80fd5b50508035926020909101359150565b5f60208284031215612dca575f80fd5b813561196081612c88565b5f8083601f840112612de5575f80fd5b50813567ffffffffffffffff811115612dfc575f80fd5b6020830191508360208260051b85010111156112f1575f80fd5b5f805f805f8060a08789031215612e2b575f80fd5b86359550602087013594506040870135612e4481612c88565b9350606087013567ffffffffffffffff811115612e5f575f80fd5b612e6b89828a01612dd5565b979a9699509497949695608090950135949350505050565b5f805f60608486031215612e95575f80fd5b8335612ea081612c88565b92506020840135612eb081612c88565b929592945050506040919091013590565b634e487b7160e01b5f52604160045260245ffd5b604051601f8201601f1916810167ffffffffffffffff81118282101715612efe57612efe612ec1565b604052919050565b5f67ffffffffffffffff831115612f1f57612f1f612ec1565b612f32601f8401601f1916602001612ed5565b9050828152838383011115612f45575f80fd5b828260208301375f602084830101529392505050565b5f60208284031215612f6b575f80fd5b813567ffffffffffffffff811115612f81575f80fd5b8201601f81018413612f91575f80fd5b61215084823560208401612f06565b5f67ffffffffffffffff821115612fb957612fb9612ec1565b5060051b60200190565b5f82601f830112612fd2575f80fd5b81356020612fe7612fe283612fa0565b612ed5565b8083825260208201915060208460051b870101935086841115613008575f80fd5b602086015b8481101561302d57803561302081612c88565b835291830191830161300d565b509695505050505050565b5f82601f830112613047575f80fd5b81356020613057612fe283612fa0565b8083825260208201915060208460051b870101935086841115613078575f80fd5b602086015b8481101561302d578035835291830191830161307d565b5f805f606084860312156130a6575f80fd5b833567ffffffffffffffff808211156130bd575f80fd5b6130c987838801612fc3565b94506020860135935060408601359150808211156130e5575f80fd5b506130f286828701613038565b9150509250925092565b8015158114611658575f80fd5b5f806040838503121561311a575f80fd5b823561312581612c88565b91506020830135612cbf816130fc565b5f60208284031215613145575f80fd5b8135611960816130fc565b5f8060408385031215613161575f80fd5b8235612d8c816130fc565b5f805f806080858703121561317f575f80fd5b843561318a81612c88565b9350602085013561319a81612c88565b925060408501359150606085013567ffffffffffffffff8111156131bc575f80fd5b8501601f810187136131cc575f80fd5b6131db87823560208401612f06565b91505092959194509250565b5f805f805f608086880312156131fb575f80fd5b8535945060208601359350604086013567ffffffffffffffff81111561321f575f80fd5b61322b88828901612dd5565b96999598509660600135949350505050565b5f806040838503121561324e575f80fd5b823567ffffffffffffffff80821115613265575f80fd5b61327186838701612fc3565b93506020850135915080821115613286575f80fd5b5061329385828601613038565b9150509250929050565b5f80604083850312156132ae575f80fd5b82356132b981612c88565b91506020830135612cbf81612c88565b5f805f606084860312156132db575f80fd5b833592506020840135915060408401356132f481612c88565b809150509250925092565b5f805f8060808587031215613312575f80fd5b8435935060208501359250604085013561332b81612c88565b9150606085013561333b81612c88565b939692955090935050565b600181811c9082168061335a57607f821691505b60208210810361294c57634e487b7160e01b5f52602260045260245ffd5b634e487b7160e01b5f52603260045260245ffd5b634e487b7160e01b5f52601160045260245ffd5b80820180821115610b7657610b7661338c565b8082028115828204841417610b7657610b7661338c565b5f826133e457634e487b7160e01b5f52601260045260245ffd5b500490565b5f602082840312156133f9575f80fd5b8151611960816130fc565b81810381811115610b7657610b7661338c565b601f82111561131f57805f5260205f20601f840160051c8101602085101561343c5750805b601f840160051c820191505b81811015612b9e575f8155600101613448565b815167ffffffffffffffff81111561347557613475612ec1565b613489816134838454613346565b84613417565b602080601f8311600181146134bc575f84156134a55750858301515b5f19600386901b1c1916600185901b178555613513565b5f85815260208120601f198616915b828110156134ea578886015182559484019460019091019084016134cb565b508582101561350757878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b5f835161352c818460208801612cfa565b835190830190613540818360208801612cfa565b01949350505050565b5f816135575761355761338c565b505f190190565b6001600160a01b03858116825284166020820152604081018390526080606082018190525f9061110f90830184612d1c565b5f602082840312156135a0575f80fd5b815161196081612cca565b5f602082840312156135bb575f80fd5b505191905056fea2646970667358221220410dc253c7678cb185cd693fee13e29b3b4d807d84f26a5995f8f0cb9a2aef0864736f6c63430008180033000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000032000000000000000000000000000000000000000000000000000000000000003a000000000000000000000000000000000000000000000000000000000000001f4000000000000000000000000428deb81a93bed820068724eb1fcc7503d71e41700000000000000000000000065db9966492c0a5ac0ef15c018c19ee383f7a8cffc2a67b6b40833bb651a702e9e36811053bc5a01f58a96d150c9191a672e416900000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000006b3b5a079f905fce13ff9d128e7d59bf40d1366c00000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000d0500000000000000000000000000000000000000000000000000000000000000075a6f6f204576650000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000035a4f4f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000043697066733a2f2f62616679626569663732333436767661617a6a6b68677a7532666f636c323662656b636669747178377a6d7a6a65376d697267746e6b79627875712f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000c8000000000000000000000000000000000000000000000000000000000000067300000000000000000000000000000000000000000000000000000000000005ca0000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x60806040526004361061039d575f3560e01c80638da5cb5b116101de578063d5abeb0111610108578063e8656fcc1161009d578063f30874ea1161006d578063f30874ea14610aea578063f34657ec14610aff578063f72171f114610b1e578063fea414b614610b3d575f80fd5b8063e8656fcc14610a79578063e985e9c514610a8d578063efe8232814610aac578063f2fde38b14610acb575f80fd5b8063e5fd1145116100d8578063e5fd1145146109df578063e6087db014610a0a578063e690f9eb14610a35578063e6a72acf14610a4e575f80fd5b8063d5abeb0114610976578063d7a0e8be1461098b578063db0dbb711461099e578063e213b5f6146109cc575f80fd5b8063ae4e49421161017e578063c82e474b1161014e578063c82e474b1461090f578063c87b56dd1461092e578063ce55c66a1461094d578063d028c20f14610961575f80fd5b8063ae4e49421461089f578063b3978a86146108be578063b80f8fb4146108dd578063b88d4fde146108fc575f80fd5b806395d89b41116101b957806395d89b4114610839578063a22cb4651461084d578063a75c3ad91461086c578063a8ddf8f614610880575f80fd5b80638da5cb5b146107eb578063905d7b331461080857806393a248411461081c575f80fd5b806331f72d77116102ca57806363691c931161025f578063715018a61161022f578063715018a61461076b57806371fa656a1461077f5780637bd4f071146107ad57806380348242146107cc575f80fd5b806363691c93146106e55780636c0360eb146107045780636e75e2e21461071857806370a082311461074c575f80fd5b80634a5bd2fd1161029a5780634a5bd2fd1461066957806355f804b314610688578063581636dd146106a75780636352211e146106c6575f80fd5b806331f72d77146105f9578063412753581461061857806342842e0e14610637578063483f0a821461064a575f80fd5b806317d791d01161034057806322644f061161031057806322644f061461056a57806323b872dd1461057d57806324a663c3146105905780632a55205a146105bb575f80fd5b806317d791d0146104d057806318160ddd146105035780631f4663421461051757806322536c0314610536575f80fd5b8063081812fc1161037b578063081812fc1461043a578063095ea7b31461047157806311f7acb91461048657806316da3bc6146104a5575f80fd5b806301d2718e146103a157806301ffc9a7146103ea57806306fdde0314610419575b5f80fd5b3480156103ac575f80fd5b506103d76103bb366004612c9c565b601c60209081525f928352604080842090915290825290205481565b6040519081526020015b60405180910390f35b3480156103f5575f80fd5b50610409610404366004612cdf565b610b5d565b60405190151581526020016103e1565b348015610424575f80fd5b5061042d610b7c565b6040516103e19190612d47565b348015610445575f80fd5b50610459610454366004612d59565b610c0c565b6040516001600160a01b0390911681526020016103e1565b61048461047f366004612d70565b610c45565b005b348015610491575f80fd5b506104846104a0366004612d9a565b610c55565b3480156104b0575f80fd5b506103d76104bf366004612d59565b60176020525f908152604090205481565b3480156104db575f80fd5b506103d77f000000000000000000000000000000000000000000000000000000000000012c81565b34801561050e575f80fd5b506103d7610d79565b348015610522575f80fd5b50610484610531366004612dba565b610d85565b348015610541575f80fd5b50610555610550366004612d9a565b610e2d565b604080519283526020830191909152016103e1565b6103d7610578366004612e16565b610e96565b61048461058b366004612e83565b611119565b34801561059b575f80fd5b506103d76105aa366004612d59565b60196020525f908152604090205481565b3480156105c6575f80fd5b506105da6105d5366004612d9a565b611273565b604080516001600160a01b0390931683526020830191909152016103e1565b348015610604575f80fd5b50610484610613366004612d59565b6112f8565b348015610623575f80fd5b50601154610459906001600160a01b031681565b610484610645366004612e83565b611305565b348015610655575f80fd5b506103d7610664366004612d59565b611324565b348015610674575f80fd5b50610409610683366004612d59565b611343565b348015610693575f80fd5b506104846106a2366004612f5b565b611393565b3480156106b2575f80fd5b506104846106c1366004613094565b6113d9565b3480156106d1575f80fd5b506104596106e0366004612d59565b611471565b3480156106f0575f80fd5b50601354610459906001600160a01b031681565b34801561070f575f80fd5b5061042d61147b565b348015610723575f80fd5b506103d7610732366004612dba565b6001600160a01b03165f908152600c602052604090205490565b348015610757575f80fd5b506103d7610766366004612dba565b611507565b348015610776575f80fd5b5061048461154b565b34801561078a575f80fd5b50610409610799366004612d59565b60156020525f908152604090205460ff1681565b3480156107b8575f80fd5b506104846107c7366004612d9a565b61155e565b3480156107d7575f80fd5b506104846107e6366004612d9a565b6115b5565b3480156107f6575f80fd5b50600b546001600160a01b0316610459565b348015610813575f80fd5b5061048461162d565b348015610827575f80fd5b506014546001600160a01b0316610459565b348015610844575f80fd5b5061042d61165b565b348015610858575f80fd5b50610484610867366004613109565b61166a565b348015610877575f80fd5b506104846116d5565b34801561088b575f80fd5b5061048461089a366004613135565b6116ea565b3480156108aa575f80fd5b50601254610459906001600160a01b031681565b3480156108c9575f80fd5b506104846108d8366004613150565b611781565b3480156108e8575f80fd5b506103d76108f7366004612d59565b61181b565b61048461090a36600461316c565b611846565b34801561091a575f80fd5b50610484610929366004612d9a565b611881565b348015610939575f80fd5b5061042d610948366004612d59565b6118ef565b348015610958575f80fd5b506103d7611967565b34801561096c575f80fd5b506103d760165481565b348015610981575f80fd5b506103d7600d5481565b6103d76109993660046131e7565b6119ac565b3480156109a9575f80fd5b506104096109b8366004612d59565b601d6020525f908152604090205460ff1681565b6103d76109da36600461323d565b611b39565b3480156109ea575f80fd5b506103d76109f9366004612d59565b601a6020525f908152604090205481565b348015610a15575f80fd5b506103d7610a24366004612d59565b601e6020525f908152604090205481565b348015610a40575f80fd5b50600e546104099060ff1681565b348015610a59575f80fd5b506103d7610a68366004612d59565b60186020525f908152604090205481565b348015610a84575f80fd5b50610409611d4a565b348015610a98575f80fd5b50610409610aa736600461329d565b611d77565b348015610ab7575f80fd5b50601454610459906001600160a01b031681565b348015610ad6575f80fd5b50610484610ae5366004612dba565b611da4565b348015610af5575f80fd5b506103d7600f5481565b348015610b0a575f80fd5b50610409610b193660046132c9565b611dde565b348015610b29575f80fd5b50610409610b383660046132ff565b611f4f565b348015610b48575f80fd5b50335f908152600c60205260409020546103d7565b5f610b6782612158565b80610b765750610b76826121a5565b92915050565b606060028054610b8b90613346565b80601f0160208091040260200160405190810160405280929190818152602001828054610bb790613346565b8015610c025780601f10610bd957610100808354040283529160200191610c02565b820191905f5260205f20905b815481529060010190602001808311610be557829003601f168201915b5050505050905090565b5f610c16826121d9565b610c2a57610c2a6333d1c03960e21b612223565b505f908152600660205260409020546001600160a01b031690565b610c518282600161222b565b5050565b610c5d6122cc565b610c66826122f9565b610c7357610c7382612341565b5f805b601f54811015610cf65783601f8281548110610c9457610c94613378565b905f5260205f20015403610cb357610cac83836133a0565b9150610cee565b60195f601f8381548110610cc957610cc9613378565b905f5260205f20015481526020019081526020015f205482610ceb91906133a0565b91505b600101610c76565b50600d54811115610d675760405163e066a8d760e01b815260206004820152602f60248201527f4e657720737570706c7920706572206d696e742067726f75702065786365656460448201526e39903a37ba30b61039bab838363c9760891b60648201526084015b60405180910390fd5b505f9182526019602052604090912055565b6001545f54035f190190565b6013546001600160a01b03163314610db25760405163472511eb60e11b8152336004820152602401610d5e565b6001600160a01b038116610dd95760405163547e168960e01b815260040160405180910390fd5b601480546001600160a01b0319166001600160a01b0383169081179091556040519081527f65b193217dd691927510cfa45296799f4dc5a6b0d113a7f1863661cd57b1587f9060200160405180910390a150565b5f8281526018602052604081205481908190610e4a9085906133b3565b905083610e55611967565b610e5f91906133b3565b6064610e6c8360036133b3565b610e7691906133ca565b610e8091906133a0565b9150610e8c82826133a0565b9250509250929050565b5f8181526015602052604081205460ff1615610ec557604051632312107960e21b815260040160405180910390fd5b604051638988eea960e01b81523360048201526001600160a01b03861660248201523060448201525f60648201526c447e69651d841bd8d104bed49390638988eea990608401602060405180830381865afa158015610f26573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610f4a91906133e9565b610f725760405163472511eb60e11b81526001600160a01b0386166004820152602401610d5e565b5f868152601760209081526040808320546001600160a01b0389168452601b83528184208a855290925290912054610faa90896133a0565b1115611009576001600160a01b0385165f908152601b602090815260408083208984528252808320546017909252909120548891610fe791613404565b6040516303e635fb60e11b815260048101929092526024820152604401610d5e565b6110498484808060200260200160405190810160405280939291908181526020018383602002808284375f920191909152505060165491508590506123a3565b611066576040516305fbe2b760e01b815260040160405180910390fd5b5f828152601560209081526040808320805460ff191660011790556001600160a01b0388168352601b8252808320898452909152812080548992906110ac9084906133a0565b909155506110bd90508588886123b8565b604080518981526020810189905291925033916001600160a01b038816917fce55cbb6a167cf85969795eda1f8d0a2e0152274849017210ca560bd3c963f7f910160405180910390a361110f81612728565b9695505050505050565b5f611123826127b0565b6001600160a01b0394851694909150811684146111495761114962a1148160e81b612223565b5f8281526006602052604090208054338082146001600160a01b0388169091141761118c576111788633611d77565b61118c5761118c632ce44b5f60e11b612223565b8015611196575f82555b6001600160a01b038681165f9081526005602052604080822080545f19019055918716808252919020805460010190554260a01b17600160e11b175f85815260046020526040812091909155600160e11b8416900361122257600184015f818152600460205260408120549003611220575f548114611220575f8181526004602052604090208490555b505b6001600160a01b0385168481887fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef5f80a4805f0361126a5761126a633a954ecd60e21b612223565b50505050505050565b5f828152600a6020526040812080548291906001600160a01b03811690600160a01b90046001600160601b0316816112c65750506009546001600160a01b03811690600160a01b90046001600160601b03165b5f6127106112dd6001600160601b038416896133b3565b6112e791906133ca565b9295509193505050505b9250929050565b6113006122cc565b600f55565b61131f83838360405180602001604052805f815250611846565b505050565b601f8181548110611333575f80fd5b5f91825260209091200154905081565b5f818152601d602052604081205460ff1661138b575f828152601e6020526040902054158061137f57505f828152601e60205260409020544211155b1561138b57505f919050565b506001919050565b61139b6122cc565b60106113a7828261345b565b506040515f19906001907f6bd5c950a8d8df17f772f5af37cb3655737899cbf903264b9795592da439661c905f90a350565b6113e16122cc565b6113ea826122f9565b6113f7576113f782612341565b5f5b835181101561146b5781818151811061141457611414613378565b6020026020010151601c5f8581526020019081526020015f205f86848151811061144057611440613378565b6020908102919091018101516001600160a01b031682528101919091526040015f20556001016113f9565b50505050565b5f610b76826127b0565b6010805461148890613346565b80601f01602080910402602001604051908101604052809291908181526020018280546114b490613346565b80156114ff5780601f106114d6576101008083540402835291602001916114ff565b820191905f5260205f20905b8154815290600101906020018083116114e257829003601f168201915b505050505081565b5f6001600160a01b038216611526576115266323d3ad8160e21b612223565b506001600160a01b03165f9081526005602052604090205467ffffffffffffffff1690565b6115536122cc565b61155c5f612849565b565b6115666122cc565b5f8181526017602090815260409182902084905581518481529081018390527fd6255c9c7b77c2a54f193e4634719645ef0fbdc4816638350b099b15a4ebca7f91015b60405180910390a15050565b6115bd6122cc565b6115c6816122f9565b6115e657604051635831017d60e01b815260048101829052602401610d5e565b5f818152601e602090815260409182902084905581518481529081018390527fb024af7f651e94348c4e66cfe71f68a3f246eff857f95f105766bc15f4ea84fc91016115a9565b601254611642906001600160a01b031661289a565b50601154611658906001600160a01b031661289a565b50565b606060038054610b8b90613346565b335f8181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b601154611658906001600160a01b031661289a565b6116f26122cc565b600e5481151560ff9091161515036117605760405163e066a8d760e01b815260206004820152602a60248201527f4d696e742073746174757320697320616c726561647920746865206f6e6520796044820152691bdd48195b9d195c995960b21b6064820152608401610d5e565b8015155f0361176e575f600f555b600e805460ff1916911515919091179055565b6117896122cc565b611792816122f9565b6117b257604051635831017d60e01b815260048101829052602401610d5e565b5f818152601d60205260408120805460ff191684151590811790915590036117e3575f818152601e60205260408120555b604080518315158152602081018390527fd88af4ad8d3188d34ada8f4e850b4b6b3b2610392d5c8ffffa63b28ae831da5491016115a9565b5f606482611827611967565b61183191906133b3565b61183c90600b6133b3565b610b7691906133ca565b611851848484611119565b6001600160a01b0383163b1561146b5761186d84848484612952565b61146b5761146b6368d2bf6b60e11b612223565b6118896122cc565b611892816122f9565b61189f5761189f81612341565b5f81815260186020526040908190208390555181907fa7e52343431f792020e7cb8411a08014688ca11782fd5709fa2531b3d74ba457906118e39085815260200190565b60405180910390a25050565b60606118fa826121d9565b61190e5761190e630a14c4b560e41b612223565b5f611917612a2d565b905080515f036119355760405180602001604052805f815250611960565b8061193f84612a3c565b60405160200161195092919061351b565b6040516020818303038152906040525b9392505050565b5f60647f000000000000000000000000000000000000000000000000000000000000012c611993612a7f565b61199d91906133b3565b6119a791906133ca565b905090565b5f8181526015602052604081205460ff16156119db57604051632312107960e21b815260040160405180910390fd5b5f85815260176020908152604080832054338452601b835281842089855290925290912054611a0a90886133a0565b1115611a3e57335f908152601b602090815260408083208884528252808320546017909252909120548791610fe791613404565b611a7e8484808060200260200160405190810160405280939291908181526020018383602002808284375f920191909152505060165491508590506123a3565b611a9b576040516305fbe2b760e01b815260040160405180910390fd5b5f828152601560209081526040808320805460ff19166001179055338352601b825280832088845290915281208054889290611ad89084906133a0565b90915550611ae990503387876123b8565b604080518881526020810188905291925033917f2e8ac5177a616f2aec08c3048f5021e4e9743ece034e8d83ba5caf76688bb475910160405180910390a2611b3081612728565b95945050505050565b5f611b426122cc565b8151835114611ba45760405163e066a8d760e01b815260206004820152602760248201527f4d69736d61746368206265747765656e20726563697069656e747320616e6420604482015266616d6f756e747360c81b6064820152608401610d5e565b5f805b8351811015611bdf57838181518110611bc257611bc2613378565b602002602001015182611bd591906133a0565b9150600101611ba7565b50611be98161181b565b915081341015611c515760405163e066a8d760e01b815260206004820152602c60248201527f4e6f7420656e6f7567682045746865722073656e7420666f722074686520616960448201526b7264726f702063686172676560a01b6064820152608401610d5e565b6011546001600160a01b03165f908152600c602052604081208054849290611c7a9084906133a0565b909155505f90505b8451811015611d39575f848281518110611c9e57611c9e613378565b60200260200101519050600d5481611cb4610d79565b611cbe91906133a0565b1115611d0d5760405163e066a8d760e01b815260206004820152601a60248201527f41697264726f702065786365656473206d617820737570706c790000000000006044820152606401610d5e565b611d30868381518110611d2257611d22613378565b602002602001015182612aea565b50600101611c82565b50611d4382612728565b5092915050565b600e545f9060ff16611d7157600f541580611d675750600f544211155b15611d7157505f90565b50600190565b6001600160a01b039182165f90815260076020908152604080832093909416825291909152205460ff1690565b611dac6122cc565b6001600160a01b038116611dd557604051631e4fbdf760e01b81525f6004820152602401610d5e565b61165881612849565b5f828152601760209081526040808320546001600160a01b0385168452601b8352818420868552909252822054611e1590866133a0565b1115611e2257505f611960565b835f03611e3057505f611960565b611e38611d4a565b611e4357505f611960565b5f838152601d602052604090205460ff16611e8b575f838152601e60205260409020541580611e7f57505f838152601e60205260409020544211155b15611e8b57505f611960565b8215611ef0575f838152601c602090815260408083206001600160a01b03861684529091528120549003611ec057505f611960565b5f838152601c602090815260408083206001600160a01b0386168452909152902054841115611ef057505f611960565b5f83815260196020908152604080832054601a90925290912054611f159086906133a0565b1115611f2257505f611960565b600d5484611f2e610d79565b611f3891906133a0565b1115611f4557505f611960565b5060019392505050565b604051638988eea960e01b81526001600160a01b038083166004830152831660248201523060448201525f60648201819052906c447e69651d841bd8d104bed49390638988eea990608401602060405180830381865afa158015611fb5573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190611fd991906133e9565b611fe457505f612150565b5f848152601760209081526040808320546001600160a01b0387168452601b83528184208885529092529091205461201c90876133a0565b111561202957505f612150565b845f0361203757505f612150565b61203f611d4a565b61204a57505f612150565b5f848152601d602052604090205460ff16612092575f848152601e6020526040902054158061208657505f848152601e60205260409020544211155b1561209257505f612150565b83156120f7575f848152601c602090815260408083206001600160a01b038616845290915281205490036120c757505f612150565b5f848152601c602090815260408083206001600160a01b03861684529091529020548511156120f757505f612150565b5f84815260196020908152604080832054601a9092529091205461211c9087906133a0565b111561212957505f612150565b600d5485612135610d79565b61213f91906133a0565b111561214c57505f612150565b5060015b949350505050565b5f6301ffc9a760e01b6001600160e01b03198316148061218857506380ac58cd60e01b6001600160e01b03198316145b80610b765750506001600160e01b031916635b5e139f60e01b1490565b5f6001600160e01b0319821663152a902d60e11b1480610b7657506301ffc9a760e01b6001600160e01b0319831614610b76565b5f8160011161221e575f5482101561221e575f5b505f82815260046020526040812054908190036122145761220d83613549565b92506121ed565b600160e01b161590505b919050565b805f5260045ffd5b5f61223583611471565b905081801561224d5750336001600160a01b03821614155b156122705761225c8133611d77565b612270576122706367d9dca160e11b612223565b5f8381526006602052604080822080546001600160a01b0319166001600160a01b0388811691821790925591518693918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a450505050565b600b546001600160a01b0316331461155c5760405163118cdaa760e01b8152336004820152602401610d5e565b5f805b601f548110156123395782601f828154811061231a5761231a613378565b905f5260205f200154036123315750600192915050565b6001016122fc565b505f92915050565b5f8181526018602090815260408083208390556017825280832083905560198252808320839055601a9091528120819055601f805460018101825591527fa03837a25210ee280c2113ff4b77ca23440b19d4866cca721c801278fd08d8070155565b5f826123af8584612b03565b14949350505050565b5f825f036124095760405163e066a8d760e01b815260206004820152601d60248201527f416d6f756e74206d7573742062652067726561746572207468616e20300000006044820152606401610d5e565b612411611d4a565b61242e57604051630d0ca57160e21b815260040160405180910390fd5b5f828152601d602052604090205460ff1661248b575f828152601e6020526040902054158061246a57505f828152601e60205260409020544211155b1561248b57604051632bf6312360e01b815260048101839052602401610d5e565b811561258b575f828152601c602090815260408083206001600160a01b038816845290915281205490036124e45760405163043374df60e21b81526001600160a01b038516600482015260248101839052604401610d5e565b5f828152601c602090815260408083206001600160a01b0388168452909152902054831115612554575f828152601c602090815260408083206001600160a01b03881684529091529081902054905163ed0fcc5760e01b8152610d5e918591600401918252602082015260400190565b5f828152601c602090815260408083206001600160a01b038816845290915281208054859290612585908490613404565b90915550505b5f82815260196020908152604080832054601a909252909120546125b09085906133a0565b11156125fd575f828152601a602090815260408083205460199092529091205484916125db91613404565b60405163cc3f2f1b60e01b815260048101929092526024820152604401610d5e565b600d5483612609610d79565b61261391906133a0565b11156126515782612622610d79565b600d5461262f9190613404565b60405163adc3cee560e01b815260048101929092526024820152604401610d5e565b5f8061265d8486610e2d565b915091508134101561268b5760405163c108422360e01b815260048101839052346024820152604401610d5e565b6011546001600160a01b03165f908152600c6020526040812080548392906126b49084906133a0565b909155506126c490508183613404565b6012546001600160a01b03165f908152600c6020526040812080549091906126ed9084906133a0565b90915550505f848152601a60205260408120805487929061270f9084906133a0565b9091555061271f90503386612aea565b50949350505050565b5f6127338234613404565b90508015610c51576040515f90339083908381818185875af1925050503d805f811461277a576040519150601f19603f3d011682016040523d82523d5f602084013e61277f565b606091505b505090508061131f57335f908152600c6020526040812080548492906127a69084906133a0565b9091555050505050565b5f8160011161283957505f81815260046020526040902054805f03612827575f5482106127e7576127e7636f96cda160e11b612223565b5b505f19015f8181526004602052604090205480156127e857600160e01b81165f0361281257919050565b612822636f96cda160e11b612223565b6127e8565b600160e01b81165f0361283957919050565b61221e636f96cda160e11b612223565b600b80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b6001600160a01b0381165f818152600c6020526040808220805490839055905190929083908381818185875af1925050503d805f81146128f5576040519150601f19603f3d011682016040523d82523d5f602084013e6128fa565b606091505b505090508061294c5760405163e066a8d760e01b815260206004820152601860248201527f5769746864726177205472616e73666572204661696c656400000000000000006044820152606401610d5e565b50919050565b604051630a85bd0160e11b81525f906001600160a01b0385169063150b7a029061298690339089908890889060040161355e565b6020604051808303815f875af19250505080156129c0575060408051601f3d908101601f191682019092526129bd91810190613590565b60015b612a13573d8080156129ed576040519150601f19603f3d011682016040523d82523d5f602084013e6129f2565b606091505b5080515f03612a0b57612a0b6368d2bf6b60e11b612223565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050612150565b606060108054610b8b90613346565b606060a06040510180604052602081039150505f815280825b600183039250600a81066030018353600a900480612a555750819003601f19909101908152919050565b60145460408051635a04434360e11b815290515f926001600160a01b03169163b40886869160048083019260209291908290030181865afa158015612ac6573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906119a791906135ab565b610c51828260405180602001604052805f815250612b45565b5f81815b8451811015612b3d57612b3382868381518110612b2657612b26613378565b6020026020010151612ba5565b9150600101612b07565b509392505050565b612b4f8383612bce565b6001600160a01b0383163b1561131f575f548281035b612b775f868380600101945086612952565b612b8b57612b8b6368d2bf6b60e11b612223565b818110612b6557815f5414612b9e575f80fd5b5050505050565b5f818310612bbf575f828152602084905260409020611960565b505f9182526020526040902090565b5f805490829003612be957612be963b562e8dd60e01b612223565b5f8181526004602090815260408083206001600160a01b0387164260a01b6001881460e11b17811790915580845260059092528220805468010000000000000001860201905590819003612c4657612c46622e076360e81b612223565b818301825b80835f7fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef5f80a4818160010191508103612c4b57505f5550505050565b6001600160a01b0381168114611658575f80fd5b5f8060408385031215612cad575f80fd5b823591506020830135612cbf81612c88565b809150509250929050565b6001600160e01b031981168114611658575f80fd5b5f60208284031215612cef575f80fd5b813561196081612cca565b5f5b83811015612d14578181015183820152602001612cfc565b50505f910152565b5f8151808452612d33816020860160208601612cfa565b601f01601f19169290920160200192915050565b602081525f6119606020830184612d1c565b5f60208284031215612d69575f80fd5b5035919050565b5f8060408385031215612d81575f80fd5b8235612d8c81612c88565b946020939093013593505050565b5f8060408385031215612dab575f80fd5b50508035926020909101359150565b5f60208284031215612dca575f80fd5b813561196081612c88565b5f8083601f840112612de5575f80fd5b50813567ffffffffffffffff811115612dfc575f80fd5b6020830191508360208260051b85010111156112f1575f80fd5b5f805f805f8060a08789031215612e2b575f80fd5b86359550602087013594506040870135612e4481612c88565b9350606087013567ffffffffffffffff811115612e5f575f80fd5b612e6b89828a01612dd5565b979a9699509497949695608090950135949350505050565b5f805f60608486031215612e95575f80fd5b8335612ea081612c88565b92506020840135612eb081612c88565b929592945050506040919091013590565b634e487b7160e01b5f52604160045260245ffd5b604051601f8201601f1916810167ffffffffffffffff81118282101715612efe57612efe612ec1565b604052919050565b5f67ffffffffffffffff831115612f1f57612f1f612ec1565b612f32601f8401601f1916602001612ed5565b9050828152838383011115612f45575f80fd5b828260208301375f602084830101529392505050565b5f60208284031215612f6b575f80fd5b813567ffffffffffffffff811115612f81575f80fd5b8201601f81018413612f91575f80fd5b61215084823560208401612f06565b5f67ffffffffffffffff821115612fb957612fb9612ec1565b5060051b60200190565b5f82601f830112612fd2575f80fd5b81356020612fe7612fe283612fa0565b612ed5565b8083825260208201915060208460051b870101935086841115613008575f80fd5b602086015b8481101561302d57803561302081612c88565b835291830191830161300d565b509695505050505050565b5f82601f830112613047575f80fd5b81356020613057612fe283612fa0565b8083825260208201915060208460051b870101935086841115613078575f80fd5b602086015b8481101561302d578035835291830191830161307d565b5f805f606084860312156130a6575f80fd5b833567ffffffffffffffff808211156130bd575f80fd5b6130c987838801612fc3565b94506020860135935060408601359150808211156130e5575f80fd5b506130f286828701613038565b9150509250925092565b8015158114611658575f80fd5b5f806040838503121561311a575f80fd5b823561312581612c88565b91506020830135612cbf816130fc565b5f60208284031215613145575f80fd5b8135611960816130fc565b5f8060408385031215613161575f80fd5b8235612d8c816130fc565b5f805f806080858703121561317f575f80fd5b843561318a81612c88565b9350602085013561319a81612c88565b925060408501359150606085013567ffffffffffffffff8111156131bc575f80fd5b8501601f810187136131cc575f80fd5b6131db87823560208401612f06565b91505092959194509250565b5f805f805f608086880312156131fb575f80fd5b8535945060208601359350604086013567ffffffffffffffff81111561321f575f80fd5b61322b88828901612dd5565b96999598509660600135949350505050565b5f806040838503121561324e575f80fd5b823567ffffffffffffffff80821115613265575f80fd5b61327186838701612fc3565b93506020850135915080821115613286575f80fd5b5061329385828601613038565b9150509250929050565b5f80604083850312156132ae575f80fd5b82356132b981612c88565b91506020830135612cbf81612c88565b5f805f606084860312156132db575f80fd5b833592506020840135915060408401356132f481612c88565b809150509250925092565b5f805f8060808587031215613312575f80fd5b8435935060208501359250604085013561332b81612c88565b9150606085013561333b81612c88565b939692955090935050565b600181811c9082168061335a57607f821691505b60208210810361294c57634e487b7160e01b5f52602260045260245ffd5b634e487b7160e01b5f52603260045260245ffd5b634e487b7160e01b5f52601160045260245ffd5b80820180821115610b7657610b7661338c565b8082028115828204841417610b7657610b7661338c565b5f826133e457634e487b7160e01b5f52601260045260245ffd5b500490565b5f602082840312156133f9575f80fd5b8151611960816130fc565b81810381811115610b7657610b7661338c565b601f82111561131f57805f5260205f20601f840160051c8101602085101561343c5750805b601f840160051c820191505b81811015612b9e575f8155600101613448565b815167ffffffffffffffff81111561347557613475612ec1565b613489816134838454613346565b84613417565b602080601f8311600181146134bc575f84156134a55750858301515b5f19600386901b1c1916600185901b178555613513565b5f85815260208120601f198616915b828110156134ea578886015182559484019460019091019084016134cb565b508582101561350757878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b5f835161352c818460208801612cfa565b835190830190613540818360208801612cfa565b01949350505050565b5f816135575761355761338c565b505f190190565b6001600160a01b03858116825284166020820152604081018390526080606082018190525f9061110f90830184612d1c565b5f602082840312156135a0575f80fd5b815161196081612cca565b5f602082840312156135bb575f80fd5b505191905056fea2646970667358221220410dc253c7678cb185cd693fee13e29b3b4d807d84f26a5995f8f0cb9a2aef0864736f6c63430008180033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000032000000000000000000000000000000000000000000000000000000000000003a000000000000000000000000000000000000000000000000000000000000001f4000000000000000000000000428deb81a93bed820068724eb1fcc7503d71e41700000000000000000000000065db9966492c0a5ac0ef15c018c19ee383f7a8cffc2a67b6b40833bb651a702e9e36811053bc5a01f58a96d150c9191a672e416900000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000006b3b5a079f905fce13ff9d128e7d59bf40d1366c00000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000d0500000000000000000000000000000000000000000000000000000000000000075a6f6f204576650000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000035a4f4f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000043697066733a2f2f62616679626569663732333436767661617a6a6b68677a7532666f636c323662656b636669747178377a6d7a6a65376d697267746e6b79627875712f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000c8000000000000000000000000000000000000000000000000000000000000067300000000000000000000000000000000000000000000000000000000000005ca0000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : _baseVariables (tuple): System.Collections.Generic.List`1[Nethereum.ABI.FunctionEncoding.ParameterOutput]
Arg [1] : _maxMintPerWallet (uint256[]): 1,1,2
Arg [2] : _maxSupplyPerMintGroup (uint256[]): 200,1651,1482
Arg [3] : _mintPrice (uint256[]): 0,0,0
Arg [4] : _royaltyPercentage (uint96): 500
Arg [5] : _kingdomlyAdmin (address): 0x428Deb81A93BeD820068724eb1fCc7503d71e417
Arg [6] : _kingdomlyFeeContract (address): 0x65Db9966492C0A5aC0EF15c018C19eE383F7a8Cf
Arg [7] : _mintRoot (bytes32): 0xfc2a67b6b40833bb651a702e9e36811053bc5a01f58a96d150c9191a672e4169
-----Encoded View---------------
33 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000100
Arg [1] : 00000000000000000000000000000000000000000000000000000000000002a0
Arg [2] : 0000000000000000000000000000000000000000000000000000000000000320
Arg [3] : 00000000000000000000000000000000000000000000000000000000000003a0
Arg [4] : 00000000000000000000000000000000000000000000000000000000000001f4
Arg [5] : 000000000000000000000000428deb81a93bed820068724eb1fcc7503d71e417
Arg [6] : 00000000000000000000000065db9966492c0a5ac0ef15c018c19ee383f7a8cf
Arg [7] : fc2a67b6b40833bb651a702e9e36811053bc5a01f58a96d150c9191a672e4169
Arg [8] : 00000000000000000000000000000000000000000000000000000000000000a0
Arg [9] : 00000000000000000000000000000000000000000000000000000000000000e0
Arg [10] : 0000000000000000000000006b3b5a079f905fce13ff9d128e7d59bf40d1366c
Arg [11] : 0000000000000000000000000000000000000000000000000000000000000120
Arg [12] : 0000000000000000000000000000000000000000000000000000000000000d05
Arg [13] : 0000000000000000000000000000000000000000000000000000000000000007
Arg [14] : 5a6f6f2045766500000000000000000000000000000000000000000000000000
Arg [15] : 0000000000000000000000000000000000000000000000000000000000000003
Arg [16] : 5a4f4f0000000000000000000000000000000000000000000000000000000000
Arg [17] : 0000000000000000000000000000000000000000000000000000000000000043
Arg [18] : 697066733a2f2f62616679626569663732333436767661617a6a6b68677a7532
Arg [19] : 666f636c323662656b636669747178377a6d7a6a65376d697267746e6b796278
Arg [20] : 75712f0000000000000000000000000000000000000000000000000000000000
Arg [21] : 0000000000000000000000000000000000000000000000000000000000000003
Arg [22] : 0000000000000000000000000000000000000000000000000000000000000001
Arg [23] : 0000000000000000000000000000000000000000000000000000000000000001
Arg [24] : 0000000000000000000000000000000000000000000000000000000000000002
Arg [25] : 0000000000000000000000000000000000000000000000000000000000000003
Arg [26] : 00000000000000000000000000000000000000000000000000000000000000c8
Arg [27] : 0000000000000000000000000000000000000000000000000000000000000673
Arg [28] : 00000000000000000000000000000000000000000000000000000000000005ca
Arg [29] : 0000000000000000000000000000000000000000000000000000000000000003
Arg [30] : 0000000000000000000000000000000000000000000000000000000000000000
Arg [31] : 0000000000000000000000000000000000000000000000000000000000000000
Arg [32] : 0000000000000000000000000000000000000000000000000000000000000000
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 34 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.