ERC-721
Overview
Max Total Supply
5,751 BROYALE
Holders
518
Market
Volume (24H)
N/A
Min Price (24H)
N/A
Max Price (24H)
N/A
Other Info
Token Contract
Balance
1 BROYALELoading...
Loading
Loading...
Loading
Loading...
Loading
# | Exchange | Pair | Price | 24H Volume | % Volume |
---|
Contract Name:
BushidoRoyale
Compiler Version
v0.8.9+commit.e5eed63a
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT pragma solidity ^0.8.9; import "erc721a/contracts/ERC721A.sol"; import "./access/AdminControl.sol"; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import "@openzeppelin/contracts/access/Ownable.sol"; import "@openzeppelin/contracts/utils/Address.sol"; import "@openzeppelin/contracts/utils/Strings.sol"; import "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol"; import "@chainlink/contracts/src/v0.8/VRFConsumerBase.sol"; contract BushidoRoyale is ERC721A, AdminControl, VRFConsumerBase, Ownable { using Strings for uint256; using MerkleProof for bytes32[]; // General mint settings uint256 public constant maxSupply = 7777; uint256 public currentMaxSupply = 3000; uint256 public maxPerTransaction = 20; bool public letContractMint = false; // Phase 1: Free mints uint256 public freeMintStartTimestamp; bytes32 public rootMintFree; mapping (address => uint256) public freeMints; bool public freeMintsActive = false; // Phase 2: Allowlist Sale uint256 public presaleStartTimestamp; bytes32 public root; mapping (address => uint256) public presaleMints; uint256 public presalePrice = 0.09 ether; bool public presaleActive = false; // Phase 3: Public Sale uint256 public saleStartTimestamp; uint256 public salePrice = 0.09 ether; bool public saleActive = false; // Owner mints uint256 public ownerMints; uint256 public ownerMintAllowance = 200; // Chainlink & Randomness // Assume three mint stages (0, 1, 2) requiring hashes and offsets bytes32 private s_keyHash; uint256 private s_fee; mapping (uint256 => bytes32) public provenanceHashes; mapping (uint256 => uint256) public offsets; mapping (uint256 => bool) public offsetsRequested; mapping (uint256 => uint256) public stageSizes; mapping (bytes32 => uint256) public offsetRequestIds; // Metadata string public tokenBaseURI; string private notRevealedUri; bool private revealed = false; // Addresses address private payableAddressTeam; address private payableAddressDev; constructor( bytes32 merkleroot, bytes32 _rootMintFree, string memory uri, address vrfCoordinator, address link, bytes32 keyhash, uint256 fee, address _payableAddressTeam, address _payableAddressDev ) ERC721A("Bushido Royale", "BROYALE") VRFConsumerBase(vrfCoordinator, link) { root = merkleroot; rootMintFree = _rootMintFree; notRevealedUri = uri; s_keyHash = keyhash; s_fee = fee; payableAddressTeam = _payableAddressTeam; payableAddressDev = _payableAddressDev; } // Mint Functions function mintPresale(uint256 _allowance, bytes32[] calldata _proof, uint256 _tokenQuantity) external payable { require(presaleActive, "PRESALE NOT ACTIVE"); require(block.timestamp >= presaleStartTimestamp, "PRESALE NOT ACTIVE"); require(_proof.verify(root, keccak256(abi.encodePacked(msg.sender, _allowance))), "NOT ON ALLOWLIST"); require(presaleMints[msg.sender] + _tokenQuantity <= _allowance, "MINTING MORE THAN ALLOWED"); require(_tokenQuantity * presalePrice <= msg.value, "INCORRECT PAYMENT AMOUNT"); uint256 currentSupply = totalSupply(); require(_tokenQuantity + currentSupply <= currentMaxSupply, "NOT ENOUGH LEFT IN STOCK"); _mint(msg.sender, _tokenQuantity); presaleMints[msg.sender] += _tokenQuantity; } function mintFree(uint256 _allowance, bytes32[] calldata _proof, uint256 _tokenQuantity) external { require(freeMintsActive, "FREE MINT NOT ACTIVE"); require(block.timestamp >= freeMintStartTimestamp, "FREE MINT NOT ACTIVE"); require(_proof.verify(rootMintFree, keccak256(abi.encodePacked(msg.sender, _allowance))), "NOT ON FREE MINT ALLOWLIST"); require(freeMints[msg.sender] + _tokenQuantity <= _allowance, "MINTING MORE THAN ALLOWED"); uint256 currentSupply = totalSupply(); require(_tokenQuantity + currentSupply <= currentMaxSupply, "NOT ENOUGH LEFT IN STOCK"); _mint(msg.sender, _tokenQuantity); freeMints[msg.sender] += _tokenQuantity; } function mint(uint256 _tokenQuantity) external payable { if (!letContractMint) { require(msg.sender == tx.origin, "CONTRACT NOT ALLOWED TO MINT"); } require(saleActive, "SALE NOT ACTIVE"); require(block.timestamp >= saleStartTimestamp, "SALE NOT ACTIVE"); require(_tokenQuantity <= maxPerTransaction, "MINTING MORE THAN ALLOWED IN A SINGLE TRANSACTION"); require(_tokenQuantity * salePrice <= msg.value, "INCORRECT PAYMENT AMOUNT"); uint256 currentSupply = totalSupply(); require(_tokenQuantity + currentSupply <= currentMaxSupply, "NOT ENOUGH LEFT IN STOCK"); _mint(msg.sender, _tokenQuantity); } function ownerMint(address _to, uint256 _tokenQuantity) external onlyAdmin { uint256 currentSupply = totalSupply(); require(_tokenQuantity + ownerMints <= ownerMintAllowance, "MINTING MORE THAN ALLOWED"); require(_tokenQuantity + currentSupply <= maxSupply, "NOT ENOUGH LEFT IN STOCK"); _mint(_to, _tokenQuantity); ownerMints += _tokenQuantity; } function tokenURI(uint256 tokenId) public view virtual override returns (string memory) { require(_exists(tokenId), "URI query for nonexistent token"); if (revealed == false) { return notRevealedUri; } else { return string(abi.encodePacked(tokenBaseURI, tokenId.toString())); } } // Chainlink Randomness function generateRandomOffset(uint256 _mintStage, uint256 _stageSize) public onlyAdmin { require(LINK.balanceOf(address(this)) >= s_fee, "Not enough LINK to pay fee"); require(!offsetsRequested[_mintStage], "Already generated random offset"); bytes32 requestId = requestRandomness(s_keyHash, s_fee); offsetRequestIds[requestId] = _mintStage; stageSizes[_mintStage] = _stageSize; } function fulfillRandomness(bytes32 requestId, uint256 randomness) internal override { uint256 mintStage = offsetRequestIds[requestId]; // transform the result to a number between 1 and the size of the stage inclusively uint256 newOffset = (randomness % stageSizes[mintStage]) + 1; offsets[mintStage] = newOffset; offsetsRequested[mintStage] = true; } // Admin Configuration function setFreeMints(bool _freeMintStatus) external onlyAdmin { freeMintsActive = _freeMintStatus; } function setPresale(bool _presaleStatus) external onlyAdmin { presaleActive = _presaleStatus; } function setSale(bool _saleStatus) external onlyAdmin { saleActive = _saleStatus; } function setURIStatus(bool _revealed, string calldata _tokenBaseURI) external onlyAdmin { require(bytes(_tokenBaseURI).length > 0, "_tokenBaseURI is empty"); revealed = _revealed; tokenBaseURI = _tokenBaseURI; } function setRoot(bytes32 _root) external onlyAdmin { require(_root.length > 0, "_root is empty"); root = _root; } function setRootMintFree(bytes32 _root) external onlyAdmin { require(_root.length > 0, "_root is empty"); rootMintFree = _root; } function setMaxPerTransaction(uint256 _maxPerTransaction) external onlyAdmin { require(_maxPerTransaction > 0, "maxPerTransaction should be positive"); maxPerTransaction = _maxPerTransaction; } function setPrice(uint _salePrice) external onlyAdmin { salePrice = _salePrice; } function setPresalePrice(uint _presalePrice) external onlyAdmin { presalePrice = _presalePrice; } function setLetContractMint(bool _letContractMint) external onlyAdmin { letContractMint = _letContractMint; } function setOwnerMintAllowance(uint256 _ownerMintAllowance) external onlyAdmin { ownerMintAllowance = _ownerMintAllowance; } function setCurrentMaxSupply(uint256 _currentMaxSupply) external onlyAdmin { require(_currentMaxSupply <= maxSupply, "REQUESTED SUPPLY TOO HIGH"); currentMaxSupply = _currentMaxSupply; } function setProvenanceHash(uint256 _mintStage, bytes32 _provenanceHash) external onlyAdmin { provenanceHashes[_mintStage] = _provenanceHash; } function setFreeMintStartTimestamp(uint256 _freeMintStartTimestamp) external onlyAdmin { require(_freeMintStartTimestamp > 0); freeMintStartTimestamp = _freeMintStartTimestamp; } function setPresaleStartTimestamp(uint256 _presaleStartTimestamp) external onlyAdmin { require(_presaleStartTimestamp > 0); presaleStartTimestamp = _presaleStartTimestamp; } function setSaleStartTimestamp(uint256 _saleStartTimestamp) external onlyAdmin { require(_saleStartTimestamp > 0); saleStartTimestamp = _saleStartTimestamp; } function withdraw() external onlyAdmin { Address.sendValue(payable(payableAddressDev), address(this).balance * 2 / 10); Address.sendValue(payable(payableAddressTeam), address(this).balance); } function withdrawTokens(IERC20 token) public onlyAdmin { require(address(token) != address(0)); token.transfer(msg.sender, token.balanceOf(address(this))); } // Required Overrides function supportsInterface(bytes4 interfaceId) public view virtual override(AccessControl, ERC721A) returns (bool) { return interfaceId == type(IAccessControl).interfaceId || interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165. interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721. interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata. } function _startTokenId() internal view virtual override returns (uint256) { return 1; } receive() external payable {} }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "./interfaces/LinkTokenInterface.sol"; import "./VRFRequestIDBase.sol"; /** **************************************************************************** * @notice Interface for contracts using VRF randomness * ***************************************************************************** * @dev PURPOSE * * @dev Reggie the Random Oracle (not his real job) wants to provide randomness * @dev to Vera the verifier in such a way that Vera can be sure he's not * @dev making his output up to suit himself. Reggie provides Vera a public key * @dev to which he knows the secret key. Each time Vera provides a seed to * @dev Reggie, he gives back a value which is computed completely * @dev deterministically from the seed and the secret key. * * @dev Reggie provides a proof by which Vera can verify that the output was * @dev correctly computed once Reggie tells it to her, but without that proof, * @dev the output is indistinguishable to her from a uniform random sample * @dev from the output space. * * @dev The purpose of this contract is to make it easy for unrelated contracts * @dev to talk to Vera the verifier about the work Reggie is doing, to provide * @dev simple access to a verifiable source of randomness. * ***************************************************************************** * @dev USAGE * * @dev Calling contracts must inherit from VRFConsumerBase, and can * @dev initialize VRFConsumerBase's attributes in their constructor as * @dev shown: * * @dev contract VRFConsumer { * @dev constructor(<other arguments>, address _vrfCoordinator, address _link) * @dev VRFConsumerBase(_vrfCoordinator, _link) public { * @dev <initialization with other arguments goes here> * @dev } * @dev } * * @dev The oracle will have given you an ID for the VRF keypair they have * @dev committed to (let's call it keyHash), and have told you the minimum LINK * @dev price for VRF service. Make sure your contract has sufficient LINK, and * @dev call requestRandomness(keyHash, fee, seed), where seed is the input you * @dev want to generate randomness from. * * @dev Once the VRFCoordinator has received and validated the oracle's response * @dev to your request, it will call your contract's fulfillRandomness method. * * @dev The randomness argument to fulfillRandomness is the actual random value * @dev generated from your seed. * * @dev The requestId argument is generated from the keyHash and the seed by * @dev makeRequestId(keyHash, seed). If your contract could have concurrent * @dev requests open, you can use the requestId to track which seed is * @dev associated with which randomness. See VRFRequestIDBase.sol for more * @dev details. (See "SECURITY CONSIDERATIONS" for principles to keep in mind, * @dev if your contract could have multiple requests in flight simultaneously.) * * @dev Colliding `requestId`s are cryptographically impossible as long as seeds * @dev differ. (Which is critical to making unpredictable randomness! See the * @dev next section.) * * ***************************************************************************** * @dev SECURITY CONSIDERATIONS * * @dev A method with the ability to call your fulfillRandomness method directly * @dev could spoof a VRF response with any random value, so it's critical that * @dev it cannot be directly called by anything other than this base contract * @dev (specifically, by the VRFConsumerBase.rawFulfillRandomness method). * * @dev For your users to trust that your contract's random behavior is free * @dev from malicious interference, it's best if you can write it so that all * @dev behaviors implied by a VRF response are executed *during* your * @dev fulfillRandomness method. If your contract must store the response (or * @dev anything derived from it) and use it later, you must ensure that any * @dev user-significant behavior which depends on that stored value cannot be * @dev manipulated by a subsequent VRF request. * * @dev Similarly, both miners and the VRF oracle itself have some influence * @dev over the order in which VRF responses appear on the blockchain, so if * @dev your contract could have multiple VRF requests in flight simultaneously, * @dev you must ensure that the order in which the VRF responses arrive cannot * @dev be used to manipulate your contract's user-significant behavior. * * @dev Since the ultimate input to the VRF is mixed with the block hash of the * @dev block in which the request is made, user-provided seeds have no impact * @dev on its economic security properties. They are only included for API * @dev compatability with previous versions of this contract. * * @dev Since the block hash of the block which contains the requestRandomness * @dev call is mixed into the input to the VRF *last*, a sufficiently powerful * @dev miner could, in principle, fork the blockchain to evict the block * @dev containing the request, forcing the request to be included in a * @dev different block with a different hash, and therefore a different input * @dev to the VRF. However, such an attack would incur a substantial economic * @dev cost. This cost scales with the number of blocks the VRF oracle waits * @dev until it calls responds to a request. */ abstract contract VRFConsumerBase is VRFRequestIDBase { /** * @notice fulfillRandomness handles the VRF response. Your contract must * @notice implement it. See "SECURITY CONSIDERATIONS" above for important * @notice principles to keep in mind when implementing your fulfillRandomness * @notice method. * * @dev VRFConsumerBase expects its subcontracts to have a method with this * @dev signature, and will call it once it has verified the proof * @dev associated with the randomness. (It is triggered via a call to * @dev rawFulfillRandomness, below.) * * @param requestId The Id initially returned by requestRandomness * @param randomness the VRF output */ function fulfillRandomness(bytes32 requestId, uint256 randomness) internal virtual; /** * @dev In order to keep backwards compatibility we have kept the user * seed field around. We remove the use of it because given that the blockhash * enters later, it overrides whatever randomness the used seed provides. * Given that it adds no security, and can easily lead to misunderstandings, * we have removed it from usage and can now provide a simpler API. */ uint256 private constant USER_SEED_PLACEHOLDER = 0; /** * @notice requestRandomness initiates a request for VRF output given _seed * * @dev The fulfillRandomness method receives the output, once it's provided * @dev by the Oracle, and verified by the vrfCoordinator. * * @dev The _keyHash must already be registered with the VRFCoordinator, and * @dev the _fee must exceed the fee specified during registration of the * @dev _keyHash. * * @dev The _seed parameter is vestigial, and is kept only for API * @dev compatibility with older versions. It can't *hurt* to mix in some of * @dev your own randomness, here, but it's not necessary because the VRF * @dev oracle will mix the hash of the block containing your request into the * @dev VRF seed it ultimately uses. * * @param _keyHash ID of public key against which randomness is generated * @param _fee The amount of LINK to send with the request * * @return requestId unique ID for this request * * @dev The returned requestId can be used to distinguish responses to * @dev concurrent requests. It is passed as the first argument to * @dev fulfillRandomness. */ function requestRandomness(bytes32 _keyHash, uint256 _fee) internal returns (bytes32 requestId) { LINK.transferAndCall(vrfCoordinator, _fee, abi.encode(_keyHash, USER_SEED_PLACEHOLDER)); // This is the seed passed to VRFCoordinator. The oracle will mix this with // the hash of the block containing this request to obtain the seed/input // which is finally passed to the VRF cryptographic machinery. uint256 vRFSeed = makeVRFInputSeed(_keyHash, USER_SEED_PLACEHOLDER, address(this), nonces[_keyHash]); // nonces[_keyHash] must stay in sync with // VRFCoordinator.nonces[_keyHash][this], which was incremented by the above // successful LINK.transferAndCall (in VRFCoordinator.randomnessRequest). // This provides protection against the user repeating their input seed, // which would result in a predictable/duplicate output, if multiple such // requests appeared in the same block. nonces[_keyHash] = nonces[_keyHash] + 1; return makeRequestId(_keyHash, vRFSeed); } LinkTokenInterface internal immutable LINK; address private immutable vrfCoordinator; // Nonces for each VRF key from which randomness has been requested. // // Must stay in sync with VRFCoordinator[_keyHash][this] mapping(bytes32 => uint256) /* keyHash */ /* nonce */ private nonces; /** * @param _vrfCoordinator address of VRFCoordinator contract * @param _link address of LINK token contract * * @dev https://docs.chain.link/docs/link-token-contracts */ constructor(address _vrfCoordinator, address _link) { vrfCoordinator = _vrfCoordinator; LINK = LinkTokenInterface(_link); } // rawFulfillRandomness is called by VRFCoordinator when it receives a valid VRF // proof. rawFulfillRandomness then calls fulfillRandomness, after validating // the origin of the call function rawFulfillRandomness(bytes32 requestId, uint256 randomness) external { require(msg.sender == vrfCoordinator, "Only VRFCoordinator can fulfill"); fulfillRandomness(requestId, randomness); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; contract VRFRequestIDBase { /** * @notice returns the seed which is actually input to the VRF coordinator * * @dev To prevent repetition of VRF output due to repetition of the * @dev user-supplied seed, that seed is combined in a hash with the * @dev user-specific nonce, and the address of the consuming contract. The * @dev risk of repetition is mostly mitigated by inclusion of a blockhash in * @dev the final seed, but the nonce does protect against repetition in * @dev requests which are included in a single block. * * @param _userSeed VRF seed input provided by user * @param _requester Address of the requesting contract * @param _nonce User-specific nonce at the time of the request */ function makeVRFInputSeed( bytes32 _keyHash, uint256 _userSeed, address _requester, uint256 _nonce ) internal pure returns (uint256) { return uint256(keccak256(abi.encode(_keyHash, _userSeed, _requester, _nonce))); } /** * @notice Returns the id for this request * @param _keyHash The serviceAgreement ID to be used for this request * @param _vRFInputSeed The seed to be passed directly to the VRF * @return The id for this request * * @dev Note that _vRFInputSeed is not the seed passed by the consuming * @dev contract, but the one generated by makeVRFInputSeed */ function makeRequestId(bytes32 _keyHash, uint256 _vRFInputSeed) internal pure returns (bytes32) { return keccak256(abi.encodePacked(_keyHash, _vRFInputSeed)); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; interface LinkTokenInterface { function allowance(address owner, address spender) external view returns (uint256 remaining); function approve(address spender, uint256 value) external returns (bool success); function balanceOf(address owner) external view returns (uint256 balance); function decimals() external view returns (uint8 decimalPlaces); function decreaseApproval(address spender, uint256 addedValue) external returns (bool success); function increaseApproval(address spender, uint256 subtractedValue) external; function name() external view returns (string memory tokenName); function symbol() external view returns (string memory tokenSymbol); function totalSupply() external view returns (uint256 totalTokensIssued); function transfer(address to, uint256 value) external returns (bool success); function transferAndCall( address to, uint256 value, bytes calldata data ) external returns (bool success); function transferFrom( address from, address to, uint256 value ) external returns (bool success); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "./IAccessControl.sol"; import "../utils/Context.sol"; import "../utils/Strings.sol"; import "../utils/introspection/ERC165.sol"; /** * @dev Contract module that allows children to implement role-based access * control mechanisms. This is a lightweight version that doesn't allow enumerating role * members except through off-chain means by accessing the contract event logs. Some * applications may benefit from on-chain enumerability, for those cases see * {AccessControlEnumerable}. * * Roles are referred to by their `bytes32` identifier. These should be exposed * in the external API and be unique. The best way to achieve this is by * using `public constant` hash digests: * * ``` * bytes32 public constant MY_ROLE = keccak256("MY_ROLE"); * ``` * * Roles can be used to represent a set of permissions. To restrict access to a * function call, use {hasRole}: * * ``` * function foo() public { * require(hasRole(MY_ROLE, msg.sender)); * ... * } * ``` * * Roles can be granted and revoked dynamically via the {grantRole} and * {revokeRole} functions. Each role has an associated admin role, and only * accounts that have a role's admin role can call {grantRole} and {revokeRole}. * * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means * that only accounts with this role will be able to grant or revoke other * roles. More complex role relationships can be created by using * {_setRoleAdmin}. * * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to * grant and revoke this role. Extra precautions should be taken to secure * accounts that have been granted it. */ abstract contract AccessControl is Context, IAccessControl, ERC165 { struct RoleData { mapping(address => bool) members; bytes32 adminRole; } mapping(bytes32 => RoleData) private _roles; bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00; /** * @dev Modifier that checks that an account has a specific role. Reverts * with a standardized message including the required role. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ * * _Available since v4.1._ */ modifier onlyRole(bytes32 role) { _checkRole(role, _msgSender()); _; } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) public view override returns (bool) { return _roles[role].members[account]; } /** * @dev Revert with a standard message if `account` is missing `role`. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ */ function _checkRole(bytes32 role, address account) internal view { if (!hasRole(role, account)) { revert( string( abi.encodePacked( "AccessControl: account ", Strings.toHexString(uint160(account), 20), " is missing role ", Strings.toHexString(uint256(role), 32) ) ) ); } } /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) public view override returns (bytes32) { return _roles[role].adminRole; } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _grantRole(role, account); } /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _revokeRole(role, account); } /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been granted `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. */ function renounceRole(bytes32 role, address account) public virtual override { require(account == _msgSender(), "AccessControl: can only renounce roles for self"); _revokeRole(role, account); } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. Note that unlike {grantRole}, this function doesn't perform any * checks on the calling account. * * [WARNING] * ==== * This function should only be called from the constructor when setting * up the initial roles for the system. * * Using this function in any other way is effectively circumventing the admin * system imposed by {AccessControl}. * ==== */ function _setupRole(bytes32 role, address account) internal virtual { _grantRole(role, account); } /** * @dev Sets `adminRole` as ``role``'s admin role. * * Emits a {RoleAdminChanged} event. */ function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual { bytes32 previousAdminRole = getRoleAdmin(role); _roles[role].adminRole = adminRole; emit RoleAdminChanged(role, previousAdminRole, adminRole); } function _grantRole(bytes32 role, address account) private { if (!hasRole(role, account)) { _roles[role].members[account] = true; emit RoleGranted(role, account, _msgSender()); } } function _revokeRole(bytes32 role, address account) private { if (hasRole(role, account)) { _roles[role].members[account] = false; emit RoleRevoked(role, account, _msgSender()); } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; /** * @dev External interface of AccessControl declared to support ERC165 detection. */ interface IAccessControl { /** * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole` * * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite * {RoleAdminChanged} not being emitted signaling this. * * _Available since v3.1._ */ event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole); /** * @dev Emitted when `account` is granted `role`. * * `sender` is the account that originated the contract call, an admin role * bearer except when using {AccessControl-_setupRole}. */ event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Emitted when `account` is revoked `role`. * * `sender` is the account that originated the contract call: * - if using `revokeRole`, it is the admin role bearer * - if using `renounceRole`, it is the role bearer (i.e. `account`) */ event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) external view returns (bool); /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {AccessControl-_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) external view returns (bytes32); /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function grantRole(bytes32 role, address account) external; /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function revokeRole(bytes32 role, address account) external; /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been granted `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. */ function renounceRole(bytes32 role, address account) external; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "../utils/Context.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract Ownable is Context { address private _owner; event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the deployer as the initial owner. */ constructor() { _setOwner(_msgSender()); } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { require(owner() == _msgSender(), "Ownable: caller is not the owner"); _; } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions anymore. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby removing any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _setOwner(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _setOwner(newOwner); } function _setOwner(address newOwner) private { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @dev Returns the amount of tokens in existence. */ function totalSupply() external view returns (uint256); /** * @dev Returns the amount of tokens owned by `account`. */ function balanceOf(address account) external view returns (uint256); /** * @dev Moves `amount` tokens from the caller's account to `recipient`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address recipient, uint256 amount) external returns (bool); /** * @dev Returns the remaining number of tokens that `spender` will be * allowed to spend on behalf of `owner` through {transferFrom}. This is * zero by default. * * This value changes when {approve} or {transferFrom} are called. */ function allowance(address owner, address spender) external view returns (uint256); /** * @dev Sets `amount` as the allowance of `spender` over the caller's tokens. * * Returns a boolean value indicating whether the operation succeeded. * * IMPORTANT: Beware that changing an allowance with this method brings the risk * that someone may use both the old and the new allowance by unfortunate * transaction ordering. One possible solution to mitigate this race * condition is to first reduce the spender's allowance to 0 and set the * desired value afterwards: * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 * * Emits an {Approval} event. */ function approve(address spender, uint256 amount) external returns (bool); /** * @dev Moves `amount` tokens from `sender` to `recipient` using the * allowance mechanism. `amount` is then deducted from the caller's * allowance. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transferFrom( address sender, address recipient, uint256 amount ) external returns (bool); /** * @dev Emitted when `value` tokens are moved from one account (`from`) to * another (`to`). * * Note that `value` may be zero. */ event Transfer(address indexed from, address indexed to, uint256 value); /** * @dev Emitted when the allowance of a `spender` for an `owner` is set by * a call to {approve}. `value` is the new allowance. */ event Approval(address indexed owner, address indexed spender, uint256 value); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize, which returns 0 for contracts in // construction, since the code is only stored at the end of the // constructor execution. uint256 size; assembly { size := extcodesize(account) } return size > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCall(target, data, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value ) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); require(isContract(target), "Address: call to non-contract"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { require(isContract(target), "Address: static call to non-contract"); (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { require(isContract(target), "Address: delegate call to non-contract"); (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; /** * @dev String operations. */ library Strings { bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef"; /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { // Inspired by OraclizeAPI's implementation - MIT licence // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol if (value == 0) { return "0"; } uint256 temp = value; uint256 digits; while (temp != 0) { digits++; temp /= 10; } bytes memory buffer = new bytes(digits); while (value != 0) { digits -= 1; buffer[digits] = bytes1(uint8(48 + uint256(value % 10))); value /= 10; } return string(buffer); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { if (value == 0) { return "0x00"; } uint256 temp = value; uint256 length = 0; while (temp != 0) { length++; temp >>= 8; } return toHexString(value, length); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = _HEX_SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "Strings: hex length insufficient"); return string(buffer); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; /** * @dev These functions deal with verification of Merkle Trees proofs. * * The proofs can be generated using the JavaScript library * https://github.com/miguelmota/merkletreejs[merkletreejs]. * Note: the hashing algorithm should be keccak256 and pair sorting should be enabled. * * See `test/utils/cryptography/MerkleProof.test.js` for some examples. */ library MerkleProof { /** * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree * defined by `root`. For this, a `proof` must be provided, containing * sibling hashes on the branch from the leaf to the root of the tree. Each * pair of leaves and each pair of pre-images are assumed to be sorted. */ function verify( bytes32[] memory proof, bytes32 root, bytes32 leaf ) internal pure returns (bool) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { bytes32 proofElement = proof[i]; if (computedHash <= proofElement) { // Hash(current computed hash + current element of the proof) computedHash = keccak256(abi.encodePacked(computedHash, proofElement)); } else { // Hash(current element of the proof + current computed hash) computedHash = keccak256(abi.encodePacked(proofElement, computedHash)); } } // Check if the computed hash (root) is equal to the provided root return computedHash == root; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "./IERC165.sol"; /** * @dev Implementation of the {IERC165} interface. * * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check * for the additional interface id that will be supported. For example: * * ```solidity * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId); * } * ``` * * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation. */ abstract contract ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IERC165).interfaceId; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165 { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.9; import "@openzeppelin/contracts/access/AccessControl.sol"; import "@openzeppelin/contracts/access/IAccessControl.sol"; import "@openzeppelin/contracts/utils/Context.sol"; abstract contract AdminControl is AccessControl { bytes32 public constant ADMIN_ROLE = keccak256("ADMIN_ROLE"); constructor() { _setupRole(DEFAULT_ADMIN_ROLE, _msgSender()); _setupRole(ADMIN_ROLE, _msgSender()); } // ========== Modifiers ========== modifier onlyAdmin() { require(hasRole(ADMIN_ROLE, _msgSender()), "Caller is not an admin"); _; } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.1.0 // Creator: Chiru Labs pragma solidity ^0.8.4; import './IERC721A.sol'; /** * @dev ERC721 token receiver interface. */ interface ERC721A__IERC721Receiver { function onERC721Received( address operator, address from, uint256 tokenId, bytes calldata data ) external returns (bytes4); } /** * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, * including the Metadata extension. Built to optimize for lower gas during batch mints. * * Assumes serials are sequentially minted starting at `_startTokenId()` * (defaults to 0, e.g. 0, 1, 2, 3..). * * Assumes that an owner cannot have more than 2**64 - 1 (max value of uint64) of supply. * * Assumes that the maximum token id cannot exceed 2**256 - 1 (max value of uint256). */ contract ERC721A is IERC721A { // 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 tokenId of the next token 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 => address) private _tokenApprovals; // Mapping from owner to operator approvals mapping(address => mapping(address => bool)) private _operatorApprovals; constructor(string memory name_, string memory symbol_) { _name = name_; _symbol = symbol_; _currentIndex = _startTokenId(); } /** * @dev Returns the starting token ID. * To change the starting token ID, please override this function. */ function _startTokenId() internal view virtual returns (uint256) { return 0; } /** * @dev Returns the next token ID to be minted. */ function _nextTokenId() internal view 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 override returns (uint256) { // Counter underflow is impossible as _burnCounter cannot be incremented // more than `_currentIndex - _startTokenId()` times. unchecked { return _currentIndex - _burnCounter - _startTokenId(); } } /** * @dev Returns the total amount of tokens minted in the contract. */ function _totalMinted() internal view returns (uint256) { // Counter underflow is impossible as _currentIndex does not decrement, // and it is initialized to `_startTokenId()` unchecked { return _currentIndex - _startTokenId(); } } /** * @dev Returns the total number of tokens burned. */ function _totalBurned() internal view returns (uint256) { return _burnCounter; } /** * @dev See {IERC165-supportsInterface}. */ 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: 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. } /** * @dev See {IERC721-balanceOf}. */ function balanceOf(address owner) public view override returns (uint256) { if (owner == address(0)) revert BalanceQueryForZeroAddress(); return _packedAddressData[owner] & BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens minted by `owner`. */ function _numberMinted(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> BITPOS_NUMBER_MINTED) & BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens burned by or on behalf of `owner`. */ function _numberBurned(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> BITPOS_NUMBER_BURNED) & BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). */ function _getAux(address owner) internal view returns (uint64) { return uint64(_packedAddressData[owner] >> BITPOS_AUX); } /** * Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). * If there are multiple variables, please pack them into a uint64. */ function _setAux(address owner, uint64 aux) internal { 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; } /** * Returns the packed ownership data of `tokenId`. */ function _packedOwnershipOf(uint256 tokenId) private view returns (uint256) { uint256 curr = tokenId; unchecked { if (_startTokenId() <= curr) if (curr < _currentIndex) { uint256 packed = _packedOwnerships[curr]; // If not burned. if (packed & BITMASK_BURNED == 0) { // Invariant: // There will always be an ownership that has an address and is not burned // before an ownership that does not have an address and is not burned. // Hence, curr will not underflow. // // We can directly compare the packed value. // If the address is zero, packed is zero. while (packed == 0) { packed = _packedOwnerships[--curr]; } return packed; } } } revert OwnerQueryForNonexistentToken(); } /** * 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); } /** * Returns the unpacked `TokenOwnership` struct at `index`. */ function _ownershipAt(uint256 index) internal view returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnerships[index]); } /** * @dev Initializes the ownership slot minted at `index` for efficiency purposes. */ function _initializeOwnershipAt(uint256 index) internal { if (_packedOwnerships[index] == 0) { _packedOwnerships[index] = _packedOwnershipOf(index); } } /** * Gas spent here starts off proportional to the maximum mint batch size. * It gradually moves to O(1) as tokens get transferred around in the collection over time. */ function _ownershipOf(uint256 tokenId) internal view returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnershipOf(tokenId)); } /** * @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 See {IERC721-ownerOf}. */ function ownerOf(uint256 tokenId) public view override returns (address) { return address(uint160(_packedOwnershipOf(tokenId))); } /** * @dev See {IERC721Metadata-name}. */ function name() public view virtual override returns (string memory) { return _name; } /** * @dev See {IERC721Metadata-symbol}. */ function symbol() public view virtual override returns (string memory) { return _symbol; } /** * @dev See {IERC721Metadata-tokenURI}. */ function tokenURI(uint256 tokenId) public view virtual override returns (string memory) { if (!_exists(tokenId)) revert URIQueryForNonexistentToken(); string memory baseURI = _baseURI(); return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : ''; } /** * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each * token will be the concatenation of the `baseURI` and the `tokenId`. Empty * by default, it can be overridden in child contracts. */ function _baseURI() internal view virtual returns (string memory) { return ''; } /** * @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)) } } /** * @dev See {IERC721-approve}. */ function approve(address to, uint256 tokenId) public override { address owner = ownerOf(tokenId); if (_msgSenderERC721A() != owner) if (!isApprovedForAll(owner, _msgSenderERC721A())) { revert ApprovalCallerNotOwnerNorApproved(); } _tokenApprovals[tokenId] = to; emit Approval(owner, to, tokenId); } /** * @dev See {IERC721-getApproved}. */ function getApproved(uint256 tokenId) public view override returns (address) { if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken(); return _tokenApprovals[tokenId]; } /** * @dev See {IERC721-setApprovalForAll}. */ function setApprovalForAll(address operator, bool approved) public virtual override { if (operator == _msgSenderERC721A()) revert ApproveToCaller(); _operatorApprovals[_msgSenderERC721A()][operator] = approved; emit ApprovalForAll(_msgSenderERC721A(), operator, approved); } /** * @dev See {IERC721-isApprovedForAll}. */ function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) { return _operatorApprovals[owner][operator]; } /** * @dev See {IERC721-safeTransferFrom}. */ function safeTransferFrom( address from, address to, uint256 tokenId ) public virtual override { safeTransferFrom(from, to, tokenId, ''); } /** * @dev See {IERC721-safeTransferFrom}. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes memory _data ) public virtual override { transferFrom(from, to, tokenId); if (to.code.length != 0) if (!_checkContractOnERC721Received(from, to, tokenId, _data)) { revert TransferToNonERC721ReceiverImplementer(); } } /** * @dev Returns whether `tokenId` exists. * * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}. * * Tokens start existing when they are minted (`_mint`), */ function _exists(uint256 tokenId) internal view returns (bool) { return _startTokenId() <= tokenId && tokenId < _currentIndex && // If within bounds, _packedOwnerships[tokenId] & BITMASK_BURNED == 0; // and not burned. } /** * @dev Equivalent to `_safeMint(to, quantity, '')`. */ function _safeMint(address to, uint256 quantity) internal { _safeMint(to, 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 { _mint(to, quantity); unchecked { if (to.code.length != 0) { uint256 end = _currentIndex; uint256 index = end - quantity; do { if (!_checkContractOnERC721Received(address(0), to, index++, _data)) { revert TransferToNonERC721ReceiverImplementer(); } } while (index < end); // Reentrancy protection. if (_currentIndex != end) revert(); } } } /** * @dev 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 { uint256 startTokenId = _currentIndex; if (to == address(0)) revert MintToZeroAddress(); if (quantity == 0) revert MintZeroQuantity(); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are incredibly unrealistic. // `balance` and `numberMinted` have a maximum limit of 2**64. // `tokenId` has a maximum limit of 2**256. unchecked { // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << BITPOS_NUMBER_MINTED) | 1); // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); uint256 tokenId = startTokenId; uint256 end = startTokenId + quantity; do { emit Transfer(address(0), to, tokenId++); } 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 { uint256 startTokenId = _currentIndex; if (to == address(0)) revert MintToZeroAddress(); if (quantity == 0) revert MintZeroQuantity(); if (quantity > MAX_MINT_ERC2309_QUANTITY_LIMIT) revert MintERC2309QuantityExceedsLimit(); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are unrealistic due to the above check for `quantity` to be below the limit. unchecked { // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << BITPOS_NUMBER_MINTED) | 1); // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to); _currentIndex = startTokenId + quantity; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev Returns the storage slot and value for the approved address of `tokenId`. */ function _getApprovedAddress(uint256 tokenId) private view returns (uint256 approvedAddressSlot, address approvedAddress) { mapping(uint256 => address) storage tokenApprovalsPtr = _tokenApprovals; // The following is equivalent to `approvedAddress = _tokenApprovals[tokenId]`. assembly { // Compute the slot. mstore(0x00, tokenId) mstore(0x20, tokenApprovalsPtr.slot) approvedAddressSlot := keccak256(0x00, 0x40) // Load the slot's value from storage. approvedAddress := sload(approvedAddressSlot) } } /** * @dev Returns whether the `approvedAddress` is equals to `from` or `msgSender`. */ function _isOwnerOrApproved( address approvedAddress, address from, address msgSender ) private pure returns (bool result) { assembly { // Mask `from` to the lower 160 bits, in case the upper bits somehow aren't clean. from := and(from, BITMASK_ADDRESS) // Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean. msgSender := and(msgSender, BITMASK_ADDRESS) // `msgSender == from || msgSender == approvedAddress`. result := or(eq(msgSender, from), eq(msgSender, approvedAddress)) } } /** * @dev Transfers `tokenId` from `from` to `to`. * * Requirements: * * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) public virtual override { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner(); (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedAddress(tokenId); // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isOwnerOrApproved(approvedAddress, from, _msgSenderERC721A())) if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved(); if (to == address(0)) revert TransferToZeroAddress(); _beforeTokenTransfers(from, to, tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as tokenId would have to be 2**256. unchecked { // We can directly increment and decrement the balances. --_packedAddressData[from]; // Updates: `balance -= 1`. ++_packedAddressData[to]; // Updates: `balance += 1`. // Updates: // - `address` to the next owner. // - `startTimestamp` to the timestamp of transfering. // - `burned` to `false`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData( to, BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked) ); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } emit Transfer(from, to, tokenId); _afterTokenTransfers(from, to, tokenId, 1); } /** * @dev Equivalent to `_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) = _getApprovedAddress(tokenId); if (approvalCheck) { // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isOwnerOrApproved(approvedAddress, from, _msgSenderERC721A())) if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved(); } _beforeTokenTransfers(from, address(0), tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // Updates: // - `balance -= 1`. // - `numberBurned += 1`. // // We can directly decrement the balance, and increment the number burned. // This is equivalent to `packed -= 1; packed += 1 << BITPOS_NUMBER_BURNED;`. _packedAddressData[from] += (1 << BITPOS_NUMBER_BURNED) - 1; // Updates: // - `address` to the last owner. // - `startTimestamp` to the timestamp of burning. // - `burned` to `true`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData( from, (BITMASK_BURNED | BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked) ); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } emit Transfer(from, address(0), tokenId); _afterTokenTransfers(from, address(0), tokenId, 1); // Overflow not possible, as _burnCounter cannot be exceed _currentIndex times. unchecked { _burnCounter++; } } /** * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target contract. * * @param from address representing the previous owner of the given token ID * @param to target address that will receive the tokens * @param tokenId uint256 ID of the token to be transferred * @param _data bytes optional data to send along with the call * @return bool whether the call correctly returned the expected magic value */ function _checkContractOnERC721Received( address from, address to, uint256 tokenId, bytes memory _data ) private returns (bool) { try ERC721A__IERC721Receiver(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns ( bytes4 retval ) { return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector; } catch (bytes memory reason) { if (reason.length == 0) { revert TransferToNonERC721ReceiverImplementer(); } else { assembly { revert(add(32, reason), mload(reason)) } } } } /** * @dev Directly sets the extra data for the ownership data `index`. */ function _setExtraDataAt(uint256 index, uint24 extraData) internal { uint256 packed = _packedOwnerships[index]; if (packed == 0) revert OwnershipNotInitializedForExtraData(); uint256 extraDataCasted; // Cast `extraData` with assembly to avoid redundant masking. assembly { extraDataCasted := extraData } packed = (packed & BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << BITPOS_EXTRA_DATA); _packedOwnerships[index] = packed; } /** * @dev 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; } /** * @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 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 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 returns (string memory ptr) { assembly { // The maximum value of a uint256 contains 78 digits (1 byte per digit), // but we allocate 128 bytes to keep the free memory pointer 32-byte word aliged. // We will need 1 32-byte word to store the length, // and 3 32-byte words to store a maximum of 78 digits. Total: 32 + 3 * 32 = 128. ptr := add(mload(0x40), 128) // Update the free memory pointer to allocate. mstore(0x40, ptr) // Cache the end of the memory to calculate the length later. let end := ptr // We write the string from the rightmost digit to the leftmost digit. // The following is essentially a do-while loop that also handles the zero case. // Costs a bit more than early returning for the zero case, // but cheaper in terms of deployment and overall runtime costs. for { // Initialize and perform the first pass without check. let temp := value // Move the pointer 1 byte leftwards to point to an empty character slot. ptr := sub(ptr, 1) // Write the character to the pointer. 48 is the ASCII index of '0'. mstore8(ptr, add(48, mod(temp, 10))) temp := div(temp, 10) } temp { // Keep dividing `temp` until zero. temp := div(temp, 10) } { // Body of the for loop. ptr := sub(ptr, 1) mstore8(ptr, add(48, mod(temp, 10))) } let length := sub(end, ptr) // Move the pointer 32 bytes leftwards to make room for the length. ptr := sub(ptr, 32) // Store the length. mstore(ptr, length) } } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.1.0 // Creator: Chiru Labs pragma solidity ^0.8.4; /** * @dev Interface of an ERC721A compliant contract. */ interface IERC721A { /** * The caller must own the token or be an approved operator. */ error ApprovalCallerNotOwnerNorApproved(); /** * The token does not exist. */ error ApprovalQueryForNonexistentToken(); /** * The caller cannot approve to their own address. */ error ApproveToCaller(); /** * 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(); struct TokenOwnership { // The address of the owner. address addr; // Keeps track of 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 through `_extraData`. uint24 extraData; } /** * @dev Returns the total amount of tokens stored by the contract. * * Burned tokens are calculated here, use `_totalMinted()` if you want to count just minted tokens. */ function totalSupply() external view returns (uint256); // ============================== // IERC165 // ============================== /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); // ============================== // 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`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes calldata data ) external; /** * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients * are aware of the ERC721 protocol to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must 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 ) external; /** * @dev Transfers `tokenId` token from `from` to `to`. * * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) external; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool _approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll} */ function isApprovedForAll(address owner, address operator) external view returns (bool); // ============================== // 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 standard. See `_mintERC2309` for more details. */ event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to); }
{ "evmVersion": "london", "libraries": {}, "metadata": { "bytecodeHash": "ipfs", "useLiteralContent": true }, "optimizer": { "enabled": true, "runs": 1000 }, "remappings": [], "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } } }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[{"internalType":"bytes32","name":"merkleroot","type":"bytes32"},{"internalType":"bytes32","name":"_rootMintFree","type":"bytes32"},{"internalType":"string","name":"uri","type":"string"},{"internalType":"address","name":"vrfCoordinator","type":"address"},{"internalType":"address","name":"link","type":"address"},{"internalType":"bytes32","name":"keyhash","type":"bytes32"},{"internalType":"uint256","name":"fee","type":"uint256"},{"internalType":"address","name":"_payableAddressTeam","type":"address"},{"internalType":"address","name":"_payableAddressDev","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"ApproveToCaller","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":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":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentMaxSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"freeMintStartTimestamp","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"freeMints","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"freeMintsActive","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_mintStage","type":"uint256"},{"internalType":"uint256","name":"_stageSize","type":"uint256"}],"name":"generateRandomOffset","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"letContractMint","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxPerTransaction","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":"_tokenQuantity","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_allowance","type":"uint256"},{"internalType":"bytes32[]","name":"_proof","type":"bytes32[]"},{"internalType":"uint256","name":"_tokenQuantity","type":"uint256"}],"name":"mintFree","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_allowance","type":"uint256"},{"internalType":"bytes32[]","name":"_proof","type":"bytes32[]"},{"internalType":"uint256","name":"_tokenQuantity","type":"uint256"}],"name":"mintPresale","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"offsetRequestIds","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"offsets","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"offsetsRequested","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_tokenQuantity","type":"uint256"}],"name":"ownerMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"ownerMintAllowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"ownerMints","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"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":"presaleActive","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"presaleMints","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"presalePrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"presaleStartTimestamp","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"provenanceHashes","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"requestId","type":"bytes32"},{"internalType":"uint256","name":"randomness","type":"uint256"}],"name":"rawFulfillRandomness","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"root","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rootMintFree","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"saleActive","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"salePrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"saleStartTimestamp","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":"uint256","name":"_currentMaxSupply","type":"uint256"}],"name":"setCurrentMaxSupply","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_freeMintStartTimestamp","type":"uint256"}],"name":"setFreeMintStartTimestamp","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_freeMintStatus","type":"bool"}],"name":"setFreeMints","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_letContractMint","type":"bool"}],"name":"setLetContractMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_maxPerTransaction","type":"uint256"}],"name":"setMaxPerTransaction","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_ownerMintAllowance","type":"uint256"}],"name":"setOwnerMintAllowance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_presaleStatus","type":"bool"}],"name":"setPresale","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_presalePrice","type":"uint256"}],"name":"setPresalePrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_presaleStartTimestamp","type":"uint256"}],"name":"setPresaleStartTimestamp","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_salePrice","type":"uint256"}],"name":"setPrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_mintStage","type":"uint256"},{"internalType":"bytes32","name":"_provenanceHash","type":"bytes32"}],"name":"setProvenanceHash","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_root","type":"bytes32"}],"name":"setRoot","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_root","type":"bytes32"}],"name":"setRootMintFree","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_saleStatus","type":"bool"}],"name":"setSale","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_saleStartTimestamp","type":"uint256"}],"name":"setSaleStartTimestamp","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_revealed","type":"bool"},{"internalType":"string","name":"_tokenBaseURI","type":"string"}],"name":"setURIStatus","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"stageSizes","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","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":"tokenBaseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20","name":"token","type":"address"}],"name":"withdrawTokens","outputs":[],"stateMutability":"nonpayable","type":"function"},{"stateMutability":"payable","type":"receive"}]
Contract Creation Code
60c0604052610bb8600b556014600c55600d805460ff19908116909155601180548216905567013fbe85edc9000060158190556016805483169055601855601980548216905560c8601b556025805490911690553480156200006057600080fd5b50604051620044903803806200449083398101604081905262000083916200039e565b604080518082018252600e81526d4275736869646f20526f79616c6560901b60208083019182528351808501909452600784526642524f59414c4560c81b90840152815189938993929091620000dc91600291620002c5565b508051620000f2906003906020840190620002c5565b50506001600090815562000108915033620001bf565b620001347fa49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c2177533620001bf565b6001600160a01b0391821660a052166080526200015133620001cf565b6013899055600f8890558651620001709060249060208a0190620002c5565b50601c93909355601d9190915560258054610100600160a81b0319166101006001600160a01b0393841602179055602680546001600160a01b0319169190921617905550620005309350505050565b620001cb828262000221565b5050565b600a80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff16620001cb5760008281526008602090815260408083206001600160a01b03851684529091529020805460ff19166001179055620002813390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b828054620002d390620004f3565b90600052602060002090601f016020900481019282620002f7576000855562000342565b82601f106200031257805160ff191683800117855562000342565b8280016001018555821562000342579182015b828111156200034257825182559160200191906001019062000325565b506200035092915062000354565b5090565b5b8082111562000350576000815560010162000355565b634e487b7160e01b600052604160045260246000fd5b80516001600160a01b03811681146200039957600080fd5b919050565b60008060008060008060008060006101208a8c031215620003be57600080fd5b895160208b015160408c0151919a5098506001600160401b0380821115620003e557600080fd5b818c0191508c601f830112620003fa57600080fd5b8151818111156200040f576200040f6200036b565b604051601f8201601f19908116603f011681019083821181831017156200043a576200043a6200036b565b816040528281528f60208487010111156200045457600080fd5b600093505b828410156200047c57602084860101516020858301015260208401935062000459565b828411156200048f576000602084830101525b809b505050505050620004a560608b0162000381565b9550620004b560808b0162000381565b945060a08a0151935060c08a01519250620004d360e08b0162000381565b9150620004e46101008b0162000381565b90509295985092959850929598565b600181811c908216806200050857607f821691505b602082108114156200052a57634e487b7160e01b600052602260045260246000fd5b50919050565b60805160a051613f2c620005646000396000818161234201526130f601526000818161191401526130c70152613f2c6000f3fe60806040526004361061049e5760003560e01c80636f8d93051161025e578063a22cb46511610143578063d5abeb01116100bb578063e985e9c51161008a578063f2fde38b1161006f578063f2fde38b14610d5e578063f51f96dd14610d7e578063ff50188514610d9457600080fd5b8063e985e9c514610cff578063ebf0c71714610d4857600080fd5b8063d5abeb0114610c7c578063dab5f34014610c92578063e3bc776214610cb2578063e5c2b7d114610cd257600080fd5b8063c54e73e311610112578063c87b56dd116100f7578063c87b56dd14610c1c578063ccfdd2f814610c3c578063d547741f14610c5c57600080fd5b8063c54e73e314610bdc578063c56c0b9214610bfc57600080fd5b8063a22cb46514610b6c578063a22d363d14610b8c578063b7612afe14610ba2578063b88d4fde14610bbc57600080fd5b806391d14854116101d657806398029d2a116101a55780639b2a96d21161018a5780639b2a96d214610b15578063a0712d6814610b44578063a217fddf14610b5757600080fd5b806398029d2a14610ace5780639aecf1f014610ae857600080fd5b806391d1485414610a3357806392c46da314610a7957806394985ddd14610a9957806395d89b4114610ab957600080fd5b806375b238fc1161022d5780638469775d116102125780638469775d146109d55780638da5cb5b146109f557806391b7f5ed14610a1357600080fd5b806375b238fc1461098657806381914619146109a857600080fd5b80636f8d93051461091157806370a0823114610931578063715018a614610951578063730220111461096657600080fd5b80633c14a2de116103845780634e99b800116102fc5780635fc9c0e6116102cb5780636352211e116102b05780636352211e146108aa57806368428a1b146108ca5780636d41d4fb146108e457600080fd5b80635fc9c0e61461087e5780636327c7741461089457600080fd5b80634e99b800146108195780634ea37fec1461082e57806353135ca01461084457806356ec0e7b1461085e57600080fd5b806342842e0e11610353578063484b973c11610338578063484b973c146107c357806349df728c146107e35780634b980d671461080357600080fd5b806342842e0e1461078357806345a6480a146107a357600080fd5b80633c14a2de146107255780633c276d86146107385780633ccfd60b1461074e5780633db82fb51461076357600080fd5b80631c67b82411610417578063248a9ca3116103e6578063318bfd4e116103cb578063318bfd4e146106cf5780633549345e146106e557806336568abe1461070557600080fd5b8063248a9ca31461067f5780632f2ff15d146106af57600080fd5b80631c67b824146105ff5780631d2e5a3a1461061f5780631fbb4e271461063f57806323b872dd1461065f57600080fd5b8063095ea7b31161046e5780630f23f707116104535780630f23f7071461059f578063104aeef8146105cc57806318160ddd146105e257600080fd5b8063095ea7b31461055d5780630ce3c1b41461057f57600080fd5b80620e7fa8146104aa57806301ffc9a7146104d357806306fdde0314610503578063081812fc1461052557600080fd5b366104a557005b600080fd5b3480156104b657600080fd5b506104c060155481565b6040519081526020015b60405180910390f35b3480156104df57600080fd5b506104f36104ee36600461377d565b610dc1565b60405190151581526020016104ca565b34801561050f57600080fd5b50610518610e92565b6040516104ca91906137f2565b34801561053157600080fd5b50610545610540366004613805565b610f24565b6040516001600160a01b0390911681526020016104ca565b34801561056957600080fd5b5061057d610578366004613833565b610f81565b005b34801561058b57600080fd5b5061057d61059a36600461386d565b611047565b3480156105ab57600080fd5b506104c06105ba366004613805565b60216020526000908152604090205481565b3480156105d857600080fd5b506104c0600b5481565b3480156105ee57600080fd5b5060015460005403600019016104c0565b34801561060b57600080fd5b5061057d61061a366004613805565b6110b1565b34801561062b57600080fd5b5061057d61063a36600461386d565b611108565b34801561064b57600080fd5b5061057d61065a366004613805565b61116d565b34801561066b57600080fd5b5061057d61067a36600461388a565b6111c4565b34801561068b57600080fd5b506104c061069a366004613805565b60009081526008602052604090206001015490565b3480156106bb57600080fd5b5061057d6106ca3660046138cb565b6113a1565b3480156106db57600080fd5b506104c0600e5481565b3480156106f157600080fd5b5061057d610700366004613805565b6113cc565b34801561071157600080fd5b5061057d6107203660046138cb565b611423565b61057d6107333660046138fb565b6114af565b34801561074457600080fd5b506104c060175481565b34801561075a57600080fd5b5061057d611790565b34801561076f57600080fd5b5061057d61077e366004613805565b61182b565b34801561078f57600080fd5b5061057d61079e36600461388a565b61188f565b3480156107af57600080fd5b5061057d6107be366004613980565b6118aa565b3480156107cf57600080fd5b5061057d6107de366004613833565b611a75565b3480156107ef57600080fd5b5061057d6107fe3660046139a2565b611bbe565b34801561080f57600080fd5b506104c0600c5481565b34801561082557600080fd5b50610518611d22565b34801561083a57600080fd5b506104c060125481565b34801561085057600080fd5b506016546104f39060ff1681565b34801561086a57600080fd5b5061057d610879366004613805565b611db0565b34801561088a57600080fd5b506104c0600f5481565b3480156108a057600080fd5b506104c0601a5481565b3480156108b657600080fd5b506105456108c5366004613805565b611e14565b3480156108d657600080fd5b506019546104f39060ff1681565b3480156108f057600080fd5b506104c06108ff3660046139a2565b60106020526000908152604090205481565b34801561091d57600080fd5b5061057d61092c3660046139bf565b611e1f565b34801561093d57600080fd5b506104c061094c3660046139a2565b611ede565b34801561095d57600080fd5b5061057d611f46565b34801561097257600080fd5b5061057d610981366004613805565b611faa565b34801561099257600080fd5b506104c0600080516020613ed783398151915281565b3480156109b457600080fd5b506104c06109c3366004613805565b601f6020526000908152604090205481565b3480156109e157600080fd5b5061057d6109f0366004613980565b612053565b348015610a0157600080fd5b50600a546001600160a01b0316610545565b348015610a1f57600080fd5b5061057d610a2e366004613805565b6120b7565b348015610a3f57600080fd5b506104f3610a4e3660046138cb565b60009182526008602090815260408084206001600160a01b0393909316845291905290205460ff1690565b348015610a8557600080fd5b5061057d610a943660046138fb565b61210e565b348015610aa557600080fd5b5061057d610ab4366004613980565b612337565b348015610ac557600080fd5b506105186123b9565b348015610ada57600080fd5b50600d546104f39060ff1681565b348015610af457600080fd5b506104c0610b03366004613805565b60226020526000908152604090205481565b348015610b2157600080fd5b506104f3610b30366004613805565b602080526000908152604090205460ff1681565b61057d610b52366004613805565b6123c8565b348015610b6357600080fd5b506104c0600081565b348015610b7857600080fd5b5061057d610b87366004613a44565b612617565b348015610b9857600080fd5b506104c0601b5481565b348015610bae57600080fd5b506011546104f39060ff1681565b348015610bc857600080fd5b5061057d610bd7366004613a88565b6126c6565b348015610be857600080fd5b5061057d610bf736600461386d565b61270a565b348015610c0857600080fd5b5061057d610c1736600461386d565b61276f565b348015610c2857600080fd5b50610518610c37366004613805565b6127d4565b348015610c4857600080fd5b5061057d610c57366004613805565b6128f9565b348015610c6857600080fd5b5061057d610c773660046138cb565b6129c5565b348015610c8857600080fd5b506104c0611e6181565b348015610c9e57600080fd5b5061057d610cad366004613805565b6129eb565b348015610cbe57600080fd5b5061057d610ccd366004613805565b612a42565b348015610cde57600080fd5b506104c0610ced366004613805565b601e6020526000908152604090205481565b348015610d0b57600080fd5b506104f3610d1a366004613b68565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b348015610d5457600080fd5b506104c060135481565b348015610d6a57600080fd5b5061057d610d793660046139a2565b612aa6565b348015610d8a57600080fd5b506104c060185481565b348015610da057600080fd5b506104c0610daf3660046139a2565b60146020526000908152604090205481565b60006001600160e01b031982167f7965db0b000000000000000000000000000000000000000000000000000000001480610e2457507f01ffc9a7000000000000000000000000000000000000000000000000000000006001600160e01b03198316145b80610e5857507f80ac58cd000000000000000000000000000000000000000000000000000000006001600160e01b03198316145b80610e8c57507f5b5e139f000000000000000000000000000000000000000000000000000000006001600160e01b03198316145b92915050565b606060028054610ea190613b96565b80601f0160208091040260200160405190810160405280929190818152602001828054610ecd90613b96565b8015610f1a5780601f10610eef57610100808354040283529160200191610f1a565b820191906000526020600020905b815481529060010190602001808311610efd57829003601f168201915b5050505050905090565b6000610f2f82612b88565b610f65576040517fcf4700e400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b506000908152600660205260409020546001600160a01b031690565b6000610f8c82611e14565b9050336001600160a01b03821614610fde57610fa88133610d1a565b610fde576040517fcfb3b94200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600082815260066020526040808220805473ffffffffffffffffffffffffffffffffffffffff19166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b61105f600080516020613ed783398151915233610a4e565b61109e5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb783398151915260448201526064015b60405180910390fd5b6011805460ff1916911515919091179055565b6110c9600080516020613ed783398151915233610a4e565b6111035760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601b55565b611120600080516020613ed783398151915233610a4e565b61115a5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6019805460ff1916911515919091179055565b611185600080516020613ed783398151915233610a4e565b6111bf5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b600f55565b60006111cf82612bbd565b9050836001600160a01b0316816001600160a01b03161461121c576040517fa114810000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008281526006602052604090208054338082146001600160a01b038816909114176112825761124c8633610d1a565b611282576040517f59c896be00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0385166112c2576040517fea553b3400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b80156112cd57600082555b6001600160a01b038681166000908152600560205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260046020526040902055600160e11b831661135857600184016000818152600460205260409020546113565760005481146113565760008181526004602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4505050505050565b6000828152600860205260409020600101546113bd8133612c46565b6113c78383612cc6565b505050565b6113e4600080516020613ed783398151915233610a4e565b61141e5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601555565b6001600160a01b03811633146114a15760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201527f20726f6c657320666f722073656c6600000000000000000000000000000000006064820152608401611095565b6114ab8282612d68565b5050565b60165460ff166115015760405162461bcd60e51b815260206004820152601260248201527f50524553414c45204e4f542041435449564500000000000000000000000000006044820152606401611095565b6012544210156115535760405162461bcd60e51b815260206004820152601260248201527f50524553414c45204e4f542041435449564500000000000000000000000000006044820152606401611095565b6013546040516bffffffffffffffffffffffff193360601b166020820152603481018690526115d491906054015b60405160208183030381529060405280519060200120858580806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250929493925050612deb9050565b6116205760405162461bcd60e51b815260206004820152601060248201527f4e4f54204f4e20414c4c4f574c495354000000000000000000000000000000006044820152606401611095565b33600090815260146020526040902054849061163d908390613be7565b111561168b5760405162461bcd60e51b815260206004820152601960248201527f4d494e54494e47204d4f5245205448414e20414c4c4f574544000000000000006044820152606401611095565b346015548261169a9190613bff565b11156116e85760405162461bcd60e51b815260206004820152601860248201527f494e434f5252454354205041594d454e5420414d4f554e5400000000000000006044820152606401611095565b60006116fd6001546000546000199190030190565b600b5490915061170d8284613be7565b111561175b5760405162461bcd60e51b815260206004820152601860248201527f4e4f5420454e4f554748204c45465420494e2053544f434b00000000000000006044820152606401611095565b6117653383612e9a565b3360009081526014602052604081208054849290611784908490613be7565b90915550505050505050565b6117a8600080516020613ed783398151915233610a4e565b6117e25760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b60265461180e906001600160a01b0316600a6117ff476002613bff565b6118099190613c34565b612faa565b6025546118299061010090046001600160a01b031647612faa565b565b611843600080516020613ed783398151915233610a4e565b61187d5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6000811161188a57600080fd5b601755565b6113c7838383604051806020016040528060008152506126c6565b6118c2600080516020613ed783398151915233610a4e565b6118fc5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601d546040516370a0823160e01b81523060048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561195e57600080fd5b505afa158015611972573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119969190613c48565b10156119e45760405162461bcd60e51b815260206004820152601a60248201527f4e6f7420656e6f756768204c494e4b20746f20706179206665650000000000006044820152606401611095565b600082815260208052604090205460ff1615611a425760405162461bcd60e51b815260206004820152601f60248201527f416c72656164792067656e6572617465642072616e646f6d206f6666736574006044820152606401611095565b6000611a52601c54601d546130c3565b600090815260226020908152604080832086905594825260219052929092205550565b611a8d600080516020613ed783398151915233610a4e565b611ac75760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6000611adc6001546000546000199190030190565b9050601b54601a5483611aef9190613be7565b1115611b3d5760405162461bcd60e51b815260206004820152601960248201527f4d494e54494e47204d4f5245205448414e20414c4c4f574544000000000000006044820152606401611095565b611e61611b4a8284613be7565b1115611b985760405162461bcd60e51b815260206004820152601860248201527f4e4f5420454e4f554748204c45465420494e2053544f434b00000000000000006044820152606401611095565b611ba28383612e9a565b81601a6000828254611bb49190613be7565b9091555050505050565b611bd6600080516020613ed783398151915233610a4e565b611c105760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6001600160a01b038116611c2357600080fd5b6040516370a0823160e01b81523060048201526001600160a01b0382169063a9059cbb90339083906370a082319060240160206040518083038186803b158015611c6c57600080fd5b505afa158015611c80573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611ca49190613c48565b6040516001600160e01b031960e085901b1681526001600160a01b0390921660048301526024820152604401602060405180830381600087803b158015611cea57600080fd5b505af1158015611cfe573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906114ab9190613c61565b60238054611d2f90613b96565b80601f0160208091040260200160405190810160405280929190818152602001828054611d5b90613b96565b8015611da85780601f10611d7d57610100808354040283529160200191611da8565b820191906000526020600020905b815481529060010190602001808311611d8b57829003601f168201915b505050505081565b611dc8600080516020613ed783398151915233610a4e565b611e025760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b60008111611e0f57600080fd5b600e55565b6000610e8c82612bbd565b611e37600080516020613ed783398151915233610a4e565b611e715760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b80611ebe5760405162461bcd60e51b815260206004820152601660248201527f5f746f6b656e4261736555524920697320656d707479000000000000000000006044820152606401611095565b6025805460ff1916841515179055611ed8602383836136ce565b50505050565b60006001600160a01b038216611f20576040517f8f4eb60400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b506001600160a01b031660009081526005602052604090205467ffffffffffffffff1690565b600a546001600160a01b03163314611fa05760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401611095565b6118296000613256565b611fc2600080516020613ed783398151915233610a4e565b611ffc5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b611e6181111561204e5760405162461bcd60e51b815260206004820152601960248201527f52455155455354454420535550504c5920544f4f2048494748000000000000006044820152606401611095565b600b55565b61206b600080516020613ed783398151915233610a4e565b6120a55760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6000918252601e602052604090912055565b6120cf600080516020613ed783398151915233610a4e565b6121095760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601855565b60115460ff166121605760405162461bcd60e51b815260206004820152601460248201527f46524545204d494e54204e4f54204143544956450000000000000000000000006044820152606401611095565b600e544210156121b25760405162461bcd60e51b815260206004820152601460248201527f46524545204d494e54204e4f54204143544956450000000000000000000000006044820152606401611095565b600f546040516bffffffffffffffffffffffff193360601b166020820152603481018690526121e49190605401611581565b6122305760405162461bcd60e51b815260206004820152601a60248201527f4e4f54204f4e2046524545204d494e5420414c4c4f574c4953540000000000006044820152606401611095565b33600090815260106020526040902054849061224d908390613be7565b111561229b5760405162461bcd60e51b815260206004820152601960248201527f4d494e54494e47204d4f5245205448414e20414c4c4f574544000000000000006044820152606401611095565b60006122b06001546000546000199190030190565b600b549091506122c08284613be7565b111561230e5760405162461bcd60e51b815260206004820152601860248201527f4e4f5420454e4f554748204c45465420494e2053544f434b00000000000000006044820152606401611095565b6123183383612e9a565b3360009081526010602052604081208054849290611784908490613be7565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146123af5760405162461bcd60e51b815260206004820152601f60248201527f4f6e6c7920565246436f6f7264696e61746f722063616e2066756c66696c6c006044820152606401611095565b6114ab82826132b5565b606060038054610ea190613b96565b600d5460ff16612421573332146124215760405162461bcd60e51b815260206004820152601c60248201527f434f4e5452414354204e4f5420414c4c4f57454420544f204d494e54000000006044820152606401611095565b60195460ff166124735760405162461bcd60e51b815260206004820152600f60248201527f53414c45204e4f542041435449564500000000000000000000000000000000006044820152606401611095565b6017544210156124c55760405162461bcd60e51b815260206004820152600f60248201527f53414c45204e4f542041435449564500000000000000000000000000000000006044820152606401611095565b600c5481111561253d5760405162461bcd60e51b815260206004820152603160248201527f4d494e54494e47204d4f5245205448414e20414c4c4f57454420494e2041205360448201527f494e474c45205452414e53414354494f4e0000000000000000000000000000006064820152608401611095565b346018548261254c9190613bff565b111561259a5760405162461bcd60e51b815260206004820152601860248201527f494e434f5252454354205041594d454e5420414d4f554e5400000000000000006044820152606401611095565b60006125af6001546000546000199190030190565b600b549091506125bf8284613be7565b111561260d5760405162461bcd60e51b815260206004820152601860248201527f4e4f5420454e4f554748204c45465420494e2053544f434b00000000000000006044820152606401611095565b6114ab3383612e9a565b6001600160a01b03821633141561265a576040517fb06307db00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b3360008181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b6126d18484846111c4565b6001600160a01b0383163b15611ed8576126ed84848484613314565b611ed8576040516368d2bf6b60e11b815260040160405180910390fd5b612722600080516020613ed783398151915233610a4e565b61275c5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6016805460ff1916911515919091179055565b612787600080516020613ed783398151915233610a4e565b6127c15760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b600d805460ff1916911515919091179055565b60606127df82612b88565b61282b5760405162461bcd60e51b815260206004820152601f60248201527f55524920717565727920666f72206e6f6e6578697374656e7420746f6b656e006044820152606401611095565b60255460ff166128c7576024805461284290613b96565b80601f016020809104026020016040519081016040528092919081815260200182805461286e90613b96565b80156128bb5780601f10612890576101008083540402835291602001916128bb565b820191906000526020600020905b81548152906001019060200180831161289e57829003601f168201915b50505050509050919050565b60236128d28361340b565b6040516020016128e3929190613c9a565b6040516020818303038152906040529050919050565b612911600080516020613ed783398151915233610a4e565b61294b5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b600081116129c05760405162461bcd60e51b8152602060048201526024808201527f6d61785065725472616e73616374696f6e2073686f756c6420626520706f736960448201527f74697665000000000000000000000000000000000000000000000000000000006064820152608401611095565b600c55565b6000828152600860205260409020600101546129e18133612c46565b6113c78383612d68565b612a03600080516020613ed783398151915233610a4e565b612a3d5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601355565b612a5a600080516020613ed783398151915233610a4e565b612a945760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b60008111612aa157600080fd5b601255565b600a546001600160a01b03163314612b005760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401611095565b6001600160a01b038116612b7c5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201527f64647265737300000000000000000000000000000000000000000000000000006064820152608401611095565b612b8581613256565b50565b600081600111158015612b9c575060005482105b8015610e8c575050600090815260046020526040902054600160e01b161590565b60008180600111612c1457600054811015612c1457600081815260046020526040902054600160e01b8116612c12575b80612c0b575060001901600081815260046020526040902054612bed565b9392505050565b505b6040517fdf2d9b4200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008281526008602090815260408083206001600160a01b038516845290915290205460ff166114ab57612c84816001600160a01b03166014613509565b612c8f836020613509565b604051602001612ca0929190613d41565b60408051601f198184030181529082905262461bcd60e51b8252611095916004016137f2565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff166114ab5760008281526008602090815260408083206001600160a01b03851684529091529020805460ff19166001179055612d243390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff16156114ab5760008281526008602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b600081815b8551811015612e8f576000868281518110612e0d57612e0d613dc2565b60200260200101519050808311612e4f576040805160208101859052908101829052606001604051602081830303815290604052805190602001209250612e7c565b60408051602081018390529081018490526060016040516020818303038152906040528051906020012092505b5080612e8781613dd8565b915050612df0565b509092149392505050565b6000546001600160a01b038316612edd576040517f2e07630000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b81612f14576040517fb562e8dd00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b038316600081815260056020526040902080546801000000000000000185020190554260a01b6001841460e11b1717600082815260046020526040902055808281015b6040516001830192906001600160a01b038716906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a4808210612f5e5760005550505050565b80471015612ffa5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e63650000006044820152606401611095565b6000826001600160a01b03168260405160006040518083038185875af1925050503d8060008114613047576040519150601f19603f3d011682016040523d82523d6000602084013e61304c565b606091505b50509050806113c75760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d617920686176652072657665727465640000000000006064820152608401611095565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316634000aea07f000000000000000000000000000000000000000000000000000000000000000084866000604051602001613133929190918252602082015260400190565b6040516020818303038152906040526040518463ffffffff1660e01b815260040161316093929190613df3565b602060405180830381600087803b15801561317a57600080fd5b505af115801561318e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906131b29190613c61565b50600083815260096020818152604080842054815180840189905280830186905230606082015260808082018390528351808303909101815260a09091019092528151918301919091209387905291905261320e906001613be7565b60008581526009602052604090205561324e8482604080516020808201949094528082019290925280518083038201815260609092019052805191012090565b949350505050565b600a80546001600160a01b0383811673ffffffffffffffffffffffffffffffffffffffff19831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60008281526022602090815260408083205480845260219092528220549091906132df9084613e1b565b6132ea906001613be7565b6000928352601f60209081526040808520929092558052909120805460ff19166001179055505050565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a0290613349903390899088908890600401613e2f565b602060405180830381600087803b15801561336357600080fd5b505af1925050508015613393575060408051601f3d908101601f1916820190925261339091810190613e6b565b60015b6133ee573d8080156133c1576040519150601f19603f3d011682016040523d82523d6000602084013e6133c6565b606091505b5080516133e6576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050949350505050565b60608161342f5750506040805180820190915260018152600360fc1b602082015290565b8160005b8115613459578061344381613dd8565b91506134529050600a83613c34565b9150613433565b60008167ffffffffffffffff81111561347457613474613a72565b6040519080825280601f01601f19166020018201604052801561349e576020820181803683370190505b5090505b841561324e576134b3600183613e88565b91506134c0600a86613e1b565b6134cb906030613be7565b60f81b8183815181106134e0576134e0613dc2565b60200101906001600160f81b031916908160001a905350613502600a86613c34565b94506134a2565b60606000613518836002613bff565b613523906002613be7565b67ffffffffffffffff81111561353b5761353b613a72565b6040519080825280601f01601f191660200182016040528015613565576020820181803683370190505b509050600360fc1b8160008151811061358057613580613dc2565b60200101906001600160f81b031916908160001a9053507f7800000000000000000000000000000000000000000000000000000000000000816001815181106135cb576135cb613dc2565b60200101906001600160f81b031916908160001a90535060006135ef846002613bff565b6135fa906001613be7565b90505b600181111561367f577f303132333435363738396162636465660000000000000000000000000000000085600f166010811061363b5761363b613dc2565b1a60f81b82828151811061365157613651613dc2565b60200101906001600160f81b031916908160001a90535060049490941c9361367881613e9f565b90506135fd565b508315612c0b5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401611095565b8280546136da90613b96565b90600052602060002090601f0160209004810192826136fc5760008555613742565b82601f106137155782800160ff19823516178555613742565b82800160010185558215613742579182015b82811115613742578235825591602001919060010190613727565b5061374e929150613752565b5090565b5b8082111561374e5760008155600101613753565b6001600160e01b031981168114612b8557600080fd5b60006020828403121561378f57600080fd5b8135612c0b81613767565b60005b838110156137b557818101518382015260200161379d565b83811115611ed85750506000910152565b600081518084526137de81602086016020860161379a565b601f01601f19169290920160200192915050565b602081526000612c0b60208301846137c6565b60006020828403121561381757600080fd5b5035919050565b6001600160a01b0381168114612b8557600080fd5b6000806040838503121561384657600080fd5b82356138518161381e565b946020939093013593505050565b8015158114612b8557600080fd5b60006020828403121561387f57600080fd5b8135612c0b8161385f565b60008060006060848603121561389f57600080fd5b83356138aa8161381e565b925060208401356138ba8161381e565b929592945050506040919091013590565b600080604083850312156138de57600080fd5b8235915060208301356138f08161381e565b809150509250929050565b6000806000806060858703121561391157600080fd5b84359350602085013567ffffffffffffffff8082111561393057600080fd5b818701915087601f83011261394457600080fd5b81358181111561395357600080fd5b8860208260051b850101111561396857600080fd5b95986020929092019750949560400135945092505050565b6000806040838503121561399357600080fd5b50508035926020909101359150565b6000602082840312156139b457600080fd5b8135612c0b8161381e565b6000806000604084860312156139d457600080fd5b83356139df8161385f565b9250602084013567ffffffffffffffff808211156139fc57600080fd5b818601915086601f830112613a1057600080fd5b813581811115613a1f57600080fd5b876020828501011115613a3157600080fd5b6020830194508093505050509250925092565b60008060408385031215613a5757600080fd5b8235613a628161381e565b915060208301356138f08161385f565b634e487b7160e01b600052604160045260246000fd5b60008060008060808587031215613a9e57600080fd5b8435613aa98161381e565b93506020850135613ab98161381e565b925060408501359150606085013567ffffffffffffffff80821115613add57600080fd5b818701915087601f830112613af157600080fd5b813581811115613b0357613b03613a72565b604051601f8201601f19908116603f01168101908382118183101715613b2b57613b2b613a72565b816040528281528a6020848701011115613b4457600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b60008060408385031215613b7b57600080fd5b8235613b868161381e565b915060208301356138f08161381e565b600181811c90821680613baa57607f821691505b60208210811415613bcb57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b60008219821115613bfa57613bfa613bd1565b500190565b6000816000190483118215151615613c1957613c19613bd1565b500290565b634e487b7160e01b600052601260045260246000fd5b600082613c4357613c43613c1e565b500490565b600060208284031215613c5a57600080fd5b5051919050565b600060208284031215613c7357600080fd5b8151612c0b8161385f565b60008151613c9081856020860161379a565b9290920192915050565b600080845481600182811c915080831680613cb657607f831692505b6020808410821415613cd657634e487b7160e01b86526022600452602486fd5b818015613cea5760018114613cfb57613d28565b60ff19861689528489019650613d28565b60008b81526020902060005b86811015613d205781548b820152908501908301613d07565b505084890196505b505050505050613d388185613c7e565b95945050505050565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613d7981601785016020880161379a565b7f206973206d697373696e6720726f6c65200000000000000000000000000000006017918401918201528351613db681602884016020880161379a565b01602801949350505050565b634e487b7160e01b600052603260045260246000fd5b6000600019821415613dec57613dec613bd1565b5060010190565b6001600160a01b0384168152826020820152606060408201526000613d3860608301846137c6565b600082613e2a57613e2a613c1e565b500690565b60006001600160a01b03808716835280861660208401525083604083015260806060830152613e6160808301846137c6565b9695505050505050565b600060208284031215613e7d57600080fd5b8151612c0b81613767565b600082821015613e9a57613e9a613bd1565b500390565b600081613eae57613eae613bd1565b50600019019056fe43616c6c6572206973206e6f7420616e2061646d696e00000000000000000000a49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c21775a26469706673582212209326d188c3f931a3357a31b7f24c3abd52de18cc4124f63752f407a217eeb1b964736f6c63430008090033d14dcfb13338ffa6dd9df2d7471ba5b61ee29206406d1b80fd01e2e1aa358291d14dcfb13338ffa6dd9df2d7471ba5b61ee29206406d1b80fd01e2e1aa3582910000000000000000000000000000000000000000000000000000000000000120000000000000000000000000f0d54349addcf704f77ae15b96510dea15cb7952000000000000000000000000514910771af9ca656af840dff83e8264ecf986caaa77729d3466ca35ae8d28b3bbac7cc36a5031efdc430821c02bc31a238af4450000000000000000000000000000000000000000000000001bc16d674ec800000000000000000000000000009484dc6cdebfed3fd91f6257575699e99710f2950000000000000000000000003ca8d9fcbb5e59debc7b81cce289e008bbbe2e0b000000000000000000000000000000000000000000000000000000000000006968747470733a2f2f73746f726167656170692e666c65656b2e636f2f39643662356263632d633236392d346135382d396436652d6165643563313861663630662d6275636b65742f70726572657665616c2d6d657461646174612f70726572657665616c2e6a736f6e0000000000000000000000000000000000000000000000
Deployed Bytecode
0x60806040526004361061049e5760003560e01c80636f8d93051161025e578063a22cb46511610143578063d5abeb01116100bb578063e985e9c51161008a578063f2fde38b1161006f578063f2fde38b14610d5e578063f51f96dd14610d7e578063ff50188514610d9457600080fd5b8063e985e9c514610cff578063ebf0c71714610d4857600080fd5b8063d5abeb0114610c7c578063dab5f34014610c92578063e3bc776214610cb2578063e5c2b7d114610cd257600080fd5b8063c54e73e311610112578063c87b56dd116100f7578063c87b56dd14610c1c578063ccfdd2f814610c3c578063d547741f14610c5c57600080fd5b8063c54e73e314610bdc578063c56c0b9214610bfc57600080fd5b8063a22cb46514610b6c578063a22d363d14610b8c578063b7612afe14610ba2578063b88d4fde14610bbc57600080fd5b806391d14854116101d657806398029d2a116101a55780639b2a96d21161018a5780639b2a96d214610b15578063a0712d6814610b44578063a217fddf14610b5757600080fd5b806398029d2a14610ace5780639aecf1f014610ae857600080fd5b806391d1485414610a3357806392c46da314610a7957806394985ddd14610a9957806395d89b4114610ab957600080fd5b806375b238fc1161022d5780638469775d116102125780638469775d146109d55780638da5cb5b146109f557806391b7f5ed14610a1357600080fd5b806375b238fc1461098657806381914619146109a857600080fd5b80636f8d93051461091157806370a0823114610931578063715018a614610951578063730220111461096657600080fd5b80633c14a2de116103845780634e99b800116102fc5780635fc9c0e6116102cb5780636352211e116102b05780636352211e146108aa57806368428a1b146108ca5780636d41d4fb146108e457600080fd5b80635fc9c0e61461087e5780636327c7741461089457600080fd5b80634e99b800146108195780634ea37fec1461082e57806353135ca01461084457806356ec0e7b1461085e57600080fd5b806342842e0e11610353578063484b973c11610338578063484b973c146107c357806349df728c146107e35780634b980d671461080357600080fd5b806342842e0e1461078357806345a6480a146107a357600080fd5b80633c14a2de146107255780633c276d86146107385780633ccfd60b1461074e5780633db82fb51461076357600080fd5b80631c67b82411610417578063248a9ca3116103e6578063318bfd4e116103cb578063318bfd4e146106cf5780633549345e146106e557806336568abe1461070557600080fd5b8063248a9ca31461067f5780632f2ff15d146106af57600080fd5b80631c67b824146105ff5780631d2e5a3a1461061f5780631fbb4e271461063f57806323b872dd1461065f57600080fd5b8063095ea7b31161046e5780630f23f707116104535780630f23f7071461059f578063104aeef8146105cc57806318160ddd146105e257600080fd5b8063095ea7b31461055d5780630ce3c1b41461057f57600080fd5b80620e7fa8146104aa57806301ffc9a7146104d357806306fdde0314610503578063081812fc1461052557600080fd5b366104a557005b600080fd5b3480156104b657600080fd5b506104c060155481565b6040519081526020015b60405180910390f35b3480156104df57600080fd5b506104f36104ee36600461377d565b610dc1565b60405190151581526020016104ca565b34801561050f57600080fd5b50610518610e92565b6040516104ca91906137f2565b34801561053157600080fd5b50610545610540366004613805565b610f24565b6040516001600160a01b0390911681526020016104ca565b34801561056957600080fd5b5061057d610578366004613833565b610f81565b005b34801561058b57600080fd5b5061057d61059a36600461386d565b611047565b3480156105ab57600080fd5b506104c06105ba366004613805565b60216020526000908152604090205481565b3480156105d857600080fd5b506104c0600b5481565b3480156105ee57600080fd5b5060015460005403600019016104c0565b34801561060b57600080fd5b5061057d61061a366004613805565b6110b1565b34801561062b57600080fd5b5061057d61063a36600461386d565b611108565b34801561064b57600080fd5b5061057d61065a366004613805565b61116d565b34801561066b57600080fd5b5061057d61067a36600461388a565b6111c4565b34801561068b57600080fd5b506104c061069a366004613805565b60009081526008602052604090206001015490565b3480156106bb57600080fd5b5061057d6106ca3660046138cb565b6113a1565b3480156106db57600080fd5b506104c0600e5481565b3480156106f157600080fd5b5061057d610700366004613805565b6113cc565b34801561071157600080fd5b5061057d6107203660046138cb565b611423565b61057d6107333660046138fb565b6114af565b34801561074457600080fd5b506104c060175481565b34801561075a57600080fd5b5061057d611790565b34801561076f57600080fd5b5061057d61077e366004613805565b61182b565b34801561078f57600080fd5b5061057d61079e36600461388a565b61188f565b3480156107af57600080fd5b5061057d6107be366004613980565b6118aa565b3480156107cf57600080fd5b5061057d6107de366004613833565b611a75565b3480156107ef57600080fd5b5061057d6107fe3660046139a2565b611bbe565b34801561080f57600080fd5b506104c0600c5481565b34801561082557600080fd5b50610518611d22565b34801561083a57600080fd5b506104c060125481565b34801561085057600080fd5b506016546104f39060ff1681565b34801561086a57600080fd5b5061057d610879366004613805565b611db0565b34801561088a57600080fd5b506104c0600f5481565b3480156108a057600080fd5b506104c0601a5481565b3480156108b657600080fd5b506105456108c5366004613805565b611e14565b3480156108d657600080fd5b506019546104f39060ff1681565b3480156108f057600080fd5b506104c06108ff3660046139a2565b60106020526000908152604090205481565b34801561091d57600080fd5b5061057d61092c3660046139bf565b611e1f565b34801561093d57600080fd5b506104c061094c3660046139a2565b611ede565b34801561095d57600080fd5b5061057d611f46565b34801561097257600080fd5b5061057d610981366004613805565b611faa565b34801561099257600080fd5b506104c0600080516020613ed783398151915281565b3480156109b457600080fd5b506104c06109c3366004613805565b601f6020526000908152604090205481565b3480156109e157600080fd5b5061057d6109f0366004613980565b612053565b348015610a0157600080fd5b50600a546001600160a01b0316610545565b348015610a1f57600080fd5b5061057d610a2e366004613805565b6120b7565b348015610a3f57600080fd5b506104f3610a4e3660046138cb565b60009182526008602090815260408084206001600160a01b0393909316845291905290205460ff1690565b348015610a8557600080fd5b5061057d610a943660046138fb565b61210e565b348015610aa557600080fd5b5061057d610ab4366004613980565b612337565b348015610ac557600080fd5b506105186123b9565b348015610ada57600080fd5b50600d546104f39060ff1681565b348015610af457600080fd5b506104c0610b03366004613805565b60226020526000908152604090205481565b348015610b2157600080fd5b506104f3610b30366004613805565b602080526000908152604090205460ff1681565b61057d610b52366004613805565b6123c8565b348015610b6357600080fd5b506104c0600081565b348015610b7857600080fd5b5061057d610b87366004613a44565b612617565b348015610b9857600080fd5b506104c0601b5481565b348015610bae57600080fd5b506011546104f39060ff1681565b348015610bc857600080fd5b5061057d610bd7366004613a88565b6126c6565b348015610be857600080fd5b5061057d610bf736600461386d565b61270a565b348015610c0857600080fd5b5061057d610c1736600461386d565b61276f565b348015610c2857600080fd5b50610518610c37366004613805565b6127d4565b348015610c4857600080fd5b5061057d610c57366004613805565b6128f9565b348015610c6857600080fd5b5061057d610c773660046138cb565b6129c5565b348015610c8857600080fd5b506104c0611e6181565b348015610c9e57600080fd5b5061057d610cad366004613805565b6129eb565b348015610cbe57600080fd5b5061057d610ccd366004613805565b612a42565b348015610cde57600080fd5b506104c0610ced366004613805565b601e6020526000908152604090205481565b348015610d0b57600080fd5b506104f3610d1a366004613b68565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b348015610d5457600080fd5b506104c060135481565b348015610d6a57600080fd5b5061057d610d793660046139a2565b612aa6565b348015610d8a57600080fd5b506104c060185481565b348015610da057600080fd5b506104c0610daf3660046139a2565b60146020526000908152604090205481565b60006001600160e01b031982167f7965db0b000000000000000000000000000000000000000000000000000000001480610e2457507f01ffc9a7000000000000000000000000000000000000000000000000000000006001600160e01b03198316145b80610e5857507f80ac58cd000000000000000000000000000000000000000000000000000000006001600160e01b03198316145b80610e8c57507f5b5e139f000000000000000000000000000000000000000000000000000000006001600160e01b03198316145b92915050565b606060028054610ea190613b96565b80601f0160208091040260200160405190810160405280929190818152602001828054610ecd90613b96565b8015610f1a5780601f10610eef57610100808354040283529160200191610f1a565b820191906000526020600020905b815481529060010190602001808311610efd57829003601f168201915b5050505050905090565b6000610f2f82612b88565b610f65576040517fcf4700e400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b506000908152600660205260409020546001600160a01b031690565b6000610f8c82611e14565b9050336001600160a01b03821614610fde57610fa88133610d1a565b610fde576040517fcfb3b94200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600082815260066020526040808220805473ffffffffffffffffffffffffffffffffffffffff19166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b61105f600080516020613ed783398151915233610a4e565b61109e5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb783398151915260448201526064015b60405180910390fd5b6011805460ff1916911515919091179055565b6110c9600080516020613ed783398151915233610a4e565b6111035760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601b55565b611120600080516020613ed783398151915233610a4e565b61115a5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6019805460ff1916911515919091179055565b611185600080516020613ed783398151915233610a4e565b6111bf5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b600f55565b60006111cf82612bbd565b9050836001600160a01b0316816001600160a01b03161461121c576040517fa114810000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008281526006602052604090208054338082146001600160a01b038816909114176112825761124c8633610d1a565b611282576040517f59c896be00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0385166112c2576040517fea553b3400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b80156112cd57600082555b6001600160a01b038681166000908152600560205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260046020526040902055600160e11b831661135857600184016000818152600460205260409020546113565760005481146113565760008181526004602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4505050505050565b6000828152600860205260409020600101546113bd8133612c46565b6113c78383612cc6565b505050565b6113e4600080516020613ed783398151915233610a4e565b61141e5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601555565b6001600160a01b03811633146114a15760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201527f20726f6c657320666f722073656c6600000000000000000000000000000000006064820152608401611095565b6114ab8282612d68565b5050565b60165460ff166115015760405162461bcd60e51b815260206004820152601260248201527f50524553414c45204e4f542041435449564500000000000000000000000000006044820152606401611095565b6012544210156115535760405162461bcd60e51b815260206004820152601260248201527f50524553414c45204e4f542041435449564500000000000000000000000000006044820152606401611095565b6013546040516bffffffffffffffffffffffff193360601b166020820152603481018690526115d491906054015b60405160208183030381529060405280519060200120858580806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250929493925050612deb9050565b6116205760405162461bcd60e51b815260206004820152601060248201527f4e4f54204f4e20414c4c4f574c495354000000000000000000000000000000006044820152606401611095565b33600090815260146020526040902054849061163d908390613be7565b111561168b5760405162461bcd60e51b815260206004820152601960248201527f4d494e54494e47204d4f5245205448414e20414c4c4f574544000000000000006044820152606401611095565b346015548261169a9190613bff565b11156116e85760405162461bcd60e51b815260206004820152601860248201527f494e434f5252454354205041594d454e5420414d4f554e5400000000000000006044820152606401611095565b60006116fd6001546000546000199190030190565b600b5490915061170d8284613be7565b111561175b5760405162461bcd60e51b815260206004820152601860248201527f4e4f5420454e4f554748204c45465420494e2053544f434b00000000000000006044820152606401611095565b6117653383612e9a565b3360009081526014602052604081208054849290611784908490613be7565b90915550505050505050565b6117a8600080516020613ed783398151915233610a4e565b6117e25760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b60265461180e906001600160a01b0316600a6117ff476002613bff565b6118099190613c34565b612faa565b6025546118299061010090046001600160a01b031647612faa565b565b611843600080516020613ed783398151915233610a4e565b61187d5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6000811161188a57600080fd5b601755565b6113c7838383604051806020016040528060008152506126c6565b6118c2600080516020613ed783398151915233610a4e565b6118fc5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601d546040516370a0823160e01b81523060048201527f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca6001600160a01b0316906370a082319060240160206040518083038186803b15801561195e57600080fd5b505afa158015611972573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119969190613c48565b10156119e45760405162461bcd60e51b815260206004820152601a60248201527f4e6f7420656e6f756768204c494e4b20746f20706179206665650000000000006044820152606401611095565b600082815260208052604090205460ff1615611a425760405162461bcd60e51b815260206004820152601f60248201527f416c72656164792067656e6572617465642072616e646f6d206f6666736574006044820152606401611095565b6000611a52601c54601d546130c3565b600090815260226020908152604080832086905594825260219052929092205550565b611a8d600080516020613ed783398151915233610a4e565b611ac75760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6000611adc6001546000546000199190030190565b9050601b54601a5483611aef9190613be7565b1115611b3d5760405162461bcd60e51b815260206004820152601960248201527f4d494e54494e47204d4f5245205448414e20414c4c4f574544000000000000006044820152606401611095565b611e61611b4a8284613be7565b1115611b985760405162461bcd60e51b815260206004820152601860248201527f4e4f5420454e4f554748204c45465420494e2053544f434b00000000000000006044820152606401611095565b611ba28383612e9a565b81601a6000828254611bb49190613be7565b9091555050505050565b611bd6600080516020613ed783398151915233610a4e565b611c105760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6001600160a01b038116611c2357600080fd5b6040516370a0823160e01b81523060048201526001600160a01b0382169063a9059cbb90339083906370a082319060240160206040518083038186803b158015611c6c57600080fd5b505afa158015611c80573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611ca49190613c48565b6040516001600160e01b031960e085901b1681526001600160a01b0390921660048301526024820152604401602060405180830381600087803b158015611cea57600080fd5b505af1158015611cfe573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906114ab9190613c61565b60238054611d2f90613b96565b80601f0160208091040260200160405190810160405280929190818152602001828054611d5b90613b96565b8015611da85780601f10611d7d57610100808354040283529160200191611da8565b820191906000526020600020905b815481529060010190602001808311611d8b57829003601f168201915b505050505081565b611dc8600080516020613ed783398151915233610a4e565b611e025760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b60008111611e0f57600080fd5b600e55565b6000610e8c82612bbd565b611e37600080516020613ed783398151915233610a4e565b611e715760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b80611ebe5760405162461bcd60e51b815260206004820152601660248201527f5f746f6b656e4261736555524920697320656d707479000000000000000000006044820152606401611095565b6025805460ff1916841515179055611ed8602383836136ce565b50505050565b60006001600160a01b038216611f20576040517f8f4eb60400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b506001600160a01b031660009081526005602052604090205467ffffffffffffffff1690565b600a546001600160a01b03163314611fa05760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401611095565b6118296000613256565b611fc2600080516020613ed783398151915233610a4e565b611ffc5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b611e6181111561204e5760405162461bcd60e51b815260206004820152601960248201527f52455155455354454420535550504c5920544f4f2048494748000000000000006044820152606401611095565b600b55565b61206b600080516020613ed783398151915233610a4e565b6120a55760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6000918252601e602052604090912055565b6120cf600080516020613ed783398151915233610a4e565b6121095760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601855565b60115460ff166121605760405162461bcd60e51b815260206004820152601460248201527f46524545204d494e54204e4f54204143544956450000000000000000000000006044820152606401611095565b600e544210156121b25760405162461bcd60e51b815260206004820152601460248201527f46524545204d494e54204e4f54204143544956450000000000000000000000006044820152606401611095565b600f546040516bffffffffffffffffffffffff193360601b166020820152603481018690526121e49190605401611581565b6122305760405162461bcd60e51b815260206004820152601a60248201527f4e4f54204f4e2046524545204d494e5420414c4c4f574c4953540000000000006044820152606401611095565b33600090815260106020526040902054849061224d908390613be7565b111561229b5760405162461bcd60e51b815260206004820152601960248201527f4d494e54494e47204d4f5245205448414e20414c4c4f574544000000000000006044820152606401611095565b60006122b06001546000546000199190030190565b600b549091506122c08284613be7565b111561230e5760405162461bcd60e51b815260206004820152601860248201527f4e4f5420454e4f554748204c45465420494e2053544f434b00000000000000006044820152606401611095565b6123183383612e9a565b3360009081526010602052604081208054849290611784908490613be7565b336001600160a01b037f000000000000000000000000f0d54349addcf704f77ae15b96510dea15cb795216146123af5760405162461bcd60e51b815260206004820152601f60248201527f4f6e6c7920565246436f6f7264696e61746f722063616e2066756c66696c6c006044820152606401611095565b6114ab82826132b5565b606060038054610ea190613b96565b600d5460ff16612421573332146124215760405162461bcd60e51b815260206004820152601c60248201527f434f4e5452414354204e4f5420414c4c4f57454420544f204d494e54000000006044820152606401611095565b60195460ff166124735760405162461bcd60e51b815260206004820152600f60248201527f53414c45204e4f542041435449564500000000000000000000000000000000006044820152606401611095565b6017544210156124c55760405162461bcd60e51b815260206004820152600f60248201527f53414c45204e4f542041435449564500000000000000000000000000000000006044820152606401611095565b600c5481111561253d5760405162461bcd60e51b815260206004820152603160248201527f4d494e54494e47204d4f5245205448414e20414c4c4f57454420494e2041205360448201527f494e474c45205452414e53414354494f4e0000000000000000000000000000006064820152608401611095565b346018548261254c9190613bff565b111561259a5760405162461bcd60e51b815260206004820152601860248201527f494e434f5252454354205041594d454e5420414d4f554e5400000000000000006044820152606401611095565b60006125af6001546000546000199190030190565b600b549091506125bf8284613be7565b111561260d5760405162461bcd60e51b815260206004820152601860248201527f4e4f5420454e4f554748204c45465420494e2053544f434b00000000000000006044820152606401611095565b6114ab3383612e9a565b6001600160a01b03821633141561265a576040517fb06307db00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b3360008181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b6126d18484846111c4565b6001600160a01b0383163b15611ed8576126ed84848484613314565b611ed8576040516368d2bf6b60e11b815260040160405180910390fd5b612722600080516020613ed783398151915233610a4e565b61275c5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b6016805460ff1916911515919091179055565b612787600080516020613ed783398151915233610a4e565b6127c15760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b600d805460ff1916911515919091179055565b60606127df82612b88565b61282b5760405162461bcd60e51b815260206004820152601f60248201527f55524920717565727920666f72206e6f6e6578697374656e7420746f6b656e006044820152606401611095565b60255460ff166128c7576024805461284290613b96565b80601f016020809104026020016040519081016040528092919081815260200182805461286e90613b96565b80156128bb5780601f10612890576101008083540402835291602001916128bb565b820191906000526020600020905b81548152906001019060200180831161289e57829003601f168201915b50505050509050919050565b60236128d28361340b565b6040516020016128e3929190613c9a565b6040516020818303038152906040529050919050565b612911600080516020613ed783398151915233610a4e565b61294b5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b600081116129c05760405162461bcd60e51b8152602060048201526024808201527f6d61785065725472616e73616374696f6e2073686f756c6420626520706f736960448201527f74697665000000000000000000000000000000000000000000000000000000006064820152608401611095565b600c55565b6000828152600860205260409020600101546129e18133612c46565b6113c78383612d68565b612a03600080516020613ed783398151915233610a4e565b612a3d5760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b601355565b612a5a600080516020613ed783398151915233610a4e565b612a945760405162461bcd60e51b81526020600482015260166024820152600080516020613eb78339815191526044820152606401611095565b60008111612aa157600080fd5b601255565b600a546001600160a01b03163314612b005760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401611095565b6001600160a01b038116612b7c5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201527f64647265737300000000000000000000000000000000000000000000000000006064820152608401611095565b612b8581613256565b50565b600081600111158015612b9c575060005482105b8015610e8c575050600090815260046020526040902054600160e01b161590565b60008180600111612c1457600054811015612c1457600081815260046020526040902054600160e01b8116612c12575b80612c0b575060001901600081815260046020526040902054612bed565b9392505050565b505b6040517fdf2d9b4200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008281526008602090815260408083206001600160a01b038516845290915290205460ff166114ab57612c84816001600160a01b03166014613509565b612c8f836020613509565b604051602001612ca0929190613d41565b60408051601f198184030181529082905262461bcd60e51b8252611095916004016137f2565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff166114ab5760008281526008602090815260408083206001600160a01b03851684529091529020805460ff19166001179055612d243390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b60008281526008602090815260408083206001600160a01b038516845290915290205460ff16156114ab5760008281526008602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b600081815b8551811015612e8f576000868281518110612e0d57612e0d613dc2565b60200260200101519050808311612e4f576040805160208101859052908101829052606001604051602081830303815290604052805190602001209250612e7c565b60408051602081018390529081018490526060016040516020818303038152906040528051906020012092505b5080612e8781613dd8565b915050612df0565b509092149392505050565b6000546001600160a01b038316612edd576040517f2e07630000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b81612f14576040517fb562e8dd00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b038316600081815260056020526040902080546801000000000000000185020190554260a01b6001841460e11b1717600082815260046020526040902055808281015b6040516001830192906001600160a01b038716906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a4808210612f5e5760005550505050565b80471015612ffa5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e63650000006044820152606401611095565b6000826001600160a01b03168260405160006040518083038185875af1925050503d8060008114613047576040519150601f19603f3d011682016040523d82523d6000602084013e61304c565b606091505b50509050806113c75760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d617920686176652072657665727465640000000000006064820152608401611095565b60007f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca6001600160a01b0316634000aea07f000000000000000000000000f0d54349addcf704f77ae15b96510dea15cb795284866000604051602001613133929190918252602082015260400190565b6040516020818303038152906040526040518463ffffffff1660e01b815260040161316093929190613df3565b602060405180830381600087803b15801561317a57600080fd5b505af115801561318e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906131b29190613c61565b50600083815260096020818152604080842054815180840189905280830186905230606082015260808082018390528351808303909101815260a09091019092528151918301919091209387905291905261320e906001613be7565b60008581526009602052604090205561324e8482604080516020808201949094528082019290925280518083038201815260609092019052805191012090565b949350505050565b600a80546001600160a01b0383811673ffffffffffffffffffffffffffffffffffffffff19831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60008281526022602090815260408083205480845260219092528220549091906132df9084613e1b565b6132ea906001613be7565b6000928352601f60209081526040808520929092558052909120805460ff19166001179055505050565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a0290613349903390899088908890600401613e2f565b602060405180830381600087803b15801561336357600080fd5b505af1925050508015613393575060408051601f3d908101601f1916820190925261339091810190613e6b565b60015b6133ee573d8080156133c1576040519150601f19603f3d011682016040523d82523d6000602084013e6133c6565b606091505b5080516133e6576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050949350505050565b60608161342f5750506040805180820190915260018152600360fc1b602082015290565b8160005b8115613459578061344381613dd8565b91506134529050600a83613c34565b9150613433565b60008167ffffffffffffffff81111561347457613474613a72565b6040519080825280601f01601f19166020018201604052801561349e576020820181803683370190505b5090505b841561324e576134b3600183613e88565b91506134c0600a86613e1b565b6134cb906030613be7565b60f81b8183815181106134e0576134e0613dc2565b60200101906001600160f81b031916908160001a905350613502600a86613c34565b94506134a2565b60606000613518836002613bff565b613523906002613be7565b67ffffffffffffffff81111561353b5761353b613a72565b6040519080825280601f01601f191660200182016040528015613565576020820181803683370190505b509050600360fc1b8160008151811061358057613580613dc2565b60200101906001600160f81b031916908160001a9053507f7800000000000000000000000000000000000000000000000000000000000000816001815181106135cb576135cb613dc2565b60200101906001600160f81b031916908160001a90535060006135ef846002613bff565b6135fa906001613be7565b90505b600181111561367f577f303132333435363738396162636465660000000000000000000000000000000085600f166010811061363b5761363b613dc2565b1a60f81b82828151811061365157613651613dc2565b60200101906001600160f81b031916908160001a90535060049490941c9361367881613e9f565b90506135fd565b508315612c0b5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401611095565b8280546136da90613b96565b90600052602060002090601f0160209004810192826136fc5760008555613742565b82601f106137155782800160ff19823516178555613742565b82800160010185558215613742579182015b82811115613742578235825591602001919060010190613727565b5061374e929150613752565b5090565b5b8082111561374e5760008155600101613753565b6001600160e01b031981168114612b8557600080fd5b60006020828403121561378f57600080fd5b8135612c0b81613767565b60005b838110156137b557818101518382015260200161379d565b83811115611ed85750506000910152565b600081518084526137de81602086016020860161379a565b601f01601f19169290920160200192915050565b602081526000612c0b60208301846137c6565b60006020828403121561381757600080fd5b5035919050565b6001600160a01b0381168114612b8557600080fd5b6000806040838503121561384657600080fd5b82356138518161381e565b946020939093013593505050565b8015158114612b8557600080fd5b60006020828403121561387f57600080fd5b8135612c0b8161385f565b60008060006060848603121561389f57600080fd5b83356138aa8161381e565b925060208401356138ba8161381e565b929592945050506040919091013590565b600080604083850312156138de57600080fd5b8235915060208301356138f08161381e565b809150509250929050565b6000806000806060858703121561391157600080fd5b84359350602085013567ffffffffffffffff8082111561393057600080fd5b818701915087601f83011261394457600080fd5b81358181111561395357600080fd5b8860208260051b850101111561396857600080fd5b95986020929092019750949560400135945092505050565b6000806040838503121561399357600080fd5b50508035926020909101359150565b6000602082840312156139b457600080fd5b8135612c0b8161381e565b6000806000604084860312156139d457600080fd5b83356139df8161385f565b9250602084013567ffffffffffffffff808211156139fc57600080fd5b818601915086601f830112613a1057600080fd5b813581811115613a1f57600080fd5b876020828501011115613a3157600080fd5b6020830194508093505050509250925092565b60008060408385031215613a5757600080fd5b8235613a628161381e565b915060208301356138f08161385f565b634e487b7160e01b600052604160045260246000fd5b60008060008060808587031215613a9e57600080fd5b8435613aa98161381e565b93506020850135613ab98161381e565b925060408501359150606085013567ffffffffffffffff80821115613add57600080fd5b818701915087601f830112613af157600080fd5b813581811115613b0357613b03613a72565b604051601f8201601f19908116603f01168101908382118183101715613b2b57613b2b613a72565b816040528281528a6020848701011115613b4457600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b60008060408385031215613b7b57600080fd5b8235613b868161381e565b915060208301356138f08161381e565b600181811c90821680613baa57607f821691505b60208210811415613bcb57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b60008219821115613bfa57613bfa613bd1565b500190565b6000816000190483118215151615613c1957613c19613bd1565b500290565b634e487b7160e01b600052601260045260246000fd5b600082613c4357613c43613c1e565b500490565b600060208284031215613c5a57600080fd5b5051919050565b600060208284031215613c7357600080fd5b8151612c0b8161385f565b60008151613c9081856020860161379a565b9290920192915050565b600080845481600182811c915080831680613cb657607f831692505b6020808410821415613cd657634e487b7160e01b86526022600452602486fd5b818015613cea5760018114613cfb57613d28565b60ff19861689528489019650613d28565b60008b81526020902060005b86811015613d205781548b820152908501908301613d07565b505084890196505b505050505050613d388185613c7e565b95945050505050565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613d7981601785016020880161379a565b7f206973206d697373696e6720726f6c65200000000000000000000000000000006017918401918201528351613db681602884016020880161379a565b01602801949350505050565b634e487b7160e01b600052603260045260246000fd5b6000600019821415613dec57613dec613bd1565b5060010190565b6001600160a01b0384168152826020820152606060408201526000613d3860608301846137c6565b600082613e2a57613e2a613c1e565b500690565b60006001600160a01b03808716835280861660208401525083604083015260806060830152613e6160808301846137c6565b9695505050505050565b600060208284031215613e7d57600080fd5b8151612c0b81613767565b600082821015613e9a57613e9a613bd1565b500390565b600081613eae57613eae613bd1565b50600019019056fe43616c6c6572206973206e6f7420616e2061646d696e00000000000000000000a49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c21775a26469706673582212209326d188c3f931a3357a31b7f24c3abd52de18cc4124f63752f407a217eeb1b964736f6c63430008090033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
d14dcfb13338ffa6dd9df2d7471ba5b61ee29206406d1b80fd01e2e1aa358291d14dcfb13338ffa6dd9df2d7471ba5b61ee29206406d1b80fd01e2e1aa3582910000000000000000000000000000000000000000000000000000000000000120000000000000000000000000f0d54349addcf704f77ae15b96510dea15cb7952000000000000000000000000514910771af9ca656af840dff83e8264ecf986caaa77729d3466ca35ae8d28b3bbac7cc36a5031efdc430821c02bc31a238af4450000000000000000000000000000000000000000000000001bc16d674ec800000000000000000000000000009484dc6cdebfed3fd91f6257575699e99710f2950000000000000000000000003ca8d9fcbb5e59debc7b81cce289e008bbbe2e0b000000000000000000000000000000000000000000000000000000000000006968747470733a2f2f73746f726167656170692e666c65656b2e636f2f39643662356263632d633236392d346135382d396436652d6165643563313861663630662d6275636b65742f70726572657665616c2d6d657461646174612f70726572657665616c2e6a736f6e0000000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : merkleroot (bytes32): 0xd14dcfb13338ffa6dd9df2d7471ba5b61ee29206406d1b80fd01e2e1aa358291
Arg [1] : _rootMintFree (bytes32): 0xd14dcfb13338ffa6dd9df2d7471ba5b61ee29206406d1b80fd01e2e1aa358291
Arg [2] : uri (string): https://storageapi.fleek.co/9d6b5bcc-c269-4a58-9d6e-aed5c18af60f-bucket/prereveal-metadata/prereveal.json
Arg [3] : vrfCoordinator (address): 0xf0d54349aDdcf704F77AE15b96510dEA15cb7952
Arg [4] : link (address): 0x514910771AF9Ca656af840dff83E8264EcF986CA
Arg [5] : keyhash (bytes32): 0xaa77729d3466ca35ae8d28b3bbac7cc36a5031efdc430821c02bc31a238af445
Arg [6] : fee (uint256): 2000000000000000000
Arg [7] : _payableAddressTeam (address): 0x9484dc6CdEBfeD3fd91f6257575699E99710F295
Arg [8] : _payableAddressDev (address): 0x3CA8D9FcbB5E59debC7B81CCE289E008bBBE2E0B
-----Encoded View---------------
14 Constructor Arguments found :
Arg [0] : d14dcfb13338ffa6dd9df2d7471ba5b61ee29206406d1b80fd01e2e1aa358291
Arg [1] : d14dcfb13338ffa6dd9df2d7471ba5b61ee29206406d1b80fd01e2e1aa358291
Arg [2] : 0000000000000000000000000000000000000000000000000000000000000120
Arg [3] : 000000000000000000000000f0d54349addcf704f77ae15b96510dea15cb7952
Arg [4] : 000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca
Arg [5] : aa77729d3466ca35ae8d28b3bbac7cc36a5031efdc430821c02bc31a238af445
Arg [6] : 0000000000000000000000000000000000000000000000001bc16d674ec80000
Arg [7] : 0000000000000000000000009484dc6cdebfed3fd91f6257575699e99710f295
Arg [8] : 0000000000000000000000003ca8d9fcbb5e59debc7b81cce289e008bbbe2e0b
Arg [9] : 0000000000000000000000000000000000000000000000000000000000000069
Arg [10] : 68747470733a2f2f73746f726167656170692e666c65656b2e636f2f39643662
Arg [11] : 356263632d633236392d346135382d396436652d616564356331386166363066
Arg [12] : 2d6275636b65742f70726572657665616c2d6d657461646174612f7072657265
Arg [13] : 7665616c2e6a736f6e0000000000000000000000000000000000000000000000
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A token is a representation of an on-chain or off-chain asset. The token page shows information such as price, total supply, holders, transfers and social links. Learn more about this page in our Knowledge Base.