Overview
ETH Balance
0 ETH
ETH Value
$0.00More Info
Private Name Tags
ContractCreator
Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
---|---|---|---|---|---|---|---|---|---|
Latest 1 internal transaction
Parent Transaction Hash | Block | From | To | |||
---|---|---|---|---|---|---|
3879577 | 41 hrs ago | Contract Creation | 0 ETH |
Loading...
Loading
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Source Code Verified (Exact Match)
Contract Name:
ERC721MagicDropCloneable
Compiler Version
v0.8.24+commit.e11b9ed9
ZkSolc Version
v1.5.11
Optimization Enabled:
Yes with Mode 3
Other Settings:
cancun EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT pragma solidity ^0.8.22; import {MerkleProofLib} from "solady/src/utils/MerkleProofLib.sol"; import {SafeTransferLib} from "solady/src/utils/ext/zksync/SafeTransferLib.sol"; import {IERC721A} from "erc721a/contracts/IERC721A.sol"; import {ERC721MagicDropMetadataCloneable} from "../ERC721MagicDropMetadataCloneable.sol"; import {ERC721ACloneable} from "../ERC721ACloneable.sol"; import {IERC721MagicDropMetadata} from "contracts/nft/erc721m/interfaces/IERC721MagicDropMetadata.sol"; import {PublicStage, AllowlistStage, SetupConfig} from "../Types.sol"; import {MINT_FEE_RECEIVER} from "contracts/utils/Constants.sol"; /// ........ /// ..... .. ... /// .. ..... .. .. /// .. ... ..... .. .. /// .. ...... .. ...... .. /// .. ......... ......... .... /// .... .. .. ... /// ........ ......... .. /// .. ... ... .. ......... /// .. .......... .... .... ....... ........ /// ....... .. .. ... .... ..... .. /// ........ . ... .. .. /// . ..... ........ .... .. /// .. .. ... ........... ... ... /// ....... .. ...... ... .. /// ............ ... ........ .. .. /// ... ..... .. .. .. .. .. ...... /// .. ........ ... .. .. .. .... .... /// ....... .. .. ...... ....... .. /// .. ..... .. .... .. /// .. .... ......... . .. .. /// ... .... .. ......... . .. .. /// .... .... .. ..... ...... ... /// ..... .. ........ ... ... /// ... .. .. .. ...... ..... .. /// .. .... ... ... .. .. /// .. .... .. .. .. /// . ...... .. .. .. /// .. ...................... .............. /// .. ................ .... ... /// . ... ........ /// .. ... ...... .. /// .. .... ...EMMY.... /// .. .. ... .... .... .. /// .. .. ..... .......... /// ... .. ... ...... /// ... .... .. .. /// .. ..... ... /// ..... .... ........ ... /// ........ .. ..... .......... /// .. ........ .. ..MAGIC..... . /// .... .... .... ..EDEN.... /// ..... . ... ...... /// .. ....... .. /// ..... ..... /// .... /// @title ERC721MagicDropCloneable /// @notice A cloneable ERC-721A drop contract that supports both a public minting stage and an allowlist minting stage. /// @dev This contract extends metadata configuration, ownership, and royalty support from its parent, while adding /// time-gated, price-defined minting stages. It also incorporates a payout recipient and protocol fee structure. /// @dev ZKsync compatible version contract ERC721MagicDropCloneable is ERC721MagicDropMetadataCloneable { /*============================================================== = STORAGE = ==============================================================*/ /// @dev Address that receives the primary sale proceeds of minted tokens. /// Configurable by the owner. If unset, withdrawals may fail. address private _payoutRecipient; /// @dev The address that receives protocol fees on withdrawal. /// @notice This is fixed and cannot be changed. address public constant PROTOCOL_FEE_RECIPIENT = 0xA3833016a4eC61f5c253D71c77522cC8A1cC1106; /// @dev The protocol fee expressed in basis points (e.g., 500 = 5%). /// @notice This fee is taken from the contract's entire balance upon withdrawal. uint256 public constant PROTOCOL_FEE_BPS = 0; // 0% /// @dev The denominator used for calculating basis points. /// @notice 10,000 BPS = 100%. A fee of 500 BPS is therefore 5%. uint256 public constant BPS_DENOMINATOR = 10_000; /// @dev Configuration of the public mint stage, including timing and price. /// @notice Public mints occur only if the current timestamp is within [startTime, endTime]. PublicStage private _publicStage; /// @dev Configuration of the allowlist mint stage, including timing, price, and a merkle root for verification. /// @notice Only addresses proven by a valid Merkle proof can mint during this stage. AllowlistStage private _allowlistStage; /// @dev The mint fee to charge on top of each mint /// @notice Set permanently on initialization uint256 public mintFee; /*============================================================== = EVENTS = ==============================================================*/ /// @notice Emitted when the public mint stage is set. event PublicStageSet(PublicStage stage); /// @notice Emitted when the allowlist mint stage is set. event AllowlistStageSet(AllowlistStage stage); /// @notice Emitted when the payout recipient is set. event PayoutRecipientSet(address newPayoutRecipient); /// @notice Emitted when a token is minted. event TokenMinted(address indexed to, uint256 tokenId, uint256 qty); /*============================================================== = ERRORS = ==============================================================*/ /// @notice Thrown when attempting to mint during a public stage that is not currently active. error PublicStageNotActive(); /// @notice Thrown when attempting to mint during an allowlist stage that is not currently active. error AllowlistStageNotActive(); /// @notice Thrown when the provided ETH value for a mint is insufficient. error RequiredValueNotMet(); /// @notice Thrown when the provided Merkle proof for an allowlist mint is invalid. error InvalidProof(); /// @notice Thrown when a stage's start or end time configuration is invalid. error InvalidStageTime(); /// @notice Thrown when the allowlist stage timing conflicts with the public stage timing. error InvalidAllowlistStageTime(); /// @notice Thrown when the public stage timing conflicts with the allowlist stage timing. error InvalidPublicStageTime(); /// @notice Thrown when the payout recipient is set to a zero address. error PayoutRecipientCannotBeZeroAddress(); /*============================================================== = INITIALIZERS = ==============================================================*/ /// @notice Initializes the contract with a name, symbol, owner and mintFee. /// @dev Can only be called once. It sets the owner, emits a deploy event, and prepares the token for minting stages. /// @param _name The ERC-721 name of the collection. /// @param _symbol The ERC-721 symbol of the collection. /// @param _owner The address designated as the initial owner of the contract. /// @param _mintFee The fee to charge on top of each mint. function initialize(string memory _name, string memory _symbol, address _owner, uint256 _mintFee) public initializer { __ERC721ACloneable__init(_name, _symbol); __ERC721MagicDropMetadataCloneable__init(_owner); mintFee = _mintFee; } /*============================================================== = PUBLIC WRITE METHODS = ==============================================================*/ /// @notice Mints tokens during the public stage. /// @dev Requires that the current time is within the configured public stage interval. /// Reverts if the buyer does not send enough ETH, or if the wallet limit would be exceeded. /// @param to The recipient address for the minted tokens. /// @param qty The number of tokens to mint. function mintPublic(address to, uint256 qty) external payable { PublicStage memory stage = _publicStage; if (block.timestamp < stage.startTime || block.timestamp > stage.endTime) { revert PublicStageNotActive(); } uint256 stagePrice = stage.price + mintFee; uint256 requiredPayment = stagePrice * qty; if (msg.value != requiredPayment) { revert RequiredValueNotMet(); } if (_walletLimit > 0 && _numberMinted(to) + qty > _walletLimit) { revert WalletLimitExceeded(); } if (_totalMinted() + qty > _maxSupply) { revert CannotExceedMaxSupply(); } _safeMint(to, qty); if (stagePrice != 0) { _splitProceeds(qty); } emit TokenMinted(to, _totalMinted(), qty); } /// @notice Mints tokens during the allowlist stage. /// @dev Requires a valid Merkle proof and the current time within the allowlist stage interval. /// Reverts if the buyer sends insufficient ETH or if the wallet limit is exceeded. /// @param to The recipient address for the minted tokens. /// @param qty The number of tokens to mint. /// @param proof The Merkle proof verifying `to` is eligible for the allowlist. function mintAllowlist(address to, uint256 qty, bytes32[] calldata proof) external payable { AllowlistStage memory stage = _allowlistStage; if (block.timestamp < stage.startTime || block.timestamp > stage.endTime) { revert AllowlistStageNotActive(); } if (!MerkleProofLib.verify(proof, stage.merkleRoot, keccak256(bytes.concat(keccak256(abi.encode(to)))))) { revert InvalidProof(); } uint256 stagePrice = stage.price + mintFee; uint256 requiredPayment = stagePrice * qty; if (msg.value != requiredPayment) { revert RequiredValueNotMet(); } if (_walletLimit > 0 && _numberMinted(to) + qty > _walletLimit) { revert WalletLimitExceeded(); } if (_totalMinted() + qty > _maxSupply) { revert CannotExceedMaxSupply(); } _safeMint(to, qty); if (stagePrice != 0) { _splitProceeds(qty); } } /// @notice Burns a specific token. /// @dev Only callable by the token owner or an approved operator. The token must exist. /// @param tokenId The ID of the token to burn. function burn(uint256 tokenId) external { _burn(tokenId, true); } /*============================================================== = PUBLIC VIEW METHODS = ==============================================================*/ /// @notice Returns the current configuration of the contract. /// @return The current configuration of the contract. function getConfig() external view returns (SetupConfig memory) { SetupConfig memory newConfig = SetupConfig({ maxSupply: _maxSupply, walletLimit: _walletLimit, baseURI: _baseURI(), contractURI: _contractURI, allowlistStage: _allowlistStage, publicStage: _publicStage, payoutRecipient: _payoutRecipient, royaltyRecipient: _royaltyReceiver, royaltyBps: _royaltyBps }); return newConfig; } /// @notice Returns the current public stage configuration (startTime, endTime, price). /// @return The current public stage settings. function getPublicStage() external view returns (PublicStage memory) { return _publicStage; } /// @notice Returns the current allowlist stage configuration (startTime, endTime, price, merkleRoot). /// @return The current allowlist stage settings. function getAllowlistStage() external view returns (AllowlistStage memory) { return _allowlistStage; } /// @notice Returns the current payout recipient who receives primary sales proceeds after protocol fees. /// @return The address currently set to receive payout funds. function payoutRecipient() external view returns (address) { return _payoutRecipient; } /// @notice Indicates whether the contract implements a given interface. /// @param interfaceId The interface ID to check for support. /// @return True if the interface is supported, false otherwise. function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721MagicDropMetadataCloneable) returns (bool) { return interfaceId == type(IERC721MagicDropMetadata).interfaceId || super.supportsInterface(interfaceId); } /*============================================================== = ADMIN OPERATIONS = ==============================================================*/ /// @notice Sets up the contract parameters in a single call. /// @dev Only callable by the owner. Configures max supply, wallet limit, URIs, stages, payout recipient. /// @param config A struct containing all setup parameters. function setup(SetupConfig calldata config) external onlyOwner { if (config.maxSupply > 0) { _setMaxSupply(config.maxSupply); } if (config.walletLimit > 0) { _setWalletLimit(config.walletLimit); } if (bytes(config.baseURI).length > 0) { _setBaseURI(config.baseURI); } if (bytes(config.contractURI).length > 0) { _setContractURI(config.contractURI); } if (config.allowlistStage.startTime != 0 || config.allowlistStage.endTime != 0) { _setAllowlistStage(config.allowlistStage); } if (config.publicStage.startTime != 0 || config.publicStage.endTime != 0) { _setPublicStage(config.publicStage); } if (config.payoutRecipient != address(0)) { _setPayoutRecipient(config.payoutRecipient); } if (config.royaltyRecipient != address(0)) { _setRoyaltyInfo(config.royaltyRecipient, config.royaltyBps); } } /// @notice Sets the configuration of the public mint stage. /// @dev Only callable by the owner. Ensures the public stage does not overlap improperly with the allowlist stage. /// @param stage A struct defining the public stage timing and price. function setPublicStage(PublicStage calldata stage) external onlyOwner { _setPublicStage(stage); } /// @notice Sets the configuration of the allowlist mint stage. /// @dev Only callable by the owner. Ensures the allowlist stage does not overlap improperly with the public stage. /// @param stage A struct defining the allowlist stage timing, price, and merkle root. function setAllowlistStage(AllowlistStage calldata stage) external onlyOwner { _setAllowlistStage(stage); } /// @notice Sets the payout recipient address for primary sale proceeds (after the protocol fee is deducted). /// @dev Only callable by the owner. /// @param newPayoutRecipient The address to receive future withdrawals. function setPayoutRecipient(address newPayoutRecipient) external onlyOwner { _setPayoutRecipient(newPayoutRecipient); } /*============================================================== = INTERNAL HELPERS = ==============================================================*/ /// @notice Internal function to set the public mint stage configuration. /// @dev Reverts if timing is invalid or conflicts with the allowlist stage. /// @param stage A struct defining public stage timings and price. function _setPublicStage(PublicStage calldata stage) internal { if (stage.startTime >= stage.endTime) { revert InvalidStageTime(); } // Ensure the public stage starts after the allowlist stage ends if (_allowlistStage.startTime != 0 && _allowlistStage.endTime != 0) { if (stage.startTime <= _allowlistStage.endTime) { revert InvalidPublicStageTime(); } } _publicStage = stage; emit PublicStageSet(stage); } /// @notice Internal function to set the allowlist mint stage configuration. /// @dev Reverts if timing is invalid or conflicts with the public stage. /// @param stage A struct defining allowlist stage timings, price, and merkle root. function _setAllowlistStage(AllowlistStage calldata stage) internal { if (stage.startTime >= stage.endTime) { revert InvalidStageTime(); } // Ensure the public stage starts after the allowlist stage ends if (_publicStage.startTime != 0 && _publicStage.endTime != 0) { if (stage.endTime >= _publicStage.startTime) { revert InvalidAllowlistStageTime(); } } _allowlistStage = stage; emit AllowlistStageSet(stage); } /// @notice Internal function to set the payout recipient. /// @dev This function does not revert if given a zero address, but no payouts would succeed if so. /// @param newPayoutRecipient The address to receive the payout from mint proceeds. function _setPayoutRecipient(address newPayoutRecipient) internal { _payoutRecipient = newPayoutRecipient; emit PayoutRecipientSet(newPayoutRecipient); } /// @notice Internal function to split the proceeds of a mint. /// @dev This function is called by the mint functions to split the proceeds into a mint fee, protocol fee and a payout. function _splitProceeds(uint256 qty) internal { if (_payoutRecipient == address(0)) { revert PayoutRecipientCannotBeZeroAddress(); } uint256 proceeds = msg.value; if (mintFee > 0) { uint256 totalMintFee = mintFee * qty; proceeds -= totalMintFee; SafeTransferLib.safeTransferETH(MINT_FEE_RECEIVER, totalMintFee); } // If there are no remaining proceeds after mint fee is taken, exit early if (proceeds == 0) { return; } if (PROTOCOL_FEE_BPS > 0) { uint256 protocolFee = (proceeds * PROTOCOL_FEE_BPS) / BPS_DENOMINATOR; uint256 remainingBalance; unchecked { remainingBalance = proceeds - protocolFee; } SafeTransferLib.safeTransferETH(PROTOCOL_FEE_RECIPIENT, protocolFee); SafeTransferLib.safeTransferETH(_payoutRecipient, remainingBalance); } else { SafeTransferLib.safeTransferETH(_payoutRecipient, proceeds); } } /*============================================================== = META = ==============================================================*/ /// @notice Returns the contract name and version. /// @dev Useful for external tools or metadata standards. /// @return The contract name and version strings. function contractNameAndVersion() public pure returns (string memory, string memory) { return ("ERC721MagicDropCloneable", "1.0.2"); } /// @notice Retrieves the token metadata URI for a given token ID. /// @dev If no base URI is set, returns an empty string. /// If a trailing slash is present, tokenId is appended; otherwise returns just the base URI. /// @param tokenId The ID of the token to retrieve the URI for. /// @return The token's metadata URI as a string. function tokenURI(uint256 tokenId) public view virtual override(ERC721ACloneable, IERC721A) returns (string memory) { if (!_exists(tokenId)) revert URIQueryForNonexistentToken(); string memory baseURI = _baseURI(); bool isBaseURIEmpty = bytes(baseURI).length == 0; bool hasNoTrailingSlash = !isBaseURIEmpty && bytes(baseURI)[bytes(baseURI).length - 1] != bytes("/")[0]; if (isBaseURIEmpty) { return ""; } if (hasNoTrailingSlash) { return baseURI; } return string(abi.encodePacked(baseURI, _toString(tokenId))); } /*============================================================== = MISC = ==============================================================*/ /// @dev Overridden to allow this contract to properly manage owner initialization. /// By always returning true, we ensure that the inherited initializer does not re-run. function _guardInitializeOwner() internal pure virtual override returns (bool) { return true; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.4; /// @notice Gas optimized verification of proof of inclusion for a leaf in a Merkle tree. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/MerkleProofLib.sol) /// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/MerkleProofLib.sol) /// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/cryptography/MerkleProof.sol) library MerkleProofLib { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* MERKLE PROOF VERIFICATION OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns whether `leaf` exists in the Merkle tree with `root`, given `proof`. function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool isValid) { /// @solidity memory-safe-assembly assembly { if mload(proof) { // Initialize `offset` to the offset of `proof` elements in memory. let offset := add(proof, 0x20) // Left shift by 5 is equivalent to multiplying by 0x20. let end := add(offset, shl(5, mload(proof))) // Iterate over proof elements to compute root hash. for {} 1 {} { // Slot of `leaf` in scratch space. // If the condition is true: 0x20, otherwise: 0x00. let scratch := shl(5, gt(leaf, mload(offset))) // Store elements to hash contiguously in scratch space. // Scratch space is 64 bytes (0x00 - 0x3f) and both elements are 32 bytes. mstore(scratch, leaf) mstore(xor(scratch, 0x20), mload(offset)) // Reuse `leaf` to store the hash to reduce stack operations. leaf := keccak256(0x00, 0x40) offset := add(offset, 0x20) if iszero(lt(offset, end)) { break } } } isValid := eq(leaf, root) } } /// @dev Returns whether `leaf` exists in the Merkle tree with `root`, given `proof`. function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool isValid) { /// @solidity memory-safe-assembly assembly { if proof.length { // Left shift by 5 is equivalent to multiplying by 0x20. let end := add(proof.offset, shl(5, proof.length)) // Initialize `offset` to the offset of `proof` in the calldata. let offset := proof.offset // Iterate over proof elements to compute root hash. for {} 1 {} { // Slot of `leaf` in scratch space. // If the condition is true: 0x20, otherwise: 0x00. let scratch := shl(5, gt(leaf, calldataload(offset))) // Store elements to hash contiguously in scratch space. // Scratch space is 64 bytes (0x00 - 0x3f) and both elements are 32 bytes. mstore(scratch, leaf) mstore(xor(scratch, 0x20), calldataload(offset)) // Reuse `leaf` to store the hash to reduce stack operations. leaf := keccak256(0x00, 0x40) offset := add(offset, 0x20) if iszero(lt(offset, end)) { break } } } isValid := eq(leaf, root) } } /// @dev Returns whether all `leaves` exist in the Merkle tree with `root`, /// given `proof` and `flags`. /// /// Note: /// - Breaking the invariant `flags.length == (leaves.length - 1) + proof.length` /// will always return false. /// - The sum of the lengths of `proof` and `leaves` must never overflow. /// - Any non-zero word in the `flags` array is treated as true. /// - The memory offset of `proof` must be non-zero /// (i.e. `proof` is not pointing to the scratch space). function verifyMultiProof( bytes32[] memory proof, bytes32 root, bytes32[] memory leaves, bool[] memory flags ) internal pure returns (bool isValid) { // Rebuilds the root by consuming and producing values on a queue. // The queue starts with the `leaves` array, and goes into a `hashes` array. // After the process, the last element on the queue is verified // to be equal to the `root`. // // The `flags` array denotes whether the sibling // should be popped from the queue (`flag == true`), or // should be popped from the `proof` (`flag == false`). /// @solidity memory-safe-assembly assembly { // Cache the lengths of the arrays. let leavesLength := mload(leaves) let proofLength := mload(proof) let flagsLength := mload(flags) // Advance the pointers of the arrays to point to the data. leaves := add(0x20, leaves) proof := add(0x20, proof) flags := add(0x20, flags) // If the number of flags is correct. for {} eq(add(leavesLength, proofLength), add(flagsLength, 1)) {} { // For the case where `proof.length + leaves.length == 1`. if iszero(flagsLength) { // `isValid = (proof.length == 1 ? proof[0] : leaves[0]) == root`. isValid := eq(mload(xor(leaves, mul(xor(proof, leaves), proofLength))), root) break } // The required final proof offset if `flagsLength` is not zero, otherwise zero. let proofEnd := add(proof, shl(5, proofLength)) // We can use the free memory space for the queue. // We don't need to allocate, since the queue is temporary. let hashesFront := mload(0x40) // Copy the leaves into the hashes. // Sometimes, a little memory expansion costs less than branching. // Should cost less, even with a high free memory offset of 0x7d00. leavesLength := shl(5, leavesLength) for { let i := 0 } iszero(eq(i, leavesLength)) { i := add(i, 0x20) } { mstore(add(hashesFront, i), mload(add(leaves, i))) } // Compute the back of the hashes. let hashesBack := add(hashesFront, leavesLength) // This is the end of the memory for the queue. // We recycle `flagsLength` to save on stack variables (sometimes save gas). flagsLength := add(hashesBack, shl(5, flagsLength)) for {} 1 {} { // Pop from `hashes`. let a := mload(hashesFront) // Pop from `hashes`. let b := mload(add(hashesFront, 0x20)) hashesFront := add(hashesFront, 0x40) // If the flag is false, load the next proof, // else, pops from the queue. if iszero(mload(flags)) { // Loads the next proof. b := mload(proof) proof := add(proof, 0x20) // Unpop from `hashes`. hashesFront := sub(hashesFront, 0x20) } // Advance to the next flag. flags := add(flags, 0x20) // Slot of `a` in scratch space. // If the condition is true: 0x20, otherwise: 0x00. let scratch := shl(5, gt(a, b)) // Hash the scratch space and push the result onto the queue. mstore(scratch, a) mstore(xor(scratch, 0x20), b) mstore(hashesBack, keccak256(0x00, 0x40)) hashesBack := add(hashesBack, 0x20) if iszero(lt(hashesBack, flagsLength)) { break } } isValid := and( // Checks if the last value in the queue is same as the root. eq(mload(sub(hashesBack, 0x20)), root), // And whether all the proofs are used, if required. eq(proofEnd, proof) ) break } } } /// @dev Returns whether all `leaves` exist in the Merkle tree with `root`, /// given `proof` and `flags`. /// /// Note: /// - Breaking the invariant `flags.length == (leaves.length - 1) + proof.length` /// will always return false. /// - Any non-zero word in the `flags` array is treated as true. /// - The calldata offset of `proof` must be non-zero /// (i.e. `proof` is from a regular Solidity function with a 4-byte selector). function verifyMultiProofCalldata( bytes32[] calldata proof, bytes32 root, bytes32[] calldata leaves, bool[] calldata flags ) internal pure returns (bool isValid) { // Rebuilds the root by consuming and producing values on a queue. // The queue starts with the `leaves` array, and goes into a `hashes` array. // After the process, the last element on the queue is verified // to be equal to the `root`. // // The `flags` array denotes whether the sibling // should be popped from the queue (`flag == true`), or // should be popped from the `proof` (`flag == false`). /// @solidity memory-safe-assembly assembly { // If the number of flags is correct. for {} eq(add(leaves.length, proof.length), add(flags.length, 1)) {} { // For the case where `proof.length + leaves.length == 1`. if iszero(flags.length) { // `isValid = (proof.length == 1 ? proof[0] : leaves[0]) == root`. // forgefmt: disable-next-item isValid := eq( calldataload( xor(leaves.offset, mul(xor(proof.offset, leaves.offset), proof.length)) ), root ) break } // The required final proof offset if `flagsLength` is not zero, otherwise zero. let proofEnd := add(proof.offset, shl(5, proof.length)) // We can use the free memory space for the queue. // We don't need to allocate, since the queue is temporary. let hashesFront := mload(0x40) // Copy the leaves into the hashes. // Sometimes, a little memory expansion costs less than branching. // Should cost less, even with a high free memory offset of 0x7d00. calldatacopy(hashesFront, leaves.offset, shl(5, leaves.length)) // Compute the back of the hashes. let hashesBack := add(hashesFront, shl(5, leaves.length)) // This is the end of the memory for the queue. // We recycle `flagsLength` to save on stack variables (sometimes save gas). flags.length := add(hashesBack, shl(5, flags.length)) // We don't need to make a copy of `proof.offset` or `flags.offset`, // as they are pass-by-value (this trick may not always save gas). for {} 1 {} { // Pop from `hashes`. let a := mload(hashesFront) // Pop from `hashes`. let b := mload(add(hashesFront, 0x20)) hashesFront := add(hashesFront, 0x40) // If the flag is false, load the next proof, // else, pops from the queue. if iszero(calldataload(flags.offset)) { // Loads the next proof. b := calldataload(proof.offset) proof.offset := add(proof.offset, 0x20) // Unpop from `hashes`. hashesFront := sub(hashesFront, 0x20) } // Advance to the next flag offset. flags.offset := add(flags.offset, 0x20) // Slot of `a` in scratch space. // If the condition is true: 0x20, otherwise: 0x00. let scratch := shl(5, gt(a, b)) // Hash the scratch space and push the result onto the queue. mstore(scratch, a) mstore(xor(scratch, 0x20), b) mstore(hashesBack, keccak256(0x00, 0x40)) hashesBack := add(hashesBack, 0x20) if iszero(lt(hashesBack, flags.length)) { break } } isValid := and( // Checks if the last value in the queue is same as the root. eq(mload(sub(hashesBack, 0x20)), root), // And whether all the proofs are used, if required. eq(proofEnd, proof.offset) ) break } } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EMPTY CALLDATA HELPERS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns an empty calldata bytes32 array. function emptyProof() internal pure returns (bytes32[] calldata proof) { /// @solidity memory-safe-assembly assembly { proof.length := 0 } } /// @dev Returns an empty calldata bytes32 array. function emptyLeaves() internal pure returns (bytes32[] calldata leaves) { /// @solidity memory-safe-assembly assembly { leaves.length := 0 } } /// @dev Returns an empty calldata bool array. function emptyFlags() internal pure returns (bool[] calldata flags) { /// @solidity memory-safe-assembly assembly { flags.length := 0 } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.4; import {SingleUseETHVault} from "./SingleUseETHVault.sol"; /// @notice Library for force safe transferring ETH and ERC20s in ZKsync. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/ext/zksync/SafeTransferLib.sol) library SafeTransferLib { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev A single use ETH vault has been created for `to`, with `amount`. event SingleUseETHVaultCreated(address indexed to, uint256 amount, address vault); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The ETH transfer has failed. error ETHTransferFailed(); /// @dev The ERC20 `transferFrom` has failed. error TransferFromFailed(); /// @dev The ERC20 `transfer` has failed. error TransferFailed(); /// @dev The ERC20 `approve` has failed. error ApproveFailed(); /// @dev The ERC20 `totalSupply` query has failed. error TotalSupplyQueryFailed(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CONSTANTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Suggested gas stipend for contract receiving ETH to perform a few /// storage reads and writes, but low enough to prevent griefing. uint256 internal constant GAS_STIPEND_NO_GRIEF = 1000000; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* ETH OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ // If the ETH transfer MUST succeed with a reasonable gas budget, use the force variants. // // The regular variants: // - Forwards all remaining gas to the target. // - Reverts if the target reverts. // - Reverts if the current contract has insufficient balance. // // The force variants: // - Forwards with an optional gas stipend // (defaults to `GAS_STIPEND_NO_GRIEF`, which is sufficient for most cases). // - If the target reverts, or if the gas stipend is exhausted, // creates a temporary contract to force send the ETH via `SELFDESTRUCT`. // Future compatible with `SENDALL`: https://eips.ethereum.org/EIPS/eip-4758. // - Reverts if the current contract has insufficient balance. // // The try variants: // - Forwards with a mandatory gas stipend. // - Instead of reverting, returns whether the transfer succeeded. /// @dev Sends `amount` (in wei) ETH to `to`. function safeTransferETH(address to, uint256 amount) internal { /// @solidity memory-safe-assembly assembly { if iszero(call(gas(), to, amount, 0x00, 0x00, 0x00, 0x00)) { mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`. revert(0x1c, 0x04) } } } /// @dev Sends all the ETH in the current contract to `to`. function safeTransferAllETH(address to) internal { /// @solidity memory-safe-assembly assembly { // Transfer all the ETH and check if it succeeded or not. if iszero(call(gas(), to, selfbalance(), 0x00, 0x00, 0x00, 0x00)) { mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`. revert(0x1c, 0x04) } } } /// @dev Force sends `amount` (in wei) ETH to `to`, with a `gasStipend`. /// If force transfer is used, returns the vault. Else returns `address(0)`. function forceSafeTransferETH(address to, uint256 amount, uint256 gasStipend) internal returns (address vault) { if (amount == uint256(0)) return address(0); // Early return if `amount` is zero. uint256 selfBalanceBefore = address(this).balance; /// @solidity memory-safe-assembly assembly { if lt(selfBalanceBefore, amount) { mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`. revert(0x1c, 0x04) } pop(call(gasStipend, to, amount, 0x00, 0x00, 0x00, 0x00)) } if (address(this).balance == selfBalanceBefore) { vault = address(new SingleUseETHVault()); /// @solidity memory-safe-assembly assembly { mstore(0x00, shr(96, shl(96, to))) if iszero(call(gas(), vault, amount, 0x00, 0x20, 0x00, 0x00)) { revert(0x00, 0x00) } } emit SingleUseETHVaultCreated(to, amount, vault); } } /// @dev Force sends all the ETH in the current contract to `to`, with a `gasStipend`. /// If force transfer is used, returns the vault. Else returns `address(0)`. function forceSafeTransferAllETH(address to, uint256 gasStipend) internal returns (address vault) { vault = forceSafeTransferETH(to, address(this).balance, gasStipend); } /// @dev Force sends `amount` (in wei) ETH to `to`, with `GAS_STIPEND_NO_GRIEF`. /// If force transfer is used, returns the vault. Else returns `address(0)`. function forceSafeTransferETH(address to, uint256 amount) internal returns (address vault) { vault = forceSafeTransferETH(to, amount, GAS_STIPEND_NO_GRIEF); } /// @dev Force sends all the ETH in the current contract to `to`, with `GAS_STIPEND_NO_GRIEF`. /// If force transfer is used, returns the vault. Else returns `address(0)`. function forceSafeTransferAllETH(address to) internal returns (address vault) { vault = forceSafeTransferETH(to, address(this).balance, GAS_STIPEND_NO_GRIEF); } /// @dev Sends `amount` (in wei) ETH to `to`, with a `gasStipend`. function trySafeTransferETH(address to, uint256 amount, uint256 gasStipend) internal returns (bool success) { /// @solidity memory-safe-assembly assembly { success := call(gasStipend, to, amount, 0x00, 0x00, 0x00, 0x00) } } /// @dev Sends all the ETH in the current contract to `to`, with a `gasStipend`. function trySafeTransferAllETH(address to, uint256 gasStipend) internal returns (bool success) { /// @solidity memory-safe-assembly assembly { success := call(gasStipend, to, selfbalance(), 0x00, 0x00, 0x00, 0x00) } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* ERC20 OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Sends `amount` of ERC20 `token` from `from` to `to`. /// Reverts upon failure. /// /// The `from` account must have at least `amount` approved for /// the current contract to manage. function safeTransferFrom(address token, address from, address to, uint256 amount) internal { /// @solidity memory-safe-assembly assembly { let m := mload(0x40) // Cache the free memory pointer. mstore(0x60, amount) // Store the `amount` argument. mstore(0x40, to) // Store the `to` argument. mstore(0x2c, shl(96, from)) // Store the `from` argument. mstore(0x0c, 0x23b872dd000000000000000000000000) // `transferFrom(address,address,uint256)`. let success := call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20) if iszero(and(eq(mload(0x00), 1), success)) { if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) { mstore(0x00, 0x7939f424) // `TransferFromFailed()`. revert(0x1c, 0x04) } } mstore(0x60, 0) // Restore the zero slot to zero. mstore(0x40, m) // Restore the free memory pointer. } } /// @dev Sends `amount` of ERC20 `token` from `from` to `to`. /// /// The `from` account must have at least `amount` approved for the current contract to manage. function trySafeTransferFrom(address token, address from, address to, uint256 amount) internal returns (bool success) { /// @solidity memory-safe-assembly assembly { let m := mload(0x40) // Cache the free memory pointer. mstore(0x60, amount) // Store the `amount` argument. mstore(0x40, to) // Store the `to` argument. mstore(0x2c, shl(96, from)) // Store the `from` argument. mstore(0x0c, 0x23b872dd000000000000000000000000) // `transferFrom(address,address,uint256)`. success := call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20) if iszero(and(eq(mload(0x00), 1), success)) { success := lt(or(iszero(extcodesize(token)), returndatasize()), success) } mstore(0x60, 0) // Restore the zero slot to zero. mstore(0x40, m) // Restore the free memory pointer. } } /// @dev Sends all of ERC20 `token` from `from` to `to`. /// Reverts upon failure. /// /// The `from` account must have their entire balance approved for the current contract to manage. function safeTransferAllFrom(address token, address from, address to) internal returns (uint256 amount) { /// @solidity memory-safe-assembly assembly { let m := mload(0x40) // Cache the free memory pointer. mstore(0x40, to) // Store the `to` argument. mstore(0x2c, shl(96, from)) // Store the `from` argument. mstore(0x0c, 0x70a08231000000000000000000000000) // `balanceOf(address)`. // Read the balance, reverting upon failure. if iszero( and( // The arguments of `and` are evaluated from right to left. gt(returndatasize(), 0x1f), // At least 32 bytes returned. staticcall(gas(), token, 0x1c, 0x24, 0x60, 0x20) ) ) { mstore(0x00, 0x7939f424) // `TransferFromFailed()`. revert(0x1c, 0x04) } mstore(0x00, 0x23b872dd) // `transferFrom(address,address,uint256)`. amount := mload(0x60) // The `amount` is already at 0x60. We'll need to return it. // Perform the transfer, reverting upon failure. let success := call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20) if iszero(and(eq(mload(0x00), 1), success)) { if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) { mstore(0x00, 0x7939f424) // `TransferFromFailed()`. revert(0x1c, 0x04) } } mstore(0x60, 0) // Restore the zero slot to zero. mstore(0x40, m) // Restore the free memory pointer. } } /// @dev Sends `amount` of ERC20 `token` from the current contract to `to`. /// Reverts upon failure. function safeTransfer(address token, address to, uint256 amount) internal { /// @solidity memory-safe-assembly assembly { mstore(0x14, to) // Store the `to` argument. mstore(0x34, amount) // Store the `amount` argument. mstore(0x00, 0xa9059cbb000000000000000000000000) // `transfer(address,uint256)`. // Perform the transfer, reverting upon failure. let success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20) if iszero(and(eq(mload(0x00), 1), success)) { if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) { mstore(0x00, 0x90b8ec18) // `TransferFailed()`. revert(0x1c, 0x04) } } mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten. } } /// @dev Sends all of ERC20 `token` from the current contract to `to`. /// Reverts upon failure. function safeTransferAll(address token, address to) internal returns (uint256 amount) { /// @solidity memory-safe-assembly assembly { mstore(0x00, 0x70a08231) // Store the function selector of `balanceOf(address)`. mstore(0x20, address()) // Store the address of the current contract. // Read the balance, reverting upon failure. if iszero( and( // The arguments of `and` are evaluated from right to left. gt(returndatasize(), 0x1f), // At least 32 bytes returned. staticcall(gas(), token, 0x1c, 0x24, 0x34, 0x20) ) ) { mstore(0x00, 0x90b8ec18) // `TransferFailed()`. revert(0x1c, 0x04) } mstore(0x14, to) // Store the `to` argument. amount := mload(0x34) // The `amount` is already at 0x34. We'll need to return it. mstore(0x00, 0xa9059cbb000000000000000000000000) // `transfer(address,uint256)`. // Perform the transfer, reverting upon failure. let success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20) if iszero(and(eq(mload(0x00), 1), success)) { if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) { mstore(0x00, 0x90b8ec18) // `TransferFailed()`. revert(0x1c, 0x04) } } mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten. } } /// @dev Sets `amount` of ERC20 `token` for `to` to manage on behalf of the current contract. /// Reverts upon failure. function safeApprove(address token, address to, uint256 amount) internal { /// @solidity memory-safe-assembly assembly { mstore(0x14, to) // Store the `to` argument. mstore(0x34, amount) // Store the `amount` argument. mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`. let success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20) if iszero(and(eq(mload(0x00), 1), success)) { if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) { mstore(0x00, 0x3e3f8f73) // `ApproveFailed()`. revert(0x1c, 0x04) } } mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten. } } /// @dev Sets `amount` of ERC20 `token` for `to` to manage on behalf of the current contract. /// If the initial attempt to approve fails, attempts to reset the approved amount to zero, /// then retries the approval again (some tokens, e.g. USDT, requires this). /// Reverts upon failure. function safeApproveWithRetry(address token, address to, uint256 amount) internal { /// @solidity memory-safe-assembly assembly { mstore(0x14, to) // Store the `to` argument. mstore(0x34, amount) // Store the `amount` argument. mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`. // Perform the approval, retrying upon failure. let success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20) if iszero(and(eq(mload(0x00), 1), success)) { if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) { mstore(0x34, 0) // Store 0 for the `amount`. mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`. pop(call(gas(), token, 0, 0x10, 0x44, 0x00, 0x00)) // Reset the approval. mstore(0x34, amount) // Store back the original `amount`. // Retry the approval, reverting upon failure. success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20) if iszero(and(eq(mload(0x00), 1), success)) { // Check the `extcodesize` again just in case the token selfdestructs lol. if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) { mstore(0x00, 0x3e3f8f73) // `ApproveFailed()`. revert(0x1c, 0x04) } } } } mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten. } } /// @dev Returns the amount of ERC20 `token` owned by `account`. /// Returns zero if the `token` does not exist. function balanceOf(address token, address account) internal view returns (uint256 amount) { /// @solidity memory-safe-assembly assembly { mstore(0x14, account) // Store the `account` argument. mstore(0x00, 0x70a08231000000000000000000000000) // `balanceOf(address)`. amount := mul( // The arguments of `mul` are evaluated from right to left. mload(0x20), and( // The arguments of `and` are evaluated from right to left. gt(returndatasize(), 0x1f), // At least 32 bytes returned. staticcall(gas(), token, 0x10, 0x24, 0x20, 0x20) ) ) } } /// @dev Returns the total supply of the `token`. /// Reverts if the token does not exist or does not implement `totalSupply()`. function totalSupply(address token) internal view returns (uint256 result) { /// @solidity memory-safe-assembly assembly { mstore(0x00, 0x18160ddd) // `totalSupply()`. if iszero( and(gt(returndatasize(), 0x1f), staticcall(gas(), token, 0x1c, 0x04, 0x00, 0x20)) ) { mstore(0x00, 0x54cd9435) // `TotalSupplyQueryFailed()`. revert(0x1c, 0x04) } result := mload(0x00) } } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; /** * @dev Interface of ERC721A. */ interface IERC721A { /** * The caller must own the token or be an approved operator. */ error ApprovalCallerNotOwnerNorApproved(); /** * The token does not exist. */ error ApprovalQueryForNonexistentToken(); /** * Cannot query the balance for the zero address. */ error BalanceQueryForZeroAddress(); /** * Cannot mint to the zero address. */ error MintToZeroAddress(); /** * The quantity of tokens minted must be more than zero. */ error MintZeroQuantity(); /** * The token does not exist. */ error OwnerQueryForNonexistentToken(); /** * The caller must own the token or be an approved operator. */ error TransferCallerNotOwnerNorApproved(); /** * The token must be owned by `from`. */ error TransferFromIncorrectOwner(); /** * Cannot safely transfer to a contract that does not implement the * ERC721Receiver interface. */ error TransferToNonERC721ReceiverImplementer(); /** * Cannot transfer to the zero address. */ error TransferToZeroAddress(); /** * The token does not exist. */ error URIQueryForNonexistentToken(); /** * The `quantity` minted with ERC2309 exceeds the safety limit. */ error MintERC2309QuantityExceedsLimit(); /** * The `extraData` cannot be set on an unintialized ownership slot. */ error OwnershipNotInitializedForExtraData(); /** * `_sequentialUpTo()` must be greater than `_startTokenId()`. */ error SequentialUpToTooSmall(); /** * The `tokenId` of a sequential mint exceeds `_sequentialUpTo()`. */ error SequentialMintExceedsLimit(); /** * Spot minting requires a `tokenId` greater than `_sequentialUpTo()`. */ error SpotMintTokenIdTooSmall(); /** * Cannot mint over a token that already exists. */ error TokenAlreadyExists(); /** * The feature is not compatible with spot mints. */ error NotCompatibleWithSpotMints(); // ============================================================= // STRUCTS // ============================================================= struct TokenOwnership { // The address of the owner. address addr; // Stores the start time of ownership with minimal overhead for tokenomics. uint64 startTimestamp; // Whether the token has been burned. bool burned; // Arbitrary data similar to `startTimestamp` that can be set via {_extraData}. uint24 extraData; } // ============================================================= // TOKEN COUNTERS // ============================================================= /** * @dev Returns the total number of tokens in existence. * Burned tokens will reduce the count. * To get the total number of tokens minted, please see {_totalMinted}. */ function totalSupply() external view returns (uint256); // ============================================================= // IERC165 // ============================================================= /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified) * to learn more about how these ids are created. * * This function call must use less than 30000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); // ============================================================= // IERC721 // ============================================================= /** * @dev Emitted when `tokenId` token is transferred from `from` to `to`. */ event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. */ event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables or disables * (`approved`) `operator` to manage all of its assets. */ event ApprovalForAll(address indexed owner, address indexed operator, bool approved); /** * @dev Returns the number of tokens in `owner`'s account. */ function balanceOf(address owner) external view returns (uint256 balance); /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) external view returns (address owner); /** * @dev Safely transfers `tokenId` token from `from` to `to`, * checking first that contract recipients are aware of the ERC721 protocol * to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be have been allowed to move * this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes calldata data ) external payable; /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom( address from, address to, uint256 tokenId ) external payable; /** * @dev Transfers `tokenId` from `from` to `to`. * * WARNING: Usage of this method is discouraged, use {safeTransferFrom} * whenever possible. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) external payable; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the * zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external payable; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} * for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool _approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll}. */ function isApprovedForAll(address owner, address operator) external view returns (bool); // ============================================================= // IERC721Metadata // ============================================================= /** * @dev Returns the token collection name. */ function name() external view returns (string memory); /** * @dev Returns the token collection symbol. */ function symbol() external view returns (string memory); /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) external view returns (string memory); // ============================================================= // IERC2309 // ============================================================= /** * @dev Emitted when tokens in `fromTokenId` to `toTokenId` * (inclusive) is transferred from `from` to `to`, as defined in the * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard. * * See {_mintERC2309} for more details. */ event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.22; import {ERC2981} from "solady/src/tokens/ERC2981.sol"; import {Ownable} from "solady/src/auth/Ownable.sol"; import {IERC721A} from "erc721a/contracts/IERC721A.sol"; import {ERC721AConduitPreapprovedCloneable} from "./ERC721AConduitPreapprovedCloneable.sol"; import {ERC721ACloneable} from "./ERC721ACloneable.sol"; import {IERC721MagicDropMetadata} from "../interfaces/IERC721MagicDropMetadata.sol"; /// @title ERC721MagicDropMetadataCloneable /// @notice A cloneable ERC-721A implementation that supports adjustable metadata URIs, royalty configuration. /// Inherits conduit-based preapprovals, making distribution more gas-efficient. contract ERC721MagicDropMetadataCloneable is ERC721AConduitPreapprovedCloneable, IERC721MagicDropMetadata, ERC2981, Ownable { /*============================================================== = INITIALIZERS = ==============================================================*/ /// @notice Initializes the contract. /// @dev This function is called by the initializer of the parent contract. /// @param owner The address of the contract owner. function __ERC721MagicDropMetadataCloneable__init(address owner) internal onlyInitializing { _initializeOwner(owner); emit MagicDropTokenDeployed(); } /*============================================================== = STORAGE = ==============================================================*/ /// @notice The base URI used to construct `tokenURI` results. /// @dev This value can be updated by the contract owner. Typically points to an off-chain IPFS/HTTPS endpoint. string internal _tokenBaseURI; /// @notice A URI providing contract-level metadata (e.g., for marketplaces). /// @dev Can be updated by the owner. Often returns metadata in a JSON format describing the project. string internal _contractURI; /// @notice The maximum total number of tokens that can ever be minted. /// @dev Acts as a cap on supply. Decreasing is allowed (if no tokens are over that limit), /// but increasing supply is forbidden after initialization. uint256 internal _maxSupply; /// @notice The per-wallet minting limit, restricting how many tokens a single address can mint. uint256 internal _walletLimit; /// @notice The address receiving royalty payments. address internal _royaltyReceiver; /// @notice The royalty amount (in basis points) for secondary sales (e.g., 100 = 1%). uint96 internal _royaltyBps; /*============================================================== = PUBLIC VIEW METHODS = ==============================================================*/ /// @notice Returns the current base URI used to construct token URIs. /// @return The base URI as a string. function baseURI() public view override returns (string memory) { return _tokenBaseURI; } /// @notice Returns a URI representing contract-level metadata, often used by marketplaces. /// @return The contract-level metadata URI. function contractURI() public view override returns (string memory) { return _contractURI; } /// @notice The maximum number of tokens that can ever be minted by this contract. /// @return The maximum supply of tokens. function maxSupply() public view returns (uint256) { return _maxSupply; } /// @notice The maximum number of tokens any single wallet can mint. /// @return The minting limit per wallet. function walletLimit() public view returns (uint256) { return _walletLimit; } /// @notice The address designated to receive royalty payments on secondary sales. /// @return The royalty receiver address. function royaltyAddress() public view returns (address) { return _royaltyReceiver; } /// @notice The royalty rate in basis points (e.g. 100 = 1%) for secondary sales. /// @return The royalty fee in basis points. function royaltyBps() public view returns (uint256) { return _royaltyBps; } /// @notice Returns the total number of tokens minted by a specific address. /// @param user The address to query. /// @return The total number of tokens minted by the specified address. function totalMintedByUser(address user) public view returns (uint256) { return _numberMinted(user); } /// @notice Indicates whether this contract implements a given interface. /// @dev Supports ERC-2981 (royalties) and ERC-4906 (batch metadata updates), in addition to inherited interfaces. /// @param interfaceId The interface ID to check for compliance. /// @return True if the contract implements the specified interface, otherwise false. function supportsInterface(bytes4 interfaceId) public view virtual override(ERC2981, ERC721ACloneable, IERC721A) returns (bool) { return interfaceId == 0x2a55205a // ERC-2981 royalties || interfaceId == 0x49064906 // ERC-4906 metadata updates || ERC721ACloneable.supportsInterface(interfaceId); } /*============================================================== = ADMIN OPERATIONS = ==============================================================*/ /// @notice Sets a new base URI for token metadata, affecting all tokens. /// @dev Emits a batch metadata update event if there are already minted tokens. /// @param newBaseURI The new base URI. function setBaseURI(string calldata newBaseURI) external override onlyOwner { _setBaseURI(newBaseURI); } /// @notice Updates the contract-level metadata URI. /// @dev Useful for marketplaces to display project details. /// @param newContractURI The new contract metadata URI. function setContractURI(string calldata newContractURI) external override onlyOwner { _setContractURI(newContractURI); emit ContractURIUpdated(newContractURI); } /// @notice Adjusts the maximum token supply. /// @dev Cannot increase beyond the original max supply. Cannot set below the current minted amount. /// @param newMaxSupply The new maximum supply. function setMaxSupply(uint256 newMaxSupply) external onlyOwner { _setMaxSupply(newMaxSupply); } /// @notice Updates the per-wallet minting limit. /// @dev This can be changed at any time to adjust distribution constraints. /// @param newWalletLimit The new per-wallet limit on minted tokens. function setWalletLimit(uint256 newWalletLimit) external onlyOwner { _setWalletLimit(newWalletLimit); } /// @notice Configures the royalty information for secondary sales. /// @dev Sets a new receiver and basis points for royalties. Basis points define the percentage rate. /// @param newReceiver The address to receive royalties. /// @param newBps The royalty rate in basis points (e.g., 100 = 1%). function setRoyaltyInfo(address newReceiver, uint96 newBps) external onlyOwner { _setRoyaltyInfo(newReceiver, newBps); } /// @notice Emits an event to notify clients of metadata changes for a specific token range. /// @dev Useful for updating external indexes after significant metadata alterations. /// @param fromTokenId The starting token ID in the updated range. /// @param toTokenId The ending token ID in the updated range. function emitBatchMetadataUpdate(uint256 fromTokenId, uint256 toTokenId) external onlyOwner { emit BatchMetadataUpdate(fromTokenId, toTokenId); } /*============================================================== = INTERNAL HELPERS = ==============================================================*/ /// @notice Internal function returning the current base URI for token metadata. /// @return The current base URI string. function _baseURI() internal view override returns (string memory) { return _tokenBaseURI; } /// @notice Internal function setting the base URI for token metadata. /// @param newBaseURI The new base URI string. function _setBaseURI(string calldata newBaseURI) internal { _tokenBaseURI = newBaseURI; if (totalSupply() != 0) { // Notify EIP-4906 compliant observers of a metadata update. emit BatchMetadataUpdate(0, totalSupply() - 1); } } /// @notice Internal function setting the maximum token supply. /// @dev Cannot increase beyond the original max supply. Cannot set below the current minted amount. /// @param newMaxSupply The new maximum supply. function _setMaxSupply(uint256 newMaxSupply) internal { if (_maxSupply != 0 && newMaxSupply > _maxSupply) { revert MaxSupplyCannotBeIncreased(); } if (newMaxSupply < _totalMinted()) { revert MaxSupplyCannotBeLessThanCurrentSupply(); } if (newMaxSupply > 2 ** 64 - 1) { revert MaxSupplyCannotBeGreaterThan2ToThe64thPower(); } _maxSupply = newMaxSupply; emit MaxSupplyUpdated(newMaxSupply); } /// @notice Internal function setting the per-wallet minting limit. /// @param newWalletLimit The new per-wallet limit on minted tokens. function _setWalletLimit(uint256 newWalletLimit) internal { _walletLimit = newWalletLimit; emit WalletLimitUpdated(newWalletLimit); } /// @notice Internal function setting the royalty information. /// @param newReceiver The address to receive royalties. /// @param newBps The royalty rate in basis points (e.g., 100 = 1%). function _setRoyaltyInfo(address newReceiver, uint96 newBps) internal { _royaltyReceiver = newReceiver; _royaltyBps = newBps; super._setDefaultRoyalty(_royaltyReceiver, _royaltyBps); emit RoyaltyInfoUpdated(_royaltyReceiver, _royaltyBps); } /// @notice Internal function setting the contract URI. /// @param newContractURI The new contract metadata URI. function _setContractURI(string calldata newContractURI) internal { _contractURI = newContractURI; emit ContractURIUpdated(newContractURI); } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; import {IERC721A} from "erc721a/contracts/IERC721A.sol"; import {Initializable} from "solady/src/utils/Initializable.sol"; /** * @dev Interface of ERC721 token receiver. */ interface ERC721A__IERC721Receiver { function onERC721Received(address operator, address from, uint256 tokenId, bytes calldata data) external returns (bytes4); } /** * @title ERC721ACloneable * * @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721) * Non-Fungible Token Standard, including the Metadata extension. * Optimized for lower gas during batch mints. * * Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...) * starting from `_startTokenId()`. * * The `_sequentialUpTo()` function can be overriden to enable spot mints * (i.e. non-consecutive mints) for `tokenId`s greater than `_sequentialUpTo()`. * * Assumptions: * * - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply. * - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256). */ contract ERC721ACloneable is IERC721A, Initializable { // Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364). struct TokenApprovalRef { address value; } // ============================================================= // CONSTANTS // ============================================================= // Mask of an entry in packed address data. uint256 private constant _BITMASK_ADDRESS_DATA_ENTRY = (1 << 64) - 1; // The bit position of `numberMinted` in packed address data. uint256 private constant _BITPOS_NUMBER_MINTED = 64; // The bit position of `numberBurned` in packed address data. uint256 private constant _BITPOS_NUMBER_BURNED = 128; // The bit position of `aux` in packed address data. uint256 private constant _BITPOS_AUX = 192; // Mask of all 256 bits in packed address data except the 64 bits for `aux`. uint256 private constant _BITMASK_AUX_COMPLEMENT = (1 << 192) - 1; // The bit position of `startTimestamp` in packed ownership. uint256 private constant _BITPOS_START_TIMESTAMP = 160; // The bit mask of the `burned` bit in packed ownership. uint256 private constant _BITMASK_BURNED = 1 << 224; // The bit position of the `nextInitialized` bit in packed ownership. uint256 private constant _BITPOS_NEXT_INITIALIZED = 225; // The bit mask of the `nextInitialized` bit in packed ownership. uint256 private constant _BITMASK_NEXT_INITIALIZED = 1 << 225; // The bit position of `extraData` in packed ownership. uint256 private constant _BITPOS_EXTRA_DATA = 232; // Mask of all 256 bits in a packed ownership except the 24 bits for `extraData`. uint256 private constant _BITMASK_EXTRA_DATA_COMPLEMENT = (1 << 232) - 1; // The mask of the lower 160 bits for addresses. uint256 private constant _BITMASK_ADDRESS = (1 << 160) - 1; // The maximum `quantity` that can be minted with {_mintERC2309}. // This limit is to prevent overflows on the address data entries. // For a limit of 5000, a total of 3.689e15 calls to {_mintERC2309} // is required to cause an overflow, which is unrealistic. uint256 private constant _MAX_MINT_ERC2309_QUANTITY_LIMIT = 5000; // The `Transfer` event signature is given by: // `keccak256(bytes("Transfer(address,address,uint256)"))`. bytes32 private constant _TRANSFER_EVENT_SIGNATURE = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef; // ============================================================= // STORAGE // ============================================================= // The next token ID to be minted. uint256 private _currentIndex; // The number of tokens burned. uint256 private _burnCounter; // Token name string private _name; // Token symbol string private _symbol; // Mapping from token ID to ownership details // An empty struct value does not necessarily mean the token is unowned. // See {_packedOwnershipOf} implementation for details. // // Bits Layout: // - [0..159] `addr` // - [160..223] `startTimestamp` // - [224] `burned` // - [225] `nextInitialized` // - [232..255] `extraData` mapping(uint256 => uint256) private _packedOwnerships; // Mapping owner address to address data. // // Bits Layout: // - [0..63] `balance` // - [64..127] `numberMinted` // - [128..191] `numberBurned` // - [192..255] `aux` mapping(address => uint256) private _packedAddressData; // Mapping from token ID to approved address. mapping(uint256 => TokenApprovalRef) private _tokenApprovals; // Mapping from owner to operator approvals mapping(address => mapping(address => bool)) private _operatorApprovals; // The amount of tokens minted above `_sequentialUpTo()`. // We call these spot mints (i.e. non-sequential mints). uint256 private _spotMinted; // ============================================================= // INITIALIZER // ============================================================= function __ERC721ACloneable__init(string memory name_, string memory symbol_) internal onlyInitializing { _name = name_; _symbol = symbol_; _currentIndex = _startTokenId(); if (_sequentialUpTo() < _startTokenId()) { _revert(SequentialUpToTooSmall.selector); } } // ============================================================= // TOKEN COUNTING OPERATIONS // ============================================================= /** * @dev Returns the starting token ID for sequential mints. * * Override this function to change the starting token ID for sequential mints. * * Note: The value returned must never change after any tokens have been minted. */ function _startTokenId() internal view virtual returns (uint256) { return 0; } /** * @dev Returns the maximum token ID (inclusive) for sequential mints. * * Override this function to return a value less than 2**256 - 1, * but greater than `_startTokenId()`, to enable spot (non-sequential) mints. * * Note: The value returned must never change after any tokens have been minted. */ function _sequentialUpTo() internal view virtual returns (uint256) { return type(uint256).max; } /** * @dev Returns the next token ID to be minted. */ function _nextTokenId() internal view virtual returns (uint256) { return _currentIndex; } /** * @dev Returns the total number of tokens in existence. * Burned tokens will reduce the count. * To get the total number of tokens minted, please see {_totalMinted}. */ function totalSupply() public view virtual override returns (uint256 result) { // Counter underflow is impossible as `_burnCounter` cannot be incremented // more than `_currentIndex + _spotMinted - _startTokenId()` times. unchecked { // With spot minting, the intermediate `result` can be temporarily negative, // and the computation must be unchecked. result = _currentIndex - _burnCounter - _startTokenId(); if (_sequentialUpTo() != type(uint256).max) result += _spotMinted; } } /** * @dev Returns the total amount of tokens minted in the contract. */ function _totalMinted() internal view virtual returns (uint256 result) { // Counter underflow is impossible as `_currentIndex` does not decrement, // and it is initialized to `_startTokenId()`. unchecked { result = _currentIndex - _startTokenId(); if (_sequentialUpTo() != type(uint256).max) result += _spotMinted; } } /** * @dev Returns the total number of tokens burned. */ function _totalBurned() internal view virtual returns (uint256) { return _burnCounter; } /** * @dev Returns the total number of tokens that are spot-minted. */ function _totalSpotMinted() internal view virtual returns (uint256) { return _spotMinted; } // ============================================================= // ADDRESS DATA OPERATIONS // ============================================================= /** * @dev Returns the number of tokens in `owner`'s account. */ function balanceOf(address owner) public view virtual override returns (uint256) { if (owner == address(0)) _revert(BalanceQueryForZeroAddress.selector); return _packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens minted by `owner`. */ function _numberMinted(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens burned by or on behalf of `owner`. */ function _numberBurned(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). */ function _getAux(address owner) internal view returns (uint64) { return uint64(_packedAddressData[owner] >> _BITPOS_AUX); } /** * Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). * If there are multiple variables, please pack them into a uint64. */ function _setAux(address owner, uint64 aux) internal virtual { uint256 packed = _packedAddressData[owner]; uint256 auxCasted; // Cast `aux` with assembly to avoid redundant masking. assembly { auxCasted := aux } packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX); _packedAddressData[owner] = packed; } // ============================================================= // IERC165 // ============================================================= /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified) * to learn more about how these ids are created. * * This function call must use less than 30000 gas. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { // The interface IDs are constants representing the first 4 bytes // of the XOR of all function selectors in the interface. // See: [ERC165](https://eips.ethereum.org/EIPS/eip-165) // (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`) return interfaceId == 0x01ffc9a7 // ERC165 interface ID for ERC165. || interfaceId == 0x80ac58cd // ERC165 interface ID for ERC721. || interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata. } // ============================================================= // IERC721Metadata // ============================================================= /** * @dev Returns the token collection name. */ function name() public view virtual override returns (string memory) { return _name; } /** * @dev Returns the token collection symbol. */ function symbol() public view virtual override returns (string memory) { return _symbol; } /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) public view virtual override returns (string memory) { if (!_exists(tokenId)) _revert(URIQueryForNonexistentToken.selector); string memory baseURI = _baseURI(); return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : ""; } /** * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each * token will be the concatenation of the `baseURI` and the `tokenId`. Empty * by default, it can be overridden in child contracts. */ function _baseURI() internal view virtual returns (string memory) { return ""; } // ============================================================= // OWNERSHIPS OPERATIONS // ============================================================= /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) public view virtual override returns (address) { return address(uint160(_packedOwnershipOf(tokenId))); } /** * @dev Gas spent here starts off proportional to the maximum mint batch size. * It gradually moves to O(1) as tokens get transferred around over time. */ function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnershipOf(tokenId)); } /** * @dev Returns the unpacked `TokenOwnership` struct at `index`. */ function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnerships[index]); } /** * @dev Returns whether the ownership slot at `index` is initialized. * An uninitialized slot does not necessarily mean that the slot has no owner. */ function _ownershipIsInitialized(uint256 index) internal view virtual returns (bool) { return _packedOwnerships[index] != 0; } /** * @dev Initializes the ownership slot minted at `index` for efficiency purposes. */ function _initializeOwnershipAt(uint256 index) internal virtual { if (_packedOwnerships[index] == 0) { _packedOwnerships[index] = _packedOwnershipOf(index); } } /** * @dev Returns the packed ownership data of `tokenId`. */ function _packedOwnershipOf(uint256 tokenId) private view returns (uint256 packed) { if (_startTokenId() <= tokenId) { packed = _packedOwnerships[tokenId]; if (tokenId > _sequentialUpTo()) { if (_packedOwnershipExists(packed)) return packed; _revert(OwnerQueryForNonexistentToken.selector); } // If the data at the starting slot does not exist, start the scan. if (packed == 0) { if (tokenId >= _currentIndex) { _revert(OwnerQueryForNonexistentToken.selector); } // Invariant: // There will always be an initialized ownership slot // (i.e. `ownership.addr != address(0) && ownership.burned == false`) // before an unintialized ownership slot // (i.e. `ownership.addr == address(0) && ownership.burned == false`) // Hence, `tokenId` will not underflow. // // We can directly compare the packed value. // If the address is zero, packed will be zero. for (;;) { unchecked { packed = _packedOwnerships[--tokenId]; } if (packed == 0) continue; if (packed & _BITMASK_BURNED == 0) return packed; // Otherwise, the token is burned, and we must revert. // This handles the case of batch burned tokens, where only the burned bit // of the starting slot is set, and remaining slots are left uninitialized. _revert(OwnerQueryForNonexistentToken.selector); } } // Otherwise, the data exists and we can skip the scan. // This is possible because we have already achieved the target condition. // This saves 2143 gas on transfers of initialized tokens. // If the token is not burned, return `packed`. Otherwise, revert. if (packed & _BITMASK_BURNED == 0) return packed; } _revert(OwnerQueryForNonexistentToken.selector); } /** * @dev Returns the unpacked `TokenOwnership` struct from `packed`. */ function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) { ownership.addr = address(uint160(packed)); ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP); ownership.burned = packed & _BITMASK_BURNED != 0; ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA); } /** * @dev Packs ownership data into a single uint256. */ function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`. result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags)) } } /** * @dev Returns the `nextInitialized` flag set if `quantity` equals 1. */ function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) { // For branchless setting of the `nextInitialized` flag. assembly { // `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`. result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1)) } } // ============================================================= // APPROVAL OPERATIONS // ============================================================= /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. See {ERC721A-_approve}. * * Requirements: * * - The caller must own the token or be an approved operator. */ function approve(address to, uint256 tokenId) public payable virtual override { _approve(to, tokenId, true); } /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) public view virtual override returns (address) { if (!_exists(tokenId)) { _revert(ApprovalQueryForNonexistentToken.selector); } return _tokenApprovals[tokenId].value; } /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} * for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool approved) public virtual override { _operatorApprovals[_msgSenderERC721A()][operator] = approved; emit ApprovalForAll(_msgSenderERC721A(), operator, approved); } /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll}. */ function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) { return _operatorApprovals[owner][operator]; } /** * @dev Returns whether `tokenId` exists. * * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}. * * Tokens start existing when they are minted. See {_mint}. */ function _exists(uint256 tokenId) internal view virtual returns (bool result) { if (_startTokenId() <= tokenId) { if (tokenId > _sequentialUpTo()) { return _packedOwnershipExists(_packedOwnerships[tokenId]); } if (tokenId < _currentIndex) { uint256 packed; while ((packed = _packedOwnerships[tokenId]) == 0) --tokenId; result = packed & _BITMASK_BURNED == 0; } } } /** * @dev Returns whether `packed` represents a token that exists. */ function _packedOwnershipExists(uint256 packed) private pure returns (bool result) { assembly { // The following is equivalent to `owner != address(0) && burned == false`. // Symbolically tested. result := gt(and(packed, _BITMASK_ADDRESS), and(packed, _BITMASK_BURNED)) } } /** * @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`. */ function _isSenderApprovedOrOwner(address approvedAddress, address owner, address msgSender) private pure returns (bool result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean. msgSender := and(msgSender, _BITMASK_ADDRESS) // `msgSender == owner || msgSender == approvedAddress`. result := or(eq(msgSender, owner), eq(msgSender, approvedAddress)) } } /** * @dev Returns the storage slot and value for the approved address of `tokenId`. */ function _getApprovedSlotAndAddress(uint256 tokenId) private view returns (uint256 approvedAddressSlot, address approvedAddress) { TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId]; // The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`. assembly { approvedAddressSlot := tokenApproval.slot approvedAddress := sload(approvedAddressSlot) } } // ============================================================= // TRANSFER OPERATIONS // ============================================================= /** * @dev Transfers `tokenId` from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom(address from, address to, uint256 tokenId) public payable virtual override { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); // Mask `from` to the lower 160 bits, in case the upper bits somehow aren't clean. from = address(uint160(uint256(uint160(from)) & _BITMASK_ADDRESS)); if (address(uint160(prevOwnershipPacked)) != from) { _revert(TransferFromIncorrectOwner.selector); } (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId); // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A())) { if (!isApprovedForAll(from, _msgSenderERC721A())) { _revert(TransferCallerNotOwnerNorApproved.selector); } } _beforeTokenTransfers(from, to, tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // We can directly increment and decrement the balances. --_packedAddressData[from]; // Updates: `balance -= 1`. ++_packedAddressData[to]; // Updates: `balance += 1`. // Updates: // - `address` to the next owner. // - `startTimestamp` to the timestamp of transfering. // - `burned` to `false`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData(to, _BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked)); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS; assembly { // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. from, // `from`. toMasked, // `to`. tokenId // `tokenId`. ) } if (toMasked == 0) _revert(TransferToZeroAddress.selector); _afterTokenTransfers(from, to, tokenId, 1); } /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom(address from, address to, uint256 tokenId) public payable virtual override { safeTransferFrom(from, to, tokenId, ""); } /** * @dev Safely transfers `tokenId` token from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory _data) public payable virtual override { transferFrom(from, to, tokenId); if (to.code.length != 0) { if (!_checkContractOnERC721Received(from, to, tokenId, _data)) { _revert(TransferToNonERC721ReceiverImplementer.selector); } } } /** * @dev Hook that is called before a set of serially-ordered token IDs * are about to be transferred. This includes minting. * And also called before burning one token. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _beforeTokenTransfers(address from, address to, uint256 startTokenId, uint256 quantity) internal virtual {} /** * @dev Hook that is called after a set of serially-ordered token IDs * have been transferred. This includes minting. * And also called after one token has been burned. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` has been * transferred to `to`. * - When `from` is zero, `tokenId` has been minted for `to`. * - When `to` is zero, `tokenId` has been burned by `from`. * - `from` and `to` are never both zero. */ function _afterTokenTransfers(address from, address to, uint256 startTokenId, uint256 quantity) internal virtual {} /** * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract. * * `from` - Previous owner of the given token ID. * `to` - Target address that will receive the token. * `tokenId` - Token ID to be transferred. * `_data` - Optional data to send along with the call. * * Returns whether the call correctly returned the expected magic value. */ function _checkContractOnERC721Received(address from, address to, uint256 tokenId, bytes memory _data) private returns (bool) { try ERC721A__IERC721Receiver(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns ( bytes4 retval ) { return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector; } catch (bytes memory reason) { if (reason.length == 0) { _revert(TransferToNonERC721ReceiverImplementer.selector); } assembly { revert(add(32, reason), mload(reason)) } } } // ============================================================= // MINT OPERATIONS // ============================================================= /** * @dev Mints `quantity` tokens and transfers them to `to`. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {Transfer} event for each mint. */ function _mint(address to, uint256 quantity) internal virtual { uint256 startTokenId = _currentIndex; if (quantity == 0) _revert(MintZeroQuantity.selector); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are incredibly unrealistic. // `balance` and `numberMinted` have a maximum limit of 2**64. // `tokenId` has a maximum limit of 2**256. unchecked { // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData(to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)); // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1); // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS; if (toMasked == 0) _revert(MintToZeroAddress.selector); uint256 end = startTokenId + quantity; uint256 tokenId = startTokenId; if (end - 1 > _sequentialUpTo()) { _revert(SequentialMintExceedsLimit.selector); } do { assembly { // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. 0, // `address(0)`. toMasked, // `to`. tokenId // `tokenId`. ) } // The `!=` check ensures that large values of `quantity` // that overflows uint256 will make the loop run out of gas. } while (++tokenId != end); _currentIndex = end; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev Mints `quantity` tokens and transfers them to `to`. * * This function is intended for efficient minting only during contract creation. * * It emits only one {ConsecutiveTransfer} as defined in * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309), * instead of a sequence of {Transfer} event(s). * * Calling this function outside of contract creation WILL make your contract * non-compliant with the ERC721 standard. * For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309 * {ConsecutiveTransfer} event is only permissible during contract creation. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {ConsecutiveTransfer} event. */ function _mintERC2309(address to, uint256 quantity) internal virtual { uint256 startTokenId = _currentIndex; if (to == address(0)) _revert(MintToZeroAddress.selector); if (quantity == 0) _revert(MintZeroQuantity.selector); if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) { _revert(MintERC2309QuantityExceedsLimit.selector); } _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are unrealistic due to the above check for `quantity` to be below the limit. unchecked { // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1); // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData(to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)); if (startTokenId + quantity - 1 > _sequentialUpTo()) { _revert(SequentialMintExceedsLimit.selector); } emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to); _currentIndex = startTokenId + quantity; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev Safely mints `quantity` tokens and transfers them to `to`. * * Requirements: * * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called for each safe transfer. * - `quantity` must be greater than 0. * * See {_mint}. * * Emits a {Transfer} event for each mint. */ function _safeMint(address to, uint256 quantity, bytes memory _data) internal virtual { _mint(to, quantity); unchecked { if (to.code.length != 0) { uint256 end = _currentIndex; uint256 index = end - quantity; do { if (!_checkContractOnERC721Received(address(0), to, index++, _data)) { _revert(TransferToNonERC721ReceiverImplementer.selector); } } while (index < end); // This prevents reentrancy to `_safeMint`. // It does not prevent reentrancy to `_safeMintSpot`. if (_currentIndex != end) revert(); } } } /** * @dev Equivalent to `_safeMint(to, quantity, '')`. */ function _safeMint(address to, uint256 quantity) internal virtual { _safeMint(to, quantity, ""); } /** * @dev Mints a single token at `tokenId`. * * Note: A spot-minted `tokenId` that has been burned can be re-minted again. * * Requirements: * * - `to` cannot be the zero address. * - `tokenId` must be greater than `_sequentialUpTo()`. * - `tokenId` must not exist. * * Emits a {Transfer} event for each mint. */ function _mintSpot(address to, uint256 tokenId) internal virtual { if (tokenId <= _sequentialUpTo()) { _revert(SpotMintTokenIdTooSmall.selector); } uint256 prevOwnershipPacked = _packedOwnerships[tokenId]; if (_packedOwnershipExists(prevOwnershipPacked)) { _revert(TokenAlreadyExists.selector); } _beforeTokenTransfers(address(0), to, tokenId, 1); // Overflows are incredibly unrealistic. // The `numberMinted` for `to` is incremented by 1, and has a max limit of 2**64 - 1. // `_spotMinted` is incremented by 1, and has a max limit of 2**256 - 1. unchecked { // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `true` (as `quantity == 1`). _packedOwnerships[tokenId] = _packOwnershipData(to, _nextInitializedFlag(1) | _nextExtraData(address(0), to, prevOwnershipPacked)); // Updates: // - `balance += 1`. // - `numberMinted += 1`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += (1 << _BITPOS_NUMBER_MINTED) | 1; // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS; if (toMasked == 0) _revert(MintToZeroAddress.selector); assembly { // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. 0, // `address(0)`. toMasked, // `to`. tokenId // `tokenId`. ) } ++_spotMinted; } _afterTokenTransfers(address(0), to, tokenId, 1); } /** * @dev Safely mints a single token at `tokenId`. * * Note: A spot-minted `tokenId` that has been burned can be re-minted again. * * Requirements: * * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}. * - `tokenId` must be greater than `_sequentialUpTo()`. * - `tokenId` must not exist. * * See {_mintSpot}. * * Emits a {Transfer} event. */ function _safeMintSpot(address to, uint256 tokenId, bytes memory _data) internal virtual { _mintSpot(to, tokenId); unchecked { if (to.code.length != 0) { uint256 currentSpotMinted = _spotMinted; if (!_checkContractOnERC721Received(address(0), to, tokenId, _data)) { _revert(TransferToNonERC721ReceiverImplementer.selector); } // This prevents reentrancy to `_safeMintSpot`. // It does not prevent reentrancy to `_safeMint`. if (_spotMinted != currentSpotMinted) revert(); } } } /** * @dev Equivalent to `_safeMintSpot(to, tokenId, '')`. */ function _safeMintSpot(address to, uint256 tokenId) internal virtual { _safeMintSpot(to, tokenId, ""); } // ============================================================= // APPROVAL OPERATIONS // ============================================================= /** * @dev Equivalent to `_approve(to, tokenId, false)`. */ function _approve(address to, uint256 tokenId) internal virtual { _approve(to, tokenId, false); } /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the * zero address clears previous approvals. * * Requirements: * * - `tokenId` must exist. * * Emits an {Approval} event. */ function _approve(address to, uint256 tokenId, bool approvalCheck) internal virtual { address owner = ownerOf(tokenId); if (approvalCheck && _msgSenderERC721A() != owner) { if (!isApprovedForAll(owner, _msgSenderERC721A())) { _revert(ApprovalCallerNotOwnerNorApproved.selector); } } _tokenApprovals[tokenId].value = to; emit Approval(owner, to, tokenId); } // ============================================================= // BURN OPERATIONS // ============================================================= /** * @dev Equivalent to `_burn(tokenId, false)`. */ function _burn(uint256 tokenId) internal virtual { _burn(tokenId, false); } /** * @dev Destroys `tokenId`. * The approval is cleared when the token is burned. * * Requirements: * * - `tokenId` must exist. * * Emits a {Transfer} event. */ function _burn(uint256 tokenId, bool approvalCheck) internal virtual { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); address from = address(uint160(prevOwnershipPacked)); (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId); if (approvalCheck) { // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A())) { if (!isApprovedForAll(from, _msgSenderERC721A())) { _revert(TransferCallerNotOwnerNorApproved.selector); } } } _beforeTokenTransfers(from, address(0), tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // Updates: // - `balance -= 1`. // - `numberBurned += 1`. // // We can directly decrement the balance, and increment the number burned. // This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`. _packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1; // Updates: // - `address` to the last owner. // - `startTimestamp` to the timestamp of burning. // - `burned` to `true`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData( from, (_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked) ); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } emit Transfer(from, address(0), tokenId); _afterTokenTransfers(from, address(0), tokenId, 1); // Overflow not possible, as `_burnCounter` cannot be exceed `_currentIndex + _spotMinted` times. unchecked { _burnCounter++; } } // ============================================================= // EXTRA DATA OPERATIONS // ============================================================= /** * @dev Directly sets the extra data for the ownership data `index`. */ function _setExtraDataAt(uint256 index, uint24 extraData) internal virtual { uint256 packed = _packedOwnerships[index]; if (packed == 0) _revert(OwnershipNotInitializedForExtraData.selector); uint256 extraDataCasted; // Cast `extraData` with assembly to avoid redundant masking. assembly { extraDataCasted := extraData } packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA); _packedOwnerships[index] = packed; } /** * @dev Called during each token transfer to set the 24bit `extraData` field. * Intended to be overridden by the cosumer contract. * * `previousExtraData` - the value of `extraData` before transfer. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _extraData(address from, address to, uint24 previousExtraData) internal view virtual returns (uint24) {} /** * @dev Returns the next extra data for the packed ownership data. * The returned result is shifted into position. */ function _nextExtraData(address from, address to, uint256 prevOwnershipPacked) private view returns (uint256) { uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA); return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA; } // ============================================================= // OTHER OPERATIONS // ============================================================= /** * @dev Returns the message sender (defaults to `msg.sender`). * * If you are writing GSN compatible contracts, you need to override this function. */ function _msgSenderERC721A() internal view virtual returns (address) { return msg.sender; } /** * @dev Converts a uint256 to its ASCII string decimal representation. */ function _toString(uint256 value) internal pure virtual returns (string memory str) { assembly { // The maximum value of a uint256 contains 78 digits (1 byte per digit), but // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned. // We will need 1 word for the trailing zeros padding, 1 word for the length, // and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0. let m := add(mload(0x40), 0xa0) // Update the free memory pointer to allocate. mstore(0x40, m) // Assign the `str` to the end. str := sub(m, 0x20) // Zeroize the slot after the string. mstore(str, 0) // Cache the end of the memory to calculate the length later. let end := str // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. // prettier-ignore for { let temp := value } 1 {} { str := sub(str, 1) // Write the character to the pointer. // The ASCII index of the '0' character is 48. mstore8(str, add(48, mod(temp, 10))) // Keep dividing `temp` until zero. temp := div(temp, 10) // prettier-ignore if iszero(temp) { break } } let length := sub(end, str) // Move the pointer 32 bytes leftwards to make room for the length. str := sub(str, 0x20) // Store the length. mstore(str, length) } } /** * @dev For more efficient reverts. */ function _revert(bytes4 errorSelector) internal pure { assembly { mstore(0x00, errorSelector) revert(0x00, 0x04) } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.22; import {IMagicDropMetadata} from "contracts/common/interfaces/IMagicDropMetadata.sol"; interface IERC721MagicDropMetadata is IMagicDropMetadata { /// @notice Emitted when the wallet limit is updated. /// @param _walletLimit The new wallet limit. event WalletLimitUpdated(uint256 _walletLimit); /// @notice Emitted when the max supply is updated. /// @param newMaxSupply The new max supply. event MaxSupplyUpdated(uint256 newMaxSupply); /// @notice Thrown when a mint would exceed the wallet-specific minting limit. error WalletLimitExceeded(); /// @notice Returns the maximum number of tokens that can be minted per wallet /// @dev Used to prevent excessive concentration of tokens in single wallets /// @return The maximum number of tokens allowed per wallet address function walletLimit() external view returns (uint256); /// @notice Returns the maximum number of tokens that can be minted /// @dev This value cannot be increased once set, only decreased /// @return The maximum supply cap for the collection function maxSupply() external view returns (uint256); /// @notice Updates the per-wallet token holding limit /// @dev Used to prevent token concentration and ensure fair distribution /// Setting this to 0 effectively removes the wallet limit /// @param walletLimit The new maximum number of tokens allowed per wallet function setWalletLimit(uint256 walletLimit) external; /// @notice Updates the maximum supply cap for the collection /// @dev Can only decrease the max supply, never increase it /// Must be greater than or equal to the current total supply /// @param maxSupply The new maximum number of tokens that can be minted function setMaxSupply(uint256 maxSupply) external; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; struct PublicStage { /// @dev The start time of the public mint stage. uint256 startTime; /// @dev The end time of the public mint stage. uint256 endTime; /// @dev The price of the public mint stage. uint256 price; } struct AllowlistStage { /// @dev The start time of the allowlist mint stage. uint256 startTime; /// @dev The end time of the allowlist mint stage. uint256 endTime; /// @dev The price of the allowlist mint stage. uint256 price; /// @dev The merkle root of the allowlist. bytes32 merkleRoot; } struct SetupConfig { /// @dev The maximum number of tokens that can be minted. /// - Can be decreased if current supply < new max supply /// - Cannot be increased once set uint256 maxSupply; /// @dev The maximum number of tokens that can be minted per wallet /// @notice A value of 0 indicates unlimited mints per wallet uint256 walletLimit; /// @dev The base URI of the token. string baseURI; /// @dev The contract URI of the token. string contractURI; /// @dev The public mint stage. PublicStage publicStage; /// @dev The allowlist mint stage. AllowlistStage allowlistStage; /// @dev The payout recipient of the token. address payoutRecipient; /// @dev The royalty recipient of the token. address royaltyRecipient; /// @dev The royalty basis points of the token. uint96 royaltyBps; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.22; address constant CANONICAL_OPERATOR_FILTER_REGISTRY_ADDRESS = 0x000000000000AAeB6D7670E522A718067333cd4E; address constant ME_SUBSCRIPTION = 0x0403c10721Ff2936EfF684Bbb57CD792Fd4b1B6c; address constant MINT_FEE_RECEIVER = 0x0B98151bEdeE73f9Ba5F2C7b72dEa02D38Ce49Fc;
// SPDX-License-Identifier: MIT pragma solidity ^0.8.4; /// @notice A single-use vault that allows a designated caller to withdraw all ETH in it. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/ext/zksync/SingleUseETHVault.sol) contract SingleUseETHVault { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Unable to withdraw all. error WithdrawAllFailed(); /// @dev Not authorized. error Unauthorized(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* WITHDRAW ALL */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ fallback() external payable virtual { /// @solidity memory-safe-assembly assembly { mstore(0x40, 0) // Optimization trick to remove free memory pointer initialization. let owner := sload(0) // Initialization. if iszero(owner) { sstore(0, calldataload(0x00)) // Store the owner. return(0x00, 0x00) // Early return. } // Authorization check. if iszero(eq(caller(), owner)) { mstore(0x00, 0x82b42900) // `Unauthorized()`. revert(0x1c, 0x04) } let to := calldataload(0x00) // If the calldata is less than 32 bytes, zero-left-pad it to 32 bytes. // Then use the rightmost 20 bytes of the word as the `to` address. // This allows for the calldata to be `abi.encode(to)` or `abi.encodePacked(to)`. to := shr(mul(lt(calldatasize(), 0x20), shl(3, sub(0x20, calldatasize()))), to) // If `to` is `address(0)`, set it to `msg.sender`. to := xor(mul(xor(to, caller()), iszero(to)), to) // Transfers the whole balance to `to`. if iszero(call(gas(), to, selfbalance(), 0x00, 0x00, 0x00, 0x00)) { mstore(0x00, 0x651aee10) // `WithdrawAllFailed()`. revert(0x1c, 0x04) } } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.4; /// @notice Simple ERC2981 NFT Royalty Standard implementation. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/tokens/ERC2981.sol) /// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/token/common/ERC2981.sol) abstract contract ERC2981 { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The royalty fee numerator exceeds the fee denominator. error RoyaltyOverflow(); /// @dev The royalty receiver cannot be the zero address. error RoyaltyReceiverIsZeroAddress(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* STORAGE */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The default royalty info is given by: /// ``` /// let packed := sload(_ERC2981_MASTER_SLOT_SEED) /// let receiver := shr(96, packed) /// let royaltyFraction := xor(packed, shl(96, receiver)) /// ``` /// /// The per token royalty info is given by. /// ``` /// mstore(0x00, tokenId) /// mstore(0x20, _ERC2981_MASTER_SLOT_SEED) /// let packed := sload(keccak256(0x00, 0x40)) /// let receiver := shr(96, packed) /// let royaltyFraction := xor(packed, shl(96, receiver)) /// ``` uint256 private constant _ERC2981_MASTER_SLOT_SEED = 0xaa4ec00224afccfdb7; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* ERC2981 */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Checks that `_feeDenominator` is non-zero. constructor() { require(_feeDenominator() != 0, "Fee denominator cannot be zero."); } /// @dev Returns the denominator for the royalty amount. /// Defaults to 10000, which represents fees in basis points. /// Override this function to return a custom amount if needed. function _feeDenominator() internal pure virtual returns (uint96) { return 10000; } /// @dev Returns true if this contract implements the interface defined by `interfaceId`. /// See: https://eips.ethereum.org/EIPS/eip-165 /// This function call must use less than 30000 gas. function supportsInterface(bytes4 interfaceId) public view virtual returns (bool result) { /// @solidity memory-safe-assembly assembly { let s := shr(224, interfaceId) // ERC165: 0x01ffc9a7, ERC2981: 0x2a55205a. result := or(eq(s, 0x01ffc9a7), eq(s, 0x2a55205a)) } } /// @dev Returns the `receiver` and `royaltyAmount` for `tokenId` sold at `salePrice`. function royaltyInfo(uint256 tokenId, uint256 salePrice) public view virtual returns (address receiver, uint256 royaltyAmount) { uint256 feeDenominator = _feeDenominator(); /// @solidity memory-safe-assembly assembly { mstore(0x00, tokenId) mstore(0x20, _ERC2981_MASTER_SLOT_SEED) let packed := sload(keccak256(0x00, 0x40)) receiver := shr(96, packed) if iszero(receiver) { packed := sload(mload(0x20)) receiver := shr(96, packed) } let x := salePrice let y := xor(packed, shl(96, receiver)) // `feeNumerator`. // Overflow check, equivalent to `require(y == 0 || x <= type(uint256).max / y)`. // Out-of-gas revert. Should not be triggered in practice, but included for safety. returndatacopy(returndatasize(), returndatasize(), mul(y, gt(x, div(not(0), y)))) royaltyAmount := div(mul(x, y), feeDenominator) } } /// @dev Sets the default royalty `receiver` and `feeNumerator`. /// /// Requirements: /// - `receiver` must not be the zero address. /// - `feeNumerator` must not be greater than the fee denominator. function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual { uint256 feeDenominator = _feeDenominator(); /// @solidity memory-safe-assembly assembly { feeNumerator := shr(160, shl(160, feeNumerator)) if gt(feeNumerator, feeDenominator) { mstore(0x00, 0x350a88b3) // `RoyaltyOverflow()`. revert(0x1c, 0x04) } let packed := shl(96, receiver) if iszero(packed) { mstore(0x00, 0xb4457eaa) // `RoyaltyReceiverIsZeroAddress()`. revert(0x1c, 0x04) } sstore(_ERC2981_MASTER_SLOT_SEED, or(packed, feeNumerator)) } } /// @dev Sets the default royalty `receiver` and `feeNumerator` to zero. function _deleteDefaultRoyalty() internal virtual { /// @solidity memory-safe-assembly assembly { sstore(_ERC2981_MASTER_SLOT_SEED, 0) } } /// @dev Sets the royalty `receiver` and `feeNumerator` for `tokenId`. /// /// Requirements: /// - `receiver` must not be the zero address. /// - `feeNumerator` must not be greater than the fee denominator. function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual { uint256 feeDenominator = _feeDenominator(); /// @solidity memory-safe-assembly assembly { feeNumerator := shr(160, shl(160, feeNumerator)) if gt(feeNumerator, feeDenominator) { mstore(0x00, 0x350a88b3) // `RoyaltyOverflow()`. revert(0x1c, 0x04) } let packed := shl(96, receiver) if iszero(packed) { mstore(0x00, 0xb4457eaa) // `RoyaltyReceiverIsZeroAddress()`. revert(0x1c, 0x04) } mstore(0x00, tokenId) mstore(0x20, _ERC2981_MASTER_SLOT_SEED) sstore(keccak256(0x00, 0x40), or(packed, feeNumerator)) } } /// @dev Sets the royalty `receiver` and `feeNumerator` for `tokenId` to zero. function _resetTokenRoyalty(uint256 tokenId) internal virtual { /// @solidity memory-safe-assembly assembly { mstore(0x00, tokenId) mstore(0x20, _ERC2981_MASTER_SLOT_SEED) sstore(keccak256(0x00, 0x40), 0) } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.4; /// @notice Simple single owner authorization mixin. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/Ownable.sol) /// /// @dev Note: /// This implementation does NOT auto-initialize the owner to `msg.sender`. /// You MUST call the `_initializeOwner` in the constructor / initializer. /// /// While the ownable portion follows /// [EIP-173](https://eips.ethereum.org/EIPS/eip-173) for compatibility, /// the nomenclature for the 2-step ownership handover may be unique to this codebase. abstract contract Ownable { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The caller is not authorized to call the function. error Unauthorized(); /// @dev The `newOwner` cannot be the zero address. error NewOwnerIsZeroAddress(); /// @dev The `pendingOwner` does not have a valid handover request. error NoHandoverRequest(); /// @dev Cannot double-initialize. error AlreadyInitialized(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The ownership is transferred from `oldOwner` to `newOwner`. /// This event is intentionally kept the same as OpenZeppelin's Ownable to be /// compatible with indexers and [EIP-173](https://eips.ethereum.org/EIPS/eip-173), /// despite it not being as lightweight as a single argument event. event OwnershipTransferred(address indexed oldOwner, address indexed newOwner); /// @dev An ownership handover to `pendingOwner` has been requested. event OwnershipHandoverRequested(address indexed pendingOwner); /// @dev The ownership handover to `pendingOwner` has been canceled. event OwnershipHandoverCanceled(address indexed pendingOwner); /// @dev `keccak256(bytes("OwnershipTransferred(address,address)"))`. uint256 private constant _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE = 0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0; /// @dev `keccak256(bytes("OwnershipHandoverRequested(address)"))`. uint256 private constant _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE = 0xdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d; /// @dev `keccak256(bytes("OwnershipHandoverCanceled(address)"))`. uint256 private constant _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE = 0xfa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* STORAGE */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The owner slot is given by: /// `bytes32(~uint256(uint32(bytes4(keccak256("_OWNER_SLOT_NOT")))))`. /// It is intentionally chosen to be a high value /// to avoid collision with lower slots. /// The choice of manual storage layout is to enable compatibility /// with both regular and upgradeable contracts. bytes32 internal constant _OWNER_SLOT = 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffff74873927; /// The ownership handover slot of `newOwner` is given by: /// ``` /// mstore(0x00, or(shl(96, user), _HANDOVER_SLOT_SEED)) /// let handoverSlot := keccak256(0x00, 0x20) /// ``` /// It stores the expiry timestamp of the two-step ownership handover. uint256 private constant _HANDOVER_SLOT_SEED = 0x389a75e1; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* INTERNAL FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Override to return true to make `_initializeOwner` prevent double-initialization. function _guardInitializeOwner() internal pure virtual returns (bool guard) {} /// @dev Initializes the owner directly without authorization guard. /// This function must be called upon initialization, /// regardless of whether the contract is upgradeable or not. /// This is to enable generalization to both regular and upgradeable contracts, /// and to save gas in case the initial owner is not the caller. /// For performance reasons, this function will not check if there /// is an existing owner. function _initializeOwner(address newOwner) internal virtual { if (_guardInitializeOwner()) { /// @solidity memory-safe-assembly assembly { let ownerSlot := _OWNER_SLOT if sload(ownerSlot) { mstore(0x00, 0x0dc149f0) // `AlreadyInitialized()`. revert(0x1c, 0x04) } // Clean the upper 96 bits. newOwner := shr(96, shl(96, newOwner)) // Store the new value. sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner)))) // Emit the {OwnershipTransferred} event. log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner) } } else { /// @solidity memory-safe-assembly assembly { // Clean the upper 96 bits. newOwner := shr(96, shl(96, newOwner)) // Store the new value. sstore(_OWNER_SLOT, newOwner) // Emit the {OwnershipTransferred} event. log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner) } } } /// @dev Sets the owner directly without authorization guard. function _setOwner(address newOwner) internal virtual { if (_guardInitializeOwner()) { /// @solidity memory-safe-assembly assembly { let ownerSlot := _OWNER_SLOT // Clean the upper 96 bits. newOwner := shr(96, shl(96, newOwner)) // Emit the {OwnershipTransferred} event. log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner) // Store the new value. sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner)))) } } else { /// @solidity memory-safe-assembly assembly { let ownerSlot := _OWNER_SLOT // Clean the upper 96 bits. newOwner := shr(96, shl(96, newOwner)) // Emit the {OwnershipTransferred} event. log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner) // Store the new value. sstore(ownerSlot, newOwner) } } } /// @dev Throws if the sender is not the owner. function _checkOwner() internal view virtual { /// @solidity memory-safe-assembly assembly { // If the caller is not the stored owner, revert. if iszero(eq(caller(), sload(_OWNER_SLOT))) { mstore(0x00, 0x82b42900) // `Unauthorized()`. revert(0x1c, 0x04) } } } /// @dev Returns how long a two-step ownership handover is valid for in seconds. /// Override to return a different value if needed. /// Made internal to conserve bytecode. Wrap it in a public function if needed. function _ownershipHandoverValidFor() internal view virtual returns (uint64) { return 48 * 3600; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* PUBLIC UPDATE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Allows the owner to transfer the ownership to `newOwner`. function transferOwnership(address newOwner) public payable virtual onlyOwner { /// @solidity memory-safe-assembly assembly { if iszero(shl(96, newOwner)) { mstore(0x00, 0x7448fbae) // `NewOwnerIsZeroAddress()`. revert(0x1c, 0x04) } } _setOwner(newOwner); } /// @dev Allows the owner to renounce their ownership. function renounceOwnership() public payable virtual onlyOwner { _setOwner(address(0)); } /// @dev Request a two-step ownership handover to the caller. /// The request will automatically expire in 48 hours (172800 seconds) by default. function requestOwnershipHandover() public payable virtual { unchecked { uint256 expires = block.timestamp + _ownershipHandoverValidFor(); /// @solidity memory-safe-assembly assembly { // Compute and set the handover slot to `expires`. mstore(0x0c, _HANDOVER_SLOT_SEED) mstore(0x00, caller()) sstore(keccak256(0x0c, 0x20), expires) // Emit the {OwnershipHandoverRequested} event. log2(0, 0, _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE, caller()) } } } /// @dev Cancels the two-step ownership handover to the caller, if any. function cancelOwnershipHandover() public payable virtual { /// @solidity memory-safe-assembly assembly { // Compute and set the handover slot to 0. mstore(0x0c, _HANDOVER_SLOT_SEED) mstore(0x00, caller()) sstore(keccak256(0x0c, 0x20), 0) // Emit the {OwnershipHandoverCanceled} event. log2(0, 0, _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE, caller()) } } /// @dev Allows the owner to complete the two-step ownership handover to `pendingOwner`. /// Reverts if there is no existing ownership handover requested by `pendingOwner`. function completeOwnershipHandover(address pendingOwner) public payable virtual onlyOwner { /// @solidity memory-safe-assembly assembly { // Compute and set the handover slot to 0. mstore(0x0c, _HANDOVER_SLOT_SEED) mstore(0x00, pendingOwner) let handoverSlot := keccak256(0x0c, 0x20) // If the handover does not exist, or has expired. if gt(timestamp(), sload(handoverSlot)) { mstore(0x00, 0x6f5e8818) // `NoHandoverRequest()`. revert(0x1c, 0x04) } // Set the handover slot to 0. sstore(handoverSlot, 0) } _setOwner(pendingOwner); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* PUBLIC READ FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns the owner of the contract. function owner() public view virtual returns (address result) { /// @solidity memory-safe-assembly assembly { result := sload(_OWNER_SLOT) } } /// @dev Returns the expiry timestamp for the two-step ownership handover to `pendingOwner`. function ownershipHandoverExpiresAt(address pendingOwner) public view virtual returns (uint256 result) { /// @solidity memory-safe-assembly assembly { // Compute the handover slot. mstore(0x0c, _HANDOVER_SLOT_SEED) mstore(0x00, pendingOwner) // Load the handover slot. result := sload(keccak256(0x0c, 0x20)) } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* MODIFIERS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Marks a function as only callable by the owner. modifier onlyOwner() virtual { _checkOwner(); _; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.22; import {ERC721AQueryableCloneable} from "./ERC721AQueryableCloneable.sol"; import {ERC721ACloneable} from "./ERC721ACloneable.sol"; import {IERC721A} from "erc721a/contracts/IERC721A.sol"; /// @title ERC721AConduitPreapprovedCloneable /// @notice ERC721A with the MagicEden conduit preapproved. abstract contract ERC721AConduitPreapprovedCloneable is ERC721AQueryableCloneable { /// @dev The canonical MagicEden conduit. address internal constant _CONDUIT = 0x2052f8A2Ff46283B30084e5d84c89A2fdBE7f74b; /// @dev Returns if the `operator` is allowed to manage all of the /// assets of `owner`. Always returns true for the conduit. function isApprovedForAll(address owner, address operator) public view virtual override(ERC721ACloneable, IERC721A) returns (bool) { if (operator == _CONDUIT) { return true; } return ERC721ACloneable.isApprovedForAll(owner, operator); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.4; /// @notice Initializable mixin for the upgradeable contracts. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/Initializable.sol) /// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/tree/master/contracts/proxy/utils/Initializable.sol) abstract contract Initializable { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The contract is already initialized. error InvalidInitialization(); /// @dev The contract is not initializing. error NotInitializing(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Triggered when the contract has been initialized. event Initialized(uint64 version); /// @dev `keccak256(bytes("Initialized(uint64)"))`. bytes32 private constant _INTIALIZED_EVENT_SIGNATURE = 0xc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d2; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* STORAGE */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The default initializable slot is given by: /// `bytes32(~uint256(uint32(bytes4(keccak256("_INITIALIZABLE_SLOT")))))`. /// /// Bits Layout: /// - [0] `initializing` /// - [1..64] `initializedVersion` bytes32 private constant _INITIALIZABLE_SLOT = 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffbf601132; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CONSTRUCTOR */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ constructor() { // Construction time check to ensure that `_initializableSlot()` is not // overridden to zero. Will be optimized away if there is no revert. require(_initializableSlot() != bytes32(0)); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Override to return a non-zero custom storage slot if required. function _initializableSlot() internal pure virtual returns (bytes32) { return _INITIALIZABLE_SLOT; } /// @dev Guards an initializer function so that it can be invoked at most once. /// /// You can guard a function with `onlyInitializing` such that it can be called /// through a function guarded with `initializer`. /// /// This is similar to `reinitializer(1)`, except that in the context of a constructor, /// an `initializer` guarded function can be invoked multiple times. /// This can be useful during testing and is not expected to be used in production. /// /// Emits an {Initialized} event. modifier initializer() virtual { bytes32 s = _initializableSlot(); /// @solidity memory-safe-assembly assembly { let i := sload(s) // Set `initializing` to 1, `initializedVersion` to 1. sstore(s, 3) // If `!(initializing == 0 && initializedVersion == 0)`. if i { // If `!(address(this).code.length == 0 && initializedVersion == 1)`. if iszero(lt(extcodesize(address()), eq(shr(1, i), 1))) { mstore(0x00, 0xf92ee8a9) // `InvalidInitialization()`. revert(0x1c, 0x04) } s := shl(shl(255, i), s) // Skip initializing if `initializing == 1`. } } _; /// @solidity memory-safe-assembly assembly { if s { // Set `initializing` to 0, `initializedVersion` to 1. sstore(s, 2) // Emit the {Initialized} event. mstore(0x20, 1) log1(0x20, 0x20, _INTIALIZED_EVENT_SIGNATURE) } } } /// @dev Guards an reinitialzer function so that it can be invoked at most once. /// /// You can guard a function with `onlyInitializing` such that it can be called /// through a function guarded with `reinitializer`. /// /// Emits an {Initialized} event. modifier reinitializer(uint64 version) virtual { bytes32 s = _initializableSlot(); /// @solidity memory-safe-assembly assembly { // Clean upper bits, and shift left by 1 to make space for the initializing bit. version := shl(1, and(version, 0xffffffffffffffff)) let i := sload(s) // If `initializing == 1 || initializedVersion >= version`. if iszero(lt(and(i, 1), lt(i, version))) { mstore(0x00, 0xf92ee8a9) // `InvalidInitialization()`. revert(0x1c, 0x04) } // Set `initializing` to 1, `initializedVersion` to `version`. sstore(s, or(1, version)) } _; /// @solidity memory-safe-assembly assembly { // Set `initializing` to 0, `initializedVersion` to `version`. sstore(s, version) // Emit the {Initialized} event. mstore(0x20, shr(1, version)) log1(0x20, 0x20, _INTIALIZED_EVENT_SIGNATURE) } } /// @dev Guards a function such that it can only be called in the scope /// of a function guarded with `initializer` or `reinitializer`. modifier onlyInitializing() virtual { _checkInitializing(); _; } /// @dev Reverts if the contract is not initializing. function _checkInitializing() internal view virtual { bytes32 s = _initializableSlot(); /// @solidity memory-safe-assembly assembly { if iszero(and(1, sload(s))) { mstore(0x00, 0xd7e6bcf8) // `NotInitializing()`. revert(0x1c, 0x04) } } } /// @dev Locks any future initializations by setting the initialized version to `2**64 - 1`. /// /// Calling this in the constructor will prevent the contract from being initialized /// or reinitialized. It is recommended to use this to lock implementation contracts /// that are designed to be called through proxies. /// /// Emits an {Initialized} event the first time it is successfully called. function _disableInitializers() internal virtual { bytes32 s = _initializableSlot(); /// @solidity memory-safe-assembly assembly { let i := sload(s) if and(i, 1) { mstore(0x00, 0xf92ee8a9) // `InvalidInitialization()`. revert(0x1c, 0x04) } let uint64max := 0xffffffffffffffff if iszero(eq(shr(1, i), uint64max)) { // Set `initializing` to 0, `initializedVersion` to `2**64 - 1`. sstore(s, shl(1, uint64max)) // Emit the {Initialized} event. mstore(0x20, uint64max) log1(0x20, 0x20, _INTIALIZED_EVENT_SIGNATURE) } } } /// @dev Returns the highest version that has been initialized. function _getInitializedVersion() internal view virtual returns (uint64 version) { bytes32 s = _initializableSlot(); /// @solidity memory-safe-assembly assembly { version := shr(1, sload(s)) } } /// @dev Returns whether the contract is currently initializing. function _isInitializing() internal view virtual returns (bool result) { bytes32 s = _initializableSlot(); /// @solidity memory-safe-assembly assembly { result := and(1, sload(s)) } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.22; interface IMagicDropMetadata { /*============================================================== = EVENTS = ==============================================================*/ /// @notice Emitted when the contract URI is updated. /// @param _contractURI The new contract URI. event ContractURIUpdated(string _contractURI); /// @notice Emitted when the royalty info is updated. /// @param receiver The new royalty receiver. /// @param bps The new royalty basis points. event RoyaltyInfoUpdated(address receiver, uint256 bps); /// @notice Emitted when the metadata is updated. (EIP-4906) /// @param _fromTokenId The starting token ID. /// @param _toTokenId The ending token ID. event BatchMetadataUpdate(uint256 _fromTokenId, uint256 _toTokenId); /// @notice Emitted once when the token contract is deployed and initialized. event MagicDropTokenDeployed(); /*============================================================== = ERRORS = ==============================================================*/ /// @notice Throw when the max supply is exceeded. error CannotExceedMaxSupply(); /// @notice Throw when the max supply is less than the current supply. error MaxSupplyCannotBeLessThanCurrentSupply(); /// @notice Throw when trying to increase the max supply. error MaxSupplyCannotBeIncreased(); /// @notice Throw when the max supply is greater than 2^64. error MaxSupplyCannotBeGreaterThan2ToThe64thPower(); /*============================================================== = PUBLIC VIEW METHODS = ==============================================================*/ /// @notice Returns the base URI used to construct token URIs /// @dev This is concatenated with the token ID to form the complete token URI /// @return The base URI string that prefixes all token URIs function baseURI() external view returns (string memory); /// @notice Returns the contract-level metadata URI /// @dev Used by marketplaces like MagicEden to display collection information /// @return The URI string pointing to the contract's metadata JSON function contractURI() external view returns (string memory); /// @notice Returns the address that receives royalty payments /// @dev Used in conjunction with royaltyBps for EIP-2981 royalty standard /// @return The address designated to receive royalty payments function royaltyAddress() external view returns (address); /// @notice Returns the royalty percentage in basis points (1/100th of a percent) /// @dev 100 basis points = 1%. Used in EIP-2981 royalty calculations /// @return The royalty percentage in basis points (e.g., 250 = 2.5%) function royaltyBps() external view returns (uint256); /*============================================================== = ADMIN OPERATIONS = ==============================================================*/ /// @notice Sets the base URI for all token metadata /// @dev This is a critical function that determines where all token metadata is hosted /// Changing this will update the metadata location for all tokens in the collection /// @param baseURI The new base URI string that will prefix all token URIs function setBaseURI(string calldata baseURI) external; /// @notice Sets the contract-level metadata URI /// @dev This metadata is used by marketplaces to display collection information /// Should point to a JSON file following collection metadata standards /// @param contractURI The new URI string pointing to the contract's metadata JSON function setContractURI(string calldata contractURI) external; /// @notice Updates the royalty configuration for the collection /// @dev Implements EIP-2981 for NFT royalty standards /// The bps (basis points) must be between 0 and 10000 (0% to 100%) /// @param newReceiver The address that will receive future royalty payments /// @param newBps The royalty percentage in basis points (e.g., 250 = 2.5%) function setRoyaltyInfo(address newReceiver, uint96 newBps) external; }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; import {IERC721AQueryable} from "erc721a/contracts/extensions/IERC721AQueryable.sol"; import {ERC721ACloneable} from "./ERC721ACloneable.sol"; /** * @title ERC721AQueryableCloneable. * * @dev ERC721A subclass with convenience query functions. */ abstract contract ERC721AQueryableCloneable is ERC721ACloneable, IERC721AQueryable { /** * @dev Returns the `TokenOwnership` struct at `tokenId` without reverting. * * If the `tokenId` is out of bounds: * * - `addr = address(0)` * - `startTimestamp = 0` * - `burned = false` * - `extraData = 0` * * If the `tokenId` is burned: * * - `addr = <Address of owner before token was burned>` * - `startTimestamp = <Timestamp when token was burned>` * - `burned = true` * - `extraData = <Extra data when token was burned>` * * Otherwise: * * - `addr = <Address of owner>` * - `startTimestamp = <Timestamp of start of ownership>` * - `burned = false` * - `extraData = <Extra data at start of ownership>` */ function explicitOwnershipOf(uint256 tokenId) public view virtual override returns (TokenOwnership memory ownership) { unchecked { if (tokenId >= _startTokenId()) { if (tokenId > _sequentialUpTo()) return _ownershipAt(tokenId); if (tokenId < _nextTokenId()) { // If the `tokenId` is within bounds, // scan backwards for the initialized ownership slot. while (!_ownershipIsInitialized(tokenId)) --tokenId; return _ownershipAt(tokenId); } } } } /** * @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order. * See {ERC721AQueryable-explicitOwnershipOf} */ function explicitOwnershipsOf(uint256[] calldata tokenIds) external view virtual override returns (TokenOwnership[] memory) { TokenOwnership[] memory ownerships; uint256 i = tokenIds.length; assembly { // Grab the free memory pointer. ownerships := mload(0x40) // Store the length. mstore(ownerships, i) // Allocate one word for the length, // `tokenIds.length` words for the pointers. i := shl(5, i) // Multiply `i` by 32. mstore(0x40, add(add(ownerships, 0x20), i)) } while (i != 0) { uint256 tokenId; assembly { i := sub(i, 0x20) tokenId := calldataload(add(tokenIds.offset, i)) } TokenOwnership memory ownership = explicitOwnershipOf(tokenId); assembly { // Store the pointer of `ownership` in the `ownerships` array. mstore(add(add(ownerships, 0x20), i), ownership) } } return ownerships; } /** * @dev Returns an array of token IDs owned by `owner`, * in the range [`start`, `stop`) * (i.e. `start <= tokenId < stop`). * * This function allows for tokens to be queried if the collection * grows too big for a single call of {ERC721AQueryable-tokensOfOwner}. * * Requirements: * * - `start < stop` */ function tokensOfOwnerIn(address owner, uint256 start, uint256 stop) external view virtual override returns (uint256[] memory) { return _tokensOfOwnerIn(owner, start, stop); } /** * @dev Returns an array of token IDs owned by `owner`. * * This function scans the ownership mapping and is O(`totalSupply`) in complexity. * It is meant to be called off-chain. * * See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into * multiple smaller scans if the collection is large enough to cause * an out-of-gas error (10K collections should be fine). */ function tokensOfOwner(address owner) external view virtual override returns (uint256[] memory) { // If spot mints are enabled, full-range scan is disabled. if (_sequentialUpTo() != type(uint256).max) { _revert(NotCompatibleWithSpotMints.selector); } uint256 start = _startTokenId(); uint256 stop = _nextTokenId(); uint256[] memory tokenIds; if (start != stop) tokenIds = _tokensOfOwnerIn(owner, start, stop); return tokenIds; } /** * @dev Helper function for returning an array of token IDs owned by `owner`. * * Note that this function is optimized for smaller bytecode size over runtime gas, * since it is meant to be called off-chain. */ function _tokensOfOwnerIn(address owner, uint256 start, uint256 stop) private view returns (uint256[] memory tokenIds) { unchecked { if (start >= stop) _revert(InvalidQueryRange.selector); // Set `start = max(start, _startTokenId())`. if (start < _startTokenId()) start = _startTokenId(); uint256 nextTokenId = _nextTokenId(); // If spot mints are enabled, scan all the way until the specified `stop`. uint256 stopLimit = _sequentialUpTo() != type(uint256).max ? stop : nextTokenId; // Set `stop = min(stop, stopLimit)`. if (stop >= stopLimit) stop = stopLimit; // Number of tokens to scan. uint256 tokenIdsMaxLength = balanceOf(owner); // Set `tokenIdsMaxLength` to zero if the range contains no tokens. if (start >= stop) tokenIdsMaxLength = 0; // If there are one or more tokens to scan. if (tokenIdsMaxLength != 0) { // Set `tokenIdsMaxLength = min(balanceOf(owner), tokenIdsMaxLength)`. if (stop - start <= tokenIdsMaxLength) { tokenIdsMaxLength = stop - start; } uint256 m; // Start of available memory. assembly { // Grab the free memory pointer. tokenIds := mload(0x40) // Allocate one word for the length, and `tokenIdsMaxLength` words // for the data. `shl(5, x)` is equivalent to `mul(32, x)`. m := add(tokenIds, shl(5, add(tokenIdsMaxLength, 1))) mstore(0x40, m) } // We need to call `explicitOwnershipOf(start)`, // because the slot at `start` may not be initialized. TokenOwnership memory ownership = explicitOwnershipOf(start); address currOwnershipAddr; // If the starting slot exists (i.e. not burned), // initialize `currOwnershipAddr`. // `ownership.address` will not be zero, // as `start` is clamped to the valid token ID range. if (!ownership.burned) currOwnershipAddr = ownership.addr; uint256 tokenIdsIdx; // Use a do-while, which is slightly more efficient for this case, // as the array will at least contain one element. do { if (_sequentialUpTo() != type(uint256).max) { // Skip the remaining unused sequential slots. if (start == nextTokenId) start = _sequentialUpTo() + 1; // Reset `currOwnershipAddr`, as each spot-minted token is a batch of one. if (start > _sequentialUpTo()) { currOwnershipAddr = address(0); } } ownership = _ownershipAt(start); // This implicitly allocates memory. assembly { switch mload(add(ownership, 0x40)) // if `ownership.burned == false`. case 0 { // if `ownership.addr != address(0)`. // The `addr` already has it's upper 96 bits clearned, // since it is written to memory with regular Solidity. if mload(ownership) { currOwnershipAddr := mload(ownership) } // if `currOwnershipAddr == owner`. // The `shl(96, x)` is to make the comparison agnostic to any // dirty upper 96 bits in `owner`. if iszero(shl(96, xor(currOwnershipAddr, owner))) { tokenIdsIdx := add(tokenIdsIdx, 1) mstore(add(tokenIds, shl(5, tokenIdsIdx)), start) } } // Otherwise, reset `currOwnershipAddr`. // This handles the case of batch burned tokens // (burned bit of first slot set, remaining slots left uninitialized). default { currOwnershipAddr := 0 } start := add(start, 1) // Free temporary memory implicitly allocated for ownership // to avoid quadratic memory expansion costs. mstore(0x40, m) } } while (!(start == stop || tokenIdsIdx == tokenIdsMaxLength)); // Store the length of the array. assembly { mstore(tokenIds, tokenIdsIdx) } } } } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; import '../IERC721A.sol'; /** * @dev Interface of ERC721AQueryable. */ interface IERC721AQueryable is IERC721A { /** * Invalid query range (`start` >= `stop`). */ error InvalidQueryRange(); /** * @dev Returns the `TokenOwnership` struct at `tokenId` without reverting. * * If the `tokenId` is out of bounds: * * - `addr = address(0)` * - `startTimestamp = 0` * - `burned = false` * - `extraData = 0` * * If the `tokenId` is burned: * * - `addr = <Address of owner before token was burned>` * - `startTimestamp = <Timestamp when token was burned>` * - `burned = true` * - `extraData = <Extra data when token was burned>` * * Otherwise: * * - `addr = <Address of owner>` * - `startTimestamp = <Timestamp of start of ownership>` * - `burned = false` * - `extraData = <Extra data at start of ownership>` */ function explicitOwnershipOf(uint256 tokenId) external view returns (TokenOwnership memory); /** * @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order. * See {ERC721AQueryable-explicitOwnershipOf} */ function explicitOwnershipsOf(uint256[] memory tokenIds) external view returns (TokenOwnership[] memory); /** * @dev Returns an array of token IDs owned by `owner`, * in the range [`start`, `stop`) * (i.e. `start <= tokenId < stop`). * * This function allows for tokens to be queried if the collection * grows too big for a single call of {ERC721AQueryable-tokensOfOwner}. * * Requirements: * * - `start < stop` */ function tokensOfOwnerIn( address owner, uint256 start, uint256 stop ) external view returns (uint256[] memory); /** * @dev Returns an array of token IDs owned by `owner`. * * This function scans the ownership mapping and is O(`totalSupply`) in complexity. * It is meant to be called off-chain. * * See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into * multiple smaller scans if the collection is large enough to cause * an out-of-gas error (10K collections should be fine). */ function tokensOfOwner(address owner) external view returns (uint256[] memory); }
{ "viaIR": true, "codegen": "yul", "remappings": [ "solady/=lib/solady/", "solemate/=/lib/solemate/src/", "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/", "@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/", "forge-std/=lib/forge-std/src/", "erc721a/contracts/=lib/ERC721A/contracts/", "erc721a-upgradeable/contracts/=lib/ERC721A-Upgradeable/contracts/", "@limitbreak/creator-token-standards/src/=lib/creator-token-standards/src/", "@ensdomains/=node_modules/@ensdomains/", "@layerzerolabs/=node_modules/@layerzerolabs/", "@limitbreak/permit-c/=lib/creator-token-standards/lib/PermitC/src/", "@opensea/tstorish/=lib/creator-token-standards/lib/tstorish/src/", "@openzeppelin-3/=node_modules/@openzeppelin-3/", "@rari-capital/solmate/=lib/creator-token-standards/lib/PermitC/lib/solmate/", "@uniswap/=node_modules/@uniswap/", "ERC721A-Upgradeable/=lib/ERC721A-Upgradeable/contracts/", "ERC721A/=lib/ERC721A/contracts/", "PermitC/=lib/creator-token-standards/lib/PermitC/", "creator-token-standards/=lib/creator-token-standards/", "ds-test/=lib/solmate/lib/ds-test/src/", "erc4626-tests/=lib/operator-filter-registry/lib/openzeppelin-contracts/lib/erc4626-tests/", "eth-gas-reporter/=node_modules/eth-gas-reporter/", "forge-gas-metering/=lib/creator-token-standards/lib/PermitC/lib/forge-gas-metering/", "hardhat-deploy/=node_modules/hardhat-deploy/", "hardhat/=node_modules/hardhat/", "murky/=lib/creator-token-standards/lib/murky/", "openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/", "openzeppelin-contracts/=lib/openzeppelin-contracts/", "openzeppelin/=lib/creator-token-standards/lib/PermitC/lib/openzeppelin-contracts/contracts/", "operator-filter-registry/=lib/operator-filter-registry/", "solmate/=lib/solmate/src/", "tstorish/=lib/creator-token-standards/lib/tstorish/src/" ], "evmVersion": "cancun", "outputSelection": { "*": { "*": [ "abi" ] } }, "optimizer": { "enabled": true, "mode": "3", "fallback_to_optimizing_for_size": false, "disable_system_request_memoization": true }, "metadata": {}, "libraries": {}, "enableEraVMExtensions": false, "forceEVMLA": false }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[],"name":"AllowlistStageNotActive","type":"error"},{"inputs":[],"name":"AlreadyInitialized","type":"error"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"CannotExceedMaxSupply","type":"error"},{"inputs":[],"name":"InvalidAllowlistStageTime","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[],"name":"InvalidProof","type":"error"},{"inputs":[],"name":"InvalidPublicStageTime","type":"error"},{"inputs":[],"name":"InvalidQueryRange","type":"error"},{"inputs":[],"name":"InvalidStageTime","type":"error"},{"inputs":[],"name":"MaxSupplyCannotBeGreaterThan2ToThe64thPower","type":"error"},{"inputs":[],"name":"MaxSupplyCannotBeIncreased","type":"error"},{"inputs":[],"name":"MaxSupplyCannotBeLessThanCurrentSupply","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"NewOwnerIsZeroAddress","type":"error"},{"inputs":[],"name":"NoHandoverRequest","type":"error"},{"inputs":[],"name":"NotCompatibleWithSpotMints","type":"error"},{"inputs":[],"name":"NotInitializing","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"PayoutRecipientCannotBeZeroAddress","type":"error"},{"inputs":[],"name":"PublicStageNotActive","type":"error"},{"inputs":[],"name":"RequiredValueNotMet","type":"error"},{"inputs":[],"name":"RoyaltyOverflow","type":"error"},{"inputs":[],"name":"RoyaltyReceiverIsZeroAddress","type":"error"},{"inputs":[],"name":"SequentialMintExceedsLimit","type":"error"},{"inputs":[],"name":"SequentialUpToTooSmall","type":"error"},{"inputs":[],"name":"SpotMintTokenIdTooSmall","type":"error"},{"inputs":[],"name":"TokenAlreadyExists","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"Unauthorized","type":"error"},{"inputs":[],"name":"WalletLimitExceeded","type":"error"},{"anonymous":false,"inputs":[{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"indexed":false,"internalType":"struct AllowlistStage","name":"stage","type":"tuple"}],"name":"AllowlistStageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_toTokenId","type":"uint256"}],"name":"BatchMetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"toTokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"ConsecutiveTransfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"_contractURI","type":"string"}],"name":"ContractURIUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[],"name":"MagicDropTokenDeployed","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"newMaxSupply","type":"uint256"}],"name":"MaxSupplyUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverCanceled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverRequested","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"newPayoutRecipient","type":"address"}],"name":"PayoutRecipientSet","type":"event"},{"anonymous":false,"inputs":[{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"}],"indexed":false,"internalType":"struct PublicStage","name":"stage","type":"tuple"}],"name":"PublicStageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"bps","type":"uint256"}],"name":"RoyaltyInfoUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"qty","type":"uint256"}],"name":"TokenMinted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_walletLimit","type":"uint256"}],"name":"WalletLimitUpdated","type":"event"},{"inputs":[],"name":"BPS_DENOMINATOR","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"PROTOCOL_FEE_BPS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"PROTOCOL_FEE_RECIPIENT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"cancelOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"completeOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"contractNameAndVersion","outputs":[{"internalType":"string","name":"","type":"string"},{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"contractURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"fromTokenId","type":"uint256"},{"internalType":"uint256","name":"toTokenId","type":"uint256"}],"name":"emitBatchMetadataUpdate","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"explicitOwnershipOf","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint64","name":"startTimestamp","type":"uint64"},{"internalType":"bool","name":"burned","type":"bool"},{"internalType":"uint24","name":"extraData","type":"uint24"}],"internalType":"struct IERC721A.TokenOwnership","name":"ownership","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"explicitOwnershipsOf","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint64","name":"startTimestamp","type":"uint64"},{"internalType":"bool","name":"burned","type":"bool"},{"internalType":"uint24","name":"extraData","type":"uint24"}],"internalType":"struct IERC721A.TokenOwnership[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getAllowlistStage","outputs":[{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"internalType":"struct AllowlistStage","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getConfig","outputs":[{"components":[{"internalType":"uint256","name":"maxSupply","type":"uint256"},{"internalType":"uint256","name":"walletLimit","type":"uint256"},{"internalType":"string","name":"baseURI","type":"string"},{"internalType":"string","name":"contractURI","type":"string"},{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"}],"internalType":"struct PublicStage","name":"publicStage","type":"tuple"},{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"internalType":"struct AllowlistStage","name":"allowlistStage","type":"tuple"},{"internalType":"address","name":"payoutRecipient","type":"address"},{"internalType":"address","name":"royaltyRecipient","type":"address"},{"internalType":"uint96","name":"royaltyBps","type":"uint96"}],"internalType":"struct SetupConfig","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getPublicStage","outputs":[{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"}],"internalType":"struct PublicStage","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"_name","type":"string"},{"internalType":"string","name":"_symbol","type":"string"},{"internalType":"address","name":"_owner","type":"address"},{"internalType":"uint256","name":"_mintFee","type":"uint256"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","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":"maxSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"qty","type":"uint256"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"name":"mintAllowlist","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"mintFee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"qty","type":"uint256"}],"name":"mintPublic","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"result","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"ownershipHandoverExpiresAt","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"payoutRecipient","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"requestOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"royaltyAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"royaltyBps","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"royaltyAmount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"internalType":"struct AllowlistStage","name":"stage","type":"tuple"}],"name":"setAllowlistStage","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"newBaseURI","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"newContractURI","type":"string"}],"name":"setContractURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxSupply","type":"uint256"}],"name":"setMaxSupply","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newPayoutRecipient","type":"address"}],"name":"setPayoutRecipient","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"}],"internalType":"struct PublicStage","name":"stage","type":"tuple"}],"name":"setPublicStage","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newReceiver","type":"address"},{"internalType":"uint96","name":"newBps","type":"uint96"}],"name":"setRoyaltyInfo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newWalletLimit","type":"uint256"}],"name":"setWalletLimit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"maxSupply","type":"uint256"},{"internalType":"uint256","name":"walletLimit","type":"uint256"},{"internalType":"string","name":"baseURI","type":"string"},{"internalType":"string","name":"contractURI","type":"string"},{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"}],"internalType":"struct PublicStage","name":"publicStage","type":"tuple"},{"components":[{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"internalType":"struct AllowlistStage","name":"allowlistStage","type":"tuple"},{"internalType":"address","name":"payoutRecipient","type":"address"},{"internalType":"address","name":"royaltyRecipient","type":"address"},{"internalType":"uint96","name":"royaltyBps","type":"uint96"}],"internalType":"struct SetupConfig","name":"config","type":"tuple"}],"name":"setup","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"tokensOfOwner","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"start","type":"uint256"},{"internalType":"uint256","name":"stop","type":"uint256"}],"name":"tokensOfOwnerIn","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"totalMintedByUser","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"walletLimit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"}]
Contract Creation Code
3cda3351802853f87f3efa7109bd4a3b7b9ac3daf75f98a3fc97a8fce04d8c17ed2e85c70100073f10cd87d69f67b2011b7805d1113c2406083a99b7b561dc84507b9a0300000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0004000000000002000a00000000000200000060041002700000065f03400197000300000031035500020000000103550000065f0040019d0000008004000039000000400040043f0000000100200190000000770000c13d000000040030008c0000082f0000413d000000000201043b000000e002200270000006610020009c0000007f0000213d000006890020009c000000e60000213d0000069d0020009c000001960000213d000006a70020009c000001fe0000a13d000006a80020009c0000032a0000213d000006ab0020009c000004790000613d000006ac0020009c0000082f0000c13d000000440030008c0000082f0000413d0000000402100370000000000202043b000900000002001d000006b00020009c0000082f0000213d0000002401100370000000000101043b000800000001001d000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b0000004e0000c13d000000000100041a000000080010006c000008580000a13d0000000802000029000000010220008a000a00000002001d000000000020043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b0000000a020000290000003b0000613d000006f300100198000008580000c13d000a06b00010019b00000000010004110000000a0010006c000000580000613d000006b001100197000700000001001d0000071d0010009c00000aef0000c13d0000000801000029000000000010043f0000000601000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d0000000902000029000006b006200197000000000101043b000000000201041a000006e802200197000000000262019f000000000021041b00000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d02000039000000040300003900000728040000410000000a050000290000000807000029000007f10000013d0000000001000416000000000001004b0000082f0000c13d00000020010000390000010000100443000001200000044300000660010000410000197a0001042e000006620020009c000001080000213d000006760020009c000001a70000213d000006800020009c000002220000a13d000006810020009c000003380000213d000006840020009c0000049f0000613d000006850020009c0000082f0000c13d000000640030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000402100370000000000202043b000600000002001d000006b00020009c0000082f0000213d0000004402100370000000000202043b0000002401100370000000000301043b000000000023004b0000085c0000813d000000000100041a000000000012004b0000000002018019000500000002001d0000000601000029000000000001004b0000086c0000613d000900000003001d000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000300600000003d000000000101043b0000000903000029000000050230006b00000dcf0000a13d000000000101041a000006b30110019800000dcf0000613d000000000012004b0000000002018019000400000002001d0000000501200210000000400200043d000300000002001d00000000012100190000002001100039000000400010043f000800000001001d000006b40010009c00000d520000213d00000008020000290000008001200039000000400010043f0000006001200039000000000001043500000040012000390000000000010435000000200120003900000000000104350000000000020435000000000100041a000000000031004b000000000100001900000b880000a13d0000000901000029000a00000001001d000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b00000d1e0000c13d0000000a01000029000000010110008a000000d20000013d0000068a0020009c000001b50000213d000006940020009c000002680000a13d000006950020009c0000037f0000213d000006980020009c000004be0000613d000006990020009c0000082f0000c13d000006b1010000410000000c0010043f0000000001000411000000000010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006ca011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000001041b00000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d0200003900000002030000390000071b04000041000002d00000013d000006630020009c000001e50000213d0000066d0020009c0000027d0000a13d0000066e0020009c0000041c0000213d000006710020009c000004cc0000613d000006720020009c0000082f0000c13d000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000402100370000000000202043b000a00000002001d000006b30020009c0000082f0000213d0000000a0230006a000006cf0020009c0000082f0000213d000001c40020008c0000082f0000413d000006c002000041000000000202041a0000000003000411000000000023004b000007f60000c13d0000000a020000290000000404200039000000000241034f000000000202043b000000000002004b000009120000c13d000900000004001d0000002003400039000000000231034f000000000202043b000000000002004b000001480000613d000800000003001d0000000c01000039000000000021041b000000400100043d00000000002104350000065f0010009c0000065f01008041000000400110021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006d7011001c70000800d020000390000000103000039000006d8040000411979196f0000040f00000001002001900000082f0000613d00000002010003670000000803000029000800200030003d0000000802100360000000000402043b00000000020000310000000a0320006a000000230330008a000006c205300197000006c206400197000000000756013f000000000056004b0000000005000019000006c205004041000000000034004b0000000006000019000006c206008041000006c20070009c000000000506c019000000000005004b0000082f0000c13d0000000904400029000000000541034f000000000605043b000006b30060009c0000082f0000213d00000000056200490000002004400039000006c207500197000006c208400197000000000978013f000000000078004b0000000007000019000006c207004041000000000054004b0000000005000019000006c205002041000006c20090009c000000000705c019000000000007004b0000082f0000c13d000000000006004b00000e2e0000613d0000000905000039000000000805041a000000010080019000000001078002700000007f0770618f0000001f0070008c00000000090000390000000109002039000000000898013f0000000100800190000007980000c13d000000200070008c0000018d0000413d000000000050043f0000001f086000390000000508800270000006d90880009a000000200060008c000006da080040410000001f077000390000000507700270000006d90770009a000000000078004b0000018d0000813d000000000008041b0000000108800039000000000078004b000001890000413d0000001f0060008c000000010760021000000df10000a13d000000000050043f000007310960019800000df90000c13d000006da08000041000000000a00001900000e030000013d0000069e0020009c000002a40000a13d0000069f0020009c000004270000213d000006a20020009c0000050e0000613d000006a30020009c0000082f0000c13d0000000001000416000000000001004b0000082f0000c13d197913c70000040f197913da0000040f000000400200043d000a00000002001d197911a00000040f000005e90000013d000006770020009c000002d20000a13d000006780020009c000004300000213d0000067b0020009c000005580000613d0000067c0020009c0000082f0000c13d0000000001000416000000000001004b0000082f0000c13d000000800000043f000006b2010000410000197a0001042e0000068b0020009c000002e30000a13d0000068c0020009c0000045a0000213d0000068f0020009c000005790000613d000006900020009c0000082f0000c13d000000640030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d000006c002000041000000000202041a0000000003000411000000000023004b000007f60000c13d0000002402100370000000000202043b0000000403100370000000000303043b000000000023004b000008540000813d0000001204000039000000000404041a000000000004004b000008b10000c13d0000000f04000039000000000034041b0000001004000039000000000024041b0000004401100370000000000101043b0000001104000039000000000014041b000000800030043f000000a00020043f000000c00010043f00000000010004140000065f0010009c0000065f01008041000000c00110021000000716011001c70000800d020000390000000103000039000006e704000041000007f10000013d000006640020009c000002f50000a13d000006650020009c000004650000213d000006680020009c000005840000613d000006690020009c0000082f0000c13d000000240030008c0000082f0000413d0000000401100370000000000101043b000006b00010009c0000082f0000213d000006c002000041000000000202041a0000000003000411000000000023004b000007f60000c13d000000000001004b00000a600000c13d000006c901000041000000000010043f000006b9010000410000197b00010430000006ad0020009c000006b10000613d000006ae0020009c000006c50000613d000006af0020009c0000082f0000c13d0000000001000416000000000001004b0000082f0000c13d0000000203000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000054004b000007980000c13d000000800010043f000000000004004b000008310000613d000000000030043f000000000001004b0000000002000019000008360000613d000006bb030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b0000021a0000413d000008360000013d000006860020009c000006da0000613d000006870020009c000006ed0000613d000006880020009c0000082f0000c13d000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000402100370000000000202043b000006b30020009c0000082f0000213d0000002304200039000000000034004b0000082f0000813d0000000404200039000000000541034f000000000505043b000a00000005001d000006b30050009c0000082f0000213d00000024052000390000000a02500029000000000032004b0000082f0000213d000006c002000041000000000202041a0000000003000411000000000023004b000007f60000c13d0000000a03000039000000000203041a000000010020019000000001062002700000007f0660618f0000001f0060008c00000000070000390000000107002039000000000272013f0000000100200190000007980000c13d000000200060008c0000000a080000290000001f02800039000002600000413d000000000030043f0000000507200270000006dd0770009a000000200080008c000006de070040410000001f066000390000000506600270000006dd0660009a000000000067004b000002600000813d000000000007041b0000000107700039000000000067004b0000025c0000413d0000001f0080008c00000b110000a13d000000000030043f000007310780019800000bd50000c13d000006de06000041000000000800001900000bdf0000013d0000069a0020009c000006f20000613d0000069b0020009c000007020000613d0000069c0020009c0000082f0000c13d000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000101043b000a00000001001d000006b00010009c0000082f0000213d197916730000040f0000000a01000029197916da0000040f00000000010000190000197a0001042e000006730020009c000007750000613d000006740020009c0000079e0000613d000006750020009c0000082f0000c13d000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000201043b000000000100041a000000000021004b000008aa0000a13d000900000002001d000a00000002001d000000000020043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b0000088b0000c13d0000000a02000029000000000002004b000000010220008a0000028e0000c13d000004990000013d000006a40020009c000007a70000613d000006a50020009c000007d40000613d000006a60020009c0000082f0000c13d000006b1010000410000000c0010043f0000000001000411000000000010043f000006cb01000041000000000010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006cc011001c70000800b02000039197919740000040f000000010020019000000f420000613d000000000101043b000a00000001001d00000000010004140000065f0010009c0000065f01008041000000c001100210000006ca011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b0000000a02000029000007220220009a000000000021041b00000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d02000039000000020300003900000723040000410000000005000411000007f10000013d0000067d0020009c000007d90000613d0000067e0020009c000007fa0000613d0000067f0020009c0000082f0000c13d000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000101043b000006b00010009c0000082f0000213d197917ae0000040f0000080c0000013d000006910020009c000008030000613d000006920020009c000008130000613d000006930020009c0000082f0000c13d000000240030008c0000082f0000413d0000000001000416000000000001004b0000082f0000c13d197916730000040f00000004010000390000000201100367000000000101043b1979176a0000040f00000000010000190000197a0001042e0000066a0020009c000008180000613d0000066b0020009c000008220000613d0000066c0020009c0000082f0000c13d000000240030008c0000082f0000413d0000000401100370000000000101043b000a00000001001d000006b00010009c0000082f0000213d000006c001000041000000000101041a0000000002000411000000000012004b000007f60000c13d000006b1010000410000000c0010043f0000000a01000029000000000010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006ca011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000800000001001d000000000101041a000900000001001d000006cb01000041000000000010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006cc011001c70000800b02000039197919740000040f000000010020019000000f420000613d000000000101043b000000090010006c00000a5d0000a13d000006cd01000041000000000010043f000006b9010000410000197b00010430000006a90020009c000005900000613d000006aa0020009c0000082f0000c13d0000000001000416000000000001004b0000082f0000c13d0000000101000039000000000101041a000000000200041a0000000001120049000000800010043f000006b2010000410000197a0001042e000006820020009c000005950000613d000006830020009c0000082f0000c13d000000440030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000402100370000000000202043b000a00000002001d000006b00020009c0000082f0000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039000900000002001d000000000012004b0000082f0000c13d0000000001000411000000000010043f0000000701000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b0000000a02000029000000000020043f000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000201041a00000732022001970000000903000029000000000232019f000000000021041b000000400100043d00000000003104350000065f0010009c0000065f01008041000000400110021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006d7011001c70000800d020000390000000303000039000007010400004100000000050004110000000a06000029000007f10000013d000006960020009c000005c40000613d000006970020009c0000082f0000c13d000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000402100370000000000202043b000006b30020009c0000082f0000213d0000002304200039000000000034004b0000082f0000813d000900040020003d0000000901100360000000000101043b000006b30010009c0000082f0000213d000000050410021000000000024200190000002402200039000000000032004b0000082f0000213d0000000005040019000000800010043f000000a002400039000000400020043f000000000001004b000003d80000c13d00000020010000390000000001120436000000800300043d00000000003104350000004001200039000000000003004b0000083e0000613d00000080040000390000000005000019000000200440003900000000060404330000000087060434000006b00770019700000000077104360000000008080433000006b308800197000000000087043500000040076000390000000007070433000000000007004b0000000007000039000000010700c03900000040081000390000000000780435000000600660003900000000060604330000071a066001970000006007100039000000000067043500000080011000390000000105500039000000000035004b000003a80000413d0000083e0000013d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e8041002700000000000430435000006f3001001980000000003000039000000010300c03900000040042000390000000000340435000006b0031001970000000003320436000000a001100270000006b3011001970000000000130435000000200150008c00000080035000390000000000230435000000400200043d00000000050100190000039f0000613d000007170020009c00000d520000813d00000009015000290000000201100367000000000301043b0000008001200039000000400010043f0000006001200039000000000001043500000040012000390000000000010435000000200120003900000000000104350000000000020435000000000100041a000000000031004b000003d20000a13d000800000005001d000a00000003001d000000000030043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b000003fe0000c13d0000000a03000029000000010330008a000003ea0000013d000000400100043d000006b40010009c0000000a0300002900000d520000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000030043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000400200043d000006b40020009c0000000805000029000003c10000a13d00000d520000013d0000066f0020009c000005d10000613d000006700020009c0000082f0000c13d0000000001000416000000000001004b0000082f0000c13d0000271001000039000000800010043f000006b2010000410000197a0001042e000006a00020009c000005d60000613d000006a10020009c0000082f0000c13d0000000001000416000000000001004b0000082f0000c13d0000000e01000039000007fe0000013d000006790020009c000005de0000613d0000067a0020009c0000082f0000c13d0000000001000416000000000001004b0000082f0000c13d000000c001000039000000400010043f0000001802000039000000800020043f000006fd02000041000000a00020043f197911fc0000040f0000000501000039000000c00010043f000006fe01000041000000e00010043f0000004001000039000000400200043d000a00000002001d0000000001120436000900000001001d00000080010000390000004002200039197911670000040f00000000020100190000000a0120006a00000009030000290000000000130435000000c001000039197911670000040f0000000a0200002900000000012100490000065f0020009c0000065f0200804100000040022002100000065f0010009c0000065f010080410000006001100210000000000121019f0000197a0001042e0000068d0020009c000005ef0000613d0000068e0020009c0000082f0000c13d0000000001000416000000000001004b0000082f0000c13d0000071501000041000000800010043f000006b2010000410000197a0001042e000006660020009c000006050000613d000006670020009c0000082f0000c13d000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000101043b000006b00010009c0000082f0000213d000006b1020000410000000c0020043f000000000010043f0000000c0100003900000020020000391979195a0000040f000005da0000013d000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000201043b000000000100041a000000000021004b000008870000a13d000900000002001d000a00000002001d000000000020043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b0000087c0000c13d0000000a02000029000000000002004b000000010220008a000004840000c13d0000071801000041000000000010043f0000001101000039000000040010043f00000719010000410000197b000104300000000001000416000000000001004b0000082f0000c13d0000000303000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000007980000c13d000000800010043f000000000004004b000008310000613d000000000030043f000000000001004b0000000002000019000008360000613d000006be030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000004b60000413d000008360000013d0000000001000416000000000001004b0000082f0000c13d197913f40000040f197914050000040f000000400200043d000a00000002001d197911ad0000040f0000000a010000290000065f0010009c0000065f0100804100000040011002100000071c011001c70000197a0001042e000000640030008c0000082f0000413d0000000402100370000000000202043b000800000002001d000006b00020009c0000082f0000213d0000002402100370000000000202043b000700000002001d0000004402100370000000000202043b000006b30020009c0000082f0000213d0000002304200039000000000034004b0000082f0000813d000900040020003d0000000901100360000000000101043b000a00000001001d000006b30010009c0000082f0000213d00000024012000390000000a020000290000000502200210000400000001001d000600000002001d000500000012001d000000050030006b0000082f0000213d0000010001000039000000400010043f0000001201000039000000000101041a000300000001001d000000800010043f0000001301000039000000000101041a000000a00010043f0000001401000039000000000101041a000000c00010043f0000001501000039000000000101041a000000e00010043f000006cb01000041000000000010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006cc011001c70000800b02000039197919740000040f000000010020019000000f420000613d000000000101043b000000030010006c0000050b0000413d000000a00200043d000000000021004b00000c520000a13d000000400100043d000006f202000041000005be0000013d000000440030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000002402100370000000000202043b000a00000002001d0000000401100370000000000101043b000000000010043f000006eb01000041000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000201041a000006ea0020009c0000052a0000213d000006eb01000041000000000201041a000006ea012001980000000003000019000000010300c08a000000000313c0d90000000a0030006b0000000003000019000000000301201900000001040000310000000005430019000000000045004b0000082f0000213d00000731053001980000001f0630018f000000030740036700000000035400190000053f0000613d000000000807034f000000008908043c0000000004940436000000000034004b0000053b0000c13d0000006002200270000000000006004b0000054d0000613d000000000457034f0000000305600210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000a011000b9000027100110011a000000400300043d0000002004300039000000000014043500000000002304350000065f0030009c0000065f03008041000000400130021000000721011001c70000197a0001042e000000840030008c0000082f0000413d0000000402100370000000000202043b000a00000002001d000006b00020009c0000082f0000213d0000002402100370000000000202043b000900000002001d000006b00020009c0000082f0000213d0000006402100370000000000402043b000006b30040009c0000082f0000213d0000002302400039000000000032004b0000082f0000813d0000000402400039000000000121034f000000000201043b0000002401400039197912190000040f00000044020000390000000202200367000000000302043b00000000040100190000000a010000290000000902000029197914330000040f00000000010000190000197a0001042e000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000101043b000006b00010009c0000082f0000213d1979141b0000040f0000080c0000013d000000240030008c0000082f0000413d0000000001000416000000000001004b0000082f0000c13d197916730000040f00000004010000390000000201100367000000000101043b197919430000040f00000000010000190000197a0001042e0000000001000416000000000001004b0000082f0000c13d0000001601000039000005da0000013d000000440030008c0000082f0000413d0000000402100370000000000202043b000900000002001d000006b00020009c0000082f0000213d0000002401100370000000000101043b000300000001001d000000e001000039000000400010043f0000000f01000039000000000101041a000a00000001001d000000800010043f0000001001000039000000000101041a000000a00010043f0000001101000039000000000101041a000000c00010043f000006cb01000041000000000010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006cc011001c70000800b02000039197919740000040f000000010020019000000f420000613d000000000101043b0000000a0010006c000005bc0000413d000000a00200043d000000000021004b0000091c0000a13d000000400100043d000007110200004100000000002104350000065f0010009c0000065f010080410000004001100210000006e1011001c70000197b000104300000000001000416000000000001004b0000082f0000c13d0000000001030019197911b60000040f000a00000001001d000900000002001d197916730000040f0000000a010000290000000902000029197916f40000040f00000000010000190000197a0001042e0000000001000416000000000001004b0000082f0000c13d0000000b01000039000005da0000013d0000000001000416000000000001004b0000082f0000c13d0000000c01000039000000000101041a000000800010043f000006b2010000410000197a0001042e000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000101043b197915f00000040f000000400200043d000a00000002001d197911cf0000040f0000000a010000290000065f0010009c0000065f010080410000004001100210000006ff011001c70000197a0001042e000006c001000041000000000501041a0000000001000411000000000051004b000007f60000c13d00000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d020000390000000303000039000006c40400004100000000060000191979196f0000040f00000001002001900000082f0000613d000006c201000041000006c002000041000000000012041b00000000010000190000197a0001042e000000840030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000402100370000000000402043b000006b30040009c0000082f0000213d0000002302400039000000000032004b0000082f0000813d0000000405400039000000000251034f000000000202043b000006b30020009c00000d520000213d0000001f0620003900000731066001970000003f066000390000073106600197000006b40060009c00000d520000213d00000024044000390000008006600039000000400060043f000000800020043f0000000004420019000000000034004b0000082f0000213d0000002004500039000000000541034f00000731062001980000001f0720018f000000a0046000390000062f0000613d000000a008000039000000000905034f000000009a09043c0000000008a80436000000000048004b0000062b0000c13d000000000007004b0000063c0000613d000000000565034f0000000306700210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f0000000000540435000000a00220003900000000000204350000002402100370000000000402043b000006b30040009c0000082f0000213d0000002302400039000000000032004b0000082f0000813d0000000405400039000000000251034f000000000202043b000006b30020009c00000d520000213d0000001f0620003900000731066001970000003f066000390000073106600197000000400700043d0000000006670019000a00000007001d000000000076004b00000000070000390000000107004039000006b30060009c00000d520000213d000000010070019000000d520000c13d0000002404400039000000400060043f0000000a060000290000000006260436000900000006001d0000000004420019000000000034004b0000082f0000213d0000002003500039000000000431034f00000731052001980000001f0620018f00000009035000290000066c0000613d000000000704034f0000000908000029000000007907043c0000000008980436000000000038004b000006680000c13d000000000006004b000006790000613d000000000454034f0000000305600210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f0000000000430435000000090220002900000000000204350000004401100370000000000101043b000800000001001d000006b00010009c0000082f0000213d000006b502000041000000000402041a0000000303000039000606b500000045000000000032041b000700000004001d000000000004004b00000dd30000c13d000000800100043d000006b30010009c00000d520000213d0000000202000039000000000302041a000000010030019000000001023002700000007f0220618f0000001f0020008c00000000040000390000000104002039000000000343013f0000000100300190000007980000c13d000000200020008c000006a80000413d0000000203000039000000000030043f0000001f031000390000000503300270000006ba0330009a000000200010008c000006bb030040410000001f022000390000000502200270000006ba0220009a000000000023004b000006a80000813d000000000003041b0000000103300039000000000023004b000006a40000413d0000001f0010008c00000ef40000a13d0000000202000039000000000020043f000007310410019800000f550000c13d0000002003000039000006bb0200004100000f610000013d000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000201043b0000070b002001980000082f0000c13d00000001010000390000070c022001970000072a0020009c000008600000213d0000072e0020009c000008000000613d0000072f0020009c000008000000613d000007300020009c000008000000613d000008660000013d000000440030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000402100370000000000202043b000a00000002001d000006b00020009c0000082f0000213d0000002401100370000000000101043b000900000001001d000006ea0010009c0000082f0000213d197916730000040f0000000a0100002900000009020000291979167d0000040f00000000010000190000197a0001042e000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000101043b000400000001001d000006b00010009c0000082f0000213d0000006002000039000000000100041a000300000001001d000000000001004b000008690000c13d0000008001000039000a00000001001d197911e20000040f0000083d0000013d0000000001000416000000000001004b0000082f0000c13d000006c001000041000007fe0000013d00000000010300191979118e0000040f000a00000001001d000900000002001d000800000003001d000000400100043d000700000001001d197911f10000040f000000070400002900000000000404350000000a0100002900000009020000290000000803000029197914330000040f00000000010000190000197a0001042e000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000101043b000900000001001d000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b000007310000c13d000000000100041a000000090010006c000008580000a13d0000000902000029000000010220008a000a00000002001d000000000020043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b0000000a020000290000071e0000613d000006f300100198000008580000c13d000a00000001001d0000000901000029000000000010043f0000000601000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d0000000a02000029000006b002200197000000000301043b000000000403041a0000000001000411000006b0011001970000071d0010009c000800000002001d000009ed0000613d000000000021004b000009ed0000613d000000000041004b000009ed0000613d000700000001001d000500000004001d000600000003001d000000000020043f0000000701000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b0000000702000029000000000020043f000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000ff00100190000000080200002900000006030000290000000504000029000009ed0000c13d0000071e01000041000000000010043f000006e1010000410000197b000104300000000001000416000000000001004b0000082f0000c13d000000800000043f000000a00000043f0000006001000039000000c00010043f000000e00010043f000001a00000043f000001c00000043f000001e00000043f000001a001000039000001000010043f0000028001000039000000400010043f000002000000043f000002200000043f000002400000043f000002600000043f0000020002000039000001200020043f000001400000043f000001600000043f000001800000043f0000000905000039000000000305041a000000010630019000000001023002700000007f0220618f0000001f0020008c00000000040000390000000104002039000000000443013f0000000100400190000008470000613d0000071801000041000000000010043f0000002201000039000000040010043f00000719010000410000197b000104300000000001000416000000000001004b0000082f0000c13d0000000d01000039000000000101041a000000a001100270000000800010043f000006b2010000410000197a0001042e000000840030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d000006c002000041000000000202041a0000000003000411000000000023004b000007f60000c13d0000000402100370000000000202043b0000002403100370000000000303043b000000000032004b000008540000813d0000000f04000039000000000404041a000000000004004b000008bb0000c13d0000001204000039000000000024041b0000001304000039000000000034041b0000004404100370000000000404043b0000001405000039000000000045041b0000006401100370000000000101043b0000001505000039000000000015041b000000800020043f000000a00030043f000000c00040043f000000e00010043f00000000010004140000065f0010009c0000065f01008041000000c00110021000000725011001c70000800d020000390000000103000039000006e304000041000007f10000013d00000000010300191979118e0000040f197912c50000040f00000000010000190000197a0001042e000000440030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d000006c002000041000000000202041a0000000003000411000000000023004b000007f60000c13d0000002402100370000000000202043b0000000401100370000000000101043b000000800010043f000000a00020043f00000000010004140000065f0010009c0000065f01008041000000c00110021000000700011001c70000800d020000390000000103000039000006dc040000411979196f0000040f00000001002001900000082f0000613d00000000010000190000197a0001042e0000072401000041000000000010043f000006b9010000410000197b000104300000000001000416000000000001004b0000082f0000c13d0000000d01000039000000000101041a000006b001100197000000800010043f000006b2010000410000197a0001042e000000240030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000401100370000000000101043b197916a80000040f000006b001100197000000400200043d00000000001204350000065f0020009c0000065f020080410000004001200210000006ce011001c70000197a0001042e0000000001000416000000000001004b0000082f0000c13d197912510000040f0000081c0000013d0000000001000416000000000001004b0000082f0000c13d1979128b0000040f0000002002000039000000400300043d000a00000003001d0000000002230436197911670000040f0000083d0000013d000000440030008c0000082f0000413d0000000002000416000000000002004b0000082f0000c13d0000000402100370000000000302043b000006b00030009c0000082f0000213d0000002401100370000000000201043b000006b00020009c000008700000a13d00000000010000190000197b000104300000073202200197000000a00020043f000000000001004b0000002002000039000000000200603900000020022000390000008001000039197912070000040f000000400100043d000a00000001001d0000008002000039197911790000040f0000000a0200002900000000012100490000065f0010009c0000065f0100804100000060011002100000065f0020009c0000065f020080410000004002200210000000000121019f0000197a0001042e0000000c04000039000000000804041a0000000b04000039000000000404041a000002800020043f000000000006004b000008760000613d000000000050043f000000000002004b000008c50000c13d000002a0020000390000002003000039000008d60000013d000006e401000041000000800010043f000006d4010000410000197b000104300000072601000041000000000010043f000006e1010000410000197b000104300000071201000041000000000010043f000006e1010000410000197b000104300000072b0020009c000008000000613d0000072c0020009c000008000000613d0000072d0020009c000008000000613d000000800000043f000006b2010000410000197a0001042e0000000401000029000000000001004b000008fe0000c13d0000071401000041000000000010043f000006e1010000410000197b0001043000000000010300191979164c0000040f000000000001004b0000000001000039000000010100c0390000080c0000013d0000073203300197000002a00030043f000000000002004b00000020030000390000000003006039000008ce0000013d000006f3001001980000000901000029000008870000c13d000000000010043f0000000601000039000000200010043f000000400200003900000000010000191979195a0000040f000000000101041a0000080b0000013d0000072901000041000000000010043f000006e1010000410000197b00010430000000400400043d000006f300100198000008aa0000c13d0000000905000039000000000305041a000000010630019000000001013002700000007f0110618f0000001f0010008c00000000020000390000000102002039000000000223013f0000000100200190000007980000c13d0000000002140436000000000006004b00000ad50000613d000000000050043f000000000001004b000000000300001900000ada0000613d000006da0500004100000000030000190000000006320019000000000705041a000000000076043500000001055000390000002003300039000000000013004b000008a20000413d00000ada0000013d000006f40100004100000000001404350000065f0040009c0000065f040080410000004001400210000006e1011001c70000197b000104300000001304000039000000000404041a000000000004004b000001d10000613d000000000043004b000001d10000213d000006e501000041000000800010043f000006d4010000410000197b00010430000000000043004b000007bb0000413d0000001004000039000000000404041a000000000004004b000007bb0000613d000006e001000041000000800010043f000006d4010000410000197b00010430000006da050000410000000003000019000000000605041a000002a007300039000000000067043500000001055000390000002003300039000000000023004b000008c70000413d0000003f023000390000073103200197000006fa0030009c00000d520000213d0000028002300039000000400020043f000006fb0030009c00000d520000213d0000000d05000039000000000605041a0000000e05000039000000000705041a000003a005300039000000400050043f0000000000420435000002c0043000390000000000140435000002a00530003900000000008504350000000a0b000039000000000a0b041a000000010ca001900000000101a002700000007f0110618f0000001f0010008c0000000008000039000000010800203900000000088a013f0000000100800190000007980000c13d000000400800043d000000000918043600000000000c004b000009490000613d0000000000b0043f000000000001004b000000000a0000190000094e0000613d000006de0b000041000000000a000019000000000ca90019000000000d0b041a0000000000dc0435000000010bb00039000000200aa0003900000000001a004b000008f60000413d0000094e0000013d000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000400200043d000000000101043b000000000101041a000006b30310019800000a630000c13d00000000010200190000006002000039000006ea0000013d0000000b01000039000000000301041a000000000003004b00000acd0000613d000000000023004b00000acd0000813d000006d601000041000000800010043f000006d4010000410000197b000104300000001601000039000000000101041a000000c00200043d000000000021001a000004990000413d000000000421001a00000003014000b9000009270000613d00000000024100d9000000030020006c000004990000c13d000200000004001d0000000002000416000000000012004b00000ce80000c13d0000000c01000039000000000101041a000a00000001001d000000000001004b00000b230000613d0000000901000029000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a0000004001100270000006b301100197000000030010002a000004990000413d00000003011000290000000a0010006c00000b230000a13d000000400100043d0000070302000041000005be0000013d000007320aa001970000000000a90435000000000001004b000000200a000039000000000a0060390000003f09a00039000007310a90019700000000098a00190000000000a9004b000000000a000039000000010a004039000006b30090009c00000d520000213d0000000100a0019000000d520000c13d000000400090043f000002e00a30003900000000008a0435000000400900043d000006fc0090009c00000d520000213d0000006008900039000000400080043f0000000f08000039000000000808041a0000000008890436000000100b000039000000000b0b041a0000000000b804350000001108000039000000000808041a000000400b90003900000000008b043500000300083000390000000000980435000000400c00043d000006b400c0009c00000d520000213d000006b00b7001970000008007c00039000000400070043f0000001207000039000000000707041a00000000077c04360000001309000039000000000909041a00000000009704350000001407000039000000000707041a0000004009c0003900000000007904350000001507000039000000000707041a0000006009c000390000000000790435000000a00960027000000380073000390000000000970435000006b0096001970000036006300039000000000096043500000340093000390000000000b90435000003200b3000390000000000cb0435000000200c000039000000400300043d000000000cc30436000000000202043300000000002c04350000000002050433000000400530003900000000002504350000000002040433000001c00400003900000060053000390000000000450435000001e00c300039000000005402043400000000004c04350000020002300039000000000004004b000009a40000613d000000000c000019000000000d2c0019000000000ec50019000000000e0e04330000000000ed0435000000200cc0003900000000004c004b0000099d0000413d000000000524001900000000000504350000001f04400039000007310440019700000000050a0433000000800a300039000001e00c4000390000000000ca0435000000000224001900000000540504340000000002420436000000000004004b000009b90000613d000000000a000019000000000c2a0019000000000da50019000000000d0d04330000000000dc0435000000200aa0003900000000004a004b000009b20000413d00000000052400190000000000050435000000000508043300000000a8050434000000a00c30003900000000008c043500000000080a0433000000c00a30003900000000008a043500000040055000390000000005050433000000e008300039000000000058043500000000050b0433000001000830003900000000ba0504340000000000a8043500000000080b0433000001200a30003900000000008a043500000040085000390000000008080433000001400a30003900000000008a043500000060055000390000000005050433000001600830003900000000005804350000000005090433000006b005500197000001800830003900000000005804350000000005060433000006b005500197000001a00630003900000000005604350000000005070433000006ea05500197000001c00630003900000000005604350000001f044000390000073101400197000000000232004900000000011200190000065f0010009c0000065f0100804100000060011002100000065f0030009c0000065f030080410000004002300210000000000121019f0000197a0001042e000000000004004b000009f00000613d000000000003041b000000000020043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000201041a0000071f0220009a000000000021041b000006cb01000041000000000010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006cc011001c70000800b02000039197919740000040f000000010020019000000f420000613d000000000101043b000700000001001d0000000901000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d0000000702000029000000a00220021000000008022001af00000720022001c7000000000101043b000000000021041b0000000a01000029000007040010019800000a490000c13d00000009010000290000000101100039000700000001001d000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b00000a490000c13d000000000100041a000000070010006b00000a490000613d0000000701000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b0000000a02000029000000000021041b00000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d02000039000000040300003900000706040000410000000805000029000000000600001900000009070000291979196f0000040f00000001002001900000082f0000613d0000000101000039000000000201041a0000000102200039000000000021041b00000000010000190000197a0001042e0000000801000029000000000001041b0000000a01000029197917950000040f00000000010000190000197a0001042e000000030030006b0000000303004029000600000003001d0000000501300210000700000002001d00000000011200190000002001100039000000400010043f000800000001001d000006b40010009c00000d520000213d00000008020000290000008001200039000000400010043f0000006001200039000000000001043500000040012000390000000000010435000000200120003900000000000104350000000000020435000000000100041a000000000001004b000000000100001900000ceb0000c13d000900000001001d000500000000001d000000000500001900000000010000190000000702000029000000060300002900000a8a0000013d000900000000001d000000070200002900000006030000290000000801000029000000400010043f00000001055000390000000101000039000000010010019000000a900000613d000000030050006c00000dc80000613d000000050030006b00000dc80000613d000000400100043d000006b40010009c00000d520000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000a00000005001d000000000050043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000400200043d000006b40020009c0000000a0500002900000d520000213d000000000101043b000000000101041a0000006003200039000000e80410027000000000004304350000004003200039000006f3001001980000000004000039000000010400c0390000000000430435000000a003100270000006b30330019700000020042000390000000000340435000006b001100197000000000012043500000a830000c13d000000000001004b00000000020100190000000902006029000900000002001d000000040120014f000006b000100198000000070200002900000a850000c13d00000005010000290000000101100039000500000001001d00000005011002100000000001210019000000000051043500000a850000013d000900000004001d000000000300041a000000000023004b00000b1d0000a13d000006d501000041000000800010043f000006d4010000410000197b0001043000000732033001970000000000320435000000000001004b000000200300003900000000030060390000003f0130003900000731051001970000000001450019000000000051004b00000000050000390000000105004039000006b30010009c00000d520000213d000000010050019000000d520000c13d000000400010043f0000000005040433000000000005004b00000b380000c13d000006f90010009c00000d520000213d0000002002100039000000400020043f0000000000010435000000400900043d00000d590000013d0000000a01000029000000000010043f0000000701000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b0000000702000029000000000020043f000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000ff00100190000000580000c13d0000072701000041000000000010043f000006e1010000410000197b00010430000000000008004b000000000600001900000bee0000613d0000000306800210000007330660027f0000073306600167000000000551034f000000000505043b000000000565016f0000000106800210000000000665019f00000bee0000013d000006d00020009c00000d000000413d000006d301000041000000800010043f000006d4010000410000197b00010430000000000200041a000700000002001d000000030020002a000004990000413d00000007020000290000000302200029000000400100043d000600000001001d0000000b01000039000000000101041a000800000002001d000000000012004b00000d100000a13d000006f101000041000000060200002900000000001204350000065f0020009c0000065f020080410000004001200210000006e1011001c70000197b00010430000006ee0010009c00000d520000213d00000000055400190000001f0550003900000000050504330000004006100039000000400060043f0000002006100039000006f507000041000000000076043500000001060000390000000000610435000000400900043d000006f601500197000006f50010009c00000d580000c13d000000a001900039000000400010043f0000008005900039000000000005043500000009080000290000000001050019000000090080008c0000000a5880011a000000f806500210000000010510008a0000000007050433000006f707700197000000000676019f000006f8066001c7000000000065043500000b4d0000213d00000000061900490000008107600039000000210610008a0000000000760435000000400100043d00000020071000390000000004040433000000000004004b00000b690000613d00000000080000190000000009780019000000000a820019000000000a0a04330000000000a904350000002008800039000000000048004b00000b620000413d000000000274001900000000000204350000000004060433000000000004004b00000b760000613d000000000600001900000000072600190000000008560019000000000808043300000000008704350000002006600039000000000046004b00000b6f0000413d000000000224001900000000000204350000000002120049000000200420008a00000000004104350000001f0220003900000731022001970000000003120019000000000023004b00000000020000390000000102004039000006b30030009c00000d520000213d000000010020019000000d520000c13d0000000009030019000000400030043f00000d590000013d000a00000001001d000700000000001d0000000001000019000000090500002900000b920000013d000a00000000001d0000000801000029000000400010043f00000001055000390000000101000039000000010010019000000b990000613d000000050050006c00000dcc0000613d0000000702000029000000040020006c00000dcc0000613d000000400100043d000006b40010009c00000d520000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000900000005001d000000000050043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000400200043d000006b40020009c000000090500002900000d520000213d000000000101043b000000000101041a0000006003200039000000e80410027000000000004304350000004003200039000006f3001001980000000004000039000000010400c0390000000000430435000000a003100270000006b30330019700000020042000390000000000340435000006b001100197000000000012043500000b8d0000c13d000000000001004b00000000020100190000000a02006029000a00000002001d000000060120014f000006b00010019800000b8e0000c13d00000007010000290000000101100039000700000001001d00000005011002100000000301100029000000000051043500000b8e0000013d000006de0600004100000000080000190000000009580019000000000991034f000000000909043b000000000096041b00000001066000390000002008800039000000000078004b00000bd70000413d0000000a0070006c00000beb0000813d0000000a070000290000000307700210000000f80770018f000007330770027f00000733077001670000000005580019000000000551034f000000000505043b000000000575016f000000000056041b0000000a08000029000000010580021000000001065001bf000000000063041b0000002003000039000000800030043f000000a00080043f00000731058001980000001f0880018f000600200040003d0000000604100360000900000005001d000000c00150003900000bff0000613d000000c005000039000000000604034f000000006706043c0000000005750436000000000015004b00000bfb0000c13d000800000008001d000000000008004b00000c0e0000613d000000090440036000000008050000290000000305500210000000000601043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004104350000000a01000029000000c0011000390000000000010435000007310120019700000040011000390000065f0010009c0000065f01008041000700600010021800000000010004140000065f0010009c0000065f01008041000000c00110021000000007011001af00000713011001c70000800d020000390000000103000039000006df040000411979196f0000040f00000001002001900000082f0000613d000000400100043d00000020021000390000000a030000290000000000320435000000200200003900000000002104350000004002100039000000090320002900000006040000290000000204400367000000090000006b00000c340000613d000000000504034f0000000006020019000000005705043c0000000006760436000000000036004b00000c300000c13d000000080000006b00000c420000613d000000090440036000000008050000290000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000a0220002900000000000204350000065f0010009c0000065f01008041000000400110021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f00000007011001af000006c3011001c70000800d020000390000000103000039000006df04000041000007f10000013d000000e00100043d000300000001001d000000400100043d0000002002000039000000000221043600000008030000290000000000320435000006ee0010009c00000d520000213d0000004003100039000000400030043f0000065f0020009c0000065f02008041000000400220021000000000010104330000065f0010009c0000065f010080410000006001100210000000000121019f00000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006c3011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000301043b000000400100043d000000200200003900000000022104360000000000320435000006ee0010009c00000d520000213d0000004003100039000000400030043f0000065f0020009c0000065f02008041000000400220021000000000010104330000065f0010009c0000065f010080410000006001100210000000000121019f00000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006c3011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b00000006020000290000003f02200039000006ef02200197000000400300043d0000000002230019000000000032004b00000000040000390000000104004039000006b30020009c00000d520000213d000000010040019000000d520000c13d000000400020043f0000000a0200002900000000022304360000000505000029000000000050007c0000082f0000213d0000000a0000006b00000cc70000613d0000000904000029000000200440003900000002044003670000000005030019000000040700002900000005080000290000002005500039000000004604043c00000000006504350000002007700039000000000087004b00000ca50000413d0000000003030433000000000003004b00000cc70000613d0000000503300210000900000023001d0000000043020434000a00000004001d000000000031004b000000000300003900000020030020390000000000130435000000200130015f0000000002020433000000000021043500000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b0000000a03000029000000090030006c000000000203001900000cb00000413d000000030010006c00000fa10000c13d0000001601000039000000000101041a000000c00200043d000000000021001a000004990000413d000000000221001a000a00000002001d00000007012000b900000cd50000613d0000000a021000fa000000070020006c000004990000c13d0000000002000416000000000012004b00000ce80000c13d0000000c01000039000000000101041a000900000001001d000000000001004b000010820000c13d000000000100041a000000070010002a000004990000413d00000007011000290000000b02000039000000000202041a000000000021004b0000110e0000a13d000000400100043d000006f102000041000005be0000013d000000400100043d0000070202000041000005be0000013d0000000001000019000a00000001001d000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a000000000001004b00000d4f0000c13d0000000a01000029000000010110008a00000cec0000013d000000000021041b000000800020043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006d1011001c70000800d020000390000000103000039000006d2040000411979196f0000040f00000001002001900000082f0000613d000000020100036700000009040000290000012c0000013d0000000601000029000006f90010009c00000d520000213d00000006010000290000002002100039000500000002001d000000400020043f0000000000010435000000030000006b00000d8b0000c13d0000071001000041000000000010043f000006e1010000410000197b00010430000000400100043d000006b40010009c00000d520000213d0000008002100039000000400020043f00000060021000390000000000020435000000400210003900000000000204350000002002100039000000000002043500000000000104350000000a01000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000400200043d000006b40020009c00000d520000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e80410027000000000004304350000004003200039000006f3001001980000000004000039000000010400c0390000000000430435000000a003100270000006b30330019700000020042000390000000000340435000006b0011001970000000000120435000a00000000001d000a00000001601d00000b890000013d000000400100043d000006b40010009c00000d5d0000a13d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b0001043000000000010400190000002002000039000a00000009001d0000000002290436000008200000013d0000008002100039000000400020043f00000060021000390000000000020435000000400210003900000000000204350000002002100039000000000002043500000000000104350000000a01000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000400200043d000006b40020009c00000d520000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e80410027000000000004304350000004003200039000006f3001001980000000004000039000000010400c0390000000000430435000000a003100270000006b30330019700000020042000390000000000340435000006b0011001970000000000120435000900000000001d000900000001601d00000a7d0000013d000006cb01000041000000000010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006cc011001c70000800b02000039197919740000040f000000010020019000000f420000613d000000000101043b000a00000001001d0000000701000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d0000000a02000029000000a0022002100000000303000029000000010030008c00000000030000190000070403006041000000000223019f0000000903000029000000000232019f000000000101043b000000000021041b000000000030043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000030200002900000705022000d1000000000101043b000000000301041a0000000002230019000000000021041b000000090000006b00000eff0000c13d0000070f01000041000000000010043f000006e1010000410000197b0001043000000005010000290000000000120435000000400100043d000006ea0000013d000000030100002900000007020000290000000000210435000000400100043d000a00000001001d0000000302000029000006eb0000013d000006b60100004100000000001004430000000001000410000000040010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006b7011001c70000800202000039197919740000040f000000010020019000000f420000613d000000020200008a000000070220017f000000000101043b000000020020008c00000ec20000c13d000000000001004b00000ec20000c13d000000070100002900000001001001900000000001000019000006b501006041000600000001001d000006b501000041000000000101041a0000000100100190000006880000c13d000010450000013d0000000306600210000007330660027f0000073306600167000000000441034f000000000404043b000000000464016f000000000474019f00000e0f0000013d000006da08000041000000000a000019000000000b4a0019000000000bb1034f000000000b0b043b0000000000b8041b0000000108800039000000200aa0003900000000009a004b00000dfb0000413d000000000069004b00000e0e0000813d0000000306600210000000f80660018f000007330660027f000007330660016700000000044a0019000000000441034f000000000404043b000000000464016f000000000048041b00000001047001bf000000000045041b0000000104000039000000000504041a000000000400041a000000000054004b00000e2e0000613d00000733015001670000000001140019000000400200043d0000002003200039000000000013043500000000000204350000065f0020009c0000065f02008041000000400120021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006db011001c70000800d020000390000000103000039000006dc040000411979196f0000040f00000001002001900000082f0000613d00000000020000310000000a0320006a0000000201000367000000230330008a0000000804000029000a00200040003d0000000a04100360000000000404043b000006c205400197000006c206300197000000000765013f000000000065004b0000000005000019000006c205004041000000000034004b0000000003000019000006c203008041000006c20070009c000000000503c019000000000005004b0000082f0000c13d0000000904400029000000000341034f000000000303043b000006b30030009c0000082f0000213d00000000023200490000002005400039000006c204200197000006c206500197000000000746013f000000000046004b0000000004000019000006c204004041000000000025004b0000000002000019000006c202002041000006c20070009c000000000402c019000000000004004b0000082f0000c13d000000000003004b00000e9d0000c13d0000000a030000290000008002300039000000000221034f000a00a00030003d0000000a03100360000000000403043b000000000302043b00000000004301a000000ec60000c13d0000000a03000029000000800230008a000000000221034f000a0060003000920000000a03100360000000000403043b000000000302043b00000000004301a000000f430000c13d0000000a02000029000a00c00020003d0000000a02100360000000000202043b000006b00020009c0000082f0000213d000000000002004b00000e860000613d0000000e01000039000000000301041a000006e803300197000000000323019f000000000031041b000000400100043d00000000002104350000065f0010009c0000065f01008041000000400110021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006d7011001c70000800d020000390000000103000039000006e9040000411979196f0000040f00000001002001900000082f0000613d00000002010003670000000a020000290000002003200039000000000231034f000000000202043b000006b00020009c0000082f0000213d000000000002004b000007f40000613d0000002003300039000000000131034f000000000101043b000006ea0010009c0000082f0000213d000000a003100210000000000323019f0000000d04000039000000000034041b000027110010008c000011170000413d000006ed01000041000000000010043f000006b9010000410000197b000104300000000a04000039000000000204041a000000010020019000000001062002700000007f0660618f0000001f0060008c00000000070000390000000107002039000000000272013f0000000100200190000007980000c13d000000200060008c0000001f0230003900000eb90000413d000000000040043f0000000507200270000006dd0770009a000000200030008c000006de070040410000001f066000390000000506600270000006dd0660009a000000000067004b00000eb90000813d000000000007041b0000000107700039000000000067004b00000eb50000413d0000001f0030008c000000000651034f00000f990000a13d000000000040043f000007310830019800000fd80000c13d000006de07000041000000000900001900000fe20000013d000006b801000041000000000010043f000006b9010000410000197b00010430000000000043004b00000f520000813d000000400200043d0000000f05000039000000000505041a000000000005004b00000fa40000c13d0000001205000039000000000035041b0000001305000039000000000045041b0000000a070000290000002005700039000000000551034f000000000505043b0000001406000039000000000056041b0000004006700039000000000161034f000000000101043b0000001506000039000000000016041b00000060062000390000000000160435000000400120003900000000005104350000002001200039000000000041043500000000003204350000065f0020009c0000065f02008041000000400120021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006e2011001c70000800d020000390000000103000039000006e3040000411979196f0000040f00000001002001900000082f0000613d000000020100036700000e5e0000013d000000000001004b000000000200001900000ef80000613d000000a00200043d0000000303100210000007330330027f0000073303300167000000000232016f0000000101100210000000000112019f00000f6d0000013d000a00070000002d000000000100001900000f120000013d0000000a0700002900000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d020000390000000403000039000007060400004100000000050000190000000906000029000a00000007001d1979196f0000040f000000010020019000000001010000390000082f0000613d000000010010019000000f020000613d0000000a070000290000000107700039000000080070006c00000f030000c13d0000000801000029000000000010041b000006b60100004100000000001004430000000901000029000000040010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006b7011001c70000800202000039197919740000040f000000010020019000000f420000613d000000000101043b000000000001004b000010990000c13d000000020000006b00000f2e0000613d0000000301000029197918f90000040f000000400100043d0000002002100039000000000300041a0000000304000029000000000042043500000000003104350000065f0010009c0000065f01008041000000400110021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006db011001c70000800d0200003900000002030000390000070e040000410000000905000029000007f10000013d000000000001042f000000000043004b00000f520000813d000000400200043d0000001205000039000000000505041a000000000005004b00000fac0000613d0000001305000039000000000505041a000000000005004b00000fac0000613d000000000053004b00000fac0000213d000006e50100004100000b320000013d000000400100043d000006e402000041000005be0000013d000006bb020000410000002003000039000000010540008a0000000505500270000006bc0550009a00000080063000390000000006060433000000000062041b00000020033000390000000102200039000000000052004b00000f5a0000c13d000000000014004b00000f6b0000813d0000000304100210000000f80440018f000007330440027f000007330440016700000080033000390000000003030433000000000343016f000000000032041b000000010110021000000001011001bf0000000202000039000000000012041b0000000a010000290000000001010433000006b30010009c00000d520000213d0000000302000039000000000302041a000000010030019000000001023002700000007f0220618f0000001f0020008c00000000040000390000000104002039000000000343013f0000000100300190000007980000c13d000000200020008c00000f900000413d0000000303000039000000000030043f0000001f031000390000000503300270000006bd0330009a000000200010008c000006be030040410000001f022000390000000502200270000006bd0220009a000000000023004b00000f900000813d000000000003041b0000000103300039000000000023004b00000f8c0000413d000000200010008c00000fcc0000413d0000000302000039000000000020043f0000073104100198000010250000c13d0000002003000039000006be02000041000010320000013d0000000301300210000007330110027f0000073301100167000000000506043b000000000115016f0000000105300210000000000151019f00000fef0000013d000000400100043d000006f002000041000005be0000013d000000000054004b00000ecd0000413d0000001005000039000000000505041a000000000005004b00000ecd0000613d000006e00100004100000b320000013d0000000f05000039000000000035041b0000001005000039000000000045041b0000000a050000290000002005500039000000000151034f000000000101043b0000001105000039000000000015041b000000400520003900000000001504350000002001200039000000000041043500000000003204350000065f0020009c0000065f02008041000000400120021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006e6011001c70000800d020000390000000103000039000006e7040000411979196f0000040f00000001002001900000082f0000613d000000020100036700000e670000013d000000000001004b00000000020000190000103e0000613d0000000302100210000007330220027f000007330220016700000009030000290000000003030433000000000223016f0000000101100210000000000212019f0000103e0000013d000006de070000410000000009000019000000000a590019000000000aa1034f000000000a0a043b0000000000a7041b00000001077000390000002009900039000000000089004b00000fda0000413d000000000038004b00000fed0000813d0000000308300210000000f80880018f000007330880027f00000733088001670000000005590019000000000151034f000000000101043b000000000181016f000000000017041b000000010130021000000001011001bf000000000014041b0000002004000039000000400100043d0000000004410436000000000034043500000731083001980000001f0930018f0000004005100039000000000785001900000fff0000613d000000000a06034f000000000b05001900000000ac0a043c000000000bcb043600000000007b004b00000ffb0000c13d000000000009004b0000100c0000613d000000000686034f0000000308900210000000000907043300000000098901cf000000000989022f000000000606043b0000010008800089000000000686022f00000000068601cf000000000696019f000000000067043500000731022001970000000003350019000000000003043500000040022000390000065f0020009c0000065f0200804100000060022002100000065f0010009c0000065f010080410000004001100210000000000121019f00000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006c3011001c70000800d020000390000000103000039000006df040000411979196f0000040f00000001002001900000082f0000613d000000020100036700000e550000013d000006be020000410000002003000039000000010540008a0000000505500270000006bf0550009a0000000a0700002900000000067300190000000006060433000000000062041b00000020033000390000000102200039000000000052004b0000102b0000c13d000000000014004b0000103c0000813d0000000304100210000000f80440018f000007330440027f00000733044001670000000a033000290000000003030433000000000343016f000000000032041b000000010110021000000001021001bf0000000301000039000000000021041b000000000000041b000006b501000041000000000101041a0000000100100190000010490000c13d000006c801000041000000000010043f000006b9010000410000197b00010430000006c001000041000000000201041a000000000002004b0000107e0000c13d0000000802000029000006b0062001980000000002000019000006c202006041000000000262019f000000000021041b00000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d020000390000000303000039000006c40400004100000000050000191979196f0000040f00000001002001900000082f0000613d00000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d020000390000000103000039000006c5040000411979196f0000040f00000001002001900000082f0000613d00000064010000390000000201100367000000000101043b0000001602000039000000000012041b000000060000006b000007f40000613d00000006010000290000000202000039000000000021041b0000000103000039000000200030043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006c6011001c70000800d02000039000006c704000041000007f10000013d000006c101000041000000000010043f000006b9010000410000197b000104300000000801000029000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000082f0000613d000000000101043b000000000101041a0000004001100270000006b301100197000000070010002a000004990000413d0000000701100029000000090010006c000009460000213d00000cdd0000013d000000400700043d0000000001000411000406b00010019b000100800000003d00000007020000290000000506000029000000640170003900000080030000390000000000310435000007070100004100000000001704350000000401700039000000040300002900000000003104350000004401700039000700000002001d0000000000210435000000240170003900000000000104350000000601000029000000000101043300000084027000390000000000120435000000a402700039000000000001004b000010bb0000613d000000000300001900000000042300190000000005630019000000000505043300000000005404350000002003300039000000000013004b000010b40000413d0000001f03100039000007310330019700000000012100190000000000010435000000a4013000390000065f0010009c0000065f0100804100000060011002100000065f0070009c0000065f0200004100000000020740190000004002200210000000000121019f00000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f0000000902000029000a00000007001d1979196f0000040f0000000a0a00002900000060031002700000065f03300197000000200030008c00000020040000390000000004034019000000200640019000000000056a0019000010df0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b000010db0000c13d0000001f07400190000010ec0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f000300000001035500000001002001900000112c0000613d0000001f01400039000000600210018f0000000001a20019000000000021004b00000000020000390000000102004039000006b30010009c00000d520000213d000000010020019000000d520000c13d000000400010043f000000200030008c0000082f0000413d0000000a0200002900000000020204330000070b002001980000082f0000c13d0000070c02200197000007070020009c0000115a0000c13d00000007020000290000000102200039000000080020006c000000000701001900000005060000290000109f0000413d000000000100041a000000080010006c00000f2a0000613d0000082f0000013d00000008010000290000000702000029197917c20000040f0000000a0000006b000007f40000613d0000000701000029197918f90000040f00000000010000190000197a0001042e0000006003200210000000000331019f000006eb04000041000000000034041b000000400300043d0000002004300039000000000014043500000000002304350000065f0030009c0000065f03008041000000400130021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006db011001c70000800d020000390000000103000039000006ec04000041000007f10000013d000000000003004b000011300000c13d0000006002000039000011570000013d0000001f0230003900000708022001970000003f022000390000070904200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000006b30040009c00000d520000213d000000010050019000000d520000c13d000000400040043f0000001f0430018f00000000063204360000070a05300198000100000006001d00000000035600190000114a0000613d000000000601034f0000000107000029000000006806043c0000000007870436000000000037004b000011460000c13d000000000004004b000011570000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b0000115e0000c13d0000070d01000041000000000010043f000006e1010000410000197b0001043000000001020000290000065f0020009c0000065f0200804100000040022002100000065f0010009c0000065f010080410000006001100210000000000121019f0000197b0001043000000000430104340000000001320436000000000003004b000011730000613d000000000200001900000000051200190000000006240019000000000606043300000000006504350000002002200039000000000032004b0000116c0000413d000000000213001900000000000204350000001f0230003900000731022001970000000001210019000000000001042d00000020030000390000000004310436000000003202043400000000002404350000004001100039000000000002004b000011880000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b000011810000413d000000000312001900000000000304350000001f0220003900000731022001970000000001120019000000000001042d000006cf0010009c0000119e0000213d000000630010008c0000119e0000a13d00000002030003670000000401300370000000000101043b000006b00010009c0000119e0000213d0000002402300370000000000202043b000006b00020009c0000119e0000213d0000004403300370000000000303043b000000000001042d00000000010000190000197b00010430000000004301043400000000033204360000000004040433000000000043043500000040031000390000000003030433000000400420003900000000003404350000006002200039000000600110003900000000010104330000000000120435000000000001042d00000000430104340000000003320436000000000404043300000000004304350000004002200039000000400110003900000000010104330000000000120435000000000001042d000006cf0010009c000011cd0000213d000000230010008c000011cd0000a13d00000002020003670000000403200370000000000303043b000006b30030009c000011cd0000213d0000002304300039000000000014004b000011cd0000813d0000000404300039000000000242034f000000000202043b000006b30020009c000011cd0000213d00000024033000390000000004230019000000000014004b000011cd0000213d0000000001030019000000000001042d00000000010000190000197b000104300000000043010434000006b00330019700000000033204360000000004040433000006b304400197000000000043043500000040031000390000000003030433000000000003004b0000000003000039000000010300c039000000400420003900000000003404350000006002200039000000600110003900000000010104330000071a011001970000000000120435000000000001042d00000020030000390000000004310436000000000302043300000000003404350000004001100039000000000003004b000011f00000613d00000000040000190000002002200039000000000502043300000000015104360000000104400039000000000034004b000011ea0000413d000000000001042d000007340010009c000011f60000813d0000002001100039000000400010043f000000000001042d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b00010430000007350010009c000012010000813d0000004001100039000000400010043f000000000001042d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b000104300000001f0220003900000731022001970000000001120019000000000021004b00000000020000390000000102004039000006b30010009c000012130000213d0000000100200190000012130000c13d000000400010043f000000000001042d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b00010430000006d00020009c000012490000813d00000000040100190000001f0120003900000731011001970000003f011000390000073105100197000000400100043d0000000005510019000000000015004b00000000070000390000000107004039000006b30050009c000012490000213d0000000100700190000012490000c13d000000400050043f00000000052104360000000007420019000000000037004b0000124f0000213d00000731062001980000001f0720018f00000002044003670000000003650019000012390000613d000000000804034f0000000009050019000000008a08043c0000000009a90436000000000039004b000012350000c13d000000000007004b000012460000613d000000000464034f0000000306700210000000000703043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000043043500000000022500190000000000020435000000000001042d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b0001043000000000010000190000197b000104300000000905000039000000000405041a000000010640019000000001024002700000007f0220618f0000001f0020008c00000000010000390000000101002039000000000016004b0000127f0000c13d000000400100043d0000000003210436000000000006004b0000126c0000613d000000000050043f000000000002004b000012720000613d000006da0500004100000000040000190000000006430019000000000705041a000000000076043500000001055000390000002004400039000000000024004b000012640000413d000012730000013d00000732044001970000000000430435000000000002004b00000020040000390000000004006039000012730000013d00000000040000190000003f0240003900000731032001970000000002130019000000000032004b00000000030000390000000103004039000006b30020009c000012850000213d0000000100300190000012850000c13d000000400020043f000000000001042d0000071801000041000000000010043f0000002201000039000000040010043f00000719010000410000197b000104300000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b000104300000000a05000039000000000405041a000000010640019000000001024002700000007f0220618f0000001f0020008c00000000010000390000000101002039000000000016004b000012b90000c13d000000400100043d0000000003210436000000000006004b000012a60000613d000000000050043f000000000002004b000012ac0000613d000006de0500004100000000040000190000000006430019000000000705041a000000000076043500000001055000390000002004400039000000000024004b0000129e0000413d000012ad0000013d00000732044001970000000000430435000000000002004b00000020040000390000000004006039000012ad0000013d00000000040000190000003f0240003900000731032001970000000002130019000000000032004b00000000030000390000000103004039000006b30020009c000012bf0000213d0000000100300190000012bf0000c13d000000400020043f000000000001042d0000071801000041000000000010043f0000002201000039000000040010043f00000719010000410000197b000104300000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b000104300007000000000002000300000002001d000500000001001d000600000003001d000000000030043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d000000000101043b000000000101041a000000000001004b000012f00000c13d000000000100041a000000060010006c000013b60000a13d0000000602000029000000010220008a000700000002001d000000000020043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d000000000101043b000000000101041a000000000001004b0000000702000029000012dd0000613d000006f300100198000013b60000c13d0000000502000029000006b002200197000400000001001d000006b001100197000700000002001d000000000021004b000013ba0000c13d0000000601000029000000000010043f0000000601000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d000000000201043b000000000302041a0000000001000411000006b0041001970000071d0040009c000013330000613d000000070040006c000013330000613d000000000034004b000013330000613d000500000004001d000100000003001d000200000002001d0000000701000029000000000010043f0000000701000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d000000000101043b0000000502000029000000000020043f000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d000000000101043b000000000101041a000000ff0010019000000002020000290000000103000029000013c30000613d000000000003004b000013360000613d000000000002041b0000000701000029000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000301000029000006b001100197000500000001001d000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d000000000101043b000000000201041a0000000102200039000000000021041b000006cb01000041000000000010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006cc011001c70000800b02000039197919740000040f0000000100200190000013be0000613d000000000101043b000300000001001d0000000601000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d0000000302000029000000a00220021000000005022001af00000704022001c7000000000101043b000000000021041b00000004010000290000070400100198000013a30000c13d00000006010000290000000101100039000300000001001d000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d000000000101043b000000000101041a000000000001004b000013a30000c13d000000000100041a000000030010006b000013a30000613d0000000301000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000013b40000613d000000000101043b0000000402000029000000000021041b00000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d02000039000000040300003900000706040000410000000705000029000000050600002900000006070000291979196f0000040f0000000100200190000013b40000613d000000050000006b000013bf0000613d000000000001042d00000000010000190000197b000104300000072601000041000000000010043f000006e1010000410000197b000104300000073601000041000000000010043f000006e1010000410000197b00010430000000000001042f0000073701000041000000000010043f000006e1010000410000197b000104300000071e01000041000000000010043f000006e1010000410000197b00010430000000400100043d000007170010009c000013d40000813d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000001042d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b00010430000000400100043d000007170010009c000013ee0000813d0000008002100039000000400020043f0000001202000039000000000202041a00000000022104360000001303000039000000000303041a00000000003204350000001402000039000000000202041a000000400310003900000000002304350000001502000039000000000202041a00000060031000390000000000230435000000000001042d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b00010430000000400100043d000007380010009c000013ff0000813d0000006002100039000000400020043f00000040021000390000000000020435000000200210003900000000000204350000000000010435000000000001042d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b00010430000000400100043d000007380010009c000014150000813d0000006002100039000000400020043f0000000f02000039000000000202041a00000000022104360000001003000039000000000303041a00000000003204350000001102000039000000000202041a00000040031000390000000000230435000000000001042d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b00010430000006b0011001980000142d0000613d000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000014310000613d000000000101043b000000000101041a000006b301100197000000000001042d0000071401000041000000000010043f000006e1010000410000197b0001043000000000010000190000197b000104300008000000000002000100000004001d000400000002001d000600000001001d000700000003001d000000000030043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d000000000101043b000000000101041a000000000001004b0000145f0000c13d000000000100041a000000070010006c0000159f0000a13d0000000702000029000000010220008a000800000002001d000000000020043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d000000000101043b000000000101041a000000000001004b00000008020000290000144c0000613d000006f3001001980000159f0000c13d0000000602000029000006b002200197000300000001001d000006b001100197000800000002001d000000000021004b000015a30000c13d0000000701000029000000000010043f0000000601000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d000000000301043b000000000403041a0000000001000411000006b001100197000500000001001d0000071d0010009c000014a30000613d0000000502000029000000080020006c000014a30000613d000000050040006b000014a30000613d000200000004001d000600000003001d0000000801000029000000000010043f0000000701000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d000000000101043b0000000502000029000000000020043f000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d000000000101043b000000000101041a000000ff0010019000000006030000290000000204000029000015af0000613d000000000004004b000014a60000613d000000000003041b0000000801000029000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000401000029000006b001100197000600000001001d000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d000000000101043b000000000201041a0000000102200039000000000021041b000006cb01000041000000000010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006cc011001c70000800b02000039197919740000040f00000001002001900000159e0000613d000000000101043b000200000001001d0000000701000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d0000000202000029000000a00220021000000006022001af00000704022001c7000000000101043b000000000021041b00000003010000290000070400100198000015130000c13d00000007010000290000000101100039000200000001001d000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d000000000101043b000000000101041a000000000001004b000015130000c13d000000000100041a000000020010006b000015130000613d0000000201000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000159c0000613d000000000101043b0000000302000029000000000021041b00000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d02000039000000040300003900000706040000410000000805000029000000060600002900000007070000291979196f0000040f00000001002001900000159c0000613d000000060000006b000015a70000613d000006b60100004100000000001004430000000401000029000000040010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006b7011001c70000800202000039197919740000040f00000001002001900000159e0000613d000000000101043b000000000001004b0000159b0000613d000000400700043d00000064017000390000008002000039000400000002001d0000000000210435000000440170003900000007020000290000000000210435000000240170003900000008020000290000000000210435000007070100004100000000001704350000000401700039000000050200002900000000002104350000008402700039000000010100002900000000310104340000000000120435000000a402700039000000000001004b000015520000613d000000000400001900000000052400190000000006430019000000000606043300000000006504350000002004400039000000000014004b0000154b0000413d0000001f03100039000007310330019700000000012100190000000000010435000000a4013000390000065f0010009c0000065f0100804100000060011002100000065f0070009c0000065f0200004100000000020740190000004002200210000000000121019f00000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f0000000602000029000800000007001d1979196f0000040f000000080b00002900000060031002700000065f03300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b0019000015770000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000015730000c13d000000000006004b000015840000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000015ab0000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000006b30010009c000015e10000213d0000000100200190000015e10000c13d000000400010043f000000200030008c0000159c0000413d00000000010b04330000070b001001980000159c0000c13d0000070c01100197000007070010009c000015dd0000c13d000000000001042d00000000010000190000197b00010430000000000001042f0000072601000041000000000010043f000006e1010000410000197b000104300000073601000041000000000010043f000006e1010000410000197b000104300000073701000041000000000010043f000006e1010000410000197b00010430000000000003004b000015b30000c13d0000006002000039000015da0000013d0000071e01000041000000000010043f000006e1010000410000197b000104300000001f0230003900000708022001970000003f022000390000070904200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000006b30040009c000015e10000213d0000000100500190000015e10000c13d000000400040043f0000001f0430018f00000000063204360000070a05300198000400000006001d0000000003560019000015cd0000613d000000000601034f0000000407000029000000006806043c0000000007870436000000000037004b000015c90000c13d000000000004004b000015da0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b000015e70000c13d0000070d01000041000000000010043f000006e1010000410000197b000104300000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b0001043000000004020000290000065f0020009c0000065f0200804100000040022002100000065f0010009c0000065f010080410000006001100210000000000121019f0000197b0001043000010000000000020000000003010019000000400100043d000007170010009c000016460000813d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000200041a000000000032004b000016430000a13d000100000003001d000000000030043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000016440000613d000000000101043b000000000101041a000000000001004b000016150000c13d0000000103000029000000010330008a000016010000013d000000400100043d000006b40010009c0000000103000029000016460000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000030043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000016440000613d000000000301034f000000400100043d000006b40010009c000016460000213d000000000203043b000000000202041a0000008003100039000000400030043f0000006003100039000000e8042002700000000000430435000006f3002001980000000003000039000000010300c03900000040041000390000000000340435000006b0032001970000000003310436000000a002200270000006b3022001970000000000230435000000000001042d00000000010000190000197b000104300000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b000104300001000000000002000006b0022001970000071d0020009c000016520000c13d0000000101000039000000000001042d000100000002001d000006b001100197000000000010043f0000000701000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000016710000613d000000000101043b0000000102000029000000000020043f000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000016710000613d000000000101043b000000000101041a000000ff0110018f000000000001042d00000000010000190000197b00010430000006c001000041000000000101041a0000000002000411000000000012004b000016790000c13d000000000001042d0000072401000041000000000010043f000006b9010000410000197b00010430000006b003100197000000a004200210000000000434019f0000000d05000039000000000045041b000006ea02200197000027110020008c0000169e0000813d0000006001100212000016a20000613d000000000112019f000006eb04000041000000000014041b000000400100043d0000002004100039000000000024043500000000003104350000065f0010009c0000065f01008041000000400110021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006db011001c70000800d020000390000000103000039000006ec040000411979196f0000040f0000000100200190000016a60000613d000000000001042d000006ed01000041000000000010043f000006b9010000410000197b000104300000073901000041000000000010043f000006b9010000410000197b0001043000000000010000190000197b000104300001000000000002000100000001001d000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000016d40000613d000000000101043b000000000101041a000000000001004b000016d10000c13d000000000100041a0000000102000029000000000021004b000016d60000a13d000000010220008a000100000002001d000000000020043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000016d40000613d000000000101043b000000000101041a000000000001004b0000000102000029000016be0000613d000006f300100198000016d60000c13d000000000001042d00000000010000190000197b000104300000072601000041000000000010043f000006e1010000410000197b00010430000006b0011001970000000e02000039000000000302041a000006e803300197000000000313019f000000000032041b000000400200043d00000000001204350000065f0020009c0000065f02008041000000400120021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006d7011001c70000800d020000390000000103000039000006e9040000411979196f0000040f0000000100200190000016f20000613d000000000001042d00000000010000190000197b00010430000006d00020009c0000175c0000813d0000000903000039000000000403041a000000010540019000000001044002700000007f0440618f0000001f0040008c00000000060000390000000106002039000000000065004b000017620000c13d000000200040008c000017110000413d000000000030043f0000001f052000390000000505500270000006d90550009a000000200020008c000006da050040410000001f044000390000000504400270000006d90440009a000000000045004b000017110000813d000000000005041b0000000105500039000000000045004b0000170d0000413d0000001f0020008c0000172f0000a13d000000000030043f00000731052001980000173a0000613d000006da04000041000000020700036700000000060000190000000008160019000000000887034f000000000808043b000000000084041b00000001044000390000002006600039000000000056004b000017190000413d000000000025004b0000172c0000813d0000000305200210000000f80550018f000007330550027f000007330550016700000000011600190000000201100367000000000101043b000000000151016f000000000014041b000000010120021000000001011001bf000017400000013d000000000002004b0000173f0000613d0000000304200210000007330440027f00000733044001670000000201100367000000000101043b000000000141016f0000000102200210000000000121019f000017400000013d000006da040000410000000006000019000000000025004b000017230000413d0000172c0000013d0000000001000019000000000013041b0000000101000039000000000201041a000000000100041a000000000021004b0000175b0000613d00000733022001670000000001210019000000400200043d0000002003200039000000000013043500000000000204350000065f0020009c0000065f02008041000000400120021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006db011001c70000800d020000390000000103000039000006dc040000411979196f0000040f0000000100200190000017680000613d000000000001042d0000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b000104300000071801000041000000000010043f0000002201000039000000040010043f00000719010000410000197b0001043000000000010000190000197b00010430000000400200043d0000000b03000039000000000403041a000000000004004b000017710000613d000000000014004b000017880000413d000000000400041a000000000014004b0000178a0000213d000006d00010009c0000178c0000813d000000000013041b00000000001204350000065f0020009c0000065f02008041000000400120021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006d7011001c70000800d020000390000000103000039000006d2040000411979196f0000040f0000000100200190000017930000613d000000000001042d000006d6010000410000178d0000013d000006d5010000410000178d0000013d000006d30100004100000000001204350000065f0020009c0000065f020080410000004001200210000006e1011001c70000197b0001043000000000010000190000197b000104300001000000000002000006c002000041000000000502041a0000000002000414000006b0061001970000065f0020009c0000065f02008041000000c001200210000006c3011001c70000800d020000390000000303000039000006c404000041000100000006001d1979196f0000040f0000000100200190000017ac0000613d000000010000006b0000000001000019000006c20100604100000001011001af000006c002000041000000000012041b000000000001042d00000000010000190000197b00010430000006b001100197000000000010043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f0000000100200190000017c00000613d000000000101043b000000000101041a0000004001100270000006b301100197000000000001042d00000000010000190000197b000104300008000000000002000200000001001d000000400100043d000400000001001d000007340010009c000018e10000813d00000004010000290000002003100039000300000003001d000000400030043f0000000000010435000800000002001d000000000002004b000018f10000613d000000000100041a000500000001001d000006cb01000041000000000010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006cc011001c70000800b02000039197919740000040f0000000100200190000018f00000613d000000000101043b000700000001001d0000000501000029000000000010043f0000000401000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000001002001900000000805000029000018ad0000613d0000000202000029000006b0042001970000000702000029000000a002200210000000010050008c00000000030000190000070403006041000000000223019f000000000242019f000000000101043b000000000021041b000700000004001d000000000040043f0000000501000039000000200010043f00000000010004140000065f0010009c0000065f01008041000000c001100210000006db011001c70000801002000039197919740000040f00000008040000290000000100200190000018ad0000613d00000705024000d1000000000101043b000000000301041a0000000002230019000000000021041b000000070000006b000018f50000613d000600050040002d000800050000002d0000000001000019000018210000013d000000080700002900000000010004140000065f0010009c0000065f01008041000000c001100210000006c3011001c70000800d020000390000000403000039000007060400004100000000050000190000000706000029000800000007001d1979196f0000040f00000001002001900000000101000039000018ad0000613d0000000100100190000018110000613d00000008070000290000000107700039000000060070006c000018120000c13d0000000601000029000000000010041b000006b60100004100000000001004430000000201000029000000040010044300000000010004140000065f0010009c0000065f01008041000000c001100210000006b7011001c70000800202000039197919740000040f0000000100200190000018f00000613d000000000101043b000000000001004b0000000306000029000018ac0000613d000000400700043d0000000001000411000206b00010019b000100800000003d0000000502000029000000640170003900000080030000390000000000310435000007070100004100000000001704350000000401700039000000020300002900000000003104350000004401700039000500000002001d0000000000210435000000240170003900000000000104350000000401000029000000000101043300000084027000390000000000120435000000a402700039000000000001004b0000185b0000613d000000000300001900000000042300190000000005630019000000000505043300000000005404350000002003300039000000000013004b000018540000413d0000001f03100039000007310330019700000000012100190000000000010435000000a4013000390000065f0010009c0000065f0100804100000060011002100000065f0070009c0000065f0200004100000000020740190000004002200210000000000121019f00000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f0000000702000029000800000007001d1979196f0000040f000000080a00002900000060031002700000065f03300197000000200030008c00000020040000390000000004034019000000200640019000000000056a00190000187f0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b0000187b0000c13d0000001f074001900000188c0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000018af0000613d0000001f01400039000000600210018f0000000001a20019000000000021004b00000000020000390000000102004039000006b30010009c0000000306000029000018e10000213d0000000100200190000018e10000c13d000000400010043f000000200030008c000018ad0000413d00000000020a04330000070b00200198000018ad0000c13d0000070c02200197000007070020009c000018dd0000c13d00000005020000290000000102200039000000060020006c00000000070100190000183f0000413d000000000100041a000000060010006c000018ad0000c13d000000000001042d00000000010000190000197b00010430000000000003004b000018b30000c13d0000006002000039000018da0000013d0000001f0230003900000708022001970000003f022000390000070904200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000006b30040009c000018e10000213d0000000100500190000018e10000c13d000000400040043f0000001f0430018f00000000063204360000070a05300198000100000006001d0000000003560019000018cd0000613d000000000601034f0000000107000029000000006806043c0000000007870436000000000037004b000018c90000c13d000000000004004b000018da0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b000018e70000c13d0000070d01000041000000000010043f000006e1010000410000197b000104300000071801000041000000000010043f0000004101000039000000040010043f00000719010000410000197b0001043000000001020000290000065f0020009c0000065f0200804100000040022002100000065f0010009c0000065f010080410000006001100210000000000121019f0000197b00010430000000000001042f0000071001000041000000000010043f000006e1010000410000197b000104300000070f01000041000000000010043f000006e1010000410000197b0001043000010000000000020000000e03000039000000000203041a000006b000200198000019350000613d00000000050004160000001602000039000000000202041a000000000002004b0000191e0000613d00000000031200a900000000022300d9000000000012004b0000193d0000c13d000000000535004b0000193d0000413d000100000005001d00000000010004140000065f0010009c0000065f01008041000000c001100210000000000003004b000019150000613d000006c3011001c700008009020000390000073a040000410000000005000019000019160000013d0000073a020000411979196f0000040f000300000001035500000060011002700001065f0010019d000000010020019000000001050000290000000e03000039000019310000613d000000000005004b000019300000613d000000000103041a0000000002000414000006b0041001970000065f0020009c0000065f02008041000000c001200210000006c3011001c70000800902000039000000000305001900000000050000191979196f0000040f00000060031002700001065f0030019d00030000000103550000000100200190000019310000613d000000000001042d0000073b01000041000000000010043f000006b9010000410000197b00010430000000400100043d0000073c0200004100000000002104350000065f0010009c0000065f010080410000004001100210000006e1011001c70000197b000104300000071801000041000000000010043f0000001101000039000000040010043f00000719010000410000197b000104300000000c02000039000000000012041b000000400200043d00000000001204350000065f0020009c0000065f02008041000000400120021000000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006d7011001c70000800d020000390000000103000039000006d8040000411979196f0000040f0000000100200190000019570000613d000000000001042d00000000010000190000197b00010430000000000001042f0000065f0010009c0000065f0100804100000040011002100000065f0020009c0000065f020080410000006002200210000000000112019f00000000020004140000065f0020009c0000065f02008041000000c002200210000000000112019f000006c3011001c70000801002000039197919740000040f00000001002001900000196d0000613d000000000101043b000000000001042d00000000010000190000197b0001043000001972002104210000000102000039000000000001042d0000000002000019000000000001042d00001977002104230000000102000039000000000001042d0000000002000019000000000001042d00001979000004320000197a0001042e0000197b0001043000000000000000000000000000000000000000000000000000000000ffffffff0000000200000000000000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000008462151b00000000000000000000000000000000000000000000000000000000c3f909d300000000000000000000000000000000000000000000000000000000e8a3d48400000000000000000000000000000000000000000000000000000000f1d5f51600000000000000000000000000000000000000000000000000000000f542033e00000000000000000000000000000000000000000000000000000000f542033f00000000000000000000000000000000000000000000000000000000fee81cf400000000000000000000000000000000000000000000000000000000f1d5f51700000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000e8a3d48500000000000000000000000000000000000000000000000000000000e985e9c500000000000000000000000000000000000000000000000000000000f04e283e00000000000000000000000000000000000000000000000000000000cc5dfcb900000000000000000000000000000000000000000000000000000000d5abeb0000000000000000000000000000000000000000000000000000000000d5abeb0100000000000000000000000000000000000000000000000000000000e1a4521800000000000000000000000000000000000000000000000000000000cc5dfcba00000000000000000000000000000000000000000000000000000000d15b439a00000000000000000000000000000000000000000000000000000000c3f909d400000000000000000000000000000000000000000000000000000000c63adb2b00000000000000000000000000000000000000000000000000000000c87b56dd00000000000000000000000000000000000000000000000000000000a483011300000000000000000000000000000000000000000000000000000000b88d4fdd00000000000000000000000000000000000000000000000000000000c23dc68e00000000000000000000000000000000000000000000000000000000c23dc68f00000000000000000000000000000000000000000000000000000000c3db27c100000000000000000000000000000000000000000000000000000000b88d4fde00000000000000000000000000000000000000000000000000000000be37822800000000000000000000000000000000000000000000000000000000a483011400000000000000000000000000000000000000000000000000000000ad2f852a00000000000000000000000000000000000000000000000000000000b296d3c60000000000000000000000000000000000000000000000000000000095d89b40000000000000000000000000000000000000000000000000000000009f93f778000000000000000000000000000000000000000000000000000000009f93f77900000000000000000000000000000000000000000000000000000000a22cb4650000000000000000000000000000000000000000000000000000000095d89b410000000000000000000000000000000000000000000000000000000099a2557a000000000000000000000000000000000000000000000000000000008462151c000000000000000000000000000000000000000000000000000000008da5cb5b00000000000000000000000000000000000000000000000000000000938e3d7b0000000000000000000000000000000000000000000000000000000042842e0d000000000000000000000000000000000000000000000000000000006352211d0000000000000000000000000000000000000000000000000000000070a0823000000000000000000000000000000000000000000000000000000000715018a500000000000000000000000000000000000000000000000000000000715018a600000000000000000000000000000000000000000000000000000000730143c60000000000000000000000000000000000000000000000000000000070a082310000000000000000000000000000000000000000000000000000000070e1e8b8000000000000000000000000000000000000000000000000000000006352211e000000000000000000000000000000000000000000000000000000006c0360eb000000000000000000000000000000000000000000000000000000006f8b44b0000000000000000000000000000000000000000000000000000000004f6632ce0000000000000000000000000000000000000000000000000000000055f804b20000000000000000000000000000000000000000000000000000000055f804b3000000000000000000000000000000000000000000000000000000005bbb2177000000000000000000000000000000000000000000000000000000004f6632cf0000000000000000000000000000000000000000000000000000000054d1f13d0000000000000000000000000000000000000000000000000000000042842e0e0000000000000000000000000000000000000000000000000000000042966c680000000000000000000000000000000000000000000000000000000046bb5954000000000000000000000000000000000000000000000000000000001ab6ce56000000000000000000000000000000000000000000000000000000002a552059000000000000000000000000000000000000000000000000000000003c8463a0000000000000000000000000000000000000000000000000000000003c8463a1000000000000000000000000000000000000000000000000000000003fb80b15000000000000000000000000000000000000000000000000000000002a55205a000000000000000000000000000000000000000000000000000000003a99665c000000000000000000000000000000000000000000000000000000001ab6ce570000000000000000000000000000000000000000000000000000000023b872dd000000000000000000000000000000000000000000000000000000002569296200000000000000000000000000000000000000000000000000000000081812fb0000000000000000000000000000000000000000000000000000000013966db40000000000000000000000000000000000000000000000000000000013966db50000000000000000000000000000000000000000000000000000000018160ddd00000000000000000000000000000000000000000000000000000000081812fc00000000000000000000000000000000000000000000000000000000095ea7b30000000000000000000000000000000000000000000000000000000001ffc9a70000000000000000000000000000000000000000000000000000000002fa7c470000000000000000000000000000000000000000000000000000000006fdde03000000000000000000000000ffffffffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000389a75e10000000000000000000000000000000000000020000000800000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffff7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffbf6011321806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b83020000020000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000000000000000000000f92ee8a900000000000000000000000000000000000000040000001c0000000000000000bfa87805ed57dc1f0d489ce33be4c4577d74ccde357eeeee058a32c55c44a532405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5acebfa87805ed57dc1f0d489ce33be4c4577d74ccde357eeeee058a32c55c44a5313da8a5f161a6c3ff06a60736d0ed24d7963cc6a5c4fafd2fa1dae9bb908e07a5c2575a0e9e593c00f959f8c92f12db2869c3395a3b0502d05e2516446f71f85b3da8a5f161a6c3ff06a60736d0ed24d7963cc6a5c4fafd2fa1dae9bb908e07a4ffffffffffffffffffffffffffffffffffffffffffffffffffffffff74873927000000000000000000000000000000000000000000000000000000000dc149f0800000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e04cdc0855317fc903931370d8fa2cbf56b50c63f39e1a46f1d5859b2d91b2c2c40200000000000000000000000000000000000020000000200000000000000000c7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d200000000000000000000000000000000000000000000000000000000d7e6bcf8000000000000000000000000000000000000000000000000000000007448fbae02000000000000000000000000000000000000200000000c0000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d955391320200000200000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000006f5e881800000000000000000000000000000000000000200000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000001000000000000000002000000000000000000000000000000000000200000008000000000000000007810bd47de260c3e9ee10061cf438099dd12256c79485f12f94dbccc981e806c8981b339000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000800000000000000000fb115a68000000000000000000000000000000000000000000000000000000002e08a508000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000020000000000000000000000000199db6b3f784dbaaa5df3981a282a84eb13409a543eaaeb8e8f309c467b45e1891eabfe8e493f369f48e58fdf2609ff8809506ce57440a6f25fddc25308a38516e1540171b6c0c960b71a7020d9f60077f6af931a8bbf590da0223dacf75c7af02000000000000000000000000000000000000400000000000000000000000006bd5c950a8d8df17f772f5af37cb3655737899cbf903264b9795592da439661c39a5844729cae3e308f36a5ce933956d7c6367997d26743ca06a70b77c062d58c65a7bb8d6351c1cf70c95a316cc6a92839c986682d98bc35f958f4883f9d2a8905d981207a7d0b6c62cc46ab0be2a076d0298e4a86d0ab79882dbd01ac37378a630cab000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000000000002000000000000000000000000000000000000800000000000000000000000006d95873399671cd981e5dbfbb034ad9c7ad8030a29b541bfd5fb5796d5d999093ee55274000000000000000000000000000000000000000000000000000000004b07080b000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000060000000000000000000000000be59aad4e5e3cd0369b75babff1d2cf97c307e9d1ad1d4a7a22a32a8d0b9ed2affffffffffffffffffffffff00000000000000000000000000000000000000009a0dcf10a4d35ed2209787aa6b02577335bd59ab979fb43e2c0438f098bd81bd0000000000000000000000000000000000000000ffffffffffffffffffffffff0000000000000000000000000000000000000000000000aa4ec00224afccfdb7f21fccf4d64d86d532c4e4eb86c007b6ad57a460c27d724188625e755ec6cf6d00000000000000000000000000000000000000000000000000000000350a88b3000000000000000000000000000000000000000000000000ffffffffffffffbf7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe009bde339000000000000000000000000000000000000000000000000000000008398630700000000000000000000000000000000000000000000000000000000e58961bf000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000a14c4b50000000000000000000000000000000000000000000000000000000002f00000000000000000000000000000000000000000000000000000000000000ff0000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff3000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffdf000000000000000000000000000000000000000000000000fffffffffffffd7f000000000000000000000000000000000000000000000000fffffffffffffc5f000000000000000000000000000000000000000000000000ffffffffffffff9f4552433732314d6167696344726f70436c6f6e6561626c650000000000000000312e302e320000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000020000000000000000000000000000000000004000000080000000000000000017307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31f73316d400000000000000000000000000000000000000000000000000000000746f46070000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000001ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef150b7a020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000003ffffffe000000000000000000000000000000000000000000000000000000000ffffffe000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000d1a57ed60000000000000000000000000000000000000000000000000000000096234cb3d6c373a1aaa06497a540bc166d4b0359243a088eaf95e21d7253d0be2e07630000000000000000000000000000000000000000000000000000000000b562e8dd00000000000000000000000000000000000000000000000000000000b358b4ef0000000000000000000000000000000000000000000000000000000032c1995a0000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000008000000000000000008f4eb60400000000000000000000000000000000000000000000000000000000000000000000000000000000a3833016a4ec61f5c253d71c77522cc8a1cc11060200000000000000000000000000000000000060000000800000000000000000000000000000000000000000000000000000000000000000ffffffffffffff804e487b710000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c9200000000000000000000000000000000000000600000000000000000000000000000000000000000000000002052f8a2ff46283b30084e5d84c89a2fdbe7f74b59c896be00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff0000000000000000000000000000000100000003000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffd5d00dbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d0000000000000000000000000000000000000000000000000000000082b429000200000000000000000000000000000000000080000000800000000000000000df2d9b4200000000000000000000000000000000000000000000000000000000cfb3b942000000000000000000000000000000000000000000000000000000008c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925cf4700e4000000000000000000000000000000000000000000000000000000005b5e139effffffffffffffffffffffffffffffffffffffffffffffffffffffff5b5e139f0000000000000000000000000000000000000000000000000000000080ac58cd00000000000000000000000000000000000000000000000000000000777139070000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000002a55205a000000000000000000000000000000000000000000000000000000004906490600000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffe0000000000000000000000000000000000000000000000000ffffffffffffffc0a114810000000000000000000000000000000000000000000000000000000000ea553b3400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffa000000000000000000000000000000000000000000000000000000000b4457eaa0000000000000000000000000b98151bedee73f9ba5f2c7b72dea02d38ce49fc00000000000000000000000000000000000000000000000000000000b12d13ebb9b0f857000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000025a190078a271baef37dde75ea3e24ca50d843f7b0aa311c0bf416986ebc52d
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 35 Chains
Chain | Token | Portfolio % | Price | Amount | Value |
---|
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.