Source Code
Overview
ETH Balance
0 ETH
ETH Value
$0.00More Info
Private Name Tags
ContractCreator
TokenTracker
Cross-Chain Transactions
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 Name:
BUUMEE
Compiler Version
v0.8.28+commit.7893614a
ZkSolc Version
v1.5.11
Optimization Enabled:
Yes with Mode 3
Other Settings:
cancun EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;
import {ERC721A} from "erc721a/contracts/ERC721A.sol";
import {Ownable} from "@openzeppelin/contracts/access/Ownable.sol";
import {ERC2981} from "@openzeppelin/contracts/token/common/ERC2981.sol";
import {BitMaps} from "@openzeppelin/contracts/utils/structs/BitMaps.sol";
import {OperatorFilterer} from "closedsea/src/OperatorFilterer.sol";
import {MerkleProof} from "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
error MaxSupplyExceeded();
error PublicSaleClosed();
error TransfersLocked();
error NotAllowedByRegistry();
error RegistryNotSet();
error WrongWeiSent();
error MaxFeeExceeded();
error InputLengthsMismatch();
error InvalidMerkleProof();
error InvalidLaunchpadFee();
error InvalidLaunchpadFeeAddress();
error TransferFailed();
error PaymentTransferFailed();
error FeeTransferFailed();
error NotEnoughBalance();
error NotEnoughAllowance();
interface ICreatorToken {
event TransferValidatorUpdated(address oldValidator, address newValidator);
function getTransferValidator() external view returns (address validator);
function getTransferValidationFunction() external view
returns (bytes4 functionSignature, bool isViewFunction);
function setTransferValidator(address validator) external;
}
interface ITransferValidator {
function validateTransfer(address caller, address from, address to, uint256 tokenId) external view;
}
interface IRegistry {
function isAllowedOperator(address operator) external view returns (bool);
}
interface IERC20 {
function transfer(address recipient, uint256 amount) external returns (bool);
function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
function isApprovedForAll(address owner, address spender) external view returns (bool);
function approve(address spender, uint256 amount) external returns (bool);
function allowance(address owner, address spender) external view returns (uint256);
function balanceOf(address account) external view returns (uint256);
}
contract BUUMEE is Ownable, OperatorFilterer, ERC2981, ERC721A, ICreatorToken {
// Transfer validator for royalty enforcement
address private _transferValidator;
bytes4 private constant VALIDATE_TRANSFER_SELECTOR = 0xcaee23ea;
// Launchpad Fee
uint256 public launchpadFee = 264202188650931;
uint256 public launchpadCutBps = 500;
address public launchpadFeeAddress = 0xbDb9e0b47a02C45E3b50973A18452DC23CE72697;
event LaunchpadFeeSent(address indexed feeAddress, uint256 feeAmount);
event TokenPaymentSent(address indexed recipient, uint256 amount);
using BitMaps for BitMaps.BitMap;
address public currency = 0x0000000000000000000000000000000000000000;
uint256 public maxSupply = 6666;
bool public operatorFilteringEnabled = true;
bool public initialTransferLockOn = true;
bool public isRegistryActive;
address public registryAddress;
string private _baseTokenURI = "";
string private _placeHolderTokenURI = "https://mintify-launchpad.nyc3.cdn.digitaloceanspaces.com/ce0ba550-b090-49b2-8442-4b4e53444034.webp";
// Phase 1 variables
uint256 public startTimePhase1 = 1753977600;
uint256 public endTimePhase1 = 1753981200;
uint256 public maxSupplyPhase1 = 1666;
uint256 public totalSupplyPhase1;
uint256 public pricePhase1 = 0;
uint256 public maxPerWalletPhase1 = 1;
bytes32 public merkleRootPhase1 = 0xa3989683746723c11deebe37190a19d17c273f85514ab5c466eb22180191516c;
mapping(address => uint256) public walletMintsPhase1;
// Phase 2 variables
uint256 public startTimePhase2 = 1753981200;
uint256 public endTimePhase2 = 1753984800;
uint256 public maxSupplyPhase2 = 0;
uint256 public totalSupplyPhase2;
uint256 public pricePhase2 = 5000000000000000;
uint256 public maxPerWalletPhase2 = 2;
bytes32 public merkleRootPhase2 = 0xd7354fd5390baf5bc058d95fc5392d45e0b2677bdb1a330d48d94ead698bde73;
mapping(address => uint256) public walletMintsPhase2;
// Phase 3 variables
uint256 public startTimePhase3 = 1753984800;
uint256 public endTimePhase3 = 1754157600;
uint256 public maxSupplyPhase3 = 0;
uint256 public totalSupplyPhase3;
uint256 public pricePhase3 = 6666000000000000;
uint256 public maxPerWalletPhase3 = 3;
bytes32 public merkleRootPhase3 = 0x0;
mapping(address => uint256) public walletMintsPhase3;
constructor() ERC721A("BUUMEE", "BUUMEE") Ownable(msg.sender) {
// Register operator filtering
_registerForOperatorFiltering();
// Set initial royalty
_setDefaultRoyalty(0x70ECD15A0D733ed98380534F3Ed33558cf52969d, 500);
}
// Phase 1 Mint
function mintPhase1(bytes32[] calldata merkleProof, uint256 quantity) external payable {
// Check if mint has started
if (startTimePhase1 != 0 && block.timestamp < startTimePhase1) {
revert PublicSaleClosed();
}
// Check if mint has ended
if (endTimePhase1 != 0 && block.timestamp > endTimePhase1) {
revert PublicSaleClosed();
}
// Check if the mint will exceed total max supply, if set.
if (maxSupply != 0 && totalSupply() + quantity > maxSupply) {
revert MaxSupplyExceeded();
}
// If phase max supply is set, check if it's exceeded
if (maxSupplyPhase1 != 0 && totalSupplyPhase1 + quantity > maxSupplyPhase1) {
revert MaxSupplyExceeded();
}
uint256 totalOrderPrice = (pricePhase1 + launchpadFee) * quantity;
// Check if the price is correct if native currency
if (currency == address(0)) {
if (msg.value != totalOrderPrice) {
revert WrongWeiSent();
}
}
else {
// Check if the user has enough balance and allowance if ERC20
IERC20 token = IERC20(currency);
if (token.balanceOf(msg.sender) < totalOrderPrice) {
revert NotEnoughBalance();
}
if (token.allowance(msg.sender, address(this)) < totalOrderPrice) {
revert NotEnoughAllowance();
}
}
// Check if the proof is set, and if it is valid
if (merkleRootPhase1 != bytes32(0)) {
// Using Merkle Tree
bytes32 node = keccak256(abi.encodePacked(msg.sender));
if (!MerkleProof.verify(merkleProof, merkleRootPhase1, node)) {
revert InvalidMerkleProof();
}
}
// Check if we have exceeded phase max per wallet if set.
if (maxPerWalletPhase1 != 0 && walletMintsPhase1[msg.sender] + quantity > maxPerWalletPhase1) {
revert MaxSupplyExceeded();
}
uint256 flatFees = 0;
// Get the Launchpad Flat Fee if set
if (launchpadFee != 0 && launchpadFeeAddress != address(0)) {
flatFees = launchpadFee * quantity;
}
// Get the Launchpad Percentage Fee if set
uint256 percentageFees = 0;
if (launchpadCutBps != 0 && launchpadFeeAddress != address(0)) {
percentageFees = (launchpadCutBps * (totalOrderPrice - flatFees)) / 10000;
}
// Send the fees
uint256 totalFees = flatFees + percentageFees;
if (totalFees != 0) {
_sendLaunchpadFee(totalFees);
}
// Transfer the payment if ERC20
if (currency != address(0) && totalOrderPrice > totalFees) {
_sendTokenPayment(address(this), totalOrderPrice - totalFees);
}
// Mint the tokens
walletMintsPhase1[msg.sender] += quantity;
totalSupplyPhase1 += quantity;
_mint(msg.sender, quantity);
}
// Phase 2 Mint
function mintPhase2(bytes32[] calldata merkleProof, uint256 quantity) external payable {
// Check if mint has started
if (startTimePhase2 != 0 && block.timestamp < startTimePhase2) {
revert PublicSaleClosed();
}
// Check if mint has ended
if (endTimePhase2 != 0 && block.timestamp > endTimePhase2) {
revert PublicSaleClosed();
}
// Check if the mint will exceed total max supply, if set.
if (maxSupply != 0 && totalSupply() + quantity > maxSupply) {
revert MaxSupplyExceeded();
}
// If phase max supply is set, check if it's exceeded
if (maxSupplyPhase2 != 0 && totalSupplyPhase2 + quantity > maxSupplyPhase2) {
revert MaxSupplyExceeded();
}
uint256 totalOrderPrice = (pricePhase2 + launchpadFee) * quantity;
// Check if the price is correct if native currency
if (currency == address(0)) {
if (msg.value != totalOrderPrice) {
revert WrongWeiSent();
}
}
else {
// Check if the user has enough balance and allowance if ERC20
IERC20 token = IERC20(currency);
if (token.balanceOf(msg.sender) < totalOrderPrice) {
revert NotEnoughBalance();
}
if (token.allowance(msg.sender, address(this)) < totalOrderPrice) {
revert NotEnoughAllowance();
}
}
// Check if the proof is set, and if it is valid
if (merkleRootPhase2 != bytes32(0)) {
// Using Merkle Tree
bytes32 node = keccak256(abi.encodePacked(msg.sender));
if (!MerkleProof.verify(merkleProof, merkleRootPhase2, node)) {
revert InvalidMerkleProof();
}
}
// Check if we have exceeded phase max per wallet if set.
if (maxPerWalletPhase2 != 0 && walletMintsPhase2[msg.sender] + quantity > maxPerWalletPhase2) {
revert MaxSupplyExceeded();
}
uint256 flatFees = 0;
// Get the Launchpad Flat Fee if set
if (launchpadFee != 0 && launchpadFeeAddress != address(0)) {
flatFees = launchpadFee * quantity;
}
// Get the Launchpad Percentage Fee if set
uint256 percentageFees = 0;
if (launchpadCutBps != 0 && launchpadFeeAddress != address(0)) {
percentageFees = (launchpadCutBps * (totalOrderPrice - flatFees)) / 10000;
}
// Send the fees
uint256 totalFees = flatFees + percentageFees;
if (totalFees != 0) {
_sendLaunchpadFee(totalFees);
}
// Transfer the payment if ERC20
if (currency != address(0) && totalOrderPrice > totalFees) {
_sendTokenPayment(address(this), totalOrderPrice - totalFees);
}
// Mint the tokens
walletMintsPhase2[msg.sender] += quantity;
totalSupplyPhase2 += quantity;
_mint(msg.sender, quantity);
}
// Phase 3 Mint
function mintPhase3(uint256 quantity) external payable {
// Check if mint has started
if (startTimePhase3 != 0 && block.timestamp < startTimePhase3) {
revert PublicSaleClosed();
}
// Check if mint has ended
if (endTimePhase3 != 0 && block.timestamp > endTimePhase3) {
revert PublicSaleClosed();
}
// Check if the mint will exceed total max supply, if set.
if (maxSupply != 0 && totalSupply() + quantity > maxSupply) {
revert MaxSupplyExceeded();
}
// If phase max supply is set, check if it's exceeded
if (maxSupplyPhase3 != 0 && totalSupplyPhase3 + quantity > maxSupplyPhase3) {
revert MaxSupplyExceeded();
}
uint256 totalOrderPrice = (pricePhase3 + launchpadFee) * quantity;
// Check if the price is correct if native currency
if (currency == address(0)) {
if (msg.value != totalOrderPrice) {
revert WrongWeiSent();
}
}
else {
// Check if the user has enough balance and allowance if ERC20
IERC20 token = IERC20(currency);
if (token.balanceOf(msg.sender) < totalOrderPrice) {
revert NotEnoughBalance();
}
if (token.allowance(msg.sender, address(this)) < totalOrderPrice) {
revert NotEnoughAllowance();
}
}
// Check if we have exceeded phase max per wallet if set.
if (maxPerWalletPhase3 != 0 && walletMintsPhase3[msg.sender] + quantity > maxPerWalletPhase3) {
revert MaxSupplyExceeded();
}
uint256 flatFees = 0;
// Get the Launchpad Flat Fee if set
if (launchpadFee != 0 && launchpadFeeAddress != address(0)) {
flatFees = launchpadFee * quantity;
}
// Get the Launchpad Percentage Fee if set
uint256 percentageFees = 0;
if (launchpadCutBps != 0 && launchpadFeeAddress != address(0)) {
percentageFees = (launchpadCutBps * (totalOrderPrice - flatFees)) / 10000;
}
// Send the fees
uint256 totalFees = flatFees + percentageFees;
if (totalFees != 0) {
_sendLaunchpadFee(totalFees);
}
// Transfer the payment if ERC20
if (currency != address(0) && totalOrderPrice > totalFees) {
_sendTokenPayment(address(this), totalOrderPrice - totalFees);
}
// Mint the tokens
walletMintsPhase3[msg.sender] += quantity;
totalSupplyPhase3 += quantity;
_mint(msg.sender, quantity);
}
// =========================================================================
// Owner Only Functions
// =========================================================================
// Owner airdrop
function airDrop(address[] memory users, uint256[] memory amounts) external onlyOwner {
// iterate over users and amounts
if (users.length != amounts.length) {
revert InputLengthsMismatch();
}
for (uint256 i; i < users.length;) {
if (maxSupply != 0 && totalSupply() + amounts[i] > maxSupply) {
revert MaxSupplyExceeded();
}
_mint(users[i], amounts[i]);
unchecked {
++i;
}
}
}
// Owner unrestricted mint
function ownerMint(address to, uint256 quantity) external onlyOwner {
if (maxSupply != 0 && totalSupply() + quantity > maxSupply) {
revert MaxSupplyExceeded();
}
_mint(to, quantity);
}
// Set max supply
function setMaxSupply(uint256 newMaxSupply) external onlyOwner {
maxSupply = newMaxSupply;
}
// Withdraw Balance to owner
function withdraw() public onlyOwner {
(bool success, ) = payable(owner()).call{value: address(this).balance}("");
if (!success) {
revert TransferFailed();
}
}
// Withdraw Balance to Address
function withdrawTo(address payable _to) public onlyOwner {
(bool success, ) = payable(_to).call{value: address(this).balance}("");
if (!success) {
revert TransferFailed();
}
}
// Withdraw ERC20 to owner
function withdrawERC20(address tokenAddress) public onlyOwner {
IERC20 token = IERC20(tokenAddress);
uint256 balance = token.balanceOf(address(this));
if (balance == 0) {
revert TransferFailed();
}
bool success = token.transfer(owner(), balance);
if (!success) {
revert TransferFailed();
}
}
// Withdraw ERC20 to Address
function withdrawERC20To(address tokenAddress, address to) public onlyOwner {
IERC20 token = IERC20(tokenAddress);
uint256 balance = token.balanceOf(address(this));
if (balance == 0) {
revert TransferFailed();
}
bool success = token.transfer(to, balance);
if (!success) {
revert TransferFailed();
}
}
// Send Launchpad Flat Fee
function _sendLaunchpadFee(uint256 feeAmount) private {
if (feeAmount == 0) {
revert InvalidLaunchpadFee();
}
if (launchpadFeeAddress == address(0)) {
revert InvalidLaunchpadFeeAddress();
}
if (currency == address(0)) {
(bool success, ) = payable(launchpadFeeAddress).call{value: feeAmount}("");
if (!success) {
revert FeeTransferFailed();
}
}
else {
// Transfer the fee in the specified currency
IERC20 token = IERC20(currency);
try token.transferFrom(msg.sender, launchpadFeeAddress, feeAmount) {
// Success
} catch {
revert FeeTransferFailed();
}
}
emit LaunchpadFeeSent(launchpadFeeAddress, feeAmount);
}
// Send ERC20 Payment
function _sendTokenPayment(address recipient, uint256 amount) private {
if (amount == 0) {
revert PaymentTransferFailed();
}
if (recipient == address(0)) {
revert PaymentTransferFailed();
}
// Transfer the fee in the specified currency
IERC20 token = IERC20(currency);
try token.transferFrom(msg.sender, address(this), amount) {
// Success
} catch {
revert PaymentTransferFailed();
}
emit TokenPaymentSent(recipient, amount);
}
// Break Transfer Lock
function breakLock() external onlyOwner {
initialTransferLockOn = false;
}
// Set the start time for the phase
function setStartTimePhase1(uint256 newStartTime) external onlyOwner {
startTimePhase1 = newStartTime;
}
// Set the end time for the phase
function setEndTimePhase1(uint256 newEndTime) external onlyOwner {
endTimePhase1 = newEndTime;
}
// Set the max supply for the phase
function setMaxSupplyPhase1(uint256 newMaxSupply) external onlyOwner {
maxSupplyPhase1 = newMaxSupply;
}
// Set max per wallet for the phase
function setMaxPerWalletPhase1(uint256 newMaxPerWallet) external onlyOwner {
maxPerWalletPhase1 = newMaxPerWallet;
}
// Set the price for the phase
function setPricePhase1(uint256 newPrice) external onlyOwner {
pricePhase1 = newPrice;
}
// Set the merkle root for the phase
function setMerkleRootPhase1(bytes32 newMerkleRoot) external onlyOwner {
merkleRootPhase1 = newMerkleRoot;
}// Set the start time for the phase
function setStartTimePhase2(uint256 newStartTime) external onlyOwner {
startTimePhase2 = newStartTime;
}
// Set the end time for the phase
function setEndTimePhase2(uint256 newEndTime) external onlyOwner {
endTimePhase2 = newEndTime;
}
// Set the max supply for the phase
function setMaxSupplyPhase2(uint256 newMaxSupply) external onlyOwner {
maxSupplyPhase2 = newMaxSupply;
}
// Set max per wallet for the phase
function setMaxPerWalletPhase2(uint256 newMaxPerWallet) external onlyOwner {
maxPerWalletPhase2 = newMaxPerWallet;
}
// Set the price for the phase
function setPricePhase2(uint256 newPrice) external onlyOwner {
pricePhase2 = newPrice;
}
// Set the merkle root for the phase
function setMerkleRootPhase2(bytes32 newMerkleRoot) external onlyOwner {
merkleRootPhase2 = newMerkleRoot;
}// Set the start time for the phase
function setStartTimePhase3(uint256 newStartTime) external onlyOwner {
startTimePhase3 = newStartTime;
}
// Set the end time for the phase
function setEndTimePhase3(uint256 newEndTime) external onlyOwner {
endTimePhase3 = newEndTime;
}
// Set the max supply for the phase
function setMaxSupplyPhase3(uint256 newMaxSupply) external onlyOwner {
maxSupplyPhase3 = newMaxSupply;
}
// Set max per wallet for the phase
function setMaxPerWalletPhase3(uint256 newMaxPerWallet) external onlyOwner {
maxPerWalletPhase3 = newMaxPerWallet;
}
// Set the price for the phase
function setPricePhase3(uint256 newPrice) external onlyOwner {
pricePhase3 = newPrice;
}
// Set the merkle root for the phase
function setMerkleRootPhase3(bytes32 newMerkleRoot) external onlyOwner {
merkleRootPhase3 = newMerkleRoot;
}
// =========================================================================
// ERC721A Misc
// =========================================================================
function _startTokenId() internal pure override returns (uint256) {
return 1;
}
// =========================================================================
// ICreatorToken Implementation
// =========================================================================
function getTransferValidator() external view override returns (address validator) {
return _transferValidator;
}
function getTransferValidationFunction() external pure override
returns (bytes4 functionSignature, bool isViewFunction) {
return (VALIDATE_TRANSFER_SELECTOR, true);
}
function setTransferValidator(address validator) external override onlyOwner {
address oldValidator = _transferValidator;
_transferValidator = validator;
emit TransferValidatorUpdated(oldValidator, validator);
}
// =========================================================================
// Operator filtering
// =========================================================================
function setApprovalForAll(address operator, bool approved)
public
override (ERC721A)
onlyAllowedOperatorApproval(operator)
{
if (initialTransferLockOn) {
revert TransfersLocked();
}
super.setApprovalForAll(operator, approved);
}
function approve(address operator, uint256 tokenId)
public
payable
override (ERC721A)
onlyAllowedOperatorApproval(operator)
{
if (initialTransferLockOn) {
revert TransfersLocked();
}
super.approve(operator, tokenId);
}
function transferFrom(address from, address to, uint256 tokenId)
public
payable
override (ERC721A)
onlyAllowedOperator(from)
{
super.transferFrom(from, to, tokenId);
}
function safeTransferFrom(address from, address to, uint256 tokenId)
public
payable
override (ERC721A)
onlyAllowedOperator(from)
{
super.safeTransferFrom(from, to, tokenId);
}
function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data)
public
payable
override (ERC721A)
onlyAllowedOperator(from)
{
super.safeTransferFrom(from, to, tokenId, data);
}
function setOperatorFilteringEnabled(bool value) public onlyOwner {
operatorFilteringEnabled = value;
}
function _operatorFilteringEnabled() internal view override returns (bool) {
return operatorFilteringEnabled;
}
// =========================================================================
// Registry Check
// =========================================================================
function _beforeTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal override {
// Check transfer lock
if (initialTransferLockOn && from != address(0) && to != address(0)) {
revert TransfersLocked();
}
// Check your custom registry
if (!_isValidAgainstRegistry(msg.sender)) {
revert NotAllowedByRegistry();
}
// Add royalty enforcement validation (skip for minting)
if (from != address(0) && _transferValidator != address(0)) {
// For ERC721A batch transfers, validate each token
for (uint256 i = 0; i < quantity; i++) {
ITransferValidator(_transferValidator).validateTransfer(
msg.sender,
from,
to,
startTokenId + i
);
}
}
super._beforeTokenTransfers(from, to, startTokenId, quantity);
}
function _isValidAgainstRegistry(address operator)
internal
view
returns (bool)
{
if (isRegistryActive) {
IRegistry registry = IRegistry(registryAddress);
return registry.isAllowedOperator(operator);
}
return true;
}
function setIsRegistryActive(bool _isRegistryActive) external onlyOwner {
if (registryAddress == address(0)) revert RegistryNotSet();
isRegistryActive = _isRegistryActive;
}
function setRegistryAddress(address _registryAddress) external onlyOwner {
registryAddress = _registryAddress;
}
// =========================================================================
// ERC165
// =========================================================================
function supportsInterface(bytes4 interfaceId) public view override (ERC721A, ERC2981) returns (bool) {
return
interfaceId == type(ICreatorToken).interfaceId ||
ERC721A.supportsInterface(interfaceId) ||
ERC2981.supportsInterface(interfaceId);
}
// =========================================================================
// ERC2891
// =========================================================================
function setDefaultRoyalty(address receiver, uint96 feeNumerator) public onlyOwner {
if (feeNumerator > 1000) {
revert MaxFeeExceeded();
}
_setDefaultRoyalty(receiver, feeNumerator);
}
function setTokenRoyalty(
uint256 tokenId,
address receiver,
uint96 feeNumerator
) external onlyOwner {
if (feeNumerator > 1000) {
revert MaxFeeExceeded();
}
_setTokenRoyalty(tokenId, receiver, feeNumerator);
}
// =========================================================================
// Metadata
// =========================================================================
function setBaseURI(string calldata baseURI) external onlyOwner {
_baseTokenURI = baseURI;
}
function setPlaceholderBaseURI(string calldata placeholderURI) external onlyOwner {
_placeHolderTokenURI = placeholderURI;
}
function _baseURI() internal view override returns (string memory) {
return _baseTokenURI;
}
function _placeHolderURI() internal view returns (string memory) {
return _placeHolderTokenURI;
}
function tokenURI(uint256 tokenId) public view override returns (string memory) {
if (!_exists(tokenId)) revert URIQueryForNonexistentToken();
string memory baseURI = _baseURI();
string memory placeHolderURI = _placeHolderURI();
if (bytes(baseURI).length != 0) {
return string(abi.encodePacked(baseURI, "/", _toString(tokenId), ".json"));
}
if (bytes(placeHolderURI).length != 0) {
return placeHolderURI;
}
return "";
}
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
pragma solidity ^0.8.4;
import './IERC721A.sol';
/**
* @dev Interface of ERC721 token receiver.
*/
interface ERC721A__IERC721Receiver {
function onERC721Received(
address operator,
address from,
uint256 tokenId,
bytes calldata data
) external returns (bytes4);
}
/**
* @title ERC721A
*
* @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721)
* Non-Fungible Token Standard, including the Metadata extension.
* Optimized for lower gas during batch mints.
*
* Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...)
* starting from `_startTokenId()`.
*
* Assumptions:
*
* - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply.
* - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256).
*/
contract ERC721A is IERC721A {
// Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364).
struct TokenApprovalRef {
address value;
}
// =============================================================
// CONSTANTS
// =============================================================
// Mask of an entry in packed address data.
uint256 private constant _BITMASK_ADDRESS_DATA_ENTRY = (1 << 64) - 1;
// The bit position of `numberMinted` in packed address data.
uint256 private constant _BITPOS_NUMBER_MINTED = 64;
// The bit position of `numberBurned` in packed address data.
uint256 private constant _BITPOS_NUMBER_BURNED = 128;
// The bit position of `aux` in packed address data.
uint256 private constant _BITPOS_AUX = 192;
// Mask of all 256 bits in packed address data except the 64 bits for `aux`.
uint256 private constant _BITMASK_AUX_COMPLEMENT = (1 << 192) - 1;
// The bit position of `startTimestamp` in packed ownership.
uint256 private constant _BITPOS_START_TIMESTAMP = 160;
// The bit mask of the `burned` bit in packed ownership.
uint256 private constant _BITMASK_BURNED = 1 << 224;
// The bit position of the `nextInitialized` bit in packed ownership.
uint256 private constant _BITPOS_NEXT_INITIALIZED = 225;
// The bit mask of the `nextInitialized` bit in packed ownership.
uint256 private constant _BITMASK_NEXT_INITIALIZED = 1 << 225;
// The bit position of `extraData` in packed ownership.
uint256 private constant _BITPOS_EXTRA_DATA = 232;
// Mask of all 256 bits in a packed ownership except the 24 bits for `extraData`.
uint256 private constant _BITMASK_EXTRA_DATA_COMPLEMENT = (1 << 232) - 1;
// The mask of the lower 160 bits for addresses.
uint256 private constant _BITMASK_ADDRESS = (1 << 160) - 1;
// The maximum `quantity` that can be minted with {_mintERC2309}.
// This limit is to prevent overflows on the address data entries.
// For a limit of 5000, a total of 3.689e15 calls to {_mintERC2309}
// is required to cause an overflow, which is unrealistic.
uint256 private constant _MAX_MINT_ERC2309_QUANTITY_LIMIT = 5000;
// The `Transfer` event signature is given by:
// `keccak256(bytes("Transfer(address,address,uint256)"))`.
bytes32 private constant _TRANSFER_EVENT_SIGNATURE =
0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef;
// =============================================================
// STORAGE
// =============================================================
// The next token ID to be minted.
uint256 private _currentIndex;
// The number of tokens burned.
uint256 private _burnCounter;
// Token name
string private _name;
// Token symbol
string private _symbol;
// Mapping from token ID to ownership details
// An empty struct value does not necessarily mean the token is unowned.
// See {_packedOwnershipOf} implementation for details.
//
// Bits Layout:
// - [0..159] `addr`
// - [160..223] `startTimestamp`
// - [224] `burned`
// - [225] `nextInitialized`
// - [232..255] `extraData`
mapping(uint256 => uint256) private _packedOwnerships;
// Mapping owner address to address data.
//
// Bits Layout:
// - [0..63] `balance`
// - [64..127] `numberMinted`
// - [128..191] `numberBurned`
// - [192..255] `aux`
mapping(address => uint256) private _packedAddressData;
// Mapping from token ID to approved address.
mapping(uint256 => TokenApprovalRef) private _tokenApprovals;
// Mapping from owner to operator approvals
mapping(address => mapping(address => bool)) private _operatorApprovals;
// =============================================================
// CONSTRUCTOR
// =============================================================
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
_currentIndex = _startTokenId();
}
// =============================================================
// TOKEN COUNTING OPERATIONS
// =============================================================
/**
* @dev Returns the starting token ID.
* To change the starting token ID, please override this function.
*/
function _startTokenId() internal view virtual returns (uint256) {
return 0;
}
/**
* @dev Returns the next token ID to be minted.
*/
function _nextTokenId() internal view virtual returns (uint256) {
return _currentIndex;
}
/**
* @dev Returns the total number of tokens in existence.
* Burned tokens will reduce the count.
* To get the total number of tokens minted, please see {_totalMinted}.
*/
function totalSupply() public view virtual override returns (uint256) {
// Counter underflow is impossible as _burnCounter cannot be incremented
// more than `_currentIndex - _startTokenId()` times.
unchecked {
return _currentIndex - _burnCounter - _startTokenId();
}
}
/**
* @dev Returns the total amount of tokens minted in the contract.
*/
function _totalMinted() internal view virtual returns (uint256) {
// Counter underflow is impossible as `_currentIndex` does not decrement,
// and it is initialized to `_startTokenId()`.
unchecked {
return _currentIndex - _startTokenId();
}
}
/**
* @dev Returns the total number of tokens burned.
*/
function _totalBurned() internal view virtual returns (uint256) {
return _burnCounter;
}
// =============================================================
// ADDRESS DATA OPERATIONS
// =============================================================
/**
* @dev Returns the number of tokens in `owner`'s account.
*/
function balanceOf(address owner) public view virtual override returns (uint256) {
if (owner == address(0)) revert BalanceQueryForZeroAddress();
return _packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY;
}
/**
* Returns the number of tokens minted by `owner`.
*/
function _numberMinted(address owner) internal view returns (uint256) {
return (_packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY;
}
/**
* Returns the number of tokens burned by or on behalf of `owner`.
*/
function _numberBurned(address owner) internal view returns (uint256) {
return (_packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY;
}
/**
* Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
*/
function _getAux(address owner) internal view returns (uint64) {
return uint64(_packedAddressData[owner] >> _BITPOS_AUX);
}
/**
* Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
* If there are multiple variables, please pack them into a uint64.
*/
function _setAux(address owner, uint64 aux) internal virtual {
uint256 packed = _packedAddressData[owner];
uint256 auxCasted;
// Cast `aux` with assembly to avoid redundant masking.
assembly {
auxCasted := aux
}
packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX);
_packedAddressData[owner] = packed;
}
// =============================================================
// IERC165
// =============================================================
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
* to learn more about how these ids are created.
*
* This function call must use less than 30000 gas.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
// The interface IDs are constants representing the first 4 bytes
// of the XOR of all function selectors in the interface.
// See: [ERC165](https://eips.ethereum.org/EIPS/eip-165)
// (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`)
return
interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165.
interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721.
interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata.
}
// =============================================================
// IERC721Metadata
// =============================================================
/**
* @dev Returns the token collection name.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev Returns the token collection symbol.
*/
function symbol() public view virtual override returns (string memory) {
return _symbol;
}
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
if (!_exists(tokenId)) revert URIQueryForNonexistentToken();
string memory baseURI = _baseURI();
return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : '';
}
/**
* @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
* token will be the concatenation of the `baseURI` and the `tokenId`. Empty
* by default, it can be overridden in child contracts.
*/
function _baseURI() internal view virtual returns (string memory) {
return '';
}
// =============================================================
// OWNERSHIPS OPERATIONS
// =============================================================
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) public view virtual override returns (address) {
return address(uint160(_packedOwnershipOf(tokenId)));
}
/**
* @dev Gas spent here starts off proportional to the maximum mint batch size.
* It gradually moves to O(1) as tokens get transferred around over time.
*/
function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) {
return _unpackedOwnership(_packedOwnershipOf(tokenId));
}
/**
* @dev Returns the unpacked `TokenOwnership` struct at `index`.
*/
function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) {
return _unpackedOwnership(_packedOwnerships[index]);
}
/**
* @dev Initializes the ownership slot minted at `index` for efficiency purposes.
*/
function _initializeOwnershipAt(uint256 index) internal virtual {
if (_packedOwnerships[index] == 0) {
_packedOwnerships[index] = _packedOwnershipOf(index);
}
}
/**
* Returns the packed ownership data of `tokenId`.
*/
function _packedOwnershipOf(uint256 tokenId) private view returns (uint256 packed) {
if (_startTokenId() <= tokenId) {
packed = _packedOwnerships[tokenId];
// If not burned.
if (packed & _BITMASK_BURNED == 0) {
// If the data at the starting slot does not exist, start the scan.
if (packed == 0) {
if (tokenId >= _currentIndex) revert OwnerQueryForNonexistentToken();
// Invariant:
// There will always be an initialized ownership slot
// (i.e. `ownership.addr != address(0) && ownership.burned == false`)
// before an unintialized ownership slot
// (i.e. `ownership.addr == address(0) && ownership.burned == false`)
// Hence, `tokenId` will not underflow.
//
// We can directly compare the packed value.
// If the address is zero, packed will be zero.
for (;;) {
unchecked {
packed = _packedOwnerships[--tokenId];
}
if (packed == 0) continue;
return packed;
}
}
// Otherwise, the data exists and is not burned. 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.
return packed;
}
}
revert OwnerQueryForNonexistentToken();
}
/**
* @dev Returns the unpacked `TokenOwnership` struct from `packed`.
*/
function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) {
ownership.addr = address(uint160(packed));
ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP);
ownership.burned = packed & _BITMASK_BURNED != 0;
ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA);
}
/**
* @dev Packs ownership data into a single uint256.
*/
function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`.
result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags))
}
}
/**
* @dev Returns the `nextInitialized` flag set if `quantity` equals 1.
*/
function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) {
// For branchless setting of the `nextInitialized` flag.
assembly {
// `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`.
result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1))
}
}
// =============================================================
// APPROVAL OPERATIONS
// =============================================================
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account. 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();
return _tokenApprovals[tokenId].value;
}
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom}
* for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_operatorApprovals[_msgSenderERC721A()][operator] = approved;
emit ApprovalForAll(_msgSenderERC721A(), operator, approved);
}
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
return _operatorApprovals[owner][operator];
}
/**
* @dev Returns whether `tokenId` exists.
*
* Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
*
* Tokens start existing when they are minted. See {_mint}.
*/
function _exists(uint256 tokenId) internal view virtual returns (bool) {
return
_startTokenId() <= tokenId &&
tokenId < _currentIndex && // If within bounds,
_packedOwnerships[tokenId] & _BITMASK_BURNED == 0; // and not burned.
}
/**
* @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`.
*/
function _isSenderApprovedOrOwner(
address approvedAddress,
address owner,
address msgSender
) private pure returns (bool result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean.
msgSender := and(msgSender, _BITMASK_ADDRESS)
// `msgSender == owner || msgSender == approvedAddress`.
result := or(eq(msgSender, owner), eq(msgSender, approvedAddress))
}
}
/**
* @dev Returns the storage slot and value for the approved address of `tokenId`.
*/
function _getApprovedSlotAndAddress(uint256 tokenId)
private
view
returns (uint256 approvedAddressSlot, address approvedAddress)
{
TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId];
// The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`.
assembly {
approvedAddressSlot := tokenApproval.slot
approvedAddress := sload(approvedAddressSlot)
}
}
// =============================================================
// TRANSFER OPERATIONS
// =============================================================
/**
* @dev Transfers `tokenId` from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) public payable virtual override {
uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);
if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner();
(uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);
// The nested ifs save around 20+ gas over a compound boolean condition.
if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();
if (to == address(0)) revert TransferToZeroAddress();
_beforeTokenTransfers(from, to, tokenId, 1);
// Clear approvals from the previous owner.
assembly {
if approvedAddress {
// This is equivalent to `delete _tokenApprovals[tokenId]`.
sstore(approvedAddressSlot, 0)
}
}
// Underflow of the sender's balance is impossible because we check for
// ownership above and the recipient's balance can't realistically overflow.
// Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
unchecked {
// We can directly increment and decrement the balances.
--_packedAddressData[from]; // Updates: `balance -= 1`.
++_packedAddressData[to]; // Updates: `balance += 1`.
// Updates:
// - `address` to the next owner.
// - `startTimestamp` to the timestamp of transfering.
// - `burned` to `false`.
// - `nextInitialized` to `true`.
_packedOwnerships[tokenId] = _packOwnershipData(
to,
_BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked)
);
// If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
uint256 nextTokenId = tokenId + 1;
// If the next slot's address is zero and not burned (i.e. packed value is zero).
if (_packedOwnerships[nextTokenId] == 0) {
// If the next slot is within bounds.
if (nextTokenId != _currentIndex) {
// Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
_packedOwnerships[nextTokenId] = prevOwnershipPacked;
}
}
}
}
emit Transfer(from, to, tokenId);
_afterTokenTransfers(from, to, tokenId, 1);
}
/**
* @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) public 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();
}
}
/**
* @dev Hook that is called before a set of serially-ordered token IDs
* are about to be transferred. This includes minting.
* And also called before burning one token.
*
* `startTokenId` - the first token ID to be transferred.
* `quantity` - the amount to be transferred.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
* transferred to `to`.
* - When `from` is zero, `tokenId` will be minted for `to`.
* - When `to` is zero, `tokenId` will be burned by `from`.
* - `from` and `to` are never both zero.
*/
function _beforeTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual {}
/**
* @dev Hook that is called after a set of serially-ordered token IDs
* have been transferred. This includes minting.
* And also called after one token has been burned.
*
* `startTokenId` - the first token ID to be transferred.
* `quantity` - the amount to be transferred.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` has been
* transferred to `to`.
* - When `from` is zero, `tokenId` has been minted for `to`.
* - When `to` is zero, `tokenId` has been burned by `from`.
* - `from` and `to` are never both zero.
*/
function _afterTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual {}
/**
* @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract.
*
* `from` - Previous owner of the given token ID.
* `to` - Target address that will receive the token.
* `tokenId` - Token ID to be transferred.
* `_data` - Optional data to send along with the call.
*
* Returns whether the call correctly returned the expected magic value.
*/
function _checkContractOnERC721Received(
address from,
address to,
uint256 tokenId,
bytes memory _data
) private returns (bool) {
try ERC721A__IERC721Receiver(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns (
bytes4 retval
) {
return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector;
} catch (bytes memory reason) {
if (reason.length == 0) {
revert TransferToNonERC721ReceiverImplementer();
} else {
assembly {
revert(add(32, reason), mload(reason))
}
}
}
}
// =============================================================
// MINT OPERATIONS
// =============================================================
/**
* @dev Mints `quantity` tokens and transfers them to `to`.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `quantity` must be greater than 0.
*
* Emits a {Transfer} event for each mint.
*/
function _mint(address to, uint256 quantity) internal virtual {
uint256 startTokenId = _currentIndex;
if (quantity == 0) revert MintZeroQuantity();
_beforeTokenTransfers(address(0), to, startTokenId, quantity);
// Overflows are incredibly unrealistic.
// `balance` and `numberMinted` have a maximum limit of 2**64.
// `tokenId` has a maximum limit of 2**256.
unchecked {
// Updates:
// - `balance += quantity`.
// - `numberMinted += quantity`.
//
// We can directly add to the `balance` and `numberMinted`.
_packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);
// Updates:
// - `address` to the owner.
// - `startTimestamp` to the timestamp of minting.
// - `burned` to `false`.
// - `nextInitialized` to `quantity == 1`.
_packedOwnerships[startTokenId] = _packOwnershipData(
to,
_nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
);
uint256 toMasked;
uint256 end = startTokenId + quantity;
// Use assembly to loop and emit the `Transfer` event for gas savings.
// The duplicated `log4` removes an extra check and reduces stack juggling.
// The assembly, together with the surrounding Solidity code, have been
// delicately arranged to nudge the compiler into producing optimized opcodes.
assembly {
// Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
toMasked := and(to, _BITMASK_ADDRESS)
// Emit the `Transfer` event.
log4(
0, // Start of data (0, since no data).
0, // End of data (0, since no data).
_TRANSFER_EVENT_SIGNATURE, // Signature.
0, // `address(0)`.
toMasked, // `to`.
startTokenId // `tokenId`.
)
// The `iszero(eq(,))` check ensures that large values of `quantity`
// that overflows uint256 will make the loop run out of gas.
// The compiler will optimize the `iszero` away for performance.
for {
let tokenId := add(startTokenId, 1)
} iszero(eq(tokenId, end)) {
tokenId := add(tokenId, 1)
} {
// Emit the `Transfer` event. Similar to above.
log4(0, 0, _TRANSFER_EVENT_SIGNATURE, 0, toMasked, tokenId)
}
}
if (toMasked == 0) revert MintToZeroAddress();
_currentIndex = end;
}
_afterTokenTransfers(address(0), to, startTokenId, quantity);
}
/**
* @dev Mints `quantity` tokens and transfers them to `to`.
*
* This function is intended for efficient minting only during contract creation.
*
* It emits only one {ConsecutiveTransfer} as defined in
* [ERC2309](https://eips.ethereum.org/EIPS/eip-2309),
* instead of a sequence of {Transfer} event(s).
*
* Calling this function outside of contract creation WILL make your contract
* non-compliant with the ERC721 standard.
* For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309
* {ConsecutiveTransfer} event is only permissible during contract creation.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `quantity` must be greater than 0.
*
* Emits a {ConsecutiveTransfer} event.
*/
function _mintERC2309(address to, uint256 quantity) internal virtual {
uint256 startTokenId = _currentIndex;
if (to == address(0)) revert MintToZeroAddress();
if (quantity == 0) revert MintZeroQuantity();
if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) revert MintERC2309QuantityExceedsLimit();
_beforeTokenTransfers(address(0), to, startTokenId, quantity);
// Overflows are unrealistic due to the above check for `quantity` to be below the limit.
unchecked {
// Updates:
// - `balance += quantity`.
// - `numberMinted += quantity`.
//
// We can directly add to the `balance` and `numberMinted`.
_packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);
// Updates:
// - `address` to the owner.
// - `startTimestamp` to the timestamp of minting.
// - `burned` to `false`.
// - `nextInitialized` to `quantity == 1`.
_packedOwnerships[startTokenId] = _packOwnershipData(
to,
_nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
);
emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to);
_currentIndex = startTokenId + quantity;
}
_afterTokenTransfers(address(0), to, startTokenId, quantity);
}
/**
* @dev Safely mints `quantity` tokens and transfers them to `to`.
*
* Requirements:
*
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called for each safe transfer.
* - `quantity` must be greater than 0.
*
* See {_mint}.
*
* Emits a {Transfer} event for each mint.
*/
function _safeMint(
address to,
uint256 quantity,
bytes memory _data
) internal virtual {
_mint(to, quantity);
unchecked {
if (to.code.length != 0) {
uint256 end = _currentIndex;
uint256 index = end - quantity;
do {
if (!_checkContractOnERC721Received(address(0), to, index++, _data)) {
revert TransferToNonERC721ReceiverImplementer();
}
} while (index < end);
// Reentrancy protection.
if (_currentIndex != end) revert();
}
}
}
/**
* @dev Equivalent to `_safeMint(to, quantity, '')`.
*/
function _safeMint(address to, uint256 quantity) internal virtual {
_safeMint(to, quantity, '');
}
// =============================================================
// 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)
if (_msgSenderERC721A() != owner)
if (!isApprovedForAll(owner, _msgSenderERC721A())) {
revert ApprovalCallerNotOwnerNorApproved();
}
_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();
}
_beforeTokenTransfers(from, address(0), tokenId, 1);
// Clear approvals from the previous owner.
assembly {
if approvedAddress {
// This is equivalent to `delete _tokenApprovals[tokenId]`.
sstore(approvedAddressSlot, 0)
}
}
// Underflow of the sender's balance is impossible because we check for
// ownership above and the recipient's balance can't realistically overflow.
// Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
unchecked {
// Updates:
// - `balance -= 1`.
// - `numberBurned += 1`.
//
// We can directly decrement the balance, and increment the number burned.
// This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`.
_packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1;
// Updates:
// - `address` to the last owner.
// - `startTimestamp` to the timestamp of burning.
// - `burned` to `true`.
// - `nextInitialized` to `true`.
_packedOwnerships[tokenId] = _packOwnershipData(
from,
(_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked)
);
// If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
uint256 nextTokenId = tokenId + 1;
// If the next slot's address is zero and not burned (i.e. packed value is zero).
if (_packedOwnerships[nextTokenId] == 0) {
// If the next slot is within bounds.
if (nextTokenId != _currentIndex) {
// Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
_packedOwnerships[nextTokenId] = prevOwnershipPacked;
}
}
}
}
emit Transfer(from, address(0), tokenId);
_afterTokenTransfers(from, address(0), tokenId, 1);
// Overflow not possible, as _burnCounter cannot be exceed _currentIndex times.
unchecked {
_burnCounter++;
}
}
// =============================================================
// EXTRA DATA OPERATIONS
// =============================================================
/**
* @dev Directly sets the extra data for the ownership data `index`.
*/
function _setExtraDataAt(uint256 index, uint24 extraData) internal virtual {
uint256 packed = _packedOwnerships[index];
if (packed == 0) revert OwnershipNotInitializedForExtraData();
uint256 extraDataCasted;
// Cast `extraData` with assembly to avoid redundant masking.
assembly {
extraDataCasted := extraData
}
packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA);
_packedOwnerships[index] = packed;
}
/**
* @dev Called during each token transfer to set the 24bit `extraData` field.
* Intended to be overridden by the cosumer contract.
*
* `previousExtraData` - the value of `extraData` before transfer.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
* transferred to `to`.
* - When `from` is zero, `tokenId` will be minted for `to`.
* - When `to` is zero, `tokenId` will be burned by `from`.
* - `from` and `to` are never both zero.
*/
function _extraData(
address from,
address to,
uint24 previousExtraData
) internal view virtual returns (uint24) {}
/**
* @dev Returns the next extra data for the packed ownership data.
* The returned result is shifted into position.
*/
function _nextExtraData(
address from,
address to,
uint256 prevOwnershipPacked
) private view returns (uint256) {
uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA);
return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA;
}
// =============================================================
// OTHER OPERATIONS
// =============================================================
/**
* @dev Returns the message sender (defaults to `msg.sender`).
*
* If you are writing GSN compatible contracts, you need to override this function.
*/
function _msgSenderERC721A() internal view virtual returns (address) {
return msg.sender;
}
/**
* @dev Converts a uint256 to its ASCII string decimal representation.
*/
function _toString(uint256 value) internal pure virtual returns (string memory str) {
assembly {
// The maximum value of a uint256 contains 78 digits (1 byte per digit), but
// we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned.
// We will need 1 word for the trailing zeros padding, 1 word for the length,
// and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0.
let m := add(mload(0x40), 0xa0)
// Update the free memory pointer to allocate.
mstore(0x40, m)
// Assign the `str` to the end.
str := sub(m, 0x20)
// Zeroize the slot after the string.
mstore(str, 0)
// Cache the end of the memory to calculate the length later.
let end := str
// We write the string from rightmost digit to leftmost digit.
// The following is essentially a do-while loop that also handles the zero case.
// prettier-ignore
for { let temp := value } 1 {} {
str := sub(str, 1)
// Write the character to the pointer.
// The ASCII index of the '0' character is 48.
mstore8(str, add(48, mod(temp, 10)))
// Keep dividing `temp` until zero.
temp := div(temp, 10)
// prettier-ignore
if iszero(temp) { break }
}
let length := sub(end, str)
// Move the pointer 32 bytes leftwards to make room for the length.
str := sub(str, 0x20)
// Store the length.
mstore(str, length)
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)
pragma solidity ^0.8.20;
import {Context} from "../utils/Context.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* The initial owner is set to the address provided by the deployer. This can
* later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract Ownable is Context {
address private _owner;
/**
* @dev The caller account is not authorized to perform an operation.
*/
error OwnableUnauthorizedAccount(address account);
/**
* @dev The owner is not a valid owner account. (eg. `address(0)`)
*/
error OwnableInvalidOwner(address owner);
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the address provided by the deployer as the initial owner.
*/
constructor(address initialOwner) {
if (initialOwner == address(0)) {
revert OwnableInvalidOwner(address(0));
}
_transferOwnership(initialOwner);
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
if (owner() != _msgSender()) {
revert OwnableUnauthorizedAccount(_msgSender());
}
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby disabling any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
if (newOwner == address(0)) {
revert OwnableInvalidOwner(address(0));
}
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (token/common/ERC2981.sol)
pragma solidity ^0.8.20;
import {IERC2981} from "../../interfaces/IERC2981.sol";
import {IERC165, ERC165} from "../../utils/introspection/ERC165.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 ERC. Marketplaces are expected to
* voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
*/
abstract contract ERC2981 is IERC2981, ERC165 {
struct RoyaltyInfo {
address receiver;
uint96 royaltyFraction;
}
RoyaltyInfo private _defaultRoyaltyInfo;
mapping(uint256 tokenId => RoyaltyInfo) private _tokenRoyaltyInfo;
/**
* @dev The default royalty set is invalid (eg. (numerator / denominator) >= 1).
*/
error ERC2981InvalidDefaultRoyalty(uint256 numerator, uint256 denominator);
/**
* @dev The default royalty receiver is invalid.
*/
error ERC2981InvalidDefaultRoyaltyReceiver(address receiver);
/**
* @dev The royalty set for a specific `tokenId` is invalid (eg. (numerator / denominator) >= 1).
*/
error ERC2981InvalidTokenRoyalty(uint256 tokenId, uint256 numerator, uint256 denominator);
/**
* @dev The royalty receiver for `tokenId` is invalid.
*/
error ERC2981InvalidTokenRoyaltyReceiver(uint256 tokenId, address receiver);
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {
return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @inheritdoc IERC2981
*/
function royaltyInfo(
uint256 tokenId,
uint256 salePrice
) public view virtual returns (address receiver, uint256 amount) {
RoyaltyInfo storage _royaltyInfo = _tokenRoyaltyInfo[tokenId];
address royaltyReceiver = _royaltyInfo.receiver;
uint96 royaltyFraction = _royaltyInfo.royaltyFraction;
if (royaltyReceiver == address(0)) {
royaltyReceiver = _defaultRoyaltyInfo.receiver;
royaltyFraction = _defaultRoyaltyInfo.royaltyFraction;
}
uint256 royaltyAmount = (salePrice * royaltyFraction) / _feeDenominator();
return (royaltyReceiver, royaltyAmount);
}
/**
* @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a
* fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an
* override.
*/
function _feeDenominator() internal pure virtual returns (uint96) {
return 10000;
}
/**
* @dev Sets the royalty information that all ids in this contract will default to.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
uint256 denominator = _feeDenominator();
if (feeNumerator > denominator) {
// Royalty fee will exceed the sale price
revert ERC2981InvalidDefaultRoyalty(feeNumerator, denominator);
}
if (receiver == address(0)) {
revert ERC2981InvalidDefaultRoyaltyReceiver(address(0));
}
_defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Removes default royalty information.
*/
function _deleteDefaultRoyalty() internal virtual {
delete _defaultRoyaltyInfo;
}
/**
* @dev Sets the royalty information for a specific token id, overriding the global default.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual {
uint256 denominator = _feeDenominator();
if (feeNumerator > denominator) {
// Royalty fee will exceed the sale price
revert ERC2981InvalidTokenRoyalty(tokenId, feeNumerator, denominator);
}
if (receiver == address(0)) {
revert ERC2981InvalidTokenRoyaltyReceiver(tokenId, address(0));
}
_tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Resets royalty information for the token id back to the global default.
*/
function _resetTokenRoyalty(uint256 tokenId) internal virtual {
delete _tokenRoyaltyInfo[tokenId];
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/structs/BitMaps.sol)
pragma solidity ^0.8.20;
/**
* @dev Library for managing uint256 to bool mapping in a compact and efficient way, provided the keys are sequential.
* Largely inspired by Uniswap's https://github.com/Uniswap/merkle-distributor/blob/master/contracts/MerkleDistributor.sol[merkle-distributor].
*
* BitMaps pack 256 booleans across each bit of a single 256-bit slot of `uint256` type.
* Hence booleans corresponding to 256 _sequential_ indices would only consume a single slot,
* unlike the regular `bool` which would consume an entire slot for a single value.
*
* This results in gas savings in two ways:
*
* - Setting a zero value to non-zero only once every 256 times
* - Accessing the same warm slot for every 256 _sequential_ indices
*/
library BitMaps {
struct BitMap {
mapping(uint256 bucket => uint256) _data;
}
/**
* @dev Returns whether the bit at `index` is set.
*/
function get(BitMap storage bitmap, uint256 index) internal view returns (bool) {
uint256 bucket = index >> 8;
uint256 mask = 1 << (index & 0xff);
return bitmap._data[bucket] & mask != 0;
}
/**
* @dev Sets the bit at `index` to the boolean `value`.
*/
function setTo(BitMap storage bitmap, uint256 index, bool value) internal {
if (value) {
set(bitmap, index);
} else {
unset(bitmap, index);
}
}
/**
* @dev Sets the bit at `index`.
*/
function set(BitMap storage bitmap, uint256 index) internal {
uint256 bucket = index >> 8;
uint256 mask = 1 << (index & 0xff);
bitmap._data[bucket] |= mask;
}
/**
* @dev Unsets the bit at `index`.
*/
function unset(BitMap storage bitmap, uint256 index) internal {
uint256 bucket = index >> 8;
uint256 mask = 1 << (index & 0xff);
bitmap._data[bucket] &= ~mask;
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
/// @notice Optimized and flexible operator filterer to abide to OpenSea's
/// mandatory on-chain royalty enforcement in order for new collections to
/// receive royalties.
/// For more information, see:
/// See: https://github.com/ProjectOpenSea/operator-filter-registry
abstract contract OperatorFilterer {
/// @dev The default OpenSea operator blocklist subscription.
address internal constant _DEFAULT_SUBSCRIPTION = 0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6;
/// @dev The OpenSea operator filter registry.
address internal constant _OPERATOR_FILTER_REGISTRY = 0x000000000000AAeB6D7670E522A718067333cd4E;
/// @dev Registers the current contract to OpenSea's operator filter,
/// and subscribe to the default OpenSea operator blocklist.
/// Note: Will not revert nor update existing settings for repeated registration.
function _registerForOperatorFiltering() internal virtual {
_registerForOperatorFiltering(_DEFAULT_SUBSCRIPTION, true);
}
/// @dev Registers the current contract to OpenSea's operator filter.
/// Note: Will not revert nor update existing settings for repeated registration.
function _registerForOperatorFiltering(address subscriptionOrRegistrantToCopy, bool subscribe)
internal
virtual
{
/// @solidity memory-safe-assembly
assembly {
let functionSelector := 0x7d3e3dbe // `registerAndSubscribe(address,address)`.
// Clean the upper 96 bits of `subscriptionOrRegistrantToCopy` in case they are dirty.
subscriptionOrRegistrantToCopy := shr(96, shl(96, subscriptionOrRegistrantToCopy))
for {} iszero(subscribe) {} {
if iszero(subscriptionOrRegistrantToCopy) {
functionSelector := 0x4420e486 // `register(address)`.
break
}
functionSelector := 0xa0af2903 // `registerAndCopyEntries(address,address)`.
break
}
// Store the function selector.
mstore(0x00, shl(224, functionSelector))
// Store the `address(this)`.
mstore(0x04, address())
// Store the `subscriptionOrRegistrantToCopy`.
mstore(0x24, subscriptionOrRegistrantToCopy)
// Register into the registry.
if iszero(call(gas(), _OPERATOR_FILTER_REGISTRY, 0, 0x00, 0x44, 0x00, 0x04)) {
// If the function selector has not been overwritten,
// it is an out-of-gas error.
if eq(shr(224, mload(0x00)), functionSelector) {
// To prevent gas under-estimation.
revert(0, 0)
}
}
// Restore the part of the free memory pointer that was overwritten,
// which is guaranteed to be zero, because of Solidity's memory size limits.
mstore(0x24, 0)
}
}
/// @dev Modifier to guard a function and revert if the caller is a blocked operator.
modifier onlyAllowedOperator(address from) virtual {
if (from != msg.sender) {
if (!_isPriorityOperator(msg.sender)) {
if (_operatorFilteringEnabled()) _revertIfBlocked(msg.sender);
}
}
_;
}
/// @dev Modifier to guard a function from approving a blocked operator..
modifier onlyAllowedOperatorApproval(address operator) virtual {
if (!_isPriorityOperator(operator)) {
if (_operatorFilteringEnabled()) _revertIfBlocked(operator);
}
_;
}
/// @dev Helper function that reverts if the `operator` is blocked by the registry.
function _revertIfBlocked(address operator) private view {
/// @solidity memory-safe-assembly
assembly {
// Store the function selector of `isOperatorAllowed(address,address)`,
// shifted left by 6 bytes, which is enough for 8tb of memory.
// We waste 6-3 = 3 bytes to save on 6 runtime gas (PUSH1 0x224 SHL).
mstore(0x00, 0xc6171134001122334455)
// Store the `address(this)`.
mstore(0x1a, address())
// Store the `operator`.
mstore(0x3a, operator)
// `isOperatorAllowed` always returns true if it does not revert.
if iszero(staticcall(gas(), _OPERATOR_FILTER_REGISTRY, 0x16, 0x44, 0x00, 0x00)) {
// Bubble up the revert if the staticcall reverts.
returndatacopy(0x00, 0x00, returndatasize())
revert(0x00, returndatasize())
}
// We'll skip checking if `from` is inside the blacklist.
// Even though that can block transferring out of wrapper contracts,
// we don't want tokens to be stuck.
// Restore the part of the free memory pointer that was overwritten,
// which is guaranteed to be zero, if less than 8tb of memory is used.
mstore(0x3a, 0)
}
}
/// @dev For deriving contracts to override, so that operator filtering
/// can be turned on / off.
/// Returns true by default.
function _operatorFilteringEnabled() internal view virtual returns (bool) {
return true;
}
/// @dev For deriving contracts to override, so that preferred marketplaces can
/// skip operator filtering, helping users save gas.
/// Returns false for all inputs by default.
function _isPriorityOperator(address) internal view virtual returns (bool) {
return false;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/MerkleProof.sol)
// This file was procedurally generated from scripts/generate/templates/MerkleProof.js.
pragma solidity ^0.8.20;
import {Hashes} from "./Hashes.sol";
/**
* @dev These functions deal with verification of Merkle Tree proofs.
*
* The tree and the proofs can be generated using our
* https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
* You will find a quickstart guide in the readme.
*
* WARNING: You should avoid using leaf values that are 64 bytes long prior to
* hashing, or use a hash function other than keccak256 for hashing leaves.
* This is because the concatenation of a sorted pair of internal nodes in
* the Merkle tree could be reinterpreted as a leaf value.
* OpenZeppelin's JavaScript library generates Merkle trees that are safe
* against this attack out of the box.
*
* IMPORTANT: Consider memory side-effects when using custom hashing functions
* that access memory in an unsafe way.
*
* NOTE: This library supports proof verification for merkle trees built using
* custom _commutative_ hashing functions (i.e. `H(a, b) == H(b, a)`). Proving
* leaf inclusion in trees built using non-commutative hashing functions requires
* additional logic that is not supported by this library.
*/
library MerkleProof {
/**
*@dev The multiproof provided is not valid.
*/
error MerkleProofInvalidMultiproof();
/**
* @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
* defined by `root`. For this, a `proof` must be provided, containing
* sibling hashes on the branch from the leaf to the root of the tree. Each
* pair of leaves and each pair of pre-images are assumed to be sorted.
*
* This version handles proofs in memory with the default hashing function.
*/
function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
return processProof(proof, leaf) == root;
}
/**
* @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
* from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
* hash matches the root of the tree. When processing the proof, the pairs
* of leaves & pre-images are assumed to be sorted.
*
* This version handles proofs in memory with the default hashing function.
*/
function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {
bytes32 computedHash = leaf;
for (uint256 i = 0; i < proof.length; i++) {
computedHash = Hashes.commutativeKeccak256(computedHash, proof[i]);
}
return computedHash;
}
/**
* @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
* defined by `root`. For this, a `proof` must be provided, containing
* sibling hashes on the branch from the leaf to the root of the tree. Each
* pair of leaves and each pair of pre-images are assumed to be sorted.
*
* This version handles proofs in memory with a custom hashing function.
*/
function verify(
bytes32[] memory proof,
bytes32 root,
bytes32 leaf,
function(bytes32, bytes32) view returns (bytes32) hasher
) internal view returns (bool) {
return processProof(proof, leaf, hasher) == root;
}
/**
* @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
* from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
* hash matches the root of the tree. When processing the proof, the pairs
* of leaves & pre-images are assumed to be sorted.
*
* This version handles proofs in memory with a custom hashing function.
*/
function processProof(
bytes32[] memory proof,
bytes32 leaf,
function(bytes32, bytes32) view returns (bytes32) hasher
) internal view returns (bytes32) {
bytes32 computedHash = leaf;
for (uint256 i = 0; i < proof.length; i++) {
computedHash = hasher(computedHash, proof[i]);
}
return computedHash;
}
/**
* @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
* defined by `root`. For this, a `proof` must be provided, containing
* sibling hashes on the branch from the leaf to the root of the tree. Each
* pair of leaves and each pair of pre-images are assumed to be sorted.
*
* This version handles proofs in calldata with the default hashing function.
*/
function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf) internal pure returns (bool) {
return processProofCalldata(proof, leaf) == root;
}
/**
* @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
* from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
* hash matches the root of the tree. When processing the proof, the pairs
* of leaves & pre-images are assumed to be sorted.
*
* This version handles proofs in calldata with the default hashing function.
*/
function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {
bytes32 computedHash = leaf;
for (uint256 i = 0; i < proof.length; i++) {
computedHash = Hashes.commutativeKeccak256(computedHash, proof[i]);
}
return computedHash;
}
/**
* @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
* defined by `root`. For this, a `proof` must be provided, containing
* sibling hashes on the branch from the leaf to the root of the tree. Each
* pair of leaves and each pair of pre-images are assumed to be sorted.
*
* This version handles proofs in calldata with a custom hashing function.
*/
function verifyCalldata(
bytes32[] calldata proof,
bytes32 root,
bytes32 leaf,
function(bytes32, bytes32) view returns (bytes32) hasher
) internal view returns (bool) {
return processProofCalldata(proof, leaf, hasher) == root;
}
/**
* @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
* from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
* hash matches the root of the tree. When processing the proof, the pairs
* of leaves & pre-images are assumed to be sorted.
*
* This version handles proofs in calldata with a custom hashing function.
*/
function processProofCalldata(
bytes32[] calldata proof,
bytes32 leaf,
function(bytes32, bytes32) view returns (bytes32) hasher
) internal view returns (bytes32) {
bytes32 computedHash = leaf;
for (uint256 i = 0; i < proof.length; i++) {
computedHash = hasher(computedHash, proof[i]);
}
return computedHash;
}
/**
* @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
* `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
*
* This version handles multiproofs in memory with the default hashing function.
*
* CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
*
* NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`.
* The `leaves` must be validated independently. See {processMultiProof}.
*/
function multiProofVerify(
bytes32[] memory proof,
bool[] memory proofFlags,
bytes32 root,
bytes32[] memory leaves
) internal pure returns (bool) {
return processMultiProof(proof, proofFlags, leaves) == root;
}
/**
* @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
* proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
* leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
* respectively.
*
* This version handles multiproofs in memory with the default hashing function.
*
* CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
* is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
* tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
*
* NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op,
* and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not
* validating the leaves elsewhere.
*/
function processMultiProof(
bytes32[] memory proof,
bool[] memory proofFlags,
bytes32[] memory leaves
) internal pure returns (bytes32 merkleRoot) {
// This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
// consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
// `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
// the Merkle tree.
uint256 leavesLen = leaves.length;
uint256 proofFlagsLen = proofFlags.length;
// Check proof validity.
if (leavesLen + proof.length != proofFlagsLen + 1) {
revert MerkleProofInvalidMultiproof();
}
// The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
// `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
bytes32[] memory hashes = new bytes32[](proofFlagsLen);
uint256 leafPos = 0;
uint256 hashPos = 0;
uint256 proofPos = 0;
// At each step, we compute the next hash using two values:
// - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
// get the next hash.
// - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
// `proof` array.
for (uint256 i = 0; i < proofFlagsLen; i++) {
bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
bytes32 b = proofFlags[i]
? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
: proof[proofPos++];
hashes[i] = Hashes.commutativeKeccak256(a, b);
}
if (proofFlagsLen > 0) {
if (proofPos != proof.length) {
revert MerkleProofInvalidMultiproof();
}
unchecked {
return hashes[proofFlagsLen - 1];
}
} else if (leavesLen > 0) {
return leaves[0];
} else {
return proof[0];
}
}
/**
* @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
* `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
*
* This version handles multiproofs in memory with a custom hashing function.
*
* CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
*
* NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`.
* The `leaves` must be validated independently. See {processMultiProof}.
*/
function multiProofVerify(
bytes32[] memory proof,
bool[] memory proofFlags,
bytes32 root,
bytes32[] memory leaves,
function(bytes32, bytes32) view returns (bytes32) hasher
) internal view returns (bool) {
return processMultiProof(proof, proofFlags, leaves, hasher) == root;
}
/**
* @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
* proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
* leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
* respectively.
*
* This version handles multiproofs in memory with a custom hashing function.
*
* CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
* is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
* tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
*
* NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op,
* and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not
* validating the leaves elsewhere.
*/
function processMultiProof(
bytes32[] memory proof,
bool[] memory proofFlags,
bytes32[] memory leaves,
function(bytes32, bytes32) view returns (bytes32) hasher
) internal view returns (bytes32 merkleRoot) {
// This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
// consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
// `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
// the Merkle tree.
uint256 leavesLen = leaves.length;
uint256 proofFlagsLen = proofFlags.length;
// Check proof validity.
if (leavesLen + proof.length != proofFlagsLen + 1) {
revert MerkleProofInvalidMultiproof();
}
// The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
// `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
bytes32[] memory hashes = new bytes32[](proofFlagsLen);
uint256 leafPos = 0;
uint256 hashPos = 0;
uint256 proofPos = 0;
// At each step, we compute the next hash using two values:
// - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
// get the next hash.
// - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
// `proof` array.
for (uint256 i = 0; i < proofFlagsLen; i++) {
bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
bytes32 b = proofFlags[i]
? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
: proof[proofPos++];
hashes[i] = hasher(a, b);
}
if (proofFlagsLen > 0) {
if (proofPos != proof.length) {
revert MerkleProofInvalidMultiproof();
}
unchecked {
return hashes[proofFlagsLen - 1];
}
} else if (leavesLen > 0) {
return leaves[0];
} else {
return proof[0];
}
}
/**
* @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
* `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
*
* This version handles multiproofs in calldata with the default hashing function.
*
* CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
*
* NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`.
* The `leaves` must be validated independently. See {processMultiProofCalldata}.
*/
function multiProofVerifyCalldata(
bytes32[] calldata proof,
bool[] calldata proofFlags,
bytes32 root,
bytes32[] memory leaves
) internal pure returns (bool) {
return processMultiProofCalldata(proof, proofFlags, leaves) == root;
}
/**
* @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
* proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
* leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
* respectively.
*
* This version handles multiproofs in calldata with the default hashing function.
*
* CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
* is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
* tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
*
* NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op,
* and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not
* validating the leaves elsewhere.
*/
function processMultiProofCalldata(
bytes32[] calldata proof,
bool[] calldata proofFlags,
bytes32[] memory leaves
) internal pure returns (bytes32 merkleRoot) {
// This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
// consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
// `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
// the Merkle tree.
uint256 leavesLen = leaves.length;
uint256 proofFlagsLen = proofFlags.length;
// Check proof validity.
if (leavesLen + proof.length != proofFlagsLen + 1) {
revert MerkleProofInvalidMultiproof();
}
// The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
// `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
bytes32[] memory hashes = new bytes32[](proofFlagsLen);
uint256 leafPos = 0;
uint256 hashPos = 0;
uint256 proofPos = 0;
// At each step, we compute the next hash using two values:
// - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
// get the next hash.
// - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
// `proof` array.
for (uint256 i = 0; i < proofFlagsLen; i++) {
bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
bytes32 b = proofFlags[i]
? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
: proof[proofPos++];
hashes[i] = Hashes.commutativeKeccak256(a, b);
}
if (proofFlagsLen > 0) {
if (proofPos != proof.length) {
revert MerkleProofInvalidMultiproof();
}
unchecked {
return hashes[proofFlagsLen - 1];
}
} else if (leavesLen > 0) {
return leaves[0];
} else {
return proof[0];
}
}
/**
* @dev Returns true if the `leaves` can be simultaneously proven to be a part of a Merkle tree defined by
* `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
*
* This version handles multiproofs in calldata with a custom hashing function.
*
* CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
*
* NOTE: Consider the case where `root == proof[0] && leaves.length == 0` as it will return `true`.
* The `leaves` must be validated independently. See {processMultiProofCalldata}.
*/
function multiProofVerifyCalldata(
bytes32[] calldata proof,
bool[] calldata proofFlags,
bytes32 root,
bytes32[] memory leaves,
function(bytes32, bytes32) view returns (bytes32) hasher
) internal view returns (bool) {
return processMultiProofCalldata(proof, proofFlags, leaves, hasher) == root;
}
/**
* @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
* proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
* leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
* respectively.
*
* This version handles multiproofs in calldata with a custom hashing function.
*
* CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
* is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
* tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
*
* NOTE: The _empty set_ (i.e. the case where `proof.length == 1 && leaves.length == 0`) is considered a no-op,
* and therefore a valid multiproof (i.e. it returns `proof[0]`). Consider disallowing this case if you're not
* validating the leaves elsewhere.
*/
function processMultiProofCalldata(
bytes32[] calldata proof,
bool[] calldata proofFlags,
bytes32[] memory leaves,
function(bytes32, bytes32) view returns (bytes32) hasher
) internal view returns (bytes32 merkleRoot) {
// This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
// consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
// `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
// the Merkle tree.
uint256 leavesLen = leaves.length;
uint256 proofFlagsLen = proofFlags.length;
// Check proof validity.
if (leavesLen + proof.length != proofFlagsLen + 1) {
revert MerkleProofInvalidMultiproof();
}
// The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
// `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
bytes32[] memory hashes = new bytes32[](proofFlagsLen);
uint256 leafPos = 0;
uint256 hashPos = 0;
uint256 proofPos = 0;
// At each step, we compute the next hash using two values:
// - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
// get the next hash.
// - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
// `proof` array.
for (uint256 i = 0; i < proofFlagsLen; i++) {
bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
bytes32 b = proofFlags[i]
? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
: proof[proofPos++];
hashes[i] = hasher(a, b);
}
if (proofFlagsLen > 0) {
if (proofPos != proof.length) {
revert MerkleProofInvalidMultiproof();
}
unchecked {
return hashes[proofFlagsLen - 1];
}
} else if (leavesLen > 0) {
return leaves[0];
} else {
return proof[0];
}
}
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
pragma solidity ^0.8.4;
/**
* @dev Interface of ERC721A.
*/
interface IERC721A {
/**
* The caller must own the token or be an approved operator.
*/
error ApprovalCallerNotOwnerNorApproved();
/**
* The token does not exist.
*/
error ApprovalQueryForNonexistentToken();
/**
* Cannot query the balance for the zero address.
*/
error BalanceQueryForZeroAddress();
/**
* Cannot mint to the zero address.
*/
error MintToZeroAddress();
/**
* The quantity of tokens minted must be more than zero.
*/
error MintZeroQuantity();
/**
* The token does not exist.
*/
error OwnerQueryForNonexistentToken();
/**
* The caller must own the token or be an approved operator.
*/
error TransferCallerNotOwnerNorApproved();
/**
* The token must be owned by `from`.
*/
error TransferFromIncorrectOwner();
/**
* Cannot safely transfer to a contract that does not implement the
* ERC721Receiver interface.
*/
error TransferToNonERC721ReceiverImplementer();
/**
* Cannot transfer to the zero address.
*/
error TransferToZeroAddress();
/**
* The token does not exist.
*/
error URIQueryForNonexistentToken();
/**
* The `quantity` minted with ERC2309 exceeds the safety limit.
*/
error MintERC2309QuantityExceedsLimit();
/**
* The `extraData` cannot be set on an unintialized ownership slot.
*/
error OwnershipNotInitializedForExtraData();
// =============================================================
// 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
// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)
pragma solidity ^0.8.20;
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC2981.sol)
pragma solidity ^0.8.20;
import {IERC165} from "../utils/introspection/IERC165.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.
*/
interface IERC2981 is IERC165 {
/**
* @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of
* exchange. The royalty amount is denominated and should be paid in that same unit of exchange.
*
* NOTE: ERC-2981 allows setting the royalty to 100% of the price. In that case all the price would be sent to the
* royalty receiver and 0 tokens to the seller. Contracts dealing with royalty should consider empty transfers.
*/
function royaltyInfo(
uint256 tokenId,
uint256 salePrice
) external view returns (address receiver, uint256 royaltyAmount);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/ERC165.sol)
pragma solidity ^0.8.20;
import {IERC165} from "./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC-165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*/
abstract contract ERC165 is IERC165 {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
return interfaceId == type(IERC165).interfaceId;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/Hashes.sol)
pragma solidity ^0.8.20;
/**
* @dev Library of standard hash functions.
*
* _Available since v5.1._
*/
library Hashes {
/**
* @dev Commutative Keccak256 hash of a sorted pair of bytes32. Frequently used when working with merkle proofs.
*
* NOTE: Equivalent to the `standardNodeHash` in our https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
*/
function commutativeKeccak256(bytes32 a, bytes32 b) internal pure returns (bytes32) {
return a < b ? efficientKeccak256(a, b) : efficientKeccak256(b, a);
}
/**
* @dev Implementation of keccak256(abi.encode(a, b)) that doesn't allocate or expand memory.
*/
function efficientKeccak256(bytes32 a, bytes32 b) internal pure returns (bytes32 value) {
assembly ("memory-safe") {
mstore(0x00, a)
mstore(0x20, b)
value := keccak256(0x00, 0x40)
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)
pragma solidity ^0.8.20;
/**
* @dev Interface of the ERC-165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[ERC].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[ERC section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}{
"viaIR": false,
"codegen": "yul",
"remappings": [
"@rari-capital/solmate/=lib/solmate/",
"ds-test/=lib/ds-test/src/",
"forge-std/=lib/forge-std/src/",
"murky/=lib/murky/src/",
"@openzeppelin/=lib/openzeppelin-contracts/",
"solarray/=lib/solarray/src/",
"solady/=lib/solady/",
"seaport-sol/=lib/seaport-sol/",
"seaport-types/=lib/seaport-types/",
"seaport-core/=lib/seaport-core/",
"seaport/=contracts/",
"closedsea/=lib/closedsea/",
"erc721a/=lib/closedsea/lib/erc721a/",
"erc4626-tests/=lib/openzeppelin-contracts/lib/erc4626-tests/",
"erc721a-upgradeable/=lib/closedsea/lib/erc721a-upgradeable/contracts/",
"halmos-cheatcodes/=lib/openzeppelin-contracts/lib/halmos-cheatcodes/src/",
"openzeppelin-contracts-upgradeable/=lib/closedsea/lib/openzeppelin-contracts-upgradeable/",
"openzeppelin-contracts/=lib/openzeppelin-contracts/",
"operator-filter-registry/=lib/closedsea/lib/operator-filter-registry/",
"solmate/=lib/solmate/src/"
],
"evmVersion": "cancun",
"outputSelection": {
"*": {
"*": [
"abi"
]
}
},
"optimizer": {
"enabled": true,
"mode": "3",
"fallback_to_optimizing_for_size": false,
"disable_system_request_memoization": true
},
"metadata": {},
"libraries": {},
"enableEraVMExtensions": false,
"forceEVMLA": false
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidDefaultRoyalty","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidDefaultRoyaltyReceiver","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidTokenRoyalty","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidTokenRoyaltyReceiver","type":"error"},{"inputs":[],"name":"FeeTransferFailed","type":"error"},{"inputs":[],"name":"InputLengthsMismatch","type":"error"},{"inputs":[],"name":"InvalidLaunchpadFee","type":"error"},{"inputs":[],"name":"InvalidLaunchpadFeeAddress","type":"error"},{"inputs":[],"name":"InvalidMerkleProof","type":"error"},{"inputs":[],"name":"MaxFeeExceeded","type":"error"},{"inputs":[],"name":"MaxSupplyExceeded","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"NotAllowedByRegistry","type":"error"},{"inputs":[],"name":"NotEnoughAllowance","type":"error"},{"inputs":[],"name":"NotEnoughBalance","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"PaymentTransferFailed","type":"error"},{"inputs":[],"name":"PublicSaleClosed","type":"error"},{"inputs":[],"name":"RegistryNotSet","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":"TransfersLocked","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"WrongWeiSent","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"toTokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"ConsecutiveTransfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"feeAddress","type":"address"},{"indexed":false,"internalType":"uint256","name":"feeAmount","type":"uint256"}],"name":"LaunchpadFeeSent","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":"recipient","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"TokenPaymentSent","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldValidator","type":"address"},{"indexed":false,"internalType":"address","name":"newValidator","type":"address"}],"name":"TransferValidatorUpdated","type":"event"},{"inputs":[{"internalType":"address[]","name":"users","type":"address[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"airDrop","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"breakLock","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"currency","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"endTimePhase1","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"endTimePhase2","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"endTimePhase3","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getTransferValidationFunction","outputs":[{"internalType":"bytes4","name":"functionSignature","type":"bytes4"},{"internalType":"bool","name":"isViewFunction","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"getTransferValidator","outputs":[{"internalType":"address","name":"validator","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"initialTransferLockOn","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"isRegistryActive","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"launchpadCutBps","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"launchpadFee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"launchpadFeeAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxPerWalletPhase1","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxPerWalletPhase2","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxPerWalletPhase3","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupplyPhase1","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupplyPhase2","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupplyPhase3","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"merkleRootPhase1","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"merkleRootPhase2","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"merkleRootPhase3","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32[]","name":"merkleProof","type":"bytes32[]"},{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"mintPhase1","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes32[]","name":"merkleProof","type":"bytes32[]"},{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"mintPhase2","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"mintPhase3","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"operatorFilteringEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"ownerMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pricePhase1","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pricePhase2","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pricePhase3","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"registryAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"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":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newEndTime","type":"uint256"}],"name":"setEndTimePhase1","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newEndTime","type":"uint256"}],"name":"setEndTimePhase2","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newEndTime","type":"uint256"}],"name":"setEndTimePhase3","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_isRegistryActive","type":"bool"}],"name":"setIsRegistryActive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxPerWallet","type":"uint256"}],"name":"setMaxPerWalletPhase1","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxPerWallet","type":"uint256"}],"name":"setMaxPerWalletPhase2","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxPerWallet","type":"uint256"}],"name":"setMaxPerWalletPhase3","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxSupply","type":"uint256"}],"name":"setMaxSupply","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxSupply","type":"uint256"}],"name":"setMaxSupplyPhase1","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxSupply","type":"uint256"}],"name":"setMaxSupplyPhase2","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newMaxSupply","type":"uint256"}],"name":"setMaxSupplyPhase3","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"newMerkleRoot","type":"bytes32"}],"name":"setMerkleRootPhase1","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"newMerkleRoot","type":"bytes32"}],"name":"setMerkleRootPhase2","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"newMerkleRoot","type":"bytes32"}],"name":"setMerkleRootPhase3","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"value","type":"bool"}],"name":"setOperatorFilteringEnabled","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"placeholderURI","type":"string"}],"name":"setPlaceholderBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newPrice","type":"uint256"}],"name":"setPricePhase1","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newPrice","type":"uint256"}],"name":"setPricePhase2","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newPrice","type":"uint256"}],"name":"setPricePhase3","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_registryAddress","type":"address"}],"name":"setRegistryAddress","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newStartTime","type":"uint256"}],"name":"setStartTimePhase1","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newStartTime","type":"uint256"}],"name":"setStartTimePhase2","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newStartTime","type":"uint256"}],"name":"setStartTimePhase3","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setTokenRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"setTransferValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"startTimePhase1","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"startTimePhase2","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"startTimePhase3","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupplyPhase1","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupplyPhase2","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupplyPhase3","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"walletMintsPhase1","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"walletMintsPhase2","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"walletMintsPhase3","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"tokenAddress","type":"address"}],"name":"withdrawERC20","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"tokenAddress","type":"address"},{"internalType":"address","name":"to","type":"address"}],"name":"withdrawERC20To","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address payable","name":"_to","type":"address"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
9c4d535b00000000000000000000000000000000000000000000000000000000000000000100087d4748cc8fc18c15314939c2595babf2617a9cb17a0a02bdbad0b3bad800000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0002000000000002000c00000000000200010000000103550000006003100270000007760030019d0000008004000039000000400040043f0000000100200190000000290000c13d0000077602300197000000040020008c00000fb80000413d000000000301043b000000e003300270000007a20030009c0000003c0000213d000007df0030009c0000006e0000a13d000007e00030009c000001b20000a13d000007e10030009c000002240000213d000007e90030009c000004930000213d000007ed0030009c00000da50000613d000007ee0030009c000009940000613d000007ef0030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f0000001a0100003900000e460000013d0000000001000416000000000001004b00000fb80000c13d0000000603000039000000800030043f0000077701000041000000a00010043f0000010002000039000000400020043f000000c00030043f000000e00010043f0000000006000411000000000006004b000000550000c13d0000082201000041000000000010043f000000040000043f0000081d0100004100001dd400010430000007a30030009c0000007f0000a13d000007a40030009c000001df0000a13d000007a50030009c000002360000213d000007ad0030009c0000049e0000213d000007b10030009c00000daa0000613d000007b20030009c000009990000613d000007b30030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000180100003900000e460000013d000000000100041a0000077802100197000000000262019f000000000020041b00000000020004140000077905100197000007760020009c0000077602008041000000c0012002100000077a011001c70000800d0200003900000003030000390000077b040000411dd21dc80000040f000000010020019000000fb80000613d000000800400043d0000077c0040009c000001840000413d0000084e01000041000000000010043f0000004101000039000000040010043f0000081d0100004100001dd400010430000007fe0030009c000001940000213d0000080d0030009c0000027e0000a13d0000080e0030009c000004460000213d000008120030009c000009000000613d000008130030009c000006610000613d000008140030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d0000000b0100003900000a450000013d000007c20030009c000001a30000213d000007d10030009c0000028b0000a13d000007d20030009c000004550000213d000007d60030009c000009270000613d000007d70030009c000006d50000613d000007d80030009c00000fb80000c13d000000440020008c00000fb80000413d0000000403100370000000000303043b000007800030009c00000fb80000213d0000002304300039000000000024004b00000fb80000813d000900040030003d0000000904100360000000000404043b000c00000004001d000007800040009c00000fb80000213d00000024033000390000000c040000290000000504400210000700000003001d000b00000004001d000800000034001d000000080020006b00000fb80000213d0000002401100370000000000101043b000600000001001d0000001401000039000000000101041a000a00000001001d000000000001004b0000111f0000c13d0000001501000039000000000101041a000a00000001001d000000000001004b000000bd0000613d000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b0000000a0010006c000004250000213d0000001001000039000000000101041a000000000001004b0000000604000029000000cd0000613d0000000402000039000000000202041a00000872022001670000000303000039000000000303041a0000000002230019000000000042001a000017280000413d0000000002420019000000000012004b00000ee90000213d0000001601000039000000000101041a000000000001004b000000d80000613d0000001702000039000000000202041a000000000042001a000017280000413d0000000002420019000000000012004b00000ee90000213d0000001801000039000000000101041a0000000c02000039000000000202041a000500000002001d000000000012001a000017280000413d000000050110002a00040000004100ad000000e50000613d00000004011000f9000000000041004b000017280000c13d0000000f01000039000000000101041a000a07790010019c0000128b0000c13d0000000001000416000000040010006c000011c40000c13d0000001a01000039000000000101041a000300000001001d000000000001004b000014fb0000c13d0000001901000039000000000101041a000c00000001001d000000000001004b0000000603000029000016360000c13d000000050000006b0000000001000019000001030000613d0000000e01000039000000000101041a00000779001001980000000001000019000001030000613d00000005013000b900000005021000fa000000000032004b000017280000c13d0000000d02000039000000000202041a000000000002004b0000000003000019000001140000613d0000000e03000039000000000303041a00000779003001980000000003000019000001140000613d000000040410006b000017280000413d00000000032400a900000000022300d9000000000042004b000017280000c13d000027100330011a000000000013001a000017280000413d000c00000013001e0000011a0000613d0000000c010000291dd21bdf0000040f0000000f01000039000000000101041a0000077902100198000016eb0000613d0000000c03000029000b000400300073000016eb0000a13d0000000001000410000907790010019c000014110000613d000000400400043d000800000004001d00000044014000390000000b030000290000000000310435000000240140003900000009030000290000000000310435000008460100004100000000001404350000000001000411000a00000001001d00000779031001970000000401400039000c00000003001d0000000000310435000007760040009c0000077601000041000000000104401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f00000847011001c71dd21dc80000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000080b00002900000008057000290000014f0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b0000014b0000c13d000000000006004b0000015c0000613d000000000171034f0000000306600210000000000705043300000000076701cf000000000767022f000000000101043b0000010006600089000000000161022f00000000016101cf000000000171019f00000000001504350000000100200190000014110000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000007800010009c000000680000213d0000000100200190000000680000c13d000000400010043f000000200030008c00000fb80000413d00000000020b0433000000000002004b0000000003000039000000010300c039000000000032004b00000fb80000c13d0000000b020000290000000000210435000007760010009c000007760100804100000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000077f011001c70000800d020000390000000203000039000008480400004100000009050000291dd21dc80000040f0000000100200190000016ee0000c13d00000fb80000013d0000000506000039000000000106041a000000010310019000000001021002700000007f0220618f0000001f0020008c00000000010000390000000101002039000000000013004b0000025a0000613d0000084e01000041000000000010043f0000002201000039000000040010043f0000081d0100004100001dd400010430000007ff0030009c000002b80000a13d000008000030009c000004600000213d000008040030009c000009320000613d000008050030009c000006da0000613d000008060030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d0000000e0100003900000a450000013d000007c30030009c000003dd0000a13d000007c40030009c000004720000213d000007c80030009c0000093d0000613d000007c90030009c000007060000613d000007ca0030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d0000002a0100003900000e1a0000013d000007f00030009c000003f00000a13d000007f10030009c0000047d0000213d000007f50030009c00000c0f0000613d000007f60030009c000009a40000613d000007f70030009c00000fb80000c13d000000440020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000402100370000000000302043b000007790030009c00000fb80000213d0000002401100370000000000201043b000000000100041a00000779041001970000000001000411000000000014004b00000ea70000c13d0000001001000039000000000101041a000000000001004b000001db0000613d0000000404000039000000000404041a00000872044001670000000305000039000000000505041a0000000004450019000000000024001a000017280000413d0000000004240019000000000014004b00000ee90000213d00000000010300191dd21c920000040f000000000100001900001dd30001042e000007b40030009c000004290000a13d000007b50030009c000004880000213d000007b90030009c00000c1a0000613d000007ba0030009c000009bd0000613d000007bb0030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000201043b000000000002004b00000eb00000613d0000000301000039000000000101041a000000000021004b00000eb00000a13d000c00000002001d000000000020043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000008250010019800000eb00000c13d0000001204000039000000000204041a000000010620019000000001012002700000007f0110618f0000001f0010008c00000000030000390000000103002039000000000332013f00000001003001900000018e0000c13d000000400500043d0000000003150436000000000006004b000012530000613d000000000040043f000000000001004b0000000002000019000012580000613d000007860400004100000000020000190000000006230019000000000704041a000000000076043500000001044000390000002002200039000000000012004b0000021c0000413d000012580000013d000007e20030009c000004a90000213d000007e60030009c00000daf0000613d000007e70030009c000009c80000613d000007e80030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b1dd21d7d0000040f000007790110019700000dc70000013d000007a60030009c000004ba0000213d000007aa0030009c00000db40000613d000007ab0030009c000009cd0000613d000007ac0030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000601043b000007790060009c00000fb80000213d000000000100041a00000779021001970000000005000411000000000052004b00000eb40000c13d000000000006004b000000370000613d0000077801100197000000000161019f000000000010041b0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d0200003900000003030000390000077b04000041000008fc0000013d000000200020008c0000026a0000413d0000001f0140003900000005011002700000077d0110009a000000200040008c0000077e010040410000001f0220003900000005022002700000077d0220009a000000000021004b0000026a0000813d000000000001041b0000000101100039000000000021004b000002660000413d0000001f0040008c000004c70000a13d000c00000004001d000000000060043f0000000001000414000007760010009c0000077601008041000000c0011002100000077f011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d0000000c070000290000087302700198000000000101043b00000e4a0000c13d0000002003000039000000050600003900000e570000013d000008150030009c000004d20000a13d000008160030009c000007610000613d000008170030009c000005330000613d000008180030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d000000160100003900000e1a0000013d000007d90030009c000004e80000a13d000007da0030009c0000077d0000613d000007db0030009c000005520000613d000007dc0030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d000007790010009c00000fb80000213d000000000100041a00000779021001970000000001000411000000000012004b00000ea70000c13d0000084a010000410000000000100443000000000100041000000004001004430000000001000414000007760010009c0000077601008041000000c00110021000000833011001c70000800a020000391dd21dcd0000040f000000010020019000001a070000613d000000000301043b0000000001000414000007760010009c0000077601008041000000c001100210000000000003004b0000112e0000c13d0000000c02000029000011320000013d000008070030009c000004fb0000a13d000008080030009c000007910000613d000008090030009c0000055d0000613d0000080a0030009c00000fb80000c13d000000640020008c00000fb80000413d0000000402100370000000000202043b000b00000002001d000007790020009c00000fb80000213d0000002402100370000000000202043b000a00000002001d000007790020009c00000fb80000213d0000004401100370000000000201043b00000000030004110000000b0030006b000002e60000613d0000001101000039000000000101041a000000ff00100190000002e60000613d000900000002001d0000082e01000041000000000010043f00000000010004100000001a0010043f0000003a0030043f0000000001000414000007760010009c0000077601008041000000c0011002100000082f011001c70000079d020000411dd21dcd0000040f0000000100200190000011d40000613d0000003a0000043f0000000902000029000000000002004b000011b80000613d000900000002001d000000000020043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a0000082500200198000011b80000c13d0000000001020019000000000002004b000003150000c13d0000000301000039000000000101041a0000000902000029000000000021004b000011b80000a13d000c00000002001d0000000c01000029000000010110008a000c00000001001d000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000000001004b000003020000613d000c00000001001d00000779011001970000000b0010006c0000124f0000c13d0000000901000029000000000010043f0000000901000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000600000001001d000000000101041a000700000001001d00000000010004110000077902100197000800000002001d0000000b0020006c000003500000613d0000000802000029000000070020006c000003500000613d0000000b01000029000000000010043f0000000a01000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000802000029000000000020043f000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000ff00100190000008b30000613d0000000a01000029000a07790010019c000015e70000613d0000001101000039000000000201041a0000000b0000006b000003590000613d0000ff00002001900000166a0000c13d0000083000200198000018200000c13d0000000b0000006b000003610000613d0000000b01000039000000000101041a000507790010019c000018cd0000c13d000000070000006b000003650000613d0000000601000029000000000001041b0000000b01000029000000000010043f0000000801000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000a01000029000000000010043f0000000801000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a0000000102200039000000000021041b000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b000800000001001d0000000901000029000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d0000000802000029000000a0022002100000000a022001af00000838022001c7000000000101043b000000000021041b0000000c010000290000083800100198000003d10000c13d00000009010000290000000101100039000800000001001d000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000000001004b000003d10000c13d0000000301000039000000000101041a000000080010006b000003d10000613d0000000801000029000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000c02000029000000000021041b0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d02000039000000040300003900000839040000410000000b050000290000000a060000290000000907000029000008fc0000013d000007cb0030009c0000050b0000a13d000007cc0030009c000008100000613d000007cd0030009c000005680000613d000007ce0030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000220100003900000e460000013d000007f80030009c000005140000a13d000007f90030009c000009d40000613d000007fa0030009c0000082f0000613d000007fb0030009c00000fb80000c13d000000240020008c00000fb80000413d0000000401100370000000000401043b0000002401000039000000000101041a000000000001004b000c00000004001d000004110000613d000b00000001001d000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b0000000b0010006c0000000c04000029000004250000413d0000002501000039000000000101041a000000000001004b00000ecf0000613d000b00000001001d000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b0000000b0010006c0000000c0400002900000ecf0000a13d0000085701000041000000000010043f0000082c0100004100001dd400010430000007bc0030009c0000051d0000a13d000007bd0030009c000009d90000613d000007be0030009c000008b70000613d000007bf0030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000201043b000000000002004b0000000001000039000000010100c039000c00000002001d000000000012004b00000fb80000c13d1dd21bd40000040f0000001101000039000000000201041a00000874022001970000000c022001af000000000021041b000000000100001900001dd30001042e0000080f0030009c000009480000613d000008100030009c000008c20000613d000008110030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d0000083401000041000000800010043f0000000101000039000000a00010043f000008640100004100001dd30001042e000007d30030009c000009530000613d000007d40030009c000008ce0000613d000007d50030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d0000000c0100003900000e1a0000013d000008010030009c000009580000613d000008020030009c000008d90000613d000008030030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000007790010009c00000fb80000213d000000000010043f0000001b01000039000009780000013d000007c50030009c000009630000613d000007c60030009c000008de0000613d000007c70030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d000000140100003900000e1a0000013d000007f20030009c00000d950000613d000007f30030009c000009e40000613d000007f40030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d0000001c0100003900000e1a0000013d000007b60030009c00000da00000613d000007b70030009c00000a220000613d000007b80030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d0000000d0100003900000e1a0000013d000007ea0030009c00000dce0000613d000007eb0030009c00000a270000613d000007ec0030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d000000210100003900000e1a0000013d000007ae0030009c00000e0c0000613d000007af0030009c00000a410000613d000007b00030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d000000180100003900000e1a0000013d000007e30030009c00000e110000613d000007e40030009c00000a4a0000613d000007e50030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000250100003900000e460000013d000007a70030009c00000e160000613d000007a80030009c00000b8c0000613d000007a90030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d0000001101000039000000000101041a000000ff00100190000009df0000013d000000000004004b0000000001000019000004cb0000613d000000a00100043d0000000302400210000008720220027f0000087202200167000000000121016f0000000102400210000000000121019f00000e630000013d000008190030009c0000096d0000613d0000081a0030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000201043b0000083d0020019800000fb80000c13d00000001010000390000079e022001970000086c0020009c00000fc80000213d0000086f0020009c00000fd10000613d000008700020009c00000fd10000613d00000fcc0000013d000007dd0030009c0000097d0000613d000007de0030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000007790010009c00000fb80000213d000000000001004b00000fd50000c13d0000084b01000041000000000010043f0000082c0100004100001dd4000104300000080b0030009c000009880000613d0000080c0030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d0000000401000039000000000101041a00000872011001670000000302000039000000000202041a0000000001120019000000800010043f0000081b0100004100001dd30001042e000007cf0030009c0000098f0000613d000007d00030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d000000270100003900000e1a0000013d000007fc0030009c00000e1e0000613d000007fd0030009c00000fb80000c13d0000000001000416000000000001004b00000fb80000c13d000000280100003900000e1a0000013d000007c00030009c00000e3c0000613d000007c10030009c00000fb80000c13d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d000007790010009c00000fb80000213d1dd21bd40000040f0000000c0100002900000018011002100000083e011001970000001102000039000000000302041a0000083f033001970000109f0000013d0000000001000416000000000001004b00000fb80000c13d0000000503000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f00000001005001900000018e0000c13d000000800010043f000000000004004b00000eb90000613d000000000030043f000000000001004b000000000200001900000ebe0000613d0000077e030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b0000054a0000413d00000ebe0000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000280100003900000e460000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000240100003900000e460000013d000000440020008c00000fb80000413d0000000403100370000000000303043b000007800030009c00000fb80000213d0000002304300039000000000024004b00000fb80000813d000900040030003d0000000904100360000000000404043b000c00000004001d000007800040009c00000fb80000213d00000024033000390000000c040000290000000504400210000700000003001d000b00000004001d000800000034001d000000080020006b00000fb80000213d0000002401100370000000000101043b000600000001001d0000001c01000039000000000101041a000a00000001001d000000000001004b000011630000c13d0000001d01000039000000000101041a000a00000001001d000000000001004b0000059a0000613d000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b0000000a0010006c000004250000213d0000001001000039000000000101041a000000000001004b0000000604000029000005aa0000613d0000000402000039000000000202041a00000872022001670000000303000039000000000303041a0000000002230019000000000042001a000017280000413d0000000002420019000000000012004b00000ee90000213d0000001e01000039000000000101041a000000000001004b000005b50000613d0000001f02000039000000000202041a000000000042001a000017280000413d0000000002420019000000000012004b00000ee90000213d0000002001000039000000000101041a0000000c02000039000000000202041a000500000002001d000000000012001a000017280000413d000000050110002a00040000004100ad000005c20000613d00000004011000f9000000000041004b000017280000c13d0000000f01000039000000000101041a000a07790010019c000013120000c13d0000000001000416000000040010006c000011c40000c13d0000002201000039000000000101041a000300000001001d000000000001004b0000155f0000c13d0000002101000039000000000101041a000c00000001001d000000000001004b00000006030000290000164d0000c13d000000050000006b0000000001000019000005e00000613d0000000e01000039000000000101041a00000779001001980000000001000019000005e00000613d00000005013000b900000005021000fa000000000032004b000017280000c13d0000000d02000039000000000202041a000000000002004b0000000003000019000005f10000613d0000000e03000039000000000303041a00000779003001980000000003000019000005f10000613d000000040410006b000017280000413d00000000032400a900000000022300d9000000000042004b000017280000c13d000027100330011a000000000013001a000017280000413d000c00000013001e000005f70000613d0000000c010000291dd21bdf0000040f0000000f01000039000000000101041a0000077902100198000017070000613d0000000c03000029000b000400300073000017070000a13d0000000001000410000907790010019c000014110000613d000000400400043d000800000004001d00000044014000390000000b030000290000000000310435000000240140003900000009030000290000000000310435000008460100004100000000001404350000000001000411000a00000001001d00000779031001970000000401400039000c00000003001d0000000000310435000007760040009c0000077601000041000000000104401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f00000847011001c71dd21dc80000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000080b00002900000008057000290000062c0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000006280000c13d000000000006004b000006390000613d000000000171034f0000000306600210000000000705043300000000076701cf000000000767022f000000000101043b0000010006600089000000000161022f00000000016101cf000000000171019f00000000001504350000000100200190000014110000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000007800010009c000000680000213d0000000100200190000000680000c13d000000400010043f000000200030008c00000fb80000413d00000000020b0433000000000002004b0000000003000039000000010300c039000000000032004b00000fb80000c13d0000000b020000290000000000210435000007760010009c000007760100804100000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000077f011001c70000800d020000390000000203000039000008480400004100000009050000291dd21dc80000040f00000001002001900000170a0000c13d00000fb80000013d000000440020008c00000fb80000413d0000000402100370000000000202043b000b00000002001d000007790020009c00000fb80000213d0000002401100370000000000201043b0000001101000039000000000101041a000000ff00100190000006820000613d000a00000002001d0000082e01000041000000000010043f00000000010004100000001a0010043f0000000b010000290000003a0010043f0000000001000414000007760010009c0000077601008041000000c0011002100000082f011001c70000079d020000411dd21dcd0000040f0000000100200190000010810000613d0000003a0000043f0000001101000039000000000101041a0000000a020000290000ff00001001900000166a0000c13d000000000002004b000011b80000613d000a00000002001d000000000020043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a0000082500100198000011b80000c13d000000000001004b000006b20000c13d0000000301000039000000000101041a0000000a02000029000000000021004b000011b80000a13d000c00000002001d0000000c01000029000000010110008a000c00000001001d000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000000001004b0000069f0000613d000c07790010019b00000000020004110000000c0020006c000014150000c13d0000000a01000029000000000010043f0000000901000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d0000000b020000290000077906200197000000000101043b000000000201041a0000077802200197000000000262019f000000000021041b0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d02000039000000040300003900000867040000410000000c050000290000000a07000029000008fc0000013d0000000001000416000000000001004b00000fb80000c13d0000001d0100003900000e1a0000013d000000440020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000002402100370000000000202043b000c00000002001d0000000401100370000000000101043b000000000010043f0000000201000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a0000077902100198000006f70000c13d0000000101000039000000000101041a0000077902100197000b00000002001d000000a0021002700000000c010000291dd21bc60000040f000027100110011a000000400200043d000000200320003900000000001304350000000b010000290000000000120435000007760020009c000007760200804100000040012002100000085e011001c700001dd30001042e000000440020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000402100370000000000202043b000c00000002001d000007790020009c00000fb80000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039000b00000002001d000000000012004b00000fb80000c13d0000001101000039000000000101041a000000ff001001900000072e0000613d0000082e01000041000000000010043f00000000010004100000001a0010043f0000000c010000290000003a0010043f0000000001000414000007760010009c0000077601008041000000c0011002100000082f011001c70000079d020000411dd21dcd0000040f0000000100200190000011720000613d0000003a0000043f0000001101000039000000000101041a0000ff00001001900000166a0000c13d0000000001000411000000000010043f0000000a01000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000c02000029000000000020043f000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a00000874022001970000000b03000029000000000232019f000000000021041b000000400100043d0000000000310435000007760010009c000007760100804100000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000077f011001c70000800d020000390000000303000039000008420400004100000000050004110000000c06000029000008fc0000013d000000440020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000402100370000000000202043b000007790020009c00000fb80000213d0000002401100370000000000101043b000c00000001001d000008520010009c00000fb80000213d0000000003020019000000000100041a00000779021001970000000001000411000000000012004b00000ea70000c13d0000000c01000029000003e90010008c00000a3d0000813d000b00000003001d000000000003004b000011ee0000c13d0000086a01000041000000380000013d0000000001000416000000000001004b00000fb80000c13d000000000100041a00000779021001970000000005000411000000000052004b00000eb40000c13d0000077801100197000000000010041b0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d0200003900000003030000390000077b040000410000000006000019000008fc0000013d000000440020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000402100370000000000202043b000c00000002001d000007790020009c00000fb80000213d0000002401100370000000000101043b000b00000001001d000007790010009c00000fb80000213d000000000100041a00000779021001970000000001000411000000000012004b00000ea70000c13d0000081e01000041000000800010043f00000000010004100000077901100197000000840010043f0000000001000414000007760010009c0000077601008041000000c0011002100000081f011001c70000000c020000291dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf000007c00000613d0000008008000039000000000901034f000000009a09043c0000000008a80436000000000058004b000007bc0000c13d000000000006004b000007cd0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000118c0000613d0000001f01400039000000600110018f00000080021001bf000a00000002001d000000400020043f000000200030008c00000fb80000413d000000800200043d000000000002004b0000115f0000613d00000821030000410000000a05000029000000000035043500000084031001bf0000000b040000290000000000430435000000a40110003900000000002104350000000001000414000007760010009c0000077601008041000000c0011002100000004002500210000000000121019f0000079c011001c70000000c020000291dd21dc80000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000a05700029000007f90000613d000000000801034f0000000a09000029000000008a08043c0000000009a90436000000000059004b000007f50000c13d000000000006004b000008060000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000013ba0000613d0000001f01400039000000600110018f0000000a01100029000000400010043f000000200030008c00000fb80000413d0000000a0100002900000c060000013d0000000001000416000000000001004b00000fb80000c13d0000000603000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f00000001005001900000018e0000c13d000000800010043f000000000004004b00000eb90000613d000000000030043f000000000001004b000000000200001900000ebe0000613d00000782030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000008270000413d00000ebe0000013d000000640020008c00000fb80000413d0000000402100370000000000202043b000b00000002001d000007790020009c00000fb80000213d0000002402100370000000000202043b000a00000002001d000007790020009c00000fb80000213d0000004401100370000000000201043b00000000030004110000000b0030006b000008440000613d0000001101000039000000000101041a000000ff00100190000011980000c13d000000a001000039000800000001001d000000400010043f000900800000003d000000800000043f000000000002004b000011b80000613d000700000002001d000000000020043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a0000082500200198000011b80000c13d0000000001020019000000000002004b000008780000c13d0000000301000039000000000101041a0000000702000029000000000021004b000011b80000a13d000c00000002001d0000000c01000029000000010110008a000c00000001001d000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000000001004b000008650000613d000c00000001001d00000779011001970000000b0010006c0000124f0000c13d0000000701000029000000000010043f0000000901000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000400000001001d000000000101041a000500000001001d00000000010004110000077902100197000600000002001d0000000b0020006c000015e40000613d0000000502000029000000060020006b000015e40000613d0000000b01000029000000000010043f0000000a01000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000602000029000000000020043f000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000ff00100190000015e40000c13d0000086001000041000000000010043f0000082c0100004100001dd400010430000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000150100003900000e460000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000007790010009c00000fb80000213d000000000010043f0000002301000039000009780000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000160100003900000e460000013d0000000001000416000000000001004b00000fb80000c13d0000001e0100003900000e1a0000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000007790010009c00000fb80000213d000000000200041a00000779032001970000000002000411000000000023004b00000e970000c13d0000000b02000039000000000302041a0000077804300197000000000414019f000000000042041b0000077902300197000000800020043f000000a00010043f0000000001000414000007760010009c0000077601008041000000c00110021000000840011001c70000800d02000039000000010300003900000841040000411dd21dc80000040f000000010020019000000fb80000613d0000115d0000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000201043b000000000002004b00000eac0000613d0000000301000039000000000101041a000000000021004b00000eac0000a13d000c00000002001d000000000020043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a00000825001001980000000c0100002900000eac0000c13d000000000010043f0000000901000039000000200010043f000000400200003900000000010000191dd21db30000040f000000000101041a000002340000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000290100003900000e460000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000140100003900000e460000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f0000002a0100003900000e460000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000260100003900000e460000013d0000000001000416000000000001004b00000fb80000c13d000000260100003900000e1a0000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000200100003900000e460000013d0000000001000416000000000001004b00000fb80000c13d1dd21bd40000040f0000001101000039000000000201041a0000087502200197000000000021041b000000000100001900001dd30001042e000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000007790010009c00000fb80000213d000000000010043f0000002b01000039000000200010043f000000400200003900000000010000191dd21db30000040f00000e1a0000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000100100003900000e460000013d0000000001000416000000000001004b00000fb80000c13d0000001101000039000000000101041a0000ff0000100190000009df0000013d0000000001000416000000000001004b00000fb80000c13d000000000100041a00000a460000013d0000000001000416000000000001004b00000fb80000c13d000000170100003900000e1a0000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f0000001d0100003900000e460000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000000000001004b0000000002000039000000010200c039000000000021004b00000fb80000c13d000000000200041a00000779032001970000000002000411000000000023004b00000e970000c13d0000001102000039000000000302041a0000083e003001980000109b0000c13d0000085601000041000000000010043f0000082c0100004100001dd400010430000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f0000001e0100003900000e460000013d0000000001000416000000000001004b00000fb80000c13d000000200100003900000e1a0000013d0000000001000416000000000001004b00000fb80000c13d0000001101000039000000000101041a000000180110027000000a460000013d0000000001000416000000000001004b00000fb80000c13d000000150100003900000e1a0000013d0000000001000416000000000001004b00000fb80000c13d0000001101000039000000000101041a00000830001001980000000001000039000000010100c039000000800010043f0000081b0100004100001dd30001042e000000240020008c00000fb80000413d0000000003000416000000000003004b00000fb80000c13d0000000403100370000000000403043b000007800040009c00000fb80000213d0000002303400039000000000023004b00000fb80000813d0000000405400039000000000351034f000000000303043b000007800030009c00000fb80000213d00000024044000390000000006430019000000000026004b00000fb80000213d000000000200041a00000779062001970000000002000411000000000026004b00000e970000c13d0000001302000039000000000702041a000000010070019000000001067002700000007f0660618f0000001f0060008c00000000080000390000000108002039000000000787013f00000001007001900000018e0000c13d000000200060008c00000a1a0000413d000000000020043f0000001f073000390000000507700270000007880770009a000000200030008c0000078b070040410000001f066000390000000506600270000007880660009a000000000067004b00000a1a0000813d000000000007041b0000000107700039000000000067004b00000a160000413d0000001f0030008c000011f90000a13d000000000020043f0000087306300198000013c60000c13d0000078b050000410000000007000019000013db0000013d0000000001000416000000000001004b00000fb80000c13d000000250100003900000e1a0000013d000000640020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000402100370000000000202043b0000002403100370000000000303043b000007790030009c00000fb80000213d0000004401100370000000000101043b000008520010009c00000fb80000213d000000000400041a00000779054001970000000004000411000000000045004b000010a30000c13d000003e80010008c000011bc0000a13d0000086b01000041000000000010043f0000082c0100004100001dd4000104300000000001000416000000000001004b00000fb80000c13d0000000f01000039000000000101041a0000077901100197000000800010043f0000081b0100004100001dd30001042e000000440020008c00000fb80000413d0000000003000416000000000003004b00000fb80000c13d0000000403100370000000000303043b000007800030009c00000fb80000213d0000002304300039000000000024004b00000fb80000813d0000000404300039000000000441034f000000000504043b000007800050009c000000680000213d00000005045002100000003f0640003900000845066001970000082d0060009c000000680000213d0000008006600039000000400060043f000000800050043f00000024033000390000000004340019000000000024004b00000fb80000213d000000000005004b00000a720000613d000000a005000039000000000631034f000000000606043b000007790060009c00000fb80000213d00000000056504360000002003300039000000000043004b00000a6a0000413d0000002403100370000000000303043b000007800030009c00000fb80000213d0000002304300039000000000024004b00000000050000190000084c050080410000084c04400197000000000004004b00000000060000190000084c060040410000084c0040009c000000000605c019000000000006004b00000fb80000c13d0000000404300039000000000441034f000000000404043b000007800040009c000000680000213d00000005054002100000003f065000390000084506600197000000400700043d0000000006670019000600000007001d000000000076004b00000000070000390000000107004039000007800060009c000000680000213d0000000100700190000000680000c13d000000400060043f00000006060000290000000006460436000700000006001d00000024033000390000000005350019000000000025004b00000fb80000213d000000000004004b00000aa60000613d0000000602000029000000000431034f000000000404043b000000200220003900000000004204350000002003300039000000000053004b00000a9f0000413d000000000100041a00000779011001970000000002000411000000000021004b000016300000c13d00000006010000290000000002010433000000800100043d000000000021004b000016e70000c13d000000000001004b0000115d0000613d000900000000001d000000060100002900000000010104330000001002000039000000000302041a000000000003004b00000acb0000613d0000000906000029000000000061004b000019820000a13d0000000402000039000000000202041a00000872022001670000000304000039000000000404041a0000000004240019000000050260021000000007052000290000000005050433000000000054001a000017280000413d0000000004540019000000000034004b00000acd0000a13d00000ee90000013d00000009060000290000000502600210000000000061004b000019820000a13d00000007012000290000000001010433000a00000001001d000000000001004b000019bd0000613d000000a00120003900000000030104330000000301000039000000000101041a000c00000001001d0000001101000039000000000201041a000008300020019800000b260000613d000800000003001d000000400400043d000b00000004001d00000831010000410000000000140435000000040140003900000000030004110000000000310435000007760040009c0000077601000041000000000104401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f0000081d011001c7000000180220027000000779022001971dd21dcd0000040f0000000b0a00002900000060031002700000077603300197000000200030008c00000020040000390000000004034019000000200640019000000000056a001900000b010000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b00000afd0000c13d0000001f0740019000000b0e0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000019c50000613d0000001f01400039000000600210018f0000000001a20019000000000021004b00000000020000390000000102004039000007800010009c000000680000213d0000000100200190000000680000c13d000000400010043f000000200030008c00000fb80000413d00000000010a0433000000000001004b0000000002000039000000010200c039000000000021004b00000fb80000c13d000000000001004b0000000803000029000018b10000613d0000077901300197000b00000001001d000000000010043f0000000801000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d0000000a020000290000084f022000d1000000000101043b000000000301041a0000000002230019000000000021041b000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b000800000001001d0000000c01000029000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d0000000802000029000000a0022002100000000a03000029000000010030008c00000000030000190000083803006041000000000223019f0000000b06000029000000000262019f000000000101043b000000000021041b0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d020000390000000403000039000008390400004100000000050000190000000c070000291dd21dc80000040f000000010020019000000fb80000613d0000000c02000029000a000a0020002d0000000c0700002900000001077000390000000a0070006c00000b810000613d0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d020000390000000403000039000008390400004100000000050000190000000b06000029000c00000007001d1dd21dc80000040f000000010020019000000b6e0000c13d00000fb80000013d0000000b0000006b000019c10000613d00000003010000390000000a02000029000000000021041b0000000902000029000900010020003d000000800100043d000000090010006b00000ab30000413d0000115d0000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d000007790010009c00000fb80000213d000000000100041a00000779021001970000000001000411000000000012004b00000ea70000c13d0000081e01000041000000800010043f00000000010004100000077901100197000000840010043f0000000001000414000007760010009c0000077601008041000000c0011002100000081f011001c70000000c020000291dd21dcd0000040f000000800a00003900000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf00000bb60000613d000000000801034f000000008908043c000000000a9a043600000000005a004b00000bb20000c13d000000000006004b00000bc30000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000010a80000613d0000001f01400039000000600110018f00000080021001bf000b00000002001d000000400020043f000000200030008c00000fb80000413d000000800200043d000000000002004b0000115f0000613d000000000300041a00000821040000410000000b050000290000000000450435000007790330019700000084041001bf0000000000340435000000a40110003900000000002104350000000001000414000007760010009c0000077601008041000000c0011002100000004002500210000000000121019f0000079c011001c70000000c020000291dd21dc80000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000b0570002900000bf00000613d000000000801034f0000000b09000029000000008a08043c0000000009a90436000000000059004b00000bec0000c13d000000000006004b00000bfd0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000127f0000613d0000001f01400039000000600110018f0000000b01100029000000400010043f000000200030008c00000fb80000413d0000000b010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b00000fb80000c13d000000000001004b0000115d0000c13d0000115f0000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000210100003900000e460000013d000000840020008c00000fb80000413d0000000403100370000000000303043b000b00000003001d000007790030009c00000fb80000213d0000002403100370000000000303043b000a00000003001d000007790030009c00000fb80000213d0000004403100370000000000303043b000900000003001d0000006403100370000000000403043b000007800040009c00000fb80000213d0000002303400039000000000023004b00000fb80000813d0000000405400039000000000351034f000000000303043b000007800030009c000000680000213d0000001f0630003900000873066001970000003f0660003900000873066001970000082d0060009c000000680000213d0000008006600039000000400060043f000000800030043f00000000043400190000002404400039000000000024004b00000fb80000213d0000002002500039000000000221034f00000873043001980000001f0530018f000000a00140003900000c4e0000613d000000a006000039000000000702034f000000007807043c0000000006860436000000000016004b00000c4a0000c13d000000000005004b00000c5b0000613d000000000242034f0000000304500210000000000501043300000000054501cf000000000545022f000000000202043b0000010004400089000000000242022f00000000024201cf000000000252019f0000000000210435000000a001300039000000000001043500000000020004110000000b0020006b00000c640000613d0000001101000039000000000101041a000000ff001001900000149f0000c13d000000090000006b000011b80000613d0000000901000029000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a0000082500200198000011b80000c13d0000000001020019000000000002004b00000c920000c13d0000000301000039000000000101041a000000090010006c000011b80000a13d000c00090000002d0000000c01000029000000010110008a000c00000001001d000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000000001004b00000c7f0000613d000c00000001001d00000779011001970000000b0010006c0000124f0000c13d0000000901000029000000000010043f0000000901000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000600000001001d000000000101041a000700000001001d00000000010004110000077902100197000800000002001d0000000b0020006c00000ccd0000613d0000000702000029000000080020006b00000ccd0000613d0000000b01000029000000000010043f0000000a01000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000802000029000000000020043f000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000ff00100190000008b30000613d0000000a01000029000507790010019c000015e70000613d0000001101000039000000000201041a0000000b0000006b00000cd60000613d0000ff00002001900000166a0000c13d0000083000200198000019390000c13d0000000b0000006b00000cde0000613d0000000b01000039000000000101041a000407790010019c000019d10000c13d000000070000006b00000ce20000613d0000000601000029000000000001041b0000000b01000029000000000010043f0000000801000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000501000029000000000010043f0000000801000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a0000000102200039000000000021041b000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b000700000001001d0000000901000029000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d0000000702000029000000a00220021000000005022001af00000838022001c7000000000101043b000000000021041b0000000c01000029000008380010019800000d4e0000c13d00000009010000290000000101100039000700000001001d000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000000001004b00000d4e0000c13d0000000301000039000000000101041a000000070010006b00000d4e0000613d0000000701000029000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000c02000029000000000021041b0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d02000039000000040300003900000839040000410000000b05000029000000050600002900000009070000291dd21dc80000040f000000010020019000000fb80000613d000008320100004100000000001004430000000a0100002900000004001004430000000001000414000007760010009c0000077601008041000000c00110021000000833011001c700008002020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b000000000001004b0000115d0000613d000000400500043d00000064015000390000008002000039000a00000002001d000000000021043500000044015000390000000902000029000000000021043500000024015000390000000b0200002900000000002104350000083a0100004100000000001504350000000401500039000000080200002900000000002104350000008402500039000000800100043d000000000012043500000873041001970000001f0310018f000c00000005001d000000a402500039000000a10020008c00001aae0000413d000000000004004b00000d900000613d000000000632001900000080053001bf000000200660008a0000000007460019000000000845001900000000080804330000000000870435000000200440008c00000d8a0000c13d000000000003004b00001ac40000613d000000a004000039000000000502001900001aba0000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f000000190100003900000e460000013d0000000001000416000000000001004b00000fb80000c13d000000290100003900000e1a0000013d0000000001000416000000000001004b00000fb80000c13d000000240100003900000e1a0000013d0000000001000416000000000001004b00000fb80000c13d000000100100003900000e1a0000013d0000000001000416000000000001004b00000fb80000c13d0000001f0100003900000e1a0000013d0000000001000416000000000001004b00000fb80000c13d00000000010200191dd21ba40000040f000c00000002001d0000077901100197000000000010043f0000000a01000039000000200010043f000000400200003900000000010000191dd21db30000040f0000000c020000291dd21b2d0000040f000000000101041a000000ff001001900000000001000039000000010100c039000000400200043d0000000000120435000007760020009c0000077602008041000000400120021000000823011001c700001dd30001042e000000240020008c00000fb80000413d0000000003000416000000000003004b00000fb80000c13d0000000403100370000000000403043b000007800040009c00000fb80000213d0000002303400039000000000023004b00000fb80000813d0000000405400039000000000351034f000000000303043b000007800030009c00000fb80000213d00000024044000390000000006430019000000000026004b00000fb80000213d000000000200041a00000779062001970000000002000411000000000026004b00000e970000c13d0000001202000039000000000702041a000000010070019000000001067002700000007f0660618f0000001f0060008c00000000080000390000000108002039000000000787013f00000001007001900000018e0000c13d000000200060008c00000e040000413d000000000020043f0000001f073000390000000507700270000007870770009a000000200030008c00000786070040410000001f066000390000000506600270000007870660009a000000000067004b00000e040000813d000000000007041b0000000107700039000000000067004b00000e000000413d0000001f0030008c000011f90000a13d000000000020043f0000087306300198000013d10000c13d00000786050000410000000007000019000013db0000013d0000000001000416000000000001004b00000fb80000c13d000000190100003900000e1a0000013d0000000001000416000000000001004b00000fb80000c13d0000001a0100003900000e1a0000013d0000000001000416000000000001004b00000fb80000c13d0000002201000039000000000101041a000000800010043f0000081b0100004100001dd30001042e0000000001000416000000000001004b00000fb80000c13d000000000100041a00000779011001970000000002000411000000000021004b00000e970000c13d0000084a010000410000000000100443000000000100041000000004001004430000000001000414000007760010009c0000077601008041000000c00110021000000833011001c70000800a020000391dd21dcd0000040f000000010020019000001a070000613d000000000301043b0000000001000414000007760010009c0000077601008041000000c001100210000000000003004b000010b40000c13d0000000002000411000010b80000013d000000240020008c00000fb80000413d0000000002000416000000000002004b00000fb80000c13d0000000401100370000000000101043b000c00000001001d1dd21bd40000040f0000001c010000390000000c02000029000000000021041b000000000100001900001dd30001042e000000010320008a0000000503300270000000000431001900000020030000390000000104400039000000050600003900000080053000390000000005050433000000000051041b00000020033000390000000101100039000000000041004b00000e500000c13d000000000072004b00000e610000813d0000000302700210000000f80220018f000008720220027f000008720220016700000080033000390000000003030433000000000223016f000000000021041b000000010170021000000001011001bf000000000016041b000000c00400043d000007800040009c000000680000213d0000000601000039000000000201041a000000010020019000000001012002700000007f0110618f0000001f0010008c00000000030000390000000103002039000000000232013f00000001002001900000018e0000c13d000000200010008c00000e820000413d0000001f024000390000000502200270000007810220009a000000200040008c00000782020040410000001f011000390000000501100270000007810110009a000000000012004b00000e820000813d000000000002041b0000000102200039000000000012004b00000e7e0000413d0000001f0040008c000000060600003900000e9c0000a13d000c00000004001d000000000060043f0000000001000414000007760010009c0000077601008041000000c0011002100000077f011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d0000000c070000290000087302700198000000000101043b00000eed0000c13d000000e003000039000000060600003900000efc0000013d0000081c01000041000000000010043f000000040020043f0000081d0100004100001dd400010430000000000004004b000000000100001900000ea00000613d000000e00100043d0000000302400210000008720220027f0000087202200167000000000121016f0000000102400210000000000121019f00000f070000013d0000081c02000041000000000020043f000000040010043f0000081d0100004100001dd4000104300000086901000041000000000010043f0000082c0100004100001dd4000104300000082b01000041000000000010043f0000082c0100004100001dd4000104300000081c01000041000000000010043f000000040050043f0000081d0100004100001dd4000104300000087402200197000000a00020043f000000000001004b00000020020000390000000002006039000000200220003900000080010000391dd21bb40000040f000000400100043d000c00000001001d00000080020000391dd21b6f0000040f0000000c020000290000000001210049000007760010009c00000776010080410000006001100210000007760020009c00000776020080410000004002200210000000000121019f00001dd30001042e0000001001000039000000000101041a000000000001004b00000ede0000613d0000000402000039000000000202041a00000872022001670000000303000039000000000303041a0000000002230019000000000042001a000017280000413d0000000002420019000000000012004b00000ee90000213d0000002601000039000000000101041a000000000001004b00000fe00000613d0000002702000039000000000202041a000000000042001a000017280000413d0000000002420019000000000012004b00000fe00000a13d0000085b01000041000000000010043f0000082c0100004100001dd400010430000000010320008a000000050330027000000000033100190000002004000039000000010330003900000006060000390000000005040019000000c0044000390000000004040433000000000041041b00000020045000390000000101100039000000000031004b00000ef30000c13d000000e003500039000000000072004b00000f050000813d0000000302700210000000f80220018f000008720220027f00000872022001670000000003030433000000000223016f000000000021041b000000010170021000000001011001bf000000000016041b00000001050000390000000301000039000000000051041b00000783010000410000000c02000039000000000012041b000001f4020000390000000d01000039000000000021041b0000000e01000039000000000201041a000007780220019700000784022001c7000000000021041b0000000f01000039000000000201041a0000077802200197000000000021041b00001a0a010000390000001002000039000000000012041b0000001101000039000000000201041a000007850220019700000101022001bf000000000021041b0000001201000039000000000301041a000000010030019000000001023002700000007f0220618f0000001f0020008c00000000040000390000000104002039000000000343013f00000001003001900000018e0000c13d0000001f0020008c00000f370000a13d00000786030000410000001f022000390000000502200270000007870220009a000000000003041b0000000103300039000000000023004b00000f330000413d000000000001041b0000001301000039000000000301041a000000010030019000000001023002700000007f0220618f0000001f0020008c00000000040000390000000104002039000000000343013f00000001003001900000018e0000c13d000000200020008c00000f4f0000413d000000810020008c00000f4f0000413d0000001f022000390000000502200270000007880220009a0000078903000041000000000003041b0000000103300039000000000023004b00000f4b0000413d000000c702000039000000000021041b0000078a010000410000078b02000041000000000012041b0000078c010000410000078d02000041000000000012041b0000078e010000410000078f02000041000000000012041b00000790010000410000079102000041000000000012041b00000792010000410000001402000039000000000012041b00000793010000410000001502000039000000000012041b00000682020000390000001603000039000000000023041b0000001802000039000000000002041b0000001902000039000000000052041b00000794020000410000001a03000039000000000023041b0000001c02000039000000000012041b00000795010000410000001d02000039000000000012041b0000001e02000039000000000002041b00000796020000410000002003000039000000000023041b00000002020000390000002103000039000000000023041b00000797020000410000002203000039000000000023041b0000002402000039000000000012041b00000798010000410000002502000039000000000012041b0000002601000039000000000001041b00000799010000410000002802000039000000000012041b00000029010000390000000302000039000000000021041b0000002a01000039000000000001041b0000079a01000041000000000010043f0000000001000410000000040010043f0000079b01000041000000240010043f0000000001000414000007760010009c0000077601008041000000c0011002100000079c011001c70000079d020000411dd21dc80000040f00000060031002700000077603300197000000040030008c0000000403008039000000000000004b00000fa50000613d000000000401034f0000000005000019000000004604043c0000000000650435000000200550003a00000fa10000c13d000000000003004b00000fb20000613d0000000303300210000000000400043d00000000043401cf000000000434022f00000100033000890000000001100370000000000101043b000000000131022f00000000013101cf000000000141019f000000000010043f000000010020019000000fba0000c13d000000000100043d0000079e011001970000079a0010009c00000fba0000c13d000000000100001900001dd400010430000000240000043f1dd21b210000040f0000079f020000410000000001210436000001f4020000390000000000210435000007a0010000410000000102000039000000000012041b000000200100003900000100001004430000012000000443000007a10100004100001dd30001042e0000086d0020009c00000fd10000613d0000086e0020009c00000fd10000613d0000086f0020009c00000000010000390000000101006039000008710020009c00000001011061bf000000010110018f000000800010043f0000081b0100004100001dd30001042e000000000010043f0000000801000039000000200010043f000000400200003900000000010000191dd21db30000040f000000000101041a0000078001100197000000800010043f0000081b0100004100001dd30001042e0000002801000039000000000101041a0000000c02000039000000000302041a000000000013001a000017280000413d000000000113001a00000000054100a900000fec0000613d00000000011500d9000000000041004b000017280000c13d000a00000003001d0000000f01000039000000000101041a0000077902100198000b00000005001d000010d50000c13d0000000001000416000000000051004b000011c40000c13d0000002901000039000000000101041a000900000001001d000000000001004b000012380000c13d0000000a02000029000000000002004b0000000001000019000010070000613d0000000e01000039000000000101041a00000779001001980000000001000019000010070000613d00000000014200a900000000022100d9000000000042004b000017280000c13d0000000d02000039000000000202041a000000000002004b0000000003000019000010110000613d0000000e03000039000000000303041a00000779003001980000000003000019000014380000c13d000000000013001a000017280000413d000a00000013001e000010170000613d0000000a010000291dd21bdf0000040f0000000f01000039000000000101041a0000077902100198000013990000613d0000000a03000029000a000b00300073000013990000a13d0000000001000410000807790010019c000014110000613d000000400400043d000700000004001d00000044014000390000000a030000290000000000310435000000240140003900000008030000290000000000310435000008460100004100000000001404350000000001000411000900000001001d00000779031001970000000401400039000b00000003001d0000000000310435000007760040009c0000077601000041000000000104401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f00000847011001c71dd21dc80000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000070b00002900000007057000290000104c0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000010480000c13d000000000006004b000010590000613d000000000171034f0000000306600210000000000705043300000000076701cf000000000767022f000000000101043b0000010006600089000000000161022f00000000016101cf000000000171019f00000000001504350000000100200190000014110000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000007800010009c000000680000213d0000000100200190000000680000c13d000000400010043f000000200030008c00000fb80000413d00000000020b0433000000000002004b0000000003000039000000010300c039000000000032004b00000fb80000c13d0000000a020000290000000000210435000007760010009c000007760100804100000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000077f011001c70000800d020000390000000203000039000008480400004100000008050000291dd21dc80000040f00000001002001900000139c0000c13d00000fb80000013d00000060041002700000001f0340018f00000820024001980000108b0000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000010870000c13d0000077604400197000000000003004b000010990000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000120435000000600140021000001dd400010430000000000001004b0000000001000019000008540100c0410000085503300197000000000113019f000000000012041b000000000100001900001dd30001042e0000081c01000041000000000010043f000000040040043f0000081d0100004100001dd4000104300000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000010af0000c13d000015d10000013d0000077a011001c70000800902000039000000000400041100000000050000191dd21dc80000040f000000600310027000000776033001980000115b0000613d0000001f043000390000083b044001970000003f044000390000083c04400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000007800040009c000000680000213d0000000100600190000000680000c13d000000400040043f0000001f0430018f0000000006350436000008200530019800000000035600190000114e0000613d000000000701034f000000007807043c0000000006860436000000000036004b000010d00000c13d0000114e0000013d000000400400043d000900000004001d0000081e010000410000000000140435000000000100041100000779031001970000000401400039000700000003001d0000000000310435000007760040009c0000077601000041000000000104401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f0000081d011001c7000800000002001d1dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000090b0000290000000905700029000010fa0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000010f60000c13d000000000006004b000011070000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000011c80000613d0000001f01400039000000600110018f0000000002b10019000000000012004b00000000010000390000000101004039000600000002001d000007800020009c000000680000213d0000000100100190000000680000c13d0000000601000029000000400010043f000000200030008c00000fb80000413d00000000010b04330000000b0010006c000014420000813d0000085901000041000000000010043f0000082c0100004100001dd400010430000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b0000000a0010006c000000aa0000813d000004250000013d0000077a011001c700008009020000390000000c0400002900000000050000191dd21dc80000040f000000600310027000000776033001980000115b0000613d0000001f043000390000083b044001970000003f044000390000083c04400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000007800040009c000000680000213d0000000100600190000000680000c13d000000400040043f0000001f0430018f0000000006350436000008200530019800000000035600190000114e0000613d000000000701034f000000007807043c0000000006860436000000000036004b0000114a0000c13d000000000004004b0000115b0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f000000000013043500000001002001900000115f0000613d000000000100001900001dd30001042e0000086301000041000000000010043f0000082c0100004100001dd400010430000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b0000000a0010006c000004250000413d000005870000013d00000060041002700000001f0340018f00000820024001980000117c0000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000011780000c13d0000077604400197000000000003004b0000118a0000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000120435000000600140021000001dd4000104300000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000011930000c13d000015d10000013d000700000002001d0000082e01000041000000000010043f00000000010004100000001a0010043f0000003a0030043f0000000001000414000007760010009c0000077601008041000000c0011002100000082f011001c70000079d020000411dd21dcd0000040f0000000100200190000012050000613d0000003a0000043f000000400100043d000900000001001d0000082a0010009c000000680000213d0000001101000039000000000101041a00000009030000290000002002300039000800000002001d000000400020043f0000000000030435000000ff00100190000013ec0000c13d0000000702000029000000000002004b0000084b0000c13d0000086801000041000000000010043f0000082c0100004100001dd400010430000000000003004b0000121f0000c13d0000085301000041000000000010043f000000040020043f000000240000043f0000079c0100004100001dd4000104300000085a01000041000000000010043f0000082c0100004100001dd4000104300000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000011cf0000c13d000015d10000013d00000060041002700000001f0340018f0000082002400198000011de0000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000011da0000c13d0000077604400197000000000003004b000011ec0000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000120435000000600140021000001dd4000104301dd21b210000040f0000000b0300002900000000013104360000000c020000290000000000210435000000a001200210000000000131019f0000000102000039000000000012041b000000000100001900001dd30001042e000000000003004b0000000004000019000011ff0000613d0000002004500039000000000141034f000000000401043b0000000301300210000008720110027f0000087201100167000000000414016f0000000101300210000013e80000013d00000060041002700000001f0340018f00000820024001980000120f0000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b0000120b0000c13d0000077604400197000000000003004b0000121d0000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000120435000000600140021000001dd400010430000000c004000039000000400040043f000000800030043f000000a00010043f000000000020043f0000000201000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000800200043d0000077902200197000000a00300043d000000a003300210000000000223019f000000000101043b000000000021041b000000000100001900001dd30001042e00000000010004110000077901100197000000000010043f0000002b01000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a0000000c04000029000000000041001a000017280000413d0000000001410019000000090010006c00000ee90000213d00000ffa0000013d0000085f01000041000000000010043f0000082c0100004100001dd40001043000000874022001970000000000230435000000000001004b000000200200003900000000020060390000003f0120003900000873011001970000000004510019000000000014004b00000000010000390000000101004039000007800040009c000000680000213d0000000100100190000000680000c13d000000400040043f0000001308000039000000000708041a000000010970019000000001017002700000007f0110618f0000001f0010008c00000000060000390000000106002039000000000667013f00000001006001900000018e0000c13d0000000006140436000000000009004b000014c40000613d000000000080043f000000000001004b0000000007000019000014c90000613d0000078b0800004100000000070000190000000009760019000000000a08041a0000000000a9043500000001088000390000002007700039000000000017004b000012770000413d000014c90000013d0000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000012860000c13d000015d10000013d000000400300043d000300000003001d0000081e010000410000000000130435000000000100041100000779021001970000000401300039000200000002001d0000000000210435000007760030009c0000077601000041000000000103401900000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000081d011001c70000000a020000291dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000030b0000290000000305700029000012b00000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000012ac0000c13d000000000006004b000012bd0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000014870000613d0000001f01400039000000600110018f0000000002b10019000000000012004b00000000010000390000000101004039000100000002001d000007800020009c000000680000213d0000000100100190000000680000c13d0000000101000029000000400010043f000000200030008c00000fb80000413d00000000010b0433000000040010006c0000111b0000413d0000000001000410000007790110019700000001030000290000002402300039000000000012043500000843010000410000000000130435000000040130003900000002020000290000000000210435000007760030009c0000077601000041000000000103401900000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000079c011001c70000000a020000291dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000105700029000012f60000613d000000000801034f0000000109000029000000008a08043c0000000009a90436000000000059004b000012f20000c13d000000000006004b000013030000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000018080000613d0000001f01400039000000600110018f0000000101100029000007800010009c000000680000213d000000400010043f000000200030008c00000fb80000413d00000001010000290000000001010433000000040010006c000000ec0000813d000014830000013d000000400300043d000300000003001d0000081e010000410000000000130435000000000100041100000779021001970000000401300039000200000002001d0000000000210435000007760030009c0000077601000041000000000103401900000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000081d011001c70000000a020000291dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000030b0000290000000305700029000013370000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000013330000c13d000000000006004b000013440000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000014930000613d0000001f01400039000000600110018f0000000002b10019000000000012004b00000000010000390000000101004039000100000002001d000007800020009c000000680000213d0000000100100190000000680000c13d0000000101000029000000400010043f000000200030008c00000fb80000413d00000000010b0433000000040010006c0000111b0000413d0000000001000410000007790110019700000001030000290000002402300039000000000012043500000843010000410000000000130435000000040130003900000002020000290000000000210435000007760030009c0000077601000041000000000103401900000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000079c011001c70000000a020000291dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000001057000290000137d0000613d000000000801034f0000000109000029000000008a08043c0000000009a90436000000000059004b000013790000c13d000000000006004b0000138a0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000018140000613d0000001f01400039000000600110018f0000000101100029000007800010009c000000680000213d000000400010043f000000200030008c00000fb80000413d00000001010000290000000001010433000000040010006c000005c90000813d000014830000013d0000000001000411000900000001001d000b07790010019b0000000b01000029000000000010043f0000002b01000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000301041a0000000c02000029000000000023001a000017280000413d0000000003230019000000000031041b0000002701000039000000000301041a000000000023001a000017280000413d0000000003230019000000000031041b00000009010000291dd21c920000040f000000000100001900001dd30001042e0000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000013c10000c13d000015d10000013d0000078b0500004100000000070000190000000008470019000000000881034f000000000808043b000000000085041b00000001055000390000002007700039000000000067004b000013c80000413d000013db0000013d000007860500004100000000070000190000000008470019000000000881034f000000000808043b000000000085041b00000001055000390000002007700039000000000067004b000013d30000413d000000000036004b000013e60000813d0000000306300210000000f80660018f000008720660027f00000872066001670000000004470019000000000141034f000000000101043b000000000161016f000000000015041b00000001010000390000000104300210000000000114019f000000000012041b000000000100001900001dd30001042e0000082e01000041000000000010043f00000000010004100000001a0010043f00000000010004110000003a0010043f0000000001000414000007760010009c0000077601008041000000c0011002100000082f011001c70000079d020000411dd21dcd0000040f0000000100200190000014e10000613d0000003a0000043f0000001101000039000000000101041a000000ff00100190000011b50000613d0000082e01000041000000000010043f00000000010004100000001a0010043f00000000010004110000003a0010043f0000000001000414000007760010009c0000077601008041000000c0011002100000082f011001c70000079d020000411dd21dcd0000040f00000001002001900000166e0000613d0000003a0000043f000011b50000013d0000085c01000041000000000010043f0000082c0100004100001dd4000104300000000c01000029000000000010043f0000000a01000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b00000000020004110000077902200197000000000020043f000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000ff00100190000006b60000c13d0000086601000041000000000010043f0000082c0100004100001dd4000104300000000b0410006b000017280000413d00000000032400a900000000022300d9000000000042004b000017280000c13d000027100330011a000000000013001a000017280000413d000010130000013d0000000001000410000007790110019700000006030000290000002402300039000000000012043500000843010000410000000000130435000000040130003900000007020000290000000000210435000007760030009c0000077601000041000000000103401900000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000079c011001c700000008020000291dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000605700029000014670000613d000000000801034f0000000609000029000000008a08043c0000000009a90436000000000059004b000014630000c13d000000000006004b000014740000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000015c60000613d0000001f01400039000000600110018f0000000601100029000007800010009c000000680000213d000000400010043f000000200030008c00000fb80000413d000000060100002900000000010104330000000b0010006c0000000c0400002900000ff50000813d0000085801000041000000000010043f0000082c0100004100001dd4000104300000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000148e0000c13d000015d10000013d0000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000149a0000c13d000015d10000013d0000082e01000041000000000010043f00000000010004100000001a0010043f00000000010004110000003a0010043f0000000001000414000007760010009c0000077601008041000000c0011002100000082f011001c70000079d020000411dd21dcd0000040f0000000100200190000015eb0000613d0000003a0000043f0000001101000039000000000101041a000000ff0010019000000c640000613d0000082e01000041000000000010043f00000000010004100000001a0010043f00000000010004110000003a0010043f0000000001000414000007760010009c0000077601008041000000c0011002100000082f011001c70000079d020000411dd21dcd0000040f0000000100200190000017ee0000613d0000003a0000043f00000c640000013d00000874077001970000000000760435000000000001004b000000200700003900000000070060390000003f0170003900000873061001970000000001460019000000000061004b00000000060000390000000106004039000007800010009c000000680000213d0000000100600190000000680000c13d000000400010043f0000000006050433000000000006004b000016050000c13d0000000002040433000000000002004b000016880000c13d0000082a0010009c000000680000213d0000002002100039000000400020043f0000000000010435000000400300043d000016e20000013d00000060041002700000001f0340018f0000082002400198000014eb0000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000014e70000c13d0000077604400197000000000003004b000014f90000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000120435000000600140021000001dd400010430000000400100043d00000014020000390000000002210436000000000300041100000060033002100000000000320435000008440010009c000000680000213d0000004003100039000000400030043f000007760020009c000007760200804100000040022002100000000001010433000007760010009c00000776010080410000006001100210000000000121019f0000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000077a011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000b020000290000003f022000390000084502200197000000400300043d0000000002230019000b00000003001d000000000032004b00000000030000390000000103004039000007800020009c000000680000213d0000000100300190000000680000c13d000000400020043f0000000c020000290000000b040000290000000002240436000a00000002001d0000000802000029000000000020007c00000fb80000213d0000000c0000006b0000155c0000613d0000000902000029000000200220003900000001022003670000000b03000029000000070500002900000008060000290000002003300039000000002402043c00000000004304350000002005500039000000000065004b000015350000413d0000000b020000290000000002020433000000000002004b0000155c0000613d0000000003000019000c00000003001d00000005023002100000000a022000290000000002020433000000000021004b0000154a0000813d000000000010043f000000200020043f00000000010004140000154d0000013d000000000020043f000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000c0300002900000001033000390000000b020000290000000002020433000000000023004b000015400000413d000000030010006c000000f10000613d000015c20000013d000000400100043d00000014020000390000000002210436000000000300041100000060033002100000000000320435000008440010009c000000680000213d0000004003100039000000400030043f000007760020009c000007760200804100000040022002100000000001010433000007760010009c00000776010080410000006001100210000000000121019f0000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000077a011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000b020000290000003f022000390000084502200197000000400300043d0000000002230019000b00000003001d000000000032004b00000000030000390000000103004039000007800020009c000000680000213d0000000100300190000000680000c13d000000400020043f0000000c020000290000000b040000290000000002240436000a00000002001d0000000802000029000000000020007c00000fb80000213d0000000c0000006b000015c00000613d0000000902000029000000200220003900000001022003670000000b03000029000000070500002900000008060000290000002003300039000000002402043c00000000004304350000002005500039000000000065004b000015990000413d0000000b020000290000000002020433000000000002004b000015c00000613d0000000003000019000c00000003001d00000005023002100000000a022000290000000002020433000000000021004b000015ae0000813d000000000010043f000000200020043f0000000001000414000015b10000013d000000000020043f000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000c0300002900000001033000390000000b020000290000000002020433000000000023004b000015a40000413d000000030010006c000005ce0000613d0000084901000041000000000010043f0000082c0100004100001dd4000104300000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000015cd0000c13d000000000005004b000015de0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000007760020009c00000776020080410000004002200210000000000112019f00001dd4000104300000000a01000029000307790010019c000016640000c13d0000086201000041000000000010043f0000082c0100004100001dd40001043000000060041002700000001f0340018f0000082002400198000015f50000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000015f10000c13d0000077604400197000000000003004b000016030000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000120435000000600140021000001dd400010430000000a004100039000000400040043f000000800410003900000000000404350000000c090000290000000006040019000000090090008c0000000a4990011a000000f807400210000000010460008a00000000080404330000082608800197000000000787019f00000827077001c700000000007404350000160a0000213d00000000016100490000008101100039000000210660008a0000000000160435000000000505043300000873095001970000001f0850018f000000400100043d0000002007100039000000000073004b0000168b0000813d000000000009004b0000162c0000613d000000000b830019000000000a870019000000200aa0008a000000200bb0008a000000000c9a0019000000000d9b0019000000000d0d04330000000000dc0435000000200990008c000016260000c13d000000000008004b000016a10000613d000000000a070019000016970000013d0000081c01000041000000000010043f0000000001000411000000040010043f0000081d0100004100001dd40001043000000000010004110000077901100197000000000010043f0000001b01000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a0000000603000029000000000031001a000017280000413d00000000013100190000000c0010006c000000f70000a13d00000ee90000013d00000000010004110000077901100197000000000010043f0000002301000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a0000000603000029000000000031001a000017280000413d00000000013100190000000c0010006c000005d40000a13d00000ee90000013d0000001101000039000000000201041a0000000b0000006b0000172e0000613d0000ff00002001900000172e0000613d0000086501000041000000000010043f0000082c0100004100001dd40001043000000060041002700000001f0340018f0000082002400198000016780000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000016740000c13d0000077604400197000000000003004b000016860000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000120435000000600140021000001dd40001043000000000030100190000000001040019000016e20000013d000000000a970019000000000009004b000016940000613d000000000b030019000000000c07001900000000bd0b0434000000000cdc04360000000000ac004b000016900000c13d000000000008004b000016a10000613d0000000003930019000000030880021000000000090a043300000000098901cf000000000989022f00000000030304330000010008800089000000000383022f00000000038301cf000000000393019f00000000003a0435000000000575001900000828030000410000000000350435000000000306043300000873073001970000001f0630018f0000000105500039000000000054004b000016ba0000813d000000000007004b000016b60000613d00000000096400190000000008650019000000200880008a000000200990008a000000000a780019000000000b790019000000000b0b04330000000000ba0435000000200770008c000016b00000c13d000000000006004b000016d00000613d0000000008050019000016c60000013d0000000008750019000000000007004b000016c30000613d0000000009040019000000000a050019000000009b090434000000000aba043600000000008a004b000016bf0000c13d000000000006004b000016d00000613d00000000047400190000000306600210000000000708043300000000076701cf000000000767022f00000000040404330000010006600089000000000464022f00000000046401cf000000000474019f000000000048043500000000035300190000082904000041000000000043043500000000031300490000001b0430008a0000000000410435000000240330003900000873023001970000000004120019000000000024004b00000000020000390000000102004039000007800040009c000000680000213d0000000100200190000000680000c13d0000000003040019000000400040043f0000002002000039000c00000003001d00000000022304361dd21b3d0000040f00000ec50000013d0000084d01000041000000000010043f0000082c0100004100001dd4000104300000000001000411000a00000001001d000c07790010019b0000000c01000029000000000010043f0000001b01000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000301041a0000000602000029000000000023001a000017280000413d0000000003230019000000000031041b0000001701000039000000000301041a000000000023001a000017280000413d000017220000013d0000000001000411000a00000001001d000c07790010019b0000000c01000029000000000010043f0000002301000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000301041a0000000602000029000000000023001a000017280000413d0000000003230019000000000031041b0000001f01000039000000000301041a000000000023001a000017280000413d0000000003230019000000000031041b0000000a010000291dd21c920000040f000000000100001900001dd30001042e0000084e01000041000000000010043f0000001101000039000000040010043f0000081d0100004100001dd4000104300000083000200198000018690000c13d0000000b0000006b000017360000613d0000000b01000039000000000101041a000207790010019c000019030000c13d000000050000006b0000173a0000613d0000000401000029000000000001041b0000000b01000029000000000010043f0000000801000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000301000029000000000010043f0000000801000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000201041a0000000102200039000000000021041b000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b000500000001001d0000000701000029000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d0000000502000029000000a00220021000000003022001af00000838022001c7000000000101043b000000000021041b0000000c010000290000083800100198000017a60000c13d00000007010000290000000101100039000500000001001d000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b000000000101041a000000000001004b000017a60000c13d0000000301000039000000000101041a000000050010006b000017a60000613d0000000501000029000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000000fb80000613d000000000101043b0000000c02000029000000000021041b0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d02000039000000040300003900000839040000410000000b05000029000000030600002900000007070000291dd21dc80000040f000000010020019000000fb80000613d000008320100004100000000001004430000000a0100002900000004001004430000000001000414000007760010009c0000077601008041000000c00110021000000833011001c700008002020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b000000000001004b0000115d0000613d000000400300043d00000064013000390000008002000039000a00000002001d000000000021043500000044013000390000000702000029000000000021043500000024013000390000000b0200002900000000002104350000083a010000410000000000130435000000040130003900000006020000290000000000210435000000090100002900000000010104330000008402300039000000000012043500000873051001970000001f0410018f000c00000003001d000000a403300039000000080030006b00001a080000813d000000000005004b000017ea0000613d00000008074000290000000006430019000000200660008a000000200770008a0000000008560019000000000957001900000000090904330000000000980435000000200550008c000017e40000c13d000000000004004b00001a1f0000613d000000000603001900001a140000013d00000060041002700000001f0340018f0000082002400198000017f80000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000017f40000c13d0000077604400197000000000003004b000018060000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f0000000000120435000000600140021000001dd4000104300000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000180f0000c13d000015d10000013d0000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000181b0000c13d000015d10000013d000000400400043d000500000004001d00000831010000410000000000140435000000040140003900000008030000290000000000310435000007760040009c0000077601000041000000000104401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f0000081d011001c7000000180220027000000779022001971dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000050b0000290000000505700029000018440000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000018400000c13d000000000006004b000018510000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000018b50000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000007800010009c000000680000213d0000000100200190000000680000c13d000000400010043f000000200030008c00000fb80000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b00000fb80000c13d000000000001004b0000035b0000c13d000018b10000013d000000400400043d000200000004001d00000831010000410000000000140435000000040140003900000006030000290000000000310435000007760040009c0000077601000041000000000104401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f0000081d011001c7000000180220027000000779022001971dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000020b00002900000002057000290000188d0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000018890000c13d000000000006004b0000189a0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000018c10000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000007800010009c000000680000213d0000000100200190000000680000c13d000000400010043f000000200030008c00000fb80000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b00000fb80000c13d000000000001004b000017300000c13d0000086101000041000000000010043f0000082c0100004100001dd4000104300000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000018bc0000c13d000015d10000013d0000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000018c80000c13d000015d10000013d00000832010000410000000000100443000000050100002900000004001004430000000001000414000007760010009c0000077601008041000000c00110021000000833011001c700008002020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b000000000001004b00000fb80000613d000000400300043d00000064013000390000000902000029000000000021043500000044013000390000000a02000029000000000021043500000024013000390000000b02000029000000000021043500000834010000410000000000130435000000040130003900000008020000290000000000210435000007760030009c000800000003001d0000077601000041000000000103401900000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f00000835011001c700000005020000291dd21dcd0000040f0000000100200190000019880000613d0000000801000029000007800010009c000000680000213d0000000801000029000000400010043f000000070000006b000003630000c13d000003650000013d00000832010000410000000000100443000000020100002900000004001004430000000001000414000007760010009c0000077601008041000000c00110021000000833011001c700008002020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b000000000001004b00000fb80000613d000000400300043d00000064013000390000000702000029000000000021043500000044013000390000000302000029000000000021043500000024013000390000000b02000029000000000021043500000834010000410000000000130435000000040130003900000006020000290000000000210435000007760030009c000100000003001d0000077601000041000000000103401900000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f00000835011001c700000002020000291dd21dcd0000040f0000000100200190000019a10000613d0000000101000029000007800010009c000000680000213d0000000101000029000000400010043f000000050000006b000017380000c13d0000173a0000013d000000400400043d000400000004001d00000831010000410000000000140435000000040140003900000008030000290000000000310435000007760040009c0000077601000041000000000104401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f0000081d011001c7000000180220027000000779022001971dd21dcd0000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000040b00002900000004057000290000195d0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000019590000c13d000000000006004b0000196a0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000019950000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000007800010009c000000680000213d0000000100200190000000680000c13d000000400010043f000000200030008c00000fb80000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b00000fb80000c13d000000000001004b00000cd80000c13d000018b10000013d0000084e01000041000000000010043f0000003201000039000000040010043f0000081d0100004100001dd40001043000000060061002700000001f0460018f0000082005600198000000400200043d0000000003520019000019ad0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000019900000c13d000019ad0000013d0000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000199c0000c13d000015d10000013d00000060061002700000001f0460018f0000082005600198000000400200043d0000000003520019000019ad0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000019a90000c13d0000077606600197000000000004004b000019bb0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000006001600210000015df0000013d0000085101000041000000000010043f0000082c0100004100001dd4000104300000085001000041000000000010043f0000082c0100004100001dd4000104300000001f0530018f0000082006300198000000400200043d0000000004620019000015d10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000019cc0000c13d000015d10000013d00000832010000410000000000100443000000040100002900000004001004430000000001000414000007760010009c0000077601008041000000c00110021000000833011001c700008002020000391dd21dcd0000040f000000010020019000001a070000613d000000000101043b000000000001004b00000fb80000613d000000400300043d00000064013000390000000902000029000000000021043500000044013000390000000502000029000000000021043500000024013000390000000b02000029000000000021043500000834010000410000000000130435000000040130003900000008020000290000000000210435000007760030009c000300000003001d0000077601000041000000000103401900000040011002100000000002000414000007760020009c0000077602008041000000c002200210000000000112019f00000835011001c700000004020000291dd21dcd0000040f000000010020019000001a6a0000613d0000000301000029000007800010009c000000680000213d0000000301000029000000400010043f000000070000006b00000ce00000c13d00000ce20000013d000000000001042f0000000006530019000000000005004b00001a110000613d0000000807000029000000000803001900000000790704340000000008980436000000000068004b00001a0d0000c13d000000000004004b00001a1f0000613d000800080050002d0000000304400210000000000506043300000000054501cf000000000545022f000000080700002900000000070704330000010004400089000000000747022f00000000044701cf000000000454019f00000000004604350000001f04100039000008730240019700000000013100190000000000010435000000a401200039000007760010009c000007760100804100000060011002100000000c02000029000007760020009c00000776020080410000004002200210000000000121019f0000000002000414000007760020009c0000077602008041000000c002200210000000000121019f00000003020000291dd21dc80000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000c0570002900001a420000613d000000000801034f0000000c09000029000000008a08043c0000000009a90436000000000059004b00001a3e0000c13d000000000006004b00001a4f0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000010020019000001a660000613d0000001f01400039000000600210018f0000000c01200029000000000021004b00000000020000390000000102004039000007800010009c000000680000213d0000000100200190000000680000c13d000000400010043f000000200030008c00000fb80000413d0000000c0100002900000000010104330000083d0010019800000fb80000c13d0000079e011001970000083a0010009c0000115d0000613d00001aa10000013d000000000003004b00001a770000c13d000000600200003900001a9e0000013d00000060061002700000001f0460018f0000082005600198000000400200043d0000000003520019000019ad0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b00001a720000c13d000019ad0000013d0000001f023000390000083b022001970000003f022000390000083c04200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000007800040009c000000680000213d0000000100500190000000680000c13d000000400040043f0000001f0430018f00000000063204360000082005300198000a00000006001d000000000356001900001a910000613d000000000601034f0000000a07000029000000006806043c0000000007870436000000000037004b00001a8d0000c13d000000000004004b00001a9e0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b00001aa50000c13d0000085d01000041000000000010043f0000082c0100004100001dd4000104300000000a02000029000007760020009c00000776020080410000004002200210000007760010009c00000776010080410000006001100210000000000121019f00001dd4000104300000000005420019000000000004004b00001ab70000613d000000a006000039000000000702001900000000680604340000000007870436000000000057004b00001ab30000c13d000000000003004b00001ac40000613d000000a0044000390000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f00000000003504350000001f03100039000008730330019700000000012100190000000000010435000000a401300039000007760010009c000007760100804100000060011002100000000c02000029000007760020009c00000776020080410000004002200210000000000121019f0000000002000414000007760020009c0000077602008041000000c002200210000000000121019f00000005020000291dd21dc80000040f00000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000c0570002900001ae70000613d000000000801034f0000000c09000029000000008a08043c0000000009a90436000000000059004b00001ae30000c13d000000000006004b00001af40000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000010020019000001b040000613d0000001f01400039000000600210018f0000000c01200029000000000021004b00000000020000390000000102004039000007800010009c000000680000213d0000000100200190000000680000c13d000000400010043f000000200030008c00001a5e0000813d00000fb80000013d000000000003004b00001a680000613d0000001f023000390000083b022001970000003f022000390000083c04200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000007800040009c000000680000213d0000000100500190000000680000c13d000000400040043f0000001f0430018f00000000063204360000082005300198000a00000006001d000000000356001900001a910000613d000000000601034f0000000a07000029000000006806043c0000000007870436000000000037004b00001b1c0000c13d00001a910000013d000000400100043d000008760010009c00001b270000813d0000004002100039000000400020043f000000000001042d0000084e01000041000000000010043f0000004101000039000000040010043f0000081d0100004100001dd4000104300000077902200197000000000020043f000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000001b3b0000613d000000000101043b000000000001042d000000000100001900001dd4000104300000000043010434000000000132043600000873063001970000001f0530018f000000000014004b00001b530000813d000000000006004b00001b4f0000613d00000000085400190000000007510019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c00001b490000c13d000000000005004b00001b690000613d000000000701001900001b5f0000013d0000000007610019000000000006004b00001b5c0000613d00000000080400190000000009010019000000008a0804340000000009a90436000000000079004b00001b580000c13d000000000005004b00001b690000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f0000000000470435000000000431001900000000000404350000001f0330003900000873023001970000000001210019000000000001042d000000200300003900000000033104360000000042020434000000000023043500000873062001970000001f0520018f0000004001100039000000000014004b00001b880000813d000000000006004b00001b840000613d00000000085400190000000007510019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c00001b7e0000c13d000000000005004b00001b9e0000613d000000000701001900001b940000013d0000000007610019000000000006004b00001b910000613d00000000080400190000000009010019000000008a0804340000000009a90436000000000079004b00001b8d0000c13d000000000005004b00001b9e0000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f0000000000470435000000000412001900000000000404350000001f0220003900000873022001970000000001120019000000000001042d000008770010009c00001bb20000213d000000430010008c00001bb20000a13d00000001020003670000000401200370000000000101043b000007790010009c00001bb20000213d0000002402200370000000000202043b000007790020009c00001bb20000213d000000000001042d000000000100001900001dd4000104300000001f0220003900000873022001970000000001120019000000000021004b00000000020000390000000102004039000007800010009c00001bc00000213d000000010020019000001bc00000c13d000000400010043f000000000001042d0000084e01000041000000000010043f0000004101000039000000040010043f0000081d0100004100001dd400010430000000000301001900000000011200a9000000000003004b00001bcd0000613d00000000033100d9000000000023004b00001bce0000c13d000000000001042d0000084e01000041000000000010043f0000001101000039000000040010043f0000081d0100004100001dd400010430000000000100041a00000779021001970000000001000411000000000012004b00001bda0000c13d000000000001042d0000081c02000041000000000020043f000000040010043f0000081d0100004100001dd4000104300002000000000002000000000001004b00001c800000613d00000000030100190000000e01000039000000000101041a000007790410019800001c840000613d0000000f01000039000000000101041a0000077902100198000200000003001d00001c360000613d000000400500043d000100000005001d0000004401500039000000000031043500000024015000390000000000410435000008460100004100000000001504350000000001000411000007790110019700000004035000390000000000130435000007760050009c0000077601000041000000000105401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f00000847011001c71dd21dc80000040f000000010b00002900000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900001c130000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00001c0f0000c13d000000000006004b00001c200000613d000000000171034f0000000306600210000000000705043300000000076701cf000000000767022f000000000101043b0000010006600089000000000161022f00000000016101cf000000000171019f0000000000150435000000010020019000001c880000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000007800010009c00001c8c0000213d000000010020019000001c8c0000c13d000000400010043f0000001f0030008c00001c7e0000a13d00000000020b0433000000000002004b0000000003000039000000010300c039000000000032004b00001c690000613d00001c7e0000013d0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c7000080090200003900000000050000191dd21dc80000040f0000006003100270000007760330019800001c660000613d0000001f043000390000083b044001970000003f044000390000083c04400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000007800040009c00001c8c0000213d000000010060019000001c8c0000c13d000000400040043f0000001f0430018f00000000063504360000082005300198000000000356001900001c590000613d000000000701034f000000007807043c0000000006860436000000000036004b00001c550000c13d000000000004004b00001c660000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000000010020019000001c880000613d000000400100043d0000000e02000039000000000202041a00000002030000290000000000310435000007760010009c000007760100804100000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f0000077f011001c700000779052001970000800d02000039000000020300003900000879040000411dd21dc80000040f000000010020019000001c7e0000613d000000000001042d000000000100001900001dd4000104300000087b01000041000000000010043f0000082c0100004100001dd4000104300000087a01000041000000000010043f0000082c0100004100001dd4000104300000087801000041000000000010043f0000082c0100004100001dd4000104300000084e01000041000000000010043f0000004101000039000000040010043f0000081d0100004100001dd4000104300004000000000002000200000002001d000000000002004b00001d4c0000613d00000000030100190000000301000039000000000101041a000400000001001d0000001101000039000000000201041a000008300020019800001ce90000613d000100000003001d000000400400043d000300000004001d000008310100004100000000001404350000000001000411000007790110019700000004034000390000000000130435000007760040009c0000077601000041000000000104401900000040011002100000000003000414000007760030009c0000077603008041000000c003300210000000000113019f0000081d011001c7000000180220027000000779022001971dd21dcd0000040f000000030b00002900000060031002700000077603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900001cc40000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00001cc00000c13d000000000006004b00001cd10000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000010020019000001d550000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000007800010009c00001d730000213d000000010020019000001d730000c13d000000400010043f0000001f0030008c00001d440000a13d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b00001d440000c13d000000000001004b000000010300002900001d790000613d0000077901300197000300000001001d000000000010043f0000000801000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000001d440000613d00000002020000290000084f022000d1000000000101043b000000000301041a0000000002230019000000000021041b000008360100004100000000001004430000000001000414000007760010009c0000077601008041000000c00110021000000837011001c70000800b020000391dd21dcd0000040f000000010020019000001d500000613d000000000101043b000100000001001d0000000401000029000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000001d440000613d0000000102000029000000a0022002100000000203000029000000010030008c00000000030000190000083803006041000000000223019f0000000306000029000000000262019f000000000101043b000000000021041b0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d0200003900000004030000390000083904000041000000000500001900000004070000291dd21dc80000040f0000000407000029000000010020019000001d440000613d000200020070002d0000000107700039000000020070006c00001d460000613d0000000001000414000007760010009c0000077601008041000000c0011002100000077a011001c70000800d020000390000000403000039000008390400004100000000050000190000000306000029000400000007001d00000004070000291dd21dc80000040f0000000407000029000000010020019000001d310000c13d000000000100001900001dd400010430000000030000006b00001d510000613d00000003010000390000000202000029000000000021041b000000000001042d0000085101000041000000000010043f0000082c0100004100001dd400010430000000000001042f0000085001000041000000000010043f0000082c0100004100001dd4000104300000001f0530018f0000082006300198000000400200043d000000000462001900001d600000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00001d5c0000c13d000000000005004b00001d6d0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000007760020009c00000776020080410000004002200210000000000112019f00001dd4000104300000084e01000041000000000010043f0000004101000039000000040010043f0000081d0100004100001dd4000104300000086101000041000000000010043f0000082c0100004100001dd4000104300001000000000002000000000001004b00001dae0000613d000100000001001d000000000010043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000001dac0000613d000000000101043b000000000101041a0000082500100198000000010200002900001dae0000c13d000000000001004b00001dab0000c13d0000000301000039000000000101041a000000000021004b00001dae0000a13d000000010220008a000100000002001d000000000020043f0000000701000039000000200010043f0000000001000414000007760010009c0000077601008041000000c00110021000000824011001c700008010020000391dd21dcd0000040f000000010020019000001dac0000613d000000000101043b000000000101041a000000000001004b000000010200002900001d980000613d000000000001042d000000000100001900001dd4000104300000086801000041000000000010043f0000082c0100004100001dd400010430000000000001042f000007760010009c00000776010080410000004001100210000007760020009c00000776020080410000006002200210000000000112019f0000000002000414000007760020009c0000077602008041000000c002200210000000000112019f0000077a011001c700008010020000391dd21dcd0000040f000000010020019000001dc60000613d000000000101043b000000000001042d000000000100001900001dd40001043000001dcb002104210000000102000039000000000001042d0000000002000019000000000001042d00001dd0002104230000000102000039000000000001042d0000000002000019000000000001042d00001dd20000043200001dd30001042e00001dd40001043000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff4255554d45450000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff02000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e00000000000000000000000000000000000000000000000010000000000000000fc949c7b4a13586e39d89eead2f38644f9fb3efb5a0490b14f8fc0ceab44c250036b6384b5eca791c62761152d0c79bb0604c104a5fb6f4eb0703f3154bb3db00200000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff09addddcec1d7ba6ad726df49aeea3e93fb0c1037d551236841a60c0c883f2c1f652222313e28459528d920b65115c16c04f3efc82aaedc97be59f3f377c0d3f0000000000000000000000000000000000000000000000000000f04a5d9a79b3000000000000000000000000bdb9e0b47a02c45e3b50973a18452dc23ce72697ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000bb8a6a4669ba250d26cd7a459eca9d215f8307e33aebe50379bc5a3617ec3444447595b99645daf2d93285ba613562dea07cf81cc5141afc8643a5c9e813cbbc9921700258681c2163fa1703a84c40f13d756cf2bf4f2d7a26c3f9afe3095f7066de8ffda797e3de9c05e8fc57b3bf0ec28a930d40b0d285d93c06501cf6a09468747470733a2f2f6d696e746966792d6c61756e63687061642e6e7963332e6366de8ffda797e3de9c05e8fc57b3bf0ec28a930d40b0d285d93c06501cf6a090646e2e6469676974616c6f6365616e7370616365732e636f6d2f63653062613566de8ffda797e3de9c05e8fc57b3bf0ec28a930d40b0d285d93c06501cf6a09135302d623039302d343962322d383434322d3462346535333434343033342e7766de8ffda797e3de9c05e8fc57b3bf0ec28a930d40b0d285d93c06501cf6a092656270000000000000000000000000000000000000000000000000000000000066de8ffda797e3de9c05e8fc57b3bf0ec28a930d40b0d285d93c06501cf6a09300000000000000000000000000000000000000000000000000000000688b930000000000000000000000000000000000000000000000000000000000688ba110a3989683746723c11deebe37190a19d17c273f85514ab5c466eb22180191516c00000000000000000000000000000000000000000000000000000000688baf200000000000000000000000000000000000000000000000000011c37937e08000d7354fd5390baf5bc058d95fc5392d45e0b2677bdb1a330d48d94ead698bde7300000000000000000000000000000000000000000000000000000000688e52200000000000000000000000000000000000000000000000000017aeb11212a0007d3e3dbe000000000000000000000000000000000000000000000000000000000000000000000000000000003cc6cdda760b79bafa08df41ecfa224f810dceb60000000000000000000000000000000000000044000000000000000000000000000000000000000000000000000000000000aaeb6d7670e522a718067333cd4effffffff0000000000000000000000000000000000000000000000000000000000000000000000000000000070ecd15a0d733ed98380534f3ed33558cf52969d0000000000000000000001f470ecd15a0d733ed98380534f3ed33558cf52969d0000000200000000000000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000006f8b44af00000000000000000000000000000000000000000000000000000000aa60bdcf00000000000000000000000000000000000000000000000000000000d5abeb0000000000000000000000000000000000000000000000000000000000e985e9c400000000000000000000000000000000000000000000000000000000f3f119f000000000000000000000000000000000000000000000000000000000f3f119f100000000000000000000000000000000000000000000000000000000f4f3b20000000000000000000000000000000000000000000000000000000000fb796e6c00000000000000000000000000000000000000000000000000000000e985e9c500000000000000000000000000000000000000000000000000000000ed9aab5100000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000e56e9abf00000000000000000000000000000000000000000000000000000000e56e9ac000000000000000000000000000000000000000000000000000000000e5a6b10f00000000000000000000000000000000000000000000000000000000e5e2a0f600000000000000000000000000000000000000000000000000000000d5abeb0100000000000000000000000000000000000000000000000000000000e079e46100000000000000000000000000000000000000000000000000000000e1136b3d00000000000000000000000000000000000000000000000000000000b88d4fdd00000000000000000000000000000000000000000000000000000000cafd705e00000000000000000000000000000000000000000000000000000000cafd705f00000000000000000000000000000000000000000000000000000000d1c026c900000000000000000000000000000000000000000000000000000000d2762b4600000000000000000000000000000000000000000000000000000000b88d4fde00000000000000000000000000000000000000000000000000000000c3d923a600000000000000000000000000000000000000000000000000000000c87b56dd00000000000000000000000000000000000000000000000000000000abd017e900000000000000000000000000000000000000000000000000000000abd017ea00000000000000000000000000000000000000000000000000000000ac19701b00000000000000000000000000000000000000000000000000000000b7c0b8e800000000000000000000000000000000000000000000000000000000aa60bdd000000000000000000000000000000000000000000000000000000000ab7b4993000000000000000000000000000000000000000000000000000000008da5cb5a000000000000000000000000000000000000000000000000000000009e5f94a600000000000000000000000000000000000000000000000000000000a70138c000000000000000000000000000000000000000000000000000000000a70138c100000000000000000000000000000000000000000000000000000000a9fc664e00000000000000000000000000000000000000000000000000000000aa0678ff000000000000000000000000000000000000000000000000000000009e5f94a700000000000000000000000000000000000000000000000000000000a22cb46500000000000000000000000000000000000000000000000000000000a42c05ba0000000000000000000000000000000000000000000000000000000095d89b400000000000000000000000000000000000000000000000000000000095d89b410000000000000000000000000000000000000000000000000000000096ce3bfa0000000000000000000000000000000000000000000000000000000096db3e89000000000000000000000000000000000000000000000000000000008da5cb5b000000000000000000000000000000000000000000000000000000008e9a85f30000000000000000000000000000000000000000000000000000000076ee0152000000000000000000000000000000000000000000000000000000007f371a9f000000000000000000000000000000000000000000000000000000007f371aa000000000000000000000000000000000000000000000000000000000858633f200000000000000000000000000000000000000000000000000000000871215d40000000000000000000000000000000000000000000000000000000076ee01530000000000000000000000000000000000000000000000000000000079544c86000000000000000000000000000000000000000000000000000000007d4b5a2100000000000000000000000000000000000000000000000000000000715018a500000000000000000000000000000000000000000000000000000000715018a60000000000000000000000000000000000000000000000000000000071be5e140000000000000000000000000000000000000000000000000000000072b0d90c000000000000000000000000000000000000000000000000000000006f8b44b00000000000000000000000000000000000000000000000000000000070a08231000000000000000000000000000000000000000000000000000000003ccfd60a0000000000000000000000000000000000000000000000000000000054389436000000000000000000000000000000000000000000000000000000005c1afeca0000000000000000000000000000000000000000000000000000000064f52a1e0000000000000000000000000000000000000000000000000000000064f52a1f0000000000000000000000000000000000000000000000000000000065216a4100000000000000000000000000000000000000000000000000000000691ce970000000000000000000000000000000000000000000000000000000005c1afecb000000000000000000000000000000000000000000000000000000005d99a0cf000000000000000000000000000000000000000000000000000000006352211e0000000000000000000000000000000000000000000000000000000055f804b20000000000000000000000000000000000000000000000000000000055f804b3000000000000000000000000000000000000000000000000000000005944c7530000000000000000000000000000000000000000000000000000000059a2f3bd000000000000000000000000000000000000000000000000000000005438943700000000000000000000000000000000000000000000000000000000545b70b20000000000000000000000000000000000000000000000000000000055f5f06600000000000000000000000000000000000000000000000000000000462fed13000000000000000000000000000000000000000000000000000000004b21839d000000000000000000000000000000000000000000000000000000004b21839e000000000000000000000000000000000000000000000000000000004ed69eaf000000000000000000000000000000000000000000000000000000004f115db100000000000000000000000000000000000000000000000000000000462fed140000000000000000000000000000000000000000000000000000000046fff98d00000000000000000000000000000000000000000000000000000000484b973c0000000000000000000000000000000000000000000000000000000041d94c970000000000000000000000000000000000000000000000000000000041d94c980000000000000000000000000000000000000000000000000000000042842e0e0000000000000000000000000000000000000000000000000000000042b5e15c000000000000000000000000000000000000000000000000000000003ccfd60b00000000000000000000000000000000000000000000000000000000406466a70000000000000000000000000000000000000000000000000000000012b3650f00000000000000000000000000000000000000000000000000000000251c21eb0000000000000000000000000000000000000000000000000000000030db1d5a0000000000000000000000000000000000000000000000000000000030db1d5b000000000000000000000000000000000000000000000000000000003bf30394000000000000000000000000000000000000000000000000000000003c6d576200000000000000000000000000000000000000000000000000000000251c21ec000000000000000000000000000000000000000000000000000000002a55205a0000000000000000000000000000000000000000000000000000000030a0896500000000000000000000000000000000000000000000000000000000189ce8b000000000000000000000000000000000000000000000000000000000189ce8b10000000000000000000000000000000000000000000000000000000021b8acd70000000000000000000000000000000000000000000000000000000023b872dd0000000000000000000000000000000000000000000000000000000012b365100000000000000000000000000000000000000000000000000000000018160ddd00000000000000000000000000000000000000000000000000000000081812fb000000000000000000000000000000000000000000000000000000000c92b630000000000000000000000000000000000000000000000000000000000c92b631000000000000000000000000000000000000000000000000000000000d4c1828000000000000000000000000000000000000000000000000000000000d705df600000000000000000000000000000000000000000000000000000000081812fc00000000000000000000000000000000000000000000000000000000095ea7b300000000000000000000000000000000000000000000000000000000098144d40000000000000000000000000000000000000000000000000000000004634d8c0000000000000000000000000000000000000000000000000000000004634d8d0000000000000000000000000000000000000000000000000000000006fdde03000000000000000000000000000000000000000000000000000000000759f2d8000000000000000000000000000000000000000000000000000000000141a4490000000000000000000000000000000000000000000000000000000001ffc9a70000000000000000000000000000000000000020000000800000000000000000118cdaa700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002400000000000000000000000070a0823100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002400000080000000000000000000000000000000000000000000000000000000000000000000000000ffffffe0a9059cbb000000000000000000000000000000000000000000000000000000001e4fbdf70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000200000000000000000000000000000000000040000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff30000000000000000000000000000000000000000000000000000000000000002f000000000000000000000000000000000000000000000000000000000000002e6a736f6e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffdfa14c4b50000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff7f00000000000000000000000000000000000000000000c617113400112233445500000000000000000000000000000000000000440000001600000000000000000000000000000000000000000000000000000000000000000000000000ff0000e18bc08a000000000000000000000000000000000000000000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000caee23ea000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084000000000000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d9553913202000002000000000000000000000000000000040000000000000000000000000000000200000000000000000000000000000000000000000000000000000000ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef150b7a020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000003ffffffe000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000ffffffffffffffffffffffffffffffffffffffff000000ffffffffffffffffff0000000000000000000000000000000000000000ffffff0200000000000000000000000000000000000040000000800000000000000000cc5dc080ff977b3c3a211fa63ab74f90f658f5ba9d3236e92c8f59570f442aac17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31dd62ed3e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffbf7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe023b872dd0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000640000000000000000000000005bfd86dd1dfba5846abf8c8ff49e529e997ac11be6a5ad81501ef4418f359689b05e92fa000000000000000000000000000000000000000000000000000000009cc7f708afc65944829bd487b90b72536b1951864fbfc14e125fc972a6507f398f4eb604000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000fc4c6036000000000000000000000000000000000000000000000000000000004e487b710000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000012e07630000000000000000000000000000000000000000000000000000000000b562e8dd000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff969f0852000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffe048e71000000000000000000000000000000000000000000000000000000000dd4e0106000000000000000000000000000000000000000000000000000000004fd3af0700000000000000000000000000000000000000000000000000000000ad3a8b9e00000000000000000000000000000000000000000000000000000000327c6a56000000000000000000000000000000000000000000000000000000008a164f63000000000000000000000000000000000000000000000000000000002ee66eed00000000000000000000000000000000000000000000000000000000d1a57ed6000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000a11481000000000000000000000000000000000000000000000000000000000059c896be000000000000000000000000000000000000000000000000000000004c80d8be00000000000000000000000000000000000000000000000000000000ea553b340000000000000000000000000000000000000000000000000000000090b8ec18000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000800000000000000000db89e3f400000000000000000000000000000000000000000000000000000000cfb3b942000000000000000000000000000000000000000000000000000000008c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925df2d9b4200000000000000000000000000000000000000000000000000000000cf4700e400000000000000000000000000000000000000000000000000000000b6d9900a00000000000000000000000000000000000000000000000000000000f4df6ae50000000000000000000000000000000000000000000000000000000080ac58ccffffffffffffffffffffffffffffffffffffffffffffffffffffffff80ac58cd00000000000000000000000000000000000000000000000000000000ad0d7f6c0000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000005b5e139f000000000000000000000000000000000000000000000000000000002a55205a00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff000000000000000000000000000000000000000000000000ffffffffffffffc07fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff4033e4e3000000000000000000000000000000000000000000000000000000002b5dffd9914ddb43acdb6963bacf053a87bf9354300844f6339f17741e25145acd0081c2000000000000000000000000000000000000000000000000000000005e2a89dd00000000000000000000000000000000000000000000000000000000827815fdcfa2dc8667bdc70635ca79a2e0813e01e09a9b0e240fc55ca366815a
Loading...
Loading
Loading...
Loading
Loading...
Loading
Net Worth in USD
$0.00
Net Worth in ETH
0
Multichain Portfolio | 35 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ 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.