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 | |||
---|---|---|---|---|---|---|
270888 | 10 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:
ArchetypeErc721a
Compiler Version
v0.8.28+commit.7893614a
ZkSolc Version
v1.5.7
Optimization Enabled:
Yes with Mode 3
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT // Archetype v0.8.0 // // d8888 888 888 // d88888 888 888 // d88P888 888 888 // d88P 888 888d888 .d8888b 88888b. .d88b. 888888 888 888 88888b. .d88b. // d88P 888 888P" d88P" 888 "88b d8P Y8b 888 888 888 888 "88b d8P Y8b // d88P 888 888 888 888 888 88888888 888 888 888 888 888 88888888 // d8888888888 888 Y88b. 888 888 Y8b. Y88b. Y88b 888 888 d88P Y8b. // d88P 888 888 "Y8888P 888 888 "Y8888 "Y888 "Y88888 88888P" "Y8888 // 888 888 // Y8b d88P 888 // "Y88P" 888 pragma solidity ^0.8.20; import "./ArchetypeLogicErc721a.sol"; import "erc721a-upgradeable/contracts/ERC721AUpgradeable.sol"; import "erc721a-upgradeable/contracts/ERC721A__Initializable.sol"; import "erc721a-upgradeable/contracts/extensions/ERC721AQueryableUpgradeable.sol"; import "./ERC721A__OwnableUpgradeable.sol"; import "solady/src/utils/LibString.sol"; import "@openzeppelin/contracts-upgradeable/token/common/ERC2981Upgradeable.sol"; contract ArchetypeErc721a is ArchetypeLogicErc721a, ERC721A__Initializable, ERC721AUpgradeable, ERC721A__OwnableUpgradeable, ERC2981Upgradeable, ERC721AQueryableUpgradeable { // // VARIABLES // mapping(bytes32 => AdvancedInvite) public invites; mapping(bytes32 => uint256) public packedBonusDiscounts; mapping(bytes32 => BurnInvite) public burnInvites; mapping(address => mapping(bytes32 => uint256)) private _minted; mapping(bytes32 => uint256) private _listSupply; mapping(address => uint128) private _ownerBalance; mapping(address => mapping(address => uint128)) private _affiliateBalance; Config public config; PayoutConfig public payoutConfig; Options public options; // // METHODS // function initialize( string memory name, string memory symbol, Config calldata config_, PayoutConfig calldata payoutConfig_, address _receiver ) external initializerERC721A { __ERC721A_init(name, symbol); // check max bps not reached and min platform fee. if ( config_.affiliateFee > MAXBPS || config_.affiliateDiscount > MAXBPS || config_.affiliateSigner == address(0) || config_.maxBatchSize == 0 ) { revert InvalidConfig(); } config = config_; __Ownable_init(); uint256 totalShares = payoutConfig_.ownerBps + payoutConfig_.platformBps + payoutConfig_.partnerBps + payoutConfig_.superAffiliateBps; if (payoutConfig_.platformBps < 250 || totalShares != 10000) { revert InvalidSplitShares(); } payoutConfig = payoutConfig_; setDefaultRoyalty(_receiver, config.defaultRoyalty); } // // PUBLIC // function mint( Auth calldata auth, uint256 quantity, address affiliate, bytes calldata signature ) external payable { mintTo(auth, quantity, _msgSender(), affiliate, signature); } function batchMintTo( Auth calldata auth, address[] calldata toList, uint256[] calldata quantityList, address affiliate, bytes calldata signature ) external payable { if (quantityList.length != toList.length) { revert InvalidConfig(); } AdvancedInvite storage invite = invites[auth.key]; uint256 packedDiscount = packedBonusDiscounts[auth.key]; uint256 curSupply = _totalMinted(); uint256 totalQuantity; uint256 totalBonusMints; for (uint256 i; i < toList.length; ) { uint256 quantityToAdd; if (invite.unitSize > 1) { quantityToAdd = quantityList[i] * invite.unitSize; } else { quantityToAdd = quantityList[i]; } uint256 numBonusMints = bonusMintsAwarded(quantityToAdd, packedDiscount); _mint(toList[i], quantityToAdd + numBonusMints); totalQuantity += quantityToAdd; totalBonusMints += numBonusMints; unchecked { ++i; } } validateAndCreditMint(invite, auth, totalQuantity, totalBonusMints, curSupply, affiliate, signature); } function mintTo( Auth calldata auth, uint256 quantity, address to, address affiliate, bytes calldata signature ) public payable { AdvancedInvite storage invite = invites[auth.key]; uint256 packedDiscount = packedBonusDiscounts[auth.key]; if (invite.unitSize > 1) { quantity = quantity * invite.unitSize; } uint256 curSupply = _totalMinted(); uint256 numBonusMints = bonusMintsAwarded(quantity, packedDiscount); _mint(to, quantity + numBonusMints); validateAndCreditMint(invite, auth, quantity, numBonusMints, curSupply, affiliate, signature); } function validateAndCreditMint( AdvancedInvite storage invite, Auth calldata auth, uint256 quantity, uint256 numBonusMints, uint256 curSupply, address affiliate, bytes calldata signature ) internal { uint256 totalQuantity = quantity + numBonusMints; ValidationArgs memory args; { args = ValidationArgs({ owner: owner(), affiliate: affiliate, quantity: totalQuantity, curSupply: curSupply, listSupply: _listSupply[auth.key] }); } uint128 cost = uint128( computePrice( invite, config.affiliateDiscount, quantity, args.listSupply, args.affiliate != address(0) ) ); validateMint(invite, config, auth, _minted, signature, args, cost); address msgSender = _msgSender(); address effectiveEoa = getEffectiveEoaWallet(msgSender); if (invite.limit < invite.maxSupply) { _minted[effectiveEoa][auth.key] += totalQuantity; } if (invite.maxSupply < UINT32_MAX) { _listSupply[auth.key] += totalQuantity; } updateBalances( invite.tokenAddress, config, _ownerBalance, _affiliateBalance, affiliate, quantity, cost ); if (msg.value > cost) { _refund(msgSender, msg.value - cost); } } function burnToMint(Auth calldata auth, uint256[] calldata tokenIds) external payable { BurnInvite storage burnInvite = burnInvites[auth.key]; uint256 curSupply = _totalMinted(); uint128 cost = burnInvite.price; validateBurnToMint(burnInvite, config, auth, tokenIds, curSupply, _minted, cost); address msgSender = _msgSender(); for (uint256 i; i < tokenIds.length; ) { address burnAddress = burnInvite.burnAddress != address(0) ? burnInvite.burnAddress : address(0x000000000000000000000000000000000000dEaD); burnInvite.burnErc721.transferFrom(msgSender, burnAddress, tokenIds[i]); unchecked { ++i; } } uint256 quantity = burnInvite.reversed ? tokenIds.length * burnInvite.ratio : tokenIds.length / burnInvite.ratio; _mint(msgSender, quantity); address effectiveEoa = getEffectiveEoaWallet(msgSender); if (burnInvite.limit < config.maxSupply) { _minted[effectiveEoa][keccak256(abi.encodePacked("burn", auth.key))] += quantity; } updateBalances( burnInvite.tokenAddress, config, _ownerBalance, _affiliateBalance, address(0), // burn to mint does not support affiliates quantity, cost ); if (msg.value > cost) { _refund(msgSender, msg.value - cost); } } function tokenURI(uint256 tokenId) public view virtual override(ERC721AUpgradeable, IERC721AUpgradeable) returns (string memory) { if (!_exists(tokenId)) revert URIQueryForNonexistentToken(); return bytes(config.baseUri).length != 0 ? string(abi.encodePacked(config.baseUri, LibString.toString(tokenId))) : ""; } function withdraw() external { address[] memory tokens = new address[](1); tokens[0] = address(0); withdrawTokens(tokens); } function withdrawTokens(address[] memory tokens) public { withdrawTokens(payoutConfig, _ownerBalance, owner(), tokens); } function withdrawAffiliate() external { address[] memory tokens = new address[](1); tokens[0] = address(0); withdrawTokensAffiliate(tokens); } function withdrawTokensAffiliate(address[] memory tokens) public { withdrawTokensAffiliate(_affiliateBalance, tokens); } function ownerBalance() external view returns (uint128) { return _ownerBalance[address(0)]; } function ownerBalanceToken(address token) external view returns (uint128) { return _ownerBalance[token]; } function affiliateBalance(address affiliate) external view returns (uint128) { return _affiliateBalance[affiliate][address(0)]; } function affiliateBalanceToken(address affiliate, address token) external view returns (uint128) { return _affiliateBalance[affiliate][token]; } function minted(address minter, bytes32 key) external view returns (uint256) { address effectiveEoa = getEffectiveEoaWallet(minter); return _minted[effectiveEoa][key]; } function listSupply(bytes32 key) external view returns (uint256) { return _listSupply[key]; } function platform() external pure returns (address) { return PLATFORM; } function computePrice( bytes32 key, uint256 quantity, bool affiliateUsed ) external view returns (uint256) { AdvancedInvite storage i = invites[key]; uint256 listSupply_ = _listSupply[key]; return computePrice(i, config.affiliateDiscount, quantity, listSupply_, affiliateUsed); } // // OWNER ONLY // function setBaseURI(string memory baseUri) external _onlyOwner { if (options.uriLocked) { revert LockedForever(); } config.baseUri = baseUri; } /// @notice the password is "forever" function lockURI(string memory password) external _onlyOwner { if (keccak256(abi.encodePacked(password)) != keccak256(abi.encodePacked("forever"))) { revert WrongPassword(); } options.uriLocked = true; } /// @notice the password is "forever" // max supply cannot subceed total supply. Be careful changing. function setMaxSupply(uint32 maxSupply, string memory password) external _onlyOwner { if (keccak256(abi.encodePacked(password)) != keccak256(abi.encodePacked("forever"))) { revert WrongPassword(); } if (options.maxSupplyLocked) { revert LockedForever(); } if (maxSupply < _totalMinted()) { revert MaxSupplyExceeded(); } config.maxSupply = maxSupply; } /// @notice the password is "forever" function lockMaxSupply(string memory password) external _onlyOwner { if (keccak256(abi.encodePacked(password)) != keccak256(abi.encodePacked("forever"))) { revert WrongPassword(); } options.maxSupplyLocked = true; } function setAffiliateFee(uint16 affiliateFee) external _onlyOwner { if (options.affiliateFeeLocked) { revert LockedForever(); } if (affiliateFee > MAXBPS) { revert InvalidConfig(); } config.affiliateFee = affiliateFee; } function setAffiliateDiscount(uint16 affiliateDiscount) external _onlyOwner { if (options.affiliateFeeLocked) { revert LockedForever(); } if (affiliateDiscount > MAXBPS) { revert InvalidConfig(); } config.affiliateDiscount = affiliateDiscount; } /// @notice the password is "forever" function lockAffiliateFee(string memory password) external _onlyOwner { if (keccak256(abi.encodePacked(password)) != keccak256(abi.encodePacked("forever"))) { revert WrongPassword(); } options.affiliateFeeLocked = true; } function setOwnerAltPayout(address ownerAltPayout) external _onlyOwner { if (options.ownerAltPayoutLocked) { revert LockedForever(); } payoutConfig.ownerAltPayout = ownerAltPayout; } function lockOwnerAltPayout() external _onlyOwner { options.ownerAltPayoutLocked = true; } function setMaxBatchSize(uint32 maxBatchSize) external _onlyOwner { config.maxBatchSize = maxBatchSize; } function setBonusDiscounts(bytes32 _key, BonusDiscount[] calldata _bonusDiscounts) public onlyOwner { if(_bonusDiscounts.length > 8) { revert InvalidConfig(); } uint256 packed; for (uint8 i = 0; i < _bonusDiscounts.length; i++) { if (i > 0 && _bonusDiscounts[i].numMints >= _bonusDiscounts[i - 1].numMints) { revert InvalidConfig(); } uint32 discount = (uint32(_bonusDiscounts[i].numMints) << 16) | uint32(_bonusDiscounts[i].numBonusMints); packed |= uint256(discount) << (32 * i); } packedBonusDiscounts[_key] = packed; } function setBonusInvite( bytes32 _key, bytes32 _cid, AdvancedInvite calldata _advancedInvite, BonusDiscount[] calldata _bonusDiscount ) external _onlyOwner { setBonusDiscounts(_key, _bonusDiscount); setAdvancedInvite(_key, _cid, _advancedInvite); } function setInvite( bytes32 _key, bytes32 _cid, Invite calldata _invite ) external _onlyOwner { setAdvancedInvite(_key, _cid, AdvancedInvite({ price: _invite.price, reservePrice: _invite.price, delta: 0, start: _invite.start, end: _invite.end, limit: _invite.limit, maxSupply: _invite.maxSupply, interval: 0, unitSize: _invite.unitSize, tokenAddress: _invite.tokenAddress, isBlacklist: _invite.isBlacklist })); } function setAdvancedInvite( bytes32 _key, bytes32 _cid, AdvancedInvite memory _AdvancedInvite ) public _onlyOwner { // approve token for withdrawals if erc20 list if (_AdvancedInvite.tokenAddress != address(0)) { bool success = IERC20(_AdvancedInvite.tokenAddress).approve(PAYOUTS, 2**256 - 1); if (!success) { revert NotApprovedToTransfer(); } } if (_AdvancedInvite.start < block.timestamp) { _AdvancedInvite.start = uint32(block.timestamp); } invites[_key] = _AdvancedInvite; emit Invited(_key, _cid); } function setBurnInvite( bytes32 _key, bytes32 _cid, BurnInvite memory _burnInvite ) external _onlyOwner { if (_burnInvite.start < block.timestamp) { _burnInvite.start = uint32(block.timestamp); } burnInvites[_key] = _burnInvite; emit BurnInvited(_key, _cid); } // // INTERNAL // function _startTokenId() internal view virtual override returns (uint256) { return 1; } modifier _onlyPlatform() { if (_msgSender() != PLATFORM) { revert NotPlatform(); } _; } modifier _onlyOwner() { if (_msgSender() != owner()) { revert NotOwner(); } _; } function _refund(address to, uint256 refund) internal { (bool success, ) = payable(to).call{ value: refund }(""); if (!success) { revert TransferFailed(); } } //ERC2981 ROYALTY function supportsInterface(bytes4 interfaceId) public view virtual override(IERC721AUpgradeable, ERC721AUpgradeable, ERC2981Upgradeable) returns (bool) { // Supports the following `interfaceId`s: // - IERC165: 0x01ffc9a7 // - IERC721: 0x80ac58cd // - IERC721Metadata: 0x5b5e139f // - IERC2981: 0x2a55205a return ERC721AUpgradeable.supportsInterface(interfaceId) || ERC2981Upgradeable.supportsInterface(interfaceId); } function setDefaultRoyalty(address receiver, uint16 feeNumerator) public _onlyOwner { config.defaultRoyalty = feeNumerator; _setDefaultRoyalty(receiver, feeNumerator); } }
// SPDX-License-Identifier: MIT // ArchetypeLogic v0.8.0 // // d8888 888 888 // d88888 888 888 // d88P888 888 888 // d88P 888 888d888 .d8888b 88888b. .d88b. 888888 888 888 88888b. .d88b. // d88P 888 888P" d88P" 888 "88b d8P Y8b 888 888 888 888 "88b d8P Y8b // d88P 888 888 888 888 888 88888888 888 888 888 888 888 88888888 // d8888888888 888 Y88b. 888 888 Y8b. Y88b. Y88b 888 888 d88P Y8b. // d88P 888 888 "Y8888P 888 888 "Y8888 "Y888 "Y88888 88888P" "Y8888 // 888 888 // Y8b d88P 888 // "Y88P" 888 pragma solidity ^0.8.20; import "../ArchetypePayouts.sol"; import "../IExclusiveDelegateResolver.sol"; import "@openzeppelin/contracts/token/ERC721/IERC721.sol"; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import "solady/src/utils/MerkleProofLib.sol"; import "solady/src/utils/ECDSA.sol"; error InvalidConfig(); error MintNotYetStarted(); error MintEnded(); error WalletUnauthorizedToMint(); error InsufficientEthSent(); error ExcessiveEthSent(); error Erc20BalanceTooLow(); error MaxSupplyExceeded(); error ListMaxSupplyExceeded(); error NumberOfMintsExceeded(); error MintingPaused(); error InvalidReferral(); error InvalidSignature(); error MaxBatchSizeExceeded(); error BurnToMintDisabled(); error NotTokenOwner(); error NotPlatform(); error NotOwner(); error NotShareholder(); error NotApprovedToTransfer(); error InvalidAmountOfTokens(); error WrongPassword(); error LockedForever(); error Blacklisted(); // // STRUCTS // struct Auth { bytes32 key; bytes32[] proof; } struct BonusDiscount { uint16 numMints; uint16 numBonusMints; } struct Config { string baseUri; address affiliateSigner; uint32 maxSupply; uint32 maxBatchSize; uint16 affiliateFee; //BPS uint16 affiliateDiscount; //BPS uint16 defaultRoyalty; //BPS } // allocation splits for withdrawn owner funds, must sum to 100% struct PayoutConfig { uint16 ownerBps; uint16 platformBps; uint16 partnerBps; uint16 superAffiliateBps; address partner; address superAffiliate; address ownerAltPayout; } struct Options { bool uriLocked; bool maxSupplyLocked; bool affiliateFeeLocked; bool ownerAltPayoutLocked; } struct AdvancedInvite { uint128 price; uint128 reservePrice; uint128 delta; uint32 start; uint32 end; uint32 limit; uint32 maxSupply; uint32 interval; uint32 unitSize; // mint 1 get x address tokenAddress; bool isBlacklist; } struct Invite { uint128 price; uint32 start; uint32 end; uint32 limit; uint32 maxSupply; uint32 unitSize; // mint 1 get x address tokenAddress; bool isBlacklist; } struct BurnInvite { IERC721 burnErc721; address burnAddress; address tokenAddress; uint128 price; // flat price - does not support discounts bool reversed; // side of the ratio (false=burn {ratio} get 1, true=burn 1 get {ratio}) uint16 ratio; uint32 start; uint32 end; uint64 limit; } struct ValidationArgs { address owner; address affiliate; uint256 quantity; uint256 curSupply; uint256 listSupply; } // UPDATE CONSTANTS BEFORE DEPLOY address constant PLATFORM = 0x16e3F90Ad00b5CDF005FB9f7D855F4611D6b2B72; address constant BATCH = 0x5D4A8C47ae56C02Bdb41D2E5D4957b7A0bE9c619; address constant PAYOUTS = 0x927a34917ab0ddFB37F05F56B302726d58f83A02; uint16 constant MAXBPS = 5000; // max fee or discount is 50% uint32 constant UINT32_MAX = 2**32 - 1; abstract contract ArchetypeLogicErc721a { // // EVENTS // event Invited(bytes32 indexed key, bytes32 indexed cid); event BurnInvited(bytes32 indexed key, bytes32 indexed cid); event Referral(address indexed affiliate, address token, uint128 wad, uint256 numMints); event Withdrawal(address indexed src, address token, uint128 wad); // AGW bytes24 constant _AGW_LINK_RIGHTS = bytes24(keccak256("AGW_LINK")); IExclusiveDelegateResolver constant DELEGATE_RESOLVER = IExclusiveDelegateResolver(0x0000000078CC4Cc1C14E27c0fa35ED6E5E58825D); // calculate price based on affiliate usage and mint discounts function computePrice( AdvancedInvite storage invite, uint16 affiliateDiscount, uint256 numTokens, uint256 listSupply, bool affiliateUsed ) internal view returns (uint256) { uint256 price = invite.price; uint256 cost; if (invite.interval > 0 && invite.delta > 0) { // Apply dutch pricing uint256 diff = (((block.timestamp - invite.start) / invite.interval) * invite.delta); if (price > invite.reservePrice) { if (diff > price - invite.reservePrice) { price = invite.reservePrice; } else { price = price - diff; } } else if (price < invite.reservePrice) { if (diff > invite.reservePrice - price) { price = invite.reservePrice; } else { price = price + diff; } } cost = price * numTokens; } else if (invite.interval == 0 && invite.delta > 0) { // Apply linear curve uint256 lastPrice = price + invite.delta * listSupply; cost = lastPrice * numTokens + (invite.delta * numTokens * (numTokens - 1)) / 2; } else { cost = price * numTokens; } if (affiliateUsed) { cost = cost - ((cost * affiliateDiscount) / 10000); } return cost; } function bonusMintsAwarded(uint256 numNfts, uint256 packedDiscount) internal pure returns (uint256) { for (uint8 i = 0; i < 8; i++) { uint32 discount = uint32((packedDiscount >> (32 * i)) & 0xFFFFFFFF); uint16 tierNumMints = uint16(discount >> 16); uint16 tierBonusMints = uint16(discount); if (tierNumMints == 0) { break; // End of valid discounts } if (numNfts >= tierNumMints) { return (numNfts / tierNumMints) * tierBonusMints; } } return 0; } function validateMint( AdvancedInvite storage i, Config storage config, Auth calldata auth, mapping(address => mapping(bytes32 => uint256)) storage minted, bytes calldata signature, ValidationArgs memory args, uint128 cost ) internal view { address msgSender = _msgSender(); address effectiveEoa = getEffectiveEoaWallet(msgSender); if (args.affiliate != address(0)) { if ( args.affiliate == PLATFORM || args.affiliate == args.owner || args.affiliate == msgSender ) { revert InvalidReferral(); } validateAffiliate(args.affiliate, signature, config.affiliateSigner); } if (i.limit == 0) { revert MintingPaused(); } if (!i.isBlacklist) { if (!verify(auth, i.tokenAddress, effectiveEoa)) { revert WalletUnauthorizedToMint(); } } else { if (verify(auth, i.tokenAddress, effectiveEoa)) { revert Blacklisted(); } } if (block.timestamp < i.start) { revert MintNotYetStarted(); } if (i.end > i.start && block.timestamp > i.end) { revert MintEnded(); } if (i.limit < i.maxSupply) { uint256 totalAfterMint = minted[effectiveEoa][auth.key] + args.quantity; if (totalAfterMint > i.limit) { revert NumberOfMintsExceeded(); } } if (i.maxSupply < config.maxSupply) { uint256 totalAfterMint = args.listSupply + args.quantity; if (totalAfterMint > i.maxSupply) { revert ListMaxSupplyExceeded(); } } if (args.quantity > config.maxBatchSize) { revert MaxBatchSizeExceeded(); } if ((args.curSupply + args.quantity) > config.maxSupply) { revert MaxSupplyExceeded(); } if (i.tokenAddress != address(0)) { IERC20 erc20Token = IERC20(i.tokenAddress); if (erc20Token.allowance(msgSender, address(this)) < cost) { revert NotApprovedToTransfer(); } if (erc20Token.balanceOf(msgSender) < cost) { revert Erc20BalanceTooLow(); } if (msg.value != 0) { revert ExcessiveEthSent(); } } else { if (msg.value < cost) { revert InsufficientEthSent(); } } } function validateBurnToMint( BurnInvite storage burnInvite, Config storage config, Auth calldata auth, uint256[] calldata tokenIds, uint256 curSupply, mapping(address => mapping(bytes32 => uint256)) storage minted, uint128 cost ) internal view { if (burnInvite.limit == 0) { revert MintingPaused(); } if (block.timestamp < burnInvite.start) { revert MintNotYetStarted(); } if (burnInvite.end > burnInvite.start && block.timestamp > burnInvite.end) { revert MintEnded(); } // check if msgSender owns tokens and has correct approvals address msgSender = _msgSender(); for (uint256 i; i < tokenIds.length; ) { if (burnInvite.burnErc721.ownerOf(tokenIds[i]) != msgSender) { revert NotTokenOwner(); } unchecked { ++i; } } if (!verify(auth, burnInvite.tokenAddress, msgSender)) { revert WalletUnauthorizedToMint(); } if (!burnInvite.burnErc721.isApprovedForAll(msgSender, address(this))) { revert NotApprovedToTransfer(); } uint256 quantity; if (burnInvite.reversed) { quantity = tokenIds.length * burnInvite.ratio; } else { if (tokenIds.length % burnInvite.ratio != 0) { revert InvalidAmountOfTokens(); } quantity = tokenIds.length / burnInvite.ratio; } if (quantity > config.maxBatchSize) { revert MaxBatchSizeExceeded(); } address effectiveEoa = getEffectiveEoaWallet(msgSender); if (burnInvite.limit < config.maxSupply) { uint256 totalAfterMint = minted[effectiveEoa][keccak256(abi.encodePacked("burn", auth.key))] + quantity; if (totalAfterMint > burnInvite.limit) { revert NumberOfMintsExceeded(); } } if ((curSupply + quantity) > config.maxSupply) { revert MaxSupplyExceeded(); } if (burnInvite.tokenAddress != address(0)) { IERC20 erc20Token = IERC20(burnInvite.tokenAddress); if (erc20Token.allowance(msgSender, address(this)) < cost) { revert NotApprovedToTransfer(); } if (erc20Token.balanceOf(msgSender) < cost) { revert Erc20BalanceTooLow(); } if (msg.value != 0) { revert ExcessiveEthSent(); } } else { if (msg.value < cost) { revert InsufficientEthSent(); } } } function updateBalances( address tokenAddress, Config storage config, mapping(address => uint128) storage _ownerBalance, mapping(address => mapping(address => uint128)) storage _affiliateBalance, address affiliate, uint256 quantity, uint128 value ) internal { uint128 affiliateWad; if (affiliate != address(0)) { affiliateWad = (value * config.affiliateFee) / 10000; _affiliateBalance[affiliate][tokenAddress] += affiliateWad; emit Referral(affiliate, tokenAddress, affiliateWad, quantity); } uint128 balance = _ownerBalance[tokenAddress]; uint128 ownerWad = value - affiliateWad; _ownerBalance[tokenAddress] = balance + ownerWad; if (tokenAddress != address(0)) { IERC20 erc20Token = IERC20(tokenAddress); bool success = erc20Token.transferFrom(_msgSender(), address(this), value); if (!success) { revert TransferFailed(); } } } function withdrawTokensAffiliate( mapping(address => mapping(address => uint128)) storage _affiliateBalance, address[] memory tokens ) internal { address msgSender = _msgSender(); for (uint256 i; i < tokens.length; i++) { address tokenAddress = tokens[i]; uint128 wad = _affiliateBalance[msgSender][tokenAddress]; _affiliateBalance[msgSender][tokenAddress] = 0; if (wad == 0) { revert BalanceEmpty(); } if (tokenAddress == address(0)) { bool success = false; (success, ) = msgSender.call{ value: wad }(""); if (!success) { revert TransferFailed(); } } else { IERC20 erc20Token = IERC20(tokenAddress); bool success = erc20Token.transfer(msgSender, wad); if (!success) { revert TransferFailed(); } } emit Withdrawal(msgSender, tokenAddress, wad); } } function withdrawTokens( PayoutConfig storage payoutConfig, mapping(address => uint128) storage _ownerBalance, address owner, address[] memory tokens ) internal { address msgSender = _msgSender(); for (uint256 i; i < tokens.length; i++) { address tokenAddress = tokens[i]; uint128 wad; if ( msgSender == owner || msgSender == PLATFORM || msgSender == payoutConfig.partner || msgSender == payoutConfig.superAffiliate || msgSender == payoutConfig.ownerAltPayout ) { wad = _ownerBalance[tokenAddress]; _ownerBalance[tokenAddress] = 0; } else { revert NotShareholder(); } if (wad == 0) { revert BalanceEmpty(); } if (payoutConfig.ownerAltPayout == address(0)) { address[] memory recipients = new address[](4); recipients[0] = owner; recipients[1] = PLATFORM; recipients[2] = payoutConfig.partner; recipients[3] = payoutConfig.superAffiliate; uint16[] memory splits = new uint16[](4); splits[0] = payoutConfig.ownerBps; splits[1] = payoutConfig.platformBps; splits[2] = payoutConfig.partnerBps; splits[3] = payoutConfig.superAffiliateBps; if (tokenAddress == address(0)) { ArchetypePayouts(PAYOUTS).updateBalances{ value: wad }( wad, tokenAddress, recipients, splits ); } else { ArchetypePayouts(PAYOUTS).updateBalances(wad, tokenAddress, recipients, splits); } } else { uint256 ownerShare = (uint256(wad) * payoutConfig.ownerBps) / 10000; uint256 remainingShare = wad - ownerShare; if (tokenAddress == address(0)) { (bool success, ) = payable(payoutConfig.ownerAltPayout).call{ value: ownerShare }(""); if (!success) revert TransferFailed(); } else { IERC20(tokenAddress).transfer(payoutConfig.ownerAltPayout, ownerShare); } address[] memory recipients = new address[](3); recipients[0] = PLATFORM; recipients[1] = payoutConfig.partner; recipients[2] = payoutConfig.superAffiliate; uint16[] memory splits = new uint16[](3); uint16 remainingBps = 10000 - payoutConfig.ownerBps; splits[1] = uint16((uint256(payoutConfig.partnerBps) * 10000) / remainingBps); splits[2] = uint16((uint256(payoutConfig.superAffiliateBps) * 10000) / remainingBps); splits[0] = 10000 - splits[1] - splits[2]; if (tokenAddress == address(0)) { ArchetypePayouts(PAYOUTS).updateBalances{ value: remainingShare }( remainingShare, tokenAddress, recipients, splits ); } else { ArchetypePayouts(PAYOUTS).updateBalances( remainingShare, tokenAddress, recipients, splits ); } } emit Withdrawal(msgSender, tokenAddress, wad); } } function validateAffiliate( address affiliate, bytes calldata signature, address affiliateSigner ) internal view { bytes32 signedMessagehash = ECDSA.toEthSignedMessageHash( keccak256(abi.encodePacked(affiliate)) ); address signer = ECDSA.recover(signedMessagehash, signature); if (signer != affiliateSigner) { revert InvalidSignature(); } } function getEffectiveEoaWallet(address msgSender) public view returns (address) { try DELEGATE_RESOLVER.delegatedWalletsByRights(msgSender, _AGW_LINK_RIGHTS) returns (address[] memory agwDelegates) { // Use first delegated wallet if set if(agwDelegates.length > 0) { return agwDelegates[0]; } } catch { // If delegation check fails, silently fall back to msgSender } // Return msgSender if delegation fails or no delegates found return msgSender; } function verify( Auth calldata auth, address tokenAddress, address account ) internal pure returns (bool) { // keys 0-255 and tokenAddress are public if (uint256(auth.key) <= 0xff || auth.key == keccak256(abi.encodePacked(tokenAddress))) { return true; } return MerkleProofLib.verify(auth.proof, auth.key, keccak256(abi.encodePacked(account))); } function _msgSender() internal view returns (address) { return msg.sender == BATCH ? tx.origin : msg.sender; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/Ownable.sol) import 'erc721a-upgradeable/contracts/ERC721A__Initializable.sol'; import 'erc721a-upgradeable/contracts/ERC721AUpgradeable.sol'; pragma solidity ^0.8.4; /** * @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 ERC721A__OwnableUpgradeable is ERC721A__Initializable, ERC721AUpgradeable { 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 onlyInitializingERC721A { __Ownable_init_unchained(); } function __Ownable_init_unchained() internal onlyInitializingERC721A { _transferOwnership(_msgSenderERC721A()); } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _isOwner(); _; } function _isOwner() internal view { require(owner() == _msgSenderERC721A(), "Ownable: caller is not the owner"); } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions anymore. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby removing any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } /** * @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 pragma solidity ^0.8.0; /** * @dev This is a base contract to aid in writing upgradeable diamond facet 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. * * 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. */ import {ERC721A__InitializableStorage} from './ERC721A__InitializableStorage.sol'; abstract contract ERC721A__Initializable { using ERC721A__InitializableStorage for ERC721A__InitializableStorage.Layout; /** * @dev Modifier to protect an initializer function from being invoked twice. */ modifier initializerERC721A() { // If the contract is initializing we ignore whether _initialized is set in order to support multiple // inheritance patterns, but we only do this in the context of a constructor, because in other contexts the // contract may have been reentered. require( ERC721A__InitializableStorage.layout()._initializing ? _isConstructor() : !ERC721A__InitializableStorage.layout()._initialized, 'ERC721A__Initializable: contract is already initialized' ); bool isTopLevelCall = !ERC721A__InitializableStorage.layout()._initializing; if (isTopLevelCall) { ERC721A__InitializableStorage.layout()._initializing = true; ERC721A__InitializableStorage.layout()._initialized = true; } _; if (isTopLevelCall) { ERC721A__InitializableStorage.layout()._initializing = false; } } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} modifier, directly or indirectly. */ modifier onlyInitializingERC721A() { require( ERC721A__InitializableStorage.layout()._initializing, 'ERC721A__Initializable: contract is not initializing' ); _; } /// @dev Returns true if and only if the function is running in the constructor function _isConstructor() private view returns (bool) { // extcodesize checks the size of the code stored in an address, and // address returns the current address. Since the code is still not // deployed when running a constructor, any checks on its code size will // yield zero, making it an effective way to detect if a contract is // under construction or not. address self = address(this); uint256 cs; assembly { cs := extcodesize(self) } return cs == 0; } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; import './IERC721AUpgradeable.sol'; import {ERC721AStorage} from './ERC721AStorage.sol'; import './ERC721A__Initializable.sol'; /** * @dev Interface of ERC721 token receiver. */ interface ERC721A__IERC721ReceiverUpgradeable { function onERC721Received( address operator, address from, uint256 tokenId, bytes calldata data ) external returns (bytes4); } /** * @title ERC721A * * @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721) * Non-Fungible Token Standard, including the Metadata extension. * Optimized for lower gas during batch mints. * * Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...) * starting from `_startTokenId()`. * * The `_sequentialUpTo()` function can be overriden to enable spot mints * (i.e. non-consecutive mints) for `tokenId`s greater than `_sequentialUpTo()`. * * Assumptions: * * - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply. * - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256). */ contract ERC721AUpgradeable is ERC721A__Initializable, IERC721AUpgradeable { using ERC721AStorage for ERC721AStorage.Layout; // ============================================================= // 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; // ============================================================= // CONSTRUCTOR // ============================================================= function __ERC721A_init(string memory name_, string memory symbol_) internal onlyInitializingERC721A { __ERC721A_init_unchained(name_, symbol_); } function __ERC721A_init_unchained(string memory name_, string memory symbol_) internal onlyInitializingERC721A { ERC721AStorage.layout()._name = name_; ERC721AStorage.layout()._symbol = symbol_; ERC721AStorage.layout()._currentIndex = _startTokenId(); if (_sequentialUpTo() < _startTokenId()) _revert(SequentialUpToTooSmall.selector); } // ============================================================= // TOKEN COUNTING OPERATIONS // ============================================================= /** * @dev Returns the starting token ID for sequential mints. * * Override this function to change the starting token ID for sequential mints. * * Note: The value returned must never change after any tokens have been minted. */ function _startTokenId() internal view virtual returns (uint256) { return 0; } /** * @dev Returns the maximum token ID (inclusive) for sequential mints. * * Override this function to return a value less than 2**256 - 1, * but greater than `_startTokenId()`, to enable spot (non-sequential) mints. * * Note: The value returned must never change after any tokens have been minted. */ function _sequentialUpTo() internal view virtual returns (uint256) { return type(uint256).max; } /** * @dev Returns the next token ID to be minted. */ function _nextTokenId() internal view virtual returns (uint256) { return ERC721AStorage.layout()._currentIndex; } /** * @dev Returns the total number of tokens in existence. * Burned tokens will reduce the count. * To get the total number of tokens minted, please see {_totalMinted}. */ function totalSupply() public view virtual override returns (uint256 result) { // Counter underflow is impossible as `_burnCounter` cannot be incremented // more than `_currentIndex + _spotMinted - _startTokenId()` times. unchecked { // With spot minting, the intermediate `result` can be temporarily negative, // and the computation must be unchecked. result = ERC721AStorage.layout()._currentIndex - ERC721AStorage.layout()._burnCounter - _startTokenId(); if (_sequentialUpTo() != type(uint256).max) result += ERC721AStorage.layout()._spotMinted; } } /** * @dev Returns the total amount of tokens minted in the contract. */ function _totalMinted() internal view virtual returns (uint256 result) { // Counter underflow is impossible as `_currentIndex` does not decrement, // and it is initialized to `_startTokenId()`. unchecked { result = ERC721AStorage.layout()._currentIndex - _startTokenId(); if (_sequentialUpTo() != type(uint256).max) result += ERC721AStorage.layout()._spotMinted; } } /** * @dev Returns the total number of tokens burned. */ function _totalBurned() internal view virtual returns (uint256) { return ERC721AStorage.layout()._burnCounter; } /** * @dev Returns the total number of tokens that are spot-minted. */ function _totalSpotMinted() internal view virtual returns (uint256) { return ERC721AStorage.layout()._spotMinted; } // ============================================================= // ADDRESS DATA OPERATIONS // ============================================================= /** * @dev Returns the number of tokens in `owner`'s account. */ function balanceOf(address owner) public view virtual override returns (uint256) { if (owner == address(0)) _revert(BalanceQueryForZeroAddress.selector); return ERC721AStorage.layout()._packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY; } /** * Returns the number of tokens minted by `owner`. */ function _numberMinted(address owner) internal view returns (uint256) { return (ERC721AStorage.layout()._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 (ERC721AStorage.layout()._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(ERC721AStorage.layout()._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 = ERC721AStorage.layout()._packedAddressData[owner]; uint256 auxCasted; // Cast `aux` with assembly to avoid redundant masking. assembly { auxCasted := aux } packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX); ERC721AStorage.layout()._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 ERC721AStorage.layout()._name; } /** * @dev Returns the token collection symbol. */ function symbol() public view virtual override returns (string memory) { return ERC721AStorage.layout()._symbol; } /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) public view virtual override returns (string memory) { if (!_exists(tokenId)) _revert(URIQueryForNonexistentToken.selector); string memory baseURI = _baseURI(); return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : ''; } /** * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each * token will be the concatenation of the `baseURI` and the `tokenId`. Empty * by default, it can be overridden in child contracts. */ function _baseURI() internal view virtual returns (string memory) { return ''; } // ============================================================= // OWNERSHIPS OPERATIONS // ============================================================= /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) public view virtual override returns (address) { return address(uint160(_packedOwnershipOf(tokenId))); } /** * @dev Gas spent here starts off proportional to the maximum mint batch size. * It gradually moves to O(1) as tokens get transferred around over time. */ function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(_packedOwnershipOf(tokenId)); } /** * @dev Returns the unpacked `TokenOwnership` struct at `index`. */ function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) { return _unpackedOwnership(ERC721AStorage.layout()._packedOwnerships[index]); } /** * @dev Returns whether the ownership slot at `index` is initialized. * An uninitialized slot does not necessarily mean that the slot has no owner. */ function _ownershipIsInitialized(uint256 index) internal view virtual returns (bool) { return ERC721AStorage.layout()._packedOwnerships[index] != 0; } /** * @dev Initializes the ownership slot minted at `index` for efficiency purposes. */ function _initializeOwnershipAt(uint256 index) internal virtual { if (ERC721AStorage.layout()._packedOwnerships[index] == 0) { ERC721AStorage.layout()._packedOwnerships[index] = _packedOwnershipOf(index); } } /** * @dev Returns the packed ownership data of `tokenId`. */ function _packedOwnershipOf(uint256 tokenId) private view returns (uint256 packed) { if (_startTokenId() <= tokenId) { packed = ERC721AStorage.layout()._packedOwnerships[tokenId]; if (tokenId > _sequentialUpTo()) { if (_packedOwnershipExists(packed)) return packed; _revert(OwnerQueryForNonexistentToken.selector); } // If the data at the starting slot does not exist, start the scan. if (packed == 0) { if (tokenId >= ERC721AStorage.layout()._currentIndex) _revert(OwnerQueryForNonexistentToken.selector); // Invariant: // There will always be an initialized ownership slot // (i.e. `ownership.addr != address(0) && ownership.burned == false`) // before an unintialized ownership slot // (i.e. `ownership.addr == address(0) && ownership.burned == false`) // Hence, `tokenId` will not underflow. // // We can directly compare the packed value. // If the address is zero, packed will be zero. for (;;) { unchecked { packed = ERC721AStorage.layout()._packedOwnerships[--tokenId]; } if (packed == 0) continue; if (packed & _BITMASK_BURNED == 0) return packed; // Otherwise, the token is burned, and we must revert. // This handles the case of batch burned tokens, where only the burned bit // of the starting slot is set, and remaining slots are left uninitialized. _revert(OwnerQueryForNonexistentToken.selector); } } // Otherwise, the data exists and we can skip the scan. // This is possible because we have already achieved the target condition. // This saves 2143 gas on transfers of initialized tokens. // If the token is not burned, return `packed`. Otherwise, revert. if (packed & _BITMASK_BURNED == 0) return packed; } _revert(OwnerQueryForNonexistentToken.selector); } /** * @dev Returns the unpacked `TokenOwnership` struct from `packed`. */ function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) { ownership.addr = address(uint160(packed)); ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP); ownership.burned = packed & _BITMASK_BURNED != 0; ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA); } /** * @dev Packs ownership data into a single uint256. */ function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`. result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags)) } } /** * @dev Returns the `nextInitialized` flag set if `quantity` equals 1. */ function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) { // For branchless setting of the `nextInitialized` flag. assembly { // `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`. result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1)) } } // ============================================================= // APPROVAL OPERATIONS // ============================================================= /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. See {ERC721A-_approve}. * * Requirements: * * - The caller must own the token or be an approved operator. */ function approve(address to, uint256 tokenId) public payable virtual override { _approve(to, tokenId, true); } /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) public view virtual override returns (address) { if (!_exists(tokenId)) _revert(ApprovalQueryForNonexistentToken.selector); return ERC721AStorage.layout()._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 { ERC721AStorage.layout()._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 ERC721AStorage.layout()._operatorApprovals[owner][operator]; } /** * @dev Returns whether `tokenId` exists. * * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}. * * Tokens start existing when they are minted. See {_mint}. */ function _exists(uint256 tokenId) internal view virtual returns (bool result) { if (_startTokenId() <= tokenId) { if (tokenId > _sequentialUpTo()) return _packedOwnershipExists(ERC721AStorage.layout()._packedOwnerships[tokenId]); if (tokenId < ERC721AStorage.layout()._currentIndex) { uint256 packed; while ((packed = ERC721AStorage.layout()._packedOwnerships[tokenId]) == 0) --tokenId; result = packed & _BITMASK_BURNED == 0; } } } /** * @dev Returns whether `packed` represents a token that exists. */ function _packedOwnershipExists(uint256 packed) private pure returns (bool result) { assembly { // The following is equivalent to `owner != address(0) && burned == false`. // Symbolically tested. result := gt(and(packed, _BITMASK_ADDRESS), and(packed, _BITMASK_BURNED)) } } /** * @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`. */ function _isSenderApprovedOrOwner( address approvedAddress, address owner, address msgSender ) private pure returns (bool result) { assembly { // Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean. owner := and(owner, _BITMASK_ADDRESS) // Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean. msgSender := and(msgSender, _BITMASK_ADDRESS) // `msgSender == owner || msgSender == approvedAddress`. result := or(eq(msgSender, owner), eq(msgSender, approvedAddress)) } } /** * @dev Returns the storage slot and value for the approved address of `tokenId`. */ function _getApprovedSlotAndAddress(uint256 tokenId) private view returns (uint256 approvedAddressSlot, address approvedAddress) { ERC721AStorage.TokenApprovalRef storage tokenApproval = ERC721AStorage.layout()._tokenApprovals[tokenId]; // The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`. assembly { approvedAddressSlot := tokenApproval.slot approvedAddress := sload(approvedAddressSlot) } } // ============================================================= // TRANSFER OPERATIONS // ============================================================= /** * @dev Transfers `tokenId` from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) public payable virtual override { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); // Mask `from` to the lower 160 bits, in case the upper bits somehow aren't clean. from = address(uint160(uint256(uint160(from)) & _BITMASK_ADDRESS)); if (address(uint160(prevOwnershipPacked)) != from) _revert(TransferFromIncorrectOwner.selector); (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId); // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A())) if (!isApprovedForAll(from, _msgSenderERC721A())) _revert(TransferCallerNotOwnerNorApproved.selector); _beforeTokenTransfers(from, to, tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // We can directly increment and decrement the balances. --ERC721AStorage.layout()._packedAddressData[from]; // Updates: `balance -= 1`. ++ERC721AStorage.layout()._packedAddressData[to]; // Updates: `balance += 1`. // Updates: // - `address` to the next owner. // - `startTimestamp` to the timestamp of transfering. // - `burned` to `false`. // - `nextInitialized` to `true`. ERC721AStorage.layout()._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 (ERC721AStorage.layout()._packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != ERC721AStorage.layout()._currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. ERC721AStorage.layout()._packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS; assembly { // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. from, // `from`. toMasked, // `to`. tokenId // `tokenId`. ) } if (toMasked == 0) _revert(TransferToZeroAddress.selector); _afterTokenTransfers(from, to, tokenId, 1); } /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom( address from, address to, uint256 tokenId ) public payable virtual override { safeTransferFrom(from, to, tokenId, ''); } /** * @dev Safely transfers `tokenId` token from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes memory _data ) public payable virtual override { transferFrom(from, to, tokenId); if (to.code.length != 0) if (!_checkContractOnERC721Received(from, to, tokenId, _data)) { _revert(TransferToNonERC721ReceiverImplementer.selector); } } /** * @dev Hook that is called before a set of serially-ordered token IDs * are about to be transferred. This includes minting. * And also called before burning one token. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _beforeTokenTransfers( address from, address to, uint256 startTokenId, uint256 quantity ) internal virtual {} /** * @dev Hook that is called after a set of serially-ordered token IDs * have been transferred. This includes minting. * And also called after one token has been burned. * * `startTokenId` - the first token ID to be transferred. * `quantity` - the amount to be transferred. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` has been * transferred to `to`. * - When `from` is zero, `tokenId` has been minted for `to`. * - When `to` is zero, `tokenId` has been burned by `from`. * - `from` and `to` are never both zero. */ function _afterTokenTransfers( address from, address to, uint256 startTokenId, uint256 quantity ) internal virtual {} /** * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract. * * `from` - Previous owner of the given token ID. * `to` - Target address that will receive the token. * `tokenId` - Token ID to be transferred. * `_data` - Optional data to send along with the call. * * Returns whether the call correctly returned the expected magic value. */ function _checkContractOnERC721Received( address from, address to, uint256 tokenId, bytes memory _data ) private returns (bool) { try ERC721A__IERC721ReceiverUpgradeable(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns (bytes4 retval) { return retval == ERC721A__IERC721ReceiverUpgradeable(to).onERC721Received.selector; } catch (bytes memory reason) { if (reason.length == 0) { _revert(TransferToNonERC721ReceiverImplementer.selector); } assembly { revert(add(32, reason), mload(reason)) } } } // ============================================================= // MINT OPERATIONS // ============================================================= /** * @dev Mints `quantity` tokens and transfers them to `to`. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {Transfer} event for each mint. */ function _mint(address to, uint256 quantity) internal virtual { uint256 startTokenId = ERC721AStorage.layout()._currentIndex; if (quantity == 0) _revert(MintZeroQuantity.selector); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are incredibly unrealistic. // `balance` and `numberMinted` have a maximum limit of 2**64. // `tokenId` has a maximum limit of 2**256. unchecked { // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `quantity == 1`. ERC721AStorage.layout()._packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. ERC721AStorage.layout()._packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1); // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS; if (toMasked == 0) _revert(MintToZeroAddress.selector); uint256 end = startTokenId + quantity; uint256 tokenId = startTokenId; if (end - 1 > _sequentialUpTo()) _revert(SequentialMintExceedsLimit.selector); do { assembly { // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. 0, // `address(0)`. toMasked, // `to`. tokenId // `tokenId`. ) } // The `!=` check ensures that large values of `quantity` // that overflows uint256 will make the loop run out of gas. } while (++tokenId != end); ERC721AStorage.layout()._currentIndex = end; } _afterTokenTransfers(address(0), to, startTokenId, quantity); } /** * @dev Mints `quantity` tokens and transfers them to `to`. * * This function is intended for efficient minting only during contract creation. * * It emits only one {ConsecutiveTransfer} as defined in * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309), * instead of a sequence of {Transfer} event(s). * * Calling this function outside of contract creation WILL make your contract * non-compliant with the ERC721 standard. * For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309 * {ConsecutiveTransfer} event is only permissible during contract creation. * * Requirements: * * - `to` cannot be the zero address. * - `quantity` must be greater than 0. * * Emits a {ConsecutiveTransfer} event. */ function _mintERC2309(address to, uint256 quantity) internal virtual { uint256 startTokenId = ERC721AStorage.layout()._currentIndex; if (to == address(0)) _revert(MintToZeroAddress.selector); if (quantity == 0) _revert(MintZeroQuantity.selector); if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) _revert(MintERC2309QuantityExceedsLimit.selector); _beforeTokenTransfers(address(0), to, startTokenId, quantity); // Overflows are unrealistic due to the above check for `quantity` to be below the limit. unchecked { // Updates: // - `balance += quantity`. // - `numberMinted += quantity`. // // We can directly add to the `balance` and `numberMinted`. ERC721AStorage.layout()._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`. ERC721AStorage.layout()._packedOwnerships[startTokenId] = _packOwnershipData( to, _nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0) ); if (startTokenId + quantity - 1 > _sequentialUpTo()) _revert(SequentialMintExceedsLimit.selector); emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to); ERC721AStorage.layout()._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 = ERC721AStorage.layout()._currentIndex; uint256 index = end - quantity; do { if (!_checkContractOnERC721Received(address(0), to, index++, _data)) { _revert(TransferToNonERC721ReceiverImplementer.selector); } } while (index < end); // This prevents reentrancy to `_safeMint`. // It does not prevent reentrancy to `_safeMintSpot`. if (ERC721AStorage.layout()._currentIndex != end) revert(); } } } /** * @dev Equivalent to `_safeMint(to, quantity, '')`. */ function _safeMint(address to, uint256 quantity) internal virtual { _safeMint(to, quantity, ''); } /** * @dev Mints a single token at `tokenId`. * * Note: A spot-minted `tokenId` that has been burned can be re-minted again. * * Requirements: * * - `to` cannot be the zero address. * - `tokenId` must be greater than `_sequentialUpTo()`. * - `tokenId` must not exist. * * Emits a {Transfer} event for each mint. */ function _mintSpot(address to, uint256 tokenId) internal virtual { if (tokenId <= _sequentialUpTo()) _revert(SpotMintTokenIdTooSmall.selector); uint256 prevOwnershipPacked = ERC721AStorage.layout()._packedOwnerships[tokenId]; if (_packedOwnershipExists(prevOwnershipPacked)) _revert(TokenAlreadyExists.selector); _beforeTokenTransfers(address(0), to, tokenId, 1); // Overflows are incredibly unrealistic. // The `numberMinted` for `to` is incremented by 1, and has a max limit of 2**64 - 1. // `_spotMinted` is incremented by 1, and has a max limit of 2**256 - 1. unchecked { // Updates: // - `address` to the owner. // - `startTimestamp` to the timestamp of minting. // - `burned` to `false`. // - `nextInitialized` to `true` (as `quantity == 1`). ERC721AStorage.layout()._packedOwnerships[tokenId] = _packOwnershipData( to, _nextInitializedFlag(1) | _nextExtraData(address(0), to, prevOwnershipPacked) ); // Updates: // - `balance += 1`. // - `numberMinted += 1`. // // We can directly add to the `balance` and `numberMinted`. ERC721AStorage.layout()._packedAddressData[to] += (1 << _BITPOS_NUMBER_MINTED) | 1; // Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean. uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS; if (toMasked == 0) _revert(MintToZeroAddress.selector); assembly { // Emit the `Transfer` event. log4( 0, // Start of data (0, since no data). 0, // End of data (0, since no data). _TRANSFER_EVENT_SIGNATURE, // Signature. 0, // `address(0)`. toMasked, // `to`. tokenId // `tokenId`. ) } ++ERC721AStorage.layout()._spotMinted; } _afterTokenTransfers(address(0), to, tokenId, 1); } /** * @dev Safely mints a single token at `tokenId`. * * Note: A spot-minted `tokenId` that has been burned can be re-minted again. * * Requirements: * * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}. * - `tokenId` must be greater than `_sequentialUpTo()`. * - `tokenId` must not exist. * * See {_mintSpot}. * * Emits a {Transfer} event. */ function _safeMintSpot( address to, uint256 tokenId, bytes memory _data ) internal virtual { _mintSpot(to, tokenId); unchecked { if (to.code.length != 0) { uint256 currentSpotMinted = ERC721AStorage.layout()._spotMinted; if (!_checkContractOnERC721Received(address(0), to, tokenId, _data)) { _revert(TransferToNonERC721ReceiverImplementer.selector); } // This prevents reentrancy to `_safeMintSpot`. // It does not prevent reentrancy to `_safeMint`. if (ERC721AStorage.layout()._spotMinted != currentSpotMinted) revert(); } } } /** * @dev Equivalent to `_safeMintSpot(to, tokenId, '')`. */ function _safeMintSpot(address to, uint256 tokenId) internal virtual { _safeMintSpot(to, tokenId, ''); } // ============================================================= // APPROVAL OPERATIONS // ============================================================= /** * @dev Equivalent to `_approve(to, tokenId, false)`. */ function _approve(address to, uint256 tokenId) internal virtual { _approve(to, tokenId, false); } /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the * zero address clears previous approvals. * * Requirements: * * - `tokenId` must exist. * * Emits an {Approval} event. */ function _approve( address to, uint256 tokenId, bool approvalCheck ) internal virtual { address owner = ownerOf(tokenId); if (approvalCheck && _msgSenderERC721A() != owner) if (!isApprovedForAll(owner, _msgSenderERC721A())) { _revert(ApprovalCallerNotOwnerNorApproved.selector); } ERC721AStorage.layout()._tokenApprovals[tokenId].value = to; emit Approval(owner, to, tokenId); } // ============================================================= // BURN OPERATIONS // ============================================================= /** * @dev Equivalent to `_burn(tokenId, false)`. */ function _burn(uint256 tokenId) internal virtual { _burn(tokenId, false); } /** * @dev Destroys `tokenId`. * The approval is cleared when the token is burned. * * Requirements: * * - `tokenId` must exist. * * Emits a {Transfer} event. */ function _burn(uint256 tokenId, bool approvalCheck) internal virtual { uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId); address from = address(uint160(prevOwnershipPacked)); (uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId); if (approvalCheck) { // The nested ifs save around 20+ gas over a compound boolean condition. if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A())) if (!isApprovedForAll(from, _msgSenderERC721A())) _revert(TransferCallerNotOwnerNorApproved.selector); } _beforeTokenTransfers(from, address(0), tokenId, 1); // Clear approvals from the previous owner. assembly { if approvedAddress { // This is equivalent to `delete _tokenApprovals[tokenId]`. sstore(approvedAddressSlot, 0) } } // Underflow of the sender's balance is impossible because we check for // ownership above and the recipient's balance can't realistically overflow. // Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256. unchecked { // Updates: // - `balance -= 1`. // - `numberBurned += 1`. // // We can directly decrement the balance, and increment the number burned. // This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`. ERC721AStorage.layout()._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`. ERC721AStorage.layout()._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 (ERC721AStorage.layout()._packedOwnerships[nextTokenId] == 0) { // If the next slot is within bounds. if (nextTokenId != ERC721AStorage.layout()._currentIndex) { // Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`. ERC721AStorage.layout()._packedOwnerships[nextTokenId] = prevOwnershipPacked; } } } } emit Transfer(from, address(0), tokenId); _afterTokenTransfers(from, address(0), tokenId, 1); // Overflow not possible, as `_burnCounter` cannot be exceed `_currentIndex + _spotMinted` times. unchecked { ERC721AStorage.layout()._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 = ERC721AStorage.layout()._packedOwnerships[index]; if (packed == 0) _revert(OwnershipNotInitializedForExtraData.selector); uint256 extraDataCasted; // Cast `extraData` with assembly to avoid redundant masking. assembly { extraDataCasted := extraData } packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA); ERC721AStorage.layout()._packedOwnerships[index] = packed; } /** * @dev Called during each token transfer to set the 24bit `extraData` field. * Intended to be overridden by the cosumer contract. * * `previousExtraData` - the value of `extraData` before transfer. * * Calling conditions: * * - When `from` and `to` are both non-zero, `from`'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, `tokenId` will be burned by `from`. * - `from` and `to` are never both zero. */ function _extraData( address from, address to, uint24 previousExtraData ) internal view virtual returns (uint24) {} /** * @dev Returns the next extra data for the packed ownership data. * The returned result is shifted into position. */ function _nextExtraData( address from, address to, uint256 prevOwnershipPacked ) private view returns (uint256) { uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA); return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA; } // ============================================================= // OTHER OPERATIONS // ============================================================= /** * @dev Returns the message sender (defaults to `msg.sender`). * * If you are writing GSN compatible contracts, you need to override this function. */ function _msgSenderERC721A() internal view virtual returns (address) { return msg.sender; } /** * @dev Converts a uint256 to its ASCII string decimal representation. */ function _toString(uint256 value) internal pure virtual returns (string memory str) { assembly { // The maximum value of a uint256 contains 78 digits (1 byte per digit), but // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned. // We will need 1 word for the trailing zeros padding, 1 word for the length, // and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0. let m := add(mload(0x40), 0xa0) // Update the free memory pointer to allocate. mstore(0x40, m) // Assign the `str` to the end. str := sub(m, 0x20) // Zeroize the slot after the string. mstore(str, 0) // Cache the end of the memory to calculate the length later. let end := str // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. // prettier-ignore for { let temp := value } 1 {} { str := sub(str, 1) // Write the character to the pointer. // The ASCII index of the '0' character is 48. mstore8(str, add(48, mod(temp, 10))) // Keep dividing `temp` until zero. temp := div(temp, 10) // prettier-ignore if iszero(temp) { break } } let length := sub(end, str) // Move the pointer 32 bytes leftwards to make room for the length. str := sub(str, 0x20) // Store the length. mstore(str, length) } } /** * @dev For more efficient reverts. */ function _revert(bytes4 errorSelector) internal pure { assembly { mstore(0x00, errorSelector) revert(0x00, 0x04) } } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; import './IERC721AQueryableUpgradeable.sol'; import '../ERC721AUpgradeable.sol'; import '../ERC721A__Initializable.sol'; /** * @title ERC721AQueryable. * * @dev ERC721A subclass with convenience query functions. */ abstract contract ERC721AQueryableUpgradeable is ERC721A__Initializable, ERC721AUpgradeable, IERC721AQueryableUpgradeable { function __ERC721AQueryable_init() internal onlyInitializingERC721A { __ERC721AQueryable_init_unchained(); } function __ERC721AQueryable_init_unchained() internal onlyInitializingERC721A {} /** * @dev Returns the `TokenOwnership` struct at `tokenId` without reverting. * * If the `tokenId` is out of bounds: * * - `addr = address(0)` * - `startTimestamp = 0` * - `burned = false` * - `extraData = 0` * * If the `tokenId` is burned: * * - `addr = <Address of owner before token was burned>` * - `startTimestamp = <Timestamp when token was burned>` * - `burned = true` * - `extraData = <Extra data when token was burned>` * * Otherwise: * * - `addr = <Address of owner>` * - `startTimestamp = <Timestamp of start of ownership>` * - `burned = false` * - `extraData = <Extra data at start of ownership>` */ function explicitOwnershipOf(uint256 tokenId) public view virtual override returns (TokenOwnership memory ownership) { unchecked { if (tokenId >= _startTokenId()) { if (tokenId > _sequentialUpTo()) return _ownershipAt(tokenId); if (tokenId < _nextTokenId()) { // If the `tokenId` is within bounds, // scan backwards for the initialized ownership slot. while (!_ownershipIsInitialized(tokenId)) --tokenId; return _ownershipAt(tokenId); } } } } /** * @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order. * See {ERC721AQueryable-explicitOwnershipOf} */ function explicitOwnershipsOf(uint256[] calldata tokenIds) external view virtual override returns (TokenOwnership[] memory) { TokenOwnership[] memory ownerships; uint256 i = tokenIds.length; assembly { // Grab the free memory pointer. ownerships := mload(0x40) // Store the length. mstore(ownerships, i) // Allocate one word for the length, // `tokenIds.length` words for the pointers. i := shl(5, i) // Multiply `i` by 32. mstore(0x40, add(add(ownerships, 0x20), i)) } while (i != 0) { uint256 tokenId; assembly { i := sub(i, 0x20) tokenId := calldataload(add(tokenIds.offset, i)) } TokenOwnership memory ownership = explicitOwnershipOf(tokenId); assembly { // Store the pointer of `ownership` in the `ownerships` array. mstore(add(add(ownerships, 0x20), i), ownership) } } return ownerships; } /** * @dev Returns an array of token IDs owned by `owner`, * in the range [`start`, `stop`) * (i.e. `start <= tokenId < stop`). * * This function allows for tokens to be queried if the collection * grows too big for a single call of {ERC721AQueryable-tokensOfOwner}. * * Requirements: * * - `start < stop` */ function tokensOfOwnerIn( address owner, uint256 start, uint256 stop ) external view virtual override returns (uint256[] memory) { return _tokensOfOwnerIn(owner, start, stop); } /** * @dev Returns an array of token IDs owned by `owner`. * * This function scans the ownership mapping and is O(`totalSupply`) in complexity. * It is meant to be called off-chain. * * See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into * multiple smaller scans if the collection is large enough to cause * an out-of-gas error (10K collections should be fine). */ function tokensOfOwner(address owner) external view virtual override returns (uint256[] memory) { // If spot mints are enabled, full-range scan is disabled. if (_sequentialUpTo() != type(uint256).max) _revert(NotCompatibleWithSpotMints.selector); uint256 start = _startTokenId(); uint256 stop = _nextTokenId(); uint256[] memory tokenIds; if (start != stop) tokenIds = _tokensOfOwnerIn(owner, start, stop); return tokenIds; } /** * @dev Helper function for returning an array of token IDs owned by `owner`. * * Note that this function is optimized for smaller bytecode size over runtime gas, * since it is meant to be called off-chain. */ function _tokensOfOwnerIn( address owner, uint256 start, uint256 stop ) private view returns (uint256[] memory tokenIds) { unchecked { if (start >= stop) _revert(InvalidQueryRange.selector); // Set `start = max(start, _startTokenId())`. if (start < _startTokenId()) start = _startTokenId(); uint256 nextTokenId = _nextTokenId(); // If spot mints are enabled, scan all the way until the specified `stop`. uint256 stopLimit = _sequentialUpTo() != type(uint256).max ? stop : nextTokenId; // Set `stop = min(stop, stopLimit)`. if (stop >= stopLimit) stop = stopLimit; // Number of tokens to scan. uint256 tokenIdsMaxLength = balanceOf(owner); // Set `tokenIdsMaxLength` to zero if the range contains no tokens. if (start >= stop) tokenIdsMaxLength = 0; // If there are one or more tokens to scan. if (tokenIdsMaxLength != 0) { // Set `tokenIdsMaxLength = min(balanceOf(owner), tokenIdsMaxLength)`. if (stop - start <= tokenIdsMaxLength) tokenIdsMaxLength = stop - start; uint256 m; // Start of available memory. assembly { // Grab the free memory pointer. tokenIds := mload(0x40) // Allocate one word for the length, and `tokenIdsMaxLength` words // for the data. `shl(5, x)` is equivalent to `mul(32, x)`. m := add(tokenIds, shl(5, add(tokenIdsMaxLength, 1))) mstore(0x40, m) } // We need to call `explicitOwnershipOf(start)`, // because the slot at `start` may not be initialized. TokenOwnership memory ownership = explicitOwnershipOf(start); address currOwnershipAddr; // If the starting slot exists (i.e. not burned), // initialize `currOwnershipAddr`. // `ownership.address` will not be zero, // as `start` is clamped to the valid token ID range. if (!ownership.burned) currOwnershipAddr = ownership.addr; uint256 tokenIdsIdx; // Use a do-while, which is slightly more efficient for this case, // as the array will at least contain one element. do { if (_sequentialUpTo() != type(uint256).max) { // Skip the remaining unused sequential slots. if (start == nextTokenId) start = _sequentialUpTo() + 1; // Reset `currOwnershipAddr`, as each spot-minted token is a batch of one. if (start > _sequentialUpTo()) currOwnershipAddr = address(0); } ownership = _ownershipAt(start); // This implicitly allocates memory. assembly { switch mload(add(ownership, 0x40)) // if `ownership.burned == false`. case 0 { // if `ownership.addr != address(0)`. // The `addr` already has it's upper 96 bits clearned, // since it is written to memory with regular Solidity. if mload(ownership) { currOwnershipAddr := mload(ownership) } // if `currOwnershipAddr == owner`. // The `shl(96, x)` is to make the comparison agnostic to any // dirty upper 96 bits in `owner`. if iszero(shl(96, xor(currOwnershipAddr, owner))) { tokenIdsIdx := add(tokenIdsIdx, 1) mstore(add(tokenIds, shl(5, tokenIdsIdx)), start) } } // Otherwise, reset `currOwnershipAddr`. // This handles the case of batch burned tokens // (burned bit of first slot set, remaining slots left uninitialized). default { currOwnershipAddr := 0 } start := add(start, 1) // Free temporary memory implicitly allocated for ownership // to avoid quadratic memory expansion costs. mstore(0x40, m) } } while (!(start == stop || tokenIdsIdx == tokenIdsMaxLength)); // Store the length of the array. assembly { mstore(tokenIds, tokenIdsIdx) } } } } }
// SPDX-License-Identifier: MIT pragma solidity 0.8.28; import {IDelegateRegistry} from "./interfaces/IDelegateRegistry.sol"; interface IExclusiveDelegateResolver { function DELEGATE_REGISTRY() external view returns (address); function GLOBAL_DELEGATION() external view returns (bytes24); function exclusiveWalletByRights(address vault, bytes24 rights) external view returns (address wallet); function delegatedWalletsByRights(address wallet, bytes24 rights) external view returns (address[] memory wallets); function exclusiveOwnerByRights(address contractAddress, uint256 tokenId, bytes24 rights) external view returns (address owner); function decodeRightsExpiration(bytes32 rights) external pure returns (bytes24 rightsIdentifier, uint40 expiration); function generateRightsWithExpiration(bytes24 rightsIdentifier, uint40 expiration) external pure returns (bytes32); }
// SPDX-License-Identifier: MIT // ArchetypePayouts v0.7.0 // // d8888 888 888 // d88888 888 888 // d88P888 888 888 // d88P 888 888d888 .d8888b 88888b. .d88b. 888888 888 888 88888b. .d88b. // d88P 888 888P" d88P" 888 "88b d8P Y8b 888 888 888 888 "88b d8P Y8b // d88P 888 888 888 888 888 88888888 888 888 888 888 888 88888888 // d8888888888 888 Y88b. 888 888 Y8b. Y88b. Y88b 888 888 d88P Y8b. // d88P 888 888 "Y8888P 888 888 "Y8888 "Y888 "Y88888 88888P" "Y8888 // 888 888 // Y8b d88P 888 // pragma solidity ^0.8.4; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; error InvalidLength(); error InvalidSplitShares(); error TransferFailed(); error BalanceEmpty(); error NotApprovedToWithdraw(); contract ArchetypePayouts { event Withdrawal(address indexed src, address token, uint256 wad); event FundsAdded(address indexed recipient, address token, uint256 amount); mapping(address => mapping(address => uint256)) private _balance; mapping(address => mapping(address => bool)) private _approvals; function updateBalances( uint256 totalAmount, address token, address[] calldata recipients, uint16[] calldata splits ) public payable { if (recipients.length != splits.length) { revert InvalidLength(); } uint256 totalShares = 0; for (uint256 i = 0; i < splits.length; i++) { totalShares += splits[i]; } if (totalShares != 10000) { revert InvalidSplitShares(); } if (token == address(0)) { // ETH payments uint256 totalReceived = msg.value; for (uint256 i = 0; i < recipients.length; i++) { if (splits[i] > 0) { uint256 amountToAdd = (totalReceived * splits[i]) / 10000; _balance[recipients[i]][token] += amountToAdd; emit FundsAdded(recipients[i], token, amountToAdd); } } } else { // ERC20 payments IERC20 paymentToken = IERC20(token); bool success = paymentToken.transferFrom(msg.sender, address(this), totalAmount); if (!success) { revert TransferFailed(); } for (uint256 i = 0; i < recipients.length; i++) { if (splits[i] > 0) { uint256 amountToAdd = (totalAmount * splits[i]) / 10000; _balance[recipients[i]][token] += amountToAdd; emit FundsAdded(recipients[i], token, amountToAdd); } } } } function withdraw() external { address msgSender = msg.sender; _withdraw(msgSender, msgSender, address(0)); } function withdrawTokens(address[] memory tokens) external { address msgSender = msg.sender; for (uint256 i = 0; i < tokens.length; i++) { _withdraw(msgSender, msgSender, tokens[i]); } } function withdrawFrom(address from, address to) public { if (from != msg.sender && !_approvals[from][to]) { revert NotApprovedToWithdraw(); } _withdraw(from, to, address(0)); } function withdrawTokensFrom( address from, address to, address[] memory tokens ) public { if (from != msg.sender && !_approvals[from][to]) { revert NotApprovedToWithdraw(); } for (uint256 i = 0; i < tokens.length; i++) { _withdraw(from, to, tokens[i]); } } function _withdraw( address from, address to, address token ) internal { uint256 wad; wad = _balance[from][token]; _balance[from][token] = 0; if (wad == 0) { revert BalanceEmpty(); } if (token == address(0)) { bool success = false; (success, ) = to.call{ value: wad }(""); if (!success) { revert TransferFailed(); } } else { IERC20 erc20Token = IERC20(token); bool success = erc20Token.transfer(to, wad); if (!success) { revert TransferFailed(); } } emit Withdrawal(from, token, wad); } function approveWithdrawal(address delegate, bool approved) external { _approvals[msg.sender][delegate] = approved; } function isApproved(address from, address delegate) external view returns (bool) { return _approvals[from][delegate]; } function balance(address recipient) external view returns (uint256) { return _balance[recipient][address(0)]; } function balanceToken(address recipient, address token) external view returns (uint256) { return _balance[recipient][token]; } }
// 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 {Initializable} from "../../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 { struct RoyaltyInfo { address receiver; uint96 royaltyFraction; } RoyaltyInfo private _defaultRoyaltyInfo; mapping(uint256 => RoyaltyInfo) private _tokenRoyaltyInfo; function __ERC2981_init() internal onlyInitializing { } function __ERC2981_init_unchained() internal onlyInitializing { } /** * @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 pragma solidity ^0.8.4; /// @notice Library for converting numbers into strings and other string operations. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/LibString.sol) /// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/LibString.sol) /// /// @dev Note: /// For performance and bytecode compactness, most of the string operations are restricted to /// byte strings (7-bit ASCII), except where otherwise specified. /// Usage of byte string operations on charsets with runes spanning two or more bytes /// can lead to undefined behavior. library LibString { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The length of the output is too small to contain all the hex digits. error HexLengthInsufficient(); /// @dev The length of the string is more than 32 bytes. error TooBigForSmallString(); /// @dev The input string must be a 7-bit ASCII. error StringNot7BitASCII(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CONSTANTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The constant returned when the `search` is not found in the string. uint256 internal constant NOT_FOUND = type(uint256).max; /// @dev Lookup for '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'. uint128 internal constant ALPHANUMERIC_7_BIT_ASCII = 0x7fffffe07fffffe03ff000000000000; /// @dev Lookup for 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'. uint128 internal constant LETTERS_7_BIT_ASCII = 0x7fffffe07fffffe0000000000000000; /// @dev Lookup for 'abcdefghijklmnopqrstuvwxyz'. uint128 internal constant LOWERCASE_7_BIT_ASCII = 0x7fffffe000000000000000000000000; /// @dev Lookup for 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'. uint128 internal constant UPPERCASE_7_BIT_ASCII = 0x7fffffe0000000000000000; /// @dev Lookup for '0123456789'. uint128 internal constant DIGITS_7_BIT_ASCII = 0x3ff000000000000; /// @dev Lookup for '0123456789abcdefABCDEF'. uint128 internal constant HEXDIGITS_7_BIT_ASCII = 0x7e0000007e03ff000000000000; /// @dev Lookup for '01234567'. uint128 internal constant OCTDIGITS_7_BIT_ASCII = 0xff000000000000; /// @dev Lookup for '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~ \t\n\r\x0b\x0c'. uint128 internal constant PRINTABLE_7_BIT_ASCII = 0x7fffffffffffffffffffffff00003e00; /// @dev Lookup for '!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~'. uint128 internal constant PUNCTUATION_7_BIT_ASCII = 0x78000001f8000001fc00fffe00000000; /// @dev Lookup for ' \t\n\r\x0b\x0c'. uint128 internal constant WHITESPACE_7_BIT_ASCII = 0x100003e00; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* DECIMAL OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns the base 10 decimal representation of `value`. function toString(uint256 value) internal pure returns (string memory result) { /// @solidity memory-safe-assembly 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. result := add(mload(0x40), 0x80) mstore(0x40, add(result, 0x20)) // Allocate memory. mstore(result, 0) // Zeroize the slot after the string. let end := result // Cache the end of the memory to calculate the length later. let w := not(0) // Tsk. // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. for { let temp := value } 1 {} { result := add(result, w) // `sub(result, 1)`. // Store the character to the pointer. // The ASCII index of the '0' character is 48. mstore8(result, add(48, mod(temp, 10))) temp := div(temp, 10) // Keep dividing `temp` until zero. if iszero(temp) { break } } let n := sub(end, result) result := sub(result, 0x20) // Move the pointer 32 bytes back to make room for the length. mstore(result, n) // Store the length. } } /// @dev Returns the base 10 decimal representation of `value`. function toString(int256 value) internal pure returns (string memory result) { if (value >= 0) return toString(uint256(value)); unchecked { result = toString(~uint256(value) + 1); } /// @solidity memory-safe-assembly assembly { // We still have some spare memory space on the left, // as we have allocated 3 words (96 bytes) for up to 78 digits. let n := mload(result) // Load the string length. mstore(result, 0x2d) // Store the '-' character. result := sub(result, 1) // Move back the string pointer by a byte. mstore(result, add(n, 1)) // Update the string length. } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* HEXADECIMAL OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns the hexadecimal representation of `value`, /// left-padded to an input length of `length` bytes. /// The output is prefixed with "0x" encoded using 2 hexadecimal digits per byte, /// giving a total length of `length * 2 + 2` bytes. /// Reverts if `length` is too small for the output to contain all the digits. function toHexString(uint256 value, uint256 length) internal pure returns (string memory result) { result = toHexStringNoPrefix(value, length); /// @solidity memory-safe-assembly assembly { let n := add(mload(result), 2) // Compute the length. mstore(result, 0x3078) // Store the "0x" prefix. result := sub(result, 2) // Move the pointer. mstore(result, n) // Store the length. } } /// @dev Returns the hexadecimal representation of `value`, /// left-padded to an input length of `length` bytes. /// The output is not prefixed with "0x" and is encoded using 2 hexadecimal digits per byte, /// giving a total length of `length * 2` bytes. /// Reverts if `length` is too small for the output to contain all the digits. function toHexStringNoPrefix(uint256 value, uint256 length) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { // We need 0x20 bytes for the trailing zeros padding, `length * 2` bytes // for the digits, 0x02 bytes for the prefix, and 0x20 bytes for the length. // We add 0x20 to the total and round down to a multiple of 0x20. // (0x20 + 0x20 + 0x02 + 0x20) = 0x62. result := add(mload(0x40), and(add(shl(1, length), 0x42), not(0x1f))) mstore(0x40, add(result, 0x20)) // Allocate memory. mstore(result, 0) // Zeroize the slot after the string. let end := result // Cache the end to calculate the length later. // Store "0123456789abcdef" in scratch space. mstore(0x0f, 0x30313233343536373839616263646566) let start := sub(result, add(length, length)) let w := not(1) // Tsk. let temp := value // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. for {} 1 {} { result := add(result, w) // `sub(result, 2)`. mstore8(add(result, 1), mload(and(temp, 15))) mstore8(result, mload(and(shr(4, temp), 15))) temp := shr(8, temp) if iszero(xor(result, start)) { break } } if temp { mstore(0x00, 0x2194895a) // `HexLengthInsufficient()`. revert(0x1c, 0x04) } let n := sub(end, result) result := sub(result, 0x20) mstore(result, n) // Store the length. } } /// @dev Returns the hexadecimal representation of `value`. /// The output is prefixed with "0x" and encoded using 2 hexadecimal digits per byte. /// As address are 20 bytes long, the output will left-padded to have /// a length of `20 * 2 + 2` bytes. function toHexString(uint256 value) internal pure returns (string memory result) { result = toHexStringNoPrefix(value); /// @solidity memory-safe-assembly assembly { let n := add(mload(result), 2) // Compute the length. mstore(result, 0x3078) // Store the "0x" prefix. result := sub(result, 2) // Move the pointer. mstore(result, n) // Store the length. } } /// @dev Returns the hexadecimal representation of `value`. /// The output is prefixed with "0x". /// The output excludes leading "0" from the `toHexString` output. /// `0x00: "0x0", 0x01: "0x1", 0x12: "0x12", 0x123: "0x123"`. function toMinimalHexString(uint256 value) internal pure returns (string memory result) { result = toHexStringNoPrefix(value); /// @solidity memory-safe-assembly assembly { let o := eq(byte(0, mload(add(result, 0x20))), 0x30) // Whether leading zero is present. let n := add(mload(result), 2) // Compute the length. mstore(add(result, o), 0x3078) // Store the "0x" prefix, accounting for leading zero. result := sub(add(result, o), 2) // Move the pointer, accounting for leading zero. mstore(result, sub(n, o)) // Store the length, accounting for leading zero. } } /// @dev Returns the hexadecimal representation of `value`. /// The output excludes leading "0" from the `toHexStringNoPrefix` output. /// `0x00: "0", 0x01: "1", 0x12: "12", 0x123: "123"`. function toMinimalHexStringNoPrefix(uint256 value) internal pure returns (string memory result) { result = toHexStringNoPrefix(value); /// @solidity memory-safe-assembly assembly { let o := eq(byte(0, mload(add(result, 0x20))), 0x30) // Whether leading zero is present. let n := mload(result) // Get the length. result := add(result, o) // Move the pointer, accounting for leading zero. mstore(result, sub(n, o)) // Store the length, accounting for leading zero. } } /// @dev Returns the hexadecimal representation of `value`. /// The output is encoded using 2 hexadecimal digits per byte. /// As address are 20 bytes long, the output will left-padded to have /// a length of `20 * 2` bytes. function toHexStringNoPrefix(uint256 value) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { // We need 0x20 bytes for the trailing zeros padding, 0x20 bytes for the length, // 0x02 bytes for the prefix, and 0x40 bytes for the digits. // The next multiple of 0x20 above (0x20 + 0x20 + 0x02 + 0x40) is 0xa0. result := add(mload(0x40), 0x80) mstore(0x40, add(result, 0x20)) // Allocate memory. mstore(result, 0) // Zeroize the slot after the string. let end := result // Cache the end to calculate the length later. mstore(0x0f, 0x30313233343536373839616263646566) // Store the "0123456789abcdef" lookup. let w := not(1) // Tsk. // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. for { let temp := value } 1 {} { result := add(result, w) // `sub(result, 2)`. mstore8(add(result, 1), mload(and(temp, 15))) mstore8(result, mload(and(shr(4, temp), 15))) temp := shr(8, temp) if iszero(temp) { break } } let n := sub(end, result) result := sub(result, 0x20) mstore(result, n) // Store the length. } } /// @dev Returns the hexadecimal representation of `value`. /// The output is prefixed with "0x", encoded using 2 hexadecimal digits per byte, /// and the alphabets are capitalized conditionally according to /// https://eips.ethereum.org/EIPS/eip-55 function toHexStringChecksummed(address value) internal pure returns (string memory result) { result = toHexString(value); /// @solidity memory-safe-assembly assembly { let mask := shl(6, div(not(0), 255)) // `0b010000000100000000 ...` let o := add(result, 0x22) let hashed := and(keccak256(o, 40), mul(34, mask)) // `0b10001000 ... ` let t := shl(240, 136) // `0b10001000 << 240` for { let i := 0 } 1 {} { mstore(add(i, i), mul(t, byte(i, hashed))) i := add(i, 1) if eq(i, 20) { break } } mstore(o, xor(mload(o), shr(1, and(mload(0x00), and(mload(o), mask))))) o := add(o, 0x20) mstore(o, xor(mload(o), shr(1, and(mload(0x20), and(mload(o), mask))))) } } /// @dev Returns the hexadecimal representation of `value`. /// The output is prefixed with "0x" and encoded using 2 hexadecimal digits per byte. function toHexString(address value) internal pure returns (string memory result) { result = toHexStringNoPrefix(value); /// @solidity memory-safe-assembly assembly { let n := add(mload(result), 2) // Compute the length. mstore(result, 0x3078) // Store the "0x" prefix. result := sub(result, 2) // Move the pointer. mstore(result, n) // Store the length. } } /// @dev Returns the hexadecimal representation of `value`. /// The output is encoded using 2 hexadecimal digits per byte. function toHexStringNoPrefix(address value) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { result := mload(0x40) // Allocate memory. // We need 0x20 bytes for the trailing zeros padding, 0x20 bytes for the length, // 0x02 bytes for the prefix, and 0x28 bytes for the digits. // The next multiple of 0x20 above (0x20 + 0x20 + 0x02 + 0x28) is 0x80. mstore(0x40, add(result, 0x80)) mstore(0x0f, 0x30313233343536373839616263646566) // Store the "0123456789abcdef" lookup. result := add(result, 2) mstore(result, 40) // Store the length. let o := add(result, 0x20) mstore(add(o, 40), 0) // Zeroize the slot after the string. value := shl(96, value) // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. for { let i := 0 } 1 {} { let p := add(o, add(i, i)) let temp := byte(i, value) mstore8(add(p, 1), mload(and(temp, 15))) mstore8(p, mload(shr(4, temp))) i := add(i, 1) if eq(i, 20) { break } } } } /// @dev Returns the hex encoded string from the raw bytes. /// The output is encoded using 2 hexadecimal digits per byte. function toHexString(bytes memory raw) internal pure returns (string memory result) { result = toHexStringNoPrefix(raw); /// @solidity memory-safe-assembly assembly { let n := add(mload(result), 2) // Compute the length. mstore(result, 0x3078) // Store the "0x" prefix. result := sub(result, 2) // Move the pointer. mstore(result, n) // Store the length. } } /// @dev Returns the hex encoded string from the raw bytes. /// The output is encoded using 2 hexadecimal digits per byte. function toHexStringNoPrefix(bytes memory raw) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let n := mload(raw) result := add(mload(0x40), 2) // Skip 2 bytes for the optional prefix. mstore(result, add(n, n)) // Store the length of the output. mstore(0x0f, 0x30313233343536373839616263646566) // Store the "0123456789abcdef" lookup. let o := add(result, 0x20) let end := add(raw, n) for {} iszero(eq(raw, end)) {} { raw := add(raw, 1) mstore8(add(o, 1), mload(and(mload(raw), 15))) mstore8(o, mload(and(shr(4, mload(raw)), 15))) o := add(o, 2) } mstore(o, 0) // Zeroize the slot after the string. mstore(0x40, add(o, 0x20)) // Allocate memory. } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* RUNE STRING OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns the number of UTF characters in the string. function runeCount(string memory s) internal pure returns (uint256 result) { /// @solidity memory-safe-assembly assembly { if mload(s) { mstore(0x00, div(not(0), 255)) mstore(0x20, 0x0202020202020202020202020202020202020202020202020303030304040506) let o := add(s, 0x20) let end := add(o, mload(s)) for { result := 1 } 1 { result := add(result, 1) } { o := add(o, byte(0, mload(shr(250, mload(o))))) if iszero(lt(o, end)) { break } } } } } /// @dev Returns if this string is a 7-bit ASCII string. /// (i.e. all characters codes are in [0..127]) function is7BitASCII(string memory s) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { result := 1 let mask := shl(7, div(not(0), 255)) let n := mload(s) if n { let o := add(s, 0x20) let end := add(o, n) let last := mload(end) mstore(end, 0) for {} 1 {} { if and(mask, mload(o)) { result := 0 break } o := add(o, 0x20) if iszero(lt(o, end)) { break } } mstore(end, last) } } } /// @dev Returns if this string is a 7-bit ASCII string, /// AND all characters are in the `allowed` lookup. /// Note: If `s` is empty, returns true regardless of `allowed`. function is7BitASCII(string memory s, uint128 allowed) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { result := 1 if mload(s) { let allowed_ := shr(128, shl(128, allowed)) let o := add(s, 0x20) for { let end := add(o, mload(s)) } 1 {} { result := and(result, shr(byte(0, mload(o)), allowed_)) o := add(o, 1) if iszero(and(result, lt(o, end))) { break } } } } } /// @dev Converts the bytes in the 7-bit ASCII string `s` to /// an allowed lookup for use in `is7BitASCII(s, allowed)`. /// To save runtime gas, you can cache the result in an immutable variable. function to7BitASCIIAllowedLookup(string memory s) internal pure returns (uint128 result) { /// @solidity memory-safe-assembly assembly { if mload(s) { let o := add(s, 0x20) for { let end := add(o, mload(s)) } 1 {} { result := or(result, shl(byte(0, mload(o)), 1)) o := add(o, 1) if iszero(lt(o, end)) { break } } if shr(128, result) { mstore(0x00, 0xc9807e0d) // `StringNot7BitASCII()`. revert(0x1c, 0x04) } } } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* BYTE STRING OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ // For performance and bytecode compactness, byte string operations are restricted // to 7-bit ASCII strings. All offsets are byte offsets, not UTF character offsets. // Usage of byte string operations on charsets with runes spanning two or more bytes // can lead to undefined behavior. /// @dev Returns `subject` all occurrences of `needle` replaced with `replacement`. function replace(string memory subject, string memory needle, string memory replacement) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { result := mload(0x40) let needleLen := mload(needle) let replacementLen := mload(replacement) let d := sub(result, subject) // Memory difference. let i := add(subject, 0x20) // Subject bytes pointer. let end := add(i, mload(subject)) if iszero(gt(needleLen, mload(subject))) { let subjectSearchEnd := add(sub(end, needleLen), 1) let h := 0 // The hash of `needle`. if iszero(lt(needleLen, 0x20)) { h := keccak256(add(needle, 0x20), needleLen) } let s := mload(add(needle, 0x20)) for { let m := shl(3, sub(0x20, and(needleLen, 0x1f))) } 1 {} { let t := mload(i) // Whether the first `needleLen % 32` bytes of `subject` and `needle` matches. if iszero(shr(m, xor(t, s))) { if h { if iszero(eq(keccak256(i, needleLen), h)) { mstore(add(i, d), t) i := add(i, 1) if iszero(lt(i, subjectSearchEnd)) { break } continue } } // Copy the `replacement` one word at a time. for { let j := 0 } 1 {} { mstore(add(add(i, d), j), mload(add(add(replacement, 0x20), j))) j := add(j, 0x20) if iszero(lt(j, replacementLen)) { break } } d := sub(add(d, replacementLen), needleLen) if needleLen { i := add(i, needleLen) if iszero(lt(i, subjectSearchEnd)) { break } continue } } mstore(add(i, d), t) i := add(i, 1) if iszero(lt(i, subjectSearchEnd)) { break } } } let n := add(sub(d, add(result, 0x20)), end) // Copy the rest of the string one word at a time. for {} lt(i, end) { i := add(i, 0x20) } { mstore(add(i, d), mload(i)) } let o := add(i, d) mstore(o, 0) // Zeroize the slot after the string. mstore(0x40, add(o, 0x20)) // Allocate memory. mstore(result, n) // Store the length. } } /// @dev Returns the byte index of the first location of `needle` in `subject`, /// needleing from left to right, starting from `from`. /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `needle` is not found. function indexOf(string memory subject, string memory needle, uint256 from) internal pure returns (uint256 result) { /// @solidity memory-safe-assembly assembly { result := not(0) // Initialize to `NOT_FOUND`. for { let subjectLen := mload(subject) } 1 {} { if iszero(mload(needle)) { result := from if iszero(gt(from, subjectLen)) { break } result := subjectLen break } let needleLen := mload(needle) let subjectStart := add(subject, 0x20) subject := add(subjectStart, from) let end := add(sub(add(subjectStart, subjectLen), needleLen), 1) let m := shl(3, sub(0x20, and(needleLen, 0x1f))) let s := mload(add(needle, 0x20)) if iszero(and(lt(subject, end), lt(from, subjectLen))) { break } if iszero(lt(needleLen, 0x20)) { for { let h := keccak256(add(needle, 0x20), needleLen) } 1 {} { if iszero(shr(m, xor(mload(subject), s))) { if eq(keccak256(subject, needleLen), h) { result := sub(subject, subjectStart) break } } subject := add(subject, 1) if iszero(lt(subject, end)) { break } } break } for {} 1 {} { if iszero(shr(m, xor(mload(subject), s))) { result := sub(subject, subjectStart) break } subject := add(subject, 1) if iszero(lt(subject, end)) { break } } break } } } /// @dev Returns the byte index of the first location of `needle` in `subject`, /// needleing from left to right. /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `needle` is not found. function indexOf(string memory subject, string memory needle) internal pure returns (uint256 result) { result = indexOf(subject, needle, 0); } /// @dev Returns the byte index of the first location of `needle` in `subject`, /// needleing from right to left, starting from `from`. /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `needle` is not found. function lastIndexOf(string memory subject, string memory needle, uint256 from) internal pure returns (uint256 result) { /// @solidity memory-safe-assembly assembly { for {} 1 {} { result := not(0) // Initialize to `NOT_FOUND`. let needleLen := mload(needle) if gt(needleLen, mload(subject)) { break } let w := result let fromMax := sub(mload(subject), needleLen) if iszero(gt(fromMax, from)) { from := fromMax } let end := add(add(subject, 0x20), w) subject := add(add(subject, 0x20), from) if iszero(gt(subject, end)) { break } // As this function is not too often used, // we shall simply use keccak256 for smaller bytecode size. for { let h := keccak256(add(needle, 0x20), needleLen) } 1 {} { if eq(keccak256(subject, needleLen), h) { result := sub(subject, add(end, 1)) break } subject := add(subject, w) // `sub(subject, 1)`. if iszero(gt(subject, end)) { break } } break } } } /// @dev Returns the byte index of the first location of `needle` in `subject`, /// needleing from right to left. /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `needle` is not found. function lastIndexOf(string memory subject, string memory needle) internal pure returns (uint256 result) { result = lastIndexOf(subject, needle, type(uint256).max); } /// @dev Returns true if `needle` is found in `subject`, false otherwise. function contains(string memory subject, string memory needle) internal pure returns (bool) { return indexOf(subject, needle) != NOT_FOUND; } /// @dev Returns whether `subject` starts with `needle`. function startsWith(string memory subject, string memory needle) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { let needleLen := mload(needle) // Just using keccak256 directly is actually cheaper. // forgefmt: disable-next-item result := and( iszero(gt(needleLen, mload(subject))), eq( keccak256(add(subject, 0x20), needleLen), keccak256(add(needle, 0x20), needleLen) ) ) } } /// @dev Returns whether `subject` ends with `needle`. function endsWith(string memory subject, string memory needle) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { let needleLen := mload(needle) // Whether `needle` is not longer than `subject`. let inRange := iszero(gt(needleLen, mload(subject))) // Just using keccak256 directly is actually cheaper. // forgefmt: disable-next-item result := and( eq( keccak256( // `subject + 0x20 + max(subjectLen - needleLen, 0)`. add(add(subject, 0x20), mul(inRange, sub(mload(subject), needleLen))), needleLen ), keccak256(add(needle, 0x20), needleLen) ), inRange ) } } /// @dev Returns `subject` repeated `times`. function repeat(string memory subject, uint256 times) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let subjectLen := mload(subject) if iszero(or(iszero(times), iszero(subjectLen))) { result := mload(0x40) subject := add(subject, 0x20) let o := add(result, 0x20) for {} 1 {} { // Copy the `subject` one word at a time. for { let j := 0 } 1 {} { mstore(add(o, j), mload(add(subject, j))) j := add(j, 0x20) if iszero(lt(j, subjectLen)) { break } } o := add(o, subjectLen) times := sub(times, 1) if iszero(times) { break } } mstore(o, 0) // Zeroize the slot after the string. mstore(0x40, add(o, 0x20)) // Allocate memory. mstore(result, sub(o, add(result, 0x20))) // Store the length. } } } /// @dev Returns a copy of `subject` sliced from `start` to `end` (exclusive). /// `start` and `end` are byte offsets. function slice(string memory subject, uint256 start, uint256 end) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let subjectLen := mload(subject) if iszero(gt(subjectLen, end)) { end := subjectLen } if iszero(gt(subjectLen, start)) { start := subjectLen } if lt(start, end) { result := mload(0x40) let n := sub(end, start) let i := add(subject, start) let w := not(0x1f) // Copy the `subject` one word at a time, backwards. for { let j := and(add(n, 0x1f), w) } 1 {} { mstore(add(result, j), mload(add(i, j))) j := add(j, w) // `sub(j, 0x20)`. if iszero(j) { break } } let o := add(add(result, 0x20), n) mstore(o, 0) // Zeroize the slot after the string. mstore(0x40, add(o, 0x20)) // Allocate memory. mstore(result, n) // Store the length. } } } /// @dev Returns a copy of `subject` sliced from `start` to the end of the string. /// `start` is a byte offset. function slice(string memory subject, uint256 start) internal pure returns (string memory result) { result = slice(subject, start, type(uint256).max); } /// @dev Returns all the indices of `needle` in `subject`. /// The indices are byte offsets. function indicesOf(string memory subject, string memory needle) internal pure returns (uint256[] memory result) { /// @solidity memory-safe-assembly assembly { let searchLen := mload(needle) if iszero(gt(searchLen, mload(subject))) { result := mload(0x40) let i := add(subject, 0x20) let o := add(result, 0x20) let subjectSearchEnd := add(sub(add(i, mload(subject)), searchLen), 1) let h := 0 // The hash of `needle`. if iszero(lt(searchLen, 0x20)) { h := keccak256(add(needle, 0x20), searchLen) } let s := mload(add(needle, 0x20)) for { let m := shl(3, sub(0x20, and(searchLen, 0x1f))) } 1 {} { let t := mload(i) // Whether the first `searchLen % 32` bytes of `subject` and `needle` matches. if iszero(shr(m, xor(t, s))) { if h { if iszero(eq(keccak256(i, searchLen), h)) { i := add(i, 1) if iszero(lt(i, subjectSearchEnd)) { break } continue } } mstore(o, sub(i, add(subject, 0x20))) // Append to `result`. o := add(o, 0x20) i := add(i, searchLen) // Advance `i` by `searchLen`. if searchLen { if iszero(lt(i, subjectSearchEnd)) { break } continue } } i := add(i, 1) if iszero(lt(i, subjectSearchEnd)) { break } } mstore(result, shr(5, sub(o, add(result, 0x20)))) // Store the length of `result`. // Allocate memory for result. // We allocate one more word, so this array can be recycled for {split}. mstore(0x40, add(o, 0x20)) } } } /// @dev Returns a arrays of strings based on the `delimiter` inside of the `subject` string. function split(string memory subject, string memory delimiter) internal pure returns (string[] memory result) { uint256[] memory indices = indicesOf(subject, delimiter); /// @solidity memory-safe-assembly assembly { let w := not(0x1f) let indexPtr := add(indices, 0x20) let indicesEnd := add(indexPtr, shl(5, add(mload(indices), 1))) mstore(add(indicesEnd, w), mload(subject)) mstore(indices, add(mload(indices), 1)) for { let prevIndex := 0 } 1 {} { let index := mload(indexPtr) mstore(indexPtr, 0x60) if iszero(eq(index, prevIndex)) { let element := mload(0x40) let l := sub(index, prevIndex) mstore(element, l) // Store the length of the element. // Copy the `subject` one word at a time, backwards. for { let o := and(add(l, 0x1f), w) } 1 {} { mstore(add(element, o), mload(add(add(subject, prevIndex), o))) o := add(o, w) // `sub(o, 0x20)`. if iszero(o) { break } } mstore(add(add(element, 0x20), l), 0) // Zeroize the slot after the string. // Allocate memory for the length and the bytes, rounded up to a multiple of 32. mstore(0x40, add(element, and(add(l, 0x3f), w))) mstore(indexPtr, element) // Store the `element` into the array. } prevIndex := add(index, mload(delimiter)) indexPtr := add(indexPtr, 0x20) if iszero(lt(indexPtr, indicesEnd)) { break } } result := indices if iszero(mload(delimiter)) { result := add(indices, 0x20) mstore(result, sub(mload(indices), 2)) } } } /// @dev Returns a concatenated string of `a` and `b`. /// Cheaper than `string.concat()` and does not de-align the free memory pointer. function concat(string memory a, string memory b) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { result := mload(0x40) let w := not(0x1f) let aLen := mload(a) // Copy `a` one word at a time, backwards. for { let o := and(add(aLen, 0x20), w) } 1 {} { mstore(add(result, o), mload(add(a, o))) o := add(o, w) // `sub(o, 0x20)`. if iszero(o) { break } } let bLen := mload(b) let output := add(result, aLen) // Copy `b` one word at a time, backwards. for { let o := and(add(bLen, 0x20), w) } 1 {} { mstore(add(output, o), mload(add(b, o))) o := add(o, w) // `sub(o, 0x20)`. if iszero(o) { break } } let totalLen := add(aLen, bLen) let last := add(add(result, 0x20), totalLen) mstore(last, 0) // Zeroize the slot after the string. mstore(result, totalLen) // Store the length. mstore(0x40, add(last, 0x20)) // Allocate memory. } } /// @dev Returns a copy of the string in either lowercase or UPPERCASE. /// WARNING! This function is only compatible with 7-bit ASCII strings. function toCase(string memory subject, bool toUpper) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let n := mload(subject) if n { result := mload(0x40) let o := add(result, 0x20) let d := sub(subject, result) let flags := shl(add(70, shl(5, toUpper)), 0x3ffffff) for { let end := add(o, n) } 1 {} { let b := byte(0, mload(add(d, o))) mstore8(o, xor(and(shr(b, flags), 0x20), b)) o := add(o, 1) if eq(o, end) { break } } mstore(result, n) // Store the length. mstore(o, 0) // Zeroize the slot after the string. mstore(0x40, add(o, 0x20)) // Allocate memory. } } } /// @dev Returns a string from a small bytes32 string. /// `s` must be null-terminated, or behavior will be undefined. function fromSmallString(bytes32 s) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { result := mload(0x40) let n := 0 for {} byte(n, s) { n := add(n, 1) } {} // Scan for '\0'. mstore(result, n) // Store the length. let o := add(result, 0x20) mstore(o, s) // Store the bytes of the string. mstore(add(o, n), 0) // Zeroize the slot after the string. mstore(0x40, add(result, 0x40)) // Allocate memory. } } /// @dev Returns the small string, with all bytes after the first null byte zeroized. function normalizeSmallString(bytes32 s) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { for {} byte(result, s) { result := add(result, 1) } {} // Scan for '\0'. mstore(0x00, s) mstore(result, 0x00) result := mload(0x00) } } /// @dev Returns the string as a normalized null-terminated small string. function toSmallString(string memory s) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { result := mload(s) if iszero(lt(result, 33)) { mstore(0x00, 0xec92f9a3) // `TooBigForSmallString()`. revert(0x1c, 0x04) } result := shl(shl(3, sub(32, result)), mload(add(s, result))) } } /// @dev Returns a lowercased copy of the string. /// WARNING! This function is only compatible with 7-bit ASCII strings. function lower(string memory subject) internal pure returns (string memory result) { result = toCase(subject, false); } /// @dev Returns an UPPERCASED copy of the string. /// WARNING! This function is only compatible with 7-bit ASCII strings. function upper(string memory subject) internal pure returns (string memory result) { result = toCase(subject, true); } /// @dev Escapes the string to be used within HTML tags. function escapeHTML(string memory s) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { result := mload(0x40) let end := add(s, mload(s)) let o := add(result, 0x20) // Store the bytes of the packed offsets and strides into the scratch space. // `packed = (stride << 5) | offset`. Max offset is 20. Max stride is 6. mstore(0x1f, 0x900094) mstore(0x08, 0xc0000000a6ab) // Store ""&'<>" into the scratch space. mstore(0x00, shl(64, 0x2671756f743b26616d703b262333393b266c743b2667743b)) for {} iszero(eq(s, end)) {} { s := add(s, 1) let c := and(mload(s), 0xff) // Not in `["\"","'","&","<",">"]`. if iszero(and(shl(c, 1), 0x500000c400000000)) { mstore8(o, c) o := add(o, 1) continue } let t := shr(248, mload(c)) mstore(o, mload(and(t, 0x1f))) o := add(o, shr(5, t)) } mstore(o, 0) // Zeroize the slot after the string. mstore(result, sub(o, add(result, 0x20))) // Store the length. mstore(0x40, add(o, 0x20)) // Allocate memory. } } /// @dev Escapes the string to be used within double-quotes in a JSON. /// If `addDoubleQuotes` is true, the result will be enclosed in double-quotes. function escapeJSON(string memory s, bool addDoubleQuotes) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { result := mload(0x40) let o := add(result, 0x20) if addDoubleQuotes { mstore8(o, 34) o := add(1, o) } // Store "\\u0000" in scratch space. // Store "0123456789abcdef" in scratch space. // Also, store `{0x08:"b", 0x09:"t", 0x0a:"n", 0x0c:"f", 0x0d:"r"}`. // into the scratch space. mstore(0x15, 0x5c75303030303031323334353637383961626364656662746e006672) // Bitmask for detecting `["\"","\\"]`. let e := or(shl(0x22, 1), shl(0x5c, 1)) for { let end := add(s, mload(s)) } iszero(eq(s, end)) {} { s := add(s, 1) let c := and(mload(s), 0xff) if iszero(lt(c, 0x20)) { if iszero(and(shl(c, 1), e)) { // Not in `["\"","\\"]`. mstore8(o, c) o := add(o, 1) continue } mstore8(o, 0x5c) // "\\". mstore8(add(o, 1), c) o := add(o, 2) continue } if iszero(and(shl(c, 1), 0x3700)) { // Not in `["\b","\t","\n","\f","\d"]`. mstore8(0x1d, mload(shr(4, c))) // Hex value. mstore8(0x1e, mload(and(c, 15))) // Hex value. mstore(o, mload(0x19)) // "\\u00XX". o := add(o, 6) continue } mstore8(o, 0x5c) // "\\". mstore8(add(o, 1), mload(add(c, 8))) o := add(o, 2) } if addDoubleQuotes { mstore8(o, 34) o := add(1, o) } mstore(o, 0) // Zeroize the slot after the string. mstore(result, sub(o, add(result, 0x20))) // Store the length. mstore(0x40, add(o, 0x20)) // Allocate memory. } } /// @dev Escapes the string to be used within double-quotes in a JSON. function escapeJSON(string memory s) internal pure returns (string memory result) { result = escapeJSON(s, false); } /// @dev Encodes `s` so that it can be safely used in a URI, /// just like `encodeURIComponent` in JavaScript. /// See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent /// See: https://datatracker.ietf.org/doc/html/rfc2396 /// See: https://datatracker.ietf.org/doc/html/rfc3986 function encodeURIComponent(string memory s) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { result := mload(0x40) // Store "0123456789ABCDEF" in scratch space. // Uppercased to be consistent with JavaScript's implementation. mstore(0x0f, 0x30313233343536373839414243444546) let o := add(result, 0x20) for { let end := add(s, mload(s)) } iszero(eq(s, end)) {} { s := add(s, 1) let c := and(mload(s), 0xff) // If not in `[0-9A-Z-a-z-_.!~*'()]`. if iszero(and(1, shr(c, 0x47fffffe87fffffe03ff678200000000))) { mstore8(o, 0x25) // '%'. mstore8(add(o, 1), mload(and(shr(4, c), 15))) mstore8(add(o, 2), mload(and(c, 15))) o := add(o, 3) continue } mstore8(o, c) o := add(o, 1) } mstore(result, sub(o, add(result, 0x20))) // Store the length. mstore(o, 0) // Zeroize the slot after the string. mstore(0x40, add(o, 0x20)) // Allocate memory. } } /// @dev Returns whether `a` equals `b`. function eq(string memory a, string memory b) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { result := eq(keccak256(add(a, 0x20), mload(a)), keccak256(add(b, 0x20), mload(b))) } } /// @dev Returns whether `a` equals `b`, where `b` is a null-terminated small string. function eqs(string memory a, bytes32 b) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { // These should be evaluated on compile time, as far as possible. let m := not(shl(7, div(not(iszero(b)), 255))) // `0x7f7f ...`. let x := not(or(m, or(b, add(m, and(b, m))))) let r := shl(7, iszero(iszero(shr(128, x)))) r := or(r, shl(6, iszero(iszero(shr(64, shr(r, x)))))) r := or(r, shl(5, lt(0xffffffff, shr(r, x)))) r := or(r, shl(4, lt(0xffff, shr(r, x)))) r := or(r, shl(3, lt(0xff, shr(r, x)))) // forgefmt: disable-next-item result := gt(eq(mload(a), add(iszero(x), xor(31, shr(3, r)))), xor(shr(add(8, r), b), shr(add(8, r), mload(add(a, 0x20))))) } } /// @dev Packs a single string with its length into a single word. /// Returns `bytes32(0)` if the length is zero or greater than 31. function packOne(string memory a) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { // We don't need to zero right pad the string, // since this is our own custom non-standard packing scheme. result := mul( // Load the length and the bytes. mload(add(a, 0x1f)), // `length != 0 && length < 32`. Abuses underflow. // Assumes that the length is valid and within the block gas limit. lt(sub(mload(a), 1), 0x1f) ) } } /// @dev Unpacks a string packed using {packOne}. /// Returns the empty string if `packed` is `bytes32(0)`. /// If `packed` is not an output of {packOne}, the output behavior is undefined. function unpackOne(bytes32 packed) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { result := mload(0x40) // Grab the free memory pointer. mstore(0x40, add(result, 0x40)) // Allocate 2 words (1 for the length, 1 for the bytes). mstore(result, 0) // Zeroize the length slot. mstore(add(result, 0x1f), packed) // Store the length and bytes. mstore(add(add(result, 0x20), mload(result)), 0) // Right pad with zeroes. } } /// @dev Packs two strings with their lengths into a single word. /// Returns `bytes32(0)` if combined length is zero or greater than 30. function packTwo(string memory a, string memory b) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { let aLen := mload(a) // We don't need to zero right pad the strings, // since this is our own custom non-standard packing scheme. result := mul( or( // Load the length and the bytes of `a` and `b`. shl(shl(3, sub(0x1f, aLen)), mload(add(a, aLen))), mload(sub(add(b, 0x1e), aLen))), // `totalLen != 0 && totalLen < 31`. Abuses underflow. // Assumes that the lengths are valid and within the block gas limit. lt(sub(add(aLen, mload(b)), 1), 0x1e) ) } } /// @dev Unpacks strings packed using {packTwo}. /// Returns the empty strings if `packed` is `bytes32(0)`. /// If `packed` is not an output of {packTwo}, the output behavior is undefined. function unpackTwo(bytes32 packed) internal pure returns (string memory resultA, string memory resultB) { /// @solidity memory-safe-assembly assembly { resultA := mload(0x40) // Grab the free memory pointer. resultB := add(resultA, 0x40) // Allocate 2 words for each string (1 for the length, 1 for the byte). Total 4 words. mstore(0x40, add(resultB, 0x40)) // Zeroize the length slots. mstore(resultA, 0) mstore(resultB, 0) // Store the lengths and bytes. mstore(add(resultA, 0x1f), packed) mstore(add(resultB, 0x1f), mload(add(add(resultA, 0x20), mload(resultA)))) // Right pad with zeroes. mstore(add(add(resultA, 0x20), mload(resultA)), 0) mstore(add(add(resultB, 0x20), mload(resultB)), 0) } } /// @dev Directly returns `a` without copying. function directReturn(string memory a) internal pure { assembly { // Assumes that the string does not start from the scratch space. let retStart := sub(a, 0x20) let retUnpaddedSize := add(mload(a), 0x40) // Right pad with zeroes. Just in case the string is produced // by a method that doesn't zero right pad. mstore(add(retStart, retUnpaddedSize), 0) mstore(retStart, 0x20) // Store the return offset. // End the transaction, returning the string. return(retStart, and(not(0x1f), add(0x1f, retUnpaddedSize))) } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.4; /// @notice Gas optimized ECDSA wrapper. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/ECDSA.sol) /// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/ECDSA.sol) /// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/cryptography/ECDSA.sol) /// /// @dev Note: /// - The recovery functions use the ecrecover precompile (0x1). /// - As of Solady version 0.0.68, the `recover` variants will revert upon recovery failure. /// This is for more safety by default. /// Use the `tryRecover` variants if you need to get the zero address back /// upon recovery failure instead. /// - As of Solady version 0.0.134, all `bytes signature` variants accept both /// regular 65-byte `(r, s, v)` and EIP-2098 `(r, vs)` short form signatures. /// See: https://eips.ethereum.org/EIPS/eip-2098 /// This is for calldata efficiency on smart accounts prevalent on L2s. /// /// WARNING! Do NOT directly use signatures as unique identifiers: /// - The recovery operations do NOT check if a signature is non-malleable. /// - Use a nonce in the digest to prevent replay attacks on the same contract. /// - Use EIP-712 for the digest to prevent replay attacks across different chains and contracts. /// EIP-712 also enables readable signing of typed data for better user safety. /// - If you need a unique hash from a signature, please use the `canonicalHash` functions. library ECDSA { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CONSTANTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The order of the secp256k1 elliptic curve. uint256 internal constant N = 0xfffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141; /// @dev `N/2 + 1`. Used for checking the malleability of the signature. uint256 private constant _HALF_N_PLUS_1 = 0x7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a1; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The signature is invalid. error InvalidSignature(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* RECOVERY OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Recovers the signer's address from a message digest `hash`, and the `signature`. function recover(bytes32 hash, bytes memory signature) internal view returns (address result) { /// @solidity memory-safe-assembly assembly { result := 1 let m := mload(0x40) // Cache the free memory pointer. for {} 1 {} { mstore(0x00, hash) mstore(0x40, mload(add(signature, 0x20))) // `r`. if eq(mload(signature), 64) { let vs := mload(add(signature, 0x40)) mstore(0x20, add(shr(255, vs), 27)) // `v`. mstore(0x60, shr(1, shl(1, vs))) // `s`. break } if eq(mload(signature), 65) { mstore(0x20, byte(0, mload(add(signature, 0x60)))) // `v`. mstore(0x60, mload(add(signature, 0x40))) // `s`. break } result := 0 break } result := mload( staticcall( gas(), // Amount of gas left for the transaction. result, // Address of `ecrecover`. 0x00, // Start of input. 0x80, // Size of input. 0x01, // Start of output. 0x20 // Size of output. ) ) // `returndatasize()` will be `0x20` upon success, and `0x00` otherwise. if iszero(returndatasize()) { mstore(0x00, 0x8baa579f) // `InvalidSignature()`. revert(0x1c, 0x04) } mstore(0x60, 0) // Restore the zero slot. mstore(0x40, m) // Restore the free memory pointer. } } /// @dev Recovers the signer's address from a message digest `hash`, and the `signature`. function recoverCalldata(bytes32 hash, bytes calldata signature) internal view returns (address result) { /// @solidity memory-safe-assembly assembly { result := 1 let m := mload(0x40) // Cache the free memory pointer. mstore(0x00, hash) for {} 1 {} { if eq(signature.length, 64) { let vs := calldataload(add(signature.offset, 0x20)) mstore(0x20, add(shr(255, vs), 27)) // `v`. mstore(0x40, calldataload(signature.offset)) // `r`. mstore(0x60, shr(1, shl(1, vs))) // `s`. break } if eq(signature.length, 65) { mstore(0x20, byte(0, calldataload(add(signature.offset, 0x40)))) // `v`. calldatacopy(0x40, signature.offset, 0x40) // Copy `r` and `s`. break } result := 0 break } result := mload( staticcall( gas(), // Amount of gas left for the transaction. result, // Address of `ecrecover`. 0x00, // Start of input. 0x80, // Size of input. 0x01, // Start of output. 0x20 // Size of output. ) ) // `returndatasize()` will be `0x20` upon success, and `0x00` otherwise. if iszero(returndatasize()) { mstore(0x00, 0x8baa579f) // `InvalidSignature()`. revert(0x1c, 0x04) } mstore(0x60, 0) // Restore the zero slot. mstore(0x40, m) // Restore the free memory pointer. } } /// @dev Recovers the signer's address from a message digest `hash`, /// and the EIP-2098 short form signature defined by `r` and `vs`. function recover(bytes32 hash, bytes32 r, bytes32 vs) internal view returns (address result) { /// @solidity memory-safe-assembly assembly { let m := mload(0x40) // Cache the free memory pointer. mstore(0x00, hash) mstore(0x20, add(shr(255, vs), 27)) // `v`. mstore(0x40, r) mstore(0x60, shr(1, shl(1, vs))) // `s`. result := mload( staticcall( gas(), // Amount of gas left for the transaction. 1, // Address of `ecrecover`. 0x00, // Start of input. 0x80, // Size of input. 0x01, // Start of output. 0x20 // Size of output. ) ) // `returndatasize()` will be `0x20` upon success, and `0x00` otherwise. if iszero(returndatasize()) { mstore(0x00, 0x8baa579f) // `InvalidSignature()`. revert(0x1c, 0x04) } mstore(0x60, 0) // Restore the zero slot. mstore(0x40, m) // Restore the free memory pointer. } } /// @dev Recovers the signer's address from a message digest `hash`, /// and the signature defined by `v`, `r`, `s`. function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal view returns (address result) { /// @solidity memory-safe-assembly assembly { let m := mload(0x40) // Cache the free memory pointer. mstore(0x00, hash) mstore(0x20, and(v, 0xff)) mstore(0x40, r) mstore(0x60, s) result := mload( staticcall( gas(), // Amount of gas left for the transaction. 1, // Address of `ecrecover`. 0x00, // Start of input. 0x80, // Size of input. 0x01, // Start of output. 0x20 // Size of output. ) ) // `returndatasize()` will be `0x20` upon success, and `0x00` otherwise. if iszero(returndatasize()) { mstore(0x00, 0x8baa579f) // `InvalidSignature()`. revert(0x1c, 0x04) } mstore(0x60, 0) // Restore the zero slot. mstore(0x40, m) // Restore the free memory pointer. } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* TRY-RECOVER OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ // WARNING! // These functions will NOT revert upon recovery failure. // Instead, they will return the zero address upon recovery failure. // It is critical that the returned address is NEVER compared against // a zero address (e.g. an uninitialized address variable). /// @dev Recovers the signer's address from a message digest `hash`, and the `signature`. function tryRecover(bytes32 hash, bytes memory signature) internal view returns (address result) { /// @solidity memory-safe-assembly assembly { result := 1 let m := mload(0x40) // Cache the free memory pointer. for {} 1 {} { mstore(0x00, hash) mstore(0x40, mload(add(signature, 0x20))) // `r`. if eq(mload(signature), 64) { let vs := mload(add(signature, 0x40)) mstore(0x20, add(shr(255, vs), 27)) // `v`. mstore(0x60, shr(1, shl(1, vs))) // `s`. break } if eq(mload(signature), 65) { mstore(0x20, byte(0, mload(add(signature, 0x60)))) // `v`. mstore(0x60, mload(add(signature, 0x40))) // `s`. break } result := 0 break } pop( staticcall( gas(), // Amount of gas left for the transaction. result, // Address of `ecrecover`. 0x00, // Start of input. 0x80, // Size of input. 0x40, // Start of output. 0x20 // Size of output. ) ) mstore(0x60, 0) // Restore the zero slot. // `returndatasize()` will be `0x20` upon success, and `0x00` otherwise. result := mload(xor(0x60, returndatasize())) mstore(0x40, m) // Restore the free memory pointer. } } /// @dev Recovers the signer's address from a message digest `hash`, and the `signature`. function tryRecoverCalldata(bytes32 hash, bytes calldata signature) internal view returns (address result) { /// @solidity memory-safe-assembly assembly { result := 1 let m := mload(0x40) // Cache the free memory pointer. mstore(0x00, hash) for {} 1 {} { if eq(signature.length, 64) { let vs := calldataload(add(signature.offset, 0x20)) mstore(0x20, add(shr(255, vs), 27)) // `v`. mstore(0x40, calldataload(signature.offset)) // `r`. mstore(0x60, shr(1, shl(1, vs))) // `s`. break } if eq(signature.length, 65) { mstore(0x20, byte(0, calldataload(add(signature.offset, 0x40)))) // `v`. calldatacopy(0x40, signature.offset, 0x40) // Copy `r` and `s`. break } result := 0 break } pop( staticcall( gas(), // Amount of gas left for the transaction. result, // Address of `ecrecover`. 0x00, // Start of input. 0x80, // Size of input. 0x40, // Start of output. 0x20 // Size of output. ) ) mstore(0x60, 0) // Restore the zero slot. // `returndatasize()` will be `0x20` upon success, and `0x00` otherwise. result := mload(xor(0x60, returndatasize())) mstore(0x40, m) // Restore the free memory pointer. } } /// @dev Recovers the signer's address from a message digest `hash`, /// and the EIP-2098 short form signature defined by `r` and `vs`. function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal view returns (address result) { /// @solidity memory-safe-assembly assembly { let m := mload(0x40) // Cache the free memory pointer. mstore(0x00, hash) mstore(0x20, add(shr(255, vs), 27)) // `v`. mstore(0x40, r) mstore(0x60, shr(1, shl(1, vs))) // `s`. pop( staticcall( gas(), // Amount of gas left for the transaction. 1, // Address of `ecrecover`. 0x00, // Start of input. 0x80, // Size of input. 0x40, // Start of output. 0x20 // Size of output. ) ) mstore(0x60, 0) // Restore the zero slot. // `returndatasize()` will be `0x20` upon success, and `0x00` otherwise. result := mload(xor(0x60, returndatasize())) mstore(0x40, m) // Restore the free memory pointer. } } /// @dev Recovers the signer's address from a message digest `hash`, /// and the signature defined by `v`, `r`, `s`. function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal view returns (address result) { /// @solidity memory-safe-assembly assembly { let m := mload(0x40) // Cache the free memory pointer. mstore(0x00, hash) mstore(0x20, and(v, 0xff)) mstore(0x40, r) mstore(0x60, s) pop( staticcall( gas(), // Amount of gas left for the transaction. 1, // Address of `ecrecover`. 0x00, // Start of input. 0x80, // Size of input. 0x40, // Start of output. 0x20 // Size of output. ) ) mstore(0x60, 0) // Restore the zero slot. // `returndatasize()` will be `0x20` upon success, and `0x00` otherwise. result := mload(xor(0x60, returndatasize())) mstore(0x40, m) // Restore the free memory pointer. } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* HASHING OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns an Ethereum Signed Message, created from a `hash`. /// This produces a hash corresponding to the one signed with the /// [`eth_sign`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_sign) /// JSON-RPC method as part of EIP-191. function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { mstore(0x20, hash) // Store into scratch space for keccak256. mstore(0x00, "\x00\x00\x00\x00\x19Ethereum Signed Message:\n32") // 28 bytes. result := keccak256(0x04, 0x3c) // `32 * 2 - (32 - 28) = 60 = 0x3c`. } } /// @dev Returns an Ethereum Signed Message, created from `s`. /// This produces a hash corresponding to the one signed with the /// [`eth_sign`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_sign) /// JSON-RPC method as part of EIP-191. /// Note: Supports lengths of `s` up to 999999 bytes. function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { let sLength := mload(s) let o := 0x20 mstore(o, "\x19Ethereum Signed Message:\n") // 26 bytes, zero-right-padded. mstore(0x00, 0x00) // Convert the `s.length` to ASCII decimal representation: `base10(s.length)`. for { let temp := sLength } 1 {} { o := sub(o, 1) mstore8(o, add(48, mod(temp, 10))) temp := div(temp, 10) if iszero(temp) { break } } let n := sub(0x3a, o) // Header length: `26 + 32 - o`. // Throw an out-of-offset error (consumes all gas) if the header exceeds 32 bytes. returndatacopy(returndatasize(), returndatasize(), gt(n, 0x20)) mstore(s, or(mload(0x00), mload(n))) // Temporarily store the header. result := keccak256(add(s, sub(0x20, n)), add(n, sLength)) mstore(s, sLength) // Restore the length. } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CANONICAL HASH FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ // The following functions returns the hash of the signature in it's canonicalized format, // which is the 65-byte `abi.encodePacked(r, s, uint8(v))`, where `v` is either 27 or 28. // If `s` is greater than `N / 2` then it will be converted to `N - s` // and the `v` value will be flipped. // If the signature has an invalid length, or if `v` is invalid, // a uniquely corrupt hash will be returned. // These functions are useful for "poor-mans-VRF". /// @dev Returns the canonical hash of `signature`. function canonicalHash(bytes memory signature) internal pure returns (bytes32 result) { // @solidity memory-safe-assembly assembly { let l := mload(signature) for {} 1 {} { mstore(0x00, mload(add(signature, 0x20))) // `r`. let s := mload(add(signature, 0x40)) let v := mload(add(signature, 0x41)) if eq(l, 64) { v := add(shr(255, s), 27) s := shr(1, shl(1, s)) } if iszero(lt(s, _HALF_N_PLUS_1)) { v := xor(v, 7) s := sub(N, s) } mstore(0x21, v) mstore(0x20, s) result := keccak256(0x00, 0x41) mstore(0x21, 0) // Restore the overwritten part of the free memory pointer. break } // If the length is neither 64 nor 65, return a uniquely corrupted hash. if iszero(lt(sub(l, 64), 2)) { // `bytes4(keccak256("InvalidSignatureLength"))`. result := xor(keccak256(add(signature, 0x20), l), 0xd62f1ab2) } } } /// @dev Returns the canonical hash of `signature`. function canonicalHashCalldata(bytes calldata signature) internal pure returns (bytes32 result) { // @solidity memory-safe-assembly assembly { let l := signature.length for {} 1 {} { mstore(0x00, calldataload(signature.offset)) // `r`. let s := calldataload(add(signature.offset, 0x20)) let v := calldataload(add(signature.offset, 0x21)) if eq(l, 64) { v := add(shr(255, s), 27) s := shr(1, shl(1, s)) } if iszero(lt(s, _HALF_N_PLUS_1)) { v := xor(v, 7) s := sub(N, s) } mstore(0x21, v) mstore(0x20, s) result := keccak256(0x00, 0x41) mstore(0x21, 0) // Restore the overwritten part of the free memory pointer. break } // If the length is neither 64 nor 65, return a uniquely corrupted hash. if iszero(lt(sub(l, 64), 2)) { calldatacopy(mload(0x40), signature.offset, l) // `bytes4(keccak256("InvalidSignatureLength"))`. result := xor(keccak256(mload(0x40), l), 0xd62f1ab2) } } } /// @dev Returns the canonical hash of `signature`. function canonicalHash(bytes32 r, bytes32 vs) internal pure returns (bytes32 result) { // @solidity memory-safe-assembly assembly { mstore(0x00, r) // `r`. let v := add(shr(255, vs), 27) let s := shr(1, shl(1, vs)) mstore(0x21, v) mstore(0x20, s) result := keccak256(0x00, 0x41) mstore(0x21, 0) // Restore the overwritten part of the free memory pointer. } } /// @dev Returns the canonical hash of `signature`. function canonicalHash(uint8 v, bytes32 r, bytes32 s) internal pure returns (bytes32 result) { // @solidity memory-safe-assembly assembly { mstore(0x00, r) // `r`. if iszero(lt(s, _HALF_N_PLUS_1)) { v := xor(v, 7) s := sub(N, s) } mstore(0x21, v) mstore(0x20, s) result := keccak256(0x00, 0x41) mstore(0x21, 0) // Restore the overwritten part of the free memory pointer. } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EMPTY CALLDATA HELPERS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns an empty calldata bytes. function emptySignature() internal pure returns (bytes calldata signature) { /// @solidity memory-safe-assembly assembly { signature.length := 0 } } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.4; /// @notice Gas optimized verification of proof of inclusion for a leaf in a Merkle tree. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/MerkleProofLib.sol) /// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/MerkleProofLib.sol) /// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/cryptography/MerkleProof.sol) library MerkleProofLib { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* MERKLE PROOF VERIFICATION OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns whether `leaf` exists in the Merkle tree with `root`, given `proof`. function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool isValid) { /// @solidity memory-safe-assembly assembly { if mload(proof) { // Initialize `offset` to the offset of `proof` elements in memory. let offset := add(proof, 0x20) // Left shift by 5 is equivalent to multiplying by 0x20. let end := add(offset, shl(5, mload(proof))) // Iterate over proof elements to compute root hash. for {} 1 {} { // Slot of `leaf` in scratch space. // If the condition is true: 0x20, otherwise: 0x00. let scratch := shl(5, gt(leaf, mload(offset))) // Store elements to hash contiguously in scratch space. // Scratch space is 64 bytes (0x00 - 0x3f) and both elements are 32 bytes. mstore(scratch, leaf) mstore(xor(scratch, 0x20), mload(offset)) // Reuse `leaf` to store the hash to reduce stack operations. leaf := keccak256(0x00, 0x40) offset := add(offset, 0x20) if iszero(lt(offset, end)) { break } } } isValid := eq(leaf, root) } } /// @dev Returns whether `leaf` exists in the Merkle tree with `root`, given `proof`. function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool isValid) { /// @solidity memory-safe-assembly assembly { if proof.length { // Left shift by 5 is equivalent to multiplying by 0x20. let end := add(proof.offset, shl(5, proof.length)) // Initialize `offset` to the offset of `proof` in the calldata. let offset := proof.offset // Iterate over proof elements to compute root hash. for {} 1 {} { // Slot of `leaf` in scratch space. // If the condition is true: 0x20, otherwise: 0x00. let scratch := shl(5, gt(leaf, calldataload(offset))) // Store elements to hash contiguously in scratch space. // Scratch space is 64 bytes (0x00 - 0x3f) and both elements are 32 bytes. mstore(scratch, leaf) mstore(xor(scratch, 0x20), calldataload(offset)) // Reuse `leaf` to store the hash to reduce stack operations. leaf := keccak256(0x00, 0x40) offset := add(offset, 0x20) if iszero(lt(offset, end)) { break } } } isValid := eq(leaf, root) } } /// @dev Returns whether all `leaves` exist in the Merkle tree with `root`, /// given `proof` and `flags`. /// /// Note: /// - Breaking the invariant `flags.length == (leaves.length - 1) + proof.length` /// will always return false. /// - The sum of the lengths of `proof` and `leaves` must never overflow. /// - Any non-zero word in the `flags` array is treated as true. /// - The memory offset of `proof` must be non-zero /// (i.e. `proof` is not pointing to the scratch space). function verifyMultiProof( bytes32[] memory proof, bytes32 root, bytes32[] memory leaves, bool[] memory flags ) internal pure returns (bool isValid) { // Rebuilds the root by consuming and producing values on a queue. // The queue starts with the `leaves` array, and goes into a `hashes` array. // After the process, the last element on the queue is verified // to be equal to the `root`. // // The `flags` array denotes whether the sibling // should be popped from the queue (`flag == true`), or // should be popped from the `proof` (`flag == false`). /// @solidity memory-safe-assembly assembly { // Cache the lengths of the arrays. let leavesLength := mload(leaves) let proofLength := mload(proof) let flagsLength := mload(flags) // Advance the pointers of the arrays to point to the data. leaves := add(0x20, leaves) proof := add(0x20, proof) flags := add(0x20, flags) // If the number of flags is correct. for {} eq(add(leavesLength, proofLength), add(flagsLength, 1)) {} { // For the case where `proof.length + leaves.length == 1`. if iszero(flagsLength) { // `isValid = (proof.length == 1 ? proof[0] : leaves[0]) == root`. isValid := eq(mload(xor(leaves, mul(xor(proof, leaves), proofLength))), root) break } // The required final proof offset if `flagsLength` is not zero, otherwise zero. let proofEnd := add(proof, shl(5, proofLength)) // We can use the free memory space for the queue. // We don't need to allocate, since the queue is temporary. let hashesFront := mload(0x40) // Copy the leaves into the hashes. // Sometimes, a little memory expansion costs less than branching. // Should cost less, even with a high free memory offset of 0x7d00. leavesLength := shl(5, leavesLength) for { let i := 0 } iszero(eq(i, leavesLength)) { i := add(i, 0x20) } { mstore(add(hashesFront, i), mload(add(leaves, i))) } // Compute the back of the hashes. let hashesBack := add(hashesFront, leavesLength) // This is the end of the memory for the queue. // We recycle `flagsLength` to save on stack variables (sometimes save gas). flagsLength := add(hashesBack, shl(5, flagsLength)) for {} 1 {} { // Pop from `hashes`. let a := mload(hashesFront) // Pop from `hashes`. let b := mload(add(hashesFront, 0x20)) hashesFront := add(hashesFront, 0x40) // If the flag is false, load the next proof, // else, pops from the queue. if iszero(mload(flags)) { // Loads the next proof. b := mload(proof) proof := add(proof, 0x20) // Unpop from `hashes`. hashesFront := sub(hashesFront, 0x20) } // Advance to the next flag. flags := add(flags, 0x20) // Slot of `a` in scratch space. // If the condition is true: 0x20, otherwise: 0x00. let scratch := shl(5, gt(a, b)) // Hash the scratch space and push the result onto the queue. mstore(scratch, a) mstore(xor(scratch, 0x20), b) mstore(hashesBack, keccak256(0x00, 0x40)) hashesBack := add(hashesBack, 0x20) if iszero(lt(hashesBack, flagsLength)) { break } } isValid := and( // Checks if the last value in the queue is same as the root. eq(mload(sub(hashesBack, 0x20)), root), // And whether all the proofs are used, if required. eq(proofEnd, proof) ) break } } } /// @dev Returns whether all `leaves` exist in the Merkle tree with `root`, /// given `proof` and `flags`. /// /// Note: /// - Breaking the invariant `flags.length == (leaves.length - 1) + proof.length` /// will always return false. /// - Any non-zero word in the `flags` array is treated as true. /// - The calldata offset of `proof` must be non-zero /// (i.e. `proof` is from a regular Solidity function with a 4-byte selector). function verifyMultiProofCalldata( bytes32[] calldata proof, bytes32 root, bytes32[] calldata leaves, bool[] calldata flags ) internal pure returns (bool isValid) { // Rebuilds the root by consuming and producing values on a queue. // The queue starts with the `leaves` array, and goes into a `hashes` array. // After the process, the last element on the queue is verified // to be equal to the `root`. // // The `flags` array denotes whether the sibling // should be popped from the queue (`flag == true`), or // should be popped from the `proof` (`flag == false`). /// @solidity memory-safe-assembly assembly { // If the number of flags is correct. for {} eq(add(leaves.length, proof.length), add(flags.length, 1)) {} { // For the case where `proof.length + leaves.length == 1`. if iszero(flags.length) { // `isValid = (proof.length == 1 ? proof[0] : leaves[0]) == root`. // forgefmt: disable-next-item isValid := eq( calldataload( xor(leaves.offset, mul(xor(proof.offset, leaves.offset), proof.length)) ), root ) break } // The required final proof offset if `flagsLength` is not zero, otherwise zero. let proofEnd := add(proof.offset, shl(5, proof.length)) // We can use the free memory space for the queue. // We don't need to allocate, since the queue is temporary. let hashesFront := mload(0x40) // Copy the leaves into the hashes. // Sometimes, a little memory expansion costs less than branching. // Should cost less, even with a high free memory offset of 0x7d00. calldatacopy(hashesFront, leaves.offset, shl(5, leaves.length)) // Compute the back of the hashes. let hashesBack := add(hashesFront, shl(5, leaves.length)) // This is the end of the memory for the queue. // We recycle `flagsLength` to save on stack variables (sometimes save gas). flags.length := add(hashesBack, shl(5, flags.length)) // We don't need to make a copy of `proof.offset` or `flags.offset`, // as they are pass-by-value (this trick may not always save gas). for {} 1 {} { // Pop from `hashes`. let a := mload(hashesFront) // Pop from `hashes`. let b := mload(add(hashesFront, 0x20)) hashesFront := add(hashesFront, 0x40) // If the flag is false, load the next proof, // else, pops from the queue. if iszero(calldataload(flags.offset)) { // Loads the next proof. b := calldataload(proof.offset) proof.offset := add(proof.offset, 0x20) // Unpop from `hashes`. hashesFront := sub(hashesFront, 0x20) } // Advance to the next flag offset. flags.offset := add(flags.offset, 0x20) // Slot of `a` in scratch space. // If the condition is true: 0x20, otherwise: 0x00. let scratch := shl(5, gt(a, b)) // Hash the scratch space and push the result onto the queue. mstore(scratch, a) mstore(xor(scratch, 0x20), b) mstore(hashesBack, keccak256(0x00, 0x40)) hashesBack := add(hashesBack, 0x20) if iszero(lt(hashesBack, flags.length)) { break } } isValid := and( // Checks if the last value in the queue is same as the root. eq(mload(sub(hashesBack, 0x20)), root), // And whether all the proofs are used, if required. eq(proofEnd, proof.offset) ) break } } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EMPTY CALLDATA HELPERS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns an empty calldata bytes32 array. function emptyProof() internal pure returns (bytes32[] calldata proof) { /// @solidity memory-safe-assembly assembly { proof.length := 0 } } /// @dev Returns an empty calldata bytes32 array. function emptyLeaves() internal pure returns (bytes32[] calldata leaves) { /// @solidity memory-safe-assembly assembly { leaves.length := 0 } } /// @dev Returns an empty calldata bool array. function emptyFlags() internal pure returns (bool[] calldata flags) { /// @solidity memory-safe-assembly assembly { flags.length := 0 } } }
// SPDX-License-Identifier: CC0-1.0 pragma solidity >=0.8.13; /** * @title IDelegateRegistry * @custom:version 2.0 * @custom:author foobar (0xfoobar) * @notice A standalone immutable registry storing delegated permissions from one address to another */ interface IDelegateRegistry { /// @notice Delegation type, NONE is used when a delegation does not exist or is revoked enum DelegationType { NONE, ALL, CONTRACT, ERC721, ERC20, ERC1155 } /// @notice Struct for returning delegations struct Delegation { DelegationType type_; address to; address from; bytes32 rights; address contract_; uint256 tokenId; uint256 amount; } /// @notice Emitted when an address delegates or revokes rights for their entire wallet event DelegateAll(address indexed from, address indexed to, bytes32 rights, bool enable); /// @notice Emitted when an address delegates or revokes rights for a contract address event DelegateContract( address indexed from, address indexed to, address indexed contract_, bytes32 rights, bool enable ); /// @notice Emitted when an address delegates or revokes rights for an ERC721 tokenId event DelegateERC721( address indexed from, address indexed to, address indexed contract_, uint256 tokenId, bytes32 rights, bool enable ); /// @notice Emitted when an address delegates or revokes rights for an amount of ERC20 tokens event DelegateERC20( address indexed from, address indexed to, address indexed contract_, bytes32 rights, uint256 amount ); /// @notice Emitted when an address delegates or revokes rights for an amount of an ERC1155 tokenId event DelegateERC1155( address indexed from, address indexed to, address indexed contract_, uint256 tokenId, bytes32 rights, uint256 amount ); /// @notice Thrown if multicall calldata is malformed error MulticallFailed(); /** * ----------- WRITE ----------- */ /** * @notice Call multiple functions in the current contract and return the data from all of them if they all succeed * @param data The encoded function data for each of the calls to make to this contract * @return results The results from each of the calls passed in via data */ function multicall(bytes[] calldata data) external payable returns (bytes[] memory results); /** * @notice Allow the delegate to act on behalf of `msg.sender` for all contracts * @param to The address to act as delegate * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param enable Whether to enable or disable this delegation, true delegates and false revokes * @return delegationHash The unique identifier of the delegation */ function delegateAll(address to, bytes32 rights, bool enable) external payable returns (bytes32 delegationHash); /** * @notice Allow the delegate to act on behalf of `msg.sender` for a specific contract * @param to The address to act as delegate * @param contract_ The contract whose rights are being delegated * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param enable Whether to enable or disable this delegation, true delegates and false revokes * @return delegationHash The unique identifier of the delegation */ function delegateContract(address to, address contract_, bytes32 rights, bool enable) external payable returns (bytes32 delegationHash); /** * @notice Allow the delegate to act on behalf of `msg.sender` for a specific ERC721 token * @param to The address to act as delegate * @param contract_ The contract whose rights are being delegated * @param tokenId The token id to delegate * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param enable Whether to enable or disable this delegation, true delegates and false revokes * @return delegationHash The unique identifier of the delegation */ function delegateERC721(address to, address contract_, uint256 tokenId, bytes32 rights, bool enable) external payable returns (bytes32 delegationHash); /** * @notice Allow the delegate to act on behalf of `msg.sender` for a specific amount of ERC20 tokens * @dev The actual amount is not encoded in the hash, just the existence of a amount (since it is an upper bound) * @param to The address to act as delegate * @param contract_ The address for the fungible token contract * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param amount The amount to delegate, > 0 delegates and 0 revokes * @return delegationHash The unique identifier of the delegation */ function delegateERC20(address to, address contract_, bytes32 rights, uint256 amount) external payable returns (bytes32 delegationHash); /** * @notice Allow the delegate to act on behalf of `msg.sender` for a specific amount of ERC1155 tokens * @dev The actual amount is not encoded in the hash, just the existence of a amount (since it is an upper bound) * @param to The address to act as delegate * @param contract_ The address of the contract that holds the token * @param tokenId The token id to delegate * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights * @param amount The amount of that token id to delegate, > 0 delegates and 0 revokes * @return delegationHash The unique identifier of the delegation */ function delegateERC1155(address to, address contract_, uint256 tokenId, bytes32 rights, uint256 amount) external payable returns (bytes32 delegationHash); /** * ----------- CHECKS ----------- */ /** * @notice Check if `to` is a delegate of `from` for the entire wallet * @param to The potential delegate address * @param from The potential address who delegated rights * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return valid Whether delegate is granted to act on the from's behalf */ function checkDelegateForAll(address to, address from, bytes32 rights) external view returns (bool); /** * @notice Check if `to` is a delegate of `from` for the specified `contract_` or the entire wallet * @param to The delegated address to check * @param contract_ The specific contract address being checked * @param from The cold wallet who issued the delegation * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return valid Whether delegate is granted to act on from's behalf for entire wallet or that specific contract */ function checkDelegateForContract(address to, address from, address contract_, bytes32 rights) external view returns (bool); /** * @notice Check if `to` is a delegate of `from` for the specific `contract` and `tokenId`, the entire `contract_`, or the entire wallet * @param to The delegated address to check * @param contract_ The specific contract address being checked * @param tokenId The token id for the token to delegating * @param from The wallet that issued the delegation * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return valid Whether delegate is granted to act on from's behalf for entire wallet, that contract, or that specific tokenId */ function checkDelegateForERC721(address to, address from, address contract_, uint256 tokenId, bytes32 rights) external view returns (bool); /** * @notice Returns the amount of ERC20 tokens the delegate is granted rights to act on the behalf of * @param to The delegated address to check * @param contract_ The address of the token contract * @param from The cold wallet who issued the delegation * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return balance The delegated balance, which will be 0 if the delegation does not exist */ function checkDelegateForERC20(address to, address from, address contract_, bytes32 rights) external view returns (uint256); /** * @notice Returns the amount of a ERC1155 tokens the delegate is granted rights to act on the behalf of * @param to The delegated address to check * @param contract_ The address of the token contract * @param tokenId The token id to check the delegated amount of * @param from The cold wallet who issued the delegation * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only * @return balance The delegated balance, which will be 0 if the delegation does not exist */ function checkDelegateForERC1155(address to, address from, address contract_, uint256 tokenId, bytes32 rights) external view returns (uint256); /** * ----------- ENUMERATIONS ----------- */ /** * @notice Returns all enabled delegations a given delegate has received * @param to The address to retrieve delegations for * @return delegations Array of Delegation structs */ function getIncomingDelegations(address to) external view returns (Delegation[] memory delegations); /** * @notice Returns all enabled delegations an address has given out * @param from The address to retrieve delegations for * @return delegations Array of Delegation structs */ function getOutgoingDelegations(address from) external view returns (Delegation[] memory delegations); /** * @notice Returns all hashes associated with enabled delegations an address has received * @param to The address to retrieve incoming delegation hashes for * @return delegationHashes Array of delegation hashes */ function getIncomingDelegationHashes(address to) external view returns (bytes32[] memory delegationHashes); /** * @notice Returns all hashes associated with enabled delegations an address has given out * @param from The address to retrieve outgoing delegation hashes for * @return delegationHashes Array of delegation hashes */ function getOutgoingDelegationHashes(address from) external view returns (bytes32[] memory delegationHashes); /** * @notice Returns the delegations for a given array of delegation hashes * @param delegationHashes is an array of hashes that correspond to delegations * @return delegations Array of Delegation structs, return empty structs for nonexistent or revoked delegations */ function getDelegationsFromHashes(bytes32[] calldata delegationHashes) external view returns (Delegation[] memory delegations); /** * ----------- STORAGE ACCESS ----------- */ /** * @notice Allows external contracts to read arbitrary storage slots */ function readSlot(bytes32 location) external view returns (bytes32); /** * @notice Allows external contracts to read an arbitrary array of storage slots */ function readSlots(bytes32[] calldata locations) external view returns (bytes32[] memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.9.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.9.0) (token/ERC721/IERC721.sol) pragma solidity ^0.8.0; import "../../utils/introspection/IERC165.sol"; /** * @dev Required interface of an ERC721 compliant contract. */ interface IERC721 is IERC165 { /** * @dev Emitted when `tokenId` token is transferred from `from` to `to`. */ event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. */ event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets. */ event ApprovalForAll(address indexed owner, address indexed operator, bool approved); /** * @dev Returns the number of tokens in ``owner``'s account. */ function balanceOf(address owner) external view returns (uint256 balance); /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) external view returns (address owner); /** * @dev Safely transfers `tokenId` token from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external; /** * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients * are aware of the ERC721 protocol to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom(address from, address to, uint256 tokenId) external; /** * @dev Transfers `tokenId` token from `from` to `to`. * * WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721 * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must * understand this adds an external call which potentially creates a reentrancy vulnerability. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom(address from, address to, uint256 tokenId) external; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll} */ function isApprovedForAll(address owner, address operator) external view returns (bool); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; /** * @dev This is a base storage for the initialization function for upgradeable diamond facet contracts **/ library ERC721A__InitializableStorage { struct Layout { /* * Indicates that the contract has been initialized. */ bool _initialized; /* * Indicates that the contract is in the process of being initialized. */ bool _initializing; } bytes32 internal constant STORAGE_SLOT = keccak256('ERC721A.contracts.storage.initializable.facet'); function layout() internal pure returns (Layout storage l) { bytes32 slot = STORAGE_SLOT; assembly { l.slot := slot } } }
// SPDX-License-Identifier: MIT // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; /** * @dev Interface of ERC721A. */ interface IERC721AUpgradeable { /** * The caller must own the token or be an approved operator. */ error ApprovalCallerNotOwnerNorApproved(); /** * The token does not exist. */ error ApprovalQueryForNonexistentToken(); /** * Cannot query the balance for the zero address. */ error BalanceQueryForZeroAddress(); /** * Cannot mint to the zero address. */ error MintToZeroAddress(); /** * The quantity of tokens minted must be more than zero. */ error MintZeroQuantity(); /** * The token does not exist. */ error OwnerQueryForNonexistentToken(); /** * The caller must own the token or be an approved operator. */ error TransferCallerNotOwnerNorApproved(); /** * The token must be owned by `from`. */ error TransferFromIncorrectOwner(); /** * Cannot safely transfer to a contract that does not implement the * ERC721Receiver interface. */ error TransferToNonERC721ReceiverImplementer(); /** * Cannot transfer to the zero address. */ error TransferToZeroAddress(); /** * The token does not exist. */ error URIQueryForNonexistentToken(); /** * The `quantity` minted with ERC2309 exceeds the safety limit. */ error MintERC2309QuantityExceedsLimit(); /** * The `extraData` cannot be set on an unintialized ownership slot. */ error OwnershipNotInitializedForExtraData(); /** * `_sequentialUpTo()` must be greater than `_startTokenId()`. */ error SequentialUpToTooSmall(); /** * The `tokenId` of a sequential mint exceeds `_sequentialUpTo()`. */ error SequentialMintExceedsLimit(); /** * Spot minting requires a `tokenId` greater than `_sequentialUpTo()`. */ error SpotMintTokenIdTooSmall(); /** * Cannot mint over a token that already exists. */ error TokenAlreadyExists(); /** * The feature is not compatible with spot mints. */ error NotCompatibleWithSpotMints(); // ============================================================= // STRUCTS // ============================================================= struct TokenOwnership { // The address of the owner. address addr; // Stores the start time of ownership with minimal overhead for tokenomics. uint64 startTimestamp; // Whether the token has been burned. bool burned; // Arbitrary data similar to `startTimestamp` that can be set via {_extraData}. uint24 extraData; } // ============================================================= // TOKEN COUNTERS // ============================================================= /** * @dev Returns the total number of tokens in existence. * Burned tokens will reduce the count. * To get the total number of tokens minted, please see {_totalMinted}. */ function totalSupply() external view returns (uint256); // ============================================================= // IERC165 // ============================================================= /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified) * to learn more about how these ids are created. * * This function call must use less than 30000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); // ============================================================= // IERC721 // ============================================================= /** * @dev Emitted when `tokenId` token is transferred from `from` to `to`. */ event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. */ event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables or disables * (`approved`) `operator` to manage all of its assets. */ event ApprovalForAll(address indexed owner, address indexed operator, bool approved); /** * @dev Returns the number of tokens in `owner`'s account. */ function balanceOf(address owner) external view returns (uint256 balance); /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) external view returns (address owner); /** * @dev Safely transfers `tokenId` token from `from` to `to`, * checking first that contract recipients are aware of the ERC721 protocol * to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be have been allowed to move * this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement * {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes calldata data ) external payable; /** * @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`. */ function safeTransferFrom( address from, address to, uint256 tokenId ) external payable; /** * @dev Transfers `tokenId` from `from` to `to`. * * WARNING: Usage of this method is discouraged, use {safeTransferFrom} * whenever possible. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token * by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) external payable; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the * zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external payable; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} * for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool _approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll}. */ function isApprovedForAll(address owner, address operator) external view returns (bool); // ============================================================= // IERC721Metadata // ============================================================= /** * @dev Returns the token collection name. */ function name() external view returns (string memory); /** * @dev Returns the token collection symbol. */ function symbol() external view returns (string memory); /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) external view returns (string memory); // ============================================================= // IERC2309 // ============================================================= /** * @dev Emitted when tokens in `fromTokenId` to `toTokenId` * (inclusive) is transferred from `from` to `to`, as defined in the * [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard. * * See {_mintERC2309} for more details. */ event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; library ERC721AStorage { // Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364). struct TokenApprovalRef { address value; } struct Layout { // ============================================================= // STORAGE // ============================================================= // The next token ID to be minted. uint256 _currentIndex; // The number of tokens burned. uint256 _burnCounter; // Token name string _name; // Token symbol string _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) _packedOwnerships; // Mapping owner address to address data. // // Bits Layout: // - [0..63] `balance` // - [64..127] `numberMinted` // - [128..191] `numberBurned` // - [192..255] `aux` mapping(address => uint256) _packedAddressData; // Mapping from token ID to approved address. mapping(uint256 => ERC721AStorage.TokenApprovalRef) _tokenApprovals; // Mapping from owner to operator approvals mapping(address => mapping(address => bool)) _operatorApprovals; // The amount of tokens minted above `_sequentialUpTo()`. // We call these spot mints (i.e. non-sequential mints). uint256 _spotMinted; } bytes32 internal constant STORAGE_SLOT = keccak256('ERC721A.contracts.storage.ERC721A'); function layout() internal pure returns (Layout storage l) { bytes32 slot = STORAGE_SLOT; assembly { l.slot := slot } } }
// 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 // ERC721A Contracts v4.3.0 // Creator: Chiru Labs pragma solidity ^0.8.4; import '../IERC721AUpgradeable.sol'; /** * @dev Interface of ERC721AQueryable. */ interface IERC721AQueryableUpgradeable is IERC721AUpgradeable { /** * Invalid query range (`start` >= `stop`). */ error InvalidQueryRange(); /** * @dev Returns the `TokenOwnership` struct at `tokenId` without reverting. * * If the `tokenId` is out of bounds: * * - `addr = address(0)` * - `startTimestamp = 0` * - `burned = false` * - `extraData = 0` * * If the `tokenId` is burned: * * - `addr = <Address of owner before token was burned>` * - `startTimestamp = <Timestamp when token was burned>` * - `burned = true` * - `extraData = <Extra data when token was burned>` * * Otherwise: * * - `addr = <Address of owner>` * - `startTimestamp = <Timestamp of start of ownership>` * - `burned = false` * - `extraData = <Extra data at start of ownership>` */ function explicitOwnershipOf(uint256 tokenId) external view returns (TokenOwnership memory); /** * @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order. * See {ERC721AQueryable-explicitOwnershipOf} */ function explicitOwnershipsOf(uint256[] memory tokenIds) external view returns (TokenOwnership[] memory); /** * @dev Returns an array of token IDs owned by `owner`, * in the range [`start`, `stop`) * (i.e. `start <= tokenId < stop`). * * This function allows for tokens to be queried if the collection * grows too big for a single call of {ERC721AQueryable-tokensOfOwner}. * * Requirements: * * - `start < stop` */ function tokensOfOwnerIn( address owner, uint256 start, uint256 stop ) external view returns (uint256[] memory); /** * @dev Returns an array of token IDs owned by `owner`. * * This function scans the ownership mapping and is O(`totalSupply`) in complexity. * It is meant to be called off-chain. * * See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into * multiple smaller scans if the collection is large enough to cause * an out-of-gas error (10K collections should be fine). */ function tokensOfOwner(address owner) external view returns (uint256[] memory); }
// 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/ERC165.sol) pragma solidity ^0.8.0; import "./IERC165Upgradeable.sol"; import {Initializable} from "../../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 v4.4.1 (utils/introspection/IERC165.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165 { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts 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); } } }
{ "optimizer": { "enabled": true, "mode": "3" }, "evmVersion": "paris", "outputSelection": { "*": { "*": [ "abi", "metadata" ], "": [ "ast" ] } }, "detectMissingLibraries": false, "forceEVMLA": false, "enableEraVMExtensions": false, "libraries": {} }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceEmpty","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"Blacklisted","type":"error"},{"inputs":[],"name":"Erc20BalanceTooLow","type":"error"},{"inputs":[],"name":"ExcessiveEthSent","type":"error"},{"inputs":[],"name":"InsufficientEthSent","type":"error"},{"inputs":[],"name":"InvalidAmountOfTokens","type":"error"},{"inputs":[],"name":"InvalidConfig","type":"error"},{"inputs":[],"name":"InvalidQueryRange","type":"error"},{"inputs":[],"name":"InvalidReferral","type":"error"},{"inputs":[],"name":"InvalidSignature","type":"error"},{"inputs":[],"name":"InvalidSplitShares","type":"error"},{"inputs":[],"name":"ListMaxSupplyExceeded","type":"error"},{"inputs":[],"name":"LockedForever","type":"error"},{"inputs":[],"name":"MaxBatchSizeExceeded","type":"error"},{"inputs":[],"name":"MaxSupplyExceeded","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintEnded","type":"error"},{"inputs":[],"name":"MintNotYetStarted","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"MintingPaused","type":"error"},{"inputs":[],"name":"NotApprovedToTransfer","type":"error"},{"inputs":[],"name":"NotCompatibleWithSpotMints","type":"error"},{"inputs":[],"name":"NotOwner","type":"error"},{"inputs":[],"name":"NotShareholder","type":"error"},{"inputs":[],"name":"NotTokenOwner","type":"error"},{"inputs":[],"name":"NumberOfMintsExceeded","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"SequentialMintExceedsLimit","type":"error"},{"inputs":[],"name":"SequentialUpToTooSmall","type":"error"},{"inputs":[],"name":"SpotMintTokenIdTooSmall","type":"error"},{"inputs":[],"name":"TokenAlreadyExists","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFailed","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"WalletUnauthorizedToMint","type":"error"},{"inputs":[],"name":"WrongPassword","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"key","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"cid","type":"bytes32"}],"name":"BurnInvited","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"toTokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"ConsecutiveTransfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"key","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"cid","type":"bytes32"}],"name":"Invited","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"affiliate","type":"address"},{"indexed":false,"internalType":"address","name":"token","type":"address"},{"indexed":false,"internalType":"uint128","name":"wad","type":"uint128"},{"indexed":false,"internalType":"uint256","name":"numMints","type":"uint256"}],"name":"Referral","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"src","type":"address"},{"indexed":false,"internalType":"address","name":"token","type":"address"},{"indexed":false,"internalType":"uint128","name":"wad","type":"uint128"}],"name":"Withdrawal","type":"event"},{"inputs":[{"internalType":"address","name":"affiliate","type":"address"}],"name":"affiliateBalance","outputs":[{"internalType":"uint128","name":"","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"affiliate","type":"address"},{"internalType":"address","name":"token","type":"address"}],"name":"affiliateBalanceToken","outputs":[{"internalType":"uint128","name":"","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32","name":"key","type":"bytes32"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"internalType":"struct Auth","name":"auth","type":"tuple"},{"internalType":"address[]","name":"toList","type":"address[]"},{"internalType":"uint256[]","name":"quantityList","type":"uint256[]"},{"internalType":"address","name":"affiliate","type":"address"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"batchMintTo","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"burnInvites","outputs":[{"internalType":"contract IERC721","name":"burnErc721","type":"address"},{"internalType":"address","name":"burnAddress","type":"address"},{"internalType":"address","name":"tokenAddress","type":"address"},{"internalType":"uint128","name":"price","type":"uint128"},{"internalType":"bool","name":"reversed","type":"bool"},{"internalType":"uint16","name":"ratio","type":"uint16"},{"internalType":"uint32","name":"start","type":"uint32"},{"internalType":"uint32","name":"end","type":"uint32"},{"internalType":"uint64","name":"limit","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32","name":"key","type":"bytes32"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"internalType":"struct Auth","name":"auth","type":"tuple"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"burnToMint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"key","type":"bytes32"},{"internalType":"uint256","name":"quantity","type":"uint256"},{"internalType":"bool","name":"affiliateUsed","type":"bool"}],"name":"computePrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"config","outputs":[{"internalType":"string","name":"baseUri","type":"string"},{"internalType":"address","name":"affiliateSigner","type":"address"},{"internalType":"uint32","name":"maxSupply","type":"uint32"},{"internalType":"uint32","name":"maxBatchSize","type":"uint32"},{"internalType":"uint16","name":"affiliateFee","type":"uint16"},{"internalType":"uint16","name":"affiliateDiscount","type":"uint16"},{"internalType":"uint16","name":"defaultRoyalty","type":"uint16"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"explicitOwnershipOf","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint64","name":"startTimestamp","type":"uint64"},{"internalType":"bool","name":"burned","type":"bool"},{"internalType":"uint24","name":"extraData","type":"uint24"}],"internalType":"struct IERC721AUpgradeable.TokenOwnership","name":"ownership","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"explicitOwnershipsOf","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint64","name":"startTimestamp","type":"uint64"},{"internalType":"bool","name":"burned","type":"bool"},{"internalType":"uint24","name":"extraData","type":"uint24"}],"internalType":"struct IERC721AUpgradeable.TokenOwnership[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"msgSender","type":"address"}],"name":"getEffectiveEoaWallet","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"components":[{"internalType":"string","name":"baseUri","type":"string"},{"internalType":"address","name":"affiliateSigner","type":"address"},{"internalType":"uint32","name":"maxSupply","type":"uint32"},{"internalType":"uint32","name":"maxBatchSize","type":"uint32"},{"internalType":"uint16","name":"affiliateFee","type":"uint16"},{"internalType":"uint16","name":"affiliateDiscount","type":"uint16"},{"internalType":"uint16","name":"defaultRoyalty","type":"uint16"}],"internalType":"struct Config","name":"config_","type":"tuple"},{"components":[{"internalType":"uint16","name":"ownerBps","type":"uint16"},{"internalType":"uint16","name":"platformBps","type":"uint16"},{"internalType":"uint16","name":"partnerBps","type":"uint16"},{"internalType":"uint16","name":"superAffiliateBps","type":"uint16"},{"internalType":"address","name":"partner","type":"address"},{"internalType":"address","name":"superAffiliate","type":"address"},{"internalType":"address","name":"ownerAltPayout","type":"address"}],"internalType":"struct PayoutConfig","name":"payoutConfig_","type":"tuple"},{"internalType":"address","name":"_receiver","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"invites","outputs":[{"internalType":"uint128","name":"price","type":"uint128"},{"internalType":"uint128","name":"reservePrice","type":"uint128"},{"internalType":"uint128","name":"delta","type":"uint128"},{"internalType":"uint32","name":"start","type":"uint32"},{"internalType":"uint32","name":"end","type":"uint32"},{"internalType":"uint32","name":"limit","type":"uint32"},{"internalType":"uint32","name":"maxSupply","type":"uint32"},{"internalType":"uint32","name":"interval","type":"uint32"},{"internalType":"uint32","name":"unitSize","type":"uint32"},{"internalType":"address","name":"tokenAddress","type":"address"},{"internalType":"bool","name":"isBlacklist","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"key","type":"bytes32"}],"name":"listSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"password","type":"string"}],"name":"lockAffiliateFee","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"password","type":"string"}],"name":"lockMaxSupply","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"lockOwnerAltPayout","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"password","type":"string"}],"name":"lockURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32","name":"key","type":"bytes32"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"internalType":"struct Auth","name":"auth","type":"tuple"},{"internalType":"uint256","name":"quantity","type":"uint256"},{"internalType":"address","name":"affiliate","type":"address"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32","name":"key","type":"bytes32"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"internalType":"struct Auth","name":"auth","type":"tuple"},{"internalType":"uint256","name":"quantity","type":"uint256"},{"internalType":"address","name":"to","type":"address"},{"internalType":"address","name":"affiliate","type":"address"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"mintTo","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"minter","type":"address"},{"internalType":"bytes32","name":"key","type":"bytes32"}],"name":"minted","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"options","outputs":[{"internalType":"bool","name":"uriLocked","type":"bool"},{"internalType":"bool","name":"maxSupplyLocked","type":"bool"},{"internalType":"bool","name":"affiliateFeeLocked","type":"bool"},{"internalType":"bool","name":"ownerAltPayoutLocked","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"ownerBalance","outputs":[{"internalType":"uint128","name":"","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"ownerBalanceToken","outputs":[{"internalType":"uint128","name":"","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"packedBonusDiscounts","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"payoutConfig","outputs":[{"internalType":"uint16","name":"ownerBps","type":"uint16"},{"internalType":"uint16","name":"platformBps","type":"uint16"},{"internalType":"uint16","name":"partnerBps","type":"uint16"},{"internalType":"uint16","name":"superAffiliateBps","type":"uint16"},{"internalType":"address","name":"partner","type":"address"},{"internalType":"address","name":"superAffiliate","type":"address"},{"internalType":"address","name":"ownerAltPayout","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"platform","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_key","type":"bytes32"},{"internalType":"bytes32","name":"_cid","type":"bytes32"},{"components":[{"internalType":"uint128","name":"price","type":"uint128"},{"internalType":"uint128","name":"reservePrice","type":"uint128"},{"internalType":"uint128","name":"delta","type":"uint128"},{"internalType":"uint32","name":"start","type":"uint32"},{"internalType":"uint32","name":"end","type":"uint32"},{"internalType":"uint32","name":"limit","type":"uint32"},{"internalType":"uint32","name":"maxSupply","type":"uint32"},{"internalType":"uint32","name":"interval","type":"uint32"},{"internalType":"uint32","name":"unitSize","type":"uint32"},{"internalType":"address","name":"tokenAddress","type":"address"},{"internalType":"bool","name":"isBlacklist","type":"bool"}],"internalType":"struct AdvancedInvite","name":"_AdvancedInvite","type":"tuple"}],"name":"setAdvancedInvite","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint16","name":"affiliateDiscount","type":"uint16"}],"name":"setAffiliateDiscount","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint16","name":"affiliateFee","type":"uint16"}],"name":"setAffiliateFee","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"baseUri","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_key","type":"bytes32"},{"components":[{"internalType":"uint16","name":"numMints","type":"uint16"},{"internalType":"uint16","name":"numBonusMints","type":"uint16"}],"internalType":"struct BonusDiscount[]","name":"_bonusDiscounts","type":"tuple[]"}],"name":"setBonusDiscounts","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_key","type":"bytes32"},{"internalType":"bytes32","name":"_cid","type":"bytes32"},{"components":[{"internalType":"uint128","name":"price","type":"uint128"},{"internalType":"uint128","name":"reservePrice","type":"uint128"},{"internalType":"uint128","name":"delta","type":"uint128"},{"internalType":"uint32","name":"start","type":"uint32"},{"internalType":"uint32","name":"end","type":"uint32"},{"internalType":"uint32","name":"limit","type":"uint32"},{"internalType":"uint32","name":"maxSupply","type":"uint32"},{"internalType":"uint32","name":"interval","type":"uint32"},{"internalType":"uint32","name":"unitSize","type":"uint32"},{"internalType":"address","name":"tokenAddress","type":"address"},{"internalType":"bool","name":"isBlacklist","type":"bool"}],"internalType":"struct AdvancedInvite","name":"_advancedInvite","type":"tuple"},{"components":[{"internalType":"uint16","name":"numMints","type":"uint16"},{"internalType":"uint16","name":"numBonusMints","type":"uint16"}],"internalType":"struct BonusDiscount[]","name":"_bonusDiscount","type":"tuple[]"}],"name":"setBonusInvite","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_key","type":"bytes32"},{"internalType":"bytes32","name":"_cid","type":"bytes32"},{"components":[{"internalType":"contract IERC721","name":"burnErc721","type":"address"},{"internalType":"address","name":"burnAddress","type":"address"},{"internalType":"address","name":"tokenAddress","type":"address"},{"internalType":"uint128","name":"price","type":"uint128"},{"internalType":"bool","name":"reversed","type":"bool"},{"internalType":"uint16","name":"ratio","type":"uint16"},{"internalType":"uint32","name":"start","type":"uint32"},{"internalType":"uint32","name":"end","type":"uint32"},{"internalType":"uint64","name":"limit","type":"uint64"}],"internalType":"struct BurnInvite","name":"_burnInvite","type":"tuple"}],"name":"setBurnInvite","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint16","name":"feeNumerator","type":"uint16"}],"name":"setDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_key","type":"bytes32"},{"internalType":"bytes32","name":"_cid","type":"bytes32"},{"components":[{"internalType":"uint128","name":"price","type":"uint128"},{"internalType":"uint32","name":"start","type":"uint32"},{"internalType":"uint32","name":"end","type":"uint32"},{"internalType":"uint32","name":"limit","type":"uint32"},{"internalType":"uint32","name":"maxSupply","type":"uint32"},{"internalType":"uint32","name":"unitSize","type":"uint32"},{"internalType":"address","name":"tokenAddress","type":"address"},{"internalType":"bool","name":"isBlacklist","type":"bool"}],"internalType":"struct Invite","name":"_invite","type":"tuple"}],"name":"setInvite","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint32","name":"maxBatchSize","type":"uint32"}],"name":"setMaxBatchSize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint32","name":"maxSupply","type":"uint32"},{"internalType":"string","name":"password","type":"string"}],"name":"setMaxSupply","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"ownerAltPayout","type":"address"}],"name":"setOwnerAltPayout","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"tokensOfOwner","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"start","type":"uint256"},{"internalType":"uint256","name":"stop","type":"uint256"}],"name":"tokensOfOwnerIn","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdrawAffiliate","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"tokens","type":"address[]"}],"name":"withdrawTokens","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"tokens","type":"address[]"}],"name":"withdrawTokensAffiliate","outputs":[],"stateMutability":"nonpayable","type":"function"}]
Contract Creation Code
9c4d535b000000000000000000000000000000000000000000000000000000000000000001000ccd3af5b5aed5db5f01add9ca8578d520197e5ffab1abe659f6b2e2316300000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0004000000000002002a000000000002000000600410027000000bb3034001970003000000310355000200000001035500000bb30040019d0000008004000039000000400040043f0000000100200190000000290000c13d000000040030008c000015b70000413d000000000201043b000000e00220027000000bb50020009c000000310000213d00000be30020009c0000005a0000a13d00000be40020009c0000009a0000213d00000bf00020009c000001db0000213d00000bf60020009c000004ba0000213d00000bf90020009c000008fa0000613d00000bfa0020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d000000c001000039000000400010043f0000000101000039000000800010043f000000a00000043f00000080010000392ec81df30000040f000000000100001900002ec90001042e0000000001000416000000000001004b000015b70000c13d00000020010000390000010000100443000001200000044300000bb40100004100002ec90001042e00000bb60020009c000000700000a13d00000bb70020009c0000013f0000213d00000bc30020009c000002080000213d00000bc90020009c000004cf0000213d00000bcc0020009c0000098c0000613d00000bcd0020009c000015b70000c13d000000840030008c000015b70000413d0000000402100370000000000202043b002a00000002001d00000c100020009c000015b70000213d0000002402100370000000000202043b002900000002001d00000c100020009c000015b70000213d0000006402100370000000000402043b00000c1b0040009c000015b70000213d0000002302400039000000000032004b000015b70000813d0000000402400039000000000221034f000000000202043b0000004401100370000000000101043b002800000001001d00000024014000392ec81b090000040f0000000004010019000004c90000013d00000bfb0020009c000001520000a13d00000bfc0020009c000001860000213d00000c020020009c0000039f0000213d00000c050020009c000006db0000613d00000c060020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d00000c9501000041000000000101041a00000cac0110016700000c2402000041000000000202041a0000000001120019000000800010043f00000c310100004100002ec90001042e00000bce0020009c000001690000a13d00000bcf0020009c000001910000213d00000bd50020009c000003b50000213d00000bd80020009c000006e70000613d00000bd90020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d00000c4001000041000000000201041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000442013f0000000100400190000006d50000c13d000000800010043f000000000003004b00000d420000613d00000c4002000041000000000020043f000000000001004b000000000200001900000d470000613d00000c41030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000000920000413d00000d470000013d00000be50020009c000002320000213d00000beb0020009c000004db0000213d00000bee0020009c0000099d0000613d00000bef0020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000202043b00000c1b0020009c000015b70000213d0000002304200039000000000034004b000015b70000813d002900040020003d0000002904100360000000000504043b00000c1b0050009c000015b70000213d000000050450021000000000024200190000002402200039000000000032004b000015b70000213d000000800050043f000000a002400039000000400020043f000000000005004b000000f70000c13d00000020010000390000000001120436000000800300043d00000000003104350000004001200039000000000003004b00000d4f0000613d0000008004000039000000000500001900000020044000390000000006040433000000008706043400000c10077001970000000007710436000000000808043300000c1b08800197000000000087043500000040076000390000000007070433000000000007004b0000000007000039000000010700c039000000400810003900000000007804350000006006600039000000000606043300000c6d066001970000006007100039000000000067043500000080011000390000000105500039000000000035004b000000c60000413d00000d4f0000013d000000000301034f0000000201000367000000000303043b000000000303041a0000008004200039000000400040043f0000006004200039000000e805300270000000000054043500000c27003001980000000004000039000000010400c0390000004005200039000000000045043500000c10043001970000000004420436000000a00330027000000c1b033001970000000000340435000000200460008c00000080036000390000000000230435000000400200043d000000bd0000613d00000000060400190000002903400029000000000331034f000000000403043b00000c1c0020009c00000dce0000213d0000008003200039000000400030043f0000006003200039000000000003043500000040032000390000000000030435000000200320003900000000000304350000000000020435000000000004004b000000f20000613d00000c2403000041000000000303041a000000000043004b000000f20000a13d002800000006001d002a00000004001d000000000040043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a000000000001004b000001210000c13d0000002a04000029000000010440008a0000010d0000013d000000400100043d00000c1c0010009c0000002a0300002900000dce0000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000030043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000400200043d00000c1c0020009c0000002806000029000000df0000a13d00000dce0000013d00000bb80020009c000002a60000213d00000bbe0020009c000005290000213d00000bc10020009c00000a140000613d00000bc20020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b00000c100010009c000015b70000213d2ec824960000040f00000a880000013d00000c070020009c000002d40000a13d00000c080020009c000004930000213d00000c0b0020009c0000083e0000613d00000c0c0020009c000015b70000c13d000000440030008c000015b70000413d0000000402100370000000000202043b002900000002001d00000c100020009c000015b70000213d0000002401100370000000000101043b000000000001004b00000d660000c13d00000c9c01000041000000000010043f00000c2d0100004100002eca0001043000000bda0020009c000002f90000a13d00000bdb0020009c000004ae0000213d00000bde0020009c000008670000613d00000bdf0020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b002600000001001d00000c100010009c000015b70000213d00000c2401000041000000000101041a000000000001004b00000d580000613d002500010010009400000db80000c13d0000006002000039002a00000004001d00000000010400192ec81ba70000040f00000d4e0000013d00000bfd0020009c000004180000213d00000c000020009c000007100000613d00000c010020009c000015b70000c13d00000000010300192ec81af70000040f2ec81ce00000040f000000000100001900002ec90001042e00000bd00020009c0000045e0000213d00000bd30020009c000007c00000613d00000bd40020009c000015b70000c13d000000440030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000202043b002a00000002001d00000c100020009c000015b70000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039002900000002001d000000000012004b000015b70000c13d000000000100041100000c1001100197000000000010043f00000c3d01000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b0000002a02000029000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000201041a00000cad022001970000002903000029000000000232019f000000000021041b000000400100043d000000000031043500000bb30010009c00000bb3010080410000004001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c3e011001c70000800d02000039000000030300003900000c3f0400004100000000050004110000002a0600002900000d2c0000013d00000bf10020009c000005cd0000213d00000bf40020009c00000a310000613d00000bf50020009c000015b70000c13d000000840030008c000015b70000413d0000000402100370000000000202043b00000c1b0020009c000015b70000213d002a00040020003d0000002a0230006a00000c320020009c000015b70000213d000000400020008c000015b70000413d0000002402100370000000000202043b002900000002001d0000004402100370000000000202043b002800000002001d00000c100020009c000015b70000213d0000006401100370000000000101043b00000c1b0010009c000015b70000213d000000040110003900000000020300192ec81b410000040f002700000001001d002600000002001d2ec826580000040f00000000030100190000002a0100002900000029020000290000002804000029000000270500002900000026060000292ec8216f0000040f000000000100001900002ec90001042e00000bc40020009c000005ee0000213d00000bc70020009c00000a6f0000613d00000bc80020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000201043b000000000002004b00000e200000613d00000c2401000041000000000101041a000000000021004b00000e200000a13d002900000002001d002a00000002001d000000000020043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a000000000001004b00000e090000c13d0000002a02000029000000000002004b000000010220008a0000021c0000c13d000008610000013d00000be60020009c000006920000213d00000be90020009c00000a800000613d00000bea0020009c000015b70000c13d000001440030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000002402100370000000000202043b002a00000002001d0000000401100370000000000101043b002900000001001d000000000100041100000c150010009c000002520000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d00000002010003670000004402100370000000000202043b002800000002001d00000c300020009c000015b70000213d0000006402100370000000000202043b002700000002001d00000bb30020009c000015b70000213d0000008402100370000000000202043b002600000002001d00000bb30020009c000015b70000213d000000a402100370000000000202043b002500000002001d00000bb30020009c000015b70000213d000000c402100370000000000202043b002400000002001d00000bb30020009c000015b70000213d000000e402100370000000000202043b002300000002001d00000bb30020009c000015b70000213d0000010402100370000000000202043b002200000002001d00000c100020009c000015b70000213d0000012401100370000000000201043b000000000002004b0000000001000039000000010100c039002100000002001d000000000012004b000015b70000c13d2ec81a420000040f0000000003010019000001400110003900000021020000290000000000210435000001200130003900000022020000290000000000210435000001000130003900000023020000290000000000210435000000c00130003900000024020000290000000000210435000000a001300039000000250200002900000000002104350000008001300039000000260200002900000000002104350000006001300039000000270200002900000000002104350000002001300039000000280200002900000000002104350000000000230435000000e00130003900000000000104350000004001300039000000000001043500000029010000290000002a020000292ec81bb60000040f000000000100001900002ec90001042e00000bb90020009c000006a10000213d00000bbc0020009c00000a8a0000613d00000bbd0020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b002a00000001001d00000c100010009c000015b70000213d000000000100041100000c150010009c000002c50000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000a401000039000000000101041a00000c180010019800000d5c0000c13d000000a301000039000000000201041a00000c19022001970000002a022001af000000000021041b000000000100001900002ec90001042e00000c0d0020009c00000c640000613d00000c0e0020009c000006ad0000613d00000c0f0020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d00000c7c01000041000000000201041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000043004b000006d50000c13d000000800010043f000000000003004b00000d420000613d00000c7c02000041000000000020043f000000000001004b000000000200001900000d470000613d00000c7e030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000002f10000413d00000d470000013d00000be00020009c00000d190000613d00000be10020009c000006c70000613d00000be20020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000402043b00000c1b0040009c000015b70000213d0000002302400039000000000032004b000015b70000813d0000000405400039000000000251034f000000000202043b00000c1b0020009c00000dce0000213d0000001f0620003900000cae066001970000003f0660003900000cae0660019700000c1c0060009c00000dce0000213d00000024044000390000008006600039000000400060043f000000800020043f0000000004420019000000000034004b000015b70000213d0000002003500039000000000331034f00000cae042001980000001f0520018f000000a001400039000003290000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b000003250000c13d000000000005004b000003360000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a0012000390000000000010435000000000100041100000c150010009c000003470000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000400100043d0000002002100039000000800300043d000000000003004b000003580000613d00000000040000190000000005240019000000a006400039000000000606043300000000006504350000002004400039000000000034004b000003510000413d0000000004230019000000000004043500000000003104350000003f0330003900000cae043001970000000003140019000000000043004b0000000004000039000000010400403900000c1b0030009c00000dce0000213d000000010040019000000dce0000c13d000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b002a00000001001d000000400100043d0000000702000039000000000221043600000c1e03000041000000000032043500000c1f0010009c00000dce0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b0000002a0010006b0000107f0000c13d000000a401000039000000000201041a00000caf0220019700000100022001bf000000000021041b000000000100001900002ec90001042e00000c030020009c000007ca0000613d00000c040020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d00000000010300192ec81ae70000040f002a00000002001d00000c1001100197000000000010043f0000009d01000039000000200010043f000000400200003900000000010000192ec82ea90000040f0000002a020000292ec81cd00000040f000000000101041a00000c300110019700000c1a0000013d00000bd60020009c000007f90000613d00000bd70020009c000015b70000c13d000000640030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000202043b002600000002001d00000c100020009c000015b70000213d0000004402100370000000000202043b0000002401100370000000000301043b000000000023004b00000d580000813d00000c2401000041000000000101041a000000000012004b0000000002018019002500000002001d000000010030008c000000010300a0390000002601000029000000000001004b00000dbc0000613d002900000003001d000000000010043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d002300600000003d000000000101043b0000002903000029000000250230006b000010a10000a13d000000000101041a00000c1b01100198000010a10000613d000000000012004b0000000002018019002400000002001d0000000501200210000000400200043d002300000002001d00000000012100190000002001100039000000400010043f002800000001001d00000c1c0010009c00000dce0000213d00000028020000290000008001200039000000400010043f000000600120003900000000000104350000004001200039000000000001043500000020012000390000000000010435000000000002043500000c2401000041000000000101041a000000000031004b000000000100001900000f140000a13d0000002901000029002a00000001001d000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a000000000001004b0000101d0000c13d0000002a01000029000000010110008a000004040000013d00000bfe0020009c0000080d0000613d00000bff0020009c000015b70000c13d000000440030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000002402100370000000000202043b002a00000002001d0000000401100370000000000101043b000000000010043f0000006601000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000400200043d002900000002001d00000c1f0020009c00000dce0000213d000000000101043b00000029040000290000004002400039000000400020043f000000000101041a0000002003400039000000a002100270000000000023043500000c100110019800000000001404350000044f0000c13d000000400100043d002900000001001d00000c1f0010009c00000dce0000213d00000029040000290000004001400039000000400010043f0000006501000039000000000101041a0000002003400039000000a002100270000000000023043500000c100110019700000000001404350000002a010000292ec81de50000040f00000029020000290000000002020433000027100110011a000000400300043d0000002004300039000000000014043500000c1001200197000000000013043500000bb30030009c00000bb303008041000000400130021000000c8d011001c700002ec90001042e00000bd10020009c000008210000613d00000bd20020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b000000000010043f0000009701000039000000200010043f000000400200003900000000010000192ec82ea90000040f0000000202100039000000000202041a0000000103100039000000000303041a000000000101041a00000c3004100197000000800040043f0000008001100270000000a00010043f00000c3001300197000000c00010043f000000800130027000000bb301100197000000e00010043f000000a00130027000000bb301100197000001000010043f000000c00130027000000bb301100197000001200010043f000000e001300270000001400010043f00000bb301200197000001600010043f000000200120027000000bb301100197000001800010043f000000400120027000000c1001100197000001a00010043f00000c3b002001980000000001000039000000010100c039000001c00010043f00000c3c0100004100002ec90001042e00000c090020009c000008a50000613d00000c0a0020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d000000a401000039000000000101041a000000ff001001900000000002000039000000010200c039000000800020043f0000ff00001001900000000002000039000000010200c039000000a00020043f00000c42001001980000000002000039000000010200c039000000c00020043f00000c18001001980000000001000039000000010100c039000000e00010043f00000c960100004100002ec90001042e00000bdc0020009c000008d00000613d00000bdd0020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d000000000100041a00000c1001100197000000800010043f00000c310100004100002ec90001042e00000bf70020009c00000a980000613d00000bf80020009c000015b70000c13d00000000010300192ec81af70000040f002a00000001001d002900000002001d002800000003001d000000400100043d002700000001001d00000020020000392ec81a300000040f000000270400002900000000000404350000002a01000029000000290200002900000028030000292ec822610000040f000000000100001900002ec90001042e00000bca0020009c00000b470000613d00000bcb0020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d000000000000043f0000009c01000039000000200010043f00000c2f010000410000081c0000013d00000bec0020009c00000bc20000613d00000bed0020009c000015b70000c13d000001c40030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000002402100370000000000202043b002900000002001d0000000402100370000000000202043b002a00000002001d000001a402100370000000000202043b00000c1b0020009c000015b70000213d0000002304200039000000000034004b000015b70000813d0000000404200039000000000141034f000000000701043b00000c1b0070009c000015b70000213d000000240820003900000006017002100000000001810019000000000031004b000015b70000213d000000000300041100000c150030009c0000000001030019000005100000c13d002700000008001d002800000007001d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000280700002900000027080000290000000003000411000000000200041a000000000112013f00000c100010019800001a080000c13d00000c1001200197000000000031004b00000e5d0000c13d000000080070008c00000be90000213d000000000007004b000000000900001900000f7b0000c13d002800000009001d0000002a010000292ec81ad70000040f0000002802000029000000000021041b00000000010000312ec81a5a0000040f00000000030100190000002a0100002900000029020000292ec81bb60000040f000000000100001900002ec90001042e00000bbf0020009c00000bca0000613d00000bc00020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000402043b00000c1b0040009c000015b70000213d0000002302400039000000000032004b000015b70000813d0000000405400039000000000251034f000000000202043b00000c1b0020009c00000dce0000213d0000001f0620003900000cae066001970000003f0660003900000cae0660019700000c1c0060009c00000dce0000213d00000024044000390000008006600039000000400060043f000000800020043f0000000004420019000000000034004b000015b70000213d0000002003500039000000000331034f00000cae042001980000001f0520018f000000a001400039000005570000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b000005530000c13d000000000005004b000005640000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a0012000390000000000010435000000000100041100000c150010009c000005750000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000400100043d0000002002100039000000800300043d000000000003004b000005860000613d00000000040000190000000005240019000000a006400039000000000606043300000000006504350000002004400039000000000034004b0000057f0000413d0000000004230019000000000004043500000000003104350000003f0330003900000cae043001970000000003140019000000000043004b0000000004000039000000010400403900000c1b0030009c00000dce0000213d000000010040019000000dce0000c13d000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b002a00000001001d000000400100043d0000000702000039000000000221043600000c1e03000041000000000032043500000c1f0010009c00000dce0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b0000002a0010006b0000107f0000c13d000000a401000039000000000201041a00000cad0220019700000001022001bf000000000021041b000000000100001900002ec90001042e00000bf20020009c00000bed0000613d00000bf30020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d000000000100041100000c150010009c000005e30000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000a401000039000000000201041a00000c700220019700000c71022001c7000000000021041b000000000100001900002ec90001042e00000bc50020009c00000bf40000613d00000bc60020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000402043b00000c1b0040009c000015b70000213d0000002302400039000000000032004b000015b70000813d0000000405400039000000000251034f000000000202043b00000c1b0020009c00000dce0000213d0000001f0620003900000cae066001970000003f0660003900000cae0660019700000c1c0060009c00000dce0000213d00000024044000390000008006600039000000400060043f000000800020043f0000000004420019000000000034004b000015b70000213d0000002003500039000000000331034f00000cae042001980000001f0520018f000000a0014000390000061c0000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b000006180000c13d000000000005004b000006290000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a0012000390000000000010435000000000100041100000c150010009c0000063a0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000400100043d0000002002100039000000800300043d000000000003004b0000064b0000613d00000000040000190000000005240019000000a006400039000000000606043300000000006504350000002004400039000000000034004b000006440000413d0000000004230019000000000004043500000000003104350000003f0330003900000cae043001970000000003140019000000000043004b0000000004000039000000010400403900000c1b0030009c00000dce0000213d000000010040019000000dce0000c13d000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b002a00000001001d000000400100043d0000000702000039000000000221043600000c1e03000041000000000032043500000c1f0010009c00000dce0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b0000002a0010006b0000107f0000c13d000000a401000039000000000201041a00000c220220019700000c23022001c7000000000021041b000000000100001900002ec90001042e00000be70020009c00000c210000613d00000be80020009c000015b70000c13d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b00000c100010009c000015b70000213d2ec821570000040f00000c1a0000013d00000bba0020009c00000c480000613d00000bbb0020009c000015b70000c13d0000000001000416000000000001004b000015b70000c13d00000000010300192ec81b6e0000040f2ec825140000040f000000000100001900002ec90001042e000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000201043b00000c9e00200198000015b70000c13d000000010100003900000c9f0220019700000ca00020009c000006c30000613d00000ca10020009c000006c30000613d00000ca20020009c000006c30000613d00000ca00020009c0000000001000039000000010100603900000ca30020009c00000001011061bf000000010110018f000000800010043f00000c310100004100002ec90001042e0000000001000416000000000001004b000015b70000c13d0000009e03000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f000000010050019000000d3a0000613d00000c6401000041000000000010043f0000002201000039000000040010043f00000c470100004100002eca000104300000000001000416000000000001004b000015b70000c13d000000c001000039000000400010043f0000000101000039000000800010043f000000a00000043f00000080010000392ec825140000040f000000000100001900002ec90001042e000000a40030008c000015b70000413d0000000402100370000000000202043b00000c1b0020009c000015b70000213d002a00040020003d0000002a0230006a00000c320020009c000015b70000213d000000400020008c000015b70000413d0000002402100370000000000202043b002900000002001d0000004402100370000000000202043b002800000002001d00000c100020009c000015b70000213d0000006402100370000000000202043b002700000002001d00000c100020009c000015b70000213d0000008401100370000000000101043b00000c1b0010009c000015b70000213d000000040110003900000000020300192ec81b410000040f000000000501001900000000060200190000002a010000290000002902000029000000280300002900000027040000292ec8216f0000040f000000000100001900002ec90001042e000001640030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000002402100370000000000202043b002900000002001d0000000402100370000000000202043b002a00000002001d000001a002000039000000400020043f0000004402100370000000000202043b00000c100020009c000015b70000213d000000800020043f0000006402100370000000000202043b00000c100020009c000015b70000213d000000a00020043f0000008402100370000000000202043b00000c100020009c000015b70000213d000000c00020043f000000a402100370000000000202043b00000c300020009c000015b70000213d000000e00020043f000000c402100370000000000202043b000000000002004b0000000003000039000000010300c039000000000032004b000015b70000c13d000001000020043f000000e402100370000000000202043b0000ffff0020008c000015b70000213d000001200020043f0000010402100370000000000202043b00000bb30020009c000015b70000213d000001400020043f0000012402100370000000000202043b00000bb30020009c000015b70000213d000001600020043f0000014401100370000000000101043b00000c1b0010009c000015b70000213d000001800010043f000000000100041100000c150010009c0000075c0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000001400100043d002800000001001d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000280200002900000bb302200197000000000012004b000007740000813d00000bb301100197000001400010043f0000002a01000029000000000010043f0000009901000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000800200043d00000c1002200197000000000101043b000000000301041a00000c1903300197000000000223019f000000000021041b000000a00200043d00000c10022001970000000103100039000000000403041a00000c1904400197000000000224019f000000000023041b000000c00200043d00000c10022001970000000203100039000000000403041a00000c1904400197000000000224019f000000000023041b000000e00200043d00000c30022001970000000303100039000000000403041a00000c8e04400197000000000224019f000001000400043d000000000004004b00000c8f040000410000000004006019000000000242019f000001200400043d000000880440021000000c9004400197000000000242019f000001400400043d000000980440021000000c9104400197000000000242019f000001600400043d000000b80440021000000c9204400197000000000242019f000000000023041b0000000401100039000001800200043d00000c1b02200197000000000301041a00000c8603300197000000000223019f000000000021041b000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000030300003900000c93040000410000002a05000029000000290600002900000d2c0000013d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b000000000010043f0000009b01000039000009950000013d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b000000000010043f0000009901000039000000200010043f000000400200003900000000010000192ec82ea90000040f0000000402100039000000000202041a0000000303100039000000000303041a0000000204100039000000000404041a0000000105100039000000000505041a000000000101041a00000c1001100197000000800010043f00000c1001500197000000a00010043f00000c1001400197000000c00010043f00000c3001300197000000e00010043f00000c4f003001980000000001000039000000010100c039000001000010043f00000088013002700000ffff0110018f000001200010043f000000980130027000000bb301100197000001400010043f000000b80130027000000bb301100197000001600010043f00000c1b01200197000001800010043f00000c940100004100002ec90001042e000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b00000c100010009c000015b70000213d000000000010043f0000009d01000039000000200010043f000000400200003900000000010000192ec82ea90000040f000000000000043f000000200010043f000000000100001900000040020000390000081b0000013d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b00000c100010009c000015b70000213d000000000010043f0000009c01000039000000200010043f000000400200003900000000010000192ec82ea90000040f000000000101041a00000c3001100197000000800010043f00000c310100004100002ec90001042e000000440030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000202043b00000c100020009c000015b70000213d0000002401100370000000000101043b002a00000001001d00000000010200192ec824960000040f00000c1001100197000000000010043f0000009a01000039000000200010043f000000400200003900000000010000192ec82ea90000040f0000002a02000029000000000020043f000000200010043f000000000100001900000040020000392ec82ea90000040f000000000101041a00000c1a0000013d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000201043b000000000002004b00000e2f0000613d00000c2401000041000000000101041a000000000021004b00000e2f0000a13d002900000002001d002a00000002001d000000000020043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a000000000001004b00000e240000c13d0000002a02000029000000000002004b000000010220008a0000084c0000c13d00000c6401000041000000000010043f0000001101000039000000040010043f00000c470100004100002eca00010430000000440030008c000015b70000413d0000000402100370000000000202043b002400000002001d00000c1b0020009c000015b70000213d0000002402000029002300040020003d000000230230006a00000c320020009c000015b70000213d000000400020008c000015b70000413d0000002402100370000000000202043b00000c1b0020009c000015b70000213d0000002304200039000000000034004b000015b70000813d0000000404200039000000000441034f000000000404043b002a00000004001d00000c1b0040009c000015b70000213d002900240020003d0000002a0200002900000005022002100000002902200029000000000032004b000015b70000213d0000002301100360000000000101043b002200000001001d000000000010043f0000009901000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d00000c2402000041000000000202041a002000000002001d000000000101043b002800000001001d0000000401100039001f00000001001d000000000101041a00210c1b0010019c00000f610000c13d00000c6701000041000000000010043f00000c2d0100004100002eca00010430000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b002a00000001001d0000ffff0010008c000015b70000213d000000000100041100000c150010009c000008be0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000a401000039000000000101041a00000c420010019800000d5c0000c13d0000002a01000029000013890010008c00000be90000813d0000002a01000029000000e00110021000000c81011001970000009f02000039000000000302041a00000c800330019700000c440000013d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b002a00000001001d0000ffff0010008c000015b70000213d000000000100041100000c150010009c000008e90000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000a401000039000000000101041a00000c420010019800000d5c0000c13d0000002a01000029000013880010008c00000be90000213d0000002a01000029000000f0011002100000009f02000039000000000302041a00000c430330019700000c440000013d000001640030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000402043b00000c1b0040009c000015b70000213d0000002302400039000000000032004b000015b70000813d0000000405400039000000000251034f000000000202043b00000c1b0020009c00000dce0000213d0000001f0620003900000cae066001970000003f0660003900000cae0660019700000c1c0060009c00000dce0000213d00000024044000390000008006600039000000400060043f000000800020043f0000000004420019000000000034004b000015b70000213d0000002004500039000000000541034f00000cae062001980000001f0720018f000000a004600039000009240000613d000000a008000039000000000905034f000000009a09043c0000000008a80436000000000048004b000009200000c13d000000000007004b000009310000613d000000000565034f0000000306700210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f0000000000540435000000a00220003900000000000204350000002402100370000000000402043b00000c1b0040009c000015b70000213d0000002302400039000000000032004b000015b70000813d0000000405400039000000000251034f000000000202043b00000c1b0020009c00000dce0000213d0000001f0620003900000cae066001970000003f0660003900000cae06600197000000400700043d0000000006670019002a00000007001d000000000076004b0000000007000039000000010700403900000c1b0060009c00000dce0000213d000000010070019000000dce0000c13d0000002404400039000000400060043f0000002a060000290000000006260436002900000006001d0000000004420019000000000034004b000015b70000213d0000002004500039000000000541034f00000cae062001980000001f0720018f0000002904600029000009610000613d000000000805034f0000002909000029000000008a08043c0000000009a90436000000000049004b0000095d0000c13d000000000007004b0000096e0000613d000000000565034f0000000306700210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f0000000000540435000000290220002900000000000204350000004402100370000000000202043b002800000002001d00000c1b0020009c000015b70000213d0000002802000029002700040020003d000000270230006a00000c320020009c000015b70000213d000000e00020008c000015b70000413d0000014401100370000000000101043b002600000001001d00000c100010009c000015b70000213d00000c7801000041000000000101041a0025ff00001001940000115a0000c13d000000ff00100190000012230000c13d00000c730110019700000101011001bf00000c7802000041000000000012041b0000116c0000013d000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b000000000010043f0000009801000039000000200010043f000000400200003900000000010000192ec82ea90000040f000000000101041a000000800010043f00000c310100004100002ec90001042e000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000402043b00000c1b0040009c000015b70000213d0000002302400039000000000032004b000015b70000813d0000000405400039000000000251034f000000000202043b00000c1b0020009c00000dce0000213d0000001f0620003900000cae066001970000003f0660003900000cae0660019700000c1c0060009c00000dce0000213d00000024044000390000008006600039000000400060043f000000800020043f0000000004420019000000000034004b000015b70000213d0000002003500039000000000331034f00000cae042001980000001f0520018f000000a001400039000009c70000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b000009c30000c13d000000000005004b000009d40000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a0012000390000000000010435000000000100041100000c150010009c000009e50000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000a401000039000000000101041a000000ff0010019000000d5c0000c13d000000800200043d00000c1b0020009c00000dce0000213d0000009e01000039000000000401041a000000010040019000000001034002700000007f0330618f0000001f0030008c00000000050000390000000105002039000000000454013f0000000100400190000006d50000c13d000000200030008c00000a0c0000413d000000000010043f0000001f04200039000000050440027000000c6e0440009a000000200020008c00000c2a040040410000001f03300039000000050330027000000c6e0330009a000000000034004b00000a0c0000813d000000000004041b0000000104400039000000000034004b00000a080000413d0000001f0020008c000010940000a13d000000000010043f00000cae04200198000010e20000c13d000000a00500003900000c2a03000041000010f00000013d0000000001000416000000000001004b000015b70000c13d000000a301000039000000000101041a000000a202000039000000000202041a000000a103000039000000000303041a0000ffff0430018f000000800040043f00000010043002700000ffff0440018f000000a00040043f00000020043002700000ffff0440018f000000c00040043f00000030043002700000ffff0440018f000000e00040043f000000400330027000000c1003300197000001000030043f00000c1002200197000001200020043f00000c1001100197000001400010043f00000c210100004100002ec90001042e000000440030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000202043b002a00000002001d00000c100020009c000015b70000213d0000002401100370000000000101043b002900000001001d0000ffff0010008c000015b70000213d000000000100041100000c150010009c00000a4f0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000a001000039000000000201041a00000c73022001970000002903000029000000000232019f000000000021041b000027110030008c00000e460000413d000000400100043d000000640210003900000c8a030000410000000000320435000000440210003900000c8b03000041000000000032043500000024021000390000002a03000039000000000032043500000c1102000041000000000021043500000004021000390000002003000039000000000032043500000bb30010009c00000bb301008041000000400110021000000c7b011001c700002eca00010430000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b2ec824370000040f000000400200043d002a00000002001d2ec81b5b0000040f0000002a0100002900000bb30010009c00000bb301008041000000400110021000000c2e011001c700002ec90001042e000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b2ec826690000040f00000c100110019700000c1a0000013d0000000001000416000000000001004b000015b70000c13d00000000010300192ec81ae70000040f002a00000002001d2ec81cbf0000040f0000002a020000292ec81cd00000040f000000000101041a000000ff001001900000000001000039000000010100c03900000c1a0000013d000000440030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000202043b002a00000002001d00000bb30020009c000015b70000213d0000002402100370000000000402043b00000c1b0040009c000015b70000213d0000002302400039000000000032004b000015b70000813d0000000405400039000000000251034f000000000202043b00000c1b0020009c00000dce0000213d0000001f0620003900000cae066001970000003f0660003900000cae0660019700000c1c0060009c00000dce0000213d00000024044000390000008006600039000000400060043f000000800020043f0000000004420019000000000034004b000015b70000213d0000002003500039000000000331034f00000cae042001980000001f0520018f000000a00140003900000ac70000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b00000ac30000c13d000000000005004b00000ad40000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a0012000390000000000010435000000000100041100000c150010009c00000ae50000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000000400100043d0000002002100039000000800300043d000000000003004b00000af60000613d00000000040000190000000005240019000000a006400039000000000606043300000000006504350000002004400039000000000034004b00000aef0000413d000000000323001900000000000304350000000003130049000000200430008a00000000004104350000001f0330003900000cae043001970000000003140019000000000043004b0000000004000039000000010400403900000c1b0030009c00000dce0000213d000000010040019000000dce0000c13d000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b002900000001001d000000400100043d0000000702000039000000000221043600000c1e03000041000000000032043500000c1f0010009c00000dce0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000290010006b0000107f0000c13d000000a401000039000000000101041a0000ff000010019000000d5c0000c13d0000002a0100002900000bb30110019700000c2402000041000000000202041a000000010220008a000000000021004b0000128e0000813d00000c7701000041000000000010043f00000c2d0100004100002eca00010430000000a40030008c000015b70000413d0000000402100370000000000202043b00000c1b0020009c000015b70000213d002300040020003d000000230230006a00000c320020009c000015b70000213d000000400020008c000015b70000413d0000002402100370000000000202043b00000c1b0020009c000015b70000213d0000002304200039000000000034004b000015b70000813d0000000404200039000000000441034f000000000404043b002000000004001d00000c1b0040009c000015b70000213d001f00240020003d000000200200002900000005022002100000001f02200029000000000032004b000015b70000213d0000004402100370000000000402043b00000c1b0040009c000015b70000213d0000002302400039000000000032004b000015b70000813d0000000402400039000000000221034f000000000202043b00000c1b0020009c000015b70000213d001e00240040003d00000005042002100000001e04400029000000000034004b000015b70000213d0000006404100370000000000404043b001300000004001d00000c100040009c000015b70000213d0000008404100370000000000404043b00000c1b0040009c000015b70000213d0000002305400039000000000035004b000015b70000813d0000000405400039000000000551034f000000000505043b000f00000005001d00000c1b0050009c000015b70000213d0000002405400039000d00000005001d0000000f04500029000000000034004b000015b70000213d000000200020006c00000be90000c13d0000002301100360000000000101043b002a00000001001d000000000010043f0000009701000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000700000001001d0000002a01000029000000000010043f0000009801000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d00000c2402000041000000000202041a000500000002001d000000000101043b000000200000006b002700000000001d002600000000001d0000133c0000c13d0000000501000029000000010510008a000000070100002900000023020000290000002603000029000000270400002900000013060000290000000d070000290000000f080000292ec827390000040f000000000100001900002ec90001042e0000000001000416000000000001004b000015b70000c13d00000000010300192ec81b6e0000040f2ec81df30000040f000000000100001900002ec90001042e000000440030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000402100370000000000202043b0000002404100370000000000504043b00000c1b0050009c000015b70000213d0000002304500039000000000034004b000015b70000813d0000000404500039000000000441034f000000000404043b00000c1b0040009c000015b70000213d000000240550003900000006064002100000000006560019000000000036004b000015b70000213d000000000300041a00000c10033001970000000006000411000000000063004b00000d310000c13d000000080040008c00000e530000a13d00000c9801000041000000000010043f00000c2d0100004100002eca000104300000000001000416000000000001004b000015b70000c13d00000c7201000041000000800010043f00000c310100004100002ec90001042e000000640030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000004402100370000000000302043b000000000003004b0000000002000039000000010200c039002a00000003001d000000000023004b000015b70000c13d0000002402100370000000000202043b002900000002001d0000000401100370000000000101043b000000000010043f0000009701000039000000200010043f000000400200003900000000010000192ec82ea90000040f0000009b02000039000000200020043f002800000001001d000000000100001900000040020000392ec82ea90000040f000000000401041a0000009f01000039000000000101041a000000f002100270000000280100002900000029030000290000002a050000292ec82e150000040f000000400200043d000000000012043500000bb30020009c00000bb302008041000000400120021000000c1a011001c700002ec90001042e000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b002a00000001001d00000bb30010009c000015b70000213d000000000100041100000c150010009c00000c3a0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d0000002a01000029000000c00110021000000c6b011001970000009f02000039000000000302041a00000c6c03300197000000000113019f000000000012041b000000000100001900002ec90001042e000000240030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000000401100370000000000101043b00000c100010009c000015b70000213d000000000200041a00000c10022001970000000003000411000000000032004b00000d310000c13d000000000001004b00000e060000c13d00000c1101000041000000800010043f0000002001000039000000840010043f0000002601000039000000a40010043f00000c1201000041000000c40010043f00000c1301000041000000e40010043f00000c140100004100002eca00010430000001a40030008c000015b70000413d0000000002000416000000000002004b000015b70000c13d0000002402100370000000000202043b002900000002001d0000000402100370000000000202043b002a00000002001d000001e002000039000000400020043f0000004402100370000000000202043b00000c300020009c000015b70000213d000000800020043f0000006402100370000000000202043b00000c300020009c000015b70000213d000000a00020043f0000008402100370000000000202043b00000c300020009c000015b70000213d000000c00020043f000000a402100370000000000202043b00000bb30020009c000015b70000213d000000e00020043f000000c402100370000000000202043b00000bb30020009c000015b70000213d000001000020043f000000e402100370000000000202043b00000bb30020009c000015b70000213d000001200020043f0000010402100370000000000202043b00000bb30020009c000015b70000213d000001400020043f0000012402100370000000000202043b00000bb30020009c000015b70000213d000001600020043f0000014402100370000000000202043b00000bb30020009c000015b70000213d000001800020043f0000016402100370000000000202043b00000c100020009c000015b70000213d000001a00020043f0000018401100370000000000101043b000000000001004b0000000002000039000000010200c039000000000021004b000015b70000c13d000001c00010043f000000000100041100000c150010009c00000cba0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000200041a000000000112013f00000c100010019800001a080000c13d000001a00100043d00000c10021001980000127c0000c13d000000e00100043d002800000001001d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000280200002900000bb302200197000000000012004b00000cd50000813d00000bb301100197000000e00010043f0000002a01000029000000000010043f0000009701000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000800200043d00000c3002200197000000a00300043d0000008003300210000000000223019f000000000101043b000000000021041b000000c00200043d00000c3002200197000000e00300043d000000800330021000000ca803300197000000000223019f000001000300043d000000a00330021000000c7503300197000000000232019f000001200300043d000000c00330021000000c6b03300197000000000232019f000001400300043d000000e003300210000000000232019f0000000103100039000000000023041b0000000201100039000001600200043d00000bb302200197000000000301041a00000ca903300197000000000223019f000001800300043d000000200330021000000caa03300197000000000232019f000001a00300043d000000400330021000000c8803300197000000000232019f000001c00300043d000000000003004b00000c27030000410000000003006019000000000232019f000000000021041b000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000030300003900000cab04000041000007bd0000013d0000000001000416000000000001004b000015b70000c13d000000000100041a00000c10051001970000000002000411000000000025004b00000d310000c13d00000c1901100197000000000010041b000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000030300003900000c6a0400004100000000060000192ec82ebe0000040f0000000100200190000015b70000613d000000000100001900002ec90001042e00000c1101000041000000800010043f0000002001000039000000840010043f000000a40010043f00000c6801000041000000c40010043f00000c690100004100002eca00010430000000800010043f000000000004004b00000d600000613d000000000030043f000000000001004b00000dc00000c13d000000200100003900000dd40000013d00000cad02200197000000a00020043f000000000001004b00000020020000390000000002006039000000200220003900000080010000392ec81a300000040f000000400100043d002a00000001001d00000080020000392ec81ac20000040f0000002a02000029000000000121004900000bb30010009c00000bb301008041000000600110021000000bb30020009c00000bb3020080410000004002200210000000000121019f00002ec90001042e00000c4401000041000000000010043f00000c2d0100004100002eca0001043000000c9701000041000000000010043f00000c2d0100004100002eca0001043000000cad02200197000000a00020043f000000000001004b0000002002000039000000000200603900000dc90000013d002800000001001d000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a000000000001004b00000d900000c13d00000c2401000041000000000101041a0000002802000029000000000021004b000001650000a13d002a00000002001d0000002a01000029000000010110008a002a00000001001d000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a000000000001004b00000d7d0000613d00000c2700100198000001650000c13d002a0c100010019b00000000020004110000002a0020006c00000e9d0000c13d0000002801000029000000000010043f00000c9a01000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000290200002900000c1006200197000000000101043b000000000201041a00000c1902200197000000000262019f000000000021041b000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000040300003900000c9b040000410000002a0500002900000028070000292ec82ebe0000040f000000010020019000000d2f0000c13d000015b70000013d002400000001001d0000002601000029000000000001004b00000e330000c13d00000c4501000041000000000010043f00000c2d0100004100002eca0001043000000c2a030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b00000dc20000413d0000003f0120003900000cae02100197000000000102001900000c1c0020009c00000dd40000a13d00000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca000104300000000003010019002700000001001d0000008002100039002a00000002001d000000400020043f0000009f01000039000000000101041a002900000001001d000000a001000039000000000101041a002800000001001d000000e0010000390000000000120435000001600230003900000080010000392ec81ab00000040f00000028020000290000ffff0220018f00000027040000290000014003400039000000000023043500000120024000390000002905000029000000f0035002700000000000320435000000e0025002700000ffff0220018f00000100034000390000000000230435000000c00250027000000bb302200197000000e0034000390000000000230435000000a00250027000000bb302200197000000c0034000390000000000230435000000a00240003900000c100350019700000000003204350000002a02000029000000000121004900000bb30020009c00000bb30200804100000bb30010009c00000bb30100804100000040022002100000006001100210000000000121019f00002ec90001042e2ec826ba0000040f000000000100001900002ec90001042e00000c270010019800000e200000c13d0000009e05000039000000000405041a000000010640019000000001014002700000007f0110618f0000001f0010008c00000000020000390000000102002039000000000224013f0000000100200190000006d50000c13d000000400200043d000000000001004b00000ef10000c13d00000c2b0020009c00000dce0000213d0000002001200039000000400010043f0000000000020435000000400300043d00000fcc0000013d00000c2c01000041000000000010043f00000c2d0100004100002eca0001043000000c2700100198000000290100002900000e2f0000c13d000000000010043f00000c9a01000041000000200010043f000000400200003900000000010000192ec82ea90000040f000000000101041a00000a880000013d00000c9d01000041000000000010043f00000c2d0100004100002eca00010430000000000010043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000400400043d000000000101043b000000000101041a00000c1b0110019800000e6d0000c13d0000006002000039000001820000013d0000002a0000006b0000000001000039000000010100c0392ec8269e0000040f2ec81a4e0000040f0000002002100039000000290300002900000000003204350000002a0200002900000000002104352ec826b20000040f000000000100001900002ec90001042e000000000004004b000000000a00001900000ec00000c13d002a0000000a001d00000000010200192ec81ad70000040f0000002a02000029000000000021041b000000000100001900002ec90001042e000000400100043d000000440210003900000c6803000041000000000032043500000c110200004100000000002104350000002402100039000000200300003900000000003204350000000402100039000000000032043500000bb30010009c00000bb301008041000000400110021000000c5e011001c700002eca00010430000000250010006b00000000020100190000002502004029002500000002001d0000000501200210002300000004001d00000000011400190000002001100039000000400010043f002800000001001d00000c1c0010009c00000dce0000213d00000028020000290000008001200039000000400010043f000000600120003900000000000104350000004001200039000000000001043500000020012000390000000000010435000000000002043500000c2401000041000000000101041a000000020010008c000000000100001900000fcf0000413d0000000101000039002a00000001001d000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a000000000001004b0000104e0000c13d0000002a01000029000000010110008a00000e890000013d0000002a01000029000000000010043f00000c3d01000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000200041100000c1002200197000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a000000ff0010019000000d960000c13d00000c9901000041000000000010043f00000c2d0100004100002eca0001043000000000030000190000000006000019000000000a00001900000006073002100000000008570019000000000781034f000000000707043b000000000003004b00000ed90000613d0000ffff0070008c000015b70000213d000000010930008a000000ff0090008c000008610000213d000000000049004b000010830000813d00000006099002100000000009590019000000000991034f000000000909043b0000ffff0090008c000015b70000213d000000000097004b00000edb0000413d00000be90000013d0000ffff0070008c000015b70000213d0000002008800039000000000881034f000000000808043b0000ffff0080008c000015b70000213d000000ff0030008c000008610000613d000000050660021000001fe00960018f000000e00660018f000000000096004b000008610000c13d000000100770021000000c2007700197000000000778019f00000000066701cf000000000aa6019f0000000106300039000000ff0360018f000000000043004b00000ec30000413d00000e560000013d000000a003200039000000400030043f00000080032000390000000000030435000000290a00002900000000070300190000000900a0008c0000000a3aa0011a000000f808300210000000010370008a000000000903043300000c2809900197000000000889019f00000c29088001c7000000000083043500000ef60000213d00000000027200490000008102200039000000210770008a0000000000270435000000400200043d0000002008200039000000000006004b00000fad0000613d000000000050043f00000c2a0400004100000000050000190000000006850019000000000904041a000000000096043500000001044000390000002005500039000000000015004b00000f0c0000413d00000faf0000013d002a00000001001d002700000000001d0000000001000019000000290500002900000f1e0000013d002a00000000001d0000002801000029000000400010043f00000001055000390000000101000039000000010010019000000f250000613d000000250050006c0000109e0000613d0000002702000029000000240020006c0000109e0000613d000000400100043d00000c1c0010009c00000dce0000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435002900000005001d000000000050043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000400200043d00000c1c0020009c000000290500002900000dce0000213d000000000101043b000000000101041a0000006003200039000000e8041002700000000000430435000000400320003900000c27001001980000000004000039000000010400c0390000000000430435000000a00310027000000c1b033001970000002004200039000000000034043500000c1001100197000000000012043500000f190000c13d000000000001004b00000000020100190000002a02006029002a00000002001d000000260120014f00000c100010019800000f1a0000c13d00000027010000290000000101100039002700000001001d00000005011002100000002301100029000000000051043500000f1a0000013d00000028010000290000000301100039001d00000001001d000000000101041a001e00000001001d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d0000001e02000029000000980220027000000bb302200197000000000101043b000000000021004b000010890000813d00000c6601000041000000000010043f00000c2d0100004100002eca00010430000000020100036700000000020000190000000003000019000000000900001900000006042002100000000005840019000000000451034f000000000404043b000000000002004b00000f950000613d0000ffff0040008c000015b70000213d000000010620008a000000ff0060008c000008610000213d000000000076004b000010830000813d00000006066002100000000006860019000000000661034f000000000606043b0000ffff0060008c000015b70000213d000000000064004b00000f970000413d00000be90000013d0000ffff0040008c000015b70000213d0000002005500039000000000551034f000000000505043b0000ffff0050008c000015b70000213d000000ff0020008c000008610000613d000000050330021000001fe00630018f000000e00330018f000000000063004b000008610000c13d000000100440021000000c2004400197000000000445019f00000000033401cf000000000993019f0000000103200039000000ff0230018f000000000072004b00000f7f0000413d0000051c0000013d00000cad04400197000000000048043500000000011800190000000004070433000000000004004b00000fbb0000613d000000000500001900000000061500190000000007350019000000000707043300000000007604350000002005500039000000000045004b00000fb40000413d000000000114001900000000000104350000000001210049000000200310008a00000000003204350000001f0110003900000cae011001970000000004210019000000000014004b0000000001000039000000010100403900000c1b0040009c00000dce0000213d000000010010019000000dce0000c13d0000000003040019000000400040043f0000000001030019002a00000003001d00000d4d0000013d002900000001001d0000000105000039002700000000001d000000000100001900000fd90000013d002900000000001d0000002801000029000000400010043f00000001055000390000000101000039000000010010019000000fe00000613d000000240050006c000010dd0000613d0000002702000029000000250020006c000010dd0000613d000000400100043d00000c1c0010009c00000dce0000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435002a00000005001d000000000050043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000400200043d00000c1c0020009c0000002a0500002900000dce0000213d000000000101043b000000000101041a0000006003200039000000e8041002700000000000430435000000400320003900000c27001001980000000004000039000000010400c0390000000000430435000000a00310027000000c1b033001970000002004200039000000000034043500000c1001100197000000000012043500000fd40000c13d000000000001004b00000000020100190000002902006029002900000002001d000000260120014f00000c1000100198000000230200002900000fd50000c13d00000027010000290000000101100039002700000001001d00000005011002100000000001210019000000000051043500000fd50000013d000000400100043d00000c1c0010009c00000dce0000213d0000008002100039000000400020043f00000060021000390000000000020435000000400210003900000000000204350000002002100039000000000002043500000000000104350000002a01000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000400200043d00000c1c0020009c00000dce0000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e8041002700000000000430435000000400320003900000c27001001980000000004000039000000010400c0390000000000430435000000a00310027000000c1b033001970000002004200039000000000034043500000c10011001970000000000120435002a00000000001d002a00000001601d00000f150000013d000000400100043d00000c1c0010009c00000dce0000213d0000008002100039000000400020043f00000060021000390000000000020435000000400210003900000000000204350000002002100039000000000002043500000000000104350000002a01000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000400200043d00000c1c0020009c00000dce0000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e8041002700000000000430435000000400320003900000c27001001980000000004000039000000010400c0390000000000430435000000a00310027000000c1b033001970000002004200039000000000034043500000c10011001970000000000120435002900000000001d002900000001601d00000fd00000013d00000c7401000041000000000010043f00000c2d0100004100002eca0001043000000c6401000041000000000010043f0000003201000039000000040010043f00000c470100004100002eca000104300000001e03000029000000b80330027000000bb303300197000000000023004b000010a50000a13d000000000031004b000010a50000a13d00000c6501000041000000000010043f00000c2d0100004100002eca00010430000000000002004b0000000003000019000010980000613d000000a00300043d000000030420021000000cac0440027f00000cac04400167000000000443016f0000000103200210000010fb0000013d000000230100002900000027020000290000000000210435000000400100043d002a00000001001d0000002302000029000001840000013d000000000100041100000c150010009c001b00000001001d001c00000001001d000010b70000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b001c00000001001d00000002010003670000001c0200002900270c100020019b0000002a0000006b000010ff0000c13d000000230110036000000028020000290000000202200039001800000002001d000000000202041a001a0c100020019b000000000101043b001900000001001d000001000010008c000011780000813d0000002801000029000000000201041a000000400400043d00000c4d010000410000000000140435000000040140003900000027030000290000000000310435000000000100041000000c1003100197002600000004001d0000002401400039001c00000003001d0000000000310435000000000100041400000c1002200197000000040020008c0000122d0000c13d0000000103000031000000200030008c00000020040000390000000004034019000012570000013d000000230200002900000027010000290000000000120435000000400400043d000001820000013d00000c2a030000410000002006000039000000010540008a000000050550027000000c6f0550009a000000000706001900000080066000390000000006060433000000000063041b00000020067000390000000103300039000000000053004b000010e70000c13d000000a005700039000000000024004b000010f90000813d0000000304200210000000f80440018f00000cac0440027f00000cac044001670000000005050433000000000445016f000000000043041b00000001030000390000000104200210000000000234019f000000000021041b000000000100001900002ec90001042e000000400a00043d00000c4605000041000000000600001900000005026002100000002902200029000000000221034f000000000202043b0000002803000029000000000403041a00000000005a04350000000403a000390000000000230435000000000300041400000c1002400197000000040020008c000011140000c13d0000000103000031000000200030008c00000020040000390000000004034019000011430000013d002500000006001d00000bb300a0009c00000bb30100004100000000010a4019000000400110021000000bb30030009c00000bb303008041000000c003300210000000000113019f00000c47011001c700260000000a001d2ec82ec30000040f000000260a000029000000600310027000000bb303300197000000200030008c00000020040000390000000004034019000000200640019000000000056a00190000112f0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b0000112b0000c13d0000001f074001900000113c0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000013120000613d000000020100036700000c460500004100000025060000290000001f02400039000000600420018f0000000002a40019000000000042004b0000000004000039000000010400403900000c1b0020009c00000dce0000213d000000010040019000000dce0000c13d000000400020043f000000200030008c000015b70000413d00000000030a043300000c100030009c000015b70000213d000000270030006c000012be0000c13d00000001066000390000002a0060006c000000000a020019000011020000413d000010bc0000013d00000c5b01000041000000000010044300000000010004100000000400100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c5c011001c700008002020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b000000000001004b000012230000c13d00000c7801000041000000000101041a0000ff0000100190000012950000c13d000000400100043d000000640210003900000c8c030000410000000000320435000000440210003900000c7a0300004100000000003204350000002402100039000000340300003900000a640000013d000000400100043d000000140200003900000000022104360000001a030000290000006003300210000000000032043500000c1f0010009c00000dce0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000190010006b000010c60000613d000000240400002900000024014000390000000202000367000000000112034f000000000301043b00000000010000310000000004410049000000230440008a00000c4a0540019700000c4a06300197000000000756013f000000000056004b000000000500001900000c4a05004041000000000043004b000000000400001900000c4a0400804100000c4a0070009c000000000504c019000000000005004b000015b70000c13d0000002303300029000000000232034f000000000202043b002600000002001d00000c1b0020009c000015b70000213d00000026020000290025000500200218000000250110006a000000200530003900000c4a0210019700000c4a03500197000000000423013f000000000023004b000000000200001900000c4a02004041002400000005001d000000000015004b000000000100001900000c4a0100204100000c4a0040009c000000000201c019000000000002004b000015b70000c13d000000400100043d000000140200003900000000022104360000001c030000290000006003300210000000000032043500000c1f0010009c00000dce0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b00000025020000290000003f0220003900000c4b02200197000000400300043d0000000002230019000000000032004b0000000004000039000000010400403900000c1b0020009c00000dce0000213d000000010040019000000dce0000c13d000000400020043f0000002602000029000000000223043600000025060000290000002404600029000000000040007c000015b70000213d000000240040006c000012010000a13d0000002408000029000000020580036700000000060300190000002006600039000000005705043c00000000007604350000002008800039000000000048004b000011f90000413d0000000003030433002600000003001d000000260000006b0000121d0000613d00000026030000290000000503300210002500000023001d0000000043020434002600000004001d000000000031004b000000000300003900000020030020390000000000130435000000200130015f00000000020204330000000000210435000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b0000002603000029000000250030006c0000000002030019000012060000413d000000190010006c000010c60000613d00000c4c01000041000000000010043f00000c2d0100004100002eca00010430000000400100043d000000640210003900000c79030000410000000000320435000000440210003900000c7a0300004100000000003204350000002402100039000000370300003900000a640000013d000000260300002900000bb30030009c00000bb303008041000000400330021000000bb30010009c00000bb301008041000000c001100210000000000131019f00000c4e011001c72ec82ec30000040f000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000002605700029000012460000613d000000000801034f0000002609000029000000008a08043c0000000009a90436000000000059004b000012420000c13d000000000006004b000012530000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000012c20000613d0000001f01400039000000600110018f0000002602100029000000000012004b00000000010000390000000101004039002500000002001d00000c1b0020009c00000dce0000213d000000010010019000000dce0000c13d0000002501000029000000400010043f000000200030008c000015b70000413d00000026010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000015b70000c13d000000000001004b0000130e0000613d0000001e0100002900000c4f00100198000014a10000c13d0000001e0100002900000088011002700000ffff01100190000014a80000c13d00000c6401000041000000000010043f0000001201000039000000040010043f00000c470100004100002eca00010430000000400400043d0000002401400039000000010300008a000000000031043500000ca5010000410000000000140435002800000004001d000000040140003900000ca60300004100000000003104350000000001000414000000040020008c000012ce0000c13d0000000103000031000000200030008c00000020040000390000000004034019000012f80000013d0000002a01000029000000a00110021000000c75011001970000009f02000039000000000302041a00000c760330019700000c440000013d000000800100043d00000c1b0010009c00000dce0000213d00000c7c02000041000000000302041a000000010030019000000001023002700000007f0220618f0000001f0020008c00000000040000390000000104002039000000000343013f0000000100300190000006d50000c13d000000200020008c000012b50000413d00000c7c03000041000000000030043f0000001f03100039000000050330027000000c7d0330009a000000200010008c00000c7e030040410000001f02200039000000050220027000000c7d0220009a000000000023004b000012b50000813d000000000003041b0000000103300039000000000023004b000012b10000413d0000001f0010008c000014380000a13d00000c7c02000041000000000020043f00000cae04100198000014430000c13d000000200300003900000c7e020000410000144f0000013d00000c4901000041000000000010043f00000c2d0100004100002eca000104300000001f0530018f00000c4806300198000000400200043d0000000004620019000013290000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000012c90000c13d000013290000013d000000280300002900000bb30030009c00000bb303008041000000400330021000000bb30010009c00000bb301008041000000c001100210000000000131019f00000c4e011001c72ec82ebe0000040f000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000002805700029000012e70000613d000000000801034f0000002809000029000000008a08043c0000000009a90436000000000059004b000012e30000c13d000000000006004b000012f40000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f000300000001035500000001002001900000131e0000613d0000001f01400039000000600210018f0000002801200029000000000021004b0000000002000039000000010200403900000c1b0010009c00000dce0000213d000000010020019000000dce0000c13d000000400010043f000000200030008c000015b70000413d00000028010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000015b70000c13d000000000001004b00000cc10000c13d00000ca701000041000000000010043f00000c2d0100004100002eca000104300000001f0530018f00000c4806300198000000400200043d0000000004620019000013290000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000013190000c13d000013290000013d0000001f0530018f00000c4806300198000000400200043d0000000004620019000013290000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000013250000c13d000000000005004b000013360000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f0000000000140435000000600130021000000bb30020009c00000bb3020080410000004002200210000000000112019f00002eca00010430000000000201041a000200f000200278000100e0002002780000000701000029001d00020010003d00000bb301200197001c00000001001d001a001000100278000000c001200270000400000001001d00000bb301100197000600000001001d0003001000100278000000a001200270000900000001001d00000bb301100197000a00000001001d00080010001002780000008001200270000c00000001001d00000bb301100197000e00000001001d000b0010001002780000006001200270001100000001001d00000bb301100197001200000001001d00100010001002780000004001200270001500000001001d00000bb301100197001600000001001d0014001000100278001b00000002001d0000002001200270001800000001001d00000bb301100197001900000001001d001700100010027800000005050000290000000002000019002600000000001d002700000000001d002100000002001d00000005012002100000001e031000290000000202000367000000000332034f000000000303043b0000001d04000029000000000404041a000000200440027000000bb304400197000000010040008c002a00000005001d000013760000213d00000000050300190000137e0000013d000000000003004b0000137d0000613d00000000054300a900000000033500d9000000000043004b0000137e0000613d000008610000013d00000000050000190000001c0300002900000c230030009c0000000006000019002500000005001d000013c60000413d0000001a04000029000000000054004b0000001b03000029000013c00000a13d000000190300002900000c230030009c0000000006000019000013c60000413d0000001704000029000000000054004b0000001803000029000013c00000a13d000000160300002900000c230030009c0000000006000019000013c60000413d0000001404000029000000000054004b0000001503000029000013c00000a13d000000120300002900000c230030009c0000000006000019000013c60000413d0000001004000029000000000054004b0000001103000029000013c00000a13d0000000e0300002900000c230030009c0000000006000019000013c60000413d0000000b04000029000000000054004b0000000c03000029000013c00000a13d0000000a0300002900000c230030009c0000000006000019000013c60000413d0000000804000029000000000054004b0000000903000029000013c00000a13d000000060300002900000c230030009c0000000006000019000013c60000413d0000000304000029000000000054004b0000000403000029000013c00000a13d0000001b0300002900000c330030009c000014360000413d00000002040000290000002505000029000000000054004b00000001030000290000000006000019000013c60000213d00000000044500d90000ffff0330018f00000000063400a900000000044600d9000000000034004b000008610000c13d002400000006001d0000001f01100029000000000112034f000000000101043b002900000001001d00000c100010009c000015b70000213d00000025010000290000002402000029000000000012001a000008610000413d002800000012001e000016670000613d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b002200000001001d0000002a01000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d0000002202000029000000a0022002100000002803000029000000010030008c000000000300001900000c3503006041000000000223019f0000002903000029000000000232019f000000000101043b000000000021041b000000000030043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000280400002900000c37024000d1000000000101043b000000000301041a0000000002230019000000000021041b000000290000006b0000166b0000613d0028002a0040002d00000000010000190000141f0000013d0000002a07000029000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000040300003900000c380400004100000000050000190000002906000029002a00000007001d2ec82ebe0000040f00000001002001900000000101000039000015b70000613d00000001001001900000140f0000613d0000002a070000290000000107700039000000280070006c000014100000c13d00000c24010000410000002802000029000000000021041b0000002502000029000000260020002a0000002403000029000008610000413d000000270030002a000008610000413d002600260020002d002700270030002d00000021020000290000000102200039000000200020006c0000002805000029000013670000413d00000bb60000013d0000000006000019000013c60000013d000000000001004b00000000020000190000145b0000613d000000030210021000000cac0220027f00000cac02200167000000a00300043d000000000223016f0000000101100210000000000212019f0000145b0000013d00000c7e020000410000002003000039000000010540008a000000050550027000000c7f0550009a00000080063000390000000006060433000000000062041b00000020033000390000000102200039000000000052004b000014480000c13d000000000014004b000014590000813d0000000304100210000000f80440018f00000cac0440027f00000cac0440016700000080033000390000000003030433000000000343016f000000000032041b000000010110021000000001021001bf00000c7c01000041000000000021041b0000002a010000290000000001010433002400000001001d00000c1b0010009c00000dce0000213d00000c4001000041000000000101041a000000010010019000000001021002700000007f0220618f002300000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006d50000c13d0000002301000029000000200010008c0000148d0000413d00000c4001000041000000000010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c3e011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d00000024030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000023010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b0000148d0000813d000000000002041b0000000102200039000000000012004b000014890000413d0000002401000029000000200010008c000015710000413d00000c4001000041000000000010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c3e011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000200200008a0000002402200180000000000101043b000015900000c13d00000020030000390000159d0000013d0000002a0000006b000014af0000c13d0000009f01000039000000000101041a002400000001001d002600000000001d000014c20000013d0026002a10100101000000000001004b000014b70000613d00000c5001000041000000000010043f00000c2d0100004100002eca000104300000001e0100002900000088011002700000ffff0110018f0000002a031000b9002600000003001d0000002a023000fa000000000012004b000008610000c13d0000009f01000039000000000101041a002400000001001d000000c00110027000000bb301100197000000260010006b000014c20000a13d00000c6301000041000000000010043f00000c2d0100004100002eca000104300000002503000029000000240130003900000c5102000041000000000021043500000c5201000041000000000013043500000004013000390000002702000029000000000021043500000bb30030009c00000bb30100004100000000010340190000004001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c4e011001c700000c53020000412ec82ec30000040f000000600310027000010bb30030019d000300000001035500000001002001900000002705000029000015240000613d00000bb3023001970000001f0420018f00000c48052001980000002503500029000014e80000613d000000000601034f0000002507000029000000006806043c0000000007870436000000000037004b000014e40000c13d000000000004004b000014f50000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000001f0120003900000c5401100197000000250110002900000c1b0010009c00000dce0000213d000000400010043f000000200020008c000015b70000413d0000002503000029000000000303043300000c1b0030009c000015b70000213d000000250520002900000025023000290000001f03200039000000000053004b000015b70000813d000000002602043400000c1b0060009c00000dce0000213d00000005046002100000003f0340003900000c4b03300197000000000313001900000c1b0030009c00000dce0000213d000000400030043f00000000036104360000000004240019000000000054004b000015b70000213d000000000006004b0000002705000029000015240000613d0000000005030019000000002602043400000c100060009c000015b70000213d0000000005650436000000000042004b000015180000413d0000000001010433000000000001004b0000002705000029000015240000613d000000000103043300000c10051001970000002401000029000000a00110027000000bb302100197002500000002001d000000210020006b0000157e0000813d000000000050043f0000009a01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b002400000001001d00000023010000290000000201100367000000000301043b000000400100043d000000200210003900000c55040000410000000000420435000000240410003900000000003404350000002403000039000000000031043500000c560010009c00000dce0000213d0000006003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000010043f0000002401000029000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a000000260010002a000008610000413d0000002601100029000000210010006c0000157e0000a13d00000c6201000041000000000010043f00000c2d0100004100002eca00010430000000240000006b0000000001000019000015ab0000613d0000002403000029000000030130021000000cac0110027f00000cac0110016700000029020000290000000002020433000000000112016f0000000102300210000000000121019f000015ab0000013d0000002001000029000000010110008a000000260010002a000008610000413d0000002601100029000000250010006c00000b430000213d0000001e0100002900200c300010019b0000001a0000006b000016540000c13d0000000001000416000000200010006c0000170d0000813d00000c6101000041000000000010043f00000c2d0100004100002eca00010430000000010320008a00000005033002700000000004310019000000200300003900000001044000390000002a0600002900000000056300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b000015960000c13d000000240020006c000015a80000813d00000024020000290000000302200210000000f80220018f00000cac0220027f00000cac022001670000002a033000290000000003030433000000000223016f000000000021041b0000002401000029000000010110021000000001011001bf00000c4002000041000000000012041b000000010100003900000c2402000041000000000012041b0000002801000029002900840010003d00000002010003670000002902100360000000000202043b0000ffff0020008c000015b90000a13d000000000100001900002eca00010430000013880020008c00000be90000213d0000002902000029002400200020003d0000002402100360000000000202043b0000ffff0020008c000015b70000213d000013880020008c00000be90000213d000000240200002900230080002000920000002302100360000000000202043b00000c100020009c000015b70000213d000000000002004b00000be90000613d0000002302000029002200400020003d0000002202100360000000000202043b00000bb30020009c000015b70000213d000000000002004b00000be90000613d0000002202000029000000600220008a000000000221034f000000000302043b0000000002000031000000280420006a000000230440008a00000c4a0540019700000c4a06300197000000000756013f000000000056004b000000000500001900000c4a05004041000000000043004b000000000400001900000c4a0400804100000c4a0070009c000000000504c019000000000005004b000015b70000c13d0000002703300029000000000131034f000000000101043b002800000001001d00000c1b0010009c000015b70000213d000000280120006a000000200530003900000c4a0210019700000c4a03500197000000000423013f000000000023004b000000000200001900000c4a02004041002a00000005001d000000000015004b000000000100001900000c4a0100204100000c4a0040009c000000000201c019000000000002004b000015b70000c13d0000009e01000039000000000101041a000000010010019000000001021002700000007f0220618f002700000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006d50000c13d0000002701000029000000200010008c000016280000413d0000009e01000039000000000010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c3e011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d00000028030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000027010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b000016280000813d000000000002041b0000000102200039000000000012004b000016240000413d0000002801000029000000200010008c000018b10000413d0000009e01000039000000000010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c3e011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000200200008a00000028032001800000000202000367000000000101043b0000000004000019000016440000613d0000002a05400029000000000552034f000000000505043b000000000051041b00000001011000390000002004400039000000000034004b0000163c0000413d000000280030006c000016500000813d00000028030000290000000303300210000000f80330018f00000cac0330027f00000cac033001670000002a04400029000000000442034f000000000404043b000000000334016f000000000031041b0000002801000029000000010110021000000001011001bf0000193e0000013d000000400300043d00000024013000390000001c02000029000000000021043500000c57010000410000000000130435002600000003001d00000004013000390000002702000029000000000021043500000000010004140000001a02000029000000040020008c0000166f0000c13d0000000103000031000000200030008c000000200400003900000000040340190000169a0000013d00000c3a01000041000000000010043f00000c2d0100004100002eca0001043000000c3901000041000000000010043f00000c2d0100004100002eca00010430000000260200002900000bb30020009c00000bb302008041000000400220021000000bb30010009c00000bb301008041000000c001100210000000000121019f00000c4e011001c70000001a020000292ec82ec30000040f000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000002605700029000016890000613d000000000801034f0000002609000029000000008a08043c0000000009a90436000000000059004b000016850000c13d000000000006004b000016960000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000016f20000613d0000001f01400039000000600110018f0000002604100029000000000014004b00000000020000390000000102004039002500000004001d00000c1b0040009c00000dce0000213d000000010020019000000dce0000c13d0000002502000029000000400020043f000000200030008c000015b70000413d00000026020000290000000002020433000000200020006c0000130e0000413d00000c58020000410000002504000029000000000024043500000004024000390000002704000029000000000042043500000000020004140000001a04000029000000040040008c000016e40000613d000000250100002900000bb30010009c00000bb301008041000000400110021000000bb30020009c00000bb302008041000000c002200210000000000112019f00000c47011001c70000001a020000292ec82ec30000040f000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000002505700029000016d10000613d000000000801034f0000002509000029000000008a08043c0000000009a90436000000000059004b000016cd0000c13d000000000006004b000016de0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000016fe0000613d0000001f01400039000000600110018f000000250110002900000c1b0010009c00000dce0000213d000000400010043f000000200030008c000015b70000413d00000025010000290000000001010433000000200010006c0000170a0000813d00000c5a01000041000000000010043f00000c2d0100004100002eca000104300000001f0530018f00000c4806300198000000400200043d0000000004620019000013290000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000016f90000c13d000013290000013d0000001f0530018f00000c4806300198000000400200043d0000000004620019000013290000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000017050000c13d000013290000013d0000000001000416000000000001004b000018860000c13d000000000100041100000c150010009c001e00000001001d0000171e0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b001e00000001001d0000002a0000006b0000181f0000c13d0000001d01000029000000000101041a00000c4f00100198002900000000001d000017290000c13d00000088011002700000ffff01100190000012760000613d0029002a001001010000001e01000029001e00000001001d00000029020000292ec826ce0000040f000000400300043d000000240130003900000c5102000041000000000021043500000c520100004100000000001304350000001e0100002900000c1002100197002800000002001d0000000401300039000000000021043500000bb30030009c002a00000003001d00000bb30100004100000000010340190000004001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c4e011001c700000c53020000412ec82ec30000040f000000600310027000010bb30030019d000300000001035500000001002001900000002802000029000017a10000613d00000bb3023001970000001f0420018f00000c48052001980000002a03500029000017560000613d000000000601034f0000002a07000029000000006806043c0000000007870436000000000037004b000017520000c13d000000000004004b000017630000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000001f0120003900000c54031001970000002a01300029000000000031004b0000000003000039000000010300403900000c1b0010009c00000dce0000213d000000010030019000000dce0000c13d000000400010043f000000200020008c000015b70000413d0000002a03000029000000000303043300000c1b0030009c000015b70000213d0000002a042000290000002a023000290000001f03200039000000000043004b000000000500001900000c4a0500804100000c4a0330019700000c4a06400197000000000763013f000000000063004b000000000300001900000c4a0300404100000c4a0070009c000000000305c019000000000003004b000015b70000c13d000000002502043400000c1b0050009c00000dce0000213d00000005065002100000003f0360003900000c4b03300197000000000313001900000c1b0030009c00000dce0000213d000000400030043f00000000035104360000000006260019000000000046004b000015b70000213d000000000062004b0000179c0000813d0000000004030019000000002502043400000c100050009c000015b70000213d0000000004540436000000000062004b000017950000413d0000000005010433000000000005004b0000002802000029000017a10000613d000000000103043300000c10021001970000001f01000029000000000101041a00000c1b011001970000009f03000039000000000303041a000000a00330027000000bb303300197000000000031004b000017ea0000813d000000000020043f0000009a01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b002a00000001001d000000400100043d000000200210003900000c550300004100000000003204350000002403100039000000220400002900000000004304350000002403000039000000000031043500000c560010009c00000dce0000213d0000006003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000010043f0000002a01000029000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000201041a000000290020002a000008610000413d0000002902200029000000000021041b0000001801000029000000000101041a00000c1001100197002a00000001001d000000000010043f0000009c01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000101041a00000c30011001970000002001100029002900000001001d00000c300010009c000008610000213d0000002a01000029000000000010043f0000009c01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000015b70000613d000000000101043b000000000201041a00000c5f0220019700000029022001af000000000021041b0000002a0000006b0000188a0000c13d0000000001000416000000200310006c00000d2f0000a13d00000000010004140000002802000029000000040020008c000018f80000c13d00000001020000390000000101000031000019040000013d0000001e0100002900210c100010019b0000002801000029002300010010003d002600000000001d0000002601000029000000050110021000000029011000290000000201100367000000000101043b002400000001001d0000002301000029000000000101041a002700000001001d0000002801000029000000000101041a00000c5b02000041000000000020044300000c1001100197002500000001001d0000000400100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c5c011001c700008002020000392ec82ec30000040f000000270300002900000c10033001980000dead03006039000000010020019000001a0c0000613d000000000101043b000000000001004b000015b70000613d000000400200043d0000004401200039000000240400002900000000004104350000002401200039000000000031043500000c5d010000410000000000120435002700000002001d00000004012000390000002102000029000000000021043500000000010004140000002502000029000000040020008c000018630000613d000000270200002900000bb30020009c00000bb302008041000000400220021000000bb30010009c00000bb301008041000000c001100210000000000121019f00000c5e011001c700000025020000292ec82ebe0000040f000000600310027000010bb30030019d00030000000103550000000100200190000018790000613d000000270100002900000c1b0010009c00000dce0000213d0000002701000029000000400010043f00000026020000290000000102200039002600000002001d0000002a0020006c000018240000413d0000001d01000029000000000101041a00000c4f00100198000017250000613d00000088011002700000ffff0110018f0000002a031000b9002900000003001d0000002a023000fa000000000012004b000008610000c13d000017290000013d00000bb3033001970000001f0530018f00000c4806300198000000400200043d0000000004620019000013290000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000018810000c13d000013290000013d00000c5901000041000000000010043f00000c2d0100004100002eca00010430000000000100041100000c150010009c0000189a0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b001b00000001001d000000400300043d00000044013000390000002002000029000000000021043500000024013000390000001c02000029000000000021043500000c5d0100004100000000001304350000001b0100002900000c1001100197002900000003001d0000000402300039000000000012043500000000010004140000002a02000029000000040020008c000018b60000c13d0000000103000031000000200030008c00000020040000390000000004034019000018e10000013d0000000202000367000000280000006b000019350000c13d00000000010000190000193e0000013d000000290200002900000bb30020009c00000bb302008041000000400220021000000bb30010009c00000bb301008041000000c001100210000000000121019f00000c5e011001c70000002a020000292ec82ebe0000040f000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000002905700029000018d00000613d000000000801034f0000002909000029000000008a08043c0000000009a90436000000000059004b000018cc0000c13d000000000006004b000018dd0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f0003000000010355000000010020019000001a0d0000613d0000001f01400039000000600210018f0000002901200029000000000021004b0000000002000039000000010200403900000c1b0010009c00000dce0000213d000000010020019000000dce0000c13d000000400010043f000000200030008c000015b70000413d00000029010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000015b70000c13d000000000001004b000018150000c13d000019080000013d00000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800902000039000000280400002900000000050000192ec82ebe0000040f0003000000010355000000600110027000010bb30010019d00000bb301100197000000000001004b0000190c0000c13d000000010020019000000d2f0000c13d00000c6001000041000000000010043f00000c2d0100004100002eca0001043000000c1b0010009c00000dce0000213d0000001f0410003900000cae044001970000003f0440003900000cae05400197000000400400043d0000000005540019000000000045004b0000000006000039000000010600403900000c1b0050009c00000dce0000213d000000010060019000000dce0000c13d000000400050043f000000000614043600000cae031001980000001f0410018f00000000013600190000000305000367000019270000613d000000000705034f000000007807043c0000000006860436000000000016004b000019230000c13d000000000004004b000019060000613d000000000335034f0000000304400210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000019060000013d0000002804000029000000030140021000000cac0110027f00000cac011001670000002a03200360000000000303043b000000000113016f0000000103400210000000000131019f0000009e03000039000000000013041b0000002301200360000000000301043b00000c100030009c000015b70000213d0000009f01000039000000000401041a00000c1904400197000000000334019f000000000031041b00000023040000290000002004400039000000000442034f000000000404043b00000bb30040009c000015b70000213d00000c7603300197000000a00440021000000c7504400197000000000334019f000000000031041b0000002204200360000000000404043b00000bb30040009c000015b70000213d00000c6c03300197000000c00440021000000c6b04400197000000000334019f000000000031041b0000002904200360000000000404043b0000ffff0040008c000015b70000213d00000c8003300197000000e00440021000000c8104400197000000000334019f000000000031041b0000002404200360000000000404043b0000ffff0040008c000015b70000213d00000c4303300197000000f004400210000000000334019f000000000031041b00000024010000290000002001100039000000000112034f000000000101043b0000ffff0010008c000015b70000213d000000a003000039000000000203041a00000c7302200197000000000112019f000000000013041b00000c7801000041000000000101041a0000ff00001001900000116e0000613d0000000001000411002a00000001001d00000c1006100197000000000100041a00000c1902100197000000000262019f000000000020041b000000000200041400000c100510019700000bb30020009c00000bb302008041000000c00120021000000c1d011001c70000800d02000039000000030300003900000c6a040000412ec82ebe0000040f0000000100200190000015b70000613d00000002010003670000006402100370000000000202043b0000ffff0020008c000015b70000213d0000008403100370000000000303043b0000ffff0030008c000015b70000213d00000000052300190000ffff0050008c000008610000213d000000a404100370000000000404043b0000ffff0040008c000015b70000213d00000000065400190000ffff0060008c000008610000213d000000c405100370000000000505043b0000ffff0050008c000015b70000213d00000000066500190000ffff0060008c000008610000213d0000fffe0730018f000000fa0070008c00001a190000413d000027100060008c00001a190000c13d00000c8302200197000000100330021000000c2003300197000000000223019f000000200340021000000c8403300197000000000232019f000000300350021000000c8503300197000000000332019f000000a102000039000000000402041a00000c8604400197000000000343019f000000000032041b000000e404100370000000000404043b00000c100040009c000015b70000213d00000c8703300197000000400440021000000c8804400197000000000334019f000000000032041b0000010402100370000000000202043b00000c100020009c000015b70000213d000000a203000039000000000403041a00000c1904400197000000000224019f000000000023041b0000012401100370000000000101043b00000c100010009c000015b70000213d000000a302000039000000000302041a00000c1903300197000000000113019f000000000012041b000000a001000039000000000101041a002900000001001d000000000100041100000c150010009c000019ec0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001a0c0000613d000000000101043b002a00000001001d000000000100041a0000002a0110014f00000c100010019800001a080000c13d00000029010000290000ffff0210018f000000a003000039000000000103041a00000c7301100197000000000121019f000000000013041b000000400100043d000027110020008c00000a5c0000813d000000260300002900000c100330019800001a1d0000c13d000000440210003900000c8903000041000000000032043500000024021000390000001903000039000000000032043500000c110200004100000000002104350000000402100039000000200300003900000e670000013d00000ca401000041000000000010043f00000c2d0100004100002eca00010430000000000001042f0000001f0530018f00000c4806300198000000400200043d0000000004620019000013290000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00001a140000c13d000013290000013d00000c8201000041000000000010043f00000c2d0100004100002eca0001043000000c1f0010009c00000dce0000213d0000004004100039000000400040043f000000200410003900000000002404350000000000310435000000a001200210000000000131019f0000006502000039000000000012041b000000250000006b00000d2f0000c13d00000c7801000041000000000201041a00000caf02200197000000000021041b000000000100001900002ec90001042e0000001f0220003900000cae022001970000000001120019000000000021004b0000000002000039000000010200403900000c1b0010009c00001a3c0000213d000000010020019000001a3c0000c13d000000400010043f000000000001042d00000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca00010430000000400100043d00000cb00010009c00001a480000813d0000016002100039000000400020043f000000000001042d00000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca00010430000000400100043d00000cb10010009c00001a540000813d0000004002100039000000400020043f000000000001042d00000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca0001043000000c320010009c00001aa80000213d000001a30010008c00001aa80000a13d000000400100043d00000cb00010009c00001aaa0000813d0000016002100039000000400020043f00000002020003670000004403200370000000000303043b00000c300030009c00001aa80000213d00000000033104360000006404200370000000000404043b00000c300040009c00001aa80000213d00000000004304350000008403200370000000000303043b00000c300030009c00001aa80000213d00000040041000390000000000340435000000a403200370000000000303043b00000bb30030009c00001aa80000213d00000060041000390000000000340435000000c403200370000000000303043b00000bb30030009c00001aa80000213d00000080041000390000000000340435000000e403200370000000000303043b00000bb30030009c00001aa80000213d000000a00410003900000000003404350000010403200370000000000303043b00000bb30030009c00001aa80000213d000000c00410003900000000003404350000012403200370000000000303043b00000bb30030009c00001aa80000213d000000e00410003900000000003404350000014403200370000000000303043b00000bb30030009c00001aa80000213d000001000410003900000000003404350000016403200370000000000303043b00000c100030009c00001aa80000213d000001200410003900000000003404350000018402200370000000000202043b000000000002004b0000000003000039000000010300c039000000000032004b00001aa80000c13d00000140031000390000000000230435000000000001042d000000000100001900002eca0001043000000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca0001043000000000430104340000000001320436000000000003004b00001abc0000613d000000000200001900000000051200190000000006240019000000000606043300000000006504350000002002200039000000000032004b00001ab50000413d000000000213001900000000000204350000001f0230003900000cae022001970000000001210019000000000001042d00000020030000390000000004310436000000003202043400000000002404350000004001100039000000000002004b00001ad10000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b00001aca0000413d000000000312001900000000000304350000001f0220003900000cae022001970000000001120019000000000001042d000000000010043f0000009801000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001ae50000613d000000000101043b000000000001042d000000000100001900002eca0001043000000c320010009c00001af50000213d000000430010008c00001af50000a13d00000002020003670000000401200370000000000101043b00000c100010009c00001af50000213d0000002402200370000000000202043b00000c100020009c00001af50000213d000000000001042d000000000100001900002eca0001043000000c320010009c00001b070000213d000000630010008c00001b070000a13d00000002030003670000000401300370000000000101043b00000c100010009c00001b070000213d0000002402300370000000000202043b00000c100020009c00001b070000213d0000004403300370000000000303043b000000000001042d000000000100001900002eca0001043000000cb20020009c00001b390000813d00000000040100190000001f0120003900000cae011001970000003f0110003900000cae05100197000000400100043d0000000005510019000000000015004b0000000007000039000000010700403900000c1b0050009c00001b390000213d000000010070019000001b390000c13d000000400050043f00000000052104360000000007420019000000000037004b00001b3f0000213d00000cae062001980000001f0720018f0000000204400367000000000365001900001b290000613d000000000804034f0000000009050019000000008a08043c0000000009a90436000000000039004b00001b250000c13d000000000007004b00001b360000613d000000000464034f0000000306700210000000000703043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000043043500000000022500190000000000020435000000000001042d00000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca00010430000000000100001900002eca000104300000001f03100039000000000023004b000000000400001900000c4a0400404100000c4a0520019700000c4a03300197000000000653013f000000000053004b000000000300001900000c4a0300204100000c4a0060009c000000000304c019000000000003004b00001b590000613d0000000203100367000000000303043b00000c1b0030009c00001b590000213d00000020011000390000000004310019000000000024004b00001b590000213d0000000002030019000000000001042d000000000100001900002eca00010430000000004301043400000c10033001970000000003320436000000000404043300000c1b04400197000000000043043500000040031000390000000003030433000000000003004b0000000003000039000000010300c0390000004004200039000000000034043500000060022000390000006001100039000000000101043300000c6d011001970000000000120435000000000001042d00000c320010009c00001b9f0000213d000000230010008c00001b9f0000a13d00000002030003670000000402300370000000000402043b00000c1b0040009c00001b9f0000213d0000002302400039000000000012004b00001b9f0000813d0000000402400039000000000223034f000000000502043b00000cb20050009c00001ba10000813d00000005065002100000003f0260003900000c4b07200197000000400200043d0000000007720019000000000027004b0000000008000039000000010800403900000c1b0070009c00001ba10000213d000000010080019000001ba10000c13d000000400070043f000000000052043500000024044000390000000006640019000000000016004b00001b9f0000213d000000000005004b00001b9d0000613d0000000001020019000000000543034f000000000505043b00000c100050009c00001b9f0000213d000000200110003900000000005104350000002004400039000000000064004b00001b940000413d0000000001020019000000000001042d000000000100001900002eca0001043000000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca0001043000000020030000390000000004310436000000000302043300000000003404350000004001100039000000000003004b00001bb50000613d00000000040000190000002002200039000000000502043300000000015104360000000104400039000000000034004b00001baf0000413d000000000001042d0006000000000002000300000002001d000600000001001d000000000100041100000c150010009c000500000003001d00001bca0000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001c920000613d000000000101043b0000000503000029000000000200041a000000000112013f00000c100010019800001c930000c13d0000012001300039000200000001001d000000000101043300000c100210019800001c260000613d000000400c00043d0000002401c00039000000010400008a000000000041043500000ca50100004100000000001c04350000000401c0003900000ca60400004100000000004104350000000001000414000000040020008c00001be40000c13d000000010b0000310000002000b0008c000000200400003900000000040b401900001c110000013d00000bb300c0009c00000bb30300004100000000030c4019000000400330021000000bb30010009c00000bb301008041000000c001100210000000000131019f00000c4e011001c700040000000c001d2ec82ebe0000040f000000040c000029000000600310027000000bb30b3001970000002000b0008c000000200400003900000000040b40190000001f0640018f000000200740019000000000057c001900001bff0000613d000000000801034f00000000090c0019000000008a08043c0000000009a90436000000000059004b00001bfb0000c13d000000000006004b00001c0c0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500010000000b001f0003000000010355000000010020019000001ca10000613d00000005030000290000001f01400039000000600210018f0000000001c20019000000000021004b0000000002000039000000010200403900000c1b0010009c00001c970000213d000000010020019000001c970000c13d000000400010043f0000001f00b0008c00001c900000a13d00000000010c0433000000000001004b0000000002000039000000010200c039000000000021004b00001c900000c13d000000000001004b00001c9d0000613d0000006001300039000400000001001d0000000001010433000100000001001d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001c920000613d000000000101043b000000010200002900000bb302200197000000000012004b00001c3d0000813d00000bb301100197000000040200002900000000001204350000000601000029000000000010043f0000009701000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000000050400002900001c900000613d000000003204043400000c300220019700000000030304330000008003300210000000000223019f000000000101043b000000000021041b0000004002400039000000000202043300000c300220019700000004030000290000000003030433000000800330021000000ca803300197000000000223019f00000080034000390000000003030433000000a00330021000000c7503300197000000000232019f000000a0034000390000000003030433000000c00330021000000c6b03300197000000000232019f000000c0034000390000000003030433000000e003300210000000000232019f0000000103100039000000000023041b0000000201100039000000e002400039000000000202043300000bb302200197000000000301041a00000ca903300197000000000223019f00000100034000390000000003030433000000200330021000000caa03300197000000000232019f00000002030000290000000003030433000000400330021000000c8803300197000000000232019f00000140034000390000000003030433000000000003004b00000c27030000410000000003006019000000000232019f000000000021041b000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000030300003900000cab04000041000000060500002900000003060000292ec82ebe0000040f000000010020019000001c900000613d000000000001042d000000000100001900002eca00010430000000000001042f00000ca401000041000000000010043f00000c2d0100004100002eca0001043000000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca0001043000000ca701000041000000000010043f00000c2d0100004100002eca000104300000001f05b0018f00000c4806b00198000000400200043d000000000462001900001cac0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00001ca80000c13d000000000005004b00001cb90000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001b0021000000bb30020009c00000bb3020080410000004002200210000000000112019f00002eca0001043000000c1001100197000000000010043f00000c3d01000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001cce0000613d000000000101043b000000000001042d000000000100001900002eca0001043000000c1002200197000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001cde0000613d000000000101043b000000000001042d000000000100001900002eca000104300007000000000002000300000002001d000500000001001d000600000003001d000000000003004b00001dd40000613d0000000601000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d000000000101043b000000000101041a000000000001004b00001d0f0000c13d00000c2401000041000000000101041a000000060010006c00001dd40000a13d0000000602000029000000010220008a000700000002001d000000000020043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d000000000101043b000000000101041a000000000001004b000000070200002900001cfc0000613d00000c270010019800001dd40000c13d000000050200002900000c1002200197000400000001001d00000c1001100197000700000002001d000000000021004b00001dd80000c13d0000000601000029000000000010043f00000c9a01000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d000000000201043b000000000302041a000000000100041100000c1004100197000000070040006c00001d500000613d000000000034004b00001d500000613d000500000004001d000100000003001d000200000002001d0000000701000029000000000010043f00000c3d01000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d000000000101043b0000000502000029000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d000000000101043b000000000101041a000000ff001001900000000202000029000000010300002900001de10000613d000000000003004b00001d530000613d000000000002041b0000000701000029000000000010043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d000000000101043b000000000201041a000000010220008a000000000021041b000000030100002900000c1001100197000500000001001d000000000010043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d000000000101043b000000000201041a0000000102200039000000000021041b00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000001ddc0000613d000000000101043b000300000001001d0000000601000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d0000000302000029000000a00220021000000005022001af00000c35022001c7000000000101043b000000000021041b000000040100002900000c350010019800001dc10000c13d00000006010000290000000101100039000300000001001d000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d000000000101043b000000000101041a000000000001004b00001dc10000c13d00000c2401000041000000000101041a000000030010006b00001dc10000613d0000000301000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000001dd20000613d000000000101043b0000000402000029000000000021041b000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000040300003900000c38040000410000000705000029000000050600002900000006070000292ec82ebe0000040f000000010020019000001dd20000613d000000050000006b00001ddd0000613d000000000001042d000000000100001900002eca0001043000000c9c01000041000000000010043f00000c2d0100004100002eca0001043000000cb301000041000000000010043f00000c2d0100004100002eca00010430000000000001042f00000cb501000041000000000010043f00000c2d0100004100002eca0001043000000cb401000041000000000010043f00000c2d0100004100002eca00010430000000000301001900000000011200a9000000000003004b00001dec0000613d00000000033100d9000000000023004b00001ded0000c13d000000000001042d00000c6401000041000000000010043f0000001101000039000000040010043f00000c470100004100002eca00010430000c000000000002000500000001001d000000000400041a000000000100041100000c150010009c00001e070000c13d000c00000004001d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f0000000100200190000020f20000613d000000000101043b0000000c0400002900000005020000290000000032020434000300000003001d000000000002004b000020e30000613d00010c100040019b00000c1003100197000000010030006c00000000010000390000000101006039000700000003001d00000c720030009c00000001011061bf00020001001001930000000002000019000a00000002001d000000050120021000000003011000290000000001010433000000020000006b00001e2c0000c13d000000a102000039000000000202041a000000400220027000000c1002200197000000070020006b00001e2c0000613d000000a202000039000000000202041a00000c1002200197000000070020006b00001e2c0000613d000000a302000039000000000202041a00000c1002200197000000070020006b000021530000c13d00000c1001100197000c00000001001d000000000010043f0000009c01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000020e40000613d000000000101043b000000000101041a000b00000001001d0000000c01000029000000000010043f0000009c01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000020e40000613d0000000b02000029000b0c300020019c000000000101043b000000000201041a00000c5f02200197000000000021041b000020f30000613d000000a301000039000000000101041a00000c100410019800001e6e0000613d000000a101000039000000000101041a0000ffff0110018f0000000b031000b9000027100930011a0006000b00900073000020ec0000413d0000000c02000029000000000002004b00001efd0000613d000000400a00043d0000002401a00039000000000091043500000cb70100004100000000001a04350000000401a0003900000000004104350000000001000414000000040020008c00001f050000c13d0000000103000031000000200030008c0000002004000039000000000403401900001f320000013d000000400800043d00000cba0080009c000020e60000213d000000a002800039000000400020043f0000000401000039000000000318043600000000010000310000000201100367000000000401034f0000000005030019000000004604043c0000000005650436000000000025004b00001e790000c13d00000001020000290000000000230435000000400280003900000c72030000410000000000320435000000a102000039000000000202041a000000400320027000000c1003300197000000600480003900000000003404350000008003800039000000a204000039000000000404041a00000c10044001970000000000430435000000400700043d00000cba0070009c000020e60000213d000000a004700039000000400040043f000000040300003900000000033704360000000005030019000000001601043c0000000005650436000000000045004b00001e950000c13d000900000008001d0000ffff0120018f000000000013043500000030012002700000ffff0110018f0000008003700039000000000013043500000020012002700000ffff0110018f00000060037000390000000000130435000800000007001d000000400170003900000010022002700000ffff0220018f000000000021043500000c5b01000041000000000010044300000ca60100004100000004001004430000000c0000006b00001f480000613d000000000100041400000bb30010009c00000bb301008041000000c00110021000000c5c011001c700008002020000392ec82ec30000040f0000000100200190000020f20000613d000000000101043b000000000001004b0000000908000029000020e40000613d000000400600043d00000044016000390000008002000039000000000021043500000024016000390000000c02000029000000000021043500000cb901000041000000000016043500000004016000390000000b020000290000000000210435000000000308043300000084026000390000000000320435000000a402600039000000000003004b000000080700002900001ed70000613d00000000040000190000002008800039000000000508043300000c100550019700000000025204360000000104400039000000000034004b00001ed00000413d00000000011200490000006403600039000000000013043500000000030704330000000001320436000000000003004b00001ee60000613d0000000002000019000000200770003900000000040704330000ffff0440018f00000000014104360000000102200039000000000032004b00001edf0000413d000000000161004900000bb30010009c00000bb3010080410000006001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000121019f00000bb30060009c00000bb3020000410000000002064019000800400020021800000008011001af00000ca602000041000900000006001d2ec82ebe0000040f000000600310027000010bb30030019d000300000001035500000001002001900000206f0000c13d0000210a0000013d0000000001000414000000040040008c00001f990000c13d00000001010000310000000102000039000000000001004b00001fad0000c13d00001fd40000013d000400000009001d00000bb300a0009c00000bb30300004100000000030a4019000000400330021000000bb30010009c00000bb301008041000000c001100210000000000131019f00000c4e011001c700090000000a001d2ec82ebe0000040f000000090a000029000000600310027000000bb303300197000000200030008c00000020040000390000000004034019000000200640019000000000056a001900001f200000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b00001f1c0000c13d0000001f0740019000001f2d0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f000300000001035500000001002001900000000409000029000021280000613d0000001f01400039000000600110018f0000000008a10019000000000018004b0000000001000039000000010100403900000c1b0080009c000020e60000213d0000000100100190000020e60000c13d000000400080043f000000200030008c000020e40000413d00000000010a0433000000000001004b0000000002000039000000010200c039000000000021004b000020e40000c13d00000cb80080009c00001fd90000413d000020e60000013d000000000100041400000bb30010009c00000bb301008041000000c00110021000000c5c011001c700008002020000392ec82ec30000040f0000000100200190000020f20000613d000000000101043b000000000001004b0000000908000029000020e40000613d000000400600043d00000044016000390000008002000039000000000021043500000cb901000041000000000016043500000004016000390000000b02000029000000000021043500000024026000390000000000020435000000000308043300000084026000390000000000320435000000a402600039000000000003004b000000080700002900001f6f0000613d00000000040000190000002008800039000000000508043300000c100550019700000000025204360000000104400039000000000034004b00001f680000413d00000000011200490000006403600039000000000013043500000000030704330000000001320436000000000003004b00001f7e0000613d0000000002000019000000200770003900000000040704330000ffff0440018f00000000014104360000000102200039000000000032004b00001f770000413d000000000161004900000bb30010009c00000bb3010080410000006001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000121019f00000bb30060009c00000bb3020000410000000002064019000800400020021800000008011001af00000c1d011001c700008009020000390000000b0300002900000ca6040000410000000005000019000900000006001d2ec82ebe0000040f000000600310027000010bb30030019d000300000001035500000001002001900000206f0000c13d000021340000013d00000bb30010009c00000bb301008041000000c001100210000027100030008c000400000009001d00001fa10000813d000000000204001900001fa50000013d00000c1d011001c70000800902000039000000000309001900000000050000192ec82ebe0000040f00000004090000290003000000010355000000600110027000010bb30010019d00000bb301100197000000000001004b00001fd40000613d00000c1b0010009c000020e60000213d0000001f0310003900000cae033001970000003f0330003900000cae04300197000000400300043d0000000004430019000000000034004b0000000005000039000000010500403900000c1b0040009c000020e60000213d0000000100500190000020e60000c13d000000400040043f000000000613043600000cae041001980000000003460019000000030500036700001fc70000613d000000000705034f000000007807043c0000000006860436000000000036004b00001fc30000c13d0000001f0110019000001fd40000613d000000000445034f0000000301100210000000000503043300000000051501cf000000000515022f000000000404043b0000010001100089000000000414022f00000000011401cf000000000151019f00000000001304350000000100200190000021170000613d000000400800043d00000cb80080009c000020e60000813d0000008001800039000000400010043f0000000302000039000000000228043600000000030000310000000203300367000000000403034f0000000005020019000000004604043c0000000005650436000000000015004b00001fe10000c13d00000c72010000410000000000120435000000a101000039000000000201041a000000400120027000000c1001100197000000400480003900000000001404350000006001800039000000a204000039000000000404041a00000c10044001970000000000410435000000400700043d00000c1c0070009c000020e60000213d0000008004700039000000400040043f000000030100003900000000011704360000000005010019000000003603043c0000000005650436000000000045004b00001ffa0000c13d0000ffff0420018f00002710034000890000ffff0030008c000020ec0000213d000027100040008c000020f70000613d00000bb30430019700000030032002700000ffff0330018f00002710033000c900000000034300d90000ffff0330018f0000006005700039000000000035043500000020022002700000ffff0220018f00002710022000c900000000024200d90000ffff0220018f0000004004700039000000000024043500002710022000890000ffff0020008c000020ec0000213d00000000023200490000ffff0020008c000020ec0000213d000900000008001d000800000007001d000000000021043500000c5b01000041000000000010044300000ca60100004100000004001004430000000c0000006b000020710000613d000000000100041400000bb30010009c00000bb301008041000000c00110021000000c5c011001c700008002020000392ec82ec30000040f0000000100200190000020f20000613d000000000101043b000000000001004b0000000908000029000020e40000613d000000400600043d00000044016000390000008002000039000000000021043500000024016000390000000c02000029000000000021043500000cb9010000410000000000160435000000040160003900000006020000290000000000210435000000000308043300000084026000390000000000320435000000a402600039000000000003004b00000008070000290000204a0000613d00000000040000190000002008800039000000000508043300000c100550019700000000025204360000000104400039000000000034004b000020430000413d00000000011200490000006403600039000000000013043500000000030704330000000001320436000000000003004b000020590000613d0000000002000019000000200770003900000000040704330000ffff0440018f00000000014104360000000102200039000000000032004b000020520000413d000000000161004900000bb30010009c00000bb3010080410000006001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000121019f00000bb30060009c00000bb3020000410000000002064019000800400020021800000008011001af00000ca602000041000900000006001d2ec82ebe0000040f000000600310027000010bb30030019d00030000000103550000000100200190000020fd0000613d0000000902000029000020c80000013d000400000009001d000000000100041400000bb30010009c00000bb301008041000000c00110021000000c5c011001c700008002020000392ec82ec30000040f0000000100200190000020f20000613d000000000101043b000000000001004b00000004070000290000000909000029000020e40000613d000000400600043d00000044016000390000008002000039000000000021043500000cb901000041000000000016043500000004016000390000000602000029000000000021043500000024026000390000000000020435000000000309043300000084026000390000000000320435000000a402600039000000000003004b00000008080000290000209a0000613d00000000040000190000002009900039000000000509043300000c100550019700000000025204360000000104400039000000000034004b000020930000413d00000000011200490000006403600039000000000013043500000000030804330000000001320436000000000003004b000020a90000613d0000000002000019000000200880003900000000040804330000ffff0440018f00000000014104360000000102200039000000000032004b000020a20000413d000000000161004900000bb30010009c00000bb301008041000000600110021000000bb30060009c000900000006001d00000bb3020000410000000002064019000800400020021800000008011001af000000000200041400000bb30020009c00000bb302008041000000c002200210000000000121019f0000000b0070006b000020bc0000c13d00000ca602000041000020c10000013d00000c1d011001c70000800902000039000000060300002900000ca60400004100000000050000192ec82ebe0000040f0003000000010355000000600310027000010bb30030019d000000010020019000000009020000290000211b0000613d00000c1b0020009c000020e60000213d000000400020043f0000000c01000029000000000012043500000020012000390000000b020000290000000000210435000000000100041400000bb30010009c00000bb301008041000000c00110021000000008011001af00000c26011001c70000800d02000039000000020300003900000cbb0400004100000007050000292ec82ebe0000040f0000000100200190000020e40000613d0000000a02000029000000010220003900000005010000290000000001010433000000000012004b00001e160000413d000000000001042d000000000100001900002eca0001043000000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca0001043000000c6401000041000000000010043f0000001101000039000000040010043f00000c470100004100002eca00010430000000000001042f00000cbc01000041000000000010043f00000c2d0100004100002eca0001043000000c6401000041000000000010043f0000001201000039000000040010043f00000c470100004100002eca0001043000000bb3033001970000001f0530018f00000c4806300198000000400200043d0000000004620019000021400000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000021050000c13d000021400000013d00000bb3033001970000001f0530018f00000c4806300198000000400200043d0000000004620019000021400000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000021120000c13d000021400000013d00000c6001000041000000000010043f00000c2d0100004100002eca0001043000000bb3033001970000001f0530018f00000c4806300198000000400200043d0000000004620019000021400000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000021230000c13d000021400000013d0000001f0530018f00000c4806300198000000400200043d0000000004620019000021400000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000212f0000c13d000021400000013d00000bb3033001970000001f0530018f00000c4806300198000000400200043d0000000004620019000021400000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000213c0000c13d000000000005004b0000214d0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f0000000000140435000000600130021000000bb30020009c00000bb3020080410000004002200210000000000112019f00002eca0001043000000cb601000041000000000010043f00000c2d0100004100002eca0001043000000c1001100198000021690000613d000000000010043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f00000001002001900000216d0000613d000000000101043b000000000101041a00000c1b01100197000000000001042d00000c4501000041000000000010043f00000c2d0100004100002eca00010430000000000100001900002eca00010430000b000000000002000600000006001d000500000005001d000400000004001d000a00000003001d000b00000002001d000300000001001d0000000201100367000000000101043b000000000010043f0000009701000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000022500000613d000000000101043b000700000001001d0000009801000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000022500000613d000000000101043b000000000101041a00000007020000290000000202200039000000000202041a000000200220027000000bb302200197000000020020008c000021a20000413d0000000b03000029000000000003004b000021a40000613d00000000043200a900000000033400d9000000000023004b000021a50000613d0000225b0000013d0000000b04000029000021a50000013d000000000400001900000c2402000041000000000202041a000800000002001d00000010021002700000ffff02200190000021d20000613d000000000042004b000021e10000a13d00000030021002700000ffff02200190000021d20000613d000000000042004b000021d60000a13d00000050021002700000ffff02200190000021d20000613d000000000042004b000021d80000a13d00000070021002700000ffff02200190000021d20000613d000000000042004b000021da0000a13d00000090021002700000ffff02200190000021d20000613d000000000042004b000021dc0000a13d000000b0021002700000ffff02200190000021d20000613d000000000042004b000021de0000a13d000000d0021002700000ffff02200190000021d20000613d000000000042004b000021e00000a13d000000f002100272000021d20000613d000000000042004b0000000003000019000021e70000213d000000e001100270000021e10000013d0000000003000019000000000040001a0000225b0000413d000021e90000013d0000002001100270000021e10000013d0000004001100270000021e10000013d0000006001100270000021e10000013d0000008001100270000021e10000013d000000a001100270000021e10000013d000000c00110027000000000022400d90000ffff0110018f00000000031200a900000000022300d9000000000012004b0000225b0000c13d000000000043001a0000225b0000413d000200000004001d000100000003001d000b00000043001e000022520000613d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f0000000100200190000022560000613d000000000101043b000900000001001d0000000801000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f00000001002001900000000b05000029000022500000613d0000000a0200002900000c10042001970000000902000029000000a002200210000000010050008c000000000300001900000c3503006041000000000223019f000000000242019f000000000101043b000000000021041b000a00000004001d000000000040043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000b040000290000000100200190000022500000613d00000c37024000d1000000000101043b000000000301041a0000000002230019000000000021041b0000000a0000006b000022570000613d000900080040002d000b00080000002d00000000010000190000223c0000013d0000000b07000029000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000040300003900000c380400004100000000050000190000000a06000029000b00000007001d2ec82ebe0000040f00000001002001900000000101000039000022500000613d00000001001001900000222c0000613d0000000b070000290000000107700039000000090070006c0000222d0000c13d00000c24010000410000000902000029000000000021041b0000000801000029000000010510008a00000007010000290000000302000029000000020300002900000001040000290000000406000029000000050700002900000006080000292ec827390000040f000000000001042d000000000100001900002eca0001043000000c3a01000041000000000010043f00000c2d0100004100002eca00010430000000000001042f00000c3901000041000000000010043f00000c2d0100004100002eca0001043000000c6401000041000000000010043f0000001101000039000000040010043f00000c470100004100002eca00010430000a000000000002000100000004001d000500000002001d000600000001001d000700000003001d000000000003004b000023e50000613d0000000701000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d000000000101043b000000000101041a000000000001004b000022910000c13d00000c2401000041000000000101041a000000070010006c000023e50000a13d0000000702000029000000010220008a000800000002001d000000000020043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d000000000101043b000000000101041a000000000001004b00000008020000290000227e0000613d00000c2700100198000023e50000c13d000000060200002900000c1002200197000300000001001d00000c1001100197000800000002001d000000000021004b000023ea0000c13d0000000701000029000000000010043f00000c9a01000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d000000000301043b000000000403041a000000000100041100000c1002100197000400000002001d000000080020006c000022d20000613d000000040040006b000022d20000613d000200000004001d000600000003001d0000000801000029000000000010043f00000c3d01000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d000000000101043b0000000402000029000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d000000000101043b000000000101041a000000ff0010019000000006030000290000000204000029000023f20000613d000000000004004b000022d50000613d000000000003041b0000000801000029000000000010043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d000000000101043b000000000201041a000000010220008a000000000021041b000000050100002900000c1001100197000600000001001d000000000010043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d000000000101043b000000000201041a0000000102200039000000000021041b00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f0000000100200190000023e90000613d000000000101043b000200000001001d0000000701000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d0000000202000029000000a0022002100000000606000029000000000262019f00000c35022001c7000000000101043b000000000021041b000000030100002900000c3500100198000023460000c13d00000007010000290000000101100039000200000001001d000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d000000000101043b000000000101041a000000000001004b0000000606000029000023460000c13d00000c2401000041000000000101041a000000020010006b000023460000613d0000000201000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000023e30000613d000000000101043b0000000302000029000000000021041b0000000606000029000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000040300003900000c3804000041000000080500002900000007070000292ec82ebe0000040f0000000100200190000023e30000613d000000060000006b000023ee0000613d00000c5b01000041000000000010044300000005010000290000000400100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c5c011001c700008002020000392ec82ec30000040f0000000100200190000023e90000613d000000000101043b000000000001004b000023e20000613d0000000008000415000000400b00043d0000006401b00039000000800700003900000000007104350000004401b00039000000070200002900000000002104350000002401b000390000000802000029000000000021043500000cbd0100004100000000001b04350000000401b00039000000040200002900000000002104350000008403b00039000000010100002900000000210104340000000000130435000000a403b00039000000000001004b000023840000613d000000000400001900000000053400190000000006420019000000000606043300000000006504350000002004400039000000000014004b0000237d0000413d0000000002310019000000000002043500000000040004140000000602000029000000040020008c000023920000c13d00000000050004150000000a0550008a00000005055002100000000103000031000000200030008c00000020040000390000000004034019000023ca0000013d000700000008001d000500000007001d0000001f0110003900000cae01100197000000a40110003900000bb30010009c00000bb301008041000000600110021000000bb300b0009c00000bb30300004100000000030b40190000004003300210000000000131019f00000bb30040009c00000bb304008041000000c003400210000000000113019f00080000000b001d2ec82ebe0000040f000000080b000029000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b0019000023b50000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000023b10000c13d000000000006004b000023c20000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000005000415000000090550008a00000005055002100000000100200190000023f60000613d00000007080000290000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000c1b0010009c000024280000213d0000000100200190000024280000c13d000000400010043f000000200030008c000023e30000413d00000000010b043300000c9e00100198000023e30000c13d0000000502500270000000000201001f00000000020004150000000002280049000000000200000200000c9f0110019700000cbd0010009c000024240000c13d000000000001042d000000000100001900002eca0001043000000c9c01000041000000000010043f00000c2d0100004100002eca00010430000000000001042f00000cb301000041000000000010043f00000c2d0100004100002eca0001043000000cb501000041000000000010043f00000c2d0100004100002eca0001043000000cb401000041000000000010043f00000c2d0100004100002eca00010430000000000003004b000023fa0000c13d0000006002000039000024210000013d0000001f0230003900000c54022001970000003f0220003900000cbe04200197000000400200043d0000000004420019000000000024004b0000000005000039000000010500403900000c1b0040009c000024280000213d0000000100500190000024280000c13d000000400040043f0000001f0430018f000000000632043600000c4805300198000500000006001d0000000003560019000024140000613d000000000601034f0000000507000029000000006806043c0000000007870436000000000037004b000024100000c13d000000000004004b000024210000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b0000242e0000c13d00000cbf01000041000000000010043f00000c2d0100004100002eca0001043000000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca00010430000000050200002900000bb30020009c00000bb302008041000000400220021000000bb30010009c00000bb3010080410000006001100210000000000121019f00002eca0001043000010000000000020000000003010019000000400100043d00000cb80010009c000024900000813d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000003004b0000248d0000613d00000c2402000041000000000202041a000000000032004b0000248d0000a13d000100000003001d000000000030043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f00000001002001900000248e0000613d000000000101043b000000000101041a000000000001004b0000245f0000c13d0000000103000029000000010330008a0000244b0000013d000000400100043d00000c1c0010009c0000000103000029000024900000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000030043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f00000001002001900000248e0000613d000000000301034f000000400100043d00000c1c0010009c000024900000213d000000000203043b000000000202041a0000008003100039000000400030043f0000006003100039000000e804200270000000000043043500000c27002001980000000003000039000000010300c0390000004004100039000000000034043500000c10032001970000000003310436000000a00220027000000c1b022001970000000000230435000000000001042d000000000100001900002eca0001043000000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca000104300002000000000002000000400400043d000000240340003900000c5102000041000000000023043500000c52020000410000000000240435000200000001001d00000c10011001970000000402400039000000000012043500000bb30040009c000100000004001d00000bb30100004100000000010440190000004001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c4e011001c700000c53020000412ec82ec30000040f000000600310027000010bb30030019d000300000001035500000001002001900000250a0000613d00000bb3023001970000001f0420018f00000c480520019800000001090000290000000003590019000024bf0000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000037004b000024bb0000c13d000000000004004b000024cc0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000001f0120003900000c54031001970000000001930019000000000031004b0000000003000039000000010300403900000c1b0010009c0000250e0000213d00000001003001900000250e0000c13d000000400010043f0000001f0020008c0000250c0000a13d000000000409043300000c1b0040009c0000250c0000213d000000000392001900000000029400190000001f04200039000000000034004b000000000500001900000c4a0500804100000c4a0440019700000c4a06300197000000000764013f000000000064004b000000000400001900000c4a0400404100000c4a0070009c000000000405c019000000000004004b0000250c0000c13d000000002402043400000c1b0040009c0000250e0000213d00000005054002100000003f0650003900000c4b06600197000000000616001900000c1b0060009c0000250e0000213d000000400060043f00000000044104360000000005520019000000000035004b0000250c0000213d000000000052004b000025030000813d0000000003040019000000002602043400000c100060009c0000250c0000213d0000000003630436000000000052004b000024fd0000413d0000000001010433000000000001004b00000002010000290000250b0000613d000000000104043300000c1001100197000000000001042d0000000201000029000000000001042d000000000100001900002eca0001043000000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca000104300008000000000002000400000001001d000000000100041100000c150010009c000025250000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f0000000100200190000026570000613d000000000101043b000100000001001d00000004010000290000000021010434000300000002001d000000000001004b000026280000613d000000010100002900070c100010019b0000000002000019000500000002001d000000050120021000000003011000290000000001010433000800000001001d0000000701000029000000000010043f0000009d01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000026290000613d000000080200002900000c1002200197000000000101043b000800000002001d000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000026290000613d000000000101043b000000000101041a000600000001001d0000000701000029000000000010043f0000009d01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000026290000613d000000000101043b0000000802000029000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000026290000613d000000060200002900000c3009200198000000000101043b000000000201041a00000c5f02200197000000000021041b000026310000613d0000000803000029000000000003004b000025860000613d000000400a00043d0000002401a00039000000000091043500000cb70100004100000000001a04350000000401a00039000000070200002900000000002104350000000001000414000000040030008c0000258f0000c13d0000000103000031000000200030008c00000020040000390000000004034019000025bd0000013d00000000010004140000000104000029000000040040008c000025d30000c13d00000001010000310000000102000039000000000001004b000025e40000c13d0000260b0000013d000600000009001d00000bb300a0009c00000bb30200004100000000020a4019000000400220021000000bb30010009c00000bb301008041000000c001100210000000000121019f00000c4e011001c7000000000203001900020000000a001d2ec82ebe0000040f000000020a000029000000600310027000000bb303300197000000200030008c00000020040000390000000004034019000000200640019000000000056a0019000025ab0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b000025a70000c13d0000001f07400190000025b80000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f000300000001035500000001002001900000000609000029000026390000613d0000001f01400039000000600210018f0000000001a20019000000000021004b0000000002000039000000010200403900000c1b0010009c0000262b0000213d00000001002001900000262b0000c13d000000400010043f000000200030008c000026290000413d00000000020a0433000000000002004b0000000003000039000000010300c039000000000032004b000026290000c13d000000000002004b0000260e0000c13d000026350000013d00000bb30010009c00000bb301008041000000c00110021000000c1d011001c7000080090200003900000000030900190000000005000019000600000009001d2ec82ebe0000040f0000000609000029000000010220018f0003000000010355000000600110027000010bb30010019d00000bb301100197000000000001004b0000260b0000613d00000c1b0010009c0000262b0000213d0000001f0310003900000cae033001970000003f0330003900000cae04300197000000400300043d0000000004430019000000000034004b0000000005000039000000010500403900000c1b0040009c0000262b0000213d00000001005001900000262b0000c13d000000400040043f000000000613043600000cae0410019800000000034600190000000305000367000025fe0000613d000000000705034f000000007807043c0000000006860436000000000036004b000025fa0000c13d0000001f011001900000260b0000613d000000000445034f0000000301100210000000000503043300000000051501cf000000000515022f000000000404043b0000010001100089000000000414022f00000000011401cf000000000151019f0000000000130435000000000002004b000026350000613d000000400100043d000000200210003900000000009204350000000802000029000000000021043500000bb30010009c00000bb3010080410000004001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c26011001c70000800d02000039000000020300003900000cbb0400004100000007050000292ec82ebe0000040f0000000100200190000026290000613d0000000502000029000000010220003900000004010000290000000001010433000000000012004b0000252e0000413d000000000001042d000000000100001900002eca0001043000000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca0001043000000cbc01000041000000000010043f00000c2d0100004100002eca0001043000000c6001000041000000000010043f00000c2d0100004100002eca000104300000001f0530018f00000c4806300198000000400200043d0000000004620019000026440000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000026400000c13d000000000005004b000026510000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f0000000000140435000000600130021000000bb30020009c00000bb3020080410000004002200210000000000112019f00002eca00010430000000000001042f000000000100041100000c150010009c000026670000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f0000000100200190000026680000613d000000000101043b000000000001042d000000000001042f0001000000000002000000000001004b0000269a0000613d000100000001001d000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000026980000613d000000000101043b000000000101041a000000000001004b000026950000c13d00000c2401000041000000000101041a0000000102000029000000000021004b0000269a0000a13d000000010220008a000100000002001d000000000020043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000026980000613d000000000101043b000000000101041a000000000001004b0000000102000029000026820000613d00000c27001001980000269a0000c13d000000000001042d000000000100001900002eca0001043000000c9c01000041000000000010043f00000c2d0100004100002eca00010430000000000001004b000026a10000613d000000000001042d000000400100043d000000440210003900000c8903000041000000000032043500000024021000390000001903000039000000000032043500000c1102000041000000000021043500000004021000390000002003000039000000000032043500000bb30010009c00000bb301008041000000400110021000000c5e011001c700002eca00010430000000002101043400000c10011001970000000002020433000000a002200210000000000112019f0000006502000039000000000012041b000000000001042d00000c1006100197000000000100041a00000c1902100197000000000262019f000000000020041b000000000200041400000c100510019700000bb30020009c00000bb302008041000000c00120021000000c1d011001c70000800d02000039000000030300003900000c6a040000412ec82ebe0000040f0000000100200190000026cc0000613d000000000001042d000000000100001900002eca000104300004000000000002000300000001001d000200000002001d000000000002004b000027300000613d00000c2401000041000000000101041a000400000001001d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f0000000100200190000027340000613d000000000101043b000100000001001d0000000401000029000000000010043f00000c2501000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000000002050000290000272e0000613d000000030200002900000c10042001970000000102000029000000a002200210000000010050008c000000000300001900000c3503006041000000000223019f000000000242019f000000000101043b000000000021041b000300000004001d000000000040043f00000c3601000041000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000020400002900000001002001900000272e0000613d00000c37024000d1000000000101043b000000000301041a0000000002230019000000000021041b000000030000006b000027350000613d000200040040002d0000000001000019000027240000013d0000000407000029000000000100041400000bb30010009c00000bb301008041000000c00110021000000c1d011001c70000800d02000039000000040300003900000c380400004100000000050000190000000306000029000400000007001d2ec82ebe0000040f000000010020019000000001010000390000272e0000613d0000000100100190000027140000613d00000004070000290000000107700039000000020070006c000027150000c13d00000c24010000410000000202000029000000000021041b000000000001042d000000000100001900002eca0001043000000c3a01000041000000000010043f00000c2d0100004100002eca00010430000000000001042f00000c3901000041000000000010043f00000c2d0100004100002eca000104300014000000000002001400000008001d000a00000007001d001100000006001d000e00000005001d001200000002001d001000000001001d000f00000003001d000d00000004001d000000000034001a00002da00000413d000000400100043d00000cba0010009c00002d9a0000213d000000a002100039000000400020043f00000080021000390000000000020435000000600210003900000000000204350000004002100039000000000002043500000020021000390000000000020435000000000001043500000012010000290000000201100367000000000101043b000000000200041a000c00000002001d000300000001001d000000000010043f0000009b01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b000000400200043d001300000002001d00000cba0020009c00002d9a0000213d0000000d030000290000000f043000290000000c0200002900000c1002200197000000000101041a0000001306000029000000a003600039000000400030043f0000008003600039000200000003001d000000000013043500000060036000390000000e0500002900000000005304350000004005600039000c00000004001d000700000005001d00000000004504350000000004260436000000110200002900000c1002200197001100000002001d000000000024043500000010080000290000000102800039000e00000002001d000000000a02041a00000c3007a00197000000000908041a00000c30069001970000009f02000039000000000502041a0000000202800039000d00000002001d000000000202041a00000bb302200198000600000003001d000b00000004001d000027bd0000613d000000000007004b000027dd0000613d00010000000a001d000400000002001d000500000009001d000800000007001d000900000006001d001000000005001d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000002da60000613d0000000102000029000000800220027000000bb302200197000000000101043b000000000321004b0000001005000029000000090400002900000008060000290000000507000029000000040800002900002da00000413d00000000018300d900000000026100a9000000000038004b000027b50000213d00000000011200d9000000000061004b00002da00000c13d0000008001700270000000000314004b000027e30000a13d000000000032004b000027ea0000213d000000000124004b000027ea0000813d00002da00000013d000000000007004b000027dd0000613d00000000021700a900000000037200d9000000000013004b00002da00000c13d000000000062001a00002da00000413d000000000262001a0000000f012000b9000027cb0000613d00000000022100d90000000f0020006c00002da00000c13d0000000f0000006b00002da00000613d0000000f027000b900000000037200d90000000f0030006c00002da00000c13d000000000002004b00002d910000613d0000000f03000029000000010430008a00000000034200a900000000022300d9000000000042004b00002da00000c13d0000000102300270000000000012001a00002da00000413d00002d940000013d000000000006004b000027f20000613d0000000f0200002900000000042600a900000000016400d9000027ef0000013d000027f60000813d0000000003410049000000000032004b000027ec0000213d000000000042001a00002da00000413d0000000001420019000000000001004b000027f90000613d0000000f0200002900000000042100a900000000011400d9000000000021004b000027fa0000613d00002da00000013d0000000004000019000000110000006b000027fc0000c13d000028060000013d0000000001040019000000000004004b000027ec0000c13d0000000004000019000000110000006b000028060000613d000000f00250027000000000012400a9000000000004004b000028030000613d00000000034100d9000000000023004b00002da00000c13d000027100110011a000000000414004b00002da00000413d000500000004001d000000000300041100000c150030009c000028160000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000002da60000613d000000000301043b000000400400043d000000240140003900000c5102000041000000000021043500000c52010000410000000000140435000800000003001d00000c1002300197001000000002001d0000000401400039000000000021043500000bb30040009c000900000004001d00000bb30100004100000000010440190000004001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c4e011001c700000c53020000412ec82ec30000040f0000001004000029000000600310027000010bb30030019d000300000001035500000001002001900000288d0000613d00000bb3023001970000001f0420018f00000c480520019800000009090000290000000003590019000028400000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000037004b0000283c0000c13d000000000004004b0000284d0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000001f0120003900000c54031001970000000001930019000000000031004b0000000003000039000000010300403900000c1b0010009c00002d9a0000213d000000010030019000002d9a0000c13d000000400010043f000000200020008c00002d980000413d000000000309043300000c1b0030009c00002d980000213d000000000492001900000000029300190000001f03200039000000000043004b000000000500001900000c4a0500804100000c4a0330019700000c4a06400197000000000763013f000000000063004b000000000300001900000c4a0300404100000c4a0070009c000000000305c019000000000003004b00002d980000c13d000000002502043400000c1b0050009c00002d9a0000213d00000005065002100000003f0360003900000c4b03300197000000000313001900000c1b0030009c00002d9a0000213d000000400030043f00000000035104360000000006260019000000000046004b00002d980000213d000000000062004b000028850000813d0000000004030019000000002502043400000c100050009c00002d980000213d0000000004540436000000000062004b0000287e0000413d0000000005010433000000000005004b000000100400002900000000010400190000288e0000613d000000000103043300000c1001100197000800000001001d0000288e0000013d0000000001040019000100000001001d0000000b01000029000000000101043300000c1001100198000029440000613d00000c720010009c00002dab0000613d0000001302000029000000000202043300000c1002200197000000000021004b00002dab0000613d000000000041004b00002dab0000613d0000009f02000039000000000202041a001300000002001d000000400200043d000000140300003900000000033204360000006001100210000000000013043500000c1f0020009c00002d9a0000213d0000004001200039000000400010043f00000bb30030009c00000bb3030080410000004001300210000000000202043300000bb30020009c00000bb3020080410000006002200210000000000112019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b000000200010043f00000cc001000041000000000010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000cc1011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d0000000004000031000000000201043b000000140100002900000c1b0010009c00002d9a0000213d00000014010000290000001f0110003900000cae011001970000003f0110003900000cae03100197000000400100043d0000000003310019000000000013004b0000000006000039000000010600403900000c1b0030009c00002d9a0000213d000000010060019000002d9a0000c13d000000400030043f000000140600002900000000036104360000000a06600029000000000046004b00002d980000213d000000140400002900000cae054001980000001f0640018f0000000a0400002900000002074003670000000004530019000028ed0000613d000000000807034f0000000009030019000000008a08043c0000000009a90436000000000049004b000028e90000c13d000000000006004b000028fa0000613d000000000557034f0000000306600210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f000000000054043500000014043000290000000000040435000000400400043d001400000004001d000000000020043f0000000002030433000000400020043f0000000002010433000000400020008c0000290e0000613d000000410020008c0000000002000019000029160000c13d00000060021000390000000002020433000000f802200270000000200020043f00000040011000390000000001010433000029140000013d00000040011000390000000001010433000000ff021002700000001b02200039000000200020043f00000c3201100197000000600010043f0000000102000039000000000100041400000bb30010009c00000bb301008041000000c00110021000000c2e011001c72ec82ec30000040f000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0540018f000000200640019000000001046001bf0000292b0000613d0000000107000039000000000801034f000000008908043c0000000007970436000000000047004b000029270000c13d000000000005004b000029380000613d000000000661034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350003000000010355000100000003001f000000000003004b00002dcf0000613d000000010120018f0000000001010433000000600000043f0000001402000029000000400020043f000000130110014f00000c100010019800002dd30000c13d0000000e01000029000000000201041a000000c001200270000a0bb30010019c00002daf0000613d00000012010000290000000201100367000000000301043b0000000d01000029000000000101041a000b00000001001d00000c3b00100198000400000002001d000029fe0000613d000001000030008c000029fa0000413d000900000003001d000000400100043d000000140200003900000000022104360000000b03000029000000200330021000000cc303300197000000000032043500000c1f0010009c00002d9a0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b000000090010006b000029fa0000613d000000120400002900000020014000390000000202000367000000000112034f000000000301043b000000000100003100000000044100490000001f0440008a00000c4a0540019700000c4a06300197000000000756013f000000000056004b000000000500001900000c4a05004041000000000043004b000000000400001900000c4a0400804100000c4a0070009c000000000504c019000000000005004b00002d980000c13d0000001203300029000000000232034f000000000602043b00000c1b0060009c00002d980000213d00000005076002100000000001710049000000200530003900000c4a0210019700000c4a03500197000000000423013f000000000023004b000000000200001900000c4a02004041000000000015004b000000000100001900000c4a0100204100000c4a0040009c000000000201c019000000000002004b00002d980000c13d000000400100043d0000001402000039000000000221043600000008030000290000006003300210000000000032043500000c1f0010009c00002d9a0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c70000801002000039001400000005001d001300000006001d000800000007001d2ec82ec30000040f000000080700002900000013060000290000001408000029000000010020019000002d980000613d000000000101043b0000003f0270003900000c4b02200197000000400300043d0000000002230019000000000032004b0000000004000039000000010400403900000c1b0020009c00002d9a0000213d000000010040019000002d9a0000c13d000000400020043f00000000026304360000000004870019000000000040007c00002d980000213d000000000084004b000029dd0000a13d000000020580036700000000060300190000002006600039000000005705043c00000000007604350000002008800039000000000048004b000029d60000413d0000000006030433000000000006004b000029f80000613d0000000503600210001300000023001d0000000043020434001400000004001d000000000031004b000000000300003900000020030020390000000000130435000000200130015f00000000020204330000000000210435000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b0000001403000029000000130030006c0000000002030019000029e10000413d000000090010006c00002aa60000c13d00000cc401000041000000000010043f00000c2d0100004100002eca00010430000001000030008c00002aa60000413d000900000003001d000000400100043d000000140200003900000000022104360000000b03000029000000200330021000000cc303300197000000000032043500000c1f0010009c00002d9a0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b000000090010006b00002aa60000613d000000120400002900000020014000390000000202000367000000000112034f000000000301043b000000000100003100000000044100490000001f0440008a00000c4a0540019700000c4a06300197000000000756013f000000000056004b000000000500001900000c4a05004041000000000043004b000000000400001900000c4a0400804100000c4a0070009c000000000504c019000000000005004b00002d980000c13d0000001203300029000000000232034f000000000602043b00000c1b0060009c00002d980000213d00000005076002100000000001710049000000200530003900000c4a0210019700000c4a03500197000000000423013f000000000023004b000000000200001900000c4a02004041000000000015004b000000000100001900000c4a0100204100000c4a0040009c000000000201c019000000000002004b00002d980000c13d000000400100043d0000001402000039000000000221043600000008030000290000006003300210000000000032043500000c1f0010009c00002d9a0000213d0000004003100039000000400030043f00000bb30020009c00000bb3020080410000004002200210000000000101043300000bb30010009c00000bb3010080410000006001100210000000000121019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c70000801002000039001400000005001d001300000006001d000800000007001d2ec82ec30000040f000000080700002900000013060000290000001408000029000000010020019000002d980000613d000000000101043b0000003f0270003900000c4b02200197000000400300043d0000000002230019000000000032004b0000000004000039000000010400403900000c1b0020009c00002d9a0000213d000000010040019000002d9a0000c13d000000400020043f00000000026304360000000004870019000000000040007c00002d980000213d000000000084004b00002a890000a13d000000020580036700000000060300190000002006600039000000005705043c00000000007604350000002008800039000000000048004b00002a820000413d0000000006030433000000000006004b00002aa40000613d0000000503600210001300000023001d0000000043020434001400000004001d000000000031004b000000000300003900000020030020390000000000130435000000200130015f00000000020204330000000000210435000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b0000001403000029000000130030006c000000000203001900002a8d0000413d000000090010006c00002e110000c13d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000002da60000613d0000000404000029000000800240027000000bb302200197000000000101043b000000000021004b00002db30000413d000000a00340027000000bb303300197000000000023004b00002abd0000a13d000000000031004b00002db70000213d000000e0064002700000000a0060006b00002aec0000813d001400000006001d0000000101000029000000000010043f0000009a01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b00000012020000290000000202200367000000000202043b000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d00000007020000290000000002020433000000000101043b000000000101041a000000000012001a0000000505000029000000140600002900002da00000413d00000000011200190000000a0010006c00002aef0000a13d00000c6201000041000000000010043f00000c2d0100004100002eca000104300000000701000029000000000201043300000005050000290000009f01000039000000000301041a000000a00130027000000bb301100197000000000016004b00002afc0000813d00000002040000290000000004040433000000000042001a00002da00000413d0000000004420019000000000064004b00002dd70000213d000000c00330027000000bb303300197000000000032004b00002dbb0000213d00000006030000290000000003030433000000000023001a00002da00000413d0000000002230019000000000012004b00002dbf0000213d00000c30025001970000000b01000029000000400110027000000c1005100198000000000400041000000000010004160000001003000029001400000002001d00002b200000613d00000c1001400197000000400c00043d0000002402c00039000000000012043500000c570100004100000000001c04350000000401c0003900000000003104350000000001000414000000040050008c00002b270000c13d0000000103000031000000200030008c0000002004000039000000000403401900002b560000013d000000000021004b000000000100041100002baa0000813d00000c6101000041000000000010043f00000c2d0100004100002eca0001043000000bb300c0009c00000bb30200004100000000020c4019000000400220021000000bb30010009c00000bb301008041000000c001100210000000000121019f00000c4e011001c7001200000005001d000000000205001900130000000c001d2ec82ec30000040f000000130c000029000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057c001900002b440000613d000000000801034f00000000090c0019000000008a08043c0000000009a90436000000000059004b00002b400000c13d000000000006004b00002b510000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f0003000000010355000000010020019000002ddb0000613d00000012050000290000001f01400039000000600110018f000000000bc1001900000000001b004b0000000002000039000000010200403900000c1b00b0009c00002d9a0000213d000000010020019000002d9a0000c13d0000004000b0043f000000200030008c00002d980000413d00000000020c0433000000140020006c00002dc30000413d00000c580200004100000000002b04350000000402b00039000000100400002900000000004204350000000002000414000000040050008c00002b9d0000613d00000bb300b0009c00000bb30100004100000000010b4019000000400110021000000bb30020009c00000bb302008041000000c002200210000000000112019f00000c47011001c7000000000205001900130000000b001d2ec82ec30000040f000000130b000029000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900002b8a0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00002b860000c13d000000000006004b00002b970000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f0003000000010355000000010020019000002de70000613d0000001f01400039000000600110018f0000000001b1001900000c1b0010009c00002d9a0000213d000000400010043f000000200030008c00002d980000413d00000000010b0433000000140010006c00002dc70000413d0000000001000416000000000001004b000000000100041100002dcb0000c13d00000c150010009c00002bb80000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000002da60000613d000000000101043b000000400400043d000000240240003900000c5103000041000000000032043500000c5202000041000000000024043500000c1002100197001200000002001d0000000401400039000000000021043500000bb30040009c001300000004001d00000bb30100004100000000010440190000004001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c4e011001c700000c53020000412ec82ec30000040f000000600310027000010bb30030019d00030000000103550000000100200190000000120200002900002c2b0000613d00000bb3023001970000001f0420018f00000c48052001980000001309000029000000000359001900002be10000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000037004b00002bdd0000c13d000000000004004b00002bee0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000001f0120003900000c54031001970000000001930019000000000031004b0000000003000039000000010300403900000c1b0010009c00002d9a0000213d000000010030019000002d9a0000c13d000000400010043f000000200020008c00002d980000413d000000000309043300000c1b0030009c00002d980000213d000000000492001900000000029300190000001f03200039000000000043004b000000000500001900000c4a0500804100000c4a0330019700000c4a06400197000000000763013f000000000063004b000000000300001900000c4a0300404100000c4a0070009c000000000305c019000000000003004b00002d980000c13d000000002502043400000c1b0050009c00002d9a0000213d00000005065002100000003f0360003900000c4b03300197000000000313001900000c1b0030009c00002d9a0000213d000000400030043f00000000035104360000000006260019000000000046004b00002d980000213d000000000062004b00002c260000813d0000000004030019000000002502043400000c100050009c00002d980000213d0000000004540436000000000062004b00002c1f0000413d0000000005010433000000000005004b000000120200002900002c2b0000613d000000000103043300000c10021001970000000e01000029000000000101041a000000e003100270000000c00410027000000bb304400197000000000034004b00002c530000813d000000000020043f0000009a01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b0000000302000029000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b000000000201041a0000000c0020002a00002da00000413d0000000c02200029000000000021041b0000000e01000029000000000101041a00000cc50010009c00002c680000213d0000000301000029000000000010043f0000009b01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b000000000201041a0000000c0020002a00002da00000413d0000000c02200029000000000021041b0000000d01000029000000000101041a000000400110027000000c1002100197000000110000006b001300000002001d00002cb80000613d0000009f01000039000000000101041a000000e0011002700000ffff0110018f00000014011000b9001000000001001d00000c300010009c00002da00000213d0000001101000029000000000010043f0000009d01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f0000000100200190000000130200002900002d980000613d000000000101043b000000000020043f000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000100200002900000c3002200197000027100420011a000000000101043b000000000201041a00000c3003200197000000000343001900000c300030009c00002da00000213d00000c5f02200197000000000223019f000000000021041b000000400100043d00000040021000390000000f0300002900000000003204350000002002100039001000000004001d00000000004204350000001302000029000000000021043500000bb30010009c00000bb3010080410000004001100210000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000cc6011001c70000800d02000039000000020300003900000cc70400004100000011050000292ec82ebe0000040f0000000100200190000000130200002900002cb90000c13d00002d980000013d001000000000001d000000000020043f0000009c01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d0000001003000029000000140230006900000c300020009c00002da00000213d000000000101043b000000000101041a00000c30011001970000000001210019001100000001001d00000c300010009c00002da00000213d0000001301000029000000000010043f0000009c01000039000000200010043f000000000100041400000bb30010009c00000bb301008041000000c00110021000000c26011001c700008010020000392ec82ec30000040f000000010020019000002d980000613d000000000101043b000000000201041a00000c5f0220019700000011022001af000000000021041b0000001302000029000000000002004b00002d4d0000613d000000000100041100000c150010009c000000140400002900002cf70000c13d00000c16010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000002da60000613d000000000101043b00000014040000290000001302000029000000400b00043d00000000030100190000004401b000390000000000410435000000000100041000000c10011001970000002404b00039000000000014043500000c5d0100004100000000001b043500000c10013001970000000403b0003900000000001304350000000001000414000000040020008c00002d0c0000c13d0000000103000031000000200030008c0000002004000039000000000403401900002d380000013d00000bb300b0009c00000bb30300004100000000030b4019000000400330021000000bb30010009c00000bb301008041000000c001100210000000000131019f00000c5e011001c700130000000b001d2ec82ebe0000040f000000130b000029000000600310027000000bb303300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900002d270000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00002d230000c13d000000000006004b00002d340000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f0003000000010355000000010020019000002df30000613d0000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000c1b0010009c00002d9a0000213d000000010020019000002d9a0000c13d000000400010043f000000200030008c00002d980000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b00002d980000c13d000000000001004b00002da70000613d0000000002000416000000140320006c00002d900000a13d00000000010004140000001204000029000000040040008c00002d590000c13d00000001020000390000000101000031000000000001004b00002d660000c13d00002d8e0000013d00000bb30010009c00000bb301008041000000c00110021000000c1d011001c7000080090200003900000000050000192ec82ebe0000040f0003000000010355000000600110027000010bb30010019d00000bb301100197000000000001004b00002d8e0000613d00000c1b0010009c00002d9a0000213d0000001f0410003900000cae044001970000003f0440003900000cae05400197000000400400043d0000000005540019000000000045004b0000000006000039000000010600403900000c1b0050009c00002d9a0000213d000000010060019000002d9a0000c13d000000400050043f000000000614043600000cae031001980000001f0410018f0000000001360019000000030500036700002d810000613d000000000705034f000000007807043c0000000006860436000000000016004b00002d7d0000c13d000000000004004b00002d8e0000613d000000000335034f0000000304400210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000010020019000002da70000613d000000000001042d0000000102000270000000000012001a00002da00000413d0000000004120019000000110000006b000027fc0000c13d000028060000013d000000000100001900002eca0001043000000c6401000041000000000010043f0000004101000039000000040010043f00000c470100004100002eca0001043000000c6401000041000000000010043f0000001101000039000000040010043f00000c470100004100002eca00010430000000000001042f00000c6001000041000000000010043f00000c2d0100004100002eca0001043000000ccb01000041000000000010043f00000c2d0100004100002eca0001043000000c6701000041000000000010043f00000c2d0100004100002eca0001043000000c6601000041000000000010043f00000c2d0100004100002eca0001043000000c6501000041000000000010043f00000c2d0100004100002eca0001043000000c6301000041000000000010043f00000c2d0100004100002eca0001043000000c7701000041000000000010043f00000c2d0100004100002eca0001043000000ca701000041000000000010043f00000c2d0100004100002eca0001043000000c5a01000041000000000010043f00000c2d0100004100002eca0001043000000c5901000041000000000010043f00000c2d0100004100002eca0001043000000cc901000041000000000010043f00000cca0100004100002eca0001043000000cc201000041000000000010043f00000c2d0100004100002eca0001043000000cc801000041000000000010043f00000c2d0100004100002eca000104300000001f0530018f00000c4806300198000000400200043d000000000462001900002dfe0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00002de20000c13d00002dfe0000013d0000001f0530018f00000c4806300198000000400200043d000000000462001900002dfe0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00002dee0000c13d00002dfe0000013d0000001f0530018f00000c4806300198000000400200043d000000000462001900002dfe0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00002dfa0000c13d000000000005004b00002e0b0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f0000000000140435000000600130021000000bb30020009c00000bb3020080410000004002200210000000000112019f00002eca0001043000000c4c01000041000000000010043f00000c2d0100004100002eca0001043000080000000000020000000006020019000000000901041a00000c30079001970000000102100039000000000202041a00000c30082001970000000201100039000000000101041a00000bb30110019800002e510000613d000000000008004b00002e700000613d000100000002001d000200000001001d000300000009001d000400000008001d000500000007001d000600000003001d000700000005001d000800000006001d00000c34010000410000000000100443000000000100041400000bb30010009c00000bb301008041000000c00110021000000c17011001c70000800b020000392ec82ec30000040f000000010020019000002ea70000613d0000000102000029000000800220027000000bb302200197000000000101043b000000000321004b000000080600002900000007050000290000000604000029000000050700002900000004080000290000000309000029000000020a00002900002ea10000413d0000000002a300d900000000018200a900000000003a004b00002e490000213d00000000022100d9000000000082004b00002ea10000c13d0000008002900270000000000327004b00002e770000a13d000000000031004b00002e7e0000213d000000000217004b00002e7e0000813d00002ea10000013d000000000008004b00002e700000613d00000000014800a900000000028100d9000000000042004b00002ea10000c13d000000000071001a00002ea10000413d000000000271001a00000000013200a900002e5f0000613d00000000022100d9000000000032004b00002ea10000c13d00000000023800a900000000048200d9000000000034004b00002ea10000c13d000000000003004b00002ea10000613d000000000002004b00002e9a0000613d000000010430008a00000000034200a900000000022300d9000000000042004b00002ea10000c13d0000000102300270000000000012001a00002ea10000413d00002e9d0000013d000000000007004b00002e850000613d00000000013700a900000000027100d9000000000032004b00002e8d0000613d00002ea10000013d00002e890000813d0000000003720049000000000031004b00002e800000213d000000000071001a00002ea10000413d0000000002710019000000000002004b00002e8c0000613d00000000014200a900000000022100d9000000000042004b00002e8d0000613d00002ea10000013d0000000001000019000000000005004b00002e8f0000c13d00002e990000013d0000000002070019000000000007004b00002e800000c13d0000000001000019000000000005004b00002e990000613d0000ffff0360018f00000000023100a9000000000001004b00002e960000613d00000000041200d9000000000034004b00002ea10000c13d000027100220011a000000000121004b00002ea10000413d000000000001042d0000000102000270000000000012001a00002ea10000413d0000000001120019000000000005004b00002e8f0000c13d00002e990000013d00000c6401000041000000000010043f0000001101000039000000040010043f00000c470100004100002eca00010430000000000001042f000000000001042f00000bb30010009c00000bb301008041000000400110021000000bb30020009c00000bb3020080410000006002200210000000000112019f000000000200041400000bb30020009c00000bb302008041000000c002200210000000000112019f00000c1d011001c700008010020000392ec82ec30000040f000000010020019000002ebc0000613d000000000101043b000000000001042d000000000100001900002eca0001043000002ec1002104210000000102000039000000000001042d0000000002000019000000000001042d00002ec6002104230000000102000039000000000001042d0000000002000019000000000001042d00002ec80000043200002ec90001042e00002eca00010430000000000000000000000000000000000000000000000000000000000000000000000000ffffffff000000020000000000000000000000000000004000000100000000000000000000000000000000000000000000000000000000000000000000000000715018a500000000000000000000000000000000000000000000000000000000b68836f900000000000000000000000000000000000000000000000000000000d404844000000000000000000000000000000000000000000000000000000000e985e9c400000000000000000000000000000000000000000000000000000000f2fde38a00000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000f588eb5000000000000000000000000000000000000000000000000000000000e985e9c500000000000000000000000000000000000000000000000000000000ead0055300000000000000000000000000000000000000000000000000000000db8f6ec300000000000000000000000000000000000000000000000000000000db8f6ec400000000000000000000000000000000000000000000000000000000de6cd0db00000000000000000000000000000000000000000000000000000000d404844100000000000000000000000000000000000000000000000000000000d88497a900000000000000000000000000000000000000000000000000000000c23dc68e00000000000000000000000000000000000000000000000000000000caf3e53100000000000000000000000000000000000000000000000000000000caf3e53200000000000000000000000000000000000000000000000000000000ce216e2f00000000000000000000000000000000000000000000000000000000c23dc68f00000000000000000000000000000000000000000000000000000000c87b56dd00000000000000000000000000000000000000000000000000000000bcc1ed0600000000000000000000000000000000000000000000000000000000bcc1ed0700000000000000000000000000000000000000000000000000000000bedcf00300000000000000000000000000000000000000000000000000000000b68836fa00000000000000000000000000000000000000000000000000000000b88d4fde000000000000000000000000000000000000000000000000000000009564e8e3000000000000000000000000000000000000000000000000000000009a7a973b00000000000000000000000000000000000000000000000000000000a3edb86900000000000000000000000000000000000000000000000000000000a3edb86a00000000000000000000000000000000000000000000000000000000a5aa4aa4000000000000000000000000000000000000000000000000000000009a7a973c00000000000000000000000000000000000000000000000000000000a22cb46500000000000000000000000000000000000000000000000000000000978a450800000000000000000000000000000000000000000000000000000000978a45090000000000000000000000000000000000000000000000000000000099a2557a000000000000000000000000000000000000000000000000000000009564e8e40000000000000000000000000000000000000000000000000000000095d89b41000000000000000000000000000000000000000000000000000000007c99e6b7000000000000000000000000000000000000000000000000000000008b4795d5000000000000000000000000000000000000000000000000000000008b4795d6000000000000000000000000000000000000000000000000000000008da5cb5b000000000000000000000000000000000000000000000000000000007c99e6b8000000000000000000000000000000000000000000000000000000008462151c00000000000000000000000000000000000000000000000000000000715018a60000000000000000000000000000000000000000000000000000000079502c55000000000000000000000000000000000000000000000000000000007c5d0a080000000000000000000000000000000000000000000000000000000034ac31580000000000000000000000000000000000000000000000000000000055f804b2000000000000000000000000000000000000000000000000000000006352211d000000000000000000000000000000000000000000000000000000006f33659e000000000000000000000000000000000000000000000000000000006f33659f0000000000000000000000000000000000000000000000000000000070a08231000000000000000000000000000000000000000000000000000000006352211e000000000000000000000000000000000000000000000000000000006e884900000000000000000000000000000000000000000000000000000000005ecb16cc000000000000000000000000000000000000000000000000000000005ecb16cd000000000000000000000000000000000000000000000000000000005fb8ecfb0000000000000000000000000000000000000000000000000000000055f804b3000000000000000000000000000000000000000000000000000000005bbb2177000000000000000000000000000000000000000000000000000000004331f638000000000000000000000000000000000000000000000000000000004bde38c7000000000000000000000000000000000000000000000000000000004bde38c80000000000000000000000000000000000000000000000000000000055a92158000000000000000000000000000000000000000000000000000000004331f639000000000000000000000000000000000000000000000000000000004a21a2df00000000000000000000000000000000000000000000000000000000400e3db800000000000000000000000000000000000000000000000000000000400e3db90000000000000000000000000000000000000000000000000000000042842e0e0000000000000000000000000000000000000000000000000000000034ac3159000000000000000000000000000000000000000000000000000000003ccfd60b0000000000000000000000000000000000000000000000000000000015ec671f000000000000000000000000000000000000000000000000000000002259e2880000000000000000000000000000000000000000000000000000000027a594360000000000000000000000000000000000000000000000000000000027a59437000000000000000000000000000000000000000000000000000000002a55205a000000000000000000000000000000000000000000000000000000002259e2890000000000000000000000000000000000000000000000000000000023b872dd000000000000000000000000000000000000000000000000000000001b60a22b000000000000000000000000000000000000000000000000000000001b60a22c0000000000000000000000000000000000000000000000000000000021d5bf240000000000000000000000000000000000000000000000000000000015ec67200000000000000000000000000000000000000000000000000000000018160ddd00000000000000000000000000000000000000000000000000000000081812fb000000000000000000000000000000000000000000000000000000000c6f910a000000000000000000000000000000000000000000000000000000000c6f910b000000000000000000000000000000000000000000000000000000001069143a00000000000000000000000000000000000000000000000000000000081812fc00000000000000000000000000000000000000000000000000000000095ea7b30000000000000000000000000000000000000000000000000000000001d88f5d0000000000000000000000000000000000000000000000000000000001ffc9a70000000000000000000000000000000000000000000000000000000006fdde03000000000000000000000000ffffffffffffffffffffffffffffffffffffffff08c379a0000000000000000000000000000000000000000000000000000000004f776e61626c653a206e6577206f776e657220697320746865207a65726f2061646472657373000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000840000008000000000000000000000000000000000000000005d4a8c47ae56c02bdb41d2e5d4957b7a0be9c619938b5f3299a1f3b18e458564efbb950733226014eece26fae19012d850b48d83020000020000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000ff000000ffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffff7f0200000000000000000000000000000000000000000000000000000000000000666f726576657200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffbf00000000000000000000000000000000000000000000000000000000ffff000000000000000000000000000000000000000000e0000000800000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffff00000000000000000000000000000000000000000000000000000000000100002569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c402569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c440200000000000000000000000000000000000040000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff3000000000000000000000000000000000000000000000000000000000000000cfe2a20ff701a1f3e14f63bd70d6c6bc6fba8172ec6d5a505cdab3927c0a9de6000000000000000000000000000000000000000000000000ffffffffffffffdfa14c4b50000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000008000000000000000000000000021d5695aeb71770b4b420e85352fe1a012fa06ae92de02f7ee513765e0afa02300000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000000000200000008000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0001000000000000000000000000000000000000000000000000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d9553913200000002000000000000000000000000000000000000000000000000000000002569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c450000000000000000000000000000000000000000000000010000000000000001ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef2e07630000000000000000000000000000000000000000000000000000000000b562e8dd00000000000000000000000000000000000000000000000000000000000000ff0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001600000008000000000000000002569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c47020000000000000000000000000000000000002000000000000000000000000017307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c312569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c43617167b76dcc8247761fd21f427ad8ec3be6b3be203aed34e3aac08b4d31817c0000000000000000000000000000000000000000000000000000000000ff00000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff32c1995a000000000000000000000000000000000000000000000000000000008f4eb604000000000000000000000000000000000000000000000000000000006352211e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffe059dc379f0000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0d838648f00000000000000000000000000000000000000000000000000000000e985e9c5000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044000000000000000000000000000000000000000000000000000000ff00000000000000000000000000000000210e34e800000000000000000000000000000000000000000000000000000000c10dcfe266c1f71ef476efbd3223555750dc271e4115626b0000000000000000e1030efb000000000000000000000000000000000000000000000000000000000000000000000000000000000000000078cc4cc1c14e27c0fa35ed6e5e58825d00000000000000000000000000000000000000000000000000000001ffffffe06275726e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff9fdd62ed3e0000000000000000000000000000000000000000000000000000000070a08231000000000000000000000000000000000000000000000000000000006c9089c0000000000000000000000000000000000000000000000000000000002355d738000000000000000000000000000000000000000000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b83020000020000000000000000000000000000002400000000000000000000000023b872dd000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064000000000000000000000000ffffffffffffffffffffffffffffffff0000000000000000000000000000000090b8ec1800000000000000000000000000000000000000000000000000000000f244866f0000000000000000000000000000000000000000000000000000000015fcbc9d000000000000000000000000000000000000000000000000000000007a7e96df000000000000000000000000000000000000000000000000000000004e487b710000000000000000000000000000000000000000000000000000000049084b94000000000000000000000000000000000000000000000000000000001d23a74200000000000000000000000000000000000000000000000000000000eb560756000000000000000000000000000000000000000000000000000000004f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657200000000000000000000000000000000000000640000008000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e000000000ffffffff000000000000000000000000000000000000000000000000ffffffff00000000ffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000000ffffff301d5df008fe5e0c1eb09c428f29394390457e8d1392a5afa3254c6d83f5621a301d5df008fe5e0c1eb09c428f29394390457e8d1392a5afa3254c6d83f56219ffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffff000000000000000000000000000000000000000000000000000000000100000000000000000000000000000016e3f90ad00b5cdf005fb9f7d855f4611d6b2b72ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00005ee88f97000000000000000000000000000000000000000000000000000000000000000000000000ffffffff0000000000000000000000000000000000000000ffffffffffffffff00000000ffffffffffffffffffffffffffffffffffffffff8a164f6300000000000000000000000000000000000000000000000000000000ee151c8401928dc223602bb187aff91b9a56c7cae5476ef1b3287b085a16c85f20697320616c726561647920696e697469616c697a6564000000000000000000455243373231415f5f496e697469616c697a61626c653a20636f6e747261637400000000000000000000000000000000000000840000000000000000000000002569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c426cc130753487db497f572e90c00c24779bdd7267955b3d1454e114d8fc4b414d933ecf8acb7824b680a8d16f3ff3db8864228d986aa4c2ebab1eeb2703b4beb36cc130753487db497f572e90c00c24779bdd7267955b3d1454e114d8fc4b414cffff0000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000ffff000000000000000000000000000000000000000000000000000000004852c10a00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffff000000000000ffff0000000000000000000000000000000000000000000000000000ffff00000000000000000000000000000000000000000000000000000000ffff000000000000ffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000ffffffff0000000000000000000000000000000000000000ffffffffffffffff00000000ffffffffffffffffffffffffffffffffffffffff0000000000000000455243323938313a20696e76616c6964207265636569766572000000000000002073616c65507269636500000000000000000000000000000000000000000000455243323938313a20726f79616c7479206665652077696c6c20657863656564206973206e6f7420696e697469616c697a696e670000000000000000000000000000000000000000000000000000000000000040000000000000000000000000ffffffffff000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000ffff0000000000000000000000000000000000000000000000000000ffffffff000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000007735bc1b1ae196347889ea96ee2c4004da1f6ca1b94ca238458f124baffbd85e00000000000000000000000000000000000001200000008000000000000000002569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c410000000000000000000000000000000000000080000000800000000000000000249fab5d0000000000000000000000000000000000000000000000000000000035be3ac800000000000000000000000000000000000000000000000000000000cfb3b942000000000000000000000000000000000000000000000000000000002569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c468c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925df2d9b4200000000000000000000000000000000000000000000000000000000cf4700e40000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000005b5e139f0000000000000000000000000000000000000000000000000000000080ac58cd000000000000000000000000000000000000000000000000000000002a55205a0000000000000000000000000000000000000000000000000000000030cd747100000000000000000000000000000000000000000000000000000000095ea7b300000000000000000000000000000000000000000000000000000000000000000000000000000000927a34917ab0ddfb37f05f56b302726d58f83a020b7d20d400000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000ffffff0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff00000000e9a0c17645ed78ccc9996259f00297ffc75e6b9d22cd605ccc9992cc8ca3f4c1ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff000000000000000000000000000000000000000000000000fffffffffffffea0000000000000000000000000000000000000000000000000ffffffffffffffc00000000000000000000000000000000000000000000000010000000000000000a11481000000000000000000000000000000000000000000000000000000000059c896be00000000000000000000000000000000000000000000000000000000ea553b3400000000000000000000000000000000000000000000000000000000650a61e100000000000000000000000000000000000000000000000000000000a9059cbb00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff80ff05280e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff5f02128911bc7070fd6c100b116c2dd9a3bb6bf132d5259a65ca8d0c86ccd78f498735c8fc00000000000000000000000000000000000000000000000000000000150b7a020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003ffffffe0d1a57ed6000000000000000000000000000000000000000000000000000000000000000019457468657265756d205369676e6564204d6573736167653a0a3332020000000000000000000000000000000000003c0000000400000000000000008baa579f00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff00000000000000000000000009550c7700000000000000000000000000000000000000000000000000000000fffffffeffffffffffffffffffffffffffffffffffffffffffffffffffffffff02000000000000000000000000000000000000600000000000000000000000008abfbe92bb62ff992ef6347c68d007f25a6e5aea2ad2f05e89f3486947cc0b2081fa239800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008baa579f00000000000000000000000000000000000000040000001c0000000000000000233067ae000000000000000000000000000000000000000000000000000000008b30bc66e197bb5cc2aee846a06f5926e67abd05f1f550a48e8d429fa69ec90c
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 30 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.