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 | |||
---|---|---|---|---|---|---|
836374 | 35 days 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:
INO
Compiler Version
v0.8.23+commit.f704f362
ZkSolc Version
v1.5.7
Optimization Enabled:
Yes with Mode 3
Other Settings:
shanghai EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {INOWritable} from "./writable/INOWritable.sol"; import {INOReadable} from "./readable/INOReadable.sol"; /** * @title INO * @notice Initial NFT Offering contract. * @dev Constructor replaced by the `initialize` function in {INOWritable}. */ contract INO is INOWritable, // 21 inherited component INOReadable // 7 inherited components {}
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {IINOWritable} from "./IINOWritable.sol"; import {INFT} from "../nft/interfaces/INFT.sol"; import {INOWritableInternal} from "./INOWritableInternal.sol"; import {INORestricted} from "./restricted/INORestricted.sol"; import {SaleStorage} from "../../common/SaleStorage.sol"; import {INOStorage} from "../INOStorage.sol"; // import struct import {BuyPermission, Phase} from "../../common/SaleStruct.sol"; import {FreeAllocation, PublicPhaseDetails} from "../INOStruct.sol"; import {UserAllocationFee} from "../../common/UserAllocationStruct.sol"; /** * @title INO * @notice Initial NFT Offering contract. * @dev This contract is used to deploy the NFT collection to mint/sale and handle the sale. */ contract INOWritable is IINOWritable, // 1 inherited component INOWritableInternal, // 6 inherited components INORestricted // 13 inherited components { /// @inheritdoc IINOWritable function buyAndMintWithERC20( uint256 spendNow, UserAllocationFee calldata allocation, bytes32[] calldata proof, BuyPermission calldata permission ) external override { SaleStorage.SetUp memory saleSetUp = SaleStorage.layout().setUp; _checkSaleUsesERC20(saleSetUp.paymentToken); _requireValidAllocation(allocation, proof); _checkMintParamsAndUpdateStorage( allocation.usrData.base.phaseId, allocation.usrData.account, spendNow, allocation.usrData.base.saleTokenPerPaymentToken, allocation.usrData.base.maxAllocation ); _permit2ApproveAndTransfer( saleSetUp.permit2, msg.sender, // delegate paying INOStorage.layout().setUp.paymentReceiver, saleSetUp.paymentToken, spendNow, permission ); } /// @inheritdoc IINOWritable function buyAndMintWithNative( UserAllocationFee calldata allocation, bytes32[] calldata proof ) external payable override { uint256 spendNow = msg.value; // delegate account paying for it SaleStorage.SetUp memory saleSetUp = SaleStorage.layout().setUp; _checkSaleUsesNative(saleSetUp.paymentToken); _requireValidAllocation(allocation, proof); _checkMintParamsAndUpdateStorage( allocation.usrData.base.phaseId, allocation.usrData.account, spendNow, allocation.usrData.base.saleTokenPerPaymentToken, allocation.usrData.base.maxAllocation ); // transfer ETH to receiver wallet (bool ok, bytes memory data) = INOStorage .layout() .setUp .paymentReceiver .call{value: spendNow}(""); // delegate can also spend on behalf of the user if (!ok) { revert INO_NativePaymentFailed(data); } } /// @inheritdoc IINOWritable function freeMint( FreeAllocation calldata allocation, bytes32[] calldata proof ) external override { _checkFreeMintParams(allocation, proof); _updateStorageOnFreeMint( allocation.phaseId, allocation.account, allocation.toMint ); _updateMintedAmount(allocation.phaseId, allocation.toMint); INFT(INOStorage.layout().collection).mint( allocation.account, // allow a delegate wallet to mint on behalf of the user allocation.toMint // mint whole free allocation in once ); } /// @inheritdoc IINOWritable function publicMintWithERC20( address mintFor, uint256 spendNow, PublicPhaseDetails calldata phaseDetails, BuyPermission calldata permission ) external override { SaleStorage.SetUp memory saleSetUp = SaleStorage.layout().setUp; _checkSaleUsesERC20(saleSetUp.paymentToken); _checkValidPublicMintPhaseDetails(phaseDetails); _checkMintParamsAndUpdateStorage( phaseDetails.phaseId, mintFor, spendNow, phaseDetails.unitPrice, phaseDetails.maxAllocationPerWallet ); _permit2ApproveAndTransfer( saleSetUp.permit2, msg.sender, // delegate paying INOStorage.layout().setUp.paymentReceiver, saleSetUp.paymentToken, spendNow, permission ); } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {SaleReadable} from "../../common/readable/SaleReadable.sol"; import {IINOReadable} from "./IINOReadable.sol"; import {INOStorage} from "../INOStorage.sol"; /** * @title INOReadable * @notice Initial NFT Offering contract. * @dev Constructor replaced by the `initialize` function in {INOWritable}. */ contract INOReadable is IINOReadable, // 1 inherited component SaleReadable // 5 inherited components { /// @inheritdoc IINOReadable function phaseMaxMint( string calldata phaseId ) public view override returns (uint256) { return INOStorage.layout().phaseMaxMint[phaseId]; } /// @inheritdoc IINOReadable function inoSetUp() public view override returns (INOStorage.SetUp memory) { return INOStorage.layout().setUp; } /// @inheritdoc IINOReadable function mintedInPhase( string calldata phaseId ) public view override returns (uint256) { return INOStorage.layout().mintedInPhase[phaseId]; } /// @inheritdoc IINOReadable function nftCollection() public view override returns (address) { return INOStorage.layout().collection; } function nftCollectionData() public view override returns (INOStorage.NFTCollectionData memory) { return INOStorage.layout().nftData; } /// @inheritdoc IINOReadable function totalMinted() public view override returns (uint256) { return INOStorage.layout().totalMinted; } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; // import struct import {BuyPermission} from "../../common/SaleStruct.sol"; import {UserAllocationFee} from "../../common/UserAllocationStruct.sol"; import {FreeAllocation, PublicPhaseDetails} from "../INOStruct.sol"; /** * @title IINOWritable * @notice Defines external and public functions for {INOWritable}. */ interface IINOWritable { /** * @notice Buy and mint NFTs with ERC20 tokens. If {SaleStorage.SetUp.paymentToken} is not set, * this function will revert and tell the user to use {buyAndMintWithNative} instead. * * @param spendNow Amount of ERC20 tokens to spend now. * @param allocation Allocation data of an `acount`. * @param proof Merkle tree proof of an `acount`'s allocation. * @param permission Permission data of an `acount`. */ function buyAndMintWithERC20( uint256 spendNow, UserAllocationFee calldata allocation, bytes32[] calldata proof, BuyPermission calldata permission ) external; /** * @notice Buy and mint NFTs with blockchain's native currency (ETH, BNB, MATIC, etc...). If * {SaleStorage.SetUp.paymentToken} is set, this function will revert and tell the user to use * {buyAndMintWithERC20} instead. * * @param allocation Allocation data of an `acount`. * @param proof Merkle tree proof of an `acount`'s allocation. */ function buyAndMintWithNative( UserAllocationFee calldata allocation, bytes32[] calldata proof ) external payable; /** * @notice Allows whitelisted addresses to mint NFTs for free/giveaways. * * @param allocation Allocation data of an `acount`. * @param proof Merkle tree proof of an `acount`'s allocation. */ function freeMint( FreeAllocation calldata allocation, bytes32[] calldata proof ) external; /** * @notice Allows the public to mint NFTs. * * @param mintFor Wallet address of the buyer (wallet delegation). * @param spendNow Amount of ERC20 tokens to spend now. * @param phaseDetails Details of the current phase. * @param permission Permission data of an `acount`. */ function publicMintWithERC20( address mintFor, uint256 spendNow, PublicPhaseDetails calldata phaseDetails, BuyPermission calldata permission ) external; }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {INOStorage} from "../../INOStorage.sol"; /** * @title INFT * @notice Define external and public functions used by NFTs listed in INOs. */ interface INFT { /// @dev Removes default royalty information. function deleteDefaultRoyalty() external; /** * @notice Initialize a clones NFT to sell & mint for an INO. * @dev Need to be public as childs override it while calling {super.initialize()}. * * @param data The NFT collection data. * @param initialOwner The initial owner of the NFT collection. * @param ino_ The linked INO contract address. */ function initialize( INOStorage.NFTCollectionData calldata data, address initialOwner, address ino_ ) external; /** * @notice Mint tokens, restricted to the INO contract. * * @dev If the implementing token uses _safeMint(), or a feeRecipient with a malicious receive() * hook is specified, the token or fee recipients may be able to execute another mint in the * same transaction via a separate INO contract. * This is dangerous if an implementing token does not correctly update the minterNumMinted * and currentTotalSupply values before transferring minted tokens, as INO references these * values to enforce token limits on a per-wallet and per-stage basis. * * ERC721A tracks these values automatically, but this note and nonReentrant modifier are left * here to encourage best-practices when referencing this contract. * * @param minter The address to mint to. * @param quantity The number of tokens to mint. */ function mint(address minter, uint256 quantity) external; /** * @notice Mint all unsold NFTs to `receiver`. */ function postmintAllUnsold(address receiver) external; /// @notice Mints `toMint` to `receiver` and reduces the max supply if does not mint all left. function postmintAndReduceSupply( address receiver, uint256 toMint ) external returns (uint256 reducedBy); /** * @notice Allow NFT collection owner to mint NFTs to his wallet BEFORE the INO starts. Mostly used to * reward the team behind the project. Can also be used if airdrops/giveaway are introduced * after the INO contract has been deployed. * @dev Can not be called even if INO is paused. */ function premint(address receiver, uint256 amount) external; /** * @notice BE CAREFUL: once max supply is reduced it can never be increased again. * @dev Can only reduce the max supply between `totalSupply()` and `maxSupply()`. */ function reduceSupplyTo(uint256 newMaxSupply) external; /// @dev Resets royalty information for the token id back to the global default. function resetTokenRoyalty(uint256 tokenId) external; /** * @dev Sets the royalty information that all ids in this contract will default to. * * @param receiver Address receiving royalties. * @param feeNumerator Royalties in basis points. */ function setDefaultRoyalty(address receiver, uint96 feeNumerator) external; function setTokenRoyalty( uint256 tokenId, address receiver, uint96 feeNumerator ) external; /** * @notice Returns a set of mint stats for the address. * * @dev NOTE: Implementing contracts should always update these numbers before transferring any tokens * with _safeMint() to mitigate consequences of malicious onERC721Received() hooks. * * @param minter The minter address. * * @return minterNumMinted The number of tokens minted by `minter`. * @return currentTotalSupply The current total supply of NFT. * @return maxSupply The maximum supply of NFT. */ function getMintStats( address minter ) external view returns ( uint256 minterNumMinted, uint256 currentTotalSupply, uint256 maxSupply ); }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {MerkleProof} from "openzeppelin-contracts/utils/cryptography/MerkleProof.sol"; import {SaleWritableInternal} from "../../common/writable/SaleWritableInternal.sol"; import {IINOWritable} from "./IINOWritable.sol"; import {IINOWritableInternal} from "./IINOWritableInternal.sol"; import {INFT} from "../nft/interfaces/INFT.sol"; import {SaleStorage} from "../../common/SaleStorage.sol"; import {INOStorage} from "../INOStorage.sol"; // import struct import {Phase} from "../../common/SaleStruct.sol"; import {FreeAllocation, PublicPhaseDetails} from "../INOStruct.sol"; import {UserAllocationFee} from "../../common/UserAllocationStruct.sol"; /** * @title INO * @notice Initial NFT Offering contract. * @notice Defines internal functions for `INOWritable`. */ contract INOWritableInternal is SaleWritableInternal, // 4 inherited components IINOWritableInternal // 1 inherited component { /////////////////////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////// PARAMS CHECKS //////////////////////////////////////// /////////////////////////////////////////////////////////////////////////////////////////////// function _checkBuyAndMintParams( string calldata phaseId, address buyer, uint256 toMint, uint256 reserveNow, uint256 maxAllocation, uint256 summedMaxPhaseCap, uint256 maxPhaseCap ) internal { _checkBuyReserveParams( phaseId, buyer, reserveNow, maxAllocation, summedMaxPhaseCap, maxPhaseCap ); _checkMaxMintInPhase(phaseId, toMint); _checkMaxMintWholeINO(toMint); } function _checkSaleUsesERC20(address saleSetUpPaymentToken) internal pure { if (saleSetUpPaymentToken == address(0)) { revert INO_UseInstead("buyAndMintWithNative"); } } function _checkSaleUsesNative( address saleSetUpPaymentToken ) internal pure { if (saleSetUpPaymentToken != address(0)) { revert INO_UseInstead("buyAndMintWithERC20"); } } function _checkFreeMintParams( FreeAllocation calldata allocation, bytes32[] calldata proof ) internal { // both replace {_checkBuyReserveParams} call _checkValidFreeAllocation(allocation, proof); _requireOpenedSaleAndPhase(allocation.phaseId); _checkMaxMintInPhase(allocation.phaseId, allocation.toMint); _checkMaxMintWholeINO(allocation.toMint); } function _checkMaxMintInPhase( string calldata phaseId, uint256 toMint ) internal view { uint256 maxMintInPhase = INOStorage.layout().phaseMaxMint[phaseId]; uint256 mintedInPhase = INOStorage.layout().mintedInPhase[phaseId]; uint256 newTotal = mintedInPhase + toMint; if (newTotal > maxMintInPhase) { revert INO_MaxMintInPhaseReached( maxMintInPhase, newTotal - maxMintInPhase ); } } function _checkMaxMintWholeINO(uint256 toMint) internal view { uint256 maxMint = INOStorage.layout().nftData.maxCap; uint256 minted = INOStorage.layout().totalMinted; uint256 newTotal = minted + toMint; if (newTotal > maxMint) { revert INO_MaxMintINOReached(maxMint, newTotal - maxMint); } } /// @dev Different params from `SaleWritableInternal._requireValidAllocation` BUT same logic function _checkValidFreeAllocation( FreeAllocation calldata allocation, bytes32[] calldata proof ) internal view returns (bool) { if ( !MerkleProof.verify( proof, SaleStorage.layout().phases.data[allocation.phaseId].rootHash, keccak256(abi.encode(address(this), block.chainid, allocation)) ) ) revert SaleWritableInternal_AllocationNotFound(); return true; } function _checkBuyIsMultipleOfUnitPrice( uint256 spendNow, uint256 bought, uint256 unitPrice, uint256 maxAllocation ) internal pure { if (bought + spendNow != maxAllocation) { if (spendNow % unitPrice != 0) { revert INO_OnlyUseMultipleOf(unitPrice); } } } function _checkValidPublicMintPhaseDetails( PublicPhaseDetails calldata phaseDetails ) internal view { if ( SaleStorage.layout().phases.data[phaseDetails.phaseId].rootHash != keccak256(abi.encode(address(this), block.chainid, phaseDetails)) ) { revert INO_PhaseDetailsNotFound(); } } /////////////////////////////////////////////////////////////////////////////////////////////// /////////////////////////////////////// STORAGE UPDATE /////////////////////////////////////// /////////////////////////////////////////////////////////////////////////////////////////////// function _checkMintParamsAndUpdateStorage( string calldata phaseId, address buyer, uint256 spendNow, uint256 unitPrice, uint256 maxAllocation ) internal { uint256 toMint = spendNow / unitPrice; uint256 maxPhaseCap = SaleStorage .layout() .phases .data[phaseId] .maxPhaseCap; _checkBuyIsMultipleOfUnitPrice( spendNow, SaleStorage.layout().ledger.allocationReservedByIn[buyer][phaseId], unitPrice, maxAllocation ); _checkBuyAndMintParams( phaseId, buyer, toMint, spendNow, maxAllocation, SaleStorage.layout().ledger.summedMaxPhaseCap, maxPhaseCap ); /// @custom:audit CEI pattern _updateStorageOnBuy(spendNow, phaseId, buyer, maxPhaseCap, toMint); INFT(INOStorage.layout().collection).mint(buyer, toMint); } function _updateMintedAmount( string calldata phaseId, uint256 toMint ) internal { INOStorage.layout().mintedInPhase[phaseId] += toMint; INOStorage.layout().totalMinted += toMint; } /// @custom:audit when total raised reached, it will close the phase and/or the whole sale function _updateStorageOnBuy( uint256 toSpend, string calldata phaseId, address buyer, uint256 maxMintPhaseCap, uint256 toMint ) internal { SaleWritableInternal._updateStorageOnBuy( toSpend, phaseId, buyer, maxMintPhaseCap ); _updateMintedAmount(phaseId, toMint); } function _updateStorageOnFreeMint( string calldata phaseId, address buyer, uint256 toMint ) internal { SaleStorage.Ledger storage ledger = SaleStorage.layout().ledger; uint256 freeAllocationMintedBy = ledger.freeAllocationMintedBy[buyer][ phaseId ]; // avoids replay attack & whole allocation minted in one tx in {freeMint} if (freeAllocationMintedBy > 0) { revert SaleWritable_AllocationExceeded(toMint, toMint); } ledger.freeAllocationMintedBy[buyer][phaseId] += toMint; } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {Clones} from "openzeppelin-contracts/proxy/Clones.sol"; import {INFT} from "../../nft/interfaces/INFT.sol"; import {IINORestricted} from "./IINORestricted.sol"; import {IINORestrictedInternal} from "./IINORestrictedInternal.sol"; import {RestrictedWritable} from "../../../common/writable/restricted/RestrictedWritable.sol"; // import struct import {Status, Phase} from "../../../common/SaleStruct.sol"; import {INOPhase} from "../../INOStruct.sol"; import {ERC721SequentialId} from "../../nft/ERC721SequentialId.sol"; // storage import {INOStorage} from "../../INOStorage.sol"; import {SaleStorage} from "../../../common/SaleStorage.sol"; /** * @title IRestrictedWritable * @notice Only the owner of the contract can call these methods. */ contract INORestricted is IINORestricted, IINORestrictedInternal, RestrictedWritable { /// @inheritdoc IINORestricted function initialize( SaleStorage.SetUp calldata saleSetUp, address owner, INOStorage.SetUp calldata inoSetUp, string[] calldata phaseIds, INOPhase[] calldata phases ) external override initializer { if (inoSetUp.paymentReceiver == address(0)) { revert INORestricted_Init_PaymentReceiverIsZeroAddr(); } if (inoSetUp.projectWallet == address(0)) { revert INORestricted_Init_ProjectWalletIsZeroAddr(); } // inherited from {RestrictedWritable.} _initializeSale(saleSetUp); _setOwnerRights(owner); INOStorage.layout().setUp = inoSetUp; // inherited from {RestrictedWritable.} _updateSetINOPhases(phaseIds, phases); emit INO_Initialized(saleSetUp, owner, inoSetUp, phaseIds, phases); } /// @inheritdoc IINORestricted function deployNftToSell( address nftToClone, INOStorage.NFTCollectionData calldata data ) external override onlyRole(DEFAULT_ADMIN_ROLE) reinitializer(2) returns (address collection) { _requireSaleNotStarted(); _checkValidClone(nftToClone); _checkNFTData(data); // collection = _clone(nftToClone, data); collection = address(new ERC721SequentialId()); INOStorage.layout().nftData = data; INOStorage.layout().collection = collection; INFT(collection).initialize(data, _msgSender(), address(this)); emit INO_DeployedNftToSell(collection, data); } function updatePhaseMaxMintAndMerkleRoot( string calldata phaseId, uint256 phaseMaxMint, bytes32 merkleRoot ) external override onlyRole(DEFAULT_ADMIN_ROLE) { /// @custom:audit verifies underneath the phase is not completed updatePhaseMerkleRoot(phaseId, merkleRoot); emit INO_PhaseMaxMintUpdated( phaseId, INOStorage.layout().phaseMaxMint[phaseId], phaseMaxMint ); INOStorage.layout().phaseMaxMint[phaseId] = phaseMaxMint; } /// @inheritdoc IINORestricted function updateSetPhase( string calldata phaseId_, INOPhase calldata phase_ ) external override onlyRole(DEFAULT_ADMIN_ROLE) { _isSaleNot(Status.COMPLETED); emit INO_SinglePhaseUpdate( phaseId_, SaleStorage.layout().phases.data[phaseId_], phase_ ); _updateSetINOPhase(phaseId_, phase_); } // TODO: gas report + testnet txs /// @inheritdoc IINORestricted function updateSetPhases( string[] calldata phaseIdentifiers_, INOPhase[] calldata phases_ ) public override onlyRole(DEFAULT_ADMIN_ROLE) { _isSaleNot(Status.COMPLETED); // inherited from {RestrictedWritable} _updateSetINOPhases(phaseIdentifiers_, phases_); emit INO_BatchPhaseUpdate(phaseIdentifiers_, phases_); } // function _clone( // address nftToClone, // INOStorage.NFTCollectionData calldata data // ) internal returns (address) { // bytes32 salt = keccak256( // abi.encode(msg.sender, data, block.timestamp) // ); // return Clones.cloneDeterministic(nftToClone, salt); // } function _updateSetINOPhase( string calldata phaseId_, INOPhase calldata phase_ ) internal { // inherited from {RestrictedWritable} _setPhase( SaleStorage.layout().ledger.summedMaxPhaseCap, SaleStorage.layout().phases.data[phaseId_].maxPhaseCap, phase_.base, phaseId_ ); INOStorage.layout().phaseMaxMint[phaseId_] = phase_.phaseMaxMint; } function _updateSetINOPhases( string[] calldata phaseIdentifiers_, INOPhase[] calldata phases_ ) internal { if (phaseIdentifiers_.length != phases_.length) { revert RestrictedWritableInternal_DifferentArraysLength(); } uint256 length = phaseIdentifiers_.length; //slither-disable-next-line uninitialized-local for (uint256 i; i < length; ++i) { /// @dev less¬ gas efficient, but more readable _updateSetINOPhase(phaseIdentifiers_[i], phases_[i]); } } function _requireSaleNotStarted() internal view { Status current = SaleStorage.layout().ledger.status; if (current != Status.NOT_STARTED) { revert INORestricted_SaleStarted(current); } } /// @dev Check name, symbol, and max cap of the NFT collection. function _checkNFTData( INOStorage.NFTCollectionData calldata data ) internal pure { if (bytes(data.name).length < 2) { revert INORestricted_Deploy_Name2CharsMin(); } if (bytes(data.symbol).length < 1) { revert INORestricted_Deploy_Symbole1CharMin(); } if (data.maxCap == 0) { revert INORestricted_Deploy_MaxCapNotSet(); } } function _checkValidClone(address clone) internal pure { if (clone == address(0)) { revert INORestricted_Deploy_NftToCloneIsZeroAddr(); } } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; // import struct import {Status, Phase} from "./SaleStruct.sol"; /** * @author https://github.com/Theo6890 * @title SaleStorage * @notice Mapps the storage layout of the {Sale} contract. * @dev Diamond proxy (ERC-2535) storage style. */ library SaleStorage { /** * @notice Struct reprensenting the main setup of the Sale. * * @param paymentToken Address of the default token used to reserve allocation through the Sale. * If `address(0)`, it means native token of the chain (ETH, BNB, etc...). * @param permit2 Official address of the {Permit2} library deployed by Uniswap. */ struct SetUp { address paymentToken; address permit2; } /** * @notice Struct reprensenting the setup of each phase of the Sale. * @dev Status of the phase is the only value that can be updated by Sale contract itself due to user's * interactions with the contract. * * @param ids List of all phases identifiers. * @param data Mapping of data of each phases. */ struct Phases { string[] ids; mapping(string => Phase) data; } /** * @notice Struct reprensenting data of the Sale which are always updated by user's interactions with * the Sale contract. * * @param status Enum representing the current status of the Sale. * @param summedMaxPhaseCap Sum of maximum cap of each phase expressed in {SetUp.paymentToken}. * @param totalRaised Total amount of paymentToken raised for this Sale, * expressed in {SetUp.paymentToken}. * @param raisedInPhase Amount of paymentToken raised for each phase, expressed in {SetUp.paymentToken}. * @param allocationReservedByIn Amount of paymentToken paid by phase by each user, * expressed in {SetUp.paymentToken}. */ struct Ledger { Status status; uint256 summedMaxPhaseCap; uint256 totalRaised; mapping(string => uint256) raisedInPhase; mapping(address => mapping(string => uint256)) allocationReservedByIn; mapping(address => mapping(string => uint256)) freeAllocationMintedBy; } /** * @notice Struct reprensenting the whole storage layout of the Sale contract. * * @param setUp reprensenting the main setup of the Sale. * @param phases reprensenting the setup of each phase of the Sale. * @param ledger reprensenting data of the Sale which are always updated by user's interactions with * the Sale contract. */ struct SaleStruct { SetUp setUp; Phases phases; Ledger ledger; } /// @notice Storage position of {SaleStruct} in {Sale} contract. bytes32 public constant Sale_STORAGE = keccak256("common.storage"); /** * @return igoStruct Whole storage of {Sale} contract. */ function layout() internal pure returns (SaleStruct storage igoStruct) { bytes32 position = Sale_STORAGE; assembly { igoStruct.slot := position } } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; /** * @title INOStorage * @notice Mapps the storage layout of the {INO} contract. * @dev Diamond proxy (ERC-2535) storage style. */ library INOStorage { /** * @notice Struct reprensenting the main setup of the INO. * * @param paymentReceiver The address which will receive the funds from the INO. * @param projectWallet The address of the project issuing NFTs - transfer ownership once sale closed. */ struct SetUp { address paymentReceiver; address projectWallet; } /** * @notice Struct reprensenting the data of the NFT collection to be deployed through INO. * * @param name The name of the NFTs to be minted during the INO. * @param symbol The symbol of the NFTs to be minted during the INO. * @param uri The base URI of the NFTs to be minted during the INO - only used for reveal on minint, * otherwise the uri will be an empty string (blackbox and reveal date cases). * @param maxCap The maximum number of NFTs to be minted during and after (if not sold out) the INO. * @param startTokenId The first token id to be minted during the INO. */ struct NFTCollectionData { string name; string symbol; string uri; uint256 maxCap; uint256 startTokenId; } /** * @notice Struct reprensenting the whole storage layout of the INO contract. * * @param setUp Struct reprensenting the main setup of the INO - modified by owner interactions only. * @param nftData Struct reprensenting the data of the NFT collection to be deployed through INO * - modified by owner interactions only. * @param collection The address of the NFT collection to be deployed and minted through INO - modified * by owner interactions only. * @param phaseMaxMint Maximum number of NFTs to be minted in a specific phase - modified by owner * interactions only. * @param mintedInPhase Number of NFTs minted in a specific phase - modified by INO contract * interaction. * @param totalMinted Total number of NFTs minted in the whole INO - modified by INO contract * interaction. */ struct INOStruct { // modified by owner interactions only SetUp setUp; NFTCollectionData nftData; address collection; mapping(string => uint256) phaseMaxMint; // modified by INO contract interaction mapping(string => uint256) mintedInPhase; uint256 totalMinted; } /// @notice Storage position of {INOStruct} in {INO} contract. bytes32 public constant INO_STORAGE = keccak256("ino.storage"); /** * @return inoStruct Whole storage of {INO} contract. */ function layout() internal pure returns (INOStruct storage inoStruct) { bytes32 position = INO_STORAGE; assembly { inoStruct.slot := position } } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; /** * @notice Shared enum representing the different status of a phase or the whole IGO. * * @custom:value NOT_STARTED IGO/Phase created but not started; allocations/buyAndMint are allowed. * @custom:value OPENED IGO/Phase started according to start date; allocations/buyAndMint are allowed. * @custom:value COMPLETED IGO/Phase everything has been sold or time has been elapsed; * allocations/buyAndMint can't be reserved anymore. * @custom:value PAUSED IGO/Phase has been paused by the owner; allocations/buyAndMint can't be * reserved until further notice. */ enum Status { NOT_STARTED, OPENED, COMPLETED, PAUSED } /** * @notice Struct representing an allocation of a wallet for a specific phase of a sale. * * @param phaseId Phase identifier of the in the current sale, e.g. "vpr-social-task", * "sale-public-phase-1", "ino-public" etc... * @param maxAllocation Maximum amount to spend in {SaleStorage.SetUp.paymentToken}. * @param saleTokenPerPaymentToken Price per token/nft of the project behind the Sale, expressed in * {SaleStorage.SetUp.paymentToken}. */ struct Allocation { string phaseId; uint256 maxAllocation; uint256 saleTokenPerPaymentToken; } /** * @notice Struct representing a buy permission signed by `msg.sender` for * {SaleWritable.reserveAllocation} function to use with {Permit2} library. * * @dev Compulsory to interact with {Permit2.permitTransferFrom} in * {SaleWritableInternal._reserveAllocation}. * * @param signature {Permit2} signature to transfer tokens from the buyer to {SaleVesting}. * @param deadline Seadline on the permit signature. * @param nonce Unique value for every token owner's signature to prevent signature replays. */ struct BuyPermission { bytes signature; uint256 deadline; uint256 nonce; } /** * @notice Shared struct representing the data of a phase. * * @param status Enum representing the current status of the phase. * @param rootHash Merkle root hash or hash of a metadata configuration: contains keccas256 hash of 3 encoded values: 1. address(this) 2. chainid 3. any of: UserAllocationFee | FreeAllocation | PublicPhaseDetails * @param startAt Timestamp at which the phase will be opened to reserve allocation. * @param endAt Timestamp at which the phase will not accept allocation reservation anymore. * @param maxPhaseCap Maximum amount of {SaleStorage.SetUp.paymentToken} for this phase. */ struct Phase { Status status; bytes32 rootHash; uint128 startAt; uint128 endAt; uint256 maxPhaseCap; }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {Phase} from "../common/SaleStruct.sol"; /** * @notice Struct representing a free allocation and user based for a specific phase of a sale. * Whitelisted addresses will mint NFTs for free. * * @param phaseId Phase identifier of the current sale. * @param toMint Amount of NFT to be minted. * @param account Wallet address of the buyer. */ struct FreeAllocation { string phaseId; uint256 toMint; address account; } /** * @notice Struct representing the details of a public phase of a sale. * * @param phaseId Phase identifier of the current sale. * @param unitPrice Price of each NFT in this phase. * @param maxAllocationPerWallet Maximum amount of tokens that can be spent by a wallet in this phase, * expressed in {SaleStorage.SetUp.paymentToken}. */ struct PublicPhaseDetails { string phaseId; uint256 unitPrice; uint256 maxAllocationPerWallet; } /** * @notice Struct representing a phase of an INO sale. * * @param base Phase struct from {SaleStruct} shared with IGO sales. * @param phaseMaxMint Maximum amount of NFTs that can be minted in this phase. */ struct INOPhase { Phase base; uint256 phaseMaxMint; }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {Allocation} from "../common/SaleStruct.sol"; /** * @notice Struct representing a user based allocation for a specific phase of a sale. * * @dev Backend is in charge of generating an allocation, which will depends on the sale type: * - IGO: allocation based on the tier from which wallet is part of, * - VPR IGO: off-chain backend lottery + allocation based on off-chain actions, e.g. * * social task: +50% from base price, * * in-game tasks: +33% from base price, * * etc... * - INO: allocation based on SFUND/SFNTS staked-farmed. * * @param base User based allocation data. * @param account Wallet address of the buyer. */ struct UserAllocation { Allocation base; address account; } /** * @notice Struct representing a user based allocation with a refund fee. * * @param usrData User based allocation data. * @param refundFee Fee to be paid by the buyer in case of refund, expressed in * {SaleStorage.SetUp.paymentToken} - decimals defined in {IGOVesting.decimals}. */ struct UserAllocationFee { UserAllocation usrData; uint256 refundFee; }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {ISaleReadable} from "../readable/ISaleReadable.sol"; import {IRestrictedWritableInternal} from "../writable/restricted/IRestrictedWritableInternal.sol"; import {ISaleWritableInternal} from "../writable/ISaleWritableInternal.sol"; import {SaleStorage} from "../SaleStorage.sol"; // import struct import {Status, Phase} from "../SaleStruct.sol"; /** * @title SaleReadable * @notice Read-only contract of {Sale} data. */ contract SaleReadable is ISaleReadable, // 1 inherited component ISaleWritableInternal, // 1 inherited component IRestrictedWritableInternal // 1 inherited component { /// @inheritdoc ISaleReadable function freeAllocationMintedBy( address account, string calldata phaseId ) external view override returns (uint256) { return SaleStorage.layout().ledger.freeAllocationMintedBy[account][ phaseId ]; } /// @inheritdoc ISaleReadable function summedMaxPhaseCap() external view override returns (uint256) { return SaleStorage.layout().ledger.summedMaxPhaseCap; } /// @inheritdoc ISaleReadable function allocationReservedByIn( address account, string calldata phaseId ) external view override returns (uint256) { return SaleStorage.layout().ledger.allocationReservedByIn[account][ phaseId ]; } /// @inheritdoc ISaleReadable function phase( string memory phaseId ) external view override returns (Phase memory phase_) { phase_ = SaleStorage.layout().phases.data[phaseId]; } /// @inheritdoc ISaleReadable function phaseIds() external view override returns (string[] memory phaseIds_) { phaseIds_ = SaleStorage.layout().phases.ids; } /// @inheritdoc ISaleReadable function raisedInPhase( string memory phaseId ) external view override returns (uint256) { return SaleStorage.layout().ledger.raisedInPhase[phaseId]; } /// @inheritdoc ISaleReadable function saleStatus() external view override returns (Status) { return SaleStorage.layout().ledger.status; } /// @inheritdoc ISaleReadable function setUp() external view override returns (address paymentToken, address permit2) { SaleStorage.SetUp memory setUp_ = SaleStorage.layout().setUp; paymentToken = setUp_.paymentToken; permit2 = setUp_.permit2; } /// @inheritdoc ISaleReadable function totalRaised() external view override returns (uint256) { return SaleStorage.layout().ledger.totalRaised; } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {INOStorage} from "../INOStorage.sol"; interface IINOReadable { /** * @param phaseId The ID of the phase to get the max mintable amount. * @return phaseMaxMint The maximum amount of NFTs that can be minted in the phase. */ function phaseMaxMint( string calldata phaseId ) external view returns (uint256); /** * @return - `paymentReceiver` address of the wallet to receive the payments - `projectWallet` address of the project which will receive the NFT owner rights after the INO ends. */ function inoSetUp() external view returns (INOStorage.SetUp memory); /// @dev Amount of NFTs minted by users in a specific phase. function mintedInPhase( string calldata phaseId ) external view returns (uint256); /// @dev Address of the NFT collection contract to mint when buying. function nftCollection() external view returns (address); function nftCollectionData() external view returns (INOStorage.NFTCollectionData memory); /// @dev Amount of NFTs minted by users in the whole INO. function totalMinted() external view returns (uint256); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/cryptography/MerkleProof.sol) pragma solidity ^0.8.0; /** * @dev These functions deal with verification of Merkle Tree proofs. * * The tree and the proofs can be generated using our * https://github.com/OpenZeppelin/merkle-tree[JavaScript library]. * You will find a quickstart guide in the readme. * * WARNING: You should avoid using leaf values that are 64 bytes long prior to * hashing, or use a hash function other than keccak256 for hashing leaves. * This is because the concatenation of a sorted pair of internal nodes in * the merkle tree could be reinterpreted as a leaf value. * OpenZeppelin's JavaScript library generates merkle trees that are safe * against this attack out of the box. */ library MerkleProof { /** * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree * defined by `root`. For this, a `proof` must be provided, containing * sibling hashes on the branch from the leaf to the root of the tree. Each * pair of leaves and each pair of pre-images are assumed to be sorted. */ function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) { return processProof(proof, leaf) == root; } /** * @dev Calldata version of {verify} * * _Available since v4.7._ */ function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) { return processProofCalldata(proof, leaf) == root; } /** * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt * hash matches the root of the tree. When processing the proof, the pairs * of leafs & pre-images are assumed to be sorted. * * _Available since v4.4._ */ function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { computedHash = _hashPair(computedHash, proof[i]); } return computedHash; } /** * @dev Calldata version of {processProof} * * _Available since v4.7._ */ function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { computedHash = _hashPair(computedHash, proof[i]); } return computedHash; } /** * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a merkle tree defined by * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}. * * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details. * * _Available since v4.7._ */ function multiProofVerify( bytes32[] memory proof, bool[] memory proofFlags, bytes32 root, bytes32[] memory leaves ) internal pure returns (bool) { return processMultiProof(proof, proofFlags, leaves) == root; } /** * @dev Calldata version of {multiProofVerify} * * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details. * * _Available since v4.7._ */ function multiProofVerifyCalldata( bytes32[] calldata proof, bool[] calldata proofFlags, bytes32 root, bytes32[] memory leaves ) internal pure returns (bool) { return processMultiProofCalldata(proof, proofFlags, leaves) == root; } /** * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false * respectively. * * CAUTION: Not all merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer). * * _Available since v4.7._ */ function processMultiProof( bytes32[] memory proof, bool[] memory proofFlags, bytes32[] memory leaves ) internal pure returns (bytes32 merkleRoot) { // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of // the merkle tree. uint256 leavesLen = leaves.length; uint256 totalHashes = proofFlags.length; // Check proof validity. require(leavesLen + proof.length - 1 == totalHashes, "MerkleProof: invalid multiproof"); // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop". bytes32[] memory hashes = new bytes32[](totalHashes); uint256 leafPos = 0; uint256 hashPos = 0; uint256 proofPos = 0; // At each step, we compute the next hash using two values: // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we // get the next hash. // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the // `proof` array. for (uint256 i = 0; i < totalHashes; i++) { bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]; bytes32 b = proofFlags[i] ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]) : proof[proofPos++]; hashes[i] = _hashPair(a, b); } if (totalHashes > 0) { unchecked { return hashes[totalHashes - 1]; } } else if (leavesLen > 0) { return leaves[0]; } else { return proof[0]; } } /** * @dev Calldata version of {processMultiProof}. * * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details. * * _Available since v4.7._ */ function processMultiProofCalldata( bytes32[] calldata proof, bool[] calldata proofFlags, bytes32[] memory leaves ) internal pure returns (bytes32 merkleRoot) { // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of // the merkle tree. uint256 leavesLen = leaves.length; uint256 totalHashes = proofFlags.length; // Check proof validity. require(leavesLen + proof.length - 1 == totalHashes, "MerkleProof: invalid multiproof"); // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop". bytes32[] memory hashes = new bytes32[](totalHashes); uint256 leafPos = 0; uint256 hashPos = 0; uint256 proofPos = 0; // At each step, we compute the next hash using two values: // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we // get the next hash. // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the // `proof` array. for (uint256 i = 0; i < totalHashes; i++) { bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]; bytes32 b = proofFlags[i] ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++]) : proof[proofPos++]; hashes[i] = _hashPair(a, b); } if (totalHashes > 0) { unchecked { return hashes[totalHashes - 1]; } } else if (leavesLen > 0) { return leaves[0]; } else { return proof[0]; } } function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) { return a < b ? _efficientHash(a, b) : _efficientHash(b, a); } function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) { /// @solidity memory-safe-assembly assembly { mstore(0x00, a) mstore(0x20, b) value := keccak256(0x00, 0x40) } } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {ISignatureTransfer} from "permit2/interfaces/ISignatureTransfer.sol"; import {MerkleProof} from "openzeppelin-contracts/utils/cryptography/MerkleProof.sol"; import {RestrictedWritableInternal} from "./restricted/RestrictedWritableInternal.sol"; import {ISaleWritableInternal} from "./ISaleWritableInternal.sol"; import {SaleStorage} from "../SaleStorage.sol"; // struct import import {Status, Phase, BuyPermission} from "../SaleStruct.sol"; import {UserAllocationFee} from "../UserAllocationStruct.sol"; /** * @title SaleWritableInternal * @notice Defines internal functions for `SaleWritable`. */ contract SaleWritableInternal is ISaleWritableInternal, // 1 inherited component RestrictedWritableInternal // 2 inherited components { /** * @notice Generic allocation validation method. * * @param phaseId Phase linked to current allocation used by buyer. * @param buyer Wallet buying tokens. * @param reserveNow Amount of tokens to spend in this transaction, * expressed in {SaleStorage.SetUp.paymentToken}. * @param maxAllocation Maximum amount of tokens this wallet can spend in this phase, * expressed in {SaleStorage.SetUp.paymentToken}. * @param summedMaxPhaseCap Total amount of tokens to be sold in this Sale, * expressed in {SaleStorage.SetUp.paymentToken}. * @param maxPhaseCap Maximum amount of tokens to be sold in this phase, * expressed in {SaleStorage.SetUp.paymentToken}. */ function _checkBuyReserveParams( string calldata phaseId, address buyer, uint256 reserveNow, uint256 maxAllocation, uint256 summedMaxPhaseCap, uint256 maxPhaseCap ) internal { _requireAllocationNotExceededInPhase( reserveNow, buyer, maxAllocation, phaseId ); _requireSummedMaxPhaseCapNotExceeded(reserveNow, summedMaxPhaseCap); _requireOpenedSaleAndPhase(phaseId); _requirePhaseCapNotExceeded(phaseId, maxPhaseCap, reserveNow); } /** * @notice Update storage of the Sale when an allocation is reserved on-chain: total raised, total raised * in phase, allocation reserved by buyer in phase, etc... * * @param amount Amount of tokens spent in this transaction, expressed in * {SaleStorage.SetUp.paymentToken}. * @param phaseId Phase linked to current allocation used by buyer. * @param buyer Wallet buying tokens. * @param maxPhaseCap Maximum amount of tokens to be sold in this phase, expressed in {SaleStorage.SetUp.paymentToken}. */ function _updateStorageOnBuy( uint256 amount, string calldata phaseId, address buyer, uint256 maxPhaseCap ) internal virtual { SaleStorage.Ledger storage ledger = SaleStorage.layout().ledger; // update raised amount ledger.totalRaised += amount; ledger.raisedInPhase[phaseId] += amount; ledger.allocationReservedByIn[buyer][phaseId] += amount; // close whole SALE if sold out if (ledger.totalRaised == ledger.summedMaxPhaseCap) _closeSale(); // close PHASE if sold out if (ledger.raisedInPhase[phaseId] == maxPhaseCap) { _closePhase(phaseId); } } /// @notice Verify phase is opened. If the sale has not been opened before the phase, open it. function _requireOpenedSaleAndPhase(string memory phaseId) internal { // manually close phase if maxPhaseCap is NOT reached - TEMPORARY solution if ( block.timestamp >= SaleStorage.layout().phases.data[phaseId].endAt ) { revert("Phase closed"); // string instead custom error as temporary solution } Phase memory phase = SaleStorage.layout().phases.data[phaseId]; Status saleStatus = SaleStorage.layout().ledger.status; // open phase if necessary if ( phase.status == Status.NOT_STARTED && block.timestamp >= phase.startAt && block.timestamp < phase.endAt ) { if (saleStatus == Status.NOT_STARTED) _openSale(); _openPhase(phaseId); return; } // revert if phase can not be opened if (phase.status != Status.OPENED) { revert SaleWritableInternal_PhaseNotOpened(phaseId, phase.status); } // revert if sale can not be opened if (saleStatus != Status.OPENED) { revert SaleWritableInternal_SaleNotOpened(saleStatus); } } /** * @notice Ensure a wallet can not spend more than their allocation for the given phase. * * @param toSpend Amount of tokens to spend in this transaction, expressed in * {SaleStorage.SetUp.paymentToken}. * @param buyer Wallet buying tokens. * @param allocated Maximum amount of tokens this wallet can spend in this phase, expressed in * {SaleStorage.SetUp.paymentToken}. */ function _requireAllocationNotExceededInPhase( uint256 toSpend, address buyer, uint256 allocated, string calldata phaseId ) internal view { uint256 totalAfterPurchase = toSpend + SaleStorage.layout().ledger.allocationReservedByIn[buyer][phaseId]; // avoids replay attack if (totalAfterPurchase > allocated) { revert SaleWritable_AllocationExceeded( allocated, totalAfterPurchase - allocated ); } } /** * @notice Verify `summedMaxPhaseCap` will not be exceeded after purchase. * * @param toSpend Amount of tokens to spend in this transaction, expressed in * {SaleStorage.SetUp.paymentToken}. * @param summedMaxPhaseCap Total amount of tokens to be sold in this Sale, expressed in * {SaleStorage.SetUp.paymentToken}. */ function _requireSummedMaxPhaseCapNotExceeded( uint256 toSpend, uint256 summedMaxPhaseCap ) internal view { uint256 totalAfterPurchase = toSpend + SaleStorage.layout().ledger.totalRaised; if (totalAfterPurchase > summedMaxPhaseCap) { revert SaleWritable_SummedMaxPhaseCapExceeded( summedMaxPhaseCap, // by how much`summedMaxPhaseCap` is exceeded totalAfterPurchase - summedMaxPhaseCap ); } } /** * @notice Verify `maxPhaseCap` will not be exceeded after purchase. * * @param phaseId Phase linked to current allocation used by buyer. * @param maxPhaseCap Maximum amount of tokens to be sold in this phase, expressed in * {SaleStorage.SetUp.paymentToken}. * @param toSpend Amount of tokens to spend in this transaction, expressed in * {SaleStorage.SetUp.paymentToken}. */ function _requirePhaseCapNotExceeded( string calldata phaseId, uint256 maxPhaseCap, uint256 toSpend ) internal view { uint256 raisedAfterPurchase = toSpend + SaleStorage.layout().ledger.raisedInPhase[phaseId]; if (raisedAfterPurchase > maxPhaseCap) { revert SaleWritable_MaxPhaseCapExceeded( phaseId, maxPhaseCap, // by how much `maxPhaseCap` is exceeded raisedAfterPurchase - maxPhaseCap ); } } /** * @notice Verify allocation is valid. * * @param allocation Allocation to verify. * @param proof Merkle proof of the allocation. */ function _requireValidAllocation( UserAllocationFee calldata allocation, bytes32[] calldata proof ) internal view { if ( !MerkleProof.verify( proof, SaleStorage .layout() .phases .data[allocation.usrData.base.phaseId] .rootHash, keccak256(abi.encode(address(this), block.chainid, allocation)) ) ) revert SaleWritableInternal_AllocationNotFound(); } /** * @notice ERC20 permit and transfer in one call. * @param permit2 Address of the permit2 contract. * @param from address to transfer tokens from. * @param to address to transfer tokens to. * @param token address of the token to transfer. * @param amount amount of tokens to transfer. * @param permission BuyPermission struct containing permit signature and deadline. */ function _permit2ApproveAndTransfer( address permit2, address from, address to, address token, uint256 amount, BuyPermission calldata permission ) internal { /// @dev declare {Permit2.permitTransferFrom} parameters ISignatureTransfer.TokenPermissions memory permitted; ISignatureTransfer.PermitTransferFrom memory permit; ISignatureTransfer.SignatureTransferDetails memory transferDetails; /// @dev configure {Permit2.permitTransferFrom} parameters using IGO and allocation parameters permitted = ISignatureTransfer.TokenPermissions({ token: token, amount: amount }); permit = ISignatureTransfer.PermitTransferFrom({ permitted: permitted, nonce: permission.nonce, deadline: permission.deadline }); transferDetails = ISignatureTransfer.SignatureTransferDetails({ to: to, requestedAmount: amount }); /// @dev {Permit2} library call ISignatureTransfer(permit2).permitTransferFrom( permit, transferDetails, from, permission.signature ); } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; // import struct import {Status} from "../../common/SaleStruct.sol"; /** * @title IINOWritableInternal * @notice Defines enum, struct, event and errors for INO. */ interface IINOWritableInternal { error INO_IncorrectNativeAmount(uint256 sent, uint256 price); error INO_IncorrectERC20Amount(uint256 sent, uint256 price); error INO_MaxMintINOReached(uint256 maxMint, uint256 exceedBy); error INO_MaxMintInPhaseReached(uint256 maxMintInPhase, uint256 exceedBy); error INO_NativePaymentFailed(bytes data); error INO_OnlyUseMultipleOf(uint256 multiple); error INO_UseInstead(string); error INO_PhaseDetailsNotFound(); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (proxy/Clones.sol) pragma solidity ^0.8.0; /** * @dev https://eips.ethereum.org/EIPS/eip-1167[EIP 1167] is a standard for * deploying minimal proxy contracts, also known as "clones". * * > To simply and cheaply clone contract functionality in an immutable way, this standard specifies * > a minimal bytecode implementation that delegates all calls to a known, fixed address. * * The library includes functions to deploy a proxy using either `create` (traditional deployment) or `create2` * (salted deterministic deployment). It also includes functions to predict the addresses of clones deployed using the * deterministic method. * * _Available since v3.4._ */ library Clones { /** * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`. * * This function uses the create opcode, which should never revert. */ function clone(address implementation) internal returns (address instance) { /// @solidity memory-safe-assembly assembly { // Cleans the upper 96 bits of the `implementation` word, then packs the first 3 bytes // of the `implementation` address with the bytecode before the address. mstore(0x00, or(shr(0xe8, shl(0x60, implementation)), 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000)) // Packs the remaining 17 bytes of `implementation` with the bytecode after the address. mstore(0x20, or(shl(0x78, implementation), 0x5af43d82803e903d91602b57fd5bf3)) instance := create(0, 0x09, 0x37) } require(instance != address(0), "ERC1167: create failed"); } /** * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`. * * This function uses the create2 opcode and a `salt` to deterministically deploy * the clone. Using the same `implementation` and `salt` multiple time will revert, since * the clones cannot be deployed twice at the same address. */ function cloneDeterministic(address implementation, bytes32 salt) internal returns (address instance) { /// @solidity memory-safe-assembly assembly { // Cleans the upper 96 bits of the `implementation` word, then packs the first 3 bytes // of the `implementation` address with the bytecode before the address. mstore(0x00, or(shr(0xe8, shl(0x60, implementation)), 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000)) // Packs the remaining 17 bytes of `implementation` with the bytecode after the address. mstore(0x20, or(shl(0x78, implementation), 0x5af43d82803e903d91602b57fd5bf3)) instance := create2(0, 0x09, 0x37, salt) } require(instance != address(0), "ERC1167: create2 failed"); } /** * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}. */ function predictDeterministicAddress( address implementation, bytes32 salt, address deployer ) internal pure returns (address predicted) { /// @solidity memory-safe-assembly assembly { let ptr := mload(0x40) mstore(add(ptr, 0x38), deployer) mstore(add(ptr, 0x24), 0x5af43d82803e903d91602b57fd5bf3ff) mstore(add(ptr, 0x14), implementation) mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73) mstore(add(ptr, 0x58), salt) mstore(add(ptr, 0x78), keccak256(add(ptr, 0x0c), 0x37)) predicted := keccak256(add(ptr, 0x43), 0x55) } } /** * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}. */ function predictDeterministicAddress( address implementation, bytes32 salt ) internal view returns (address predicted) { return predictDeterministicAddress(implementation, salt, address(this)); } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; // import struct import {Phase} from "../../../common/SaleStruct.sol"; import {INOPhase} from "../../INOStruct.sol"; // storage import {INOStorage} from "../../INOStorage.sol"; import {SaleStorage} from "../../../common/SaleStorage.sol"; /** * @title IINORestricted * @notice Only the owner of the contract can call these methods. */ interface IINORestricted { /** * @notice Some projects will only do the sale through INO and will handle the NFT minting themselves. * Others will do the mint and sale through INO. This function is used to deploy the NFT * collection for the second case. * @dev Use {reinitializer(2)} as {initialize} is called first. * * @param nftToClone The address of the NFT to use as an NFT base. * @param data Data of the NFT collection to be deployed. */ function deployNftToSell( address nftToClone, INOStorage.NFTCollectionData calldata data ) external returns (address collection); /** * @notice Use a single token for the whole INO (never changed once set here). * * @param saleSetUp Data of the sale to be deployed - common logic shared between IGOs and INOs. * @param owner Owner of the INO. * @param inoSetUp Data of the INO to be deployed. * @param phaseIds Default list of phase identifiers - can be empty array `new string[](0)` * @param phases Default list of phases - can be empty array `new INOPhase[](0)` */ function initialize( SaleStorage.SetUp calldata saleSetUp, address owner, INOStorage.SetUp calldata inoSetUp, string[] calldata phaseIds, INOPhase[] calldata phases ) external; /** * @dev Update or create a phase with all its data. * * @param phaseId_ Identifier of phase to set or update. * @param phase_ Struct {INOPhase} containing INO phase's data to be saved. */ function updateSetPhase( string calldata phaseId_, INOPhase calldata phase_ ) external; /** * @dev Update or create multiple phases with all their data. * * @param phaseIdentifiers_ Array of identifiers of `phases`. * @param phases_ Array of struct {INOPhase} containing phases' data to be saved. */ function updateSetPhases( string[] calldata phaseIdentifiers_, INOPhase[] calldata phases_ ) external; function updatePhaseMaxMintAndMerkleRoot( string calldata phaseId, uint256 phaseMaxMint, bytes32 merkleRoot ) external; }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {INOStorage} from "../../INOStorage.sol"; import {SaleStorage} from "../../../common/SaleStorage.sol"; // import struct import {Status, Phase} from "../../../common/SaleStruct.sol"; import {INOPhase} from "../../INOStruct.sol"; /** * @title IINORestrictedInternal */ interface IINORestrictedInternal { error INORestricted_Init_PaymentReceiverIsZeroAddr(); error INORestricted_Init_ProjectWalletIsZeroAddr(); error INORestricted_SaleStarted(Status current); error INORestricted_Deploy_MaxCapNotSet(); error INORestricted_Deploy_Name2CharsMin(); error INORestricted_Deploy_NftToCloneIsZeroAddr(); // error INORestricted_Deploy_SaleAlreadyStarted(); error INORestricted_Deploy_Symbole1CharMin(); event INO_DeployedNftToSell( address indexed collection, INOStorage.NFTCollectionData indexed data ); event INO_Initialized( SaleStorage.SetUp indexed saleSetUp, address indexed owner, INOStorage.SetUp indexed igoSetUp, string[] phaseIds_, INOPhase[] phases ); event INO_PhaseMaxMintUpdated( string indexed phaseId, uint256 indexed oldPhaseMaxMint, uint256 indexed newPhaseMaxMint ); event INO_SinglePhaseUpdate( string indexed phaseId, Phase indexed oldData, INOPhase indexed newData ); event INO_BatchPhaseUpdate( string[] indexed phaseId, INOPhase[] indexed phase ); }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {IERC20} from "openzeppelin-contracts/token/ERC20/IERC20.sol"; import {SafeERC20} from "openzeppelin-contracts/token/ERC20/utils/SafeERC20.sol"; import {Initializable} from "openzeppelin-contracts/proxy/utils/Initializable.sol"; import {IRestrictedWritable} from "./IRestrictedWritable.sol"; import {IGOStorage} from "../../../igo/IGOStorage.sol"; import {SaleStorage} from "../../SaleStorage.sol"; import {RestrictedWritableInternal} from "./RestrictedWritableInternal.sol"; // import struct import {Status, Phase} from "../../SaleStruct.sol"; /** * @title RestrictedWritable */ contract RestrictedWritable is IRestrictedWritable, // 1 inherited component RestrictedWritableInternal, // 2 inherited component Initializable // 1 inherited component { using SafeERC20 for IERC20; /// @inheritdoc IRestrictedWritable function closeSale() external override onlyRole(DEFAULT_ADMIN_ROLE) { _closeSale(); emit SaleClosed(); } function openSale() external override onlyRole(DEFAULT_ADMIN_ROLE) { _isSale(Status.NOT_STARTED); _openSale(); emit SaleOpened(); } function pauseSale() external override onlyRole(DEFAULT_ADMIN_ROLE) { _isSale(Status.OPENED); SaleStorage.layout().ledger.status = Status.PAUSED; emit SalePaused(); } function resumeSale() external override onlyRole(DEFAULT_ADMIN_ROLE) { _isSale(Status.PAUSED); SaleStorage.layout().ledger.status = Status.OPENED; emit SaleResumed(); } /// @inheritdoc IRestrictedWritable function recoverLostERC20( address token, address to ) external override onlyRole(DEFAULT_ADMIN_ROLE) { if (token == address(0)) revert RestrictedWritable_TokenIsZeroAddr(); if (to == address(0)) revert RestrictedWritable_ReceiverIsZeroAddr(); uint256 amount = IERC20(token).balanceOf(address(this)); IERC20(token).safeTransfer(to, amount); emit RecoveredLostERC20(token, to, amount); } function closePhases( string[] calldata phaseIds ) external override onlyRole(DEFAULT_ADMIN_ROLE) { for (uint256 i = 0; i < phaseIds.length; i++) { if ( block.timestamp >= SaleStorage.layout().phases.data[phaseIds[i]].endAt ) { _closePhase(phaseIds[i]); } } } //////////////////////////// PHASE SINGLE UPDATE //////////////////////////// /// @inheritdoc IRestrictedWritable function openPhase( string calldata phaseId ) external override onlyRole(DEFAULT_ADMIN_ROLE) { _isPhase(Status.NOT_STARTED, phaseId); _openPhase(phaseId); emit PhaseOpened(phaseId); } function pausePhase( string calldata phaseId ) external override onlyRole(DEFAULT_ADMIN_ROLE) { _isPhase(Status.OPENED, phaseId); SaleStorage.layout().phases.data[phaseId].status = Status.PAUSED; emit PhasePaused(phaseId); } function resumePhase( string calldata phaseId ) external override onlyRole(DEFAULT_ADMIN_ROLE) { _isPhase(Status.PAUSED, phaseId); SaleStorage.layout().phases.data[phaseId].status = Status.OPENED; emit PhaseResumed(phaseId); } function updatePhaseEndDate( string calldata phaseId, uint128 endAt ) external override onlyRole(DEFAULT_ADMIN_ROLE) { _isPhaseNot(Status.COMPLETED, phaseId); if (endAt <= block.timestamp) { revert RestrictedWritable_EndInPast(); } if (endAt <= SaleStorage.layout().phases.data[phaseId].startAt) { revert RestrictedWritable_EndBeforeStart(); } emit PhaseEndDateUpdated( phaseId, SaleStorage.layout().phases.data[phaseId].endAt, endAt ); SaleStorage.layout().phases.data[phaseId].endAt = endAt; } /// @inheritdoc IRestrictedWritable function updatePhaseMaxCapAndMerkleRoot( string calldata phaseId, uint256 maxPhaseCap, bytes32 merkleRoot ) external override onlyRole(DEFAULT_ADMIN_ROLE) { /// @custom:audit verifies underneath the phase is not completed updatePhaseMerkleRoot(phaseId, merkleRoot); uint256 summedMaxPhaseCap = SaleStorage .layout() .ledger .summedMaxPhaseCap; summedMaxPhaseCap -= SaleStorage .layout() .phases .data[phaseId] .maxPhaseCap; summedMaxPhaseCap += maxPhaseCap; emit PhaseMaxCapUpdated( phaseId, SaleStorage.layout().phases.data[phaseId].maxPhaseCap, maxPhaseCap ); SaleStorage.layout().phases.data[phaseId].maxPhaseCap = maxPhaseCap; SaleStorage.layout().ledger.summedMaxPhaseCap = summedMaxPhaseCap; } /// @inheritdoc IRestrictedWritable function updatePhaseMerkleRoot( string calldata phaseId, bytes32 merkleRoot ) public override onlyRole(DEFAULT_ADMIN_ROLE) { _isPhaseNot(Status.COMPLETED, phaseId); if (merkleRoot == bytes32(0)) { revert RestrictedWritable_EmptyMerkleRoot(); } emit PhaseMerkleRootUpdated( phaseId, SaleStorage.layout().phases.data[phaseId].rootHash, merkleRoot ); SaleStorage.layout().phases.data[phaseId].rootHash = merkleRoot; } /// @inheritdoc IRestrictedWritable function updatePhaseStartDate( string calldata phaseId, uint128 startAt ) external override onlyRole(DEFAULT_ADMIN_ROLE) { _isPhase(Status.NOT_STARTED, phaseId); if (startAt >= SaleStorage.layout().phases.data[phaseId].endAt) { revert RestrictedWritable_StartAfterEnd(); } emit PhaseStartDateUpdated( phaseId, SaleStorage.layout().phases.data[phaseId].startAt, startAt ); SaleStorage.layout().phases.data[phaseId].startAt = startAt; } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {ERC721Base} from "./ERC721Base.sol"; import {INOStorage} from "../INOStorage.sol"; contract ERC721SequentialId is ERC721Base // 12 inherited components { function initialize( INOStorage.NFTCollectionData calldata data, address initialOwner, address ino_ ) public override { super.initialize(data, initialOwner, ino_); emit NFTDeployed( Type.Sequential, initialOwner, data.name, data.symbol ); } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; // import struct import {Status, Phase} from "../SaleStruct.sol"; /** * @title ISaleReadable * @notice Interface made for read-only data from {Sale}. */ interface ISaleReadable { /** * @param account Address of the user. * @param phaseId Identifier of the phase. * * @return amount Amount of paymentToken paid by phase by each user, * expressed in {SetUp.paymentToken}. */ function freeAllocationMintedBy( address account, string calldata phaseId ) external view returns (uint256); /** * @return Total Sum of maximum cap of each phase, expressed in {SetUp.paymentToken}. */ function summedMaxPhaseCap() external view returns (uint256); /** * @param account Address of the user. * @param phaseId Identifier of the phase. * * @return Amount of {SaleStorage.SetUp.paymentToken} paid by `account` for the phase `phaseId`. * If `address(0)` is returned, it means native (ETH, BNB, MATCI, etc...). */ function allocationReservedByIn( address account, string calldata phaseId ) external view returns (uint256); /** * @param phaseId Identifier of the phase. * @return phase_ Phase struct representing the data of the phase `phaseId`. */ function phase( string memory phaseId ) external view returns (Phase memory phase_); /// @return phaseIds_ List of all phases identifiers. function phaseIds() external view returns (string[] memory phaseIds_); /** * @param phaseId Identifier of the phase. * * @return Amount of {SaleStorage.SetUp.paymentToken} raised for the phase `phaseId`. * If `address(0)` is returned, it means native (ETH, BNB, MATCI, etc...). */ function raisedInPhase( string memory phaseId ) external view returns (uint256); /// @return Enum representing the current status of the Sale. function saleStatus() external view returns (Status); /** * @return paymentToken Address of the default token used to reserve allocation through the Sale. * If `address(0)` is returned, it means native (ETH, BNB, MATCI, etc...). * @return permit2 Address of Permit2 contract. */ function setUp() external view returns (address paymentToken, address permit2); /// @return Total amount of {SaleStorage.SetUp.paymentToken} raised for this Sale. function totalRaised() external view returns (uint256); }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {Status} from "../../SaleStruct.sol"; /** * @title IRestrictedWritableInternal * @notice Defines event and error used in {RestrictedWritableInternal} & {RestrictedWritable}. */ interface IRestrictedWritableInternal { // @notice Thrown when `phaseIds` and `phases` arrays have different lengths. error RestrictedWritableInternal_DifferentArraysLength(); // @notice Thrown when a phase {IGOStruct.Phase} is empty is {RestrictedWritableInternal._setPhases}. error RestrictedWritableInternal_EmptyPhase(); //////////////////////////// THROWN ON Sale INITIALIZATION //////////////////////////// error RestrictedWritable_Init_OwnerIsZeroAddr(); error RestrictedWritable_Init_PaymentTokenIsZeroAddr(); error RestrictedWritable_Init_Permit2IsZeroAddr(); //////////////////////////// THROWN AT ANY TIME //////////////////////////// /// @dev Thrown when merkle root is equal to bytes32(0). error RestrictedWritable_EmptyMerkleRoot(); // @notice Thrown when a phase {IGOStruct.Phase} is empty is {RestrictedWritable.updateSetPhase}. error RestrictedWritable_EmptyPhase(); error RestrictedWritable_EndInPast(); /// @dev Thrown when a new phase is created with a status different from `NOT_STARTED`. error RestrictedWritable_NewPhaseStatus(); /// @dev Thrown when the phase status is equal to `avoid`. error RestrictedWritable_PhaseMatched(Status avoid, Status phaseStatus); error RestrictedWritable_PhaseMaxCapIsZero(); error RestrictedWritable_PhaseMerkleRootIsZero(); /// @dev Thrown when the phase status is not equal to the one expected. error RestrictedWritable_PhaseNotMatched(Status expected, Status current); error RestrictedWritable_PhaseStartGteEnd(); error RestrictedWritable_ReceiverIsZeroAddr(); /// @dev Thrown when the sale status is equal to `avoid`. error RestrictedWritable_SaleMatched(Status avoid, Status saleStatus); /// @dev Thrown when the sale status is not equal to the one expected. error RestrictedWritable_SaleNotMatched(Status expected, Status current); error RestrictedWritable_StartAfterEnd(); error RestrictedWritable_EndBeforeStart(); error RestrictedWritable_TokenIsZeroAddr(); event PhaseEndDateUpdated( string indexed phaseId, uint256 indexed oldEndDate, uint256 indexed newEndDate ); event PhaseMaxCapUpdated( string indexed phaseId, uint256 indexed oldMaxCap, uint256 indexed newMaxCap ); event PhaseMerkleRootUpdated( string indexed phaseId, bytes32 indexed oldMerkleRoot, bytes32 indexed newMerkleRoot ); event PhaseOpened(string indexed phaseName); event PhasePaused(string indexed phaseName); event PhaseResumed(string indexed phaseName); event PhaseStartDateUpdated( string indexed phaseId, uint256 indexed oldStartDate, uint256 indexed newStartDate ); event RecoveredLostERC20( address indexed token, address indexed to, uint256 indexed amount ); event SaleClosed(); event SaleOpened(); event SalePaused(); event SaleResumed(); }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; // import struct import {Status} from "../SaleStruct.sol"; /** * @title ISaleWritableInternal * @notice Internal interface of `SaleWritable` which defines events and errors. */ interface ISaleWritableInternal { /// @notice Thrown when the buyer tries to spend more than {Allocation.maxAllocation}. error SaleWritable_AllocationExceeded( uint256 allocation, uint256 exceedsBy ); /// @notice Thrown when the grand total to be raised for this Sale is exceeded. error SaleWritable_SummedMaxPhaseCapExceeded( uint256 summedMaxPhaseCap, uint256 exceedsBy ); /// @notice Thrown when the cap (maximum amount) of the current phase is exceeded. error SaleWritable_MaxPhaseCapExceeded( string phaseId, uint256 maxPhaseCap, uint256 exceedsBy ); /// @notice Thrown when `msg.sender` is not the buyer. error SaleWritableInternal_AccountNotAuthorized(); /// @notice Thrown when the allocation is not found in the merkle proof. error SaleWritableInternal_AllocationNotFound(); /// @notice Thrown when the phase is not opened. error SaleWritableInternal_PhaseNotOpened(string phaseId, Status current); /// @notice Thrown when the Sale is not opened. error SaleWritableInternal_SaleNotOpened(Status current); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import {IEIP712} from "./IEIP712.sol"; /// @title SignatureTransfer /// @notice Handles ERC20 token transfers through signature based actions /// @dev Requires user's token approval on the Permit2 contract interface ISignatureTransfer is IEIP712 { /// @notice Thrown when the requested amount for a transfer is larger than the permissioned amount /// @param maxAmount The maximum amount a spender can request to transfer error InvalidAmount(uint256 maxAmount); /// @notice Thrown when the number of tokens permissioned to a spender does not match the number of tokens being transferred /// @dev If the spender does not need to transfer the number of tokens permitted, the spender can request amount 0 to be transferred error LengthMismatch(); /// @notice Emits an event when the owner successfully invalidates an unordered nonce. event UnorderedNonceInvalidation(address indexed owner, uint256 word, uint256 mask); /// @notice The token and amount details for a transfer signed in the permit transfer signature struct TokenPermissions { // ERC20 token address address token; // the maximum amount that can be spent uint256 amount; } /// @notice The signed permit message for a single token transfer struct PermitTransferFrom { TokenPermissions permitted; // a unique value for every token owner's signature to prevent signature replays uint256 nonce; // deadline on the permit signature uint256 deadline; } /// @notice Specifies the recipient address and amount for batched transfers. /// @dev Recipients and amounts correspond to the index of the signed token permissions array. /// @dev Reverts if the requested amount is greater than the permitted signed amount. struct SignatureTransferDetails { // recipient address address to; // spender requested amount uint256 requestedAmount; } /// @notice Used to reconstruct the signed permit message for multiple token transfers /// @dev Do not need to pass in spender address as it is required that it is msg.sender /// @dev Note that a user still signs over a spender address struct PermitBatchTransferFrom { // the tokens and corresponding amounts permitted for a transfer TokenPermissions[] permitted; // a unique value for every token owner's signature to prevent signature replays uint256 nonce; // deadline on the permit signature uint256 deadline; } /// @notice A map from token owner address and a caller specified word index to a bitmap. Used to set bits in the bitmap to prevent against signature replay protection /// @dev Uses unordered nonces so that permit messages do not need to be spent in a certain order /// @dev The mapping is indexed first by the token owner, then by an index specified in the nonce /// @dev It returns a uint256 bitmap /// @dev The index, or wordPosition is capped at type(uint248).max function nonceBitmap(address, uint256) external view returns (uint256); /// @notice Transfers a token using a signed permit message /// @dev Reverts if the requested amount is greater than the permitted signed amount /// @param permit The permit data signed over by the owner /// @param owner The owner of the tokens to transfer /// @param transferDetails The spender's requested transfer details for the permitted token /// @param signature The signature to verify function permitTransferFrom( PermitTransferFrom memory permit, SignatureTransferDetails calldata transferDetails, address owner, bytes calldata signature ) external; /// @notice Transfers a token using a signed permit message /// @notice Includes extra data provided by the caller to verify signature over /// @dev The witness type string must follow EIP712 ordering of nested structs and must include the TokenPermissions type definition /// @dev Reverts if the requested amount is greater than the permitted signed amount /// @param permit The permit data signed over by the owner /// @param owner The owner of the tokens to transfer /// @param transferDetails The spender's requested transfer details for the permitted token /// @param witness Extra data to include when checking the user signature /// @param witnessTypeString The EIP-712 type definition for remaining string stub of the typehash /// @param signature The signature to verify function permitWitnessTransferFrom( PermitTransferFrom memory permit, SignatureTransferDetails calldata transferDetails, address owner, bytes32 witness, string calldata witnessTypeString, bytes calldata signature ) external; /// @notice Transfers multiple tokens using a signed permit message /// @param permit The permit data signed over by the owner /// @param owner The owner of the tokens to transfer /// @param transferDetails Specifies the recipient and requested amount for the token transfer /// @param signature The signature to verify function permitTransferFrom( PermitBatchTransferFrom memory permit, SignatureTransferDetails[] calldata transferDetails, address owner, bytes calldata signature ) external; /// @notice Transfers multiple tokens using a signed permit message /// @dev The witness type string must follow EIP712 ordering of nested structs and must include the TokenPermissions type definition /// @notice Includes extra data provided by the caller to verify signature over /// @param permit The permit data signed over by the owner /// @param owner The owner of the tokens to transfer /// @param transferDetails Specifies the recipient and requested amount for the token transfer /// @param witness Extra data to include when checking the user signature /// @param witnessTypeString The EIP-712 type definition for remaining string stub of the typehash /// @param signature The signature to verify function permitWitnessTransferFrom( PermitBatchTransferFrom memory permit, SignatureTransferDetails[] calldata transferDetails, address owner, bytes32 witness, string calldata witnessTypeString, bytes calldata signature ) external; /// @notice Invalidates the bits specified in mask for the bitmap at the word position /// @dev The wordPos is maxed at type(uint248).max /// @param wordPos A number to index the nonceBitmap at /// @param mask A bitmap masked against msg.sender's current bitmap at the word position function invalidateUnorderedNonces(uint256 wordPos, uint256 mask) external; }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {AccessControlEnumerable} from "openzeppelin-contracts/access/AccessControlEnumerable.sol"; import {IRestrictedWritableInternal} from "./IRestrictedWritableInternal.sol"; import {SaleStorage} from "../../SaleStorage.sol"; // import struct import {Status, Phase} from "../../SaleStruct.sol"; /** * @title RestrictedWritableInternal * @notice Defines the internal functions of `RestrictedWritable` contract. */ contract RestrictedWritableInternal is IRestrictedWritableInternal, // 1 inherited component AccessControlEnumerable // 8 inherited component { function _checkPhaseData( uint256 oldMaxPhaseCap, Phase calldata phase_ ) internal view { if (oldMaxPhaseCap == 0) { // if it is a new phase phase MUST be NOT_STARTED if (phase_.status != Status.NOT_STARTED) { revert RestrictedWritable_NewPhaseStatus(); } } if (phase_.rootHash == bytes32(0)) { revert RestrictedWritable_PhaseMerkleRootIsZero(); } /** * @dev Phase can start in the past as we can have a phase that is already started BUT contract has * been deployed later due to unexpected reasons. */ if (phase_.startAt >= phase_.endAt) { revert RestrictedWritable_PhaseStartGteEnd(); } if (phase_.endAt <= block.timestamp) { revert RestrictedWritable_EndInPast(); } if (phase_.maxPhaseCap == 0) { revert RestrictedWritable_PhaseMaxCapIsZero(); } } /// @param phaseId Phase identifier to close. function _closePhase(string memory phaseId) internal { SaleStorage.layout().phases.data[phaseId].status = Status.COMPLETED; } function _closeSale() internal { SaleStorage.layout().ledger.status = Status.COMPLETED; } function _initializeSale(SaleStorage.SetUp calldata saleSetUp) internal { if (saleSetUp.permit2 == address(0)) revert RestrictedWritable_Init_Permit2IsZeroAddr(); SaleStorage.layout().setUp = saleSetUp; } function _openPhase(string memory phaseId) internal { SaleStorage.layout().phases.data[phaseId].status = Status.OPENED; } function _openSale() internal { SaleStorage.layout().ledger.status = Status.OPENED; } function _setOwnerRights(address owner) internal { if (owner == address(0)) { revert RestrictedWritable_Init_OwnerIsZeroAddr(); } _grantRole(DEFAULT_ADMIN_ROLE, owner); _grantRole(DEFAULT_ADMIN_ROLE, _msgSender()); } function _checkTimestampsForUpdatedPhase( uint128 oldStartAt, uint128 oldEndAt, uint128 startAt, uint128 endAt, string calldata phaseId_ ) internal view { // if startAt is changed, existing phase should be in NOT_STARTED state if (oldStartAt != startAt) { _isPhase(Status.NOT_STARTED, phaseId_); } // if endAt is changed, existing phase should not be in COMPLETED state if (oldEndAt != endAt) { _isPhaseNot(Status.COMPLETED, phaseId_); } } /** * @notice Set the data of phase or update it if it already exists. * * @param summedMaxPhaseCap The sum of all max amount to raise per phase before updating this phase, * expressed in {SaleStorage.SetUp.paymentToken} * @param oldMaxPhaseCap The max amount to raise for the phase before updating it, * expressed in {SaleStorage.SetUp.paymentToken}. * @param phase_ The phase's data to save. * @param phaseId_ The phase identifier. */ function _setPhase( uint256 summedMaxPhaseCap, uint256 oldMaxPhaseCap, Phase calldata phase_, string calldata phaseId_ ) internal { _checkPhaseData(oldMaxPhaseCap, phase_); if (oldMaxPhaseCap != 0) { _checkTimestampsForUpdatedPhase( SaleStorage.layout().phases.data[phaseId_].startAt, SaleStorage.layout().phases.data[phaseId_].endAt, phase_.startAt, phase_.endAt, phaseId_ ); } summedMaxPhaseCap -= oldMaxPhaseCap; summedMaxPhaseCap += phase_.maxPhaseCap; // if phase does not exist, push to ids if (oldMaxPhaseCap == 0) SaleStorage.layout().phases.ids.push(phaseId_); SaleStorage.layout().phases.data[phaseId_] = phase_; SaleStorage.layout().ledger.summedMaxPhaseCap = summedMaxPhaseCap; } function _isPhase(Status expected, string calldata phaseId) internal view { Status phaseStatus = SaleStorage.layout().phases.data[phaseId].status; if (phaseStatus != expected) { revert RestrictedWritable_PhaseNotMatched(expected, phaseStatus); } } /// @dev If **phase status** is NOT equals `avoid` it passes silently, otherwise it reverts. function _isPhaseNot(Status avoid, string calldata phaseId) internal view { Status phaseStatus = SaleStorage.layout().phases.data[phaseId].status; if (phaseStatus == avoid) { revert RestrictedWritable_PhaseMatched(avoid, phaseStatus); } } function _isSale(Status expected) internal view { Status current = SaleStorage.layout().ledger.status; if (current != expected) { revert RestrictedWritable_SaleNotMatched(expected, current); } } /// @dev If **sale status** is NOT equals `avoid` it passes silently, otherwise it reverts. function _isSaleNot(Status avoid) internal view { Status current = SaleStorage.layout().ledger.status; if (current == avoid) { revert RestrictedWritable_SaleMatched(avoid, current); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @dev Emitted when `value` tokens are moved from one account (`from`) to * another (`to`). * * Note that `value` may be zero. */ event Transfer(address indexed from, address indexed to, uint256 value); /** * @dev Emitted when the allowance of a `spender` for an `owner` is set by * a call to {approve}. `value` is the new allowance. */ event Approval(address indexed owner, address indexed spender, uint256 value); /** * @dev Returns the amount of tokens in existence. */ function totalSupply() external view returns (uint256); /** * @dev Returns the amount of tokens owned by `account`. */ function balanceOf(address account) external view returns (uint256); /** * @dev Moves `amount` tokens from the caller's account to `to`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address to, uint256 amount) external returns (bool); /** * @dev Returns the remaining number of tokens that `spender` will be * allowed to spend on behalf of `owner` through {transferFrom}. This is * zero by default. * * This value changes when {approve} or {transferFrom} are called. */ function allowance(address owner, address spender) external view returns (uint256); /** * @dev Sets `amount` as the allowance of `spender` over the caller's tokens. * * Returns a boolean value indicating whether the operation succeeded. * * IMPORTANT: Beware that changing an allowance with this method brings the risk * that someone may use both the old and the new allowance by unfortunate * transaction ordering. One possible solution to mitigate this race * condition is to first reduce the spender's allowance to 0 and set the * desired value afterwards: * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 * * Emits an {Approval} event. */ function approve(address spender, uint256 amount) external returns (bool); /** * @dev Moves `amount` tokens from `from` to `to` using the * allowance mechanism. `amount` is then deducted from the caller's * allowance. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transferFrom(address from, address to, uint256 amount) external returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC20/utils/SafeERC20.sol) pragma solidity ^0.8.0; import "../IERC20.sol"; import "../extensions/IERC20Permit.sol"; import "../../../utils/Address.sol"; /** * @title SafeERC20 * @dev Wrappers around ERC20 operations that throw on failure (when the token * contract returns false). Tokens that return no value (and instead revert or * throw on failure) are also supported, non-reverting calls are assumed to be * successful. * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract, * which allows you to call the safe operations as `token.safeTransfer(...)`, etc. */ library SafeERC20 { using Address for address; /** * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value, * non-reverting calls are assumed to be successful. */ function safeTransfer(IERC20 token, address to, uint256 value) internal { _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value)); } /** * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful. */ function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal { _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value)); } /** * @dev Deprecated. This function has issues similar to the ones found in * {IERC20-approve}, and its usage is discouraged. * * Whenever possible, use {safeIncreaseAllowance} and * {safeDecreaseAllowance} instead. */ function safeApprove(IERC20 token, address spender, uint256 value) internal { // safeApprove should only be called when setting an initial allowance, // or when resetting it to zero. To increase and decrease it, use // 'safeIncreaseAllowance' and 'safeDecreaseAllowance' require( (value == 0) || (token.allowance(address(this), spender) == 0), "SafeERC20: approve from non-zero to non-zero allowance" ); _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value)); } /** * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value, * non-reverting calls are assumed to be successful. */ function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal { uint256 oldAllowance = token.allowance(address(this), spender); _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value)); } /** * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value, * non-reverting calls are assumed to be successful. */ function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal { unchecked { uint256 oldAllowance = token.allowance(address(this), spender); require(oldAllowance >= value, "SafeERC20: decreased allowance below zero"); _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value)); } } /** * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value, * non-reverting calls are assumed to be successful. Compatible with tokens that require the approval to be set to * 0 before setting it to a non-zero value. */ function forceApprove(IERC20 token, address spender, uint256 value) internal { bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value); if (!_callOptionalReturnBool(token, approvalCall)) { _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0)); _callOptionalReturn(token, approvalCall); } } /** * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`. * Revert on invalid signature. */ function safePermit( IERC20Permit token, address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) internal { uint256 nonceBefore = token.nonces(owner); token.permit(owner, spender, value, deadline, v, r, s); uint256 nonceAfter = token.nonces(owner); require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed"); } /** * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement * on the return value: the return value is optional (but if data is returned, it must not be false). * @param token The token targeted by the call. * @param data The call data (encoded using abi.encode or one of its variants). */ function _callOptionalReturn(IERC20 token, bytes memory data) private { // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that // the target address contains contract code and also asserts for success in the low-level call. bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed"); require(returndata.length == 0 || abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed"); } /** * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement * on the return value: the return value is optional (but if data is returned, it must not be false). * @param token The token targeted by the call. * @param data The call data (encoded using abi.encode or one of its variants). * * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead. */ function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) { // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false // and not revert is the subcall reverts. (bool success, bytes memory returndata) = address(token).call(data); return success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.1) (proxy/utils/Initializable.sol) pragma solidity ^0.8.2; import "../../utils/Address.sol"; /** * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. * * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in * case an upgrade adds a module that needs to be initialized. * * For example: * * [.hljs-theme-light.nopadding] * ```solidity * contract MyToken is ERC20Upgradeable { * function initialize() initializer public { * __ERC20_init("MyToken", "MTK"); * } * } * * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable { * function initializeV2() reinitializer(2) public { * __ERC20Permit_init("MyToken"); * } * } * ``` * * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. * * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity. * * [CAUTION] * ==== * Avoid leaving a contract uninitialized. * * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() { * _disableInitializers(); * } * ``` * ==== */ abstract contract Initializable { /** * @dev Indicates that the contract has been initialized. * @custom:oz-retyped-from bool */ uint8 private _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool private _initializing; /** * @dev Triggered when the contract has been initialized or reinitialized. */ event Initialized(uint8 version); /** * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope, * `onlyInitializing` functions can be used to initialize parent contracts. * * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a * constructor. * * Emits an {Initialized} event. */ modifier initializer() { bool isTopLevelCall = !_initializing; require( (isTopLevelCall && _initialized < 1) || (!Address.isContract(address(this)) && _initialized == 1), "Initializable: contract is already initialized" ); _initialized = 1; if (isTopLevelCall) { _initializing = true; } _; if (isTopLevelCall) { _initializing = false; emit Initialized(1); } } /** * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be * used to initialize parent contracts. * * A reinitializer may be used after the original initialization step. This is essential to configure modules that * are added through upgrades and that require initialization. * * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer` * cannot be nested. If one is invoked in the context of another, execution will revert. * * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in * a contract, executing them in the right order is up to the developer or operator. * * WARNING: setting the version to 255 will prevent any future reinitialization. * * Emits an {Initialized} event. */ modifier reinitializer(uint8 version) { require(!_initializing && _initialized < version, "Initializable: contract is already initialized"); _initialized = version; _initializing = true; _; _initializing = false; emit Initialized(version); } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} and {reinitializer} modifiers, directly or indirectly. */ modifier onlyInitializing() { require(_initializing, "Initializable: contract is not initializing"); _; } /** * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call. * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized * to any version. 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 executed. */ function _disableInitializers() internal virtual { require(!_initializing, "Initializable: contract is initializing"); if (_initialized != type(uint8).max) { _initialized = type(uint8).max; emit Initialized(type(uint8).max); } } /** * @dev Returns the highest version that has been initialized. See {reinitializer}. */ function _getInitializedVersion() internal view returns (uint8) { return _initialized; } /** * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}. */ function _isInitializing() internal view returns (bool) { return _initializing; } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {IGOStorage} from "../../../igo/IGOStorage.sol"; import {SaleStorage} from "../../SaleStorage.sol"; // import struct import {Phase} from "../../SaleStruct.sol"; /** * @title IRestrictedWritable * @notice Only the owner of the contract can call these methods. */ interface IRestrictedWritable { //////////////////////////// SHARED Sale DATA //////////////////////////// /** * @notice Close the sale for good. * @dev Can be closed at any point in time AND NOT reversible. */ function closeSale() external; function openSale() external; function pauseSale() external; function resumeSale() external; /// @dev Retrieve any ERC20 sent to the contract by mistake. function recoverLostERC20(address token, address to) external; function closePhases(string[] calldata phaseIds) external; // TODO: UX choice to make here, do we need both phase single field update and phase batch update? //////////////////////////// PHASE SINGLE UPDATE //////////////////////////// /** * @custom:audit phase can be opened even if it does not exists but as only the owner can update this * method we make the asumption that the owner will always be aware of this to save gast costs and it * can be paused at any time to update its data so it does not pose a security risk. */ function openPhase(string calldata phaseId) external; function pausePhase(string calldata phaseId) external; function resumePhase(string calldata phaseId) external; function updatePhaseEndDate( string calldata phaseId, uint128 endAt ) external; /** * @notice Update `maxPhaseCap` which is the maximum amount of tokens that can be sold in a phase * and the merkle root of a phase to update a single or multiple wallet allocation, * refund fee, etc. * @dev `maxPhaseCap` is expressed in {SaleStorage.SetUp.paymentToken}. * * @param phaseId Identifier of the phase. * @param merkleRoot New merkle root to be saved for this phase. */ function updatePhaseMaxCapAndMerkleRoot( string calldata phaseId, uint256 maxPhaseCap, bytes32 merkleRoot ) external; /** * @notice Update the merkle root of a phase to update a single or multiple wallet allocation, * refund fee, payment token etc. * * @param phaseId Identifier of the phase. * @param merkleRoot New merkle root to be saved for this phase. */ function updatePhaseMerkleRoot( string calldata phaseId, bytes32 merkleRoot ) external; function updatePhaseStartDate( string calldata phaseId, uint128 startAt ) external; }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; /** * @author https://github.com/Theo6890 * @title IGOStorage * @notice Mapps the storage layout of the {IGO} contract. * @dev Diamond proxy (ERC-2535) storage style. */ library IGOStorage { /** * @notice Struct reprensenting the main setup of the IGO. * * @param vestingContract Address of the {IGOVesting} contract. * @param refundFeeDecimals Number of decimals used for {IIGOWritableInternal.Allocation.refundFee}. */ struct SetUp { address vestingContract; uint256 refundFeeDecimals; } /** * @notice Struct reprensenting the whole storage layout of the IGO contract. * * @param setUp Struct reprensenting the main setup of the IGO. */ struct IGOStruct { SetUp setUp; } /// @notice Storage position of {IGOStruct} in {IGO} contract. bytes32 public constant IGO_STORAGE = keccak256("igo.storage"); /** * @return igoStruct Whole storage of {IGO} contract. */ function layout() internal pure returns (IGOStruct storage igoStruct) { bytes32 position = IGO_STORAGE; assembly { igoStruct.slot := position } } }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {ERC2981Upgradeable} from "openzeppelin-contracts-upgradeable/token/common/ERC2981Upgradeable.sol"; import {ReentrancyGuardUpgradeable} from "openzeppelin-contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol"; import {INFT} from "./interfaces/INFT.sol"; import {INFTInternal} from "./interfaces/INFTInternal.sol"; import {ISaleReadable} from "../../common/readable/ISaleReadable.sol"; /// @custom:audit OpenSea base contract (imported in `seadrop` library) - very few changes import {ERC721ContractMetadataCloneable} from "./imported/ERC721ContractMetadataCloneable.sol"; import {INOStorage} from "../INOStorage.sol"; // import struct import {Status} from "../../common/SaleStruct.sol"; abstract contract ERC721Base is INFT, // 1 inherited component INFTInternal, // 1 inherited component ERC2981Upgradeable, // 4 inherited components ERC721ContractMetadataCloneable, // 7 inherited components ReentrancyGuardUpgradeable // 2 inherited components { uint256 public startTokenId; address public ino; function deleteDefaultRoyalty() external override { _onlyOwnerOrSelf(); _deleteDefaultRoyalty(); } /// @inheritdoc INFT function mint( address minter, uint256 quantity ) external virtual override nonReentrant { _onlyIno(msg.sender); // Extra safety check to ensure the max supply is not exceeded. if (_totalMinted() + quantity > maxSupply()) { revert ERC721Base_MintQuantityExceedsMaxSupply( _totalMinted() + quantity, maxSupply() ); } // Mint the quantity of tokens to the minter. _safeMint(minter, quantity); } /// @inheritdoc INFT function postmintAllUnsold(address receiver) external override onlyOwner { _onlyIfInoCompleted(); uint256 quantity = maxSupply() - _totalMinted(); _safeMint(receiver, quantity); emit MintedAllUnsold(quantity); } /// @inheritdoc INFT function postmintAndReduceSupply( address receiver, uint256 quantity ) external override onlyOwner returns (uint256 reducedBy) { _onlyIfInoCompleted(); uint256 newTotal = _totalMinted() + quantity; uint256 oldMaxSupply = _maxSupply; if (newTotal > oldMaxSupply) { revert ERC721Base_PostmintAndReduceSupply_QuantityExceedsMaxSupply( oldMaxSupply, newTotal - oldMaxSupply ); } reducedBy = oldMaxSupply - newTotal; _safeMint(receiver, quantity); _setMaxSupply(_totalMinted()); emit MintedSomeUnsoldAndReducedSupply(quantity, reducedBy, _maxSupply); } /// @inheritdoc INFT function premint( address receiver, uint256 quantity ) external override onlyOwner { Status status = ISaleReadable(ino).saleStatus(); if (status != Status.NOT_STARTED) { revert ERC721Base_Premint_INOStarted(status); } _safeMint(receiver, quantity); emit Preminted(receiver, quantity, _startTokenId()); } function resetTokenRoyalty(uint256 tokenId) external override { _onlyOwnerOrSelf(); _resetTokenRoyalty(tokenId); } function setDefaultRoyalty( address receiver, uint96 feeNumerator ) external override { _onlyOwnerOrSelf(); _setDefaultRoyalty(receiver, feeNumerator); emit RoyaltyInfoUpdated(receiver, feeNumerator); } function setTokenRoyalty( uint256 tokenId, address receiver, uint96 feeNumerator ) external override { _onlyOwnerOrSelf(); _setTokenRoyalty(tokenId, receiver, feeNumerator); emit TokenRoyaltyInfoUpdated(tokenId, receiver, feeNumerator); } /// @inheritdoc INFT /// @dev Child contract MUST override it to emit an event. function initialize( INOStorage.NFTCollectionData calldata data, address initialOwner, address ino_ ) public virtual override initializer { if (data.maxCap > 2 ** 64 - 1) { revert CannotExceedMaxSupplyOfUint64(data.maxCap); } _maxSupply = data.maxCap; _tokenBaseURI = data.uri; startTokenId = data.startTokenId; // init after {startTokenId} is set __ERC721ACloneable__init(data.name, data.symbol); __ReentrancyGuard_init(); _transferOwnership(initialOwner); ino = ino_; } /// @inheritdoc INFT function reduceSupplyTo(uint256 newMaxSupply) public override { _onlyIfInoCompleted(); if (newMaxSupply >= _maxSupply) { revert ERC721Base_ReduceSupplyTo_NotGreaterEqThan(_maxSupply); } if (newMaxSupply <= _totalMinted()) { revert ERC721Base_ReduceSupplyTo_NotLowerEqThan(_totalMinted()); } emit SupplyReduced(_maxSupply, newMaxSupply); _setMaxSupply(newMaxSupply); /// @custom:audit cotains {_onlyOwnerOrSelf()} } function supportsInterface( bytes4 interfaceId ) public view virtual override(ERC721ContractMetadataCloneable, ERC2981Upgradeable) returns (bool) { return ERC2981Upgradeable.supportsInterface(interfaceId) || ERC721ContractMetadataCloneable.supportsInterface(interfaceId); } /// @inheritdoc INFT function getMintStats( address minter ) external view override returns ( uint256 minterNumMinted, uint256 currentTotalSupply, uint256 maxSupply_ ) { minterNumMinted = _numberMinted(minter); currentTotalSupply = _totalMinted(); maxSupply_ = _maxSupply; } function _onlyIno(address minter) internal view { if (minter != ino) { revert ERC721Base_InoOnlyApprovedMinter(); } } function _onlyIfInoCompleted() internal view { Status status = ISaleReadable(ino).saleStatus(); if (status != Status.COMPLETED) { revert ERC721Base_OnlyIfInoCompleted(status); } } function _startTokenId() internal view override returns (uint256) { return startTokenId; } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; interface IEIP712 { function DOMAIN_SEPARATOR() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (access/AccessControlEnumerable.sol) pragma solidity ^0.8.0; import "./IAccessControlEnumerable.sol"; import "./AccessControl.sol"; import "../utils/structs/EnumerableSet.sol"; /** * @dev Extension of {AccessControl} that allows enumerating the members of each role. */ abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl { using EnumerableSet for EnumerableSet.AddressSet; mapping(bytes32 => EnumerableSet.AddressSet) private _roleMembers; /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns one of the accounts that have `role`. `index` must be a * value between 0 and {getRoleMemberCount}, non-inclusive. * * Role bearers are not sorted in any particular way, and their ordering may * change at any point. * * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure * you perform all queries on the same block. See the following * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post] * for more information. */ function getRoleMember(bytes32 role, uint256 index) public view virtual override returns (address) { return _roleMembers[role].at(index); } /** * @dev Returns the number of accounts that have `role`. Can be used * together with {getRoleMember} to enumerate all bearers of a role. */ function getRoleMemberCount(bytes32 role) public view virtual override returns (uint256) { return _roleMembers[role].length(); } /** * @dev Overload {_grantRole} to track enumerable memberships */ function _grantRole(bytes32 role, address account) internal virtual override { super._grantRole(role, account); _roleMembers[role].add(account); } /** * @dev Overload {_revokeRole} to track enumerable memberships */ function _revokeRole(bytes32 role, address account) internal virtual override { super._revokeRole(role, account); _roleMembers[role].remove(account); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Permit.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612]. * * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't * need to send a transaction, and thus is not required to hold Ether at all. */ interface IERC20Permit { /** * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens, * given ``owner``'s signed approval. * * IMPORTANT: The same issues {IERC20-approve} has related to transaction * ordering also apply here. * * Emits an {Approval} event. * * Requirements: * * - `spender` cannot be the zero address. * - `deadline` must be a timestamp in the future. * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner` * over the EIP712-formatted function arguments. * - the signature must use ``owner``'s current nonce (see {nonces}). * * For more information on the signature format, see the * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP * section]. */ function permit( address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) external; /** * @dev Returns the current nonce for `owner`. This value must be * included whenever a signature is generated for {permit}. * * Every successful call to {permit} increases ``owner``'s nonce by one. This * prevents a signature from being used multiple times. */ function nonces(address owner) external view returns (uint256); /** * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}. */ // solhint-disable-next-line func-name-mixedcase function DOMAIN_SEPARATOR() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * * Furthermore, `isContract` will also return true if the target contract within * the same transaction is already scheduled for destruction by `SELFDESTRUCT`, * which only has an effect at the end of a transaction. * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract. * * _Available since v4.8._ */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata, string memory errorMessage ) internal view returns (bytes memory) { if (success) { if (returndata.length == 0) { // only check isContract if the call was successful and the return data is empty // otherwise we already know that it was a contract require(isContract(target), "Address: call to non-contract"); } return returndata; } else { _revert(returndata, errorMessage); } } /** * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason or using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { _revert(returndata, errorMessage); } } function _revert(bytes memory returndata, string memory errorMessage) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (token/common/ERC2981.sol) pragma solidity ^0.8.0; import "../../interfaces/IERC2981Upgradeable.sol"; import "../../utils/introspection/ERC165Upgradeable.sol"; import "../../proxy/utils/Initializable.sol"; /** * @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information. * * Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for * specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first. * * Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the * fee is specified in basis points by default. * * IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See * https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to * voluntarily pay royalties together with sales, but note that this standard is not yet widely supported. * * _Available since v4.5._ */ abstract contract ERC2981Upgradeable is Initializable, IERC2981Upgradeable, ERC165Upgradeable { function __ERC2981_init() internal onlyInitializing { } function __ERC2981_init_unchained() internal onlyInitializing { } struct RoyaltyInfo { address receiver; uint96 royaltyFraction; } RoyaltyInfo private _defaultRoyaltyInfo; mapping(uint256 => RoyaltyInfo) private _tokenRoyaltyInfo; /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165Upgradeable, ERC165Upgradeable) returns (bool) { return interfaceId == type(IERC2981Upgradeable).interfaceId || super.supportsInterface(interfaceId); } /** * @inheritdoc IERC2981Upgradeable */ function royaltyInfo(uint256 tokenId, uint256 salePrice) public view virtual override returns (address, uint256) { RoyaltyInfo memory royalty = _tokenRoyaltyInfo[tokenId]; if (royalty.receiver == address(0)) { royalty = _defaultRoyaltyInfo; } uint256 royaltyAmount = (salePrice * royalty.royaltyFraction) / _feeDenominator(); return (royalty.receiver, royaltyAmount); } /** * @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a * fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an * override. */ function _feeDenominator() internal pure virtual returns (uint96) { return 10000; } /** * @dev Sets the royalty information that all ids in this contract will default to. * * Requirements: * * - `receiver` cannot be the zero address. * - `feeNumerator` cannot be greater than the fee denominator. */ function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual { require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice"); require(receiver != address(0), "ERC2981: invalid receiver"); _defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator); } /** * @dev Removes default royalty information. */ function _deleteDefaultRoyalty() internal virtual { delete _defaultRoyaltyInfo; } /** * @dev Sets the royalty information for a specific token id, overriding the global default. * * Requirements: * * - `receiver` cannot be the zero address. * - `feeNumerator` cannot be greater than the fee denominator. */ function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual { require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice"); require(receiver != address(0), "ERC2981: Invalid parameters"); _tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator); } /** * @dev Resets royalty information for the token id back to the global default. */ function _resetTokenRoyalty(uint256 tokenId) internal virtual { delete _tokenRoyaltyInfo[tokenId]; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[48] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol) pragma solidity ^0.8.0; import "../proxy/utils/Initializable.sol"; /** * @dev Contract module that helps prevent reentrant calls to a function. * * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier * available, which can be applied to functions to make sure there are no nested * (reentrant) calls to them. * * Note that because there is a single `nonReentrant` guard, functions marked as * `nonReentrant` may not call one another. This can be worked around by making * those functions `private`, and then adding `external` `nonReentrant` entry * points to them. * * TIP: If you would like to learn more about reentrancy and alternative ways * to protect against it, check out our blog post * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul]. */ abstract contract ReentrancyGuardUpgradeable is Initializable { // Booleans are more expensive than uint256 or any type that takes up a full // word because each write operation emits an extra SLOAD to first read the // slot's contents, replace the bits taken up by the boolean, and then write // back. This is the compiler's defense against contract upgrades and // pointer aliasing, and it cannot be disabled. // The values being non-zero value makes deployment a bit more expensive, // but in exchange the refund on every call to nonReentrant will be lower in // amount. Since refunds are capped to a percentage of the total // transaction's gas, it is best to keep them low in cases like this one, to // increase the likelihood of the full refund coming into effect. uint256 private constant _NOT_ENTERED = 1; uint256 private constant _ENTERED = 2; uint256 private _status; function __ReentrancyGuard_init() internal onlyInitializing { __ReentrancyGuard_init_unchained(); } function __ReentrancyGuard_init_unchained() internal onlyInitializing { _status = _NOT_ENTERED; } /** * @dev Prevents a contract from calling itself, directly or indirectly. * Calling a `nonReentrant` function from another `nonReentrant` * function is not supported. It is possible to prevent this from happening * by making the `nonReentrant` function external, and making it call a * `private` function that does the actual work. */ modifier nonReentrant() { _nonReentrantBefore(); _; _nonReentrantAfter(); } function _nonReentrantBefore() private { // On the first call to nonReentrant, _status will be _NOT_ENTERED require(_status != _ENTERED, "ReentrancyGuard: reentrant call"); // Any calls to nonReentrant after this point will fail _status = _ENTERED; } function _nonReentrantAfter() private { // By storing the original value once again, a refund is triggered (see // https://eips.ethereum.org/EIPS/eip-2200) _status = _NOT_ENTERED; } /** * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a * `nonReentrant` function in the call stack. */ function _reentrancyGuardEntered() internal view returns (bool) { return _status == _ENTERED; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; }
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.23; import {Status} from "../../../common/SaleStruct.sol"; /** * @title INFTInternal * @notice Define enum, struct, event and errors used by NFTs listed in INOs. */ interface INFTInternal { /// @ notice Define the type of NFT according to INO needs. enum Type { Sequential, RandomisedUri, ConfigRoyalty } /// @notice Thrown when someone other than the INO tries to mint. error ERC721Base_InoOnlyApprovedMinter(); /// @notice Thrown when trying to mint more than maximum supply. error ERC721Base_MintQuantityExceedsMaxSupply( uint256 total, uint256 maxSupply ); /// @notice Thrown when trying to make an action BUT INO is not completed. error ERC721Base_OnlyIfInoCompleted(Status current); error ERC721Base_PostmintAndReduceSupply_QuantityExceedsMaxSupply( uint256 maxSupply, uint256 exceededBy ); /// @notice Thrown when trying to premint wheras INO already started, even if paused. error ERC721Base_Premint_INOStarted(Status current); /// @notice Thrown when updating provenance hash once INO is opened, paused or closed. error ERC721Base_SetProvenanceHash(Status current); /** * @notice Thrown when updating base URI once INO is opened, paused or closed, except if reveal date * and new uri equls provenan hash. */ error ERC721Base_SetBaseURI(Status current); /// @notice Thrown when trying to increase maximum supply. error ERC721Base_ReduceSupplyTo_NotGreaterEqThan(uint256 maxSupply); /// @notice Thrown when trying to decrease maximum supply below total quantity supply. error ERC721Base_ReduceSupplyTo_NotLowerEqThan(uint256 totalSupply); event MintedAllUnsold(uint256 indexed quantity); event MintedSomeUnsoldAndReducedSupply( uint256 indexed quantity, uint256 indexed reducedBy, uint256 indexed newSupply ); event NFTDeployed( Type indexed nftType, address indexed initialOwner, string indexed name, string symbol ); event Preminted( address indexed receiver, uint256 indexed quantity, uint256 indexed startTokenId ); /// @dev Emit an event when the royalties info is updated. event RoyaltyInfoUpdated(address receiver, uint256 bps); /// @dev Emit an event when the royalties info for a token is updated. event TokenRoyaltyInfoUpdated( uint256 tokenId, address receiver, uint256 bps ); event SupplyReduced(uint256 indexed oldSupply, uint256 indexed newSupply); }
// SPDX-License-Identifier: MIT pragma solidity 0.8.23; import {IERC165} from "openzeppelin-contracts/utils/introspection/IERC165.sol"; import {INFTContractMetadata} from "./INFTContractMetadata.sol"; import {ERC721ACloneable} from "./ERC721ACloneable.sol"; import {Ownable2StepUpgradeable} from "openzeppelin-contracts-upgradeable/access/Ownable2StepUpgradeable.sol"; /** * @title ERC721ContractMetadataCloneable * @author James Wenzel (emo.eth) * @author Ryan Ghods (ralxz.eth) * @author Stephan Min (stephanm.eth) * @notice ERC721ContractMetadata is a token contract that extends ERC721A * with additional metadata and ownership capabilities. * * @custom:audit Only changes from base contract in `seadrop` library are located in {setBaseURI} and * {_setMaxSupply}. */ abstract contract ERC721ContractMetadataCloneable is ERC721ACloneable, // 3 inherited components Ownable2StepUpgradeable, // 2 inherited components INFTContractMetadata // 1 inherited component { /// @notice Track the max supply. uint256 _maxSupply; /// @notice Track the base URI for token metadata. string _tokenBaseURI; /// @notice Track the contract URI for contract metadata. string _contractURI; /// @notice Track the provenance hash for guaranteeing metadata order /// for random reveals. /// @custom:audit Made `internal` compared to `seadrop` library. bytes32 internal _provenanceHash; error OnlyOwner(); /** * @dev Reverts if the sender is not the owner or the contract itself. * This function is inlined instead of being a modifier * to save contract space from being inlined N times. */ function _onlyOwnerOrSelf() internal view { if ( _cast(msg.sender == owner()) | _cast(msg.sender == address(this)) == 0 ) { revert OnlyOwner(); } } /** * @notice Sets the base URI for the token metadata and emits an event. * * @param newBaseURI The new base URI to set. * * @custom:audit Only changed visibility function (external to public) + `virtual` keyword compared * to `seadrop` library. * Made public to call through {super.setBaseURI} */ function setBaseURI(string calldata newBaseURI) public virtual override { // Ensure the sender is only the owner or contract itself. _onlyOwnerOrSelf(); // Set the new base URI. _tokenBaseURI = newBaseURI; // Emit an event with the update. if (totalSupply() != 0) { emit BatchMetadataUpdate(_startTokenId(), _nextTokenId() - 1); } } /** * @notice Sets the contract URI for contract metadata. * * @param newContractURI The new contract URI. */ function setContractURI(string calldata newContractURI) external override { // Ensure the sender is only the owner or contract itself. _onlyOwnerOrSelf(); // Set the new contract URI. _contractURI = newContractURI; // Emit an event with the update. emit ContractURIUpdated(newContractURI); } /** * @notice Emit an event notifying metadata updates for * a range of token ids, according to EIP-4906. * * @param fromTokenId The start token id. * @param toTokenId The end token id. */ function emitBatchMetadataUpdate( uint256 fromTokenId, uint256 toTokenId ) external { // Ensure the sender is only the owner or contract itself. _onlyOwnerOrSelf(); // Emit an event with the update. emit BatchMetadataUpdate(fromTokenId, toTokenId); } /** * @notice Sets the max token supply and emits an event. * * @param newMaxSupply The new max supply to set. * * * @custom:audit Only changed visibility function (external to internal) compared * to `seadrop` library. */ function _setMaxSupply(uint256 newMaxSupply) internal { // Ensure the sender is only the owner or contract itself. _onlyOwnerOrSelf(); // Ensure the max supply does not exceed the maximum value of uint64. if (newMaxSupply > 2 ** 64 - 1) { revert CannotExceedMaxSupplyOfUint64(newMaxSupply); } // Set the new max supply. _maxSupply = newMaxSupply; // Emit an event with the update. emit MaxSupplyUpdated(newMaxSupply); } /** * @notice Sets the provenance hash and emits an event. * * The provenance hash is used for random reveals, which * is a hash of the ordered metadata to show it has not been * modified after mint started. * * In INO case, only useful for mint strategies with reveal date. Blackbox and reveal on mint * will not use this. * * This function will revert after the first item has been minted. * * @param newProvenanceHash The new provenance hash to set. * * * @custom:audit Only added `virtual` and changed from `external` to `public` compared to `seadrop` * library. */ function setProvenanceHash(bytes32 newProvenanceHash) public virtual { // Ensure the sender is only the owner or contract itself. _onlyOwnerOrSelf(); // Revert if any items have been minted. if (_totalMinted() > 0) { revert ProvenanceHashCannotBeSetAfterMintStarted(); } // Keep track of the old provenance hash for emitting with the event. bytes32 oldProvenanceHash = _provenanceHash; // Set the new provenance hash. _provenanceHash = newProvenanceHash; // Emit an event with the update. emit ProvenanceHashUpdated(oldProvenanceHash, newProvenanceHash); } /** * @notice Returns the base URI for token metadata. */ function baseURI() external view override returns (string memory) { return _baseURI(); } /** * @notice Returns the base URI for the contract, which ERC721A uses * to return tokenURI. */ function _baseURI() internal view virtual override returns (string memory) { return _tokenBaseURI; } /** * @notice Returns the contract URI for contract metadata. */ function contractURI() external view override returns (string memory) { return _contractURI; } /** * @notice Returns the max token supply. */ function maxSupply() public view returns (uint256) { return _maxSupply; } /** * @notice Returns the provenance hash. * The provenance hash is used for random reveals, which * is a hash of the ordered metadata to show it is unmodified * after mint has started. */ function provenanceHash() external view override returns (bytes32) { return _provenanceHash; } /** * @notice Returns whether the interface is supported. * * @param interfaceId The interface id to check against. */ function supportsInterface( bytes4 interfaceId ) public view virtual override(ERC721ACloneable) returns (bool) { return interfaceId == 0x49064906 || // ERC-4906 super.supportsInterface(interfaceId); } /** * @dev Internal pure function to cast a `bool` value to a `uint256` value. * * @param b The `bool` value to cast. * * @return u The `uint256` value. */ function _cast(bool b) internal pure returns (uint256 u) { assembly { u := b } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol) pragma solidity ^0.8.0; import "./IAccessControl.sol"; /** * @dev External interface of AccessControlEnumerable declared to support ERC165 detection. */ interface IAccessControlEnumerable is IAccessControl { /** * @dev Returns one of the accounts that have `role`. `index` must be a * value between 0 and {getRoleMemberCount}, non-inclusive. * * Role bearers are not sorted in any particular way, and their ordering may * change at any point. * * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure * you perform all queries on the same block. See the following * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post] * for more information. */ function getRoleMember(bytes32 role, uint256 index) external view returns (address); /** * @dev Returns the number of accounts that have `role`. Can be used * together with {getRoleMember} to enumerate all bearers of a role. */ function getRoleMemberCount(bytes32 role) external view returns (uint256); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (access/AccessControl.sol) pragma solidity ^0.8.0; import "./IAccessControl.sol"; import "../utils/Context.sol"; import "../utils/Strings.sol"; import "../utils/introspection/ERC165.sol"; /** * @dev Contract module that allows children to implement role-based access * control mechanisms. This is a lightweight version that doesn't allow enumerating role * members except through off-chain means by accessing the contract event logs. Some * applications may benefit from on-chain enumerability, for those cases see * {AccessControlEnumerable}. * * Roles are referred to by their `bytes32` identifier. These should be exposed * in the external API and be unique. The best way to achieve this is by * using `public constant` hash digests: * * ```solidity * bytes32 public constant MY_ROLE = keccak256("MY_ROLE"); * ``` * * Roles can be used to represent a set of permissions. To restrict access to a * function call, use {hasRole}: * * ```solidity * function foo() public { * require(hasRole(MY_ROLE, msg.sender)); * ... * } * ``` * * Roles can be granted and revoked dynamically via the {grantRole} and * {revokeRole} functions. Each role has an associated admin role, and only * accounts that have a role's admin role can call {grantRole} and {revokeRole}. * * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means * that only accounts with this role will be able to grant or revoke other * roles. More complex role relationships can be created by using * {_setRoleAdmin}. * * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to * grant and revoke this role. Extra precautions should be taken to secure * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules} * to enforce additional security measures for this role. */ abstract contract AccessControl is Context, IAccessControl, ERC165 { struct RoleData { mapping(address => bool) members; bytes32 adminRole; } mapping(bytes32 => RoleData) private _roles; bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00; /** * @dev Modifier that checks that an account has a specific role. Reverts * with a standardized message including the required role. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ * * _Available since v4.1._ */ modifier onlyRole(bytes32 role) { _checkRole(role); _; } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) public view virtual override returns (bool) { return _roles[role].members[account]; } /** * @dev Revert with a standard message if `_msgSender()` is missing `role`. * Overriding this function changes the behavior of the {onlyRole} modifier. * * Format of the revert message is described in {_checkRole}. * * _Available since v4.6._ */ function _checkRole(bytes32 role) internal view virtual { _checkRole(role, _msgSender()); } /** * @dev Revert with a standard message if `account` is missing `role`. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ */ function _checkRole(bytes32 role, address account) internal view virtual { if (!hasRole(role, account)) { revert( string( abi.encodePacked( "AccessControl: account ", Strings.toHexString(account), " is missing role ", Strings.toHexString(uint256(role), 32) ) ) ); } } /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) { return _roles[role].adminRole; } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. * * May emit a {RoleGranted} event. */ function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _grantRole(role, account); } /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. * * May emit a {RoleRevoked} event. */ function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _revokeRole(role, account); } /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been revoked `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. * * May emit a {RoleRevoked} event. */ function renounceRole(bytes32 role, address account) public virtual override { require(account == _msgSender(), "AccessControl: can only renounce roles for self"); _revokeRole(role, account); } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. Note that unlike {grantRole}, this function doesn't perform any * checks on the calling account. * * May emit a {RoleGranted} event. * * [WARNING] * ==== * This function should only be called from the constructor when setting * up the initial roles for the system. * * Using this function in any other way is effectively circumventing the admin * system imposed by {AccessControl}. * ==== * * NOTE: This function is deprecated in favor of {_grantRole}. */ function _setupRole(bytes32 role, address account) internal virtual { _grantRole(role, account); } /** * @dev Sets `adminRole` as ``role``'s admin role. * * Emits a {RoleAdminChanged} event. */ function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual { bytes32 previousAdminRole = getRoleAdmin(role); _roles[role].adminRole = adminRole; emit RoleAdminChanged(role, previousAdminRole, adminRole); } /** * @dev Grants `role` to `account`. * * Internal function without access restriction. * * May emit a {RoleGranted} event. */ function _grantRole(bytes32 role, address account) internal virtual { if (!hasRole(role, account)) { _roles[role].members[account] = true; emit RoleGranted(role, account, _msgSender()); } } /** * @dev Revokes `role` from `account`. * * Internal function without access restriction. * * May emit a {RoleRevoked} event. */ function _revokeRole(bytes32 role, address account) internal virtual { if (hasRole(role, account)) { _roles[role].members[account] = false; emit RoleRevoked(role, account, _msgSender()); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/structs/EnumerableSet.sol) // This file was procedurally generated from scripts/generate/templates/EnumerableSet.js. pragma solidity ^0.8.0; /** * @dev Library for managing * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive * types. * * Sets have the following properties: * * - Elements are added, removed, and checked for existence in constant time * (O(1)). * - Elements are enumerated in O(n). No guarantees are made on the ordering. * * ```solidity * contract Example { * // Add the library methods * using EnumerableSet for EnumerableSet.AddressSet; * * // Declare a set state variable * EnumerableSet.AddressSet private mySet; * } * ``` * * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`) * and `uint256` (`UintSet`) are supported. * * [WARNING] * ==== * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure * unusable. * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info. * * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an * array of EnumerableSet. * ==== */ library EnumerableSet { // To implement this library for multiple types with as little code // repetition as possible, we write it in terms of a generic Set type with // bytes32 values. // The Set implementation uses private functions, and user-facing // implementations (such as AddressSet) are just wrappers around the // underlying Set. // This means that we can only create new EnumerableSets for types that fit // in bytes32. struct Set { // Storage of set values bytes32[] _values; // Position of the value in the `values` array, plus 1 because index 0 // means a value is not in the set. mapping(bytes32 => uint256) _indexes; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function _add(Set storage set, bytes32 value) private returns (bool) { if (!_contains(set, value)) { set._values.push(value); // The value is stored at length-1, but we add 1 to all indexes // and use 0 as a sentinel value set._indexes[value] = set._values.length; return true; } else { return false; } } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function _remove(Set storage set, bytes32 value) private returns (bool) { // We read and store the value's index to prevent multiple reads from the same storage slot uint256 valueIndex = set._indexes[value]; if (valueIndex != 0) { // Equivalent to contains(set, value) // To delete an element from the _values array in O(1), we swap the element to delete with the last one in // the array, and then remove the last element (sometimes called as 'swap and pop'). // This modifies the order of the array, as noted in {at}. uint256 toDeleteIndex = valueIndex - 1; uint256 lastIndex = set._values.length - 1; if (lastIndex != toDeleteIndex) { bytes32 lastValue = set._values[lastIndex]; // Move the last value to the index where the value to delete is set._values[toDeleteIndex] = lastValue; // Update the index for the moved value set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex } // Delete the slot where the moved value was stored set._values.pop(); // Delete the index for the deleted slot delete set._indexes[value]; return true; } else { return false; } } /** * @dev Returns true if the value is in the set. O(1). */ function _contains(Set storage set, bytes32 value) private view returns (bool) { return set._indexes[value] != 0; } /** * @dev Returns the number of values on the set. O(1). */ function _length(Set storage set) private view returns (uint256) { return set._values.length; } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function _at(Set storage set, uint256 index) private view returns (bytes32) { return set._values[index]; } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function _values(Set storage set) private view returns (bytes32[] memory) { return set._values; } // Bytes32Set struct Bytes32Set { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _add(set._inner, value); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _remove(set._inner, value); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) { return _contains(set._inner, value); } /** * @dev Returns the number of values in the set. O(1). */ function length(Bytes32Set storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) { return _at(set._inner, index); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(Bytes32Set storage set) internal view returns (bytes32[] memory) { bytes32[] memory store = _values(set._inner); bytes32[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } // AddressSet struct AddressSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(AddressSet storage set, address value) internal returns (bool) { return _add(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(AddressSet storage set, address value) internal returns (bool) { return _remove(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(AddressSet storage set, address value) internal view returns (bool) { return _contains(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns the number of values in the set. O(1). */ function length(AddressSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(AddressSet storage set, uint256 index) internal view returns (address) { return address(uint160(uint256(_at(set._inner, index)))); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(AddressSet storage set) internal view returns (address[] memory) { bytes32[] memory store = _values(set._inner); address[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } // UintSet struct UintSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(UintSet storage set, uint256 value) internal returns (bool) { return _add(set._inner, bytes32(value)); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(UintSet storage set, uint256 value) internal returns (bool) { return _remove(set._inner, bytes32(value)); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(UintSet storage set, uint256 value) internal view returns (bool) { return _contains(set._inner, bytes32(value)); } /** * @dev Returns the number of values in the set. O(1). */ function length(UintSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(UintSet storage set, uint256 index) internal view returns (uint256) { return uint256(_at(set._inner, index)); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(UintSet storage set) internal view returns (uint256[] memory) { bytes32[] memory store = _values(set._inner); uint256[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC2981.sol) pragma solidity ^0.8.0; import "../utils/introspection/IERC165Upgradeable.sol"; /** * @dev Interface for the NFT Royalty Standard. * * A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal * support for royalty payments across all NFT marketplaces and ecosystem participants. * * _Available since v4.5._ */ interface IERC2981Upgradeable is IERC165Upgradeable { /** * @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of * exchange. The royalty amount is denominated and should be paid in that same unit of exchange. */ function royaltyInfo( uint256 tokenId, uint256 salePrice ) external view returns (address receiver, uint256 royaltyAmount); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol) pragma solidity ^0.8.0; import "./IERC165Upgradeable.sol"; import "../../proxy/utils/Initializable.sol"; /** * @dev Implementation of the {IERC165} interface. * * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check * for the additional interface id that will be supported. For example: * * ```solidity * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId); * } * ``` * * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation. */ abstract contract ERC165Upgradeable is Initializable, IERC165Upgradeable { function __ERC165_init() internal onlyInitializing { } function __ERC165_init_unchained() internal onlyInitializing { } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IERC165Upgradeable).interfaceId; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol) pragma solidity ^0.8.2; import "../../utils/AddressUpgradeable.sol"; /** * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. * * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in * case an upgrade adds a module that needs to be initialized. * * For example: * * [.hljs-theme-light.nopadding] * ```solidity * contract MyToken is ERC20Upgradeable { * function initialize() initializer public { * __ERC20_init("MyToken", "MTK"); * } * } * * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable { * function initializeV2() reinitializer(2) public { * __ERC20Permit_init("MyToken"); * } * } * ``` * * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. * * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity. * * [CAUTION] * ==== * Avoid leaving a contract uninitialized. * * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() { * _disableInitializers(); * } * ``` * ==== */ abstract contract Initializable { /** * @dev Indicates that the contract has been initialized. * @custom:oz-retyped-from bool */ uint8 private _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool private _initializing; /** * @dev Triggered when the contract has been initialized or reinitialized. */ event Initialized(uint8 version); /** * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope, * `onlyInitializing` functions can be used to initialize parent contracts. * * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a * constructor. * * Emits an {Initialized} event. */ modifier initializer() { bool isTopLevelCall = !_initializing; require( (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1), "Initializable: contract is already initialized" ); _initialized = 1; if (isTopLevelCall) { _initializing = true; } _; if (isTopLevelCall) { _initializing = false; emit Initialized(1); } } /** * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be * used to initialize parent contracts. * * A reinitializer may be used after the original initialization step. This is essential to configure modules that * are added through upgrades and that require initialization. * * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer` * cannot be nested. If one is invoked in the context of another, execution will revert. * * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in * a contract, executing them in the right order is up to the developer or operator. * * WARNING: setting the version to 255 will prevent any future reinitialization. * * Emits an {Initialized} event. */ modifier reinitializer(uint8 version) { require(!_initializing && _initialized < version, "Initializable: contract is already initialized"); _initialized = version; _initializing = true; _; _initializing = false; emit Initialized(version); } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} and {reinitializer} modifiers, directly or indirectly. */ modifier onlyInitializing() { require(_initializing, "Initializable: contract is not initializing"); _; } /** * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call. * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized * to any version. 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 executed. */ function _disableInitializers() internal virtual { require(!_initializing, "Initializable: contract is initializing"); if (_initialized != type(uint8).max) { _initialized = type(uint8).max; emit Initialized(type(uint8).max); } } /** * @dev Returns the highest version that has been initialized. See {reinitializer}. */ function _getInitializedVersion() internal view returns (uint8) { return _initialized; } /** * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}. */ function _isInitializing() internal view returns (bool) { return _initializing; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165 { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
// SPDX-License-Identifier: MIT pragma solidity 0.8.23; /** * @custom:audit Changes from base contract `seadrop/src/interfaces/ISeaDropTokenContractMetadata.sol`: * - deleted {setMaxSupply}, * - deleted everything related to royalties. */ interface INFTContractMetadata { /** * @notice Throw if the max supply exceeds uint64, a limit * due to the storage of bit-packed variables in ERC721A. */ error CannotExceedMaxSupplyOfUint64(uint256 newMaxSupply); /** * @dev Revert with an error when attempting to set the provenance * hash after the mint has started. */ error ProvenanceHashCannotBeSetAfterMintStarted(); /** * @dev Emit an event for token metadata reveals/updates, * according to EIP-4906. * * @param _fromTokenId The start token id. * @param _toTokenId The end token id. */ event BatchMetadataUpdate(uint256 _fromTokenId, uint256 _toTokenId); /** * @dev Emit an event when the URI for the collection-level metadata * is updated. */ event ContractURIUpdated(string newContractURI); /** * @dev Emit an event when the max token supply is updated. */ event MaxSupplyUpdated(uint256 newMaxSupply); /** * @dev Emit an event with the previous and new provenance hash after * being updated. */ event ProvenanceHashUpdated(bytes32 previousHash, bytes32 newHash); /** * @notice Sets the base URI for the token metadata and emits an event. * * @param tokenURI The new base URI to set. */ function setBaseURI(string calldata tokenURI) external; /** * @notice Sets the contract URI for contract metadata. * * @param newContractURI The new contract URI. */ function setContractURI(string calldata newContractURI) external; /** * @notice Sets the provenance hash and emits an event. * * The provenance hash is used for random reveals, which * is a hash of the ordered metadata to show it has not been * modified after mint started. * * This function will revert after the first item has been minted. * * @param newProvenanceHash The new provenance hash to set. */ function setProvenanceHash(bytes32 newProvenanceHash) external; /** * @notice Returns the base URI for token metadata. */ function baseURI() external view returns (string memory); /** * @notice Returns the contract URI. */ function contractURI() external view returns (string memory); /** * @notice Returns the max token supply. */ function maxSupply() external view returns (uint256); /** * @notice Returns the provenance hash. * The provenance hash is used for random reveals, which * is a hash of the ordered metadata to show it is unmodified * after mint has started. */ function provenanceHash() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.2.2 // Creator: Chiru Labs pragma solidity ^0.8.23; import {IERC721A} from "ERC721A/IERC721A.sol"; import {Initializable} from "openzeppelin-contracts-upgradeable/proxy/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); } /** * @custom:audit Added `minterOf` support in `_mint`, compared to OpenSea base contract. * * @title ERC721A * * @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721) * Non-Fungible Token Standard, including the Metadata extension. * Optimized for lower gas during batch mints. * * Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...) * starting from `_startTokenId()`. * * Assumptions: * * - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply. * - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256). * */ contract 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; mapping(uint256 => address) public minterOf; // ============================================================= // CONSTRUCTOR // ============================================================= function __ERC721ACloneable__init( string memory name_, string memory symbol_ ) internal onlyInitializing { _name = name_; _symbol = symbol_; _currentIndex = _startTokenId(); } // ============================================================= // TOKEN COUNTING OPERATIONS // ============================================================= /** * @dev Returns the starting token ID. * To change the starting token ID, please override this function. */ function _startTokenId() internal view virtual returns (uint256) { return 0; } /** * @dev Returns the next token ID to be minted. */ function _nextTokenId() internal view virtual returns (uint256) { return _currentIndex; } /** * @dev Returns the total number of tokens in existence. * Burned tokens will reduce the count. * To get the total number of tokens minted, please see {_totalMinted}. */ function totalSupply() public view virtual override returns (uint256) { // Counter underflow is impossible as _burnCounter cannot be incremented // more than `_currentIndex - _startTokenId()` times. unchecked { return _currentIndex - _burnCounter - _startTokenId(); } } /** * @dev Returns the total amount of tokens minted in the contract. */ function _totalMinted() internal view virtual returns (uint256) { // Counter underflow is impossible as `_currentIndex` does not decrement, // and it is initialized to `_startTokenId()`. unchecked { return _currentIndex - _startTokenId(); } } /** * @dev Returns the total number of tokens burned. */ function _totalBurned() internal view virtual returns (uint256) { return _burnCounter; } // ============================================================= // ADDRESS DATA OPERATIONS // ============================================================= /** * @dev Returns the number of tokens in `owner`'s account. */ function balanceOf( address owner ) public view virtual override returns (uint256) { if (owner == address(0)) revert BalanceQueryForZeroAddress(); return _packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens minted by `owner`. */ function _numberMinted(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens burned by or on behalf of `owner`. */ function _numberBurned(address owner) internal view returns (uint256) { return (_packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). */ function _getAux(address owner) internal view returns (uint64) { return uint64(_packedAddressData[owner] >> _BITPOS_AUX); } /** * Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used). * If there are multiple variables, please pack them into a uint64. */ function _setAux(address owner, uint64 aux) internal virtual { uint256 packed = _packedAddressData[owner]; uint256 auxCasted; // Cast `aux` with assembly to avoid redundant masking. assembly { auxCasted := aux } packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX); _packedAddressData[owner] = packed; } // ============================================================= // IERC165 // ============================================================= /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified) * to learn more about how these ids are created. * * This function call must use less than 30000 gas. */ function supportsInterface( bytes4 interfaceId ) public view virtual override returns (bool) { // The interface IDs are constants representing the first 4 bytes // of the XOR of all function selectors in the interface. // See: [ERC165](https://eips.ethereum.org/EIPS/eip-165) // (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`) return interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165. interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721. interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata. } // ============================================================= // IERC721Metadata // ============================================================= /** * @dev Returns the token collection name. */ function name() public view virtual override returns (string memory) { return _name; } /** * @dev Returns the token collection symbol. */ function symbol() public view virtual override returns (string memory) { return _symbol; } /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI( uint256 tokenId ) public view virtual override returns (string memory) { if (!_exists(tokenId)) revert URIQueryForNonexistentToken(); string memory baseURI = _baseURI(); return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : ""; } /** * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each * token will be the concatenation of the `baseURI` and the `tokenId`. Empty * by default, it can be overridden in child contracts. */ function _baseURI() internal view virtual returns (string memory) { return ""; } // ============================================================= // OWNERSHIPS OPERATIONS // ============================================================= /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf( uint256 tokenId ) public view virtual override returns (address) { return address(uint160(_packedOwnershipOf(tokenId))); } /** * @dev Gas spent here starts off proportional to the maximum mint batch size. * It gradually moves to O(1) as tokens get transferred around over time. */ function _ownershipOf( uint256 tokenId ) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnershipOf(tokenId)); } /** * @dev Returns the unpacked `TokenOwnership` struct at `index`. */ function _ownershipAt( uint256 index ) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnerships[index]); } /** * @dev Initializes the ownership slot minted at `index` for efficiency purposes. */ function _initializeOwnershipAt(uint256 index) internal virtual { if (_packedOwnerships[index] == 0) { _packedOwnerships[index] = _packedOwnershipOf(index); } } /** * Returns the packed ownership data of `tokenId`. */ function _packedOwnershipOf( uint256 tokenId ) private view returns (uint256) { uint256 curr = tokenId; unchecked { if (_startTokenId() <= curr) { if (curr < _currentIndex) { uint256 packed = _packedOwnerships[curr]; // If not burned. if (packed & _BITMASK_BURNED == 0) { // Invariant: // There will always be an initialized ownership slot // (i.e. `ownership.addr != address(0) && ownership.burned == false`) // before an unintialized ownership slot // (i.e. `ownership.addr == address(0) && ownership.burned == false`) // Hence, `curr` will not underflow. // // We can directly compare the packed value. // If the address is zero, packed will be zero. while (packed == 0) { packed = _packedOwnerships[--curr]; } return packed; } } } } revert OwnerQueryForNonexistentToken(); } /** * @dev Returns the unpacked `TokenOwnership` struct from `packed`. */ function _unpackedOwnership( uint256 packed ) private pure returns (TokenOwnership memory ownership) { ownership.addr = address(uint160(packed)); ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP); ownership.burned = packed & _BITMASK_BURNED != 0; ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA); } /** * @dev Packs ownership data into a single uint256. */ function _packOwnershipData( address owner, uint256 flags ) private view returns (uint256 result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`. result := or( owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags) ) } } /** * @dev Returns the `nextInitialized` flag set if `quantity` equals 1. */ function _nextInitializedFlag( uint256 quantity ) private pure returns (uint256 result) { // For branchless setting of the `nextInitialized` flag. assembly { // `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`. result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1)) } } // ============================================================= // APPROVAL OPERATIONS // ============================================================= /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the * zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) public virtual override { address owner = ownerOf(tokenId); if (_msgSenderERC721A() != owner) { if (!isApprovedForAll(owner, _msgSenderERC721A())) { revert ApprovalCallerNotOwnerNorApproved(); } } _tokenApprovals[tokenId].value = to; emit Approval(owner, to, tokenId); } /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved( uint256 tokenId ) public view virtual override returns (address) { if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken(); return _tokenApprovals[tokenId].value; } /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} * for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll( address operator, bool approved ) public virtual override { _operatorApprovals[_msgSenderERC721A()][operator] = approved; emit ApprovalForAll(_msgSenderERC721A(), operator, approved); } /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll}. */ function isApprovedForAll( address owner, address operator ) public view virtual override returns (bool) { return _operatorApprovals[owner][operator]; } /** * @dev Returns whether `tokenId` exists. * * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}. * * Tokens start existing when they are minted. See {_mint}. */ function _exists(uint256 tokenId) internal view virtual returns (bool) { return _startTokenId() <= tokenId && tokenId < _currentIndex && // If within bounds, _packedOwnerships[tokenId] & _BITMASK_BURNED == 0; // and not burned. } /** * @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`. */ function _isSenderApprovedOrOwner( address approvedAddress, address owner, address msgSender ) private pure returns (bool result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean. msgSender := and(msgSender, _BITMASK_ADDRESS) // `msgSender == owner || msgSender == approvedAddress`. result := or(eq(msgSender, owner), eq(msgSender, approvedAddress)) } } /** * @dev Returns the storage slot and value for the approved address of `tokenId`. */ function _getApprovedSlotAndAddress( uint256 tokenId ) private view returns (uint256 approvedAddressSlot, address approvedAddress) { TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId]; // The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`. assembly { approvedAddressSlot := tokenApproval.slot approvedAddress := sload(approvedAddressSlot) } } // ============================================================= // TRANSFER OPERATIONS // ============================================================= /** * @dev Transfers `tokenId` from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) public virtual override { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner(); ( uint256 approvedAddressSlot, address approvedAddress ) = _getApprovedSlotAndAddress(tokenId); // The nested ifs save around 20+ gas over a compound boolean condition. if ( !_isSenderApprovedOrOwner( approvedAddress, from, _msgSenderERC721A() ) ) { if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved(); } if (to == address(0)) revert TransferToZeroAddress(); _beforeTokenTransfers(from, to, tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // We can directly increment and decrement the balances. --_packedAddressData[from]; // Updates: `balance -= 1`. ++_packedAddressData[to]; // Updates: `balance += 1`. // Updates: // - `address` to the next owner. // - `startTimestamp` to the timestamp of transfering. // - `burned` to `false`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData( to, _BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked) ); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } emit Transfer(from, to, tokenId); _afterTokenTransfers(from, to, tokenId, 1); } /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom( address from, address to, uint256 tokenId ) public 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 virtual override { transferFrom(from, to, tokenId); if (to.code.length != 0) { if (!_checkContractOnERC721Received(from, to, tokenId, _data)) { revert TransferToNonERC721ReceiverImplementer(); } } } /** * @dev Hook that is called before a set of serially-ordered token IDs * are about to be transferred. This includes minting. * And also called before burning one token. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _beforeTokenTransfers( address from, address to, uint256 startTokenId, uint256 quantity ) internal virtual {} /** * @dev Hook that is called after a set of serially-ordered token IDs * have been transferred. This includes minting. * And also called after one token has been burned. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` has been * transferred to `to`. * - When `from` is zero, `tokenId` has been minted for `to`. * - When `to` is zero, `tokenId` has been burned by `from`. * - `from` and `to` are never both zero. */ function _afterTokenTransfers( address from, address to, uint256 startTokenId, uint256 quantity ) internal virtual {} /** * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract. * * `from` - Previous owner of the given token ID. * `to` - Target address that will receive the token. * `tokenId` - Token ID to be transferred. * `_data` - Optional data to send along with the call. * * Returns whether the call correctly returned the expected magic value. */ function _checkContractOnERC721Received( address from, address to, uint256 tokenId, bytes memory _data ) private returns (bool) { try ERC721A__IERC721Receiver(to).onERC721Received( _msgSenderERC721A(), from, tokenId, _data ) returns (bytes4 retval) { return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector; } catch (bytes memory reason) { if (reason.length == 0) { revert TransferToNonERC721ReceiverImplementer(); } else { assembly { revert(add(32, reason), mload(reason)) } } } } // ============================================================= // MINT OPERATIONS // ============================================================= /** * @dev Mints `quantity` tokens and transfers them to `to`. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {Transfer} event for each mint. */ function _mint(address to, uint256 quantity) internal virtual { uint256 startTokenId = _currentIndex; if (quantity == 0) revert MintZeroQuantity(); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are incredibly unrealistic. // `balance` and `numberMinted` have a maximum limit of 2**64. // `tokenId` has a maximum limit of 2**256. unchecked { // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1); // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); uint256 toMasked; uint256 end = startTokenId + quantity; // Use assembly to loop and emit the `Transfer` event for gas savings. // The duplicated `log4` removes an extra check and reduces stack juggling. // The assembly, together with the surrounding Solidity code, have been // delicately arranged to nudge the compiler into producing optimized opcodes. assembly { // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. toMasked := and(to, _BITMASK_ADDRESS) // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. 0, // `address(0)`. toMasked, // `to`. startTokenId // `tokenId`. ) /// @custom:audit adding compared to OpenSea original contract // minterOf[tokenId] = to sstore(hashLocation(startTokenId, minterOf.slot), to) /// @custom:audit adding compared to OpenSea original contract function hashLocation(key, slot) -> location { mstore(0x80, key) mstore(0xa0, slot) location := keccak256(0x80, 0x40) } // The `iszero(eq(,))` check ensures that large values of `quantity` // that overflows uint256 will make the loop run out of gas. // The compiler will optimize the `iszero` away for performance. for { let tokenId := add(startTokenId, 1) } iszero(eq(tokenId, end)) { tokenId := add(tokenId, 1) } { /// @custom:audit adding compared to OpenSea original contract // minterOf[tokenId] = to sstore(hashLocation(tokenId, minterOf.slot), to) // Emit the `Transfer` event. Similar to above. log4(0, 0, _TRANSFER_EVENT_SIGNATURE, 0, toMasked, tokenId) } } if (toMasked == 0) revert MintToZeroAddress(); _currentIndex = end; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev This mint function excludes update of `minterOf`. * @dev Mints `quantity` tokens and transfers them to `to`. * * This function is intended for efficient minting only during contract creation. * * It emits only one {ConsecutiveTransfer} as defined in * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309), * instead of a sequence of {Transfer} event(s). * * Calling this function outside of contract creation WILL make your contract * non-compliant with the ERC721 standard. * For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309 * {ConsecutiveTransfer} event is only permissible during contract creation. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {ConsecutiveTransfer} event. */ function _mintERC2309(address to, uint256 quantity) internal virtual { uint256 startTokenId = _currentIndex; if (to == address(0)) revert MintToZeroAddress(); if (quantity == 0) revert MintZeroQuantity(); if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) revert MintERC2309QuantityExceedsLimit(); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are unrealistic due to the above check for `quantity` to be below the limit. unchecked { // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. _packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1); // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. _packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); emit ConsecutiveTransfer( startTokenId, startTokenId + quantity - 1, address(0), to ); _currentIndex = startTokenId + quantity; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev Safely mints `quantity` tokens and transfers them to `to`. * * Requirements: * * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called for each safe transfer. * - `quantity` must be greater than 0. * * See {_mint}. * * Emits a {Transfer} event for each mint. */ function _safeMint( address to, uint256 quantity, bytes memory _data ) internal virtual { _mint(to, quantity); unchecked { if (to.code.length != 0) { uint256 end = _currentIndex; uint256 index = end - quantity; do { if ( !_checkContractOnERC721Received( address(0), to, index++, _data ) ) { revert TransferToNonERC721ReceiverImplementer(); } } while (index < end); // Reentrancy protection. if (_currentIndex != end) revert(); } } } /** * @dev Equivalent to `_safeMint(to, quantity, '')`. */ function _safeMint(address to, uint256 quantity) internal virtual { _safeMint(to, quantity, ""); } // ============================================================= // BURN OPERATIONS // ============================================================= /** * @dev Equivalent to `_burn(tokenId, false)`. */ function _burn(uint256 tokenId) internal virtual { _burn(tokenId, false); } /** * @dev Destroys `tokenId`. * The approval is cleared when the token is burned. * * Requirements: * * - `tokenId` must exist. * * Emits a {Transfer} event. */ function _burn(uint256 tokenId, bool approvalCheck) internal virtual { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); address from = address(uint160(prevOwnershipPacked)); ( uint256 approvedAddressSlot, address approvedAddress ) = _getApprovedSlotAndAddress(tokenId); if (approvalCheck) { // The nested ifs save around 20+ gas over a compound boolean condition. if ( !_isSenderApprovedOrOwner( approvedAddress, from, _msgSenderERC721A() ) ) { if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved(); } } _beforeTokenTransfers(from, address(0), tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // Updates: // - `balance -= 1`. // - `numberBurned += 1`. // // We can directly decrement the balance, and increment the number burned. // This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`. _packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1; // Updates: // - `address` to the last owner. // - `startTimestamp` to the timestamp of burning. // - `burned` to `true`. // - `nextInitialized` to `true`. _packedOwnerships[tokenId] = _packOwnershipData( from, (_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked) ); // If the next slot may not have been initialized (i.e. `nextInitialized == false`) . if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) { uint256 nextTokenId = tokenId + 1; // If the next slot's address is zero and not burned (i.e. packed value is zero). if (_packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != _currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. _packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } emit Transfer(from, address(0), tokenId); _afterTokenTransfers(from, address(0), tokenId, 1); // Overflow not possible, as _burnCounter cannot be exceed _currentIndex times. unchecked { _burnCounter++; } } // ============================================================= // EXTRA DATA OPERATIONS // ============================================================= /** * @dev Directly sets the extra data for the ownership data `index`. */ function _setExtraDataAt( uint256 index, uint24 extraData ) internal virtual { uint256 packed = _packedOwnerships[index]; if (packed == 0) revert OwnershipNotInitializedForExtraData(); uint256 extraDataCasted; // Cast `extraData` with assembly to avoid redundant masking. assembly { extraDataCasted := extraData } packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA); _packedOwnerships[index] = packed; } /** * @dev Called during each token transfer to set the 24bit `extraData` field. * Intended to be overridden by the cosumer contract. * * `previousExtraData` - the value of `extraData` before transfer. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _extraData( address from, address to, uint24 previousExtraData ) internal view virtual returns (uint24) {} /** * @dev Returns the next extra data for the packed ownership data. * The returned result is shifted into position. */ function _nextExtraData( address from, address to, uint256 prevOwnershipPacked ) private view returns (uint256) { uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA); return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA; } // ============================================================= // OTHER OPERATIONS // ============================================================= /** * @dev Returns the message sender (defaults to `msg.sender`). * * If you are writing GSN compatible contracts, you need to override this function. */ function _msgSenderERC721A() internal view virtual returns (address) { return msg.sender; } /** * @dev Converts a uint256 to its ASCII string decimal representation. */ function _toString( uint256 value ) internal pure virtual returns (string memory str) { assembly { // The maximum value of a uint256 contains 78 digits (1 byte per digit), but // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned. // We will need 1 word for the trailing zeros padding, 1 word for the length, // and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0. let m := add(mload(0x40), 0xa0) // Update the free memory pointer to allocate. mstore(0x40, m) // Assign the `str` to the end. str := sub(m, 0x20) // Zeroize the slot after the string. mstore(str, 0) // Cache the end of the memory to calculate the length later. let end := str // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. // prettier-ignore for { let temp := value } 1 {} { str := sub(str, 1) // Write the character to the pointer. // The ASCII index of the '0' character is 48. mstore8(str, add(48, mod(temp, 10))) // Keep dividing `temp` until zero. temp := div(temp, 10) // prettier-ignore if iszero(temp) { break } } let length := sub(end, str) // Move the pointer 32 bytes leftwards to make room for the length. str := sub(str, 0x20) // Store the length. mstore(str, length) } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable2Step.sol) pragma solidity ^0.8.0; import "./OwnableUpgradeable.sol"; import "../proxy/utils/Initializable.sol"; /** * @dev Contract module which provides access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership} and {acceptOwnership}. * * This module is used through inheritance. It will make available all functions * from parent (Ownable). */ abstract contract Ownable2StepUpgradeable is Initializable, OwnableUpgradeable { function __Ownable2Step_init() internal onlyInitializing { __Ownable_init_unchained(); } function __Ownable2Step_init_unchained() internal onlyInitializing { } address private _pendingOwner; event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner); /** * @dev Returns the address of the pending owner. */ function pendingOwner() public view virtual returns (address) { return _pendingOwner; } /** * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one. * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual override onlyOwner { _pendingOwner = newOwner; emit OwnershipTransferStarted(owner(), newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner. * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual override { delete _pendingOwner; super._transferOwnership(newOwner); } /** * @dev The new owner accepts the ownership transfer. */ function acceptOwnership() public virtual { address sender = _msgSender(); require(pendingOwner() == sender, "Ownable2Step: caller is not the new owner"); _transferOwnership(sender); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol) pragma solidity ^0.8.0; /** * @dev External interface of AccessControl declared to support ERC165 detection. */ interface IAccessControl { /** * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole` * * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite * {RoleAdminChanged} not being emitted signaling this. * * _Available since v3.1._ */ event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole); /** * @dev Emitted when `account` is granted `role`. * * `sender` is the account that originated the contract call, an admin role * bearer except when using {AccessControl-_setupRole}. */ event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Emitted when `account` is revoked `role`. * * `sender` is the account that originated the contract call: * - if using `revokeRole`, it is the admin role bearer * - if using `renounceRole`, it is the role bearer (i.e. `account`) */ event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) external view returns (bool); /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {AccessControl-_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) external view returns (bytes32); /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function grantRole(bytes32 role, address account) external; /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function revokeRole(bytes32 role, address account) external; /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been granted `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. */ function renounceRole(bytes32 role, address account) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Context.sol) pragma solidity ^0.8.0; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol) pragma solidity ^0.8.0; import "./math/Math.sol"; import "./math/SignedMath.sol"; /** * @dev String operations. */ library Strings { bytes16 private constant _SYMBOLS = "0123456789abcdef"; uint8 private constant _ADDRESS_LENGTH = 20; /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { unchecked { uint256 length = Math.log10(value) + 1; string memory buffer = new string(length); uint256 ptr; /// @solidity memory-safe-assembly assembly { ptr := add(buffer, add(32, length)) } while (true) { ptr--; /// @solidity memory-safe-assembly assembly { mstore8(ptr, byte(mod(value, 10), _SYMBOLS)) } value /= 10; if (value == 0) break; } return buffer; } } /** * @dev Converts a `int256` to its ASCII `string` decimal representation. */ function toString(int256 value) internal pure returns (string memory) { return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMath.abs(value)))); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { unchecked { return toHexString(value, Math.log256(value) + 1); } } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = _SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "Strings: hex length insufficient"); return string(buffer); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation. */ function toHexString(address addr) internal pure returns (string memory) { return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH); } /** * @dev Returns true if the two strings are equal. */ function equal(string memory a, string memory b) internal pure returns (bool) { return keccak256(bytes(a)) == keccak256(bytes(b)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol) pragma solidity ^0.8.0; import "./IERC165.sol"; /** * @dev Implementation of the {IERC165} interface. * * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check * for the additional interface id that will be supported. For example: * * ```solidity * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId); * } * ``` * * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation. */ abstract contract ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IERC165).interfaceId; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165Upgradeable { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library AddressUpgradeable { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * * Furthermore, `isContract` will also return true if the target contract within * the same transaction is already scheduled for destruction by `SELFDESTRUCT`, * which only has an effect at the end of a transaction. * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract. * * _Available since v4.8._ */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata, string memory errorMessage ) internal view returns (bytes memory) { if (success) { if (returndata.length == 0) { // only check isContract if the call was successful and the return data is empty // otherwise we already know that it was a contract require(isContract(target), "Address: call to non-contract"); } return returndata; } else { _revert(returndata, errorMessage); } } /** * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason or using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { _revert(returndata, errorMessage); } } function _revert(bytes memory returndata, string memory errorMessage) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.2.2 // 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(); /** * The caller cannot approve to their own address. */ error ApproveToCaller(); /** * Cannot query the balance for the zero address. */ error BalanceQueryForZeroAddress(); /** * Cannot mint to the zero address. */ error MintToZeroAddress(); /** * The quantity of tokens minted must be more than zero. */ error MintZeroQuantity(); /** * The token does not exist. */ error OwnerQueryForNonexistentToken(); /** * The caller must own the token or be an approved operator. */ error TransferCallerNotOwnerNorApproved(); /** * The token must be owned by `from`. */ error TransferFromIncorrectOwner(); /** * Cannot safely transfer to a contract that does not implement the * ERC721Receiver interface. */ error TransferToNonERC721ReceiverImplementer(); /** * Cannot transfer to the zero address. */ error TransferToZeroAddress(); /** * The token does not exist. */ error URIQueryForNonexistentToken(); /** * The `quantity` minted with ERC2309 exceeds the safety limit. */ error MintERC2309QuantityExceedsLimit(); /** * The `extraData` cannot be set on an unintialized ownership slot. */ error OwnershipNotInitializedForExtraData(); // ============================================================= // 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; /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom( address from, address to, uint256 tokenId ) external; /** * @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; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the * zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} * for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool _approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll}. */ function isApprovedForAll(address owner, address operator) external view returns (bool); // ============================================================= // IERC721Metadata // ============================================================= /** * @dev Returns the token collection name. */ function name() external view returns (string memory); /** * @dev Returns the token collection symbol. */ function symbol() external view returns (string memory); /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) external view returns (string memory); // ============================================================= // IERC2309 // ============================================================= /** * @dev Emitted when tokens in `fromTokenId` to `toTokenId` * (inclusive) is transferred from `from` to `to`, as defined in the * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard. * * See {_mintERC2309} for more details. */ event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol) pragma solidity ^0.8.0; import "../utils/ContextUpgradeable.sol"; import "../proxy/utils/Initializable.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable { address private _owner; event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the deployer as the initial owner. */ function __Ownable_init() internal onlyInitializing { __Ownable_init_unchained(); } function __Ownable_init_unchained() internal onlyInitializing { _transferOwnership(_msgSender()); } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _checkOwner(); _; } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if the sender is not the owner. */ function _checkOwner() internal view virtual { require(owner() == _msgSender(), "Ownable: caller is not the owner"); } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby disabling any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol) pragma solidity ^0.8.0; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { enum Rounding { Down, // Toward negative infinity Up, // Toward infinity Zero // Toward zero } /** * @dev Returns the largest of two numbers. */ function max(uint256 a, uint256 b) internal pure returns (uint256) { return a > b ? a : b; } /** * @dev Returns the smallest of two numbers. */ function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /** * @dev Returns the average of two numbers. The result is rounded towards * zero. */ function average(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b) / 2 can overflow. return (a & b) + (a ^ b) / 2; } /** * @dev Returns the ceiling of the division of two numbers. * * This differs from standard division with `/` in that it rounds up instead * of rounding down. */ function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b - 1) / b can overflow on addition, so we distribute. return a == 0 ? 0 : (a - 1) / b + 1; } /** * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0 * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) * with further edits by Uniswap Labs also under MIT license. */ function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) { unchecked { // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256 // variables such that product = prod1 * 2^256 + prod0. uint256 prod0; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod0 := mul(x, y) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { // Solidity will revert if denominator == 0, unlike the div opcode on its own. // The surrounding unchecked block does not change this fact. // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic. return prod0 / denominator; } // Make sure the result is less than 2^256. Also prevents denominator == 0. require(denominator > prod1, "Math: mulDiv overflow"); /////////////////////////////////////////////// // 512 by 256 division. /////////////////////////////////////////////// // Make division exact by subtracting the remainder from [prod1 prod0]. uint256 remainder; assembly { // Compute remainder using mulmod. remainder := mulmod(x, y, denominator) // Subtract 256 bit number from 512 bit number. prod1 := sub(prod1, gt(remainder, prod0)) prod0 := sub(prod0, remainder) } // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1. // See https://cs.stackexchange.com/q/138556/92363. // Does not overflow because the denominator cannot be zero at this stage in the function. uint256 twos = denominator & (~denominator + 1); assembly { // Divide denominator by twos. denominator := div(denominator, twos) // Divide [prod1 prod0] by twos. prod0 := div(prod0, twos) // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one. twos := add(div(sub(0, twos), twos), 1) } // Shift in bits from prod1 into prod0. prod0 |= prod1 * twos; // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for // four bits. That is, denominator * inv = 1 mod 2^4. uint256 inverse = (3 * denominator) ^ 2; // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works // in modular arithmetic, doubling the correct bits in each step. inverse *= 2 - denominator * inverse; // inverse mod 2^8 inverse *= 2 - denominator * inverse; // inverse mod 2^16 inverse *= 2 - denominator * inverse; // inverse mod 2^32 inverse *= 2 - denominator * inverse; // inverse mod 2^64 inverse *= 2 - denominator * inverse; // inverse mod 2^128 inverse *= 2 - denominator * inverse; // inverse mod 2^256 // Because the division is now exact we can divide by multiplying with the modular inverse of denominator. // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1 // is no longer required. result = prod0 * inverse; return result; } } /** * @notice Calculates x * y / denominator with full precision, following the selected rounding direction. */ function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) { uint256 result = mulDiv(x, y, denominator); if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) { result += 1; } return result; } /** * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down. * * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11). */ function sqrt(uint256 a) internal pure returns (uint256) { if (a == 0) { return 0; } // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target. // // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`. // // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)` // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))` // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)` // // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit. uint256 result = 1 << (log2(a) >> 1); // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128, // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision // into the expected uint128 result. unchecked { result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; return min(result, a / result); } } /** * @notice Calculates sqrt(a), following the selected rounding direction. */ function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = sqrt(a); return result + (rounding == Rounding.Up && result * result < a ? 1 : 0); } } /** * @dev Return the log in base 2, rounded down, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 128; } if (value >> 64 > 0) { value >>= 64; result += 64; } if (value >> 32 > 0) { value >>= 32; result += 32; } if (value >> 16 > 0) { value >>= 16; result += 16; } if (value >> 8 > 0) { value >>= 8; result += 8; } if (value >> 4 > 0) { value >>= 4; result += 4; } if (value >> 2 > 0) { value >>= 2; result += 2; } if (value >> 1 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 2, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log2(value); return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0); } } /** * @dev Return the log in base 10, rounded down, of a positive value. * Returns 0 if given 0. */ function log10(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >= 10 ** 64) { value /= 10 ** 64; result += 64; } if (value >= 10 ** 32) { value /= 10 ** 32; result += 32; } if (value >= 10 ** 16) { value /= 10 ** 16; result += 16; } if (value >= 10 ** 8) { value /= 10 ** 8; result += 8; } if (value >= 10 ** 4) { value /= 10 ** 4; result += 4; } if (value >= 10 ** 2) { value /= 10 ** 2; result += 2; } if (value >= 10 ** 1) { result += 1; } } return result; } /** * @dev Return the log in base 10, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log10(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log10(value); return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0); } } /** * @dev Return the log in base 256, rounded down, of a positive value. * Returns 0 if given 0. * * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string. */ function log256(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 16; } if (value >> 64 > 0) { value >>= 64; result += 8; } if (value >> 32 > 0) { value >>= 32; result += 4; } if (value >> 16 > 0) { value >>= 16; result += 2; } if (value >> 8 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 256, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log256(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log256(value); return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol) pragma solidity ^0.8.0; /** * @dev Standard signed math utilities missing in the Solidity language. */ library SignedMath { /** * @dev Returns the largest of two signed numbers. */ function max(int256 a, int256 b) internal pure returns (int256) { return a > b ? a : b; } /** * @dev Returns the smallest of two signed numbers. */ function min(int256 a, int256 b) internal pure returns (int256) { return a < b ? a : b; } /** * @dev Returns the average of two signed numbers without overflow. * The result is rounded towards zero. */ function average(int256 a, int256 b) internal pure returns (int256) { // Formula from the book "Hacker's Delight" int256 x = (a & b) + ((a ^ b) >> 1); return x + (int256(uint256(x) >> 255) & (a ^ b)); } /** * @dev Returns the absolute unsigned value of a signed value. */ function abs(int256 n) internal pure returns (uint256) { unchecked { // must be unchecked in order to support `n = type(int256).min` return uint256(n >= 0 ? n : -n); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Context.sol) pragma solidity ^0.8.0; import "../proxy/utils/Initializable.sol"; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract ContextUpgradeable is Initializable { function __Context_init() internal onlyInitializing { } function __Context_init_unchained() internal onlyInitializing { } function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
{ "viaIR": true, "codegen": "yul", "remappings": [ "forge-std/=lib/forge-std/src/", "hardhat/=node_modules/hardhat/", "murky/=lib/murky/", "permit2/=lib/permit2/src/", "solmate/=lib/solmate/", "vesting-schedule/=lib/vesting-schedule/src/", "layer0/=lib/layer-zero-examples/contracts/", "seadrop/=lib/seadrop/", "ERC721A/=lib/ERC721A/contracts/", "chainlink/=lib/chainlink-brownie-contracts/contracts/src/v0.8/", "@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/", "openzeppelin-contracts/=lib/openzeppelin-contracts/contracts/", "openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/", "permit2-test/=lib/permit2/test/", "@ensdomains/=lib/vesting-schedule/node_modules/@ensdomains/", "@openzeppelin/=node_modules/@openzeppelin/", "@prb/test/=lib/vesting-schedule/lib/prb-test/src/", "@uniswap/=lib/layer-zero-examples/node_modules/@uniswap/", "ERC721A-Upgradeable/=lib/seadrop/lib/ERC721A-Upgradeable/contracts/", "chainlink-brownie-contracts/=lib/chainlink-brownie-contracts/contracts/src/v0.6/vendor/@arbitrum/nitro-contracts/src/", "create2-helpers/=lib/seadrop/lib/create2-helpers/", "create2-scripts/=lib/seadrop/lib/create2-helpers/script/", "ds-test/=lib/forge-std/lib/ds-test/src/", "erc4626-tests/=lib/openzeppelin-contracts-upgradeable/lib/erc4626-tests/", "eth-gas-reporter/=node_modules/eth-gas-reporter/", "forge-gas-snapshot/=lib/permit2/lib/forge-gas-snapshot/src/", "hardhat-deploy/=lib/layer-zero-examples/node_modules/hardhat-deploy/", "layer-zero-examples/=lib/layer-zero-examples/contracts/", "openzeppelin/=lib/openzeppelin-contracts-upgradeable/contracts/", "operator-filter-registry/=lib/seadrop/lib/operator-filter-registry/", "prb-test/=lib/vesting-schedule/lib/prb-test/src/", "utility-contracts/=lib/seadrop/lib/utility-contracts/" ], "evmVersion": "shanghai", "outputSelection": { "*": { "*": [ "abi", "metadata" ], "": [ "ast" ] } }, "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":"INORestricted_Deploy_MaxCapNotSet","type":"error"},{"inputs":[],"name":"INORestricted_Deploy_Name2CharsMin","type":"error"},{"inputs":[],"name":"INORestricted_Deploy_NftToCloneIsZeroAddr","type":"error"},{"inputs":[],"name":"INORestricted_Deploy_Symbole1CharMin","type":"error"},{"inputs":[],"name":"INORestricted_Init_PaymentReceiverIsZeroAddr","type":"error"},{"inputs":[],"name":"INORestricted_Init_ProjectWalletIsZeroAddr","type":"error"},{"inputs":[{"internalType":"enum Status","name":"current","type":"uint8"}],"name":"INORestricted_SaleStarted","type":"error"},{"inputs":[{"internalType":"uint256","name":"sent","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"}],"name":"INO_IncorrectERC20Amount","type":"error"},{"inputs":[{"internalType":"uint256","name":"sent","type":"uint256"},{"internalType":"uint256","name":"price","type":"uint256"}],"name":"INO_IncorrectNativeAmount","type":"error"},{"inputs":[{"internalType":"uint256","name":"maxMint","type":"uint256"},{"internalType":"uint256","name":"exceedBy","type":"uint256"}],"name":"INO_MaxMintINOReached","type":"error"},{"inputs":[{"internalType":"uint256","name":"maxMintInPhase","type":"uint256"},{"internalType":"uint256","name":"exceedBy","type":"uint256"}],"name":"INO_MaxMintInPhaseReached","type":"error"},{"inputs":[{"internalType":"bytes","name":"data","type":"bytes"}],"name":"INO_NativePaymentFailed","type":"error"},{"inputs":[{"internalType":"uint256","name":"multiple","type":"uint256"}],"name":"INO_OnlyUseMultipleOf","type":"error"},{"inputs":[],"name":"INO_PhaseDetailsNotFound","type":"error"},{"inputs":[{"internalType":"string","name":"","type":"string"}],"name":"INO_UseInstead","type":"error"},{"inputs":[],"name":"RestrictedWritableInternal_DifferentArraysLength","type":"error"},{"inputs":[],"name":"RestrictedWritableInternal_EmptyPhase","type":"error"},{"inputs":[],"name":"RestrictedWritable_EmptyMerkleRoot","type":"error"},{"inputs":[],"name":"RestrictedWritable_EmptyPhase","type":"error"},{"inputs":[],"name":"RestrictedWritable_EndBeforeStart","type":"error"},{"inputs":[],"name":"RestrictedWritable_EndInPast","type":"error"},{"inputs":[],"name":"RestrictedWritable_Init_OwnerIsZeroAddr","type":"error"},{"inputs":[],"name":"RestrictedWritable_Init_PaymentTokenIsZeroAddr","type":"error"},{"inputs":[],"name":"RestrictedWritable_Init_Permit2IsZeroAddr","type":"error"},{"inputs":[],"name":"RestrictedWritable_NewPhaseStatus","type":"error"},{"inputs":[{"internalType":"enum Status","name":"avoid","type":"uint8"},{"internalType":"enum Status","name":"phaseStatus","type":"uint8"}],"name":"RestrictedWritable_PhaseMatched","type":"error"},{"inputs":[],"name":"RestrictedWritable_PhaseMaxCapIsZero","type":"error"},{"inputs":[],"name":"RestrictedWritable_PhaseMerkleRootIsZero","type":"error"},{"inputs":[{"internalType":"enum Status","name":"expected","type":"uint8"},{"internalType":"enum Status","name":"current","type":"uint8"}],"name":"RestrictedWritable_PhaseNotMatched","type":"error"},{"inputs":[],"name":"RestrictedWritable_PhaseStartGteEnd","type":"error"},{"inputs":[],"name":"RestrictedWritable_ReceiverIsZeroAddr","type":"error"},{"inputs":[{"internalType":"enum Status","name":"avoid","type":"uint8"},{"internalType":"enum Status","name":"saleStatus","type":"uint8"}],"name":"RestrictedWritable_SaleMatched","type":"error"},{"inputs":[{"internalType":"enum Status","name":"expected","type":"uint8"},{"internalType":"enum Status","name":"current","type":"uint8"}],"name":"RestrictedWritable_SaleNotMatched","type":"error"},{"inputs":[],"name":"RestrictedWritable_StartAfterEnd","type":"error"},{"inputs":[],"name":"RestrictedWritable_TokenIsZeroAddr","type":"error"},{"inputs":[],"name":"SaleWritableInternal_AccountNotAuthorized","type":"error"},{"inputs":[],"name":"SaleWritableInternal_AllocationNotFound","type":"error"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"enum Status","name":"current","type":"uint8"}],"name":"SaleWritableInternal_PhaseNotOpened","type":"error"},{"inputs":[{"internalType":"enum Status","name":"current","type":"uint8"}],"name":"SaleWritableInternal_SaleNotOpened","type":"error"},{"inputs":[{"internalType":"uint256","name":"allocation","type":"uint256"},{"internalType":"uint256","name":"exceedsBy","type":"uint256"}],"name":"SaleWritable_AllocationExceeded","type":"error"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"},{"internalType":"uint256","name":"exceedsBy","type":"uint256"}],"name":"SaleWritable_MaxPhaseCapExceeded","type":"error"},{"inputs":[{"internalType":"uint256","name":"summedMaxPhaseCap","type":"uint256"},{"internalType":"uint256","name":"exceedsBy","type":"uint256"}],"name":"SaleWritable_SummedMaxPhaseCapExceeded","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string[]","name":"phaseId","type":"string[]"},{"components":[{"components":[{"internalType":"enum Status","name":"status","type":"uint8"},{"internalType":"bytes32","name":"rootHash","type":"bytes32"},{"internalType":"uint128","name":"startAt","type":"uint128"},{"internalType":"uint128","name":"endAt","type":"uint128"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"}],"internalType":"struct Phase","name":"base","type":"tuple"},{"internalType":"uint256","name":"phaseMaxMint","type":"uint256"}],"indexed":true,"internalType":"struct INOPhase[]","name":"phase","type":"tuple[]"}],"name":"INO_BatchPhaseUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"collection","type":"address"},{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"uri","type":"string"},{"internalType":"uint256","name":"maxCap","type":"uint256"},{"internalType":"uint256","name":"startTokenId","type":"uint256"}],"indexed":true,"internalType":"struct INOStorage.NFTCollectionData","name":"data","type":"tuple"}],"name":"INO_DeployedNftToSell","type":"event"},{"anonymous":false,"inputs":[{"components":[{"internalType":"address","name":"paymentToken","type":"address"},{"internalType":"address","name":"permit2","type":"address"}],"indexed":true,"internalType":"struct SaleStorage.SetUp","name":"saleSetUp","type":"tuple"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"components":[{"internalType":"address","name":"paymentReceiver","type":"address"},{"internalType":"address","name":"projectWallet","type":"address"}],"indexed":true,"internalType":"struct INOStorage.SetUp","name":"igoSetUp","type":"tuple"},{"indexed":false,"internalType":"string[]","name":"phaseIds_","type":"string[]"},{"components":[{"components":[{"internalType":"enum Status","name":"status","type":"uint8"},{"internalType":"bytes32","name":"rootHash","type":"bytes32"},{"internalType":"uint128","name":"startAt","type":"uint128"},{"internalType":"uint128","name":"endAt","type":"uint128"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"}],"internalType":"struct Phase","name":"base","type":"tuple"},{"internalType":"uint256","name":"phaseMaxMint","type":"uint256"}],"indexed":false,"internalType":"struct INOPhase[]","name":"phases","type":"tuple[]"}],"name":"INO_Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"phaseId","type":"string"},{"indexed":true,"internalType":"uint256","name":"oldPhaseMaxMint","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"newPhaseMaxMint","type":"uint256"}],"name":"INO_PhaseMaxMintUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"phaseId","type":"string"},{"components":[{"internalType":"enum Status","name":"status","type":"uint8"},{"internalType":"bytes32","name":"rootHash","type":"bytes32"},{"internalType":"uint128","name":"startAt","type":"uint128"},{"internalType":"uint128","name":"endAt","type":"uint128"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"}],"indexed":true,"internalType":"struct Phase","name":"oldData","type":"tuple"},{"components":[{"components":[{"internalType":"enum Status","name":"status","type":"uint8"},{"internalType":"bytes32","name":"rootHash","type":"bytes32"},{"internalType":"uint128","name":"startAt","type":"uint128"},{"internalType":"uint128","name":"endAt","type":"uint128"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"}],"internalType":"struct Phase","name":"base","type":"tuple"},{"internalType":"uint256","name":"phaseMaxMint","type":"uint256"}],"indexed":true,"internalType":"struct INOPhase","name":"newData","type":"tuple"}],"name":"INO_SinglePhaseUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"phaseId","type":"string"},{"indexed":true,"internalType":"uint256","name":"oldEndDate","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"newEndDate","type":"uint256"}],"name":"PhaseEndDateUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"phaseId","type":"string"},{"indexed":true,"internalType":"uint256","name":"oldMaxCap","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"newMaxCap","type":"uint256"}],"name":"PhaseMaxCapUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"phaseId","type":"string"},{"indexed":true,"internalType":"bytes32","name":"oldMerkleRoot","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newMerkleRoot","type":"bytes32"}],"name":"PhaseMerkleRootUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"phaseName","type":"string"}],"name":"PhaseOpened","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"phaseName","type":"string"}],"name":"PhasePaused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"phaseName","type":"string"}],"name":"PhaseResumed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"string","name":"phaseId","type":"string"},{"indexed":true,"internalType":"uint256","name":"oldStartDate","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"newStartDate","type":"uint256"}],"name":"PhaseStartDateUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"token","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"RecoveredLostERC20","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[],"name":"SaleClosed","type":"event"},{"anonymous":false,"inputs":[],"name":"SaleOpened","type":"event"},{"anonymous":false,"inputs":[],"name":"SalePaused","type":"event"},{"anonymous":false,"inputs":[],"name":"SaleResumed","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"string","name":"phaseId","type":"string"}],"name":"allocationReservedByIn","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"spendNow","type":"uint256"},{"components":[{"components":[{"components":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"uint256","name":"maxAllocation","type":"uint256"},{"internalType":"uint256","name":"saleTokenPerPaymentToken","type":"uint256"}],"internalType":"struct Allocation","name":"base","type":"tuple"},{"internalType":"address","name":"account","type":"address"}],"internalType":"struct UserAllocation","name":"usrData","type":"tuple"},{"internalType":"uint256","name":"refundFee","type":"uint256"}],"internalType":"struct UserAllocationFee","name":"allocation","type":"tuple"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"},{"components":[{"internalType":"bytes","name":"signature","type":"bytes"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"}],"internalType":"struct BuyPermission","name":"permission","type":"tuple"}],"name":"buyAndMintWithERC20","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"components":[{"components":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"uint256","name":"maxAllocation","type":"uint256"},{"internalType":"uint256","name":"saleTokenPerPaymentToken","type":"uint256"}],"internalType":"struct Allocation","name":"base","type":"tuple"},{"internalType":"address","name":"account","type":"address"}],"internalType":"struct UserAllocation","name":"usrData","type":"tuple"},{"internalType":"uint256","name":"refundFee","type":"uint256"}],"internalType":"struct UserAllocationFee","name":"allocation","type":"tuple"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"name":"buyAndMintWithNative","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"string[]","name":"phaseIds","type":"string[]"}],"name":"closePhases","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"closeSale","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"nftToClone","type":"address"},{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"uri","type":"string"},{"internalType":"uint256","name":"maxCap","type":"uint256"},{"internalType":"uint256","name":"startTokenId","type":"uint256"}],"internalType":"struct INOStorage.NFTCollectionData","name":"data","type":"tuple"}],"name":"deployNftToSell","outputs":[{"internalType":"address","name":"collection","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"string","name":"phaseId","type":"string"}],"name":"freeAllocationMintedBy","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"uint256","name":"toMint","type":"uint256"},{"internalType":"address","name":"account","type":"address"}],"internalType":"struct FreeAllocation","name":"allocation","type":"tuple"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"name":"freeMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"address","name":"paymentToken","type":"address"},{"internalType":"address","name":"permit2","type":"address"}],"internalType":"struct SaleStorage.SetUp","name":"saleSetUp","type":"tuple"},{"internalType":"address","name":"owner","type":"address"},{"components":[{"internalType":"address","name":"paymentReceiver","type":"address"},{"internalType":"address","name":"projectWallet","type":"address"}],"internalType":"struct INOStorage.SetUp","name":"inoSetUp","type":"tuple"},{"internalType":"string[]","name":"phaseIds","type":"string[]"},{"components":[{"components":[{"internalType":"enum Status","name":"status","type":"uint8"},{"internalType":"bytes32","name":"rootHash","type":"bytes32"},{"internalType":"uint128","name":"startAt","type":"uint128"},{"internalType":"uint128","name":"endAt","type":"uint128"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"}],"internalType":"struct Phase","name":"base","type":"tuple"},{"internalType":"uint256","name":"phaseMaxMint","type":"uint256"}],"internalType":"struct INOPhase[]","name":"phases","type":"tuple[]"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"inoSetUp","outputs":[{"components":[{"internalType":"address","name":"paymentReceiver","type":"address"},{"internalType":"address","name":"projectWallet","type":"address"}],"internalType":"struct INOStorage.SetUp","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"}],"name":"mintedInPhase","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nftCollection","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nftCollectionData","outputs":[{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"uri","type":"string"},{"internalType":"uint256","name":"maxCap","type":"uint256"},{"internalType":"uint256","name":"startTokenId","type":"uint256"}],"internalType":"struct INOStorage.NFTCollectionData","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"}],"name":"openPhase","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"openSale","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"}],"name":"pausePhase","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"pauseSale","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"}],"name":"phase","outputs":[{"components":[{"internalType":"enum Status","name":"status","type":"uint8"},{"internalType":"bytes32","name":"rootHash","type":"bytes32"},{"internalType":"uint128","name":"startAt","type":"uint128"},{"internalType":"uint128","name":"endAt","type":"uint128"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"}],"internalType":"struct Phase","name":"phase_","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"phaseIds","outputs":[{"internalType":"string[]","name":"phaseIds_","type":"string[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"}],"name":"phaseMaxMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"mintFor","type":"address"},{"internalType":"uint256","name":"spendNow","type":"uint256"},{"components":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"uint256","name":"unitPrice","type":"uint256"},{"internalType":"uint256","name":"maxAllocationPerWallet","type":"uint256"}],"internalType":"struct PublicPhaseDetails","name":"phaseDetails","type":"tuple"},{"components":[{"internalType":"bytes","name":"signature","type":"bytes"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"}],"internalType":"struct BuyPermission","name":"permission","type":"tuple"}],"name":"publicMintWithERC20","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"}],"name":"raisedInPhase","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"address","name":"to","type":"address"}],"name":"recoverLostERC20","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"}],"name":"resumePhase","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"resumeSale","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"saleStatus","outputs":[{"internalType":"enum Status","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"setUp","outputs":[{"internalType":"address","name":"paymentToken","type":"address"},{"internalType":"address","name":"permit2","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"summedMaxPhaseCap","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalMinted","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalRaised","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"uint128","name":"endAt","type":"uint128"}],"name":"updatePhaseEndDate","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"name":"updatePhaseMaxCapAndMerkleRoot","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"uint256","name":"phaseMaxMint","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"name":"updatePhaseMaxMintAndMerkleRoot","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"name":"updatePhaseMerkleRoot","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId","type":"string"},{"internalType":"uint128","name":"startAt","type":"uint128"}],"name":"updatePhaseStartDate","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"phaseId_","type":"string"},{"components":[{"components":[{"internalType":"enum Status","name":"status","type":"uint8"},{"internalType":"bytes32","name":"rootHash","type":"bytes32"},{"internalType":"uint128","name":"startAt","type":"uint128"},{"internalType":"uint128","name":"endAt","type":"uint128"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"}],"internalType":"struct Phase","name":"base","type":"tuple"},{"internalType":"uint256","name":"phaseMaxMint","type":"uint256"}],"internalType":"struct INOPhase","name":"phase_","type":"tuple"}],"name":"updateSetPhase","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string[]","name":"phaseIdentifiers_","type":"string[]"},{"components":[{"components":[{"internalType":"enum Status","name":"status","type":"uint8"},{"internalType":"bytes32","name":"rootHash","type":"bytes32"},{"internalType":"uint128","name":"startAt","type":"uint128"},{"internalType":"uint128","name":"endAt","type":"uint128"},{"internalType":"uint256","name":"maxPhaseCap","type":"uint256"}],"internalType":"struct Phase","name":"base","type":"tuple"},{"internalType":"uint256","name":"phaseMaxMint","type":"uint256"}],"internalType":"struct INOPhase[]","name":"phases_","type":"tuple[]"}],"name":"updateSetPhases","outputs":[],"stateMutability":"nonpayable","type":"function"}]
Contract Creation Code
9c4d535b000000000000000000000000000000000000000000000000000000000000000001000d178fad9ad22af56987eec8d3d1e406075d81eebaa1ec4e2ccbf978cca200000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0004000000000002000e000000000002000000600310027000000c28043001970003000000410355000200000001035500000c280030019d0000008003000039000000400030043f0000000100200190000001500000c13d000000040040008c00001ba40000413d000000000201043b000000e00220027000000c2a0020009c000001580000213d00000c490020009c000001690000a13d00000c4a0020009c000001910000213d00000c520020009c0000041f0000213d00000c560020009c00000cbf0000613d00000c570020009c00000e220000613d00000c580020009c00001ba40000c13d000000640040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d000b00040020003d0000000b03100360000000000303043b000c00000003001d00000c6b0030009c00001ba40000213d0000002403200039000900000003001d0000000c02300029000000000042004b00001ba40000213d0000004402100370000000000202043b000800000002001d0000002401100370000000000101043b000500000001001d309c22580000040f000000200100008a000a000c00100183309c22580000040f0000000c010000290000001f0710018f0000000b010000290000002001100039000700000001001d0000000203100367000000400100043d0000000a021000290000000a0000006b0000004e0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b0000004a0000c13d000000000007004b0000005b0000613d0000000a033003600000000304700210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000b00000007001d0000000c04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000060c96002000a200000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0110018f000000030010008c000010790000213d000000020010008c00000e010000613d000000080000006b0000145c0000613d000000400100043d0000000a02100029000000070300002900000002033003670000000a0000006b000000880000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000000840000c13d0000000b0000006b000000960000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d0000000a0320002900000007040000290000000204400367000000000101043b0000000101100039000000000101041a000400000001001d0000000a0000006b000000b70000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b000000b30000c13d0000000b0000006b000000c50000613d0000000a014003600000000b040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c030000290000000001320019000000000001043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c280030009c00000c28020000410000000002034019000300600020021800000003011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000040300003900000ca80400004100000004060000290000000807000029309c30920000040f000000010020019000001ba40000613d000000400100043d0000000a02100029000000070300002900000002033003670000000a0000006b000000f40000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000000f00000c13d0000000b0000006b000001020000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b00000001011000390000000802000029000000000021041b0000000701000029000000020310036700000c9a01000041000000000101041a000800000001001d000000400100043d0000000a021000290000000a0000006b000001260000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000001220000c13d0000000b0000006b000001340000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000301100039000000000101041a0008000800100073000016ed0000813d00000cdc01000041000000000010043f0000001101000039000000040010043f00000c69010000410000309e000104300000000001000416000000000001004b00001ba40000c13d00000020010000390000010000100443000001200000044300000c29010000410000309d0001042e00000c2b0020009c000001810000a13d00000c2c0020009c0000024e0000213d00000c340020009c0000045b0000213d00000c380020009c00000cd60000613d00000c390020009c00000e330000613d00000c3a0020009c00001ba40000c13d0000000001000416000000000001004b00001ba40000c13d00000c910100004100000da00000013d00000c590020009c000002cc0000a13d00000c5a0020009c000003020000213d00000c5e0020009c0000074e0000613d00000c5f0020009c00000a700000613d00000c600020009c00001ba40000c13d000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000401100370000000000101043b000000000010043f000000200000043f00000040020000390000000001000019309c307d0000040f000000010110003900000da00000013d00000c3b0020009c000002ec0000a13d00000c3c0020009c000003160000213d00000c400020009c000008610000613d00000c410020009c00000a7d0000613d00000c420020009c00001ba40000c13d0000000001000416000000000001004b00001ba40000c13d000000800000043f00000c7f010000410000309d0001042e00000c4b0020009c0000047b0000213d00000c4f0020009c00000cf80000613d00000c500020009c00000ec90000613d00000c510020009c00001ba40000c13d000000840040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b000c00000002001d0000002402100370000000000202043b00000c6b0020009c00001ba40000213d0000000006020019000000000224004900000c720020009c00001ba40000213d000000440020008c00001ba40000413d0000004402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d0000000403200039000000000331034f000000000303043b00000c6b0030009c00001ba40000213d000000240220003900000005053002100000000005250019000000000045004b00001ba40000213d0000006401100370000000000101043b000b00000001001d00000c6b0010009c00001ba40000213d0000000b0140006a00000c720010009c00001ba40000213d000000640010008c00001ba40000413d000000c001000039000000400010043f00000c8a01000041000000000101041a00000c6701100198000000800010043f00000c8b01000041000000000101041a00000c6701100197000000a00010043f000004510000613d000900000006001d0000000401600039000a00000001001d309c2aa80000040f00000002010003670000000a0a0000290000000a02100360000000000302043b0000000002000031000000090420006a000000430440008a00000c870540019700000c8706300197000000000756013f000000000056004b000000000500001900000c8705004041000000000043004b000000000400001900000c870400804100000c870070009c000000000504c019000000000005004b00001ba40000c13d0000000003a30019000000000431034f000000000404043b00000000053200490000005f0550008a00000c870650019700000c8707400197000000000867013f000000000067004b000000000600001900000c8706004041000000000054004b000000000500001900000c870500804100000c870080009c000000000605c019000000000006004b00001ba40000c13d0000000004340019000000000541034f000000000505043b00000000064200490000001f0660008a00000c870760019700000c8708500197000000000978013f000000000078004b000000000700001900000c8707004041000000000065004b000000000600001900000c870600804100000c870090009c000000000706c019000000000007004b00001ba40000c13d0000000004450019000000000541034f000000000505043b000900000005001d00000c6b0050009c00001ba40000213d000000090220006a000000200740003900000c870420019700000c8705700197000000000645013f000000000045004b000000000400001900000c8704004041000800000007001d000000000027004b000000000200001900000c870200204100000c870060009c000000000402c019000000000004004b00001ba40000c13d0000002002300039000000000121034f000000000101043b000700000001001d00000c670010009c00001ba40000213d00000000010a001900000000020a0019309c21940000040f0000000002010019309c21a90000040f00000040011000390000000201100367000000000101043b000600000001001d0000000a010000290000000002010019309c21940000040f0000000002010019309c21a90000040f00000020011000390000000201100367000000000601043b0000000801000029000000090200002900000007030000290000000c040000290000000605000029309c25260000040f0000000b01000029000000040610003900000c8f01000041000000000201041a000000800400043d000000a00100043d00000c670110019700000c670320019700000c670440019700000000020004110000000c05000029309c299d0000040f00000000010000190000309d0001042e00000c2d0020009c000004d40000213d00000c310020009c00000d170000613d00000c320020009c00000ed20000613d00000c330020009c00001ba40000c13d0000000001000416000000000001004b00001ba40000c13d00000c8201000041000000000401041a00000c6b0040009c000010c60000213d00000005014002100000003f0110003900000c830110019700000c6d0010009c000010c60000213d0000008001100039000000400010043f000000800040043f00000c8202000041000000000020043f000000000004004b000002ba0000613d000000a00500003900000c8406000041000000200700008a0000000008000019000600000004001d000000000b06041a0000000103b00190000000010ab002700000007f01a0018f000000000a0160190000001f00a0008c0000000002000039000000010200203900000000022b013f0000000100200190000010db0000c13d000000400900043d0000000002a90436000000000003004b000002820000c13d00000cf403b001970000000000320435000000000001004b000000200220c039000002a80000013d00070000000b001d00080000000a001d000900000009001d000a00000008001d000c00000005001d000b00000006001d000000000060043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f000000010020019000001ba40000613d0000000702000029000000020020008c00000000020000190000000c05000029000000200700008a0000000a0800002900000009090000290000000806000029000002a40000413d000000000101043b000000000200001900000020022000390000000003920019000000000401041a00000000004304350000000101100039000000000062004b0000029d0000413d0000000001290019000000200210003900000006040000290000000b0600002900000000019200490000001f01100039000000000271016f0000000001920019000000000021004b0000000002000039000000010200403900000c6b0010009c000010c60000213d0000000100200190000010c60000c13d000000400010043f000000000595043600000001066000390000000108800039000000000048004b0000026e0000413d000000400100043d00000020020000390000000003210436000000800200043d0000000000230435000000400310003900000005042002100000000007340019000000000002004b000010f40000c13d000000000217004900000c280020009c00000c2802008041000000600220021000000c280010009c00000c28010080410000004001100210000000000112019f0000309d0001042e00000c610020009c000004f10000a13d00000c620020009c00000a460000613d00000c630020009c00000be40000613d00000c640020009c00001ba40000c13d0000000001000416000000000001004b00001ba40000c13d309c22580000040f00000c7e01000041000000000101041a000000ff0210018f000000030020008c000010790000213d000000000002004b0000107f0000c13d00000cf40110019700000001011001bf00000c7e02000041000000000012041b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000010300003900000ced0400004100000ee30000013d00000c430020009c0000050f0000a13d00000c440020009c00000a570000613d00000c450020009c00000ca10000613d00000c460020009c00001ba40000c13d000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000401100370000000000101043b00000c6b0010009c00001ba40000213d00000004011000390000000002040019309c1fb10000040f309c20e50000040f00000e1a0000013d00000c5b0020009c0000091f0000613d00000c5c0020009c00000aa40000613d00000c5d0020009c00001ba40000c13d000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000401100370000000000101043b00000c6b0010009c00001ba40000213d00000004011000390000000002040019309c1fb10000040f309c20b30000040f00000e1a0000013d00000c3d0020009c00000a280000613d00000c3e0020009c00000b150000613d00000c3f0020009c00001ba40000c13d000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d000b00040020003d0000000b03100360000000000303043b000c00000003001d00000c6b0030009c00001ba40000213d0000002403200039000a00000003001d0000000c02300029000000000042004b00001ba40000213d0000002401100370000000000101043b000800000001001d00000c880010009c00001ba40000213d000000200100008a0009000c00100183309c22580000040f0000000c010000290000001f0710018f0000000b010000290000002001100039000700000001001d0000000203100367000000400100043d0000000902100029000000090000006b0000034b0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000003470000c13d000000000007004b000003580000613d00000009033003600000000304700210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000b00000007001d0000000c04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000060c96002000a200000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0210018f000000030020008c000010790000213d000000400100043d000000000002004b000013b70000c13d000000090210002900000007030000290000000203300367000000090000006b000003830000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b0000037f0000c13d0000000b0000006b000003910000613d00000009033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d000000000101043b0000000201100039000000000101041a0000008001100270000000080010006b000015940000813d000000090120002900000007030000290000000203300367000000090000006b000003b40000613d000000000403034f0000000005020019000000004604043c0000000005650436000000000015004b000003b00000c13d0000000b0000006b000003c20000613d00000009033003600000000b040000290000000304400210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003104350000000c0120002900000c9303000041000000000031043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d000000090320002900000007040000290000000204400367000000000101043b0000000201100039000000000101041a000700000001001d000000090000006b000003e30000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b000003df0000c13d0000000b0000006b000003f10000613d00000009014003600000000b040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c030000290000000001320019000000000001043500000c280030009c00000c28010000410000000001034019000000600110021000000c280020009c00000c28020080410000004002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c2801008041000000070200002900000c8806200197000000c00110021000000c77011001c70000800d02000039000000040300003900000ca6040000410000000807000029309c30920000040f000000010020019000001ba40000613d0000000a010000290000000c02000029309c20810000040f0000000201100039000000000201041a00000ca70220019700000008022001af000000000021041b00000000010000190000309d0001042e00000c530020009c00000d8e0000613d00000c540020009c00000ee80000613d00000c550020009c00001ba40000c13d000000840040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b000c00000002001d00000c670020009c00001ba40000213d0000002402100370000000000202043b000a00000002001d0000004402100370000000000202043b000b00000002001d00000c6b0020009c00001ba40000213d0000000b0340006a00000c720030009c00001ba40000213d000000640030008c00001ba40000413d0000006402100370000000000202043b000900000002001d00000c6b0020009c00001ba40000213d000000090240006a00000c720020009c00001ba40000213d000000640020008c00001ba40000413d000000c002000039000000400020043f00000c8a05000041000000000505041a00000c6705500198000000800050043f00000c8b05000041000000000505041a00000c6705500197000000a00050043f000011550000c13d00000c8c01000041000000c00010043f0000002001000039000000c40010043f0000001401000039000000e40010043f00000cdf01000041000001040010043f00000c8e010000410000309e0001043000000c350020009c00000d930000613d00000c360020009c00000f000000613d00000c370020009c00001ba40000c13d000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000002402100370000000000202043b000c00000002001d00000c670020009c00001ba40000213d0000000401100370000000000101043b000b00000001001d000000000010043f000000200000043f00000040020000390000000001000019309c307d0000040f0000000101100039000000000101041a309c23080000040f0000000b010000290000000c02000029309c24440000040f00000000010000190000309d0001042e00000c4c0020009c00000da40000613d00000c4d0020009c00000f8f0000613d00000c4e0020009c00001ba40000c13d000000e40040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000004402100370000000000202043b000b00000002001d00000c670020009c00001ba40000213d000000a402100370000000000202043b000c00000002001d00000c6b0020009c00001ba40000213d0000000c020000290000002302200039000000000042004b00001ba40000813d0000000c020000290000000402200039000000000221034f000000000202043b000a00000002001d00000c6b0020009c00001ba40000213d0000000c0200002900000024032000390000000a020000290000000502200210000900000003001d000700000002001d0000000002320019000000000042004b00001ba40000213d000000c402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d0000000403200039000000000131034f000000000101043b000600000001001d00000c6b0010009c00001ba40000213d000500240020003d0000000601000029000000c0011000c90000000501100029000000000041004b00001ba40000213d00000000010004150000000e0110008a00040005001002180000000201000039000000000101041a000800000001001d0003ff0000100194000015760000c13d00000000010004150000000d0110008a00040005001002180000000801000029000000ff00100190000015760000c13d000000080100002900000caa0110019700000101011001bf0000000202000039000000000012041b00000002010003670000006402100370000000000202043b00000c670020009c00001ba40000213d00080c670020019c000016a50000c13d000000400100043d00000cd8020000410000145e0000013d00000c2e0020009c00000e090000613d00000c2f0020009c000010710000613d00000c300020009c00001ba40000c13d000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b000c00000002001d00000c670020009c00001ba40000213d0000002401100370000000000101043b000b00000001001d00000c670010009c00001ba40000213d000a00000003001d309c22580000040f000000400500043d0000000c02000029000000000002004b000010eb0000c13d00000c7d01000041000010ee0000013d00000c650020009c00000a2d0000613d00000c660020009c00001ba40000c13d0000000001000416000000000001004b00001ba40000c13d000000c001000039000000400010043f000000800000043f000000a00000043f309c20070000040f00000c8f01000041000000000101041a00000c6701100197000000c00010043f00000cd302000041000000000202041a00000c6702200197000000e00020043f000000400200043d0000000001120436000000e00300043d00000c6703300197000000000031043500000c280020009c00000c2802008041000000400120021000000cef011001c70000309d0001042e00000c470020009c00000a3d0000613d00000c480020009c00001ba40000c13d000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b000b00000002001d00000c6b0020009c00001ba40000213d0000000b0240006a00000c720020009c00001ba40000213d000000640020008c00001ba40000413d0000002403100370000000000303043b00000c6b0030009c00001ba40000213d0000002305300039000000000045004b00001ba40000813d0000000405300039000000000551034f000000000505043b000c00000005001d00000c6b0050009c00001ba40000213d00000024033000390000000c050000290000000505500210000700000003001d000a00000005001d000800000035001d000000080040006b00001ba40000213d0000000b03000029000600040030003d0000000603100360000000000303043b000000230220008a00000c870530019700000c8706200197000000000765013f000000000065004b000000000500001900000c8705004041000000000023004b000000000200001900000c870200804100000c870070009c000000000502c019000000000005004b00001ba40000c13d0000000603300029000000000231034f000000000202043b00000c6b0020009c00001ba40000213d0000000004240049000000200330003900000c870540019700000c8706300197000000000756013f000000000056004b000000000500001900000c8705004041000000000043004b000000000400001900000c870400204100000c870070009c000000000504c019000000000005004b00001ba40000c13d000000000331034f00000cf5042001980000001f0520018f0000008001400039000005680000613d0000008006000039000000000703034f000000007807043c0000000006860436000000000016004b000005640000c13d000000000005004b000005750000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000800120003900000c9303000041000000000031043500000c950020009c00000c95020080410000006001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000cc50110009a0000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000101100039000000000101041a000400000001001d000000400100043d000900000001001d00000020021000390000000001000410000500000002001d000000000012043500000cc6010000410000000000100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c9e011001c70000800b02000039309c30970000040f000000010020019000001f900000613d000000000101043b00000009040000290000006002400039000000600300003900000000003204350000004002400039000000000012043500000002010003670000000602100360000000000202043b00000000040000310000000b0540006a000000230550008a00000c870650019700000c8707200197000000000867013f000000000067004b000000000600001900000c8706004041000000000052004b000000000500001900000c870500804100000c870080009c000000000605c019000000000006004b00001ba40000c13d0000000605200029000000000251034f000000000202043b00000c6b0020009c00001ba40000213d00000020055000390000000004240049000000000045004b000000000600001900000c870600204100000c870440019700000c8707500197000000000847013f000000000047004b000000000400001900000c870400404100000c870080009c000000000406c019000000000004004b00001ba40000c13d000000090800002900000080048000390000000000340435000000e0038000390000000000230435000000000551034f00000cf5062001980000001f0720018f00000100038000390000000004630019000005d90000613d000000000805034f0000000009030019000000008a08043c0000000009a90436000000000049004b000005d50000c13d000000000007004b000005e60000613d000000000565034f0000000306700210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005404350000000003320019000000000003043500000006040000290000002003400039000000000331034f000000000503043b0000000903000029000000a003300039000300000005001d0000000000530435000200400040003d0000000201100360000000000101043b00000c670010009c00001ba40000213d0000000904000029000000c00340003900000000001304350000001f0120003900000cf501100197000000e00210003900000000002404350000011f0110003900000cf5021001970000000001420019000000000021004b0000000002000039000000010200403900000c6b0010009c000010c60000213d0000000100200190000010c60000c13d000000400010043f000000050100002900000c280010009c00000c280100804100000040011002100000000902000029000000000202043300000c280020009c00000c28020080410000006002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000a020000290000003f0220003900000c8302200197000000400300043d0000000002230019000a00000003001d000000000032004b0000000003000039000000010300403900000c6b0020009c000010c60000213d0000000100300190000010c60000c13d000000400020043f0000000c020000290000000a040000290000000002240436000900000002001d0000000802000029000000000020007c00001ba40000213d0000000c0000006b0000065e0000613d000000070500002900000002025003670000000a0300002900000008060000290000002003300039000000002402043c00000000004304350000002005500039000000000065004b000006370000413d0000000a020000290000000002020433000000000002004b0000065e0000613d0000000003000019000c00000003001d000000050230021000000009022000290000000002020433000000000021004b0000064c0000813d000000000010043f000000200020043f00000000010004140000064f0000013d000000000020043f000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000c0300002900000001033000390000000a020000290000000002020433000000000023004b000006420000413d000000040010006c0000192e0000c13d00000002030003670000000601300360000000000101043b00000000040000310000000b0240006a000000230220008a00000c870520019700000c8706100197000000000756013f000000000056004b000000000500001900000c8705004041000000000021004b000000000200001900000c870200804100000c870070009c000000000502c019000000000005004b00001ba40000c13d0000000601100029000000000213034f000000000202043b00000c6b0020009c00001ba40000213d0000000005240049000000200610003900000c870150019700000c8707600197000000000817013f000000000017004b000000000100001900000c8701004041000000000056004b000000000500001900000c870500204100000c870080009c000000000105c019000000000001004b00001ba40000c13d0000001f0120003900000cf5011001970000003f0110003900000cf505100197000000400100043d0000000005510019000000000015004b0000000007000039000000010700403900000c6b0050009c000010c60000213d0000000100700190000010c60000c13d000000400050043f00000000052104360000000007620019000000000047004b00001ba40000213d000000000463034f00000cf5062001980000001f0720018f0000000003650019000006a40000613d000000000804034f0000000009050019000000008a08043c0000000009a90436000000000039004b000006a00000c13d000000000007004b000006b10000613d000000000464034f0000000306700210000000000703043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000043043500000000022500190000000000020435309c2f220000040f00000002010003670000000602100360000000000302043b00000000020000310000000b0420006a000000230440008a00000c870540019700000c8706300197000000000756013f000000000056004b000000000500001900000c8705004041000000000043004b000000000400001900000c870400804100000c870070009c000000000504c019000000000005004b00001ba40000c13d0000000603300029000000000431034f000000000404043b000c00000004001d00000c6b0040009c00001ba40000213d0000000c0220006a000000200630003900000c870320019700000c8704600197000000000534013f000000000034004b000000000300001900000c8703004041000a00000006001d000000000026004b000000000200001900000c870200204100000c870050009c000000000302c019000000000003004b00001ba40000c13d0000000a031003600000000c0200002900000cf5042001980009001f00200193000000400100043d000800000004001d0000000002410019000006eb0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000006e70000c13d000000090000006b000006f90000613d000000080330036000000009040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c04000029000000000241001900000cc903000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000070c96002000a200000007011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d00000008032000290000000a040000290000000204400367000000000101043b000000000101041a000a00000001001d000000080000006b0000071f0000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b0000071b0000c13d000000090000006b0000072d0000613d000000080140036000000009040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c0120002900000cca03000041000000000031043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000007011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000030010002a0000014a0000413d00000003011000290000000a0110006c00001bcd0000a13d000000400200043d0000002403200039000000000013043500000cd001000041000000000012043500000004012000390000000a03000029000000000031043500001b250000013d000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d000b00040020003d0000000b03100360000000000303043b000c00000003001d00000c6b0030009c00001ba40000213d0000002403200039000a00000003001d0000000c02300029000000000042004b00001ba40000213d0000002401100370000000000101043b000800000001001d00000c880010009c00001ba40000213d000000200100008a0009000c00100183309c22580000040f0000000c010000290000001f0710018f0000000b010000290000002001100039000700000001001d0000000203100367000000400100043d0000000902100029000000090000006b0000077d0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000007790000c13d000000000007004b0000078a0000613d00000009033003600000000304700210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000b00000007001d0000000c04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000060c96002000a200000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0110018f000000030010008c000010790000213d000000020010008c00000e010000613d00000c9d010000410000000000100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c9e011001c70000800b02000039309c30970000040f000000010020019000001f900000613d000000000101043b000000080010006b000018330000a13d000000400100043d000000090210002900000007030000290000000203300367000000090000006b000007c30000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000007bf0000c13d0000000b0000006b000007d10000613d00000009033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d000000000101043b0000000201100039000000000101041a00000c8801100197000000080010006b000016d90000a13d000000090120002900000007030000290000000203300367000000090000006b000007f40000613d000000000403034f0000000005020019000000004604043c0000000005650436000000000015004b000007f00000c13d0000000b0000006b000008020000613d00000009033003600000000b040000290000000304400210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003104350000000c0120002900000c9303000041000000000031043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d000000090320002900000007040000290000000204400367000000000101043b0000000201100039000000000101041a000700000001001d000000090000006b000008230000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b0000081f0000c13d0000000b0000006b000008310000613d00000009014003600000000b040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c030000290000000001320019000000000001043500000c280030009c00000c28010000410000000001034019000000600110021000000c280020009c00000c28020080410000004002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c280100804100000007020000290000008006200270000000c00110021000000c77011001c70000800d02000039000000040300003900000ceb040000410000000807000029309c30920000040f000000010020019000001ba40000613d0000000a010000290000000c02000029309c20810000040f000000080200002900000080022002100000000201100039000000000301041a00000c8803300197000000000223019f000000000021041b00000000010000190000309d0001042e000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d000b00040020003d0000000b01100360000000000101043b000c00000001001d00000c6b0010009c00001ba40000213d0000000c012000290000002401100039000000000041004b00001ba40000213d000000200100008a000a000c00100183309c22580000040f0000000c010000290000001f0710018f0000000b010000290000002001100039000900000001001d0000000203100367000000400100043d0000000a021000290000000a0000006b0000088a0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000008860000c13d000000000007004b000008970000613d0000000a033003600000000304700210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000b00000007001d0000000c04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000080c96002000a200000008011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0310018f000000030030008c000010790000213d000000400200043d00000c280020009c00000c28010000410000000001024019000000030030008c0000142e0000c13d0000000a03200029000000090400002900000002044003670000000a0000006b000008c50000613d000000000504034f0000000006020019000000005705043c0000000006760436000000000036004b000008c10000c13d0000000b0000006b000008d30000613d0000000a044003600000000b050000290000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000c0220002900000c930300004100000000003204350000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000008011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000201041a00000cf40220019700000001022001bf000000000021041b00000009010000290000000203100367000000400100043d0000000a021000290000000a0000006b000008f30000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000008ef0000c13d0000000b0000006b000009010000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c030000290000000002310019000000000002043500000c280030009c00000c2803008041000000600230021000000c280010009c00000c28010080410000004001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000020300003900000cc40400004100000ee30000013d000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b000900000002001d00000c6b0020009c00001ba40000213d00000009020000290000002302200039000000000042004b00001ba40000813d00000009020000290000000402200039000000000121034f000000000101043b000700000001001d00000c6b0010009c00001ba40000213d0000000901000029000b00240010003d000000070100002900000005011002100000000b01100029000000000041004b00001ba40000213d309c22580000040f000000070000006b00000ee60000613d000c00000000001d0000095f0000013d000000000321001900000c9304000041000000000043043500000c280020009c00000c28020080410000004002200210000000200110003900000c280010009c00000c28010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000201041a00000cf40220019700000002022001bf000000000021041b0000000c020000290000000102200039000c00000002001d000000070020006c00000ee60000813d0000000c0100002900000005011002100008000b0010002d00000002020003670000000801200360000000000101043b0000000003000031000000090430006a000000430440008a00000c870540019700000c8706100197000000000756013f000000000056004b000000000500001900000c8705004041000000000041004b000000000400001900000c870400804100000c870070009c000000000504c019000000000005004b00001ba40000c13d0000000b04100029000000000142034f000000000101043b00000c6b0010009c00001ba40000213d0000000005130049000000200340003900000c870450019700000c8706300197000000000746013f000000000046004b000000000400001900000c8704004041000000000053004b000000000500001900000c870500204100000c870070009c000000000405c019000000000004004b00001ba40000c13d000000000432034f00000cf505100198000000400200043d0000000003520019000009940000613d000000000604034f0000000007020019000000006806043c0000000007870436000000000037004b000009900000c13d0000001f06100190000009a10000613d000000000454034f0000000305600210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f0000000000430435000000000312001900000c9304000041000000000043043500000c280020009c00000c2802008041000000400220021000000c950010009c00000c95010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000ccd0110009a0000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000201100039000000000101041a000a00000001001d00000c9d010000410000000000100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c9e011001c70000800b02000039309c30970000040f000000010020019000001f900000613d0000000a020000290000008002200270000000000101043b000000000021004b0000095a0000413d00000002020003670000000801200360000000000101043b0000000004000031000000090340006a000000430330008a00000c870530019700000c8706100197000000000756013f000000000056004b000000000500001900000c8705004041000000000031004b000000000300001900000c870300804100000c870070009c000000000503c019000000000005004b00001ba40000c13d0000000b03100029000000000132034f000000000101043b00000c6b0010009c00001ba40000213d0000000005140049000000200630003900000c870350019700000c8707600197000000000837013f000000000037004b000000000300001900000c8703004041000000000056004b000000000500001900000c870500204100000c870080009c000000000305c019000000000003004b00001ba40000c13d0000001f0310003900000cf5033001970000003f0330003900000cf503300197000000400500043d0000000003350019000000000053004b0000000007000039000000010700403900000c6b0030009c000010c60000213d0000000100700190000010c60000c13d000000400030043f00000000031504360000000007610019000000000047004b00001ba40000213d000000000462034f00000cf506100198000000000263001900000a0c0000613d000000000704034f0000000008030019000000007907043c0000000008980436000000000028004b00000a080000c13d0000001f0710019000000a190000613d000000000464034f0000000306700210000000000702043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000042043500000000011300190000000000010435000000400200043d0000000001050433000000000001004b000009400000613d000000000400001900000000052400190000000006340019000000000606043300000000006504350000002004400039000000000014004b00000a200000413d000009400000013d0000000001000416000000000001004b00001ba40000c13d00000ca90100004100000da00000013d000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000401100370000000000101043b00000cf00010019800001ba40000c13d00000cf10010009c000010870000c13d0000000102000039000000010120018f000000800010043f00000c7f010000410000309d0001042e0000000001000416000000000001004b00001ba40000c13d0000000001040019309c1fcb0000040f000c00000002001d000b00000003001d309c21590000040f00000a780000013d0000000001000416000000000001004b00001ba40000c13d309c206d0000040f0000000021010434000000000202043300000c6702200197000000400300043d0000002004300039000000000024043500000c6701100197000000000013043500000c280030009c00000c2803008041000000400130021000000cef011001c70000309d0001042e000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b000000000020043f0000000102000039000000200020043f0000002401100370000000000101043b000c00000001001d00000040020000390000000001000019309c307d0000040f0000000c02000029309c301c0000040f0000000302200210000000000101041a000000000121022f00000c6701100197000000ff0020008c000000000100201900000e1b0000013d0000000001000416000000000001004b00001ba40000c13d0000000001040019309c1fcb0000040f000c00000002001d000b00000003001d309c21480000040f00000000030100190000000c010000290000000b02000029309c21170000040f00000e1a0000013d000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b000c00000002001d00000c670020009c00001ba40000213d0000002401100370000000000101043b00000c6b0010009c00001ba40000213d000000000114004900000c720010009c00001ba40000213d000000a40010008c00001ba40000413d309c22580000040f0000000202000039000000000102041a0000fffe00100190000016460000c13d00000caa0110019700000102011001bf000000000012041b00000c7e01000041000000000101041a000000ff0110018f000000030010008c000010790000213d000000000001004b0000114b0000c13d0000000c0000006b000013ff0000c13d000000400100043d00000cc3020000410000145e0000013d000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b000c00000002001d0000002401100370000000000101043b000b00000001001d00000c670010009c00001ba40000213d0000000c01000029000000000010043f000000200000043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000101100039000000000101041a309c23080000040f0000000c01000029000000000010043f000000200000043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000b02000029000000000020043f000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0010019000000b0a0000c13d0000000c01000029000000000010043f000000200000043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000b02000029000000000020043f000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000201041a00000cf40220019700000001022001bf000000000021041b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d020000390000000403000039000000000700041100000ce8040000410000000c050000290000000b06000029309c30920000040f000000010020019000001ba40000613d0000000c01000029000000000010043f0000000101000039000000200010043f00000040020000390000000001000019309c307d0000040f0000000b02000029309c30370000040f00000000010000190000309d0001042e000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d000b00040020003d0000000b03100360000000000303043b000c00000003001d00000c6b0030009c00001ba40000213d0000002403200039000900000003001d0000000c02300029000000000042004b00001ba40000213d0000002401100370000000000101043b000800000001001d000000200100008a000a000c00100183309c22580000040f0000000c010000290000001f0710018f0000000b010000290000002001100039000700000001001d0000000203100367000000400100043d0000000a021000290000000a0000006b00000b420000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00000b3e0000c13d000000000007004b00000b4f0000613d0000000a033003600000000304700210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000b00000007001d0000000c04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000060c96002000a200000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0110018f000000030010008c000010790000213d000000020010008c00000e010000613d000000080000006b0000145c0000613d000000400100043d0000000a02100029000000070300002900000002033003670000000a0000006b00000b7c0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00000b780000c13d0000000b0000006b00000b8a0000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d0000000a0320002900000007040000290000000204400367000000000101043b0000000101100039000000000101041a000700000001001d0000000a0000006b00000bab0000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b00000ba70000c13d0000000b0000006b00000bb90000613d0000000a014003600000000b040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c030000290000000001320019000000000001043500000c280030009c00000c28010000410000000001034019000000600110021000000c280020009c00000c28020080410000004002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000040300003900000ca80400004100000007060000290000000807000029309c30920000040f000000010020019000001ba40000613d00000009010000290000000c02000029309c20810000040f00000001011000390000000802000029000000000021041b00000000010000190000309d0001042e000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d000b00040020003d0000000b01100360000000000101043b000c00000001001d00000c6b0010009c00001ba40000213d0000000c012000290000002401100039000000000041004b00001ba40000213d000000200100008a000a000c00100183309c22580000040f0000000c010000290000001f0710018f0000000b010000290000002001100039000900000001001d0000000203100367000000400100043d0000000a021000290000000a0000006b00000c0d0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00000c090000c13d000000000007004b00000c1a0000613d0000000a033003600000000304700210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000b00000007001d0000000c04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000080c96002000a200000008011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0210018f000000040020008c000010790000813d000000400100043d000000010020008c000014560000c13d0000000a02100029000000090300002900000002033003670000000a0000006b00000c450000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00000c410000c13d0000000b0000006b00000c530000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000008011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000201041a00000cf40220019700000003022001bf000000000021041b00000009010000290000000203100367000000400100043d0000000a021000290000000a0000006b00000c750000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00000c710000c13d0000000b0000006b00000c830000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c030000290000000002310019000000000002043500000c280030009c00000c2803008041000000600230021000000c280010009c00000c28010080410000004001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000020300003900000cee0400004100000ee30000013d000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000002402100370000000000202043b000c00000002001d00000c670020009c00001ba40000213d0000000401100370000000000101043b000000000010043f000000200000043f00000040020000390000000001000019309c307d0000040f0000000c02000029000000000020043f000000200010043f00000000010000190000004002000039309c307d0000040f000000000101041a000000ff001001900000000001000039000000010100c039000000800010043f00000c7f010000410000309d0001042e0000000001000416000000000001004b00001ba40000c13d309c22580000040f00000c7e01000041000000000101041a000000ff0210018f000000030020008c000010790000213d000010900000c13d00000cf40110019700000001011001bf00000c7e02000041000000000012041b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000010300003900000ce70400004100000ee30000013d000000e40040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d000b00040020003d0000000b01100360000000000101043b000c00000001001d00000c6b0010009c00001ba40000213d0000002402200039000a00000002001d0000000c01200029000000000041004b00001ba40000213d309c22580000040f00000c7e01000041000000000101041a000000ff0110018f000000030010008c000010790000213d000000020010008c000012ad0000c13d000000400100043d00000ca40200004100000e030000013d0000000001000416000000000001004b00001ba40000c13d0000006001000039000000800010043f000000a00010043f000000c00010043f000000e00000043f000001000000043f000001c002000039000000400020043f00000cb001000041000000000301041a000000010430019000000001013002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000054004b000010db0000c13d000001c00010043f000000000004004b000010980000613d00000cb003000041000000000030043f000000000001004b000010b70000c13d0000002003000039000001e001000039000010cd0000013d000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b000900000002001d00000c6b0020009c00001ba40000213d00000009020000290000002302200039000000000042004b00001ba40000813d00000009020000290000000402200039000000000221034f000000000202043b000c00000002001d00000c6b0020009c00001ba40000213d0000000902000029000b00240020003d0000000c0200002900000005022002100000000b02200029000000000042004b00001ba40000213d0000002402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d0000000403200039000000000131034f000000000101043b000a00000001001d00000c6b0010009c00001ba40000213d000800240020003d0000000a01000029000000c0011000c90000000801100029000000000041004b00001ba40000213d309c22580000040f00000c7e01000041000000000101041a000000ff0110018f000000030010008c000010790000213d000000020010008c00000cf50000613d0000000b010000290000000c0200002900000008030000290000000a04000029309c2c440000040f000000400500043d0000000c0000006b000700000005001d0000159b0000c13d0000000702000029000000000125004900000c280010009c00000c2801008041000000600110021000000c280020009c00000c28020080410000004002200210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d000000000101043b000c00000001001d0000000a0000006b00000000010200190000000806000029000016ae0000c13d000000000121004900000c280010009c00000c2801008041000000600110021000000c280020009c00000c28020080410000004002200210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000601043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000030300003900000c89040000410000000c0500002900000ee30000013d0000000001000416000000000001004b00001ba40000c13d00000c9a0100004100000da00000013d000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000401100370000000000101043b000000000010043f0000000101000039000000200010043f00000040020000390000000001000019309c307d0000040f000000000101041a000000800010043f00000c7f010000410000309d0001042e000000640040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d000b00040020003d0000000b03100360000000000303043b000c00000003001d00000c6b0030009c00001ba40000213d0000002403200039000900000003001d0000000c02300029000000000042004b00001ba40000213d0000004402100370000000000202043b000800000002001d0000002401100370000000000101043b000500000001001d309c22580000040f000000200100008a000a000c00100183309c22580000040f0000000c010000290000001f0710018f0000000b010000290000002001100039000700000001001d0000000203100367000000400100043d0000000a021000290000000a0000006b00000dd50000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00000dd10000c13d000000000007004b00000de20000613d0000000a033003600000000304700210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000b00000007001d0000000c04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000060c96002000a200000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0110018f000000030010008c000010790000213d000000020010008c0000145a0000c13d000000400100043d00000cec0200004100000000002104350000002402100039000000020300003900000000003204350000000402100039000010a50000013d0000000001000416000000000001004b00001ba40000c13d0000000001040019309c20240000040f0000000013010434000b00000003001d000000400200043d000c00000002001d309c1fe80000040f0000000b030000290000000c01000029000000000413001900000c800200004100000000002404350000002002300039309c307d0000040f000000000101041a000000400200043d000000000012043500000c280020009c00000c2802008041000000400120021000000c81011001c70000309d0001042e000000440040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000002402100370000000000202043b00000c670020009c00001ba40000213d0000000003000411000000000032004b000010ab0000c13d0000000401100370000000000101043b309c24440000040f00000000010000190000309d0001042e000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000302043b00000c6b0030009c00001ba40000213d0000002302300039000000000042004b00001ba40000813d0000000405300039000000000251034f000000000202043b00000c6b0020009c000010c60000213d0000001f0720003900000cf5077001970000003f0770003900000cf50770019700000c6d0070009c000010c60000213d00000024033000390000008007700039000000400070043f000000800020043f0000000003320019000000000043004b00001ba40000213d0000002003500039000000000331034f00000cf5042001980000001f0520018f000000a00140003900000e5d0000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b00000e590000c13d000000000005004b00000e6a0000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a0012000390000000000010435000000400100043d00000c920010009c000010c60000213d000000a002100039000000400020043f000000800210003900000000000204350000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000400200043d000000800100043d000000000001004b00000e860000613d00000000030000190000000004230019000000a005300039000000000505043300000000005404350000002003300039000000000013004b00000e7f0000413d000000000321001900000c9304000041000000000043043500000c280020009c00000c28020080410000004002200210000000200110003900000c280010009c00000c28010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000400200043d00000c920020009c000010c60000213d000000a003200039000000400030043f000000000301041a000000ff0330018f000000030030008c000010790000213d00000000043204360000000105100039000000000505041a00000000005404350000000205100039000000000505041a00000060062000390000008007500270000000000076043500000c88055001970000004007200039000000000057043500000080022000390000000301100039000000000101041a0000000000120435000000400100043d000000000331043600000000040404330000000000430435000000000307043300000c880330019700000040041000390000000000340435000000000306043300000c88033001970000006004100039000000000034043500000000020204330000008003100039000000000023043500000c280010009c00000c2801008041000000400110021000000c94011001c70000309d0001042e0000000001000416000000000001004b00001ba40000c13d00000cbb01000041000000000101041a00000c6701100197000000800010043f00000c7f010000410000309d0001042e0000000001000416000000000001004b00001ba40000c13d309c22580000040f00000c7e01000041000000000201041a00000cf40220019700000002022001bf000000000021041b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000010300003900000c8604000041309c30920000040f000000010020019000001ba40000613d00000000010000190000309d0001042e0000000001000416000000000001004b00001ba40000c13d309c22580000040f00000c7e01000041000000000101041a000000ff0210018f000000030020008c000010790000213d000000010020008c0000109e0000c13d00000cf40110019700000003011001bf00000c7e02000041000000000012041b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000010300003900000ce10400004100000ee30000013d000000440040008c00001ba40000413d0000000402100370000000000202043b000c00000002001d00000c6b0020009c00001ba40000213d0000000c0240006a00000c720020009c00001ba40000213d000000440020008c00001ba40000413d0000002402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d0000000403200039000000000131034f000000000301043b00000c6b0030009c00001ba40000213d000000240220003900000005013002100000000001210019000000000041004b00001ba40000213d000000c001000039000000400010043f00000c8a01000041000000000101041a00000c6701100198000000800010043f00000c8b01000041000000000101041a00000c6701100197000000a00010043f000014640000c13d0000000c010000290000000401100039000b00000001001d309c2aa80000040f00000002040003670000000b080000290000000b01400360000000000301043b00000000010000310000000c0210006a000000430220008a00000c870520019700000c8706300197000000000756013f000000000056004b000000000500001900000c8705004041000000000023004b000000000200001900000c870200804100000c870070009c000000000502c019000000000005004b00001ba40000c13d0000000002830019000000000524034f000000000505043b00000000062100490000005f0660008a00000c870760019700000c8708500197000000000978013f000000000078004b000000000700001900000c8707004041000000000065004b000000000600001900000c870600804100000c870090009c000000000706c019000000000007004b00001ba40000c13d0000000005250019000000000254034f000000000202043b00000000065100490000001f0660008a00000c870760019700000c8708200197000000000978013f000000000078004b000000000700001900000c8707004041000000000062004b000000000600001900000c870600804100000c870090009c000000000706c019000000000007004b00001ba40000c13d0000000006520019000000000264034f000000000202043b00000c6b0020009c00001ba40000213d0000000007210049000000200160003900000c870670019700000c8708100197000000000968013f000000000068004b000000000600001900000c8706004041000000000071004b000000000700001900000c870700204100000c870090009c000000000607c019000000000006004b00001ba40000c13d0000000c033000290000002403300039000000000334034f000000000303043b00000c670030009c00001ba40000213d0000004006500039000000000764034f0000002005500039000000000454034f000000000604043b000000000507043b0000000004000416309c25260000040f00000c8f01000041000000000201041a000000000100041400000c6704200197000000040040008c000017640000c13d00000001020000390000000103000031000017a60000013d000000240040008c00001ba40000413d0000000002000416000000000002004b00001ba40000c13d0000000402100370000000000202043b00000c6b0020009c00001ba40000213d0000002303200039000000000043004b00001ba40000813d000b00040020003d0000000b01100360000000000101043b000c00000001001d00000c6b0010009c00001ba40000213d0000000c01200029000900240010003d000000090040006b00001ba40000213d000000200100008a000a000c00100183309c22580000040f0000000c010000290000001f0710018f0000000b010000290000002001100039000800000001001d0000000203100367000000400100043d0000000a021000290000000a0000006b00000fb80000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00000fb40000c13d000000000007004b00000fc50000613d0000000a033003600000000304700210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000b00000007001d0000000c04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000200240003900000c280020009c000700000002001d00000c28020080410000006002200210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0210018f000000030020008c000010790000213d000000400100043d000000000002004b000013b70000c13d0000000c020000290000001f0220003900000cf5022001970000003f0220003900000cf5022001970000000002210019000000000012004b0000000003000039000000010300403900000c6b0020009c000010c60000213d0000000100300190000010c60000c13d000000400020043f0000000c0200002900000000022104360000000904000029000000000040007c00001ba40000213d000000080300002900000002043003670000000a032000290000000a0000006b000010030000613d000000000504034f0000000006020019000000005705043c0000000006760436000000000036004b00000fff0000c13d0000000b0000006b000010110000613d0000000a044003600000000b050000290000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f000000000043043500000007031000290000000000030435000000400300043d0000000001010433000000000001004b0000101f0000613d000000000400001900000000053400190000000006240019000000000606043300000000006504350000002004400039000000000014004b000010180000413d000000000231001900000c9304000041000000000042043500000c280030009c00000c28030080410000004002300210000000200110003900000c280010009c00000c28010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000201041a00000cf40220019700000001022001bf000000000021041b00000008010000290000000203100367000000400100043d0000000a021000290000000a0000006b000010450000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000010410000c13d0000000b0000006b000010530000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c030000290000000002310019000000000002043500000c280030009c00000c2803008041000000600230021000000c280010009c00000c28010080410000004001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000020300003900000cd90400004100000ee30000013d0000000001000416000000000001004b00001ba40000c13d00000c7e01000041000000000101041a000000ff0110018f000000030010008c0000108d0000a13d00000cdc01000041000000000010043f0000002101000039000000040010043f00000c69010000410000309e00010430000000400100043d0000002403100039000000000023043500000ce002000041000000000021043500000004021000390000000000020435000010a60000013d00000cf20010009c0000000002000039000000010200603900000cf30010009c00000001022061bf000000010120018f000000800010043f00000c7f010000410000309d0001042e000000400100043d0000002403100039000000000023043500000ce002000041000000000021043500000004021000390000000303000039000010a50000013d00000cf403300197000001e00030043f000000000001004b0000020001000039000001e001006039000010c20000013d000000400100043d0000002403100039000000000023043500000ce002000041000000000021043500000004021000390000000103000039000000000032043500000c280010009c00000c2801008041000000400110021000000ca0011001c70000309e0001043000000c7501000041000000800010043f0000002001000039000000840010043f0000002f01000039000000a40010043f00000ce401000041000000c40010043f00000ce501000041000000e40010043f00000ce6010000410000309e0001043000000cb20300004100000000050000190000000004050019000000000503041a000001e006400039000000000056043500000001033000390000002005400039000000000015004b000010b90000413d0000020001400039000001a10110008a00000cf50310019700000cdb0030009c000010cc0000a13d00000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e00010430000001c001300039000000400010043f000001200020043f00000cb302000041000000000402041a000000010640019000000001024002700000007f0520018f00000000020560190000001f0020008c00000000070000390000000107002039000000000774013f0000000100700190000010e10000613d00000cdc01000041000000000010043f0000002201000039000000040010043f00000c69010000410000309e000104300000000000210435000000000006004b000011100000c13d00000cf402400197000001e0033000390000000000230435000000000005004b000000200400003900000000040060390000111f0000013d0000000b0000006b0000113e0000c13d00000c7b01000041000000000015043500000c280050009c00000c2805008041000000400150021000000c7c011001c70000309e00010430000000a0040000390000000006000019000010ff0000013d0000001f0980003900000cf5099001970000000008780019000000000008043500000000077900190000000106600039000000000026004b000002c30000813d0000000008170049000000400880008a0000000003830436000000004804043400000000980804340000000007870436000000000008004b000010f70000613d000000000a000019000000000b7a0019000000000ca90019000000000c0c04330000000000cb0435000000200aa0003900000000008a004b000011080000413d000010f70000013d00000cb305000041000000000050043f000000020040008c00000000040000190000111f0000413d00000cb505000041000001e00330003900000000040000190000000006430019000000000705041a000000000076043500000001055000390000002004400039000000000024004b000011180000413d0000000002140019000000200820003900000c6b0080009c000010c60000213d000000000018004b000010c60000413d000000400080043f000001400010043f00000cb601000041000000000301041a000000010530019000000001013002700000007f0410018f00000000010460190000001f0010008c00000000060000390000000106002039000000000663013f0000000100600190000010db0000c13d00000000070800190000000000180435000000000005004b000013bb0000c13d00000cf40130019700000040022000390000000000120435000000000004004b00000020030000390000000003006039000013ca0000013d00000c680100004100000000001504350000000401500039000000000300041000000000003104350000000001000414000000040020008c000012510000c13d0000000103000031000000200030008c000000200400003900000000040340190000127e0000013d000000400200043d00000cab0300004100000000003204350000000403200039000000000013043500000c280020009c00000c2802008041000000400120021000000c69011001c70000309e000104300000000b05000029000800040050003d0000000805100360000000000505043b000000230330008a00000c870650019700000c8707300197000000000876013f000000000076004b000000000600001900000c8706004041000000000035004b000000000300001900000c870300804100000c870080009c000000000603c019000000000006004b00001ba40000c13d0000000805500029000000000351034f000000000303043b00000c6b0030009c00001ba40000213d0000000006340049000000200450003900000c870560019700000c8707400197000000000857013f000000000057004b000000000500001900000c8705004041000000000064004b000000000600001900000c870600204100000c870080009c000000000506c019000000000005004b00001ba40000c13d000000000441034f00000cf5053001980000001f0630018f000000c001500039000011850000613d000000000704034f000000007807043c0000000002820436000000000012004b000011810000c13d000000000006004b000011920000613d000000000254034f0000000304600210000000000501043300000000054501cf000000000545022f000000000202043b0000010004400089000000000242022f00000000024201cf000000000252019f0000000000210435000000c00130003900000c9302000041000000000021043500000c950030009c00000c95030080410000006001300210000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000cdd0110009a0000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000101100039000000000101041a000500000001001d000000400100043d000700000001001d00000020021000390000000001000410000600000002001d000000000012043500000cc6010000410000000000100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c9e011001c70000800b02000039309c30970000040f000000010020019000001f900000613d000000000101043b00000007040000290000006002400039000000600300003900000000003204350000004002400039000000000012043500000002010003670000000802100360000000000202043b00000000040000310000000b0540006a000000230550008a00000c870650019700000c8707200197000000000867013f000000000067004b000000000600001900000c8706004041000000000052004b000000000500001900000c870500804100000c870080009c000000000605c019000000000006004b00001ba40000c13d0000000805200029000000000251034f000000000202043b00000c6b0020009c00001ba40000213d00000020055000390000000004240049000000000045004b000000000600001900000c870600204100000c870440019700000c8707500197000000000847013f000000000047004b000000000400001900000c870400404100000c870080009c000000000406c019000000000004004b00001ba40000c13d000000070800002900000080048000390000000000340435000000e0038000390000000000230435000000000551034f00000cf5062001980000001f0720018f00000100038000390000000004630019000011f60000613d000000000805034f0000000009030019000000008a08043c0000000009a90436000000000049004b000011f20000c13d000000000007004b000012030000613d000000000565034f0000000306700210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f0000000000540435000000000332001900000000000304350000000805000029000b00200050003d0000000b03100360000000000303043b0000000706000029000000a0046000390000000000340435000400400050003d0000000401100360000000000101043b000000c00360003900000000001304350000001f0120003900000cf501100197000000e00210003900000000002604350000011f0110003900000cf5021001970000000001620019000000000021004b0000000002000039000000010200403900000c6b0010009c000010c60000213d0000000100200190000010c60000c13d000000400010043f000000060100002900000c280010009c00000c280100804100000040011002100000000702000029000000000202043300000c280020009c00000c28020080410000006002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000050010006b000018120000c13d00000008010000290000000002010019309c216a0000040f0000000b04000029000000020440036700000004050000290000000203500367000000000603043b000000000504043b0000000c030000290000000a04000029309c25260000040f0000000901000029000000040610003900000c8f01000041000000000201041a000000800400043d000000a00100043d00000c670110019700000c670320019700000c670440019700000000020004110000000a05000029309c299d0000040f00000000010000190000309d0001042e00000c280050009c00000c28030000410000000003054019000000400330021000000c280010009c00000c2801008041000000c001100210000000000131019f00000c69011001c7000900000005001d309c30970000040f000000600310027000000c2803300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000090b00002900000009057000290000126c0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000012680000c13d000000000006004b000012790000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000014380000613d00000000050b00190000001f01400039000000600210018f0000000001520019000000000021004b0000000002000039000000010200403900000c6b0010009c000010c60000213d0000000100200190000010c60000c13d000000400010043f000000200040008c00001ba40000413d0000000006050433000000200210003900000c6c04000041000000000042043500000024041000390000000b0500002900000000005404350000004404100039000900000006001d00000000006404350000004404000039000000000041043500000c6d0010009c000010c60000213d0000008004100039000800000004001d000000400040043f00000c6e0010009c000010c60000213d000000c004100039000000400040043f000000200400003900000008050000290000000000450435000000a00410003900000c6f050000410000000000540435000000000401043300000000010004140000000c05000029000000040050008c000015e70000c13d0000000102000039000015f90000013d0000000c0200002900000cf5032001980009001f00200193000000400100043d000800000003001d00000000023100190000000b030000290000002003300039000b00000003001d0000000203300367000012be0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000012ba0000c13d000000090000006b000012cc0000613d000000080330036000000009040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000070c96002000a200000007011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d00000008032000290000000b040000290000000204400367000000000101043b000600000001001d000000080000006b000012f10000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b000012ed0000c13d000000090000006b000012ff0000613d000000080140036000000009040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c030000290000000001320019000000000001043500000c280030009c00000c28010000410000000001034019000000600110021000000c280020009c00000c28020080410000004002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000500000001001d0000000601000029000000000101041a000000ff0110018f000000030010008c000010790000213d000000400200043d000000000112043600000006050000290000000103500039000000000303041a00000000003104350000000201500039000000000101041a00000060032000390000008004100270000000000043043500000c8801100197000000400320003900000000001304350000000301500039000000000101041a0000008003200039000000000013043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000c97011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d000000000101043b000600000001001d00000002010003670000002403100370000000000303043b000000030030008c00001ba40000213d00000000033204360000004404100370000000000404043b00000000004304350000006403100370000000000303043b000400000003001d00000c880030009c00001ba40000213d0000004003200039000000040400002900000000004304350000008403100370000000000303043b00000c880030009c00001ba40000213d00000060042000390000000000340435000000a403100370000000000303043b00000080042000390000000000340435000000c401100370000000000101043b000000a003200039000000000013043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000c98011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000701043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000040300003900000c990400004100000005050000290000000606000029309c30920000040f000000010020019000001ba40000613d000000400100043d00000008021000290000000b03000029000000020330036700000c9a04000041000000000404041a000600000004001d000000080000006b000013860000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000013820000c13d000000090000006b000013940000613d000000080330036000000009040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000007011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d0000000202000367000000000101043b0000000301100039000000000101041a000500000001001d000000000001004b000013b00000c13d0000002401200370000000000101043b000000000001004b000018b40000c13d0000004401200370000000000101043b000000000001004b000018150000c13d000000400100043d00000ca3020000410000145e0000013d0000002403100039000000000023043500000c9f02000041000010830000013d00000cb604000041000000000040043f000000020030008c0000000003000019000013ca0000413d00000cb804000041000000400220003900000000030000190000000005320019000000000604041a000000000065043500000001044000390000002003300039000000000013004b000013c30000413d00000020023000390000000001070019000c00000007001d309c20120000040f0000000c01000029000001600010043f00000cb901000041000000000101041a000001800010043f00000cba01000041000000000101041a000001a00010043f0000002001000039000000400400043d000c00000004001d0000000002140436000000a003000039000001200100043d0000000000320435000000c002400039309c1ff50000040f00000000020100190000000c040000290000000001410049000000200310008a0000004004400039000001400100043d0000000000340435309c1ff50000040f00000000020100190000000c040000290000000001410049000000200310008a0000006004400039000001600100043d0000000000340435309c1ff50000040f0000000c040000290000008002400039000001800300043d0000000000320435000000a002400039000001a00300043d0000000000320435000000000141004900000c280040009c00000c2804008041000000400240021000000c280010009c00000c28010080410000006001100210000000000121019f0000309d0001042e00000002010003670000002402100370000000000202043b0000000403200039000000000231034f000000000602043b000000000200003100000000043200490000001f0440008a00000c870540019700000c8707600197000000000857013f000000000057004b000000000700001900000c8707004041000000000046004b000000000900001900000c870900804100000c870080009c000000000709c019000000000007004b00001ba40000c13d0000000007360019000000000671034f000000000606043b00000c6b0060009c00001ba40000213d00000000086200490000002007700039000000000087004b000000000900001900000c870900204100000c870880019700000c8707700197000000000a87013f000000000087004b000000000700001900000c870700404100000c8700a0009c000000000709c019000000000007004b00001ba40000c13d000000010060008c0000165a0000213d000000400100043d00000cc2020000410000145e0000013d0000002404200039000000000034043500000c9f030000410000000000320435000000040220003900000003030000390000000000320435000000400110021000000ca0011001c70000309e000104300000001f0530018f00000c6a06300198000000400200043d0000000004620019000014430000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000143f0000c13d000000000005004b000014500000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f0000000000140435000000600130021000000c280020009c00000c28020080410000004002200210000000000112019f0000309e000104300000002403100039000000000023043500000c9f02000041000010a20000013d000000080000006b0000146e0000c13d000000400100043d00000ce302000041000000000021043500000c280010009c00000c2801008041000000400110021000000c7c011001c70000309e0001043000000c8c01000041000000c00010043f0000002001000039000000c40010043f0000001301000039000000e40010043f00000c8d01000041000001040010043f00000c8e010000410000309e00010430000000400100043d0000000a02100029000000070300002900000002033003670000000a0000006b0000147a0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000014760000c13d0000000b0000006b000014880000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d0000000a0320002900000007040000290000000204400367000000000101043b0000000101100039000000000101041a000400000001001d0000000a0000006b000014a90000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b000014a50000c13d0000000b0000006b000014b70000613d0000000a014003600000000b040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c030000290000000001320019000000000001043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c280030009c00000c28020000410000000002034019000300600020021800000003011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000040300003900000ca80400004100000004060000290000000807000029309c30920000040f000000010020019000001ba40000613d000000400100043d0000000a02100029000000070300002900000002033003670000000a0000006b000014e60000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000014e20000c13d0000000b0000006b000014f40000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b00000001011000390000000802000029000000000021041b00000007010000290000000203100367000000400100043d0000000a021000290000000a0000006b000015150000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000015110000c13d0000000b0000006b000015230000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000cc903000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d0000000a0320002900000007040000290000000204400367000000000101043b000000000101041a000800000001001d0000000a0000006b000015430000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b0000153f0000c13d0000000b0000006b000015510000613d0000000a014003600000000b040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c01200029000000000001043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000003011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000040300003900000cda0400004100000008060000290000000507000029309c30920000040f000000010020019000001ba40000613d00000009010000290000000c02000029309c20e50000040f0000000502000029000000000021041b00000000010000190000309d0001042e00000c7001000041000000000010044300000000010004100000000400100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c71011001c70000800202000039309c30970000040f000000010020019000001f900000613d000000000101043b000000000001004b000016430000c13d0000000801000029000000ff0110018f000000010010008c00000004010000290000000501100270000000000100003f000000010100603f000016460000c13d000000030000006b000004c50000613d000001000100008a000000080110017f00000001011001bf000004c80000013d00000ca501000041000000000012043500000c280020009c00000c2802008041000000400120021000000c7c011001c70000309e000104300000000002000031000000090420006a0000000203000367000000430440008a00000c870640019700000000080000190000000b090000290000000705000029000015ad0000013d0000001f01a0003900000cf501100197000000000a5a001900000000000a04350000000005510019000000200990003900000001088000390000000c0080006c00000d570000813d000000000a93034f000000000a0a043b00000c870ba00197000000000c6b013f00000000006b004b000000000b00001900000c870b00404100000000004a004b000000000d00001900000c870d00804100000c8700c0009c000000000b0dc01900000000000b004b00001ba40000c13d0000000b0ba00029000000000ab3034f000000000a0a043b00000c6b00a0009c00001ba40000213d000000200bb00039000000000ca200490000000000cb004b000000000d00001900000c870d00204100000c870cc0019700000c870eb00197000000000fce013f0000000000ce004b000000000c00001900000c870c00404100000c8700f0009c000000000c0dc01900000000000c004b00001ba40000c13d000000000cb3034f00000cf50da00198000000000bd50019000015d90000613d000000000e0c034f000000000f05001900000000e10e043c000000000f1f04360000000000bf004b000015d50000c13d0000001f0ea00190000015a40000613d0000000001dc034f000000030ce00210000000000d0b0433000000000dcd01cf000000000dcd022f000000000101043b000001000cc000890000000001c1022f0000000001c101cf0000000001d1019f00000000001b0435000015a40000013d00000c280020009c00000c2802008041000000400220021000000c280040009c00000c28040080410000006003400210000000000223019f00000c280010009c00000c2801008041000000c001100210000000000121019f0000000c02000029309c30920000040f000000010220018f0003000000010355000000600110027000010c280010019d00000c2803100197000000000003004b000016160000c13d000700600000003d00000007010000290000000001010433000000000002004b000016820000c13d000000000001004b000016db0000c13d000000400300043d000c00000003001d00000c7501000041000000000013043500000004013000390000002002000039000000000021043500000024023000390000000801000029309c1ff50000040f0000000c02000029000000000121004900000c280010009c00000c280100804100000c280020009c00000c280200804100000060011002100000004002200210000000000121019f0000309e0001043000000c6b0030009c000010c60000213d0000001f0430003900000cf5044001970000003f0440003900000cf504400197000000400500043d0000000004450019000700000005001d000000000054004b0000000005000039000000010500403900000c6b0040009c000010c60000213d0000000100500190000010c60000c13d000000400040043f0000000704000029000000000534043600000cf5043001980000001f0330018f000a00000005001d00000000014500190000000305000367000016350000613d000000000605034f0000000a07000029000000006806043c0000000007870436000000000017004b000016310000c13d000000000003004b000015fc0000613d000000000445034f0000000303300210000000000501043300000000053501cf000000000535022f000000000404043b0000010003300089000000000434022f00000000033401cf000000000353019f0000000000310435000015fc0000013d00000004010000290000000501100270000000000100003f000000400100043d000000640210003900000cd1030000410000000000320435000000440210003900000cd203000041000000000032043500000024021000390000002e03000039000000000032043500000c7502000041000000000021043500000004021000390000002003000039000000000032043500000c280010009c00000c2801008041000000400110021000000c76011001c70000309e000104300000002006300039000000000761034f000000000707043b00000c8708700197000000000958013f000000000058004b000000000500001900000c8705004041000000000047004b000000000400001900000c870400804100000c870090009c000000000504c019000000000005004b00001ba40000c13d0000000004370019000000000341034f000000000303043b00000c6b0030009c00001ba40000213d00000000023200490000002004400039000000000024004b000000000500001900000c870500204100000c870220019700000c8704400197000000000724013f000000000024004b000000000200001900000c870200404100000c870070009c000000000205c019000000000002004b00001ba40000c13d000000400200043d000000000003004b000017960000c13d00000cc101000041000015950000013d000000000001004b000017700000c13d00000c700100004100000000001004430000000c010000290000000400100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c71011001c70000800202000039309c30970000040f000000010020019000001f900000613d000000000101043b000000000001004b0000176c0000c13d000000400100043d000000440210003900000c7903000041000000000032043500000024021000390000001d03000039000000000032043500000c7502000041000000000021043500000004021000390000002003000039000000000032043500000c280010009c00000c2801008041000000400110021000000c7a011001c70000309e000104300000008402100370000000000202043b00000c670020009c00001ba40000213d00040c670020019c000016e40000c13d000000400100043d00000cd7020000410000145e0000013d000000020300036700000000040000190000000001020019000000000563034f000000000505043b000000030050008c00001ba40000213d000000000806001900000000055104360000002006800039000000000663034f000000000606043b00000000006504350000004005800039000000000653034f000000000606043b00000c880060009c00001ba40000213d000000400710003900000000006704350000002005500039000000000653034f000000000606043b00000c880060009c00001ba40000213d000000600710003900000000006704350000002006500039000000000663034f000000000606043b000000800710003900000000006704350000004005500039000000000553034f000000000505043b000000a0061000390000000000560435000000c006800039000000c00110003900000001044000390000000a0040006c000016b10000413d00000d710000013d00000cea01000041000015950000013d0000000a0200002900000c280020009c00000c2802008041000000400220021000000c280010009c00000c28010080410000006001100210000000000121019f0000309e000104300000002402100370000000000202043b00000c670020009c00001ba40000213d00020c670020019c000017dd0000c13d000000400100043d00000cd6020000410000145e0000013d0000000802000029000000050020002a0000014a0000413d000000400100043d0000000a02100029000000070300002900000002033003670000000a0000006b000016fc0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000016f80000c13d0000000b0000006b0000170a0000613d0000000a033003600000000b040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000006011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d0000000a0320002900000007040000290000000204400367000000000101043b0000000301100039000000000101041a000700000001001d0000000a0000006b0000172b0000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b000017270000c13d0000000b0000006b000017390000613d0000000a014003600000000b040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c01200029000000000001043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000003011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000501043b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000040300003900000ce20400004100000007060000290000000507000029309c30920000040f000000010020019000001ba40000613d0000000801000029000b00050010002d00000009010000290000000c02000029309c20810000040f00000003011000390000000502000029000000000021041b00000c9a010000410000000b02000029000000000021041b00000000010000190000309d0001042e00000c280010009c00000c2801008041000000c0011002100000000002000416000000000002004b0000179d0000c13d0000000002040019000017a10000013d00000007010000290000000001010433000000000001004b000017870000613d00000c720010009c0000000a0200002900001ba40000213d000000200010008c00001ba40000413d0000000001020433000000000001004b0000000002000039000000010200c039000000000021004b00001ba40000c13d000000000001004b000017870000c13d000000400100043d000000640210003900000c73030000410000000000320435000000440210003900000c7403000041000000000032043500000024021000390000002a030000390000164f0000013d000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000040300003900000c78040000410000000c050000290000000b060000290000000907000029309c30920000040f000000010020019000001ba40000613d00000ee60000013d0000004003600039000000000131034f000000000101043b000000000001004b000017f10000c13d00000cc001000041000015950000013d00000c77011001c7000080090200003900000000030004160000000005000019309c30920000040f0003000000010355000000600110027000010c280010019d00000c2803100197000000000003004b000017b40000c13d0000006001000039000000010020019000000ee60000c13d000000400400043d000c00000004001d00000c9002000041000000000024043500000004024000390000002003000039000000000032043500000024024000390000160b0000013d00000c6b0030009c000010c60000213d0000001f0130003900000cf5011001970000003f0110003900000cf505100197000000400100043d0000000005510019000000000015004b0000000006000039000000010600403900000c6b0050009c000010c60000213d0000000100600190000010c60000c13d000000400050043f000000000731043600000cf5043001980000001f0530018f00000000034700190000000306000367000017cf0000613d000000000806034f000000008908043c0000000007970436000000000037004b000017cb0000c13d000000000005004b000017a90000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f0000000000430435000017a90000013d0000000401100370000000000101043b00000c670010009c00001ba40000213d00010c670010019b00000c8a01000041000000000201041a00000cbc0220019700000001022001af000000000021041b00000c8b01000041000000000201041a00000cbc0220019700000002022001af000000000021041b0000000b0000006b000018360000c13d000000400100043d00000cd5020000410000145e0000013d00000cac0020009c000010c60000213d000000240120003900000cad030000410000000000310435000000440120003900000000030004140000006004000039000000000041043500000cae010000410000000000120435000000640120003900000000000104350000000401200039000000000001043500000c280020009c00000c2802008041000000400120021000000c280030009c00000c2803008041000000c002300210000000000121019f00000caf011001c70000800602000039309c30920000040f0000000100200190000018b70000613d000000000101043b000000000001004b000018de0000c13d00000003010003670000000102000031000018bb0000013d000000400100043d00000cde020000410000145e0000013d0000008401200370000000000101043b00000c8801100197000000040010006b000018db0000813d00000c9d010000410000000000100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c9e011001c70000800b02000039309c30970000040f000000010020019000001f900000613d000000000101043b00000002020003670000008403200370000000000303043b00000c8803300197000000000013004b000018330000a13d000000a401200370000000000101043b000000000001004b000019ae0000c13d000000400100043d00000ca2020000410000145e0000013d000000400100043d00000ce9020000410000145e0000013d0000000b01000029309c23cf0000040f0000000001000411309c23cf0000040f00000c8f01000041000000000201041a00000cbc0220019700000008022001af000000000021041b00000cd301000041000000000201041a00000cbc0220019700000004022001af000000000021041b00000009010000290000000a0200002900000005030000290000000604000029309c2c440000040f000000400100043d0000002002100039000000020300002900000000003204350000000102000029000000000021043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000200000001001d000000400100043d0000002002100039000000040300002900000000003204350000000802000029000000000021043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000100000001001d000000400300043d00000040013000390000000a02000029000000000021043500000040010000390000000001130436000400000001001d000800000003001d0000000701300029000000600c100039000000000002004b000019310000c13d0000000801c0006a00000004020000290000000000120435000000060100002900000000021c0436000000000001004b000019830000c13d0000000803000029000000000132004900000c280010009c00000c2801008041000000600110021000000c280030009c00000c28030080410000004002300210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000c77011001c70000000b0200002900000c67062001970000800d02000039000000040300003900000cd40400004100000002050000290000000107000029309c30920000040f000000010020019000001ba40000613d000000030000006b00000ee60000c13d0000000203000039000000000103041a00000cf601100197000000000013041b0000000103000039000000400100043d000000000031043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c85011001c70000800d0200003900000cbf0400004100000ee30000013d000000400100043d00000c9b020000410000145e0000013d0003000000010355000000600210027000010c280020019d00000c280220019700000cf5052001980000001f0620018f000000400300043d0000000004530019000018c60000613d000000000701034f0000000008030019000000007907043c0000000008980436000000000048004b000018c20000c13d000000000006004b000018d30000613d000000000151034f0000000305600210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f000000000014043500000c280020009c00000c2802008041000000600120021000000c280030009c00000c28030080410000004002300210000000000112019f0000309e00010430000000400100043d00000c9c020000410000145e0000013d00000002020003670000002403200370000000000503043b0000000404500039000000000342034f000000000703043b00000000030000310000000005530049000000230550008a00000c870650019700000c8708700197000000000968013f000000000068004b000000000800001900000c8708004041000000000057004b000000000a00001900000c870a00804100000c870090009c00000000080ac019000000000008004b00001ba40000c13d0000000008470019000000000782034f000000000707043b00000c6b0070009c00001ba40000213d0000000009730049000000200880003900000c870a90019700000c870b800197000000000cab013f0000000000ab004b000000000a00001900000c870a004041000000000098004b000000000900001900000c870900204100000c8700c0009c000000000a09c01900000000000a004b00001ba40000c13d00000cb009000041000000000a09041a0000000100a001900000000109a002700000007f0990618f0000001f0090008c000000000b000039000000010b002039000000000aba013f0000000100a00190000010db0000c13d000000200090008c000019250000413d00000cb00a0000410000000000a0043f0000001f0a700039000000050aa0027000000cb10aa0009a000000200070008c00000cb20a0040410000001f09900039000000050990027000000cb10990009a00000000009a004b000019250000813d00000000000a041b000000010aa0003900000000009a004b000019210000413d0000001f0070008c00001a7e0000a13d00000cb009000041000000000090043f00000cf50a70019800001a8a0000c13d00000cb209000041000000000b00001900001a940000013d000000400100043d00000cc8020000410000145e0000013d0000000c0100002900070000000000350000000001100079000000020400036700000008020000290000006005200039000000430610008a00000c8708600197000000000a000019000000090b000029000019450000013d0000001f02d0003900000cf50220019700000000031d00190000000000030435000000000c120019000000200bb00039000000010aa000390000000a00a0006c0000187f0000813d0000000801c0006a000000600110008a00000000051504360000000001b4034f000000000201043b00000c8701200197000000000781013f000000000081004b000000000100001900000c8701004041000000000062004b000000000d00001900000c870d00804100000c870070009c00000000010dc019000000000001004b00001ba40000c13d0000000901200029000000000214034f000000000d02043b00000c6b00d0009c00001ba40000213d00000020021000390000000701d00069000000000012004b000000000700001900000c870700204100000c870110019700000c870e200197000000000f1e013f00000000001e004b000000000100001900000c870100404100000c8700f0009c000000000107c019000000000001004b00001ba40000c13d000000000724034f0000000001dc043600000cf502d00198000000000e210019000019750000613d000000000f07034f000000000c01001900000000f30f043c000000000c3c04360000000000ec004b000019710000c13d0000001f0cd001900000193c0000613d000000000227034f0000000303c0021000000000070e043300000000073701cf000000000737022f000000000202043b0000010003300089000000000232022f00000000023201cf000000000272019f00000000002e04350000193c0000013d000000020300036700000000040000190000000505000029000000000153034f000000000101043b000000030010008c00001ba40000213d000000000705001900000000011204360000002005700039000000000553034f000000000505043b00000000005104350000004001700039000000000513034f000000000505043b00000c880050009c00001ba40000213d000000400620003900000000005604350000002005100039000000000153034f000000000101043b00000c880010009c00001ba40000213d000000600620003900000000001604350000002001500039000000000113034f000000000101043b000000800620003900000000001604350000004001500039000000000113034f000000000101043b000000a0052000390000000000150435000000c005700039000000c0022000390000000104400039000000060040006c000019860000413d000018860000013d000000050000006b00001a0b0000c13d000000060010002a0000014a0000413d00000c8203000041000000000203041a00000c6b0020009c000010c60000213d000600060010002d0000000101200039000000000013041b000000000030043f00000ca10120009a0000000a020000290000000c03000029309c21dd0000040f00000002010003670000000b03100360000000400100043d0000000802100029000000080000006b000019ca0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000019c60000c13d000000090000006b000019d80000613d000000080330036000000009040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000007011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d00000002020003670000002403200370000000000303043b000000030030008c000010790000213d000000000101043b000000000401041a00000cf404400197000000000334019f000000000031041b0000004403200370000000000303043b0000000104100039000000000034041b0000008403200370000000000303043b000000800330021000000004033001af0000000204100039000000000034041b0000000301100039000000a403200370000000000303043b000000000031041b00000c9a010000410000000603000029000000000031041b000000c401200370000000000101043b000b00000001001d0000000a010000290000000c02000029309c20e50000040f000017600000013d0000000b03200360000000400100043d0000000802100029000000080000006b00001a160000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00001a120000c13d000000090000006b00001a240000613d000000080330036000000009040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000007011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d00000008032000290000000b040000290000000204400367000000000101043b0000000201100039000000000101041a000300000001001d000000080000006b00001a450000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b00001a410000c13d000000090000006b00001a530000613d000000080140036000000009040000290000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000c0120002900000c9303000041000000000031043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000007011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b0000000201100039000000000101041a000200000001001d000000030100002900000c8801100197000000040010006c00001aec0000c13d0000000201000029000000800210027000000002010003670000008403100370000000000303043b00000c8803300197000000000032004b00001b2a0000c13d0000000502000029000000060220006b0000014a0000413d0000000201000367000000a403100370000000000303043b000000000023001a0000014a0000413d000600000023001d000019bf0000013d000000000007004b000000000900001900001a830000613d000000000882034f000000000908043b000000030870021000000cf70880027f00000cf708800167000000000889016f0000000107700210000000000778019f00001aa10000013d00000cb209000041000000000b000019000000000c8b0019000000000cc2034f000000000c0c043b0000000000c9041b0000000109900039000000200bb000390000000000ab004b00001a8c0000413d00000000007a004b00001a9f0000813d000000030a700210000000f80aa0018f00000cf70aa0027f00000cf70aa0016700000000088b0019000000000882034f000000000808043b0000000008a8016f000000000089041b000000010770021000000001077001bf00000cb008000041000000000078041b0000002007400039000000000872034f000000000808043b00000c8709800197000000000a69013f000000000069004b000000000900001900000c8709004041000000000058004b000000000b00001900000c870b00804100000c8700a0009c00000000090bc019000000000009004b00001ba40000c13d0000000009480019000000000892034f000000000808043b00000c6b0080009c00001ba40000213d000000000a830049000000200990003900000c870ba0019700000c870c900197000000000dbc013f0000000000bc004b000000000b00001900000c870b0040410000000000a9004b000000000a00001900000c870a00204100000c8700d0009c000000000b0ac01900000000000b004b00001ba40000c13d00000cb30a000041000000000b0a041a0000000100b00190000000010ab002700000007f0aa0618f0000001f00a0008c000000000c000039000000010c002039000000000bcb013f0000000100b00190000010db0000c13d0000002000a0008c00001ae30000413d00000cb30b0000410000000000b0043f0000001f0b800039000000050bb0027000000cb40bb0009a000000200080008c00000cb50b0040410000001f0aa00039000000050aa0027000000cb40aa0009a0000000000ab004b00001ae30000813d00000000000b041b000000010bb000390000000000ab004b00001adf0000413d0000001f0080008c00001b5c0000a13d00000cb30a0000410000000000a0043f00000cf50b80019800001b680000c13d00000cb50a000041000000000c00001900001b720000013d000000400100043d00000008021000290000000b030000290000000203300367000000080000006b00001af80000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00001af40000c13d000000090000006b00001b060000613d000000080330036000000009040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000007011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0110018f000000030010008c000010790000213d000000000001004b00001a6c0000613d000000400200043d0000002403200039000000000013043500000c9f0100004100000000001204350000000401200039000000000001043500000c280020009c00000c2802008041000000400120021000000ca0011001c70000309e000104300000000b03100360000000400100043d0000000802100029000000080000006b00001b350000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00001b310000c13d000000090000006b00001b430000613d000000080330036000000009040000290000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000c0210002900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000007011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000ff0110018f000000030010008c000010790000213d000000020010008c00000e010000613d00001a740000013d000000000008004b000000000a00001900001b610000613d000000000992034f000000000a09043b000000030980021000000cf70990027f00000cf70990016700000000099a016f0000000108800210000000000889019f00001b7f0000013d00000cb50a000041000000000c000019000000000d9c0019000000000dd2034f000000000d0d043b0000000000da041b000000010aa00039000000200cc000390000000000bc004b00001b6a0000413d00000000008b004b00001b7d0000813d000000030b800210000000f80bb0018f00000cf70bb0027f00000cf70bb0016700000000099c0019000000000992034f000000000909043b0000000009b9016f00000000009a041b000000010880021000000001088001bf00000cb309000041000000000089041b0000002007700039000000000872034f000000000808043b00000c8709800197000000000a69013f000000000069004b000000000600001900000c8706004041000000000058004b000000000500001900000c870500804100000c8700a0009c000000000605c019000000000006004b00001ba40000c13d0000000005480019000000000452034f000000000404043b00000c6b0040009c00001ba40000213d0000000006430049000000200350003900000c870560019700000c8708300197000000000958013f000000000058004b000000000500001900000c8705004041000000000063004b000000000600001900000c870600204100000c870090009c000000000506c019000000000005004b00001ba60000613d00000000010000190000309e0001043000000cb605000041000000000605041a000000010060019000000001056002700000007f0550618f0000001f0050008c00000000080000390000000108002039000000000686013f0000000100600190000010db0000c13d000000200050008c00001bc30000413d00000cb606000041000000000060043f0000001f06400039000000050660027000000cb70660009a000000200040008c00000cb8060040410000001f05500039000000050550027000000cb70550009a000000000056004b00001bc30000813d000000000006041b0000000106600039000000000056004b00001bbf0000413d0000001f0040008c000000010540021000001d310000a13d00000cb606000041000000000060043f00000cf50840019800001d3c0000c13d00000cb806000041000000000900001900001d460000013d00000ca901000041000000000201041a000000030020002a0000014a0000413d00000cb901000041000000000101041a0000000302200029000000000212004b00001be20000a13d000000400300043d0000002404300039000000000024043500000ccf0200004100000000002304350000000402300039000000000012043500000c280030009c00000c2803008041000000400130021000000ca0011001c70000309e0001043000000002010003670000000602100360000000000302043b00000000020000310000000b0420006a000000230440008a00000c870540019700000c8706300197000000000756013f000000000056004b000000000500001900000c8705004041000000000043004b000000000400001900000c870400804100000c870070009c000000000504c019000000000005004b00001ba40000c13d0000000603300029000000000431034f000000000404043b000c00000004001d00000c6b0040009c00001ba40000213d0000000c0220006a000000200630003900000c870320019700000c8704600197000000000534013f000000000034004b000000000300001900000c8703004041000a00000006001d000000000026004b000000000200001900000c870200204100000c870050009c000000000302c019000000000003004b00001ba40000c13d0000000201100360000000000101043b000900000001001d00000c670010009c00001ba40000213d0000000901000029000000000010043f00000ccb01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d0000000c0300002900000cf5053001980008001f003001930000000a020000290000000204200367000000000201043b000000400100043d000700000005001d000000000351001900001c2d0000613d000000000504034f0000000006010019000000005705043c0000000006760436000000000036004b00001c290000c13d000000080000006b00001c3b0000613d000000070440036000000008050000290000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000c040000290000000003410019000000000023043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950040009c00000c95020000410000000002044019000000600220021000050c96002000a200000005011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000101041a000000000001004b00001f910000c13d0000000901000029000000000010043f00000ccb01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000400200043d00000007032000290000000a040000290000000204400367000000000101043b000000070000006b00001c6f0000613d000000000504034f0000000006020019000000005705043c0000000006760436000000000036004b00001c6b0000c13d000000080000006b00001c7d0000613d000000070440036000000008050000290000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000c03200029000000000013043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000005011001af00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000201041a000000030020002a0000014a0000413d0000000302200029000000000021041b00000002020003670000000601200360000000000101043b00000000030000310000000b0430006a000000230440008a00000c870540019700000c8706100197000000000756013f000000000056004b000000000500001900000c8705004041000000000041004b000000000400001900000c870400804100000c870070009c000000000504c019000000000005004b00001ba40000c13d0000000604100029000000000142034f000000000101043b00000c6b0010009c00001ba40000213d0000000005130049000000200340003900000c870450019700000c8706300197000000000746013f000000000046004b000000000400001900000c8704004041000000000053004b000000000500001900000c870500204100000c870070009c000000000405c019000000000004004b00001ba40000c13d000000000432034f00000cf5051001980000001f0610018f000000400200043d000000000352001900001cc60000613d000000000704034f0000000008020019000000007907043c0000000008980436000000000038004b00001cc20000c13d000000000006004b00001cd30000613d000000000454034f0000000305600210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f0000000000430435000000000312001900000cca04000041000000000043043500000c280020009c00000c2802008041000000400220021000000c950010009c00000c95010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000ccd0110009a0000801002000039309c30970000040f000000010020019000001ba40000613d000000000101043b000000000201041a000000030020002a0000014a0000413d0000000302200029000000000021041b00000ca901000041000000000201041a000000030020002a0000014a0000413d0000000302200029000000000021041b00000cbb01000041000000000101041a00000002020000290000000202200367000000000202043b000a00000002001d00000c670020009c00001ba40000213d00000c670210019700000c70010000410000000000100443000b00000002001d0000000400200443000000000100041400000c280010009c00000c2801008041000000c00110021000000c71011001c70000800202000039309c30970000040f000000010020019000001f900000613d000000000101043b000000000001004b00001ba40000613d000000400300043d00000024013000390000000302000029000000000021043500000cce010000410000000000130435000c00000003001d00000004013000390000000a02000029000000000021043500000000010004140000000b02000029000000040020008c00001d2a0000613d0000000c0200002900000c280020009c00000c2802008041000000400220021000000c280010009c00000c2801008041000000c001100210000000000121019f00000ca0011001c70000000b02000029309c30920000040f000000600310027000010c280030019d0003000000010355000000010020019000001fa40000613d0000000c0100002900000c6b0010009c000010c60000213d0000000c01000029000000400010043f00000000010000190000309d0001042e000000000004004b000000000600001900001d360000613d000000000332034f000000000603043b000000030340021000000cf70330027f00000cf703300167000000000336016f000000000353019f00001d520000013d00000cb8060000410000000009000019000000000a390019000000000aa2034f000000000a0a043b0000000000a6041b00000001066000390000002009900039000000000089004b00001d3e0000413d000000000048004b00001d510000813d0000000304400210000000f80440018f00000cf70440027f00000cf7044001670000000003390019000000000332034f000000000303043b000000000343016f000000000036041b00000001035001bf00000cb604000041000000000034041b0000002003700039000000000332034f000000000303043b00000cb904000041000000000034041b0000004003700039000000000232034f000000000302043b00000cba02000041000b00000003001d000000000032041b00000c670310019700000cbb01000041000000000201041a00000cbc02200197000000000232019f000000000021041b00000c70010000410000000000100443000c00000003001d0000000400300443000000000100041400000c280010009c00000c2801008041000000c00110021000000c71011001c70000800202000039309c30970000040f000000010020019000001f900000613d000000000101043b000000000001004b00001ba40000613d000000400200043d00000cbd010000410000000000120435000a00000002001d00000004012000390000006002000039000000000021043500000002010003670000002402100370000000000402043b0000000403400039000000000231034f000000000602043b00000000020000310000000004420049000000230440008a00000c870540019700000c8707600197000000000857013f000000000057004b000000000700001900000c8707004041000000000046004b000000000900001900000c870900804100000c870080009c000000000709c019000000000007004b00001ba40000c13d0000000007360019000000000671034f000000000606043b00000c6b0060009c00001ba40000213d00000020077000390000000008620049000000000087004b000000000900001900000c870900204100000c870880019700000c870a700197000000000b8a013f00000000008a004b000000000800001900000c870800404100000c8700b0009c000000000809c019000000000008004b00001ba40000c13d0000000a0c0000290000006408c00039000000a00900003900000000009804350000010408c000390000000000680435000000000871034f00000cf50a6001980000001f0b60018f0000012409c000390000000007a9001900001db80000613d000000000c08034f000000000d09001900000000ce0c043c000000000ded043600000000007d004b00001db40000c13d00000000000b004b00001dc50000613d0000000008a8034f000000030ab00210000000000b070433000000000bab01cf000000000bab022f000000000808043b000001000aa000890000000008a8022f0000000008a801cf0000000008b8019f0000000000870435000000000796001900000000000704350000002008300039000000000781034f000000000707043b00000c870a700197000000000b5a013f00000000005a004b000000000a00001900000c870a004041000000000047004b000000000c00001900000c870c00804100000c8700b0009c000000000a0cc01900000000000a004b00001ba40000c13d000000000a3700190000000007a1034f000000000707043b00000c6b0070009c00001ba40000213d000000200aa00039000000000b7200490000000000ba004b000000000c00001900000c870c00204100000c870bb0019700000c870da00197000000000ebd013f0000000000bd004b000000000b00001900000c870b00404100000c8700e0009c000000000b0cc01900000000000b004b00001ba40000c13d0000001f0660003900000cf5066001970000000009960019000000c0066000390000000a0b000029000000840bb0003900000000006b0435000000000aa1034f000000000979043600000cf50b7001980000001f0c70018f0000000006b9001900001dfd0000613d000000000d0a034f000000000e09001900000000df0d043c000000000efe043600000000006e004b00001df90000c13d00000000000c004b00001e0a0000613d000000000aba034f000000030bc00210000000000c060433000000000cbc01cf000000000cbc022f000000000a0a043b000001000bb00089000000000aba022f000000000aba01cf000000000aca019f0000000000a60435000000000697001900000000000604350000002006800039000000000861034f000000000808043b00000c870a800197000000000b5a013f00000000005a004b000000000500001900000c8705004041000000000048004b000000000400001900000c870400804100000c8700b0009c000000000504c019000000000005004b00001ba40000c13d0000000004380019000000000341034f000000000303043b00000c6b0030009c00001ba40000213d00000020044000390000000002320049000000000024004b000000000500001900000c870500204100000c870220019700000c8708400197000000000a28013f000000000028004b000000000200001900000c870200404100000c8700a0009c000000000205c019000000000002004b00001ba40000c13d0000001f0270003900000cf50220019700000000029200190000000a070000290000000005720049000000640550008a000000a4077000390000000000570435000000000541034f000000000232043600000cf5073001980000001f0830018f000000000472001900001e430000613d000000000905034f000000000a020019000000009b09043c000000000aba043600000000004a004b00001e3f0000c13d000000000008004b00001e500000613d000000000575034f0000000307800210000000000804043300000000087801cf000000000878022f000000000505043b0000010007700089000000000575022f00000000057501cf000000000585019f0000000000540435000000000423001900000000000404350000002004600039000000000141034f000000000101043b0000000a06000029000000e4046000390000000b050000290000000000540435000000c404600039000000000014043500000044016000390000000004000410000000000041043500000024016000390000000004000411000000000041043500000000010004140000000c04000029000000040040008c00001e7d0000613d0000001f0330003900000cf5033001970000000a040000290000000002420049000000000232001900000c280020009c00000c2802008041000000600220021000000c280040009c00000c280300004100000000030440190000004003300210000000000232019f00000c280010009c00000c2801008041000000c001100210000000000121019f0000000c02000029309c30920000040f000000600310027000010c280030019d0003000000010355000000010020019000001f970000613d0000000a0100002900000c6b0010009c000010c60000213d0000000a01000029000000400010043f00000002010003670000002402100370000000000402043b0000000403400039000000000231034f000000000602043b00000000020000310000000004420049000000230440008a00000c870540019700000c8707600197000000000857013f000000000057004b000000000700001900000c8707004041000000000046004b000000000900001900000c870900804100000c870080009c000000000709c019000000000007004b00001ba40000c13d0000000006360019000000000761034f000000000707043b00000c6b0070009c00001ba40000213d00000020066000390000000008720049000000000086004b000000000900001900000c870900204100000c870880019700000c870a600197000000000b8a013f00000000008a004b000000000800001900000c870800404100000c8700b0009c000000000809c019000000000008004b00001ba40000c13d000000000861034f00000cf5097001980000001f0a70018f0000000a0690002900001eb70000613d000000000b08034f0000000a0c00002900000000bd0b043c000000000cdc043600000000006c004b00001eb30000c13d00000000000a004b00001ec40000613d000000000898034f0000000309a00210000000000a060433000000000a9a01cf000000000a9a022f000000000808043b0000010009900089000000000898022f00000000089801cf0000000008a8019f00000000008604350000000a0670002900000000000604350000002008300039000000000681034f000000000606043b00000c8709600197000000000a59013f000000000059004b000000000900001900000c8709004041000000000046004b000000000b00001900000c870b00804100000c8700a0009c00000000090bc019000000000009004b00001ba40000c13d0000000009360019000000000691034f000000000606043b00000c6b0060009c00001ba40000213d000000200a900039000000000962004900000000009a004b000000000b00001900000c870b00204100000c870990019700000c870ca00197000000000d9c013f00000000009c004b000000000900001900000c870900404100000c8700d0009c00000000090bc019000000000009004b00001ba40000c13d0000001f0770003900000cf5077001970000000a09700029000000000aa1034f00000cf50b6001980000001f0c60018f0000000007b9001900001ef70000613d000000000d0a034f000000000e09001900000000df0d043c000000000efe043600000000007e004b00001ef30000c13d00000000000c004b00001f040000613d000000000aba034f000000030bc00210000000000c070433000000000cbc01cf000000000cbc022f000000000a0a043b000001000bb00089000000000aba022f000000000aba01cf000000000aca019f0000000000a70435000000000796001900000000000704350000002007800039000000000871034f000000000808043b00000c870a800197000000000b5a013f00000000005a004b000000000500001900000c8705004041000000000048004b000000000400001900000c870400804100000c8700b0009c000000000504c019000000000005004b00001ba40000c13d0000000004380019000000000341034f000000000303043b00000c6b0030009c00001ba40000213d00000020044000390000000002320049000000000024004b000000000500001900000c870500204100000c870220019700000c8708400197000000000a28013f000000000028004b000000000200001900000c870200404100000c8700a0009c000000000205c019000000000002004b00001ba40000c13d0000001f0260003900000cf5022001970000000002920019000000000541034f00000cf5063001980000001f0830018f000000000462001900001f370000613d000000000905034f000000000a020019000000009b09043c000000000aba043600000000004a004b00001f330000c13d000000000008004b00001f440000613d000000000565034f0000000306800210000000000804043300000000086801cf000000000868022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000585019f0000000000540435000000000423001900000000000404350000001f0330003900000cf50330019700000000022300190000002003700039000000000131034f000000000101043b00000020032000390000000b04000029000000000043043500000000001204350000000a030000290000000001320049000000400110003900000c280010009c00000c2801008041000000600110021000000c280030009c00000c28030080410000004002300210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000001ba40000613d000000000601043b000000400100043d000b00000001001d000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d02000039000000030300003900000cbe040000410000000c05000029309c30920000040f000000010020019000001ba40000613d0000000203000039000000000103041a00000cf601100197000000000013041b0000000b01000029000000000031043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c85011001c70000800d02000039000000010300003900000cbf04000041309c30920000040f000000010020019000001ba40000613d000000400100043d0000000c02000029000000000021043500000c280010009c00000c2801008041000000400110021000000c81011001c70000309d0001042e000000000001042f000000400100043d00000ccc0200004100000000002104350000002402100039000000030300002900000e060000013d00000c28033001970000001f0530018f00000c6a06300198000000400200043d0000000004620019000014430000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00001f9f0000c13d000014430000013d00000c28033001970000001f0530018f00000c6a06300198000000400200043d0000000004620019000014430000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00001fac0000c13d000014430000013d0000001f03100039000000000023004b000000000400001900000c870400404100000c870520019700000c8703300197000000000653013f000000000053004b000000000300001900000c870300204100000c870060009c000000000304c019000000000003004b00001fc90000613d0000000203100367000000000303043b00000c6b0030009c00001fc90000213d00000020011000390000000004310019000000000024004b00001fc90000213d0000000002030019000000000001042d00000000010000190000309e0001043000000c720010009c00001fe60000213d000000430010008c00001fe60000a13d00000002020003670000000403200370000000000403043b00000c670040009c00001fe60000213d0000002403200370000000000503043b00000c6b0050009c00001fe60000213d0000002303500039000000000013004b00001fe60000813d0000000403500039000000000232034f000000000302043b00000c6b0030009c00001fe60000213d00000024025000390000000005230019000000000015004b00001fe60000213d0000000001040019000000000001042d00000000010000190000309e00010430000000000003004b00001ff20000613d000000000400001900000000052400190000000006140019000000000606043300000000006504350000002004400039000000000034004b00001feb0000413d00000000012300190000000000010435000000000001042d00000000430104340000000001320436000000000003004b000020010000613d000000000200001900000000051200190000000006240019000000000606043300000000006504350000002002200039000000000032004b00001ffa0000413d000000000213001900000000000204350000001f0230003900000cf5022001970000000001210019000000000001042d00000cf80010009c0000200c0000813d0000004001100039000000400010043f000000000001042d00000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e000104300000001f0220003900000cf5022001970000000001120019000000000021004b0000000002000039000000010200403900000c6b0010009c0000201e0000213d00000001002001900000201e0000c13d000000400010043f000000000001042d00000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e0001043000000c720010009c000020650000213d0000000002010019000000230010008c000020650000a13d00000002040003670000000401400370000000000501043b00000c6b0050009c000020650000213d0000002301500039000000000021004b000020650000813d0000000406500039000000000164034f000000000301043b00000cf90030009c000020670000813d0000001f0130003900000cf5011001970000003f0110003900000cf508100197000000400100043d0000000008810019000000000018004b0000000009000039000000010900403900000c6b0080009c000020670000213d0000000100900190000020670000c13d0000002409500039000000400080043f00000000053104360000000008930019000000000028004b000020650000213d0000002002600039000000000424034f00000cf5063001980000001f0730018f0000000002650019000020550000613d000000000804034f0000000009050019000000008a08043c0000000009a90436000000000029004b000020510000c13d000000000007004b000020620000613d000000000464034f0000000306700210000000000702043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000042043500000000023500190000000000020435000000000001042d00000000010000190000309e0001043000000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e00010430000000400100043d00000cf80010009c0000207b0000813d0000004002100039000000400020043f00000c8a02000041000000000202041a00000c6702200197000000000221043600000c8b03000041000000000303041a00000c67033001970000000000320435000000000001042d00000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e0001043000000cf5042001980000001f0520018f0000000206100367000000400100043d00000000034100190000208d0000613d000000000706034f0000000008010019000000007907043c0000000008980436000000000038004b000020890000c13d000000000005004b0000209a0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f0000000000430435000000000321001900000c9304000041000000000043043500000c280010009c00000c28010080410000004001100210000000200220003900000c280020009c00000c28020080410000006002200210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f0000000100200190000020b10000613d000000000101043b000000000001042d00000000010000190000309e0001043000000cf5042001980000001f0520018f0000000206100367000000400100043d0000000003410019000020bf0000613d000000000706034f0000000008010019000000007907043c0000000008980436000000000038004b000020bb0000c13d000000000005004b000020cc0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f0000000000430435000000000321001900000cca04000041000000000043043500000c280010009c00000c28010080410000004001100210000000200220003900000c280020009c00000c28020080410000006002200210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f0000000100200190000020e30000613d000000000101043b000000000001042d00000000010000190000309e0001043000000cf5042001980000001f0520018f0000000206100367000000400100043d0000000003410019000020f10000613d000000000706034f0000000008010019000000007907043c0000000008980436000000000038004b000020ed0000c13d000000000005004b000020fe0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f0000000000430435000000000321001900000cc904000041000000000043043500000c280010009c00000c28010080410000004001100210000000200220003900000c280020009c00000c28020080410000006002200210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f0000000100200190000021150000613d000000000101043b000000000001042d00000000010000190000309e0001043000000cf5052001980000001f0620018f0000000207100367000000400100043d0000000004510019000021230000613d000000000807034f0000000009010019000000008a08043c0000000009a90436000000000049004b0000211f0000c13d000000000006004b000021300000613d000000000557034f0000000306600210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005404350000000004210019000000000034043500000c280010009c00000c28010080410000004001100210000000200220003900000c280020009c00000c28020080410000006002200210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f0000000100200190000021460000613d000000000101043b000000000001042d00000000010000190000309e0001043000000c6701100197000000000010043f00000ccb01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000021570000613d000000000101043b000000000001042d00000000010000190000309e0001043000000c6701100197000000000010043f00000cfa01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000021680000613d000000000101043b000000000001042d00000000010000190000309e000104300000000204000367000000000224034f000000000202043b000000000300003100000000051300490000001f0550008a00000c870650019700000c8707200197000000000867013f000000000067004b000000000600001900000c8706002041000000000052004b000000000500001900000c870500404100000c870080009c000000000605c019000000000006004b000021920000613d0000000001120019000000000214034f000000000202043b00000c6b0020009c000021920000213d0000000003230049000000200110003900000c870430019700000c8705100197000000000645013f000000000045004b000000000400001900000c8704004041000000000031004b000000000300001900000c870300204100000c870060009c000000000403c019000000000004004b000021920000c13d000000000001042d00000000010000190000309e000104300000000202200367000000000202043b00000000031000790000003f0330008a00000c870430019700000c8705200197000000000645013f000000000045004b000000000400001900000c8704002041000000000032004b000000000300001900000c870300404100000c870060009c000000000403c019000000000004004b000021a70000613d0000000001120019000000000001042d00000000010000190000309e000104300000000202200367000000000202043b00000000031000790000005f0330008a00000c870430019700000c8705200197000000000645013f000000000045004b000000000400001900000c8704002041000000000032004b000000000300001900000c870300404100000c870060009c000000000403c019000000000004004b000021bc0000613d0000000001120019000000000001042d00000000010000190000309e00010430000000000323043600000cf5062001980000001f0720018f00000000056300190000000201100367000021ca0000613d000000000801034f0000000009030019000000008a08043c0000000009a90436000000000059004b000021c60000c13d000000000007004b000021d70000613d000000000161034f0000000306700210000000000705043300000000076701cf000000000767022f000000000101043b0000010006600089000000000161022f00000000016101cf000000000171019f0000000000150435000000000123001900000000000104350000001f0120003900000cf5011001970000000001130019000000000001042d000400000000000200000cf90030009c0000224a0000813d000000000401041a000000010540019000000001064002700000007f0660618f0000001f0060008c00000000040000390000000104002039000000000045004b000022500000c13d000000200060008c000200000001001d000400000003001d000300000002001d0000220c0000413d000100000006001d000000000010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f0000000100200190000022560000613d00000004030000290000001f023000390000000502200270000000200030008c0000000002004019000000000501043b00000001010000290000001f01100039000000050110027000000000041500190000000005250019000000000045004b000000020100002900000003020000290000220c0000813d000000000005041b0000000105500039000000000045004b000022080000413d0000001f0030008c000022370000a13d000000000010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f0000000100200190000022560000613d000000040700002900000cf502700198000000000601043b0000000308000029000022450000613d0000000204000367000000000300001900000002010000290000000005830019000000000554034f000000000505043b000000000056041b00000001066000390000002003300039000000000023004b000022200000413d000000000072004b000022330000813d0000000302700210000000f80220018f00000cf70220027f00000cf70220016700000000038300190000000203300367000000000303043b000000000223016f000000000026041b000000010270021000000001022001bf000000000021041b000000000001042d000000000003004b0000223c0000613d0000000202200367000000000402043b0000223d0000013d0000000004000019000000030230021000000cf70220027f00000cf702200167000000000424016f0000000102300210000000000224019f000000000021041b000000000001042d00000000030000190000000201000029000000000072004b0000222a0000413d000022330000013d00000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e0001043000000cdc01000041000000000010043f0000002201000039000000040010043f00000c69010000410000309e0001043000000000010000190000309e0001043000040000000000020000000001000411000000000010043f00000cfb01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f00000001002001900000226b0000613d000000000101043b000000000101041a000000ff001001900000226d0000613d000000000001042d00000000010000190000309e00010430000000400200043d00000cfc0020009c000022760000413d00000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e000104300000006004200039000000400040043f0000002a01000039000000000112043600000000030000310000000203300367000000000503034f0000000006010019000000005705043c0000000006760436000000000046004b0000227e0000c13d000000000401043300000cfd0440019700000cfe044001c700000000004104350000002104200039000000000504043300000cfd0550019700000cff055001c700000000005404350000002904000039000000000600041100000000050600190000000006020433000000000046004b000022f30000a13d0000000006140019000000000706043300000cfd077001970000000308500210000000780880018f00000d000880021f00000d0108800197000000000787019f00000000007604350000000406500270000000010440008a000000010040008c0000228d0000213d000000400700043d000000100050008c000022f90000813d00000c6d0070009c000022700000213d0000008004700039000000400040043f000000420500003900000000055704360000000008050019000000003603043c0000000005650436000000000045004b000022a80000c13d000000000308043300000cfd0330019700000cfe033001c7000000000038043500000000060700190000002103700039000000000403043300000cfd0440019700000cff044001c7000000000043043500000041030000390000000004060433000000000034004b000022f30000a13d0000000004830019000000000504043300000cfd0550019700000cfe055001c70000000000540435000000010330008a000000010030008c000022b70000213d000000400500043d000400000005001d000000200350003900000d030400004100000000004304350000000003020433000300000003001d0000003702500039000100000006001d000200000008001d309c1fe80000040f00000003020000290000000401200029000000370210003900000d04030000410000000000320435000000480210003900000001010000290000000003010433000100000003001d0000000201000029309c1fe80000040f000000010200002900000003032000290000002802300039000000040100002900000000002104350000004802300039309c20120000040f00000c7501000041000000400300043d000300000003001d000000000013043500000020010000390000000402300039000000000012043500000024023000390000000401000029309c1ff50000040f0000000302000029000000000121004900000c280010009c00000c280100804100000c280020009c00000c280200804100000060011002100000004002200210000000000121019f0000309e0001043000000cdc01000041000000000010043f0000003201000039000000040010043f00000c69010000410000309e00010430000000440170003900000d0202000041000000000021043500000c750100004100000000001704350000002401700039000000200200003900000000002104350000000401700039000000000021043500000c280070009c00000c2807008041000000400170021000000c7a011001c70000309e000104300004000000000002000400000001001d000000000010043f000000200000043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000023270000613d000000000101043b0000000002000411000000000020043f000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000023270000613d000000000101043b000000000101041a000000ff00100190000023290000613d000000000001042d00000000010000190000309e00010430000000400200043d00000cfc0020009c000023320000413d00000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e000104300000006004200039000000400040043f0000002a01000039000000000112043600000000030000310000000203300367000000000503034f0000000006010019000000005705043c0000000006760436000000000046004b0000233a0000c13d000000000401043300000cfd0440019700000cfe044001c700000000004104350000002104200039000000000504043300000cfd0550019700000cff055001c700000000005404350000002904000039000000000600041100000000050600190000000006020433000000000046004b000023b90000a13d0000000006140019000000000706043300000cfd077001970000000308500210000000780880018f00000d000880021f00000d0108800197000000000787019f00000000007604350000000406500270000000010440008a000000010040008c000023490000213d000000100050008c000023bf0000813d000000400400043d000300000004001d00000c6d0040009c0000232c0000213d00000003060000290000008004600039000000400040043f00000042050000390000000005560436000200000005001d000000003603043c0000000005650436000000000045004b000023660000c13d0000000209000029000000000309043300000cfd0330019700000cfe033001c7000000000039043500000003080000290000002103800039000000000403043300000cfd0440019700000cff044001c700000000004304350000004103000039000000040500002900000000040500190000000005080433000000000035004b000023b90000a13d0000000005930019000000000605043300000cfd066001970000000307400210000000780770018f00000d000770021f00000d0107700197000000000667019f00000000006504350000000405400270000000010330008a000000010030008c000023770000213d000000100040008c000023bf0000813d000000400500043d000400000005001d000000200350003900000d030400004100000000004304350000000003020433000100000003001d0000003702500039309c1fe80000040f00000001020000290000000401200029000000370210003900000d04030000410000000000320435000000480210003900000003010000290000000003010433000300000003001d0000000201000029309c1fe80000040f000000030200002900000001032000290000002802300039000000040100002900000000002104350000004802300039309c20120000040f00000c7501000041000000400300043d000300000003001d000000000013043500000020010000390000000402300039000000000012043500000024023000390000000401000029309c1ff50000040f0000000302000029000000000121004900000c280010009c00000c280100804100000c280020009c00000c280200804100000060011002100000004002200210000000000121019f0000309e0001043000000cdc01000041000000000010043f0000003201000039000000040010043f00000c69010000410000309e00010430000000400100043d000000440210003900000d0203000041000000000032043500000c750200004100000000002104350000002402100039000000200300003900000000003204350000000402100039000000000032043500000c280010009c00000c2801008041000000400110021000000c7a011001c70000309e00010430000200000000000200000c6701100197000200000001001d000000000010043f00000cfb01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f00000001002001900000243c0000613d000000000101043b000000000101041a000000ff00100190000024020000c13d0000000201000029000000000010043f00000cfb01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f00000001002001900000243c0000613d000000000101043b000000000201041a00000cf40220019700000001022001bf000000000021041b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d020000390000000403000039000000000700041100000ce80400004100000000050000190000000206000029309c30920000040f00000001002001900000243c0000613d0000000201000029000000000010043f00000d0501000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f00000001002001900000243c0000613d000000000101043b000000000101041a000000000001004b000024140000613d000000000001042d00000d0601000041000000000201041a00000cf90020009c0000243e0000813d000100000002001d0000000102200039000000000021041b000000000010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f00000001002001900000243c0000613d000000000101043b00000001011000290000000202000029000000000021041b00000d0601000041000000000101041a000100000001001d000000000020043f00000d0501000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f00000001002001900000243c0000613d000000000101043b0000000102000029000000000021041b000000000001042d00000000010000190000309e0001043000000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e000104300006000000000002000600000002001d000500000001001d000000000010043f000000200000043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000025120000613d000000000101043b000000060200002900000c6702200197000600000002001d000000000020043f000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000025120000613d000000000101043b000000000101041a000000ff00100190000024900000613d0000000501000029000000000010043f000000200000043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000025120000613d000000000101043b0000000602000029000000000020043f000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000025120000613d000000000101043b000000000201041a00000cf402200197000000000021041b000000000100041400000c280010009c00000c2801008041000000c00110021000000c77011001c70000800d020000390000000403000039000000000700041100000d070400004100000005050000290000000606000029309c30920000040f0000000100200190000025120000613d0000000501000029000000000010043f0000000101000039000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000025120000613d000000000201043b0000000601000029000000000010043f000500000002001d0000000101200039000300000001001d000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000025120000613d0000000503000029000000000101043b000000000101041a000000000001004b000025110000613d000000000203041a000000000002004b000025140000613d000000000012004b000400000001001d000024f10000613d000200000002001d000000000030043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f0000000100200190000025120000613d00000004020000290001000100200092000000000101043b0000000504000029000000000204041a000000010020006c0000251a0000a13d0000000202000029000000010220008a0000000001120019000000000101041a000200000001001d000000000040043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f0000000100200190000025120000613d000000000101043b00000001011000290000000202000029000000000021041b000000000020043f0000000301000029000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000025120000613d000000000101043b0000000402000029000000000021041b0000000503000029000000000103041a000400000001001d000000000001004b000025200000613d000000000030043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f0000000100200190000025120000613d0000000402000029000000010220008a000000000101043b0000000001210019000000000001041b0000000501000029000000000021041b0000000601000029000000000010043f0000000301000029000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000025120000613d000000000101043b000000000001041b000000000001042d00000000010000190000309e0001043000000cdc01000041000000000010043f0000001101000039000000040010043f00000c69010000410000309e0001043000000cdc01000041000000000010043f0000003201000039000000040010043f00000c69010000410000309e0001043000000cdc01000041000000000010043f0000003101000039000000040010043f00000c69010000410000309e000104300010000000000002000000000005004b000028f70000613d000000000a030019000000000301001900000cf507200198000f00000002001d000e001f00200193000d00000003001d0000000203300367000000400100043d001000000007001d00000000027100190000253a0000613d000000000703034f0000000009010019000000007807043c0000000009890436000000000029004b000025360000c13d00080000000a001d000300000005001d000900000006001d000a00000004001d0000000e04000029000000000004004b00000003064002100000254c0000613d0000001003300360000000000402043300000000046401cf000000000464022f000000000303043b0000010005600089000000000353022f00000000035301cf000000000343019f0000000000320435000b00000006001d0000000f04000029000000000241001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f000000200240003900000c280020009c000400000002001d00000c2802008041000c0060002002180000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b0000000301100039000000000101041a000500000001001d000000080100002900000c6701100197000700000001001d000000000010043f00000cfa01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000400200043d00000010032000290000000d040000290000000204400367000000000101043b000000100000006b000025840000613d000000000504034f0000000006020019000000005705043c0000000006760436000000000036004b000025800000c13d0000000e0000006b000025910000613d000000100440036000000000050304330000000b0600002900000000056501cf000000000565022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000454019f00000000004304350000000f03200029000000000013043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000201041a0000000a04000029000000000042001a000029970000413d000000030500002900060000105400e10000000002420019000000090020006c000025ad0000613d000000000001004b000028fd0000c13d00000c9a01000041000000000101041a000800000001001d0000000701000029000000000010043f00000cfa01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000400200043d00000010032000290000000d040000290000000204400367000000000101043b000000100000006b000025ca0000613d000000000504034f0000000006020019000000005705043c0000000006760436000000000036004b000025c60000c13d0000000e0000006b000025d70000613d000000100440036000000000050304330000000b0600002900000000056501cf000000000565022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000454019f00000000004304350000000f03200029000000000013043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000101041a0000000a02000029000000000021001a000029970000413d00000000012100190000000904000029000000000141004b000029070000213d00000c9101000041000000000101041a000000000021001a000029970000413d00000000012100190000000804000029000000000141004b0000000f030000290000290c0000213d00000cf90030009c000028ea0000813d0000001f0130003900000cf5011001970000003f0110003900020cf50010019b000000400200043d0000000201200029000900000002001d000000000021004b0000000002000039000000010200403900000c6b0010009c000028ea0000213d0000000100200190000028ea0000c13d000000400010043f00000009010000290000000001310436000800000001001d0000000d01300029000100000001001d000000000010007c000028e80000213d0000000d01000029000000020210036700000008060000290000001001600029000000100000006b0000261d0000613d000000000302034f0000000004060019000000003503043c0000000004540436000000000014004b000026190000c13d0000000e0000006b0000000b040000290000262a0000613d0000001002200360000000000301043300000000034301cf000000000343022f000000000202043b0000010004400089000000000242022f00000000024201cf000000000232019f0000000000210435000000090300002900000004013000290000000000010435000000400200043d0000000001030433000000000001004b000026390000613d000000000300001900000000042300190000000005630019000000000505043300000000005404350000002003300039000000000013004b000026320000413d000000000321001900000c9304000041000000000043043500000c280020009c00000c28020080410000004002200210000000200110003900000c280010009c00000c28010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b0000000201100039000000000101041a000300000001001d00000c9d010000410000000000100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c9e011001c70000800b02000039309c30970000040f0000000100200190000028f60000613d000000400200043d000000000301043b00000003010000290000008001100270000000000013004b000029140000813d000300000003001d00000009010000290000000001010433000000000001004b0000000806000029000026710000613d000000000300001900000000042300190000000005630019000000000505043300000000005404350000002003300039000000000013004b0000266a0000413d000000000321001900000c9304000041000000000043043500000c280020009c00000c28020080410000004002200210000000200110003900000c280010009c00000c28010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000400200043d00000c920020009c0000000806000029000028ea0000213d000000a003200039000000400030043f000000000301041a000000ff0830018f000000040080008c0000000307000029000028f00000813d00000000038204360000000104100039000000000404041a00000000004304350000000203100039000000000403041a00000060052000390000008003400270000000000035043500000c88044001970000004005200039000000000045043500000080022000390000000301100039000000000101041a000000000012043500000c7e01000041000000000201041a000000ff0120018f000000000008004b000026dc0000c13d000000000047004b000026dc0000413d000000000037004b000029240000813d000000030010008c000028f00000213d000000000001004b000026b30000c13d00000cf40120019700000001011001bf00000c7e02000041000000000012041b000000400200043d00000009010000290000000001010433000000000001004b000026c00000613d000000000300001900000000042300190000000005630019000000000505043300000000005404350000002003300039000000000013004b000026b90000413d000000000321001900000c9304000041000000000043043500000c280020009c00000c28020080410000004002200210000000200110003900000c280010009c00000c28010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000201041a00000cf40220019700000001022001bf000000000021041b0000000d03000029000026e30000013d000000010080008c000029240000c13d000000040010008c000028f00000813d000000010010008c0000000d030000290000296e0000c13d000000400100043d00000010021000290000000203300367000000100000006b000026ee0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000026ea0000c13d0000000e0000006b000026fb0000613d000000100330036000000000040204330000000b0500002900000000045401cf000000000454022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000343019f00000000003204350000000f0210002900000c8003000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000101041a0000000a02000029000000000021001a000029970000413d0000000001210019000000400700043d000000050110006c0000000f020000290000293c0000213d00000010017000290000000d040000290000000206400367000000100000006b000027210000613d000000000306034f0000000004070019000000003503043c0000000004540436000000000014004b0000271d0000c13d0000000e0000006b0000272e0000613d000000100460036000000000030104330000000b0600002900000000036301cf000000000363022f000000000504043b0000010004600089000000000545022f00000000044501cf000000000334019f0000000000310435000000000127001900000cc902000041000000000021043500000c280070009c00000c28070080410000004001700210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000400200043d00000010032000290000000d040000290000000204400367000000000101043b000000000101041a000900000001001d000000100000006b0000274e0000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b0000274a0000c13d0000000e0000006b0000275b0000613d000000100140036000000000040304330000000b0500002900000000045401cf000000000454022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000141019f00000000001304350000000f0120002900000cca03000041000000000031043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000101041a0000000603000029000000000031001a0000000a040000290000000905000029000029970000413d0000000001310019000000000151004b000029560000213d00000ca901000041000000000201041a000000000032001a000029970000413d00000cb901000041000000000101041a0000000002320019000000000212004b000029620000213d00000c9101000041000000000201041a000000000042001a000029970000413d0000000002420019000000000021041b0000000d010000290000000203100367000000400100043d0000001002100029000000100000006b000027910000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b0000278d0000c13d0000000e0000006b0000279e0000613d000000100330036000000000040204330000000b0500002900000000045401cf000000000454022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000343019f00000000003204350000000f0210002900000c8003000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000201041a0000000a03000029000000000032001a000029970000413d0000000002320019000000000021041b0000000701000029000000000010043f00000cfa01000041000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000400200043d00000010032000290000000d040000290000000204400367000000000101043b000000100000006b000027d00000613d000000000504034f0000000006020019000000005705043c0000000006760436000000000036004b000027cc0000c13d0000000e0000006b000027dd0000613d000000100440036000000000050304330000000b0600002900000000056501cf000000000565022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000454019f00000000004304350000000f03200029000000000013043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000201041a0000000a03000029000000000032001a000029970000413d0000000002320019000000000021041b00000c9a01000041000000000101041a00000c9102000041000000000202041a000000000012004b000027ff0000c13d00000c7e01000041000000000201041a00000cf40220019700000002022001bf000000000021041b000000400100043d00000010021000290000000d030000290000000203300367000000100000006b0000280b0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000028070000c13d0000000e0000006b000028180000613d000000100330036000000000040204330000000b0500002900000000045401cf000000000454022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000343019f00000000003204350000000f0210002900000c8003000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000101041a000000050010006c0000287c0000c13d000000400200043d0000000201200029000000000021004b0000000003000039000000010300403900000c6b0010009c0000000f04000029000028ea0000213d0000000100300190000028ea0000c13d000000400010043f00000000014204360000000104000029000000000040007c000028e80000213d0000000d0300002900000002043003670000001003100029000000100000006b000028470000613d000000000504034f0000000006010019000000005705043c0000000006760436000000000036004b000028430000c13d0000000e0000006b000028540000613d000000100440036000000000050304330000000b0600002900000000056501cf000000000565022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000454019f000000000043043500000004032000290000000000030435000000400300043d0000000002020433000000000002004b000028620000613d000000000400001900000000053400190000000006140019000000000606043300000000006504350000002004400039000000000024004b0000285b0000413d000000000132001900000c9304000041000000000041043500000c280030009c00000c28030080410000004001300210000000200220003900000c280020009c00000c28020080410000006002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000201041a00000cf40220019700000002022001bf000000000021041b000000400100043d00000010021000290000000d030000290000000203300367000000100000006b000028880000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b000028840000c13d0000000e0000006b000028950000613d000000100330036000000000040204330000000b0500002900000000045401cf000000000454022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000343019f00000000003204350000000f0210002900000cca03000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000c011001af00000c77011001c70000801002000039309c30970000040f0000000100200190000028e80000613d000000000101043b000000000201041a0000000603000029000000000032001a000029970000413d0000000002320019000000000021041b00000ca901000041000000000201041a000000000032001a000029970000413d0000000002320019000000000021041b00000cbb01000041000000000101041a00000c7002000041000000000020044300000c6701100197001000000001001d0000000400100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c71011001c70000800202000039309c30970000040f0000000100200190000028f60000613d000000000101043b000000000001004b000028e80000613d000000400400043d00000024014000390000000602000029000000000021043500000cce01000041000000000014043500000004014000390000000702000029000000000021043500000000010004140000001002000029000000040020008c000028e40000613d00000c280040009c00000c28030000410000000003044019000000400330021000000c280010009c00000c2801008041000000c001100210000000000131019f00000ca0011001c7001000000004001d309c30920000040f0000001004000029000000600310027000010c280030019d00030000000103550000000100200190000029780000613d00000c6b0040009c000028ea0000213d000000400040043f000000000001042d00000000010000190000309e0001043000000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e0001043000000cdc01000041000000000010043f0000002101000039000000040010043f00000c69010000410000309e00010430000000000001042f00000cdc01000041000000000010043f0000001201000039000000040010043f00000c69010000410000309e00010430000000400100043d00000d080200004100000000002104350000000402100039000000000052043500000c280010009c00000c2801008041000000400110021000000c69011001c70000309e00010430000000400200043d0000002403200039000000000013043500000ccc01000041000029100000013d000000400200043d0000002403200039000000000013043500000d0d010000410000000000120435000000040120003900000000004104350000295d0000013d000000440120003900000d0903000041000000000031043500000024012000390000000c03000039000000000031043500000c7501000041000000000012043500000004012000390000002003000039000000000031043500000c280020009c00000c2802008041000000400120021000000c7a011001c70000309e00010430000000400300043d001000000003001d00000d0a01000041000000000013043500000004013000390000004002000039000000000021043500000044023000390000000901000029000f00000008001d309c1ff50000040f000000100300002900000024023000390000000f040000290000000000420435000000000131004900000c280010009c00000c280100804100000c280030009c00000c280300804100000060011002100000004002300210000000000121019f0000309e00010430001000000001001d00000d0c01000041000000000017043500000004017000390000006003000039000000000031043500000064037000390000000d01000029000f00000007001d309c21be0000040f0000000f04000029000000440240003900000010030000290000000000320435000000240240003900000005030000290000000000320435000000000141004900000c280010009c00000c280100804100000c280040009c00000c280400804100000060011002100000004002400210000000000121019f0000309e00010430000000400200043d0000002403200039000000000013043500000cd00100004100000000001204350000000401200039000000000051043500000c280020009c00000c2802008041000000400120021000000ca0011001c70000309e00010430000000400300043d0000002404300039000000000024043500000ccf0200004100000000002304350000000402300039000000000012043500000c280030009c00000c2803008041000000400130021000000ca0011001c70000309e00010430000000400200043d00000d0b0300004100000000003204350000000403200039000000000013043500000c280020009c00000c2802008041000000400120021000000c69011001c70000309e0001043000000c28033001970000001f0530018f00000c6a06300198000000400200043d0000000004620019000029840000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000029800000c13d000000000005004b000029910000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f0000000000140435000000600130021000000c280020009c00000c28020080410000004002200210000000000112019f0000309e0001043000000cdc01000041000000000010043f0000001101000039000000040010043f00000c69010000410000309e000104300009000000000002000000400800043d00000cf80080009c00002a800000813d0000004007800039000000400070043f000000200780003900000000000704350000000000080435000000400900043d00000d0e0090009c00002a800000213d0000006007900039000000400070043f00000c920090009c00002a800000213d000000a008900039000000400080043f0000000000070435000000000779043600000040089000390000000000080435000000000007043500000080079000390000000000070435000000400800043d00000d0f0080009c00002a800000213d0000004007800039000000400070043f000000200780003900000000000704350000000000080435000000400800043d00000d0f0080009c00002a800000213d0000004007800039000000400070043f0000002007800039000000000057043500000c67044001970000000000480435000000400c00043d00000d0e00c0009c00002a800000213d0000006004c00039000000400040043f000000000b8c04360000004004600039000000020a00036700000000044a034f000000000404043b00000000004b0435000000200460003900000000044a034f000000400dc00039000000000404043b00000000004d0435000000400e00043d00000d0f00e0009c00002a800000213d0000004004e00039000000400040043f00000c6703300197000000000f3e043600000000005f043500000000046a034f000000000300003100000000056300490000001f0550008a000000000404043b00000c870740019700000c8708500197000000000987013f000000000087004b000000000700001900000c8707002041000000000054004b000000000500001900000c870500404100000c870090009c000000000705c019000000000007004b00002a860000613d000000000464001900000000054a034f000000000705043b00000c6b0070009c00002a860000213d0000000006730049000000200840003900000c870360019700000c8704800197000000000534013f000000000034004b000000000300001900000c8703004041000200000008001d000000000068004b000000000400001900000c870400204100000c870050009c000000000304c019000000000003004b00002a860000c13d00030000000f001d00040000000e001d00050000000d001d00060000000c001d00070000000b001d000800000007001d000900000002001d00000c670210019700000c70010000410000000000100443000100000002001d0000000400200443000000000100041400000c280010009c00000c2801008041000000c00110021000000c71011001c70000800202000039309c30970000040f000000010020019000002a880000613d000000000101043b000000000001004b0000000904000029000000080a0000290000000705000029000000060200002900000005060000290000000407000029000000030800002900002a860000613d000000400b00043d00000d100100004100000000001b04350000000001020433000000002101043400000c67011001970000000403b00039000000000013043500000000010204330000002402b00039000000000012043500000000010504330000004402b00039000000000012043500000000010604330000006402b000390000000000120435000000000107043300000c67011001970000008402b0003900000000001204350000000001080433000000e402b000390000010003000039000000000032043500000c6702400197000000c403b000390000000000230435000000a402b0003900000000001204350000010401b000390000000000a1043500000cf504a001980000001f05a0018f0000012402b0003900000000034200190000000206000029000000020660036700002a520000613d000000000706034f0000000008020019000000007907043c0000000008980436000000000038004b00002a4e0000c13d000000000005004b00002a5f0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000002a20019000000000002043500000000040004140000000102000029000000040020008c00002a7c0000613d0000001f03a0003900000cf50130019700000d110010009c00000d1101008041000000600110021000000c2800b0009c00000c280300004100000000030b40190000004003300210000000000131019f00000c280040009c00000c2804008041000000c003400210000000000131019f00000d120110009a00090000000b001d309c30920000040f000000090b000029000000600310027000010c280030019d0003000000010355000000010020019000002a890000613d00000c6b00b0009c00002a800000213d0000004000b0043f000000000001042d00000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e0001043000000000010000190000309e00010430000000000001042f00000c28033001970000001f0530018f00000c6a06300198000000400200043d000000000462001900002a950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00002a910000c13d000000000005004b00002aa20000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f0000000000140435000000600130021000000c280020009c00000c28020080410000004002200210000000000112019f0000309e000104300006000000000002000600000003001d000300000002001d0000000209000367000000000219034f000000000202043b000000000300003100000000041300490000003f0440008a00000c870540019700000c8706200197000000000756013f000000000056004b000000000500001900000c8705002041000000000042004b000000000400001900000c870400404100000c870070009c000000000504c019000000000005004b00002c330000613d0000000002120019000000000429034f000000000404043b00000000052300490000005f0550008a00000c870650019700000c8707400197000000000867013f000000000067004b000000000600001900000c8706004041000000000054004b000000000500001900000c870500804100000c870080009c000000000605c019000000000006004b00002c330000c13d0000000002240019000000000429034f000000000404043b00000000052300490000001f0550008a00000c870650019700000c8707400197000000000867013f000000000067004b000000000600001900000c8706004041000000000054004b000000000500001900000c870500804100000c870080009c000000000605c019000000000006004b00002c330000c13d0000000004240019000000000249034f000000000202043b00000c6b0020009c00002c330000213d0000000005230049000000200340003900000c870450019700000c8706300197000000000746013f000000000046004b000000000400001900000c8704004041000000000053004b000000000500001900000c870500204100000c870070009c000000000405c019000000000004004b00002c330000c13d000000000439034f00000cf5052001980000001f0620018f000000400a00043d00000000035a001900002b020000613d000000000704034f00000000080a0019000000007907043c0000000008980436000000000038004b00002afe0000c13d000500000001001d000000000006004b00002b100000613d000000000454034f0000000305600210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f000000000043043500000000032a001900000c9304000041000000000043043500000c2800a0009c00000c280a0080410000004001a0021000000c950020009c00000c95020080410000006002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000121019f00000ccd0110009a0000801002000039309c30970000040f000000010020019000002c330000613d000000000101043b0000000101100039000000000101041a000100000001001d000000400100043d000400000001001d00000020021000390000000001000410000200000002001d000000000012043500000cc6010000410000000000100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c9e011001c70000800b02000039309c30970000040f000000010020019000002c3b0000613d000000000101043b000000040e0000290000006002e00039000000600400003900000000004204350000004002e0003900000000001204350000000201000367000000050d0000290000000002d1034f000000000202043b00000000060000310000000003d600490000003f0330008a00000c870530019700000c8707200197000000000857013f000000000057004b000000000500001900000c8705004041000000000032004b000000000300001900000c870300804100000c870080009c000000000503c019000000000005004b00002c330000c13d0000008005e00039000000400300003900000000003504350000000002d20019000000000521034f000000000505043b00000000072600490000005f0770008a00000c870870019700000c8709500197000000000a89013f000000000089004b000000000800001900000c8708004041000000000075004b000000000700001900000c870700804100000c8700a0009c000000000807c019000000000008004b00002c330000c13d000000c007e0003900000000003704350000000003250019000000000531034f000000000505043b00000000073600490000001f0770008a00000c870870019700000c8709500197000000000a89013f000000000089004b000000000800001900000c8708004041000000000075004b000000000700001900000c870700804100000c8700a0009c000000000807c019000000000008004b00002c330000c13d0000000007350019000000000571034f000000000505043b00000c6b0050009c00002c330000213d00000020077000390000000006560049000000000067004b000000000800001900000c870800204100000c870660019700000c8709700197000000000a69013f000000000069004b000000000600001900000c870600404100000c8700a0009c000000000608c019000000000006004b00002c330000c13d0000010006e0003900000000004604350000016004e000390000000000540435000000000771034f00000cf5085001980000001f0950018f0000018004e00039000000000684001900002ba10000613d000000000a07034f000000000b04001900000000ac0a043c000000000bcb043600000000006b004b00002b9d0000c13d000000000009004b00002bae0000613d000000000787034f0000000308900210000000000906043300000000098901cf000000000989022f000000000707043b0000010008800089000000000787022f00000000078701cf000000000797019f0000000000760435000000000445001900000000000404350000002004300039000000000441034f000000000404043b0000012006e0003900000000004604350000004003300039000000000331034f000000000303043b0000014004e0003900000000003404350000002002200039000000000221034f000000000202043b00000c670020009c00002c330000213d000000e003e0003900000000002304350000002002d00039000000000121034f000000000101043b000000a002e0003900000000001204350000001f0150003900000cf501100197000001600210003900000000002e04350000019f0110003900000cf5021001970000000001e20019000000000021004b0000000002000039000000010200403900000c6b0010009c00002c350000213d000000010020019000002c350000c13d000000400010043f000000020100002900000c280010009c00000c2801008041000000400110021000000000020e043300000c280020009c00000c28020080410000006002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000002c330000613d0000000003000031000000000101043b000000060200002900000c6b0020009c00002c350000213d000000060200002900000005022002100000003f0420003900000c8304400197000000400500043d0000000004450019000500000005001d000000000054004b0000000005000039000000010500403900000c6b0040009c00002c350000213d000000010050019000002c350000c13d000000400040043f000000060400002900000005050000290000000004450436000400000004001d0000000302200029000000000032004b00002c330000213d0000000306000029000000000062004b00002c110000a13d000000020360036700000005040000290000002004400039000000003503043c00000000005404350000002006600039000000000026004b00002c080000413d00000005020000290000000002020433000600000002001d000000060000006b00002c300000613d0000000003000019000600000003001d000000050230021000000004022000290000000002020433000000000021004b00002c1e0000813d000000000010043f000000200020043f000000000100041400002c210000013d000000000020043f000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f000000010020019000002c330000613d0000000603000029000000000101043b000000010330003900000005020000290000000002020433000000000023004b00002c140000413d000000010010006c00002c3c0000c13d000000000001042d00000000010000190000309e0001043000000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e00010430000000000001042f000000400100043d00000cc802000041000000000021043500000c280010009c00000c2801008041000000400110021000000c7c011001c70000309e000104300012000000000002000300000003001d000700000001001d000000000042004b00002f1f0000c13d000000000002004b00002ed60000613d0000000001000019000200000002001d000c00000001001d000000050110021000000007021000290000000201000367000000000221034f000000000302043b0000000002000031000000070420006a0000001f0440008a00000c870540019700000c8706300197000000000756013f000000000056004b000000000500001900000c8705002041000000000043004b000000000400001900000c870400404100000c870070009c000000000504c019000000000005004b00002ed70000613d0000000703300029000000000431034f000000000704043b00000c6b0070009c00002ed70000213d0000000002720049000000200630003900000c870320019700000c8704600197000000000534013f000000000034004b000000000300001900000c8703004041001200000006001d000000000026004b000000000200001900000c870200204100000c870050009c000000000302c019000000000003004b00002ed70000c13d000000120310036000000cf50870019800000c9a01000041000000000101041a000600000001001d000000400100043d000000000281001900002c860000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00002c820000c13d0000001f0670019000002c930000613d000000000383034f0000000304600210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000f00000006001d000000000271001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c950070009c00000c95020000410000000002074019000000600220021000090c96002000a200000009011001af00000c77011001c70000801002000039001100000007001d001000000008001d309c30970000040f000000010020019000002ed70000613d0000000c02000029000000c0022000c900000003032000290000000202000367000000000101043b0000000301100039000000000101041a000e00000001001d000000000001004b00002cbc0000c13d000000000132034f000000000101043b000000030010008c00002ed70000213d000000000001004b00002ef20000c13d000b00000003001d0000002001300039000000000312034f000000000303043b000500000003001d000000000003004b00002ed90000613d0000002003100039000000000132034f000000000101043b00000c880010009c00002ed70000213d0000002003300039000000000232034f000000000202043b00000c880020009c00002ed70000213d000d00000003001d000000000021004b00002edc0000813d00000c9d010000410000000000100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c9e011001c70000800b02000039309c30970000040f000000010020019000002edf0000613d00000002020003670000000d04000029000000000342034f000000000303043b00000c880030009c0000001107000029000000100800002900002ed70000213d000000000101043b000000000013004b00002ee00000a13d0000002001400039000000000112034f000000000101043b000a00000001001d000000000001004b00000c8203000041000000120500002900002ee30000613d0000000b0100002900000040011000390000000e0000006b000800000001001d000d00200010003d00002dd30000613d000000000352034f000000400100043d0000000002810019000000000008004b00002cff0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00002cfb0000c13d0000000f04000029000000000004004b00002d0d0000613d000000000383034f0000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000000000271001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000009011001af00000c77011001c70000801002000039309c30970000040f00000010080000290000001107000029000000010020019000002ed70000613d000000400200043d000000000382001900000012040000290000000204400367000000000101043b0000000201100039000000000101041a000400000001001d000000000008004b00002d300000613d000000000104034f0000000005020019000000001601043c0000000005650436000000000035004b00002d2c0000c13d0000000f05000029000000000005004b00002d3e0000613d000000000184034f0000000304500210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000000000172001900000c9303000041000000000031043500000c280020009c00000c28020080410000004001200210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000009011001af00000c77011001c70000801002000039309c30970000040f00000010080000290000001107000029000000010020019000002ed70000613d00000002020003670000000803200360000000000101043b0000000201100039000000000401041a000000000103043b00000c880010009c00002ed70000213d0000000d03200360000000000603043b00000c880060009c00002ed70000213d000000040300002900000c8803300197000000000013004b000000120500002900002d9a0000613d000100000006001d000400000004001d000000000352034f000000400100043d0000000002810019000000000008004b00002d6f0000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00002d6b0000c13d0000000f04000029000000000004004b00002d7d0000613d000000000383034f0000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000000000271001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000009011001af00000c77011001c70000801002000039309c30970000040f0000001008000029000000110700002900000001002001900000000404000029000000010600002900002ed70000613d000000000101043b000000000101041a000000ff0110018f000000040010008c00002eec0000813d000000000001004b000000120500002900002f060000c13d0000008001400270000000000061004b00000c820300004100002dd30000613d000000400100043d00000000028100190000000203500367000000000008004b00002da90000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00002da50000c13d0000000f04000029000000000004004b00002db70000613d000000000383034f0000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000000000271001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000009011001af00000c77011001c70000801002000039309c30970000040f00000010080000290000001107000029000000010020019000002ed70000613d000000000101043b000000000101041a000000ff0110018f000000030010008c00002eec0000213d000000020010008c00000c8203000041000000120500002900002f120000613d0000000e02000029000000060220006b00002ee60000413d0000000a0020002a00002ee60000413d000900000002001d0000000e0000006b00002e460000c13d000000000103041a00000c6b0010009c00002efa0000213d0000000102100039000000000023041b000000000030043f00000ca10410009a000000000104041a000000010210019000000001031002700000007f0330618f0000001f0030008c00000000010000390000000101002039000000000012004b00002f000000c13d000000200030008c000e00000004001d00002e0d0000413d000600000003001d000000000040043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f00000010080000290000001107000029000000010020019000002ed70000613d0000001f027000390000000502200270000000200070008c0000000002004019000000000301043b00000006010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b00000012050000290000000e0400002900002e0d0000813d000000000002041b0000000102200039000000000012004b00002e090000413d0000001f0070008c00002e390000a13d000000000040043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f00000010080000290000001107000029000000010020019000002ed70000613d000000000101043b000000000008004b00002ed00000613d0000000203000367000000000200001900000012050000290000000e060000290000000004520019000000000443034f000000000404043b000000000041041b00000001011000390000002002200039000000000082004b00002e220000413d000000000078004b00002e350000813d0000000303700210000000f80330018f00000cf70330027f00000cf70330016700000000025200190000000202200367000000000202043b000000000232016f000000000021041b000000010170021000000001011001bf000000000016041b00002e460000013d000000000007004b00002e3e0000613d0000000201500367000000000101043b00002e3f0000013d0000000001000019000000030270021000000cf70220027f00000cf702200167000000000121016f0000000102700210000000000121019f000000000014041b000000400100043d00000000028100190000000203500367000000000008004b00002e510000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00002e4d0000c13d0000000f04000029000000000004004b00002e5f0000613d000000000383034f0000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000000000271001900000c9303000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f000000200270003900000c280020009c00000c2802008041000e0060002002180000000e011001af00000c77011001c70000801002000039309c30970000040f00000010080000290000001107000029000000010020019000002ed70000613d00000002020003670000000b03200360000000000101043b000000000303043b000000030030008c00002ed70000213d000000000401041a00000cf404400197000000000334019f000000000031041b00000001031000390000000504000029000000000043041b0000000803200360000000000303043b00000c880030009c00002ed70000213d0000000204100039000000000504041a00000ca705500197000000000535019f000000000054041b0000000d05200360000000000505043b00000c880050009c00002ed70000213d0000000a0900002900000009069000290000008005500210000000000335019f000000000034041b0000000301100039000000000091041b00000c9a01000041000000000061041b00000012032003600000000d010000290000004001100039000000000112034f000000000101043b001200000001001d000000400100043d0000000002810019000000000008004b00002ea90000613d000000000403034f0000000005010019000000004604043c0000000005650436000000000025004b00002ea50000c13d0000000f04000029000000000004004b00002eb70000613d000000000383034f0000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000000000271001900000cc903000041000000000032043500000c280010009c00000c28010080410000004001100210000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f0000000e011001af00000c77011001c70000801002000039309c30970000040f000000010020019000002ed70000613d000000000101043b0000001202000029000000000021041b0000000c010000290000000101100039000000020010006c00002c4d0000413d00002ed60000013d000000000200001900000012050000290000000e06000029000000000078004b00002e2c0000413d00002e350000013d000000000001042d00000000010000190000309e00010430000000400100043d00000ca30200004100002ef40000013d000000400100043d00000c9c0200004100002ef40000013d000000000001042f000000400100043d00000ce90200004100002ef40000013d000000400100043d00000ca20200004100002ef40000013d00000cdc01000041000000000010043f0000001101000039000000040010043f00000c69010000410000309e0001043000000cdc01000041000000000010043f0000002101000039000000040010043f00000c69010000410000309e00010430000000400100043d00000c9b02000041000000000021043500000c280010009c00000c2801008041000000400110021000000c7c011001c70000309e0001043000000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e0001043000000cdc01000041000000000010043f0000002201000039000000040010043f00000c69010000410000309e00010430000000400200043d0000002403200039000000000013043500000c9f0100004100000000001204350000000401200039000000000001043500000c280020009c00000c2802008041000000400120021000000ca0011001c70000309e00010430000000400100043d00000cec0200004100000000002104350000002402100039000000020300003900000000003204350000000402100039000000000032043500000c280010009c00000c2801008041000000400110021000000ca0011001c70000309e00010430000000400100043d00000d130200004100002ef40000013d0003000000000002000000400700043d0000002006100039000200000001001d0000000002010433000000000002004b00002f310000613d000000000300001900000000047300190000000005630019000000000505043300000000005404350000002003300039000000000023004b00002f2a0000413d000300000006001d000000000372001900000c9304000041000000000043043500000c280070009c00000c28070080410000004001700210000000200220003900000c280020009c00000c28020080410000006002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000002fdb0000613d000000000101043b0000000201100039000000000101041a000100000001001d00000c9d010000410000000000100443000000000100041400000c280010009c00000c2801008041000000c00110021000000c9e011001c70000800b02000039309c30970000040f000000010020019000002fe30000613d000000400200043d000000000301043b00000001010000290000008001100270000100000003001d000000000013004b000000030600002900002fe40000813d00000002010000290000000001010433000000000001004b00002f6a0000613d000000000300001900000000042300190000000005630019000000000505043300000000005404350000002003300039000000000013004b00002f630000413d000000000321001900000c9304000041000000000043043500000c280020009c00000c28020080410000004002200210000000200110003900000c280010009c00000c28010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000002fdb0000613d000000000101043b000000400200043d00000d140020009c00002ff40000813d000000a003200039000000400030043f000000000301041a000000ff0730018f000000040070008c000000030600002900002fdd0000813d00000000037204360000000104100039000000000404041a00000000004304350000000203100039000000000403041a00000060052000390000008003400270000000000035043500000c88044001970000004005200039000000000045043500000080022000390000000301100039000000000101041a000000000012043500000c7e01000041000000000201041a000000ff0120018f000000000007004b000000010500002900002fd40000c13d000000000045004b00002fd40000413d000000000035004b00002ffa0000813d000000030010008c00002fdd0000213d000000000001004b00002fac0000c13d00000cf40120019700000001011001bf00000c7e02000041000000000012041b000000400200043d00000002010000290000000001010433000000000001004b00002fb90000613d000000000300001900000000042300190000000005630019000000000505043300000000005404350000002003300039000000000013004b00002fb20000413d000000000321001900000c9304000041000000000043043500000c280020009c00000c28020080410000004002200210000000200110003900000c280010009c00000c28010080410000006001100210000000000121019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f000000010020019000002fdb0000613d000000000101043b000000000201041a00000cf40220019700000001022001bf000000000021041b000000000001042d000000010070008c00002ffa0000c13d000000040010008c00002fdd0000813d000000010010008c000030120000c13d000000000001042d00000000010000190000309e0001043000000cdc01000041000000000010043f0000002101000039000000040010043f00000c69010000410000309e00010430000000000001042f000000440120003900000d0903000041000000000031043500000024012000390000000c03000039000000000031043500000c7501000041000000000012043500000004012000390000002003000039000000000031043500000c280020009c00000c2802008041000000400120021000000c7a011001c70000309e0001043000000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e00010430000000400300043d000300000003001d00000d0a01000041000000000013043500000004013000390000004002000039000000000021043500000044023000390000000201000029000200000007001d309c1ff50000040f0000000303000029000000240230003900000002040000290000000000420435000000000131004900000c280010009c00000c280100804100000c280030009c00000c280300804100000060011002100000004002300210000000000121019f0000309e00010430000000400200043d00000d0b0300004100000000003204350000000403200039000000000013043500000c280020009c00000c2802008041000000400120021000000c69011001c70000309e000104300001000000000002000000000301041a000100000002001d000000000023004b0000302f0000a13d000000000010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f0000000100200190000030350000613d000000000101043b00000001011000290000000002000019000000000001042d00000cdc01000041000000000010043f0000003201000039000000040010043f00000c69010000410000309e0001043000000000010000190000309e000104300004000000000002000300000002001d000000000020043f000400000001001d0000000101100039000200000001001d000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000030740000613d000000000101043b000000000101041a000000000001004b0000304c0000613d000000000001042d0000000402000029000000000102041a00000cf90010009c000030760000813d000100000001001d0000000101100039000000000012041b000000000020043f000000000100041400000c280010009c00000c2801008041000000c00110021000000c85011001c70000801002000039309c30970000040f0000000100200190000030740000613d000000000101043b00000001011000290000000302000029000000000021041b0000000401000029000000000101041a000400000001001d000000000020043f0000000201000029000000200010043f000000000100041400000c280010009c00000c2801008041000000c00110021000000cc7011001c70000801002000039309c30970000040f0000000100200190000030740000613d000000000101043b0000000402000029000000000021041b000000000001042d00000000010000190000309e0001043000000cdc01000041000000000010043f0000004101000039000000040010043f00000c69010000410000309e00010430000000000001042f00000c280010009c00000c2801008041000000400110021000000c280020009c00000c28020080410000006002200210000000000112019f000000000200041400000c280020009c00000c2802008041000000c002200210000000000112019f00000c77011001c70000801002000039309c30970000040f0000000100200190000030900000613d000000000101043b000000000001042d00000000010000190000309e0001043000003095002104210000000102000039000000000001042d0000000002000019000000000001042d0000309a002104230000000102000039000000000001042d0000000002000019000000000001042d0000309c000004320000309d0001042e0000309e00010430000000000000000000000000000000000000000000000000000000000000000000000000ffffffff0000000200000000000000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000008393080700000000000000000000000000000000000000000000000000000000b6594d5400000000000000000000000000000000000000000000000000000000ed6394db00000000000000000000000000000000000000000000000000000000f5181aac00000000000000000000000000000000000000000000000000000000f5181aad00000000000000000000000000000000000000000000000000000000f9020e3300000000000000000000000000000000000000000000000000000000faf0c58100000000000000000000000000000000000000000000000000000000ed6394dc00000000000000000000000000000000000000000000000000000000ee55efee00000000000000000000000000000000000000000000000000000000ef4bfb9800000000000000000000000000000000000000000000000000000000ca15c87200000000000000000000000000000000000000000000000000000000ca15c87300000000000000000000000000000000000000000000000000000000d041415800000000000000000000000000000000000000000000000000000000d547741f00000000000000000000000000000000000000000000000000000000b6594d5500000000000000000000000000000000000000000000000000000000bfe46deb00000000000000000000000000000000000000000000000000000000c5c4744c000000000000000000000000000000000000000000000000000000009b1001d700000000000000000000000000000000000000000000000000000000a2309ff700000000000000000000000000000000000000000000000000000000a2309ff800000000000000000000000000000000000000000000000000000000a4ab1b5200000000000000000000000000000000000000000000000000000000b10c1b42000000000000000000000000000000000000000000000000000000009b1001d8000000000000000000000000000000000000000000000000000000009cdad4f200000000000000000000000000000000000000000000000000000000a217fddf000000000000000000000000000000000000000000000000000000009010d07b000000000000000000000000000000000000000000000000000000009010d07c0000000000000000000000000000000000000000000000000000000091d1485400000000000000000000000000000000000000000000000000000000964fc1ac0000000000000000000000000000000000000000000000000000000083930808000000000000000000000000000000000000000000000000000000008e3ac7720000000000000000000000000000000000000000000000000000000033e364ca0000000000000000000000000000000000000000000000000000000064496584000000000000000000000000000000000000000000000000000000006e581560000000000000000000000000000000000000000000000000000000006e581561000000000000000000000000000000000000000000000000000000006ea3c6ac000000000000000000000000000000000000000000000000000000007f0bb8de0000000000000000000000000000000000000000000000000000000064496585000000000000000000000000000000000000000000000000000000006588103b000000000000000000000000000000000000000000000000000000006dd57d310000000000000000000000000000000000000000000000000000000053319aa00000000000000000000000000000000000000000000000000000000053319aa10000000000000000000000000000000000000000000000000000000055367ba900000000000000000000000000000000000000000000000000000000598a06d70000000000000000000000000000000000000000000000000000000033e364cb0000000000000000000000000000000000000000000000000000000036568abe0000000000000000000000000000000000000000000000000000000050b4804e000000000000000000000000000000000000000000000000000000001f7adfdf000000000000000000000000000000000000000000000000000000002bf61645000000000000000000000000000000000000000000000000000000002bf61646000000000000000000000000000000000000000000000000000000002f2ff15d00000000000000000000000000000000000000000000000000000000301c9762000000000000000000000000000000000000000000000000000000001f7adfe0000000000000000000000000000000000000000000000000000000002419822000000000000000000000000000000000000000000000000000000000248a9ca3000000000000000000000000000000000000000000000000000000000a9254e3000000000000000000000000000000000000000000000000000000000a9254e4000000000000000000000000000000000000000000000000000000000e1fb3bb00000000000000000000000000000000000000000000000000000000167ff46f0000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000000407b572000000000000000000000000ffffffffffffffffffffffffffffffffffffffff70a0823100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000000000000000000000000000ffffffffffffffffa9059cbb00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff7f000000000000000000000000000000000000000000000000ffffffffffffff3f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c65641806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b8302000002000000000000000000000000000000240000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff6f742073756363656564000000000000000000000000000000000000000000005361666545524332303a204552433230206f7065726174696f6e20646964206e08c379a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002d1d46fe329373fab87a4f3e0d1fc3113d3556ebdbdc47372a971830343ebdc416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000000000000000000000000000000000000000006400000000000000000000000030779e0c00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000000000062a2846900000000000000000000000000000000000000000000000000000000e8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac402480207740000000000000000000000000000000000000020000000800000000000000000e8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac402480207770000000000000000000000000000000000000020000000000000000000000000e8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac402480207727fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0e6812692cc48e737ed6fb1f4ec0503bbfd88e5ceb294d0fdf88b8d8cddbc508002000000000000000000000000000000000000200000000000000000000000004c013bd73202fde3c7cfe26ca486d0882f2c5b2fc9c761b15212f759bd2347dd800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff89cf70488e4eadb7869f34a1ac259a8c71e507d9c4bdca484b23caa3e146c548e8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac40248020770e8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac4024802077189c8f6c000000000000000000000000000000000000000000000000000000000627579416e644d696e74576974684552433230000000000000000000000000000000000000000000000000000000000000000064000000c00000000000000000d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa4c9fda95ff00000000000000000000000000000000000000000000000000000000e8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac40248020776000000000000000000000000000000000000000000000000ffffffffffffff5fe8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac4024802077300000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffdfffffffffffffffffffffffffffffffffffffffe000000000000000000000000002000000000000000000000000000000000000a000000000000000000000000002000000000000000000000000000000000000c0000000000000000000000000435abbc42c5f6f2940a7ae00adf25477b143a7ff73e7af6263687422c7fc32b7e8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac402480207757f0be1d5000000000000000000000000000000000000000000000000000000006c6ff7ae00000000000000000000000000000000000000000000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d955391320200000200000000000000000000000000000004000000000000000000000000c92c4ad0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044000000000000000000000000197ed96d33b718c812904e0b13fafc4402771a314d6b2f02077472732243af80eeea8f8d00000000000000000000000000000000000000000000000000000000e0fd77c200000000000000000000000000000000000000000000000000000000c3609c6c0000000000000000000000000000000000000000000000000000000055bce0b300000000000000000000000000000000000000000000000000000000b6063b70a27237920bfd0970cef3eecadaeec71746776501f80755c77ad403ffffffffffffffffffffffffffffffffff0000000000000000000000000000000015da7ed5d61cd60c8292baa2bedc01b3e00d0c23cc3a7881c75693772d766179d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa56ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00001e5baa6700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff7b0100053509eef80ec9a3c534dc23732181d4cb17bedfa5bb605e31ac7af7e0ec9c4d535bdea7cd8a978f128b93471df48c7dbab89d703809115bdc118c235bfd0200000000000000000000000000000000000084000000000000000000000000d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa4ebf71d03b000bc45d611914c4d0dc85c2d9de7eb79716d7f39458a590039bdfdd408e2fc4fff43ba29ee6eb3b2f237a3d2621814868e9280c6ba75a6ffc642023d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa4f010f8758f32033a039a7f28cc5ee48784a3d70baa545c8c70111ea9318b49bfbfef078a70cdfcc5fc6580d733a11b787b5c28f455aba3738feee156ce74b6405d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa50de93da25d8687bb92da5a568a24f6152f275bb42cdb7d3202b193f1b6396d9b6216c25da27978446d25a5a975db09ead0d8a44bd32482cdfd4e6c0e49c69264ad0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa51d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa52d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa53ffffffffffffffffffffffff00000000000000000000000000000000000000008d1197b000000000000000000000000000000000000000000000000000000000ec3d50b58d4069bffddcdf1c185fe460bf84515313ccf2e63e7c4683aa0697bf7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024980c0c16b40000000000000000000000000000000000000000000000000000000031cd22d70000000000000000000000000000000000000000000000000000000019c3706100000000000000000000000000000000000000000000000000000000bdcee525000000000000000000000000000000000000000000000000000000000811ae900a201b0f0b74bdb67631ccc9490c9f013b61e8989efb84f4a6f81ac8fdffffffffffffffffffffffffffffffffffffdfffffff8000000000000000009a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b020000000000000000000000000000000000004000000000000000000000000090a44ef900000000000000000000000000000000000000000000000000000000d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa54d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa55e8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac402480207793de9cb1c00000000000000000000000000000000000000000000000000000000fdffffffffffffffffffffffffffffffffffffe000000000000000000000000040c10f190000000000000000000000000000000000000000000000000000000018b25c8e0000000000000000000000000000000000000000000000000000000040e9e06f00000000000000000000000000000000000000000000000000000000647920696e697469616c697a6564000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e747261637420697320616c726561d0bc967845ff7ed451d2e8ae9f1bb4b6cb8317580ba4f05622a42fd0a2aefa4d1497345f0dbd49f159dc860308f766cd682b97f60eadeb2699add805ac2f79e8bd2a4b1e00000000000000000000000000000000000000000000000000000000f63eef7b00000000000000000000000000000000000000000000000000000000fec39e17000000000000000000000000000000000000000000000000000000009b01b00700000000000000000000000000000000000000000000000000000000aa97bd4ce97ef7c37b0d27a86d74ec828314d7c88231d41fec06d84a6dba458ad42b5b879b2101bfacd80cfe6279be314b4e122c79279b62ff355fd8036f6236000000000000000000000000000000000000000000000000fffffffffffffe3f4e487b7100000000000000000000000000000000000000000000000000000000fdffffffffffffffffffffffffffffffffffffdfffffff400000000000000000c7efe2ba00000000000000000000000000000000000000000000000000000000627579416e644d696e74576974684e6174697665000000000000000000000000306214ae000000000000000000000000000000000000000000000000000000008a98cbd0cab14e33b8a5e5710b9b59bceec8af9a5b4b3bb32fb275cf04ea048d5853b050771199a29637684839a7300440fad8daa8dd21dd6503777729f5d051e3aa272800000000000000000000000000000000000000000000000000000000416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636520726f6c657320666f722073656c6600000000000000000000000000000000000000000000000000000000000000000000000084000000800000000000000000bcbdbf400d5c713d9679ffa947f717848591ab5a7d1608c49119db603c4942cb2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0dd84d2a6b000000000000000000000000000000000000000000000000000000001d859e3c0000000000000000000000000000000000000000000000000000000073ea38bf2364c15fd0bf36e7dc11202f5bc4d61ddd1b87ec439ed3f6ab8894f52f02be9d00000000000000000000000000000000000000000000000000000000cb2d1afee08f05a64e0c510df45b66e43153ca6d0b90429bfdda12f05aa43b80f215bf675342aaf38dc307bcc9b10c0b26a037350a4f6c5770f89f03d5734f55000000000000000000000000000000000000004000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff5a05180f0000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000007965db0b00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffc00000000000000000000000000000000000000000000000010000000000000000e8c5fdcac7135b71152a8b8457be258a5807b8ed92ceecd2833ac40248020778ad3228b676f7d3cd4284a5443f17f1962b36e491b30a40b2405849e597ba5fb5000000000000000000000000000000000000000000000000ffffffffffffffa000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff3000000000000000000000000000000000000000000000000000000000000000780000000000000000000000000000000000000000000000000000000000000030313233343536373839616263646566000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000537472696e67733a20686578206c656e67746820696e73756666696369656e74416363657373436f6e74726f6c3a206163636f756e7420000000000000000000206973206d697373696e6720726f6c6520000000000000000000000000000000a6eef7e35abe7026729641147f7915573c7e97b47efa546f5f6e3230263bcb4aa6eef7e35abe7026729641147f7915573c7e97b47efa546f5f6e3230263bcb49f6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b8526d06300000000000000000000000000000000000000000000000000000000506861736520636c6f736564000000000000000000000000000000000000000055923235000000000000000000000000000000000000000000000000000000006abb0175000000000000000000000000000000000000000000000000000000008d0ecb1b000000000000000000000000000000000000000000000000000000001d3cdc0e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff9f000000000000000000000000000000000000000000000000ffffffffffffffbf30f28b7a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffedbfffffffffffffffffffffffffffffffffffffedc00000000000000000000000002d70b8a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff600000000000000000000000000000000000000000000000000000000000000000985b70b52ee0ac29217d226e1a1ae7a37f8fc7cb834cba5f38fac703f10f1b28
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.