Source Code
Overview
ETH Balance
0 ETH
ETH Value
$0.00More Info
Private Name Tags
ContractCreator
TokenTracker
Latest 25 from a total of 10,019 transactions
| Transaction Hash |
|
Block
|
From
|
To
|
|||||
|---|---|---|---|---|---|---|---|---|---|
| Set Approval For... | 36438933 | 1 hr ago | IN | 0 ETH | 0.00000545 | ||||
| Set Approval For... | 36433228 | 2 hrs ago | IN | 0 ETH | 0.00000424 | ||||
| Safe Transfer Fr... | 36432500 | 2 hrs ago | IN | 0 ETH | 0.00000509 | ||||
| Safe Transfer Fr... | 36432385 | 2 hrs ago | IN | 0 ETH | 0.00000563 | ||||
| Set Approval For... | 36390457 | 7 hrs ago | IN | 0 ETH | 0.00000585 | ||||
| Set Approval For... | 36390303 | 7 hrs ago | IN | 0 ETH | 0.00000508 | ||||
| Safe Transfer Fr... | 36257660 | 25 hrs ago | IN | 0 ETH | 0.00000683 | ||||
| Safe Transfer Fr... | 36246282 | 27 hrs ago | IN | 0 ETH | 0.00000684 | ||||
| Set Approval For... | 36210447 | 33 hrs ago | IN | 0 ETH | 0.00000454 | ||||
| Set Approval For... | 36163345 | 41 hrs ago | IN | 0 ETH | 0.00000464 | ||||
| Set Approval For... | 36134162 | 47 hrs ago | IN | 0 ETH | 0.00000556 | ||||
| Set Approval For... | 36079205 | 2 days ago | IN | 0 ETH | 0.00000512 | ||||
| Set Approval For... | 35998329 | 2 days ago | IN | 0 ETH | 0.0000059 | ||||
| Set Approval For... | 35983701 | 3 days ago | IN | 0 ETH | 0.00000598 | ||||
| Set Approval For... | 35959251 | 3 days ago | IN | 0 ETH | 0.00000453 | ||||
| Set Approval For... | 35851389 | 3 days ago | IN | 0 ETH | 0.00000465 | ||||
| Set Approval For... | 35849231 | 3 days ago | IN | 0 ETH | 0.00000465 | ||||
| Set Approval For... | 35681186 | 4 days ago | IN | 0 ETH | 0.00000585 | ||||
| Set Approval For... | 35625061 | 5 days ago | IN | 0 ETH | 0.00000512 | ||||
| Set Approval For... | 35621493 | 5 days ago | IN | 0 ETH | 0.00000677 | ||||
| Set Approval For... | 35537217 | 5 days ago | IN | 0 ETH | 0.00000585 | ||||
| Set Approval For... | 35487121 | 6 days ago | IN | 0 ETH | 0.00000512 | ||||
| Set Approval For... | 35389599 | 7 days ago | IN | 0 ETH | 0.00000514 | ||||
| Set Approval For... | 35387962 | 7 days ago | IN | 0 ETH | 0.00000464 | ||||
| Safe Transfer Fr... | 35377720 | 7 days ago | IN | 0 ETH | 0.00000609 |
Latest 25 internal transactions (View All)
Advanced mode:
| Parent Transaction Hash | Block | From | To | |||
|---|---|---|---|---|---|---|
| 9956817 | 246 days ago | 131.99775 ETH | ||||
| 9953753 | 246 days ago | 0.06139169 ETH | ||||
| 9953563 | 246 days ago | 0.05939169 ETH | ||||
| 9953562 | 246 days ago | 0.00334169 ETH | ||||
| 9953562 | 246 days ago | 0.05939169 ETH | ||||
| 9953559 | 246 days ago | 0.00668339 ETH | ||||
| 9953559 | 246 days ago | 0.11878339 ETH | ||||
| 9953556 | 246 days ago | 0.00334169 ETH | ||||
| 9953556 | 246 days ago | 0.05939169 ETH | ||||
| 9953556 | 246 days ago | 0.00334169 ETH | ||||
| 9953556 | 246 days ago | 0.05939169 ETH | ||||
| 9953543 | 246 days ago | 0.00334169 ETH | ||||
| 9953543 | 246 days ago | 0.05939169 ETH | ||||
| 9953529 | 246 days ago | 0.00334169 ETH | ||||
| 9953529 | 246 days ago | 0.05939169 ETH | ||||
| 9953525 | 246 days ago | 0.00334169 ETH | ||||
| 9953525 | 246 days ago | 0.05939169 ETH | ||||
| 9953524 | 246 days ago | 0.00668339 ETH | ||||
| 9953524 | 246 days ago | 0.11878339 ETH | ||||
| 9953509 | 246 days ago | 0.00334169 ETH | ||||
| 9953509 | 246 days ago | 0.05939169 ETH | ||||
| 9953498 | 246 days ago | 0.00334169 ETH | ||||
| 9953498 | 246 days ago | 0.05939169 ETH | ||||
| 9953492 | 246 days ago | 0.00334169 ETH | ||||
| 9953492 | 246 days ago | 0.05939169 ETH |
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:
Fugz
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();
interface IRegistry {
function isAllowedOperator(address operator) external view returns (bool);
}
contract Fugz is Ownable, OperatorFilterer, ERC2981, ERC721A {
// Launchpad Fee
uint256 public launchpadFee = 391696043869957;
uint256 public launchpadCutBps = 500;
address public launchpadFeeAddress = 0xbDb9e0b47a02C45E3b50973A18452DC23CE72697;
event LaunchpadFeeSent(address indexed feeAddress, uint256 feeAmount);
using BitMaps for BitMaps.BitMap;
uint256 public maxSupply = 5555;
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/c2841f6a-0e00-4470-a931-d4929a9b422e.png";
// Phase 1 variables
uint256 public startTimePhase1 = 1747918800;
uint256 public endTimePhase1 = 1748005200;
uint256 public maxSupplyPhase1 = 0;
uint256 public totalSupplyPhase1;
uint256 public pricePhase1 = 59000000000000000;
uint256 public maxPerWalletPhase1 = 1;
bytes32 public merkleRootPhase1 = 0x99558795d61a4d9acfc5f63d1e6061788a850b67a7d4f8e03f7b5b32f7c865ad;
mapping(address => uint256) public walletMintsPhase1;
// Phase 2 variables
uint256 public startTimePhase2 = 1748005200;
uint256 public endTimePhase2 = 1748008800;
uint256 public maxSupplyPhase2 = 0;
uint256 public totalSupplyPhase2;
uint256 public pricePhase2 = 59000000000000000;
uint256 public maxPerWalletPhase2 = 2;
bytes32 public merkleRootPhase2 = 0xb0d333d0e0795a18292fb4ec2f0eb5fa6f0166bd0c83600ab782c6007b5f0878;
mapping(address => uint256) public walletMintsPhase2;
// Phase 3 variables
uint256 public startTimePhase3 = 1748008800;
uint256 public endTimePhase3 = 1748023200;
uint256 public maxSupplyPhase3 = 0;
uint256 public totalSupplyPhase3;
uint256 public pricePhase3 = 61000000000000000;
uint256 public maxPerWalletPhase3 = 2;
bytes32 public merkleRootPhase3 = 0x0;
mapping(address => uint256) public walletMintsPhase3;
constructor() ERC721A("Fugz", "FUGZ") Ownable(msg.sender) {
// Register operator filtering
_registerForOperatorFiltering();
// Set initial royalty
_setDefaultRoyalty(0x573DeD42cDe7380452E3a055944138608eF45E12, 250);
}
// 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();
}
// Check if the price is correct
if (msg.value != (pricePhase1 + launchpadFee) * quantity) {
revert WrongWeiSent();
}
// 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 * (msg.value - flatFees)) / 10000;
}
// Send the fees
uint256 totalFees = flatFees + percentageFees;
if (totalFees != 0) {
_sendLaunchpadFee(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();
}
// Check if the price is correct
if (msg.value != (pricePhase2 + launchpadFee) * quantity) {
revert WrongWeiSent();
}
// 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 * (msg.value - flatFees)) / 10000;
}
// Send the fees
uint256 totalFees = flatFees + percentageFees;
if (totalFees != 0) {
_sendLaunchpadFee(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();
}
// Check if the price is correct
if (msg.value != (pricePhase3 + launchpadFee) * quantity) {
revert WrongWeiSent();
}
// 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 * (msg.value - flatFees)) / 10000;
}
// Send the fees
uint256 totalFees = flatFees + percentageFees;
if (totalFees != 0) {
_sendLaunchpadFee(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();
}
}
// Send Launchpad Flat Fee
function _sendLaunchpadFee(uint256 feeAmount) private {
if (feeAmount == 0) {
revert InvalidLaunchpadFee();
}
if (launchpadFeeAddress == address(0)) {
revert InvalidLaunchpadFeeAddress();
}
(bool success, ) = payable(launchpadFeeAddress).call{value: feeAmount}("");
if (!success) {
revert TransferFailed();
}
emit LaunchpadFeeSent(launchpadFeeAddress, feeAmount);
}
// 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;
}
// =========================================================================
// 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 {
if (initialTransferLockOn && from != address(0) && to != address(0)) {
revert TransfersLocked();
}
if (_isValidAgainstRegistry(msg.sender)) {
super._beforeTokenTransfers(from, to, startTokenId, quantity);
} else {
revert NotAllowedByRegistry();
}
}
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) {
// Supports the following interfaceIds:
// - IERC165: 0x01ffc9a7
// - IERC721: 0x80ac58cd
// - IERC721Metadata: 0x5b5e139f
// - IERC2981: 0x2a55205a
return 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":"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":[{"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":"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":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","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":"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":"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":[],"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 payable","name":"_to","type":"address"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
9c4d535b00000000000000000000000000000000000000000000000000000000000000000100070be39217622b7426ba7437f327a72fa56f65c1ac18726ab4901ba1804000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0002000000000002000b000000000002000100000001035500000060031002700000061c0030019d0000008004000039000000400040043f0000000100200190000000240000c13d000a00000004001d0000061c02300197000000040020008c00000ec50000413d000000000301043b000000e0033002700000064a0030009c000000380000213d000006840030009c000000ba0000213d000006a10030009c000000f90000a13d000006a20030009c0000019c0000a13d000006a30030009c000002e60000213d000006a70030009c00000ad10000613d000006a80030009c000006340000613d000006a90030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d0000001c0100003900000b690000013d0000000001000416000000000001004b00000ec50000c13d0000000401000039000000800010043f0000061d02000041000000a00020043f0000010002000039000000400020043f000000c00010043f0000061e01000041000000e00010043f0000000006000411000000000006004b000000a10000c13d000006c001000041000000000010043f000000040000043f000006bf010000410000186f000104300000064b0030009c000000d60000213d000006680030009c000001080000a13d000006690030009c000001d00000a13d0000066a0030009c000002f10000213d0000066e0030009c00000ada0000613d0000066f0030009c0000063f0000613d000006700030009c00000ec50000c13d000000440020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000402100370000000000202043b000b00000002001d000006200020009c00000ec50000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039000a00000002001d000000000012004b00000ec50000c13d0000000f01000039000000000101041a000000ff001001900000006e0000613d000006cc01000041000000000010043f00000000010004100000001a0010043f0000000b010000290000003a0010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006cd011001c70000064402000041186d18680000040f000000010020019000000f2a0000613d0000003a0000043f0000000f01000039000000000101041a0000ff0000100190000012780000c13d0000000001000411000000000010043f0000000a01000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000b02000029000000000020043f000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a00000704022001970000000a03000029000000000232019f000000000021041b000000400100043d00000000003104350000061c0010009c0000061c01008041000000400110021000000000020004140000061c0020009c0000061c02008041000000c002200210000000000112019f00000626011001c70000800d020000390000000303000039000006dd0400004100000000050004110000000b0600002900000b200000013d000000000100041a0000061f02100197000000000262019f000000000020041b000000000200041400000620051001970000061c0020009c0000061c02008041000000c00120021000000621011001c70000800d0200003900000003030000390000062204000041186d18630000040f000000010020019000000ec50000613d000000800500043d000006230050009c000000e90000413d000006e501000041000000000010043f0000004101000039000000040010043f000006bf010000410000186f00010430000006850030009c000001370000a13d000006860030009c000002900000a13d000006870030009c000002fc0000213d0000068b0030009c00000ae50000613d0000068c0030009c0000064a0000613d0000068d0030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b186d18180000040f0000062001100197000000400200043d00000000001204350000061c0020009c0000061c020080410000004001200210000006c1011001c70000186e0001042e0000064c0030009c0000015a0000a13d0000064d0030009c0000029d0000a13d0000064e0030009c0000030d0000213d000006520030009c00000aea0000613d000006530030009c0000064f0000613d000006540030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d0000000f01000039000000000101041a000000180110027000000ad60000013d0000000504000039000000000104041a000000010310019000000001021002700000007f0220618f0000001f0020008c00000000010000390000000101002039000000000013004b000001790000613d000006e501000041000000000010043f0000002201000039000000040010043f000006bf010000410000186f00010430000006b00030009c000002aa0000213d000006b70030009c000003250000a13d000006b80030009c0000066a0000613d000006b90030009c000005860000613d000006ba0030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d000000140100003900000b690000013d000006770030009c000002b90000213d0000067e0030009c000003430000a13d0000067f0030009c000006850000613d000006800030009c000005a50000613d000006810030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d000006200010009c00000ec50000213d000000000100041a00000620021001970000000001000411000000000012004b00000dc50000c13d000006e10100004100000000001004430000000001000410000000040010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d6011001c70000800a02000039186d18680000040f0000000100200190000013cb0000613d000000000301043b00000000010004140000061c0010009c0000061c01008041000000c001100210000000000003004b00000f440000c13d0000000b0200002900000f480000013d000006940030009c000002cc0000213d0000069b0030009c000003560000a13d0000069c0030009c000006990000613d0000069d0030009c000005b00000613d0000069e0030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000000000001004b0000000002000039000000010200c039000000000021004b00000ec50000c13d000000000200041a00000620032001970000000002000411000000000023004b00000db30000c13d0000000f02000039000000000302041a000006db0030019800000ede0000c13d000006ed01000041000000000010043f000006ca010000410000186f000104300000065b0030009c000002d90000213d000006620030009c000004a10000a13d000006630030009c000007360000613d000006640030009c000005bb0000613d000006650030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000201043b000000000002004b0000000001000039000000010100c039000b00000002001d000000000012004b00000ec50000c13d186d17220000040f0000000f01000039000000000201041a00000704022001970000000b022001af000000000021041b00000000010000190000186e0001042e000000200020008c000001890000413d0000001f015000390000000501100270000006240110009a000000200050008c00000625010040410000001f022000390000000502200270000006240220009a000000000021004b000001890000813d000000000001041b0000000101100039000000000021004b000001850000413d0000001f0050008c0000031a0000a13d000b00000005001d000000000040043f00000000010004140000061c0010009c0000061c01008041000000c00110021000000626011001c70000801002000039186d18680000040f000000010020019000000ec50000613d0000000b060000290000070502600198000000000101043b00000d5d0000c13d000000200300003900000d690000013d000006aa0030009c000004b70000a13d000006ab0030009c000007410000613d000006ac0030009c000005c60000613d000006ad0030009c00000ec50000c13d000000440020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000002402100370000000000202043b000b00000002001d0000000401100370000000000101043b000000000010043f0000000201000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a0000062002100198000001c10000c13d0000000101000039000000000101041a0000062002100197000a00000002001d000000a0021002700000000b01000029186d17140000040f000027100110011a000000400200043d000000200320003900000000001304350000000a0100002900000000001204350000061c0020009c0000061c020080410000004001200210000006f4011001c70000186e0001042e000006710030009c000004c60000a13d000006720030009c000007d50000613d000006730030009c000005d10000613d000006740030009c00000ec50000c13d000000440020008c00000ec50000413d0000000403100370000000000303043b000006270030009c00000ec50000213d0000002304300039000000000024004b00000ec50000813d000800040030003d0000000804100360000000000404043b000b00000004001d000006270040009c00000ec50000213d00000024033000390000000b040000290000000504400210000600000003001d000a00000004001d000700000034001d000000070020006b00000ec50000213d0000002401100370000000000101043b000500000001001d0000001a01000039000000000101041a000900000001001d000000000001004b000002050000613d000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000000090010006c00000df10000413d0000001b01000039000000000101041a000900000001001d000000000001004b00000fc20000c13d0000000e01000039000000000101041a000000000001004b00000005040000290000021a0000613d0000000402000039000000000202041a00000706022001670000000303000039000000000303041a0000000002230019000000000042001a000010870000413d0000000002420019000000000012004b00000bc10000213d0000001c01000039000000000101041a000000000001004b000002250000613d0000001d02000039000000000202041a000000000042001a000010870000413d0000000002420019000000000012004b00000bc10000213d0000001e01000039000000000101041a0000000b02000039000000000302041a000000000013001a000010870000413d000000000213001a00000000014200a9000002310000613d00000000022100d9000000000042004b000010870000c13d000400000003001d0000000002000416000000000012004b00000f260000c13d0000002001000039000000000101041a000300000001001d000000000001004b0000111f0000c13d0000001f01000039000000000101041a000b00000001001d000000000001004b0000000503000029000002560000613d00000000010004110000062001100197000000000010043f0000002101000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a0000000503000029000000000031001a000010870000413d00000000013100190000000b0010006c00000bc10000213d0000000402000029000000000002004b0000000001000019000002630000613d0000000d01000039000000000101041a00000620001001980000000001000019000002630000613d00000000013200a900000000022100d9000000000032004b000010870000c13d0000000c02000039000000000202041a000000000002004b0000000003000019000002750000613d0000000d03000039000000000303041a00000620003001980000000003000019000002750000613d0000000003000416000000000413004b000010870000413d00000000032400a900000000022300d9000000000042004b000010870000c13d000027100330011a000000000013001a000010870000413d000b00000013001e0000127c0000c13d00000000010004110000062001100197000000000010043f0000002101000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000301041a0000000502000029000000000023001a000010870000413d0000000003230019000000000031041b0000001d01000039000008e50000013d0000068e0030009c000004cf0000a13d0000068f0030009c000007da0000613d000006900030009c000005f00000613d000006910030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d0000001f0100003900000b690000013d000006550030009c000004de0000a13d000006560030009c000008180000613d000006570030009c0000060e0000613d000006580030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d000000170100003900000b690000013d000006b10030009c000004e70000a13d000006b20030009c000008230000613d000006b30030009c000006190000613d000006b40030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d0000000f01000039000000000101041a0000ff00001001900000073c0000013d000006780030009c0000055f0000a13d000006790030009c0000082e0000613d0000067a0030009c000006250000613d0000067b0030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000140100003900000b9e0000013d000006950030009c000005680000a13d000006960030009c000008e90000613d000006970030009c0000062a0000613d000006980030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d000000220100003900000b690000013d0000065c0030009c000005770000a13d0000065d0030009c000009270000613d0000065e0030009c0000062f0000613d0000065f0030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d000000230100003900000b690000013d000006a40030009c00000aef0000613d000006a50030009c000009620000613d000006a60030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d000000260100003900000b690000013d0000066b0030009c00000afb0000613d0000066c0030009c000009800000613d0000066d0030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d000000120100003900000b690000013d000006880030009c00000b000000613d000006890030009c0000098a0000613d0000068a0030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000230100003900000b9e0000013d0000064f0030009c00000b050000613d000006500030009c00000acc0000613d000006510030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d0000000f01000039000000000101041a000000ff001001900000073c0000013d000000000005004b00000000010000190000031e0000613d000000a00100043d0000000302500210000007060220027f0000070602200167000000000121016f0000000102500210000000000121019f00000d760000013d000006bb0030009c00000b240000613d000006bc0030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000201043b000006da0020019800000ec50000c13d00000001010000390000064502200197000007000020009c0000033f0000613d000007010020009c0000033f0000613d000007020020009c0000033f0000613d000007000020009c00000000010000390000000101006039000007030020009c00000001011061bf000000010110018f000000800010043f000006bd010000410000186e0001042e000006820030009c00000b340000613d000006830030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000006200010009c00000ec50000213d000000000001004b00000df50000c13d000006e201000041000000000010043f000006ca010000410000186f000104300000069f0030009c00000b3f0000613d000006a00030009c00000ec50000c13d000000640020008c00000ec50000413d0000000402100370000000000202043b000a00000002001d000006200020009c00000ec50000213d0000002402100370000000000202043b000900000002001d000006200020009c00000ec50000213d0000004401100370000000000201043b00000000030004110000000a0030006b0000036f0000613d0000000f01000039000000000101041a000000ff0010019000000f750000c13d000000a001000039000700000001001d000000400010043f000800800000003d000000800000043f000000000002004b00000fb90000613d000600000002001d000000000020043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a000006c30020019800000fb90000c13d0000000001020019000000000002004b000003a30000c13d0000000301000039000000000101041a0000000602000029000000000021004b00000fb90000a13d000b00000002001d0000000b01000029000000010110008a000b00000001001d000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000000001004b000003900000613d000b00000001001d00000620011001970000000a0010006c0000104c0000c13d0000000601000029000000000010043f0000000901000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000300000001001d000000000101041a000400000001001d00000000010004110000062002100197000500000002001d0000000a0020006c000003de0000613d0000000402000029000000050020006b000003de0000613d0000000a01000029000000000010043f0000000a01000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000502000029000000000020043f000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000ff00100190000007d10000613d0000000901000029000206200010019c000012230000613d0000000f01000039000000000201041a0000000a0000006b000003e70000613d0000ff0000200190000012780000c13d000006cf002001980000147b0000c13d000000040000006b000003ed0000613d0000000301000029000000000001041b0000000a01000029000000000010043f0000000801000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000201000029000000000010043f0000000801000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a0000000102200039000000000021041b000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000400000001001d0000000601000029000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d0000000402000029000000a00220021000000002022001af000006d3022001c7000000000101043b000000000021041b0000000b01000029000006d300100198000004590000c13d00000006010000290000000101100039000400000001001d000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000000001004b000004590000c13d0000000301000039000000000101041a000000040010006b000004590000613d0000000401000029000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000b02000029000000000021041b00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d020000390000000403000039000006d4040000410000000a0500002900000002060000290000000607000029186d18630000040f000000010020019000000ec50000613d000006d50100004100000000001004430000000901000029000000040010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d6011001c70000800202000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000000000001004b00000f730000613d000000400300043d00000064013000390000008002000039000900000002001d000000000021043500000044013000390000000602000029000000000021043500000024013000390000000a020000290000000000210435000006d7010000410000000000130435000000040130003900000005020000290000000000210435000000080100002900000000010104330000008402300039000000000012043500000705051001970000001f0410018f000b00000003001d000000a403300039000000070030006b000015600000813d000000000005004b0000049d0000613d00000007074000290000000006430019000000200660008a000000200770008a0000000008560019000000000957001900000000090904330000000000980435000000200550008c000004970000c13d000000000004004b000015770000613d00000000060300190000156c0000013d000006660030009c00000b440000613d000006670030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d000006200010009c00000ec50000213d186d17220000040f0000000b010000290000001801100210000006db011001970000000f02000039000000000302041a000006dc0330019700000ee20000013d000006ae0030009c00000b4f0000613d000006af0030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000220100003900000b9e0000013d000006750030009c00000b5b0000613d000006760030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d000000000100041a00000ad60000013d000006920030009c00000b600000613d000006930030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000180100003900000b9e0000013d000006590030009c00000b650000613d0000065a0030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d0000000e0100003900000b690000013d000006b50030009c00000b6d0000613d000006b60030009c00000ec50000c13d000000440020008c00000ec50000413d0000000402100370000000000202043b000a00000002001d000006200020009c00000ec50000213d0000002401100370000000000201043b0000000f01000039000000000101041a000000ff001001900000050c0000613d000900000002001d000006cc01000041000000000010043f00000000010004100000001a0010043f0000000a010000290000003a0010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006cd011001c70000064402000041186d18680000040f000000010020019000000ee60000613d0000003a0000043f0000000f01000039000000000101041a00000009020000290000ff0000100190000012780000c13d000000000002004b00000fb90000613d000900000002001d000000000020043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000006c30010019800000fb90000c13d000000000001004b0000053c0000c13d0000000301000039000000000101041a0000000902000029000000000021004b00000fb90000a13d000b00000002001d0000000b01000029000000010110008a000b00000001001d000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000000001004b000005290000613d000b06200010019b00000000020004110000000b0020006c000010fc0000c13d0000000901000029000000000010043f0000000901000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d0000000a020000290000062006200197000000000101043b000000000201041a0000061f02200197000000000262019f000000000021041b00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d020000390000000403000039000006fb040000410000000b05000029000000090700002900000b200000013d0000067c0030009c00000b940000613d0000067d0030009c00000ec50000c13d0000000001000416000000000001004b00000ec50000c13d0000001b0100003900000b690000013d000006990030009c00000ba20000613d0000069a0030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000170100003900000b9e0000013d000006600030009c00000bc50000613d000006610030009c00000ec50000c13d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f0000001c0100003900000b9e0000013d0000000001000416000000000001004b00000ec50000c13d0000000503000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000000f30000c13d000000800010043f000000000004004b00000dca0000613d000000000030043f000000000001004b000000000200001900000dcf0000613d00000625030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b0000059d0000413d00000dcf0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000260100003900000b9e0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f0000001f0100003900000b9e0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000130100003900000b9e0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000120100003900000b9e0000013d0000000001000416000000000001004b00000ec50000c13d0000000603000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000000f30000c13d000000800010043f000000000004004b00000dca0000613d000000000030043f000000000001004b000000000200001900000dcf0000613d00000629030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000005e80000413d00000dcf0000013d000000640020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000402100370000000000202043b0000002403100370000000000303043b000006200030009c00000ec50000213d0000004401100370000000000101043b000006e90010009c00000ec50000213d000000000400041a00000620054001970000000004000411000000000045004b00000f000000c13d000003e80010008c000006810000213d000000000003004b00000fe00000c13d000006ea01000041000000000010043f000000040020043f000000240000043f00000643010000410000186f00010430000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000160100003900000b9e0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000006200010009c00000ec50000213d000000000010043f000000210100003900000b2f0000013d0000000001000416000000000001004b00000ec50000c13d000000240100003900000b690000013d0000000001000416000000000001004b00000ec50000c13d0000001a0100003900000b690000013d0000000001000416000000000001004b00000ec50000c13d000000270100003900000b690000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f0000001e0100003900000b9e0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000280100003900000b9e0000013d0000000001000416000000000001004b00000ec50000c13d0000001e0100003900000b690000013d000000440020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000402100370000000000202043b000006200020009c00000ec50000213d0000002401100370000000000101043b000b00000001001d000006200010009c00000ec50000213d000000000020043f0000000a01000039000000200010043f00000040020000390000000001000019186d184e0000040f0000000b02000029186d167f0000040f000000000101041a000000ff001001900000000001000039000000010100c039000000cf0000013d000000440020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000402100370000000000202043b000006200020009c00000ec50000213d0000002401100370000000000101043b000b00000001001d000006e90010009c00000ec50000213d0000000003020019000000000100041a00000620021001970000000001000411000000000012004b00000dc50000c13d0000000b01000029000003e90010008c00000fbd0000413d000006ff01000041000000000010043f000006ca010000410000186f000104300000000001000416000000000001004b00000ec50000c13d000000000100041a00000620021001970000000005000411000000000052004b00000dc00000c13d0000061f01100197000000000010041b00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d0200003900000003030000390000062204000041000000000600001900000b200000013d000000240020008c00000ec50000413d0000000401100370000000000501043b0000002201000039000000000101041a000000000001004b000006b20000613d000a00000001001d000b00000005001d000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b0000000a0010006c0000000b0500002900000df10000413d0000002301000039000000000101041a000000000001004b00000de00000c13d0000000e01000039000000000101041a000000000001004b000006c50000613d0000000402000039000000000202041a00000706022001670000000303000039000000000303041a0000000002230019000000000052001a000010870000413d0000000002520019000000000012004b00000bc10000213d0000002401000039000000000101041a000000000001004b000006d00000613d0000002502000039000000000202041a000000000052001a000010870000413d0000000002520019000000000012004b00000bc10000213d0000002601000039000000000101041a0000000b02000039000000000302041a000000000013001a000010870000413d000000000213001a00000000015200a9000006dc0000613d00000000022100d9000000000052004b000010870000c13d0000000002000416000000000012004b00000f260000c13d0000002701000039000000000101041a000a00000001001d000000000001004b000b00000005001d000006fd0000613d000900000003001d00000000010004110000062001100197000000000010043f0000002901000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a0000000b05000029000000000051001a0000000903000029000010870000413d00000000015100190000000a0010006c00000bc10000213d000000000003004b0000000001000019000007090000613d0000000d01000039000000000101041a00000620001001980000000001000019000007090000613d00000000015300a900000000023100d9000000000052004b000010870000c13d0000000c02000039000000000202041a000000000002004b0000000003000019000007130000613d0000000d03000039000000000303041a000006200030019800000000030000190000107c0000c13d000000000013001a000010870000413d000a00000013001e000010440000c13d00000000010004110000062001100197000000000010043f0000002901000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000301041a0000000b02000029000000000023001a000010870000413d0000000003230019000000000031041b0000002501000039000000000301041a000000000023001a000010870000413d0000000003230019000000000031041b0000000001000411186d172d0000040f00000000010000190000186e0001042e0000000001000416000000000001004b00000ec50000c13d0000000f01000039000000000101041a000006cf001001980000000001000039000000010100c039000000800010043f000006bd010000410000186e0001042e000000640020008c00000ec50000413d0000000402100370000000000202043b000a00000002001d000006200020009c00000ec50000213d0000002402100370000000000202043b000900000002001d000006200020009c00000ec50000213d0000004401100370000000000201043b00000000030004110000000a0030006b000007670000613d0000000f01000039000000000101041a000000ff00100190000007670000613d000800000002001d000006cc01000041000000000010043f00000000010004100000001a0010043f0000003a0030043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006cd011001c70000064402000041186d18680000040f000000010020019000000ff90000613d0000003a0000043f0000000802000029000000000002004b00000fb90000613d000800000002001d000000000020043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a000006c30020019800000fb90000c13d0000000001020019000000000002004b000007960000c13d0000000301000039000000000101041a0000000802000029000000000021004b00000fb90000a13d000b00000002001d0000000b01000029000000010110008a000b00000001001d000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000000001004b000007830000613d000b00000001001d00000620011001970000000a0010006c0000104c0000c13d0000000801000029000000000010043f0000000901000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000500000001001d000000000101041a000600000001001d00000000010004110000062002100197000700000002001d0000000a0020006c000012200000613d0000000702000029000000060020006c000012200000613d0000000a01000029000000000010043f0000000a01000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000702000029000000000020043f000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000ff00100190000012200000c13d000006f601000041000000000010043f000006ca010000410000186f000104300000000001000416000000000001004b00000ec50000c13d000000250100003900000b690000013d000000240020008c00000ec50000413d0000000003000416000000000003004b00000ec50000c13d0000000403100370000000000403043b000006270040009c00000ec50000213d0000002303400039000000000023004b00000ec50000813d0000000405400039000000000351034f000000000303043b000006270030009c00000ec50000213d00000024044000390000000006430019000000000026004b00000ec50000213d000000000200041a00000620062001970000000002000411000000000026004b00000db30000c13d0000001002000039000000000702041a000000010070019000000001067002700000007f0660618f0000001f0060008c00000000080000390000000108002039000000000787013f0000000100700190000000f30000c13d000000200060008c000008100000413d000000000020043f0000001f0730003900000005077002700000062e0770009a000000200030008c0000062d070040410000001f0660003900000005066002700000062e0660009a000000000067004b000008100000813d000000000007041b0000000107700039000000000067004b0000080c0000413d0000001f0030008c000010130000a13d000000000020043f0000070506300198000010d60000c13d0000062d050000410000000007000019000010eb0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f0000001b0100003900000b9e0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000240100003900000b9e0000013d000000440020008c00000ec50000413d0000000403100370000000000303043b000006270030009c00000ec50000213d0000002304300039000000000024004b00000ec50000813d000800040030003d0000000804100360000000000404043b000b00000004001d000006270040009c00000ec50000213d00000024033000390000000b040000290000000504400210000600000003001d000a00000004001d000700000034001d000000070020006b00000ec50000213d0000002401100370000000000101043b000500000001001d0000001201000039000000000101041a000900000001001d000000000001004b0000085b0000613d000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000000090010006c00000df10000413d0000001301000039000000000101041a000900000001001d000000000001004b00000fd10000c13d0000000e01000039000000000101041a000000000001004b0000000504000029000008700000613d0000000402000039000000000202041a00000706022001670000000303000039000000000303041a0000000002230019000000000042001a000010870000413d0000000002420019000000000012004b00000bc10000213d0000001401000039000000000201041a000000000002004b0000087b0000613d0000001503000039000000000303041a000000000043001a000010870000413d0000000003430019000000000023004b00000bc10000213d0000001602000039000000000202041a0000000b03000039000000000503041a000000000025001a000010870000413d000000000325001a00000000024300a9000008870000613d00000000033200d9000000000043004b000010870000c13d000400000005001d0000000003000416000000000023004b00000f260000c13d0000001802000039000000000202041a000300000002001d000000000002004b000011830000c13d0000001701000039000000000101041a000b00000001001d000000000001004b0000000503000029000008ac0000613d00000000010004110000062001100197000000000010043f0000001901000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a0000000503000029000000000031001a000010870000413d00000000013100190000000b0010006c00000bc10000213d0000000402000029000000000002004b0000000001000019000008b90000613d0000000d01000039000000000101041a00000620001001980000000001000019000008b90000613d00000000013200a900000000022100d9000000000032004b000010870000c13d0000000c02000039000000000202041a000000000002004b0000000003000019000008cb0000613d0000000d03000039000000000303041a00000620003001980000000003000019000008cb0000613d0000000003000416000000000413004b000010870000413d00000000032400a900000000022300d9000000000042004b000010870000c13d000027100330011a000000000013001a000010870000413d000b00000013001e000012a40000c13d00000000010004110000062001100197000000000010043f0000001901000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000301041a0000000502000029000000000023001a000010870000413d0000000003230019000000000031041b0000001501000039000000000301041a000000000023001a000010870000413d000007300000013d000000240020008c00000ec50000413d0000000003000416000000000003004b00000ec50000c13d0000000403100370000000000403043b000006270040009c00000ec50000213d0000002303400039000000000023004b00000ec50000813d0000000405400039000000000351034f000000000303043b000006270030009c00000ec50000213d00000024044000390000000006430019000000000026004b00000ec50000213d000000000200041a00000620062001970000000002000411000000000026004b00000db30000c13d0000001102000039000000000702041a000000010070019000000001067002700000007f0660618f0000001f0060008c00000000080000390000000108002039000000000787013f0000000100700190000000f30000c13d000000200060008c0000091f0000413d000000000020043f0000001f0730003900000005077002700000062f0770009a000000200030008c00000632070040410000001f0660003900000005066002700000062f0660009a000000000067004b0000091f0000813d000000000007041b0000000107700039000000000067004b0000091b0000413d0000001f0030008c000010130000a13d000000000020043f0000070506300198000010e10000c13d00000632050000410000000007000019000010eb0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000201043b000000000002004b00000db80000613d0000000301000039000000000101041a000000000021004b00000db80000a13d000b00000002001d000000000020043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000006c30010019800000db80000c13d0000001004000039000000000204041a000000010620019000000001012002700000007f0110618f0000001f0010008c00000000030000390000000103002039000000000332013f0000000100300190000000f30000c13d000000400500043d0000000003150436000000000006004b000010500000613d000000000040043f000000000001004b0000000002000019000010550000613d0000062d0400004100000000020000190000000006230019000000000704041a000000000076043500000001044000390000002002200039000000000012004b0000095a0000413d000010550000013d0000000001000416000000000001004b00000ec50000c13d000000000100041a00000620011001970000000002000411000000000021004b00000db30000c13d000006e10100004100000000001004430000000001000410000000040010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d6011001c70000800a02000039186d18680000040f0000000100200190000013cb0000613d000000000301043b00000000010004140000061c0010009c0000061c01008041000000c001100210000000000003004b00000f050000c13d000000000200041100000f090000013d0000000001000416000000000001004b00000ec50000c13d186d17220000040f0000000f01000039000000000201041a0000070702200197000000000021041b00000000010000190000186e0001042e000000440020008c00000ec50000413d0000000003000416000000000003004b00000ec50000c13d0000000403100370000000000303043b000006270030009c00000ec50000213d0000002304300039000000000024004b00000ec50000813d0000000404300039000000000441034f000000000504043b000006270050009c000000b40000213d00000005045002100000003f06400039000006de06600197000006cb0060009c000000b40000213d0000008006600039000000400060043f000000800050043f00000024033000390000000004340019000000000024004b00000ec50000213d000000000005004b000009b20000613d000000a005000039000000000631034f000000000606043b000006200060009c00000ec50000213d00000000056504360000002003300039000000000043004b000009aa0000413d0000002403100370000000000303043b000006270030009c00000ec50000213d0000002304300039000000000024004b0000000005000019000006e305008041000006e304400197000000000004004b0000000006000019000006e306004041000006e30040009c000000000605c019000000000006004b00000ec50000c13d0000000404300039000000000441034f000000000404043b000006270040009c000000b40000213d00000005054002100000003f06500039000006de06600197000000400700043d0000000006670019000500000007001d000000000076004b00000000070000390000000107004039000006270060009c000000b40000213d0000000100700190000000b40000c13d000000400060043f00000005060000290000000006460436000600000006001d00000024033000390000000005350019000000000025004b00000ec50000213d000000000004004b000009e60000613d0000000502000029000000000431034f000000000404043b000000200220003900000000004204350000002003300039000000000053004b000009df0000413d000000000100041a00000620011001970000000002000411000000000021004b0000126c0000c13d00000005010000290000000002010433000000800100043d000000000021004b000013490000c13d000000000001004b00000f730000613d000800000000001d000000050100002900000000010104330000000e02000039000000000302041a000000000003004b00000a0b0000613d0000000806000029000000000061004b0000153a0000a13d0000000402000039000000000202041a00000706022001670000000304000039000000000404041a0000000004240019000000050260021000000006052000290000000005050433000000000054001a000010870000413d0000000004540019000000000034004b00000a0d0000a13d00000bc10000013d00000008060000290000000502600210000000000061004b0000153a0000a13d00000006012000290000000001010433000900000001001d000000000001004b0000154c0000613d000000a00120003900000000030104330000000301000039000000000101041a000b00000001001d0000000f01000039000000000201041a000006cf0020019800000a660000613d000700000003001d000000400400043d000a00000004001d000006d00100004100000000001404350000000401400039000000000300041100000000003104350000061c0040009c0000061c010000410000000001044019000000400110021000000000030004140000061c0030009c0000061c03008041000000c003300210000000000113019f000006bf011001c700000018022002700000062002200197186d18680000040f0000000a0a00002900000060031002700000061c03300197000000200030008c00000020040000390000000004034019000000200640019000000000056a001900000a410000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b00000a3d0000c13d0000001f0740019000000a4e0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000015540000613d0000001f01400039000000600210018f0000000001a20019000000000021004b00000000020000390000000102004039000006270010009c000000b40000213d0000000100200190000000b40000c13d000000400010043f000000200030008c00000ec50000413d00000000010a0433000000000001004b0000000002000039000000010200c039000000000021004b00000ec50000c13d000000000001004b0000000703000029000014c30000613d0000062001300197000a00000001001d000000000010043f0000000801000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d0000000902000029000006e6022000d1000000000101043b000000000301041a0000000002230019000000000021041b000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000700000001001d0000000b01000029000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d0000000702000029000000a0022002100000000903000029000000010030008c0000000003000019000006d303006041000000000223019f0000000a06000029000000000262019f000000000101043b000000000021041b00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d020000390000000403000039000006d40400004100000000050000190000000b07000029186d18630000040f000000010020019000000ec50000613d0000000b02000029000900090020002d0000000b070000290000000107700039000000090070006c00000ac10000613d00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d020000390000000403000039000006d40400004100000000050000190000000a06000029000b00000007001d186d18630000040f000000010020019000000aae0000c13d00000ec50000013d0000000a0000006b000015500000613d00000003010000390000000902000029000000000021041b0000000802000029000800010020003d000000800100043d000000080010006b000009f30000413d00000f730000013d0000000001000416000000000001004b00000ec50000c13d000000200100003900000b690000013d0000000001000416000000000001004b00000ec50000c13d0000000d01000039000000000101041a0000062001100197000000800010043f000006bd010000410000186e0001042e000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f000000200100003900000b9e0000013d0000000001000416000000000001004b00000ec50000c13d0000001d0100003900000b690000013d0000000001000416000000000001004b00000ec50000c13d000000160100003900000b690000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000006200010009c00000ec50000213d000000000010043f000000190100003900000b2f0000013d0000000001000416000000000001004b00000ec50000c13d000000280100003900000b690000013d0000000001000416000000000001004b00000ec50000c13d000000180100003900000b690000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000601043b000006200060009c00000ec50000213d000000000100041a00000620021001970000000005000411000000000052004b00000dc00000c13d000000000006004b000000330000613d0000061f01100197000000000161019f000000000010041b00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d0200003900000003030000390000062204000041186d18630000040f000000010020019000000f730000c13d00000ec50000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000006200010009c00000ec50000213d000000000010043f0000002901000039000000200010043f00000040020000390000000001000019186d184e0000040f00000b690000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f0000000e0100003900000b9e0000013d0000000001000416000000000001004b00000ec50000c13d000000130100003900000b690000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f0000001a0100003900000b9e0000013d0000000001000416000000000001004b00000ec50000c13d0000000401000039000000000101041a00000706011001670000000302000039000000000202041a0000000001120019000000800010043f000006bd010000410000186e0001042e0000000001000416000000000001004b00000ec50000c13d0000000b0100003900000b690000013d0000000001000416000000000001004b00000ec50000c13d000000150100003900000b690000013d0000000001000416000000000001004b00000ec50000c13d0000000c01000039000000000101041a000000800010043f000006bd010000410000186e0001042e000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000201043b000000000002004b00000dbc0000613d0000000301000039000000000101041a000000000021004b00000dbc0000a13d000b00000002001d000000000020043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000006c3001001980000000b0100002900000dbc0000c13d000000000010043f0000000901000039000000200010043f00000040020000390000000001000019186d184e0000040f000000000101041a000000ce0000013d000000240020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000401100370000000000101043b000b00000001001d186d17220000040f00000027010000390000000b02000029000000000021041b00000000010000190000186e0001042e000000440020008c00000ec50000413d0000000002000416000000000002004b00000ec50000c13d0000000402100370000000000302043b000006200030009c00000ec50000213d0000002401100370000000000201043b000000000100041a00000620041001970000000001000411000000000014004b00000dc50000c13d0000000e01000039000000000101041a000000000001004b00000eda0000613d0000000404000039000000000404041a00000706044001670000000305000039000000000505041a0000000004450019000000000024001a000010870000413d0000000004240019000000000014004b00000eda0000a13d000006f001000041000000000010043f000006ca010000410000186f00010430000000840020008c00000ec50000413d0000000403100370000000000303043b000900000003001d000006200030009c00000ec50000213d0000002403100370000000000303043b000800000003001d000006200030009c00000ec50000213d0000004403100370000000000303043b000700000003001d0000006403100370000000000403043b000006270040009c00000ec50000213d0000002303400039000000000023004b00000ec50000813d0000000405400039000000000351034f000000000303043b000006270030009c000000b40000213d0000001f0630003900000705066001970000003f066000390000070506600197000006cb0060009c000000b40000213d0000008006600039000000400060043f000000800030043f00000000043400190000002404400039000000000024004b00000ec50000213d0000002002500039000000000221034f00000705043001980000001f0530018f000000a00140003900000bf90000613d000000a006000039000000000702034f000000007807043c0000000006860436000000000016004b00000bf50000c13d000000000005004b00000c060000613d000000000242034f0000000304500210000000000501043300000000054501cf000000000545022f000000000202043b0000010004400089000000000242022f00000000024201cf000000000252019f0000000000210435000000a00130003900000000000104350000000002000411000000090020006b00000c330000613d0000000f01000039000000000101041a000000ff0010019000000c330000613d000006cc01000041000000000010043f00000000010004100000001a0010043f00000000010004110000003a0010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006cd011001c70000064402000041186d18680000040f0000000100200190000012270000613d0000003a0000043f0000000f01000039000000000101041a000000ff0010019000000c330000613d000006cc01000041000000000010043f00000000010004100000001a0010043f00000000010004110000003a0010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006cd011001c70000064402000041186d18680000040f0000000100200190000013cc0000613d0000003a0000043f000000070000006b00000fb90000613d0000000701000029000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a000006c30020019800000fb90000c13d0000000001020019000000000002004b00000c610000c13d0000000301000039000000000101041a000000070010006c00000fb90000a13d000b00070000002d0000000b01000029000000010110008a000b00000001001d000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000000001004b00000c4e0000613d000b00000001001d0000062001100197000000090010006c0000104c0000c13d0000000701000029000000000010043f0000000901000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000400000001001d000000000101041a000500000001001d00000000010004110000062002100197000600000002001d000000090020006c00000c9c0000613d0000000502000029000000060020006b00000c9c0000613d0000000901000029000000000010043f0000000a01000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000602000029000000000020043f000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000ff00100190000007d10000613d0000000801000029000306200010019c000012230000613d0000000f01000039000000000201041a000000090000006b00000ca50000613d0000ff0000200190000012780000c13d000006cf00200198000014f10000c13d000000050000006b00000cab0000613d0000000401000029000000000001041b0000000901000029000000000010043f0000000801000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000301000029000000000010043f0000000801000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a0000000102200039000000000021041b000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000500000001001d0000000701000029000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d0000000502000029000000a00220021000000003022001af000006d3022001c7000000000101043b000000000021041b0000000b01000029000006d30010019800000d170000c13d00000007010000290000000101100039000500000001001d000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000000001004b00000d170000c13d0000000301000039000000000101041a000000050010006b00000d170000613d0000000501000029000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000b02000029000000000021041b00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d020000390000000403000039000006d404000041000000090500002900000003060000290000000707000029186d18630000040f000000010020019000000ec50000613d000006d50100004100000000001004430000000801000029000000040010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d6011001c70000800202000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000000000001004b00000f730000613d000000400500043d000000640150003900000080020000390000000000210435000000440150003900000007020000290000000000210435000000240150003900000009020000290000000000210435000006d70100004100000000001504350000000401500039000000060200002900000000002104350000008402500039000000800100043d000000000012043500000705041001970000001f0310018f000b00000005001d000000a402500039000000a10020008c000015f90000413d000000000004004b00000d580000613d000000000632001900000080053001bf000000200660008a0000000007460019000000000845001900000000080804330000000000870435000000200440008c00000d520000c13d000000000003004b0000160f0000613d000000a0040000390000000005020019000016050000013d000000010320008a000000050330027000000000043100190000002003000039000000010440003900000080053000390000000005050433000000000051041b00000020033000390000000101100039000000000041004b00000d620000c13d000000000062004b00000d730000813d0000000302600210000000f80220018f000007060220027f000007060220016700000080033000390000000003030433000000000223016f000000000021041b000000010160021000000001011001bf0000000504000039000000000014041b000000c00500043d000006270050009c000000b40000213d0000000604000039000000000204041a000000010020019000000001012002700000007f0110618f0000001f0010008c00000000030000390000000103002039000000000232013f0000000100200190000000f30000c13d000000200010008c00000d950000413d0000001f025000390000000502200270000006280220009a000000200050008c00000629020040410000001f011000390000000501100270000006280110009a000000000012004b00000d950000813d000000000002041b0000000102200039000000000012004b00000d910000413d0000001f0050008c00000da80000a13d000b00000005001d000000000040043f00000000010004140000061c0010009c0000061c01008041000000c00110021000000626011001c70000801002000039186d18680000040f000000010020019000000ec50000613d0000000b060000290000070502600198000000000101043b00000e000000c13d000000e00300003900000e0e0000013d000000000005004b000000000100001900000dac0000613d000000e00100043d0000000302500210000007060220027f0000070602200167000000000121016f0000000102500210000000000121019f00000e1a0000013d000006be01000041000000000010043f000000040020043f000006bf010000410000186f00010430000006c901000041000000000010043f000006ca010000410000186f00010430000006fd01000041000000000010043f000006ca010000410000186f00010430000006be01000041000000000010043f000000040050043f000006bf010000410000186f00010430000006be02000041000000000020043f000000040010043f000006bf010000410000186f000104300000070402200197000000a00020043f000000000001004b0000002002000039000000000200603900000020022000390000008001000039186d16f60000040f000000400100043d000b00000001001d0000008002000039186d16c10000040f0000000b0200002900000000012100490000061c0010009c0000061c0100804100000060011002100000061c0020009c0000061c020080410000004002200210000000000121019f0000186e0001042e000a00000001001d000b00000005001d000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b0000000a0010006c0000000b05000029000006b60000a13d000006ee01000041000000000010043f000006ca010000410000186f00010430000000000010043f0000000801000039000000200010043f00000040020000390000000001000019186d184e0000040f000000000101041a0000062701100197000000800010043f000006bd010000410000186e0001042e000000010320008a00000005033002700000000003310019000000200400003900000001033000390000000005040019000000c0044000390000000004040433000000000041041b00000020045000390000000101100039000000000031004b00000e050000c13d000000e003500039000000000062004b00000e170000813d0000000302600210000000f80220018f000007060220027f00000706022001670000000003030433000000000223016f000000000021041b000000010160021000000001011001bf0000000604000039000000000014041b00000001050000390000000301000039000000000051041b0000062a010000410000000b02000039000000000012041b000001f4010000390000000c02000039000000000012041b0000000d01000039000000000201041a0000061f022001970000062b022001c7000000000021041b000015b3010000390000000e02000039000000000012041b0000000f01000039000000000201041a0000062c0220019700000101022001bf000000000021041b0000001001000039000000000301041a000000010030019000000001023002700000007f0220618f0000001f0020008c00000000040000390000000104002039000000000343013f0000000100300190000000f30000c13d0000001f0020008c00000e460000a13d0000062d030000410000001f0220003900000005022002700000062e0220009a000000000003041b0000000103300039000000000023004b00000e420000413d000000000001041b0000001101000039000000000301041a000000010030019000000001023002700000007f0220618f0000001f0020008c00000000040000390000000104002039000000000343013f0000000100300190000000f30000c13d000000200020008c00000e5e0000413d000000810020008c00000e5e0000413d0000001f0220003900000005022002700000062f0220009a0000063003000041000000000003041b0000000103300039000000000023004b00000e5a0000413d000000c502000039000000000021041b00000631010000410000063202000041000000000012041b00000633010000410000063402000041000000000012041b00000635010000410000063602000041000000000012041b00000637010000410000063802000041000000000012041b00000639010000410000001202000039000000000012041b0000063a010000410000001302000039000000000012041b0000001402000039000000000002041b0000063b020000410000001603000039000000000023041b0000001703000039000000000053041b0000063c030000410000001804000039000000000034041b0000001a03000039000000000013041b0000063d010000410000001b03000039000000000013041b0000001c03000039000000000003041b0000001e03000039000000000023041b00000002020000390000001f03000039000000000023041b0000063e030000410000002004000039000000000034041b0000002203000039000000000013041b0000063f010000410000002303000039000000000013041b0000002401000039000000000001041b00000640010000410000002603000039000000000013041b0000002701000039000000000021041b0000002801000039000000000001041b0000064101000041000000000010043f0000000001000410000000040010043f0000064201000041000000240010043f00000000010004140000061c0010009c0000061c01008041000000c00110021000000643011001c70000064402000041186d18630000040f00000060031002700000061c03300197000000040030008c0000000403008039000000000000004b00000eb20000613d000000000401034f0000000005000019000000004604043c0000000000650435000000200550003a00000eae0000c13d000000000003004b00000ebf0000613d0000000303300210000000000400043d00000000043401cf000000000434022f00000100033000890000000001100370000000000101043b000000000131022f00000000013101cf000000000141019f000000000010043f000000010020019000000ec70000c13d000000000100043d0000064501100197000006410010009c00000ec70000c13d00000000010000190000186f00010430000000240000043f000000400100043d000006460010009c000000b40000213d0000004002100039000000400020043f0000002002100039000000fa0300003900000000003204350000064702000041000000000021043500000648010000410000000102000039000000000012041b00000020010000390000010000100443000001200000044300000649010000410000186e0001042e0000000001030019186d172d0000040f00000000010000190000186e0001042e000000000001004b0000000001000019000006eb0100c041000006ec03300197000000000113019f000000000012041b00000000010000190000186e0001042e00000060041002700000001f0340018f000006ce0240019800000ef00000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b00000eec0000c13d0000061c04400197000000000003004b00000efe0000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f000000000012043500000060014002100000186f00010430000006be01000041000000000010043f000000040040043f000006bf010000410000186f0001043000000621011001c7000080090200003900000000040004110000000005000019186d18630000040f00000060031002700000061c0330019800000f710000613d0000001f04300039000006d8044001970000003f04400039000006d904400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000006270040009c000000b40000213d0000000100600190000000b40000c13d000000400040043f0000001f0430018f0000000006350436000006ce05300198000000000356001900000f640000613d000000000701034f000000007807043c0000000006860436000000000036004b00000f210000c13d00000f640000013d000006ef01000041000000000010043f000006ca010000410000186f0001043000000060041002700000001f0340018f000006ce0240019800000f340000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b00000f300000c13d0000061c04400197000000000003004b00000f420000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f000000000012043500000060014002100000186f0001043000000621011001c700008009020000390000000b040000290000000005000019186d18630000040f00000060031002700000061c0330019800000f710000613d0000001f04300039000006d8044001970000003f04400039000006d904400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000006270040009c000000b40000213d0000000100600190000000b40000c13d000000400040043f0000001f0430018f0000000006350436000006ce05300198000000000356001900000f640000613d000000000701034f000000007807043c0000000006860436000000000036004b00000f600000c13d000000000004004b00000f710000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000100200190000012cc0000613d00000000010000190000186e0001042e000600000002001d000006cc01000041000000000010043f00000000010004100000001a0010043f0000003a0030043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006cd011001c70000064402000041186d18680000040f00000001002001900000101f0000613d0000003a0000043f000000400100043d000800000001001d000006c80010009c000000b40000213d0000000f01000039000000000101041a00000008030000290000002002300039000700000002001d000000400020043f0000000000030435000000ff0010019000000fb60000613d000006cc01000041000000000010043f00000000010004100000001a0010043f00000000010004110000003a0010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006cd011001c70000064402000041186d18680000040f0000000100200190000011e90000613d0000003a0000043f0000000f01000039000000000101041a000000ff0010019000000fb60000613d000006cc01000041000000000010043f00000000010004100000001a0010043f00000000010004110000003a0010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006cd011001c70000064402000041186d18680000040f0000000100200190000012d00000613d0000003a0000043f0000000602000029000000000002004b000003760000c13d000006fc01000041000000000010043f000006ca010000410000186f00010430000a00000003001d000000000003004b000010390000c13d000006fe01000041000000340000013d000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000000090010006c0000020a0000a13d00000df10000013d000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000000090010006c000008600000a13d00000df10000013d000000c004000039000000400040043f000000800030043f000000a00010043f000000000020043f0000000201000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000800200043d0000062002200197000000a00300043d000000a003300210000000000223019f000000000101043b000000000021041b00000000010000190000186e0001042e00000060041002700000001f0340018f000006ce02400198000010030000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b00000fff0000c13d0000061c04400197000000000003004b000010110000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f000000000012043500000060014002100000186f00010430000000000003004b0000000004000019000010190000613d0000002004500039000000000141034f000000000401043b0000000301300210000007060110027f0000070601100167000000000414016f0000000101300210000010f80000013d00000060041002700000001f0340018f000006ce02400198000010290000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000010250000c13d0000061c04400197000000000003004b000010370000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f000000000012043500000060014002100000186f00010430186d17080000040f0000000a0300002900000000013104360000000b020000290000000000210435000000a001200210000000000131019f0000000102000039000000000012041b00000000010000190000186e0001042e0000000d01000039000000000101041a00000620041001980000108d0000c13d000006f101000041000000000010043f000006ca010000410000186f00010430000006f501000041000000000010043f000006ca010000410000186f0001043000000704022001970000000000230435000000000001004b000000200200003900000000020060390000003f0120003900000705011001970000000004510019000000000014004b00000000010000390000000101004039000006270040009c000000b40000213d0000000100100190000000b40000c13d000000400040043f0000001108000039000000000708041a000000010970019000000001017002700000007f0110618f0000001f0010008c00000000060000390000000106002039000000000667013f0000000100600190000000f30000c13d0000000006140436000000000009004b000012030000613d000000000080043f000000000001004b0000000007000019000012080000613d000006320800004100000000070000190000000009760019000000000a08041a0000000000a9043500000001088000390000002007700039000000000017004b000010740000413d000012080000013d0000000003000416000000000413004b000010870000413d00000000032400a900000000022300d9000000000042004b000010870000c13d000027100330011a000000000013001a000010870000413d000007150000013d000006e501000041000000000010043f0000001101000039000000040010043f000006bf010000410000186f0001043000000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c700008009020000390000000a030000290000000005000019186d18630000040f00000060031002700000061c03300198000010be0000613d0000001f04300039000006d8044001970000003f04400039000006d904400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000006270040009c000000b40000213d0000000100600190000000b40000c13d000000400040043f0000001f0430018f0000000006350436000006ce053001980000000003560019000010b10000613d000000000701034f000000007807043c0000000006860436000000000036004b000010ad0000c13d000000000004004b000010be0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000100200190000012cc0000613d0000000d01000039000000000201041a000000400100043d0000000a0300002900000000003104350000061c0010009c0000061c01008041000000400110021000000000030004140000061c0030009c0000061c03008041000000c003300210000000000113019f00000626011001c700000620052001970000800d020000390000000203000039000006df04000041186d18630000040f0000000100200190000007170000c13d00000ec50000013d0000062d0500004100000000070000190000000008470019000000000881034f000000000808043b000000000085041b00000001055000390000002007700039000000000067004b000010d80000413d000010eb0000013d000006320500004100000000070000190000000008470019000000000881034f000000000808043b000000000085041b00000001055000390000002007700039000000000067004b000010e30000413d000000000036004b000010f60000813d0000000306300210000000f80660018f000007060660027f00000706066001670000000004470019000000000141034f000000000101043b000000000161016f000000000015041b00000001010000390000000104300210000000000114019f000000000012041b00000000010000190000186e0001042e0000000b01000029000000000010043f0000000a01000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b00000000020004110000062002200197000000000020043f000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000ff00100190000005400000c13d000006fa01000041000000000010043f000006ca010000410000186f00010430000000400100043d00000014020000390000000002210436000000000300041100000060033002100000000000320435000006460010009c000000b40000213d0000004003100039000000400030043f0000061c0020009c0000061c02008041000000400220021000000000010104330000061c0010009c0000061c010080410000006001100210000000000121019f00000000020004140000061c0020009c0000061c02008041000000c002200210000000000112019f00000621011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000a020000290000003f02200039000006de02200197000000400300043d0000000002230019000a00000003001d000000000032004b00000000030000390000000103004039000006270020009c000000b40000213d0000000100300190000000b40000c13d000000400020043f0000000b020000290000000a040000290000000002240436000900000002001d0000000702000029000000000020007c00000ec50000213d0000000b0000006b000011800000613d0000000802000029000000200220003900000001022003670000000a03000029000000060500002900000007060000290000002003300039000000002402043c00000000004304350000002005500039000000000065004b000011590000413d0000000a020000290000000002020433000000000002004b000011800000613d0000000003000019000b00000003001d000000050230021000000009022000290000000002020433000000000021004b0000116e0000813d000000000010043f000000200020043f0000000001000414000011710000013d000000000020043f000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000b0300002900000001033000390000000a020000290000000002020433000000000023004b000011640000413d000000030010006c0000023a0000613d000011e50000013d000000400200043d0000000001120436000000000300041100000060033002100000000000310435000006460020009c000000b40000213d0000004003200039000000400030043f0000061c0010009c0000061c01008041000000400110021000000000020204330000061c0020009c0000061c020080410000006002200210000000000112019f00000000020004140000061c0020009c0000061c02008041000000c002200210000000000112019f00000621011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000a020000290000003f02200039000006de02200197000000400300043d0000000002230019000a00000003001d000000000032004b00000000030000390000000103004039000006270020009c000000b40000213d0000000100300190000000b40000c13d000000400020043f0000000b020000290000000a040000290000000002240436000900000002001d0000000702000029000000000020007c00000ec50000213d0000000b0000006b000011e30000613d0000000802000029000000200220003900000001022003670000000a03000029000000060500002900000007060000290000002003300039000000002402043c00000000004304350000002005500039000000000065004b000011bc0000413d0000000a020000290000000002020433000000000002004b000011e30000613d0000000003000019000b00000003001d000000050230021000000009022000290000000002020433000000000021004b000011d10000813d000000000010043f000000200020043f0000000001000414000011d40000013d000000000020043f000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000b0300002900000001033000390000000a020000290000000002020433000000000023004b000011c70000413d000000030010006c000008900000613d000006e001000041000000000010043f000006ca010000410000186f0001043000000060041002700000001f0340018f000006ce02400198000011f30000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000011ef0000c13d0000061c04400197000000000003004b000012010000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f000000000012043500000060014002100000186f0001043000000704077001970000000000760435000000000001004b000000200700003900000000070060390000003f0170003900000705061001970000000001460019000000000061004b00000000060000390000000106004039000006270010009c000000b40000213d0000000100600190000000b40000c13d000000400010043f0000000006050433000000000006004b000012410000c13d0000000002040433000000000002004b000012ea0000c13d000006c80010009c000000b40000213d0000002002100039000000400020043f0000000000010435000000400300043d000013440000013d0000000901000029000906200010019c000012720000c13d000006f801000041000000000010043f000006ca010000410000186f0001043000000060041002700000001f0340018f000006ce02400198000012310000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b0000122d0000c13d0000061c04400197000000000003004b0000123f0000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f000000000012043500000060014002100000186f00010430000000a004100039000000400040043f000000800410003900000000000404350000000b090000290000000006040019000000090090008c0000000a4990011a000000f807400210000000010460008a0000000008040433000006c408800197000000000787019f000006c5077001c70000000000740435000012460000213d00000000016100490000008101100039000000210660008a0000000000160435000000000505043300000705095001970000001f0850018f000000400100043d0000002007100039000000000073004b000012ed0000813d000000000009004b000012680000613d000000000b830019000000000a870019000000200aa0008a000000200bb0008a000000000c9a0019000000000d9b0019000000000d0d04330000000000dc0435000000200990008c000012620000c13d000000000008004b000013030000613d000000000a070019000012f90000013d000006be01000041000000000010043f0000000001000411000000040010043f000006bf010000410000186f000104300000000f01000039000000000201041a0000000a0000006b0000134d0000613d0000ff00002001900000134d0000613d000006f901000041000000000010043f000006ca010000410000186f000104300000000d01000039000000000101041a0000062004100198000010480000613d00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c700008009020000390000000b030000290000000005000019186d18630000040f00000060031002700000061c033001980000142f0000c13d0000000100200190000012cc0000613d0000000d01000039000000000201041a000000400100043d0000000b0300002900000000003104350000061c0010009c0000061c01008041000000400110021000000000030004140000061c0030009c0000061c03008041000000c003300210000000000113019f00000626011001c700000620052001970000800d020000390000000203000039000006df04000041186d18630000040f0000000100200190000002790000c13d00000ec50000013d0000000d01000039000000000101041a0000062004100198000010480000613d00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c700008009020000390000000b030000290000000005000019186d18630000040f00000060031002700000061c03300198000014550000c13d0000000100200190000012cc0000613d0000000d01000039000000000201041a000000400100043d0000000b0300002900000000003104350000061c0010009c0000061c01008041000000400110021000000000030004140000061c0030009c0000061c03008041000000c003300210000000000113019f00000626011001c700000620052001970000800d020000390000000203000039000006df04000041186d18630000040f0000000100200190000008cf0000c13d00000ec50000013d000006f301000041000000000010043f000006ca010000410000186f0001043000000060041002700000001f0340018f000006ce02400198000012da0000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000012d60000c13d0000061c04400197000000000003004b000012e80000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f000000000012043500000060014002100000186f0001043000000000030100190000000001040019000013440000013d000000000a970019000000000009004b000012f60000613d000000000b030019000000000c07001900000000bd0b0434000000000cdc04360000000000ac004b000012f20000c13d000000000008004b000013030000613d0000000003930019000000030880021000000000090a043300000000098901cf000000000989022f00000000030304330000010008800089000000000383022f00000000038301cf000000000393019f00000000003a04350000000005750019000006c6030000410000000000350435000000000306043300000705073001970000001f0630018f0000000105500039000000000054004b0000131c0000813d000000000007004b000013180000613d00000000096400190000000008650019000000200880008a000000200990008a000000000a780019000000000b790019000000000b0b04330000000000ba0435000000200770008c000013120000c13d000000000006004b000013320000613d0000000008050019000013280000013d0000000008750019000000000007004b000013250000613d0000000009040019000000000a050019000000009b090434000000000aba043600000000008a004b000013210000c13d000000000006004b000013320000613d00000000047400190000000306600210000000000708043300000000076701cf000000000767022f00000000040404330000010006600089000000000464022f00000000046401cf000000000474019f00000000004804350000000003530019000006c704000041000000000043043500000000031300490000001b0430008a0000000000410435000000240330003900000705023001970000000004120019000000000024004b00000000020000390000000102004039000006270040009c000000b40000213d0000000100200190000000b40000c13d0000000003040019000000400040043f0000002002000039000b00000003001d0000000002230436186d168f0000040f00000dd60000013d000006e401000041000000000010043f000006ca010000410000186f00010430000006cf00200198000013e60000c13d000000060000006b000013530000613d0000000501000029000000000001041b0000000a01000029000000000010043f0000000801000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000901000029000000000010043f0000000801000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000201041a0000000102200039000000000021041b000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000013cb0000613d000000000101043b000700000001001d0000000801000029000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d0000000702000029000000a00220021000000009022001af000006d3022001c7000000000101043b000000000021041b0000000b01000029000006d300100198000013bf0000c13d00000008010000290000000101100039000700000001001d000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b000000000101041a000000000001004b000013bf0000c13d0000000301000039000000000101041a000000070010006b000013bf0000613d0000000701000029000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f000000010020019000000ec50000613d000000000101043b0000000b02000029000000000021041b00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d020000390000000403000039000006d4040000410000000a050000290000000906000029000000080700002900000b200000013d000000000001042f00000060041002700000001f0340018f000006ce02400198000013d60000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000026004b000013d20000c13d0000061c04400197000000000003004b000013e40000613d000000000121034f0000000303300210000000000502043300000000053501cf000000000535022f000000000101043b0000010003300089000000000131022f00000000013101cf000000000151019f000000000012043500000060014002100000186f00010430000000400400043d000400000004001d000006d00100004100000000001404350000000401400039000000070300002900000000003104350000061c0040009c0000061c010000410000000001044019000000400110021000000000030004140000061c0030009c0000061c03008041000000c003300210000000000113019f000006bf011001c700000018022002700000062002200197186d18680000040f00000060031002700000061c03300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000040b00002900000004057000290000140a0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000014060000c13d000000000006004b000014170000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000014c70000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000006270010009c000000b40000213d0000000100200190000000b40000c13d000000400010043f000000200030008c00000ec50000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b00000ec50000c13d000000000001004b0000134f0000c13d000014c30000013d0000001f04300039000006d8044001970000003f04400039000006d904400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000006270040009c000000b40000213d0000000100600190000000b40000c13d000000400040043f0000001f0430018f0000000006350436000006ce053001980000000003560019000014470000613d000000000701034f000000007807043c0000000006860436000000000036004b000014430000c13d000000000004004b0000128c0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000128c0000013d0000001f04300039000006d8044001970000003f04400039000006d904400197000000400500043d0000000004450019000000000054004b00000000060000390000000106004039000006270040009c000000b40000213d0000000100600190000000b40000c13d000000400040043f0000001f0430018f0000000006350436000006ce0530019800000000035600190000146d0000613d000000000701034f000000007807043c0000000006860436000000000036004b000014690000c13d000000000004004b000012b40000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000012b40000013d000000400400043d000100000004001d000006d00100004100000000001404350000000401400039000000050300002900000000003104350000061c0040009c0000061c010000410000000001044019000000400110021000000000030004140000061c0030009c0000061c03008041000000c003300210000000000113019f000006bf011001c700000018022002700000062002200197186d18680000040f00000060031002700000061c03300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000010b00002900000001057000290000149f0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b0000149b0000c13d000000000006004b000014ac0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000014d30000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000006270010009c000000b40000213d0000000100200190000000b40000c13d000000400010043f000000200030008c00000ec50000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b00000ec50000c13d000000000001004b000003e90000c13d000006f701000041000000000010043f000006ca010000410000186f000104300000001f0530018f000006ce06300198000000400200043d0000000004620019000014de0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000014ce0000c13d000014de0000013d0000001f0530018f000006ce06300198000000400200043d0000000004620019000014de0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000014da0000c13d000000000005004b000014eb0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f000000000014043500000060013002100000061c0020009c0000061c020080410000004002200210000000000112019f0000186f00010430000000400400043d000200000004001d000006d00100004100000000001404350000000401400039000000060300002900000000003104350000061c0040009c0000061c010000410000000001044019000000400110021000000000030004140000061c0030009c0000061c03008041000000c003300210000000000113019f000006bf011001c700000018022002700000062002200197186d18680000040f00000060031002700000061c03300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000020b0000290000000205700029000015150000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000015110000c13d000000000006004b000015220000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000015400000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000006270010009c000000b40000213d0000000100200190000000b40000c13d000000400010043f000000200030008c00000ec50000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b00000ec50000c13d000000000001004b00000ca70000c13d000014c30000013d000006e501000041000000000010043f0000003201000039000000040010043f000006bf010000410000186f000104300000001f0530018f000006ce06300198000000400200043d0000000004620019000014de0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000015470000c13d000014de0000013d000006e801000041000000000010043f000006ca010000410000186f00010430000006e701000041000000000010043f000006ca010000410000186f000104300000001f0530018f000006ce06300198000000400200043d0000000004620019000014de0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000155b0000c13d000014de0000013d0000000006530019000000000005004b000015690000613d0000000707000029000000000803001900000000790704340000000008980436000000000068004b000015650000c13d000000000004004b000015770000613d000700070050002d0000000304400210000000000506043300000000054501cf000000000545022f000000070700002900000000070704330000010004400089000000000747022f00000000044701cf000000000454019f00000000004604350000001f04100039000007050240019700000000013100190000000000010435000000a4012000390000061c0010009c0000061c0100804100000060011002100000000b020000290000061c0020009c0000061c020080410000004002200210000000000121019f00000000020004140000061c0020009c0000061c02008041000000c002200210000000000121019f0000000202000029186d18630000040f00000060031002700000061c03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000b057000290000159a0000613d000000000801034f0000000b09000029000000008a08043c0000000009a90436000000000059004b000015960000c13d000000000006004b000015a70000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000015be0000613d0000001f01400039000000600210018f0000000b01200029000000000021004b00000000020000390000000102004039000006270010009c000000b40000213d0000000100200190000000b40000c13d000000400010043f000000200030008c00000ec50000413d0000000b010000290000000001010433000006da0010019800000ec50000c13d0000064501100197000006d70010009c00000f730000613d000015c40000013d000000000003004b000015c80000c13d00000060020000390000000001020433000000000001004b000015f00000c13d000006f201000041000000000010043f000006ca010000410000186f000104300000001f02300039000006d8022001970000003f02200039000006d904200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000006270040009c000000b40000213d0000000100500190000000b40000c13d000000400040043f0000001f0430018f0000000006320436000006ce05300198000900000006001d0000000003560019000015e20000613d000000000601034f0000000907000029000000006806043c0000000007870436000000000037004b000015de0000c13d000000000004004b000015c10000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000015c10000013d00000009020000290000061c0020009c0000061c0200804100000040022002100000061c0010009c0000061c010080410000006001100210000000000121019f0000186f000104300000000005420019000000000004004b000016020000613d000000a006000039000000000702001900000000680604340000000007870436000000000057004b000015fe0000c13d000000000003004b0000160f0000613d000000a0044000390000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f00000000003504350000001f03100039000007050330019700000000012100190000000000010435000000a4013000390000061c0010009c0000061c0100804100000060011002100000000b020000290000061c0020009c0000061c020080410000004002200210000000000121019f00000000020004140000061c0020009c0000061c02008041000000c002200210000000000121019f0000000302000029186d18630000040f00000060031002700000061c03300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000b05700029000016320000613d000000000801034f0000000b09000029000000008a08043c0000000009a90436000000000059004b0000162e0000c13d000000000006004b0000163f0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000164f0000613d0000001f01400039000000600210018f0000000b01200029000000000021004b00000000020000390000000102004039000006270010009c000000b40000213d0000000100200190000000b40000c13d000000400010043f000000200030008c000015b60000813d00000ec50000013d000000000003004b000016530000c13d00000060020000390000167a0000013d0000001f02300039000006d8022001970000003f02200039000006d904200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000006270040009c000000b40000213d0000000100500190000000b40000c13d000000400040043f0000001f0430018f0000000006320436000006ce05300198000a00000006001d00000000035600190000166d0000613d000000000601034f0000000a07000029000000006806043c0000000007870436000000000037004b000016690000c13d000000000004004b0000167a0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b000015c40000613d0000000a02000029000015f10000013d0000062002200197000000000020043f000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f00000001002001900000168d0000613d000000000101043b000000000001042d00000000010000190000186f000104300000000043010434000000000132043600000705063001970000001f0530018f000000000014004b000016a50000813d000000000006004b000016a10000613d00000000085400190000000007510019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c0000169b0000c13d000000000005004b000016bb0000613d0000000007010019000016b10000013d0000000007610019000000000006004b000016ae0000613d00000000080400190000000009010019000000008a0804340000000009a90436000000000079004b000016aa0000c13d000000000005004b000016bb0000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f0000000000470435000000000431001900000000000404350000001f0330003900000705023001970000000001210019000000000001042d000000200300003900000000033104360000000042020434000000000023043500000705062001970000001f0520018f0000004001100039000000000014004b000016da0000813d000000000006004b000016d60000613d00000000085400190000000007510019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c000016d00000c13d000000000005004b000016f00000613d0000000007010019000016e60000013d0000000007610019000000000006004b000016e30000613d00000000080400190000000009010019000000008a0804340000000009a90436000000000079004b000016df0000c13d000000000005004b000016f00000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f0000000000470435000000000412001900000000000404350000001f0220003900000705022001970000000001120019000000000001042d0000001f0220003900000705022001970000000001120019000000000021004b00000000020000390000000102004039000006270010009c000017020000213d0000000100200190000017020000c13d000000400010043f000000000001042d000006e501000041000000000010043f0000004101000039000000040010043f000006bf010000410000186f00010430000000400100043d000007080010009c0000170e0000813d0000004002100039000000400020043f000000000001042d000006e501000041000000000010043f0000004101000039000000040010043f000006bf010000410000186f00010430000000000301001900000000011200a9000000000003004b0000171b0000613d00000000033100d9000000000023004b0000171c0000c13d000000000001042d000006e501000041000000000010043f0000001101000039000000040010043f000006bf010000410000186f00010430000000000100041a00000620021001970000000001000411000000000012004b000017280000c13d000000000001042d000006be02000041000000000020043f000000040010043f000006bf010000410000186f000104300004000000000002000200000002001d000000000002004b000017e70000613d00000000030100190000000301000039000000000101041a000400000001001d0000000f01000039000000000201041a000006cf00200198000017840000613d000100000003001d000000400400043d000300000004001d000006d001000041000000000014043500000000010004110000062001100197000000040340003900000000001304350000061c0040009c0000061c010000410000000001044019000000400110021000000000030004140000061c0030009c0000061c03008041000000c003300210000000000113019f000006bf011001c700000018022002700000062002200197186d18680000040f000000030b00002900000060031002700000061c03300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b00190000175f0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b0000175b0000c13d000000000006004b0000176c0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000017f00000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000006270010009c0000180e0000213d00000001002001900000180e0000c13d000000400010043f0000001f0030008c000017df0000a13d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b000017df0000c13d000000000001004b0000000103000029000018140000613d0000062001300197000300000001001d000000000010043f0000000801000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f0000000100200190000017df0000613d0000000202000029000006e6022000d1000000000101043b000000000301041a0000000002230019000000000021041b000006d101000041000000000010044300000000010004140000061c0010009c0000061c01008041000000c001100210000006d2011001c70000800b02000039186d18680000040f0000000100200190000017eb0000613d000000000101043b000100000001001d0000000401000029000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f0000000100200190000017df0000613d0000000102000029000000a0022002100000000203000029000000010030008c0000000003000019000006d303006041000000000223019f0000000306000029000000000262019f000000000101043b000000000021041b00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d020000390000000403000039000006d40400004100000000050000190000000407000029186d18630000040f00000004070000290000000100200190000017df0000613d000200020070002d0000000107700039000000020070006c000017e10000613d00000000010004140000061c0010009c0000061c01008041000000c00110021000000621011001c70000800d020000390000000403000039000006d40400004100000000050000190000000306000029000400000007001d0000000407000029186d18630000040f00000004070000290000000100200190000017cc0000c13d00000000010000190000186f00010430000000030000006b000017ec0000613d00000003010000390000000202000029000000000021041b000000000001042d000006e801000041000000000010043f000006ca010000410000186f00010430000000000001042f000006e701000041000000000010043f000006ca010000410000186f000104300000001f0530018f000006ce06300198000000400200043d0000000004620019000017fb0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000017f70000c13d000000000005004b000018080000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f000000000014043500000060013002100000061c0020009c0000061c020080410000004002200210000000000112019f0000186f00010430000006e501000041000000000010043f0000004101000039000000040010043f000006bf010000410000186f00010430000006f701000041000000000010043f000006ca010000410000186f000104300001000000000002000000000001004b000018490000613d000100000001001d000000000010043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f0000000100200190000018470000613d000000000101043b000000000101041a000006c3001001980000000102000029000018490000c13d000000000001004b000018460000c13d0000000301000039000000000101041a000000000021004b000018490000a13d000000010220008a000100000002001d000000000020043f0000000701000039000000200010043f00000000010004140000061c0010009c0000061c01008041000000c001100210000006c2011001c70000801002000039186d18680000040f0000000100200190000018470000613d000000000101043b000000000101041a000000000001004b0000000102000029000018330000613d000000000001042d00000000010000190000186f00010430000006fc01000041000000000010043f000006ca010000410000186f00010430000000000001042f0000061c0010009c0000061c0100804100000040011002100000061c0020009c0000061c020080410000006002200210000000000112019f00000000020004140000061c0020009c0000061c02008041000000c002200210000000000112019f00000621011001c70000801002000039186d18680000040f0000000100200190000018610000613d000000000101043b000000000001042d00000000010000190000186f0001043000001866002104210000000102000039000000000001042d0000000002000019000000000001042d0000186b002104230000000102000039000000000001042d0000000002000019000000000001042d0000186d000004320000186e0001042e0000186f0001043000000000000000000000000000000000000000000000000000000000ffffffff4675677a000000000000000000000000000000000000000000000000000000004655475a00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff02000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e00000000000000000000000000000000000000000000000010000000000000000fc949c7b4a13586e39d89eead2f38644f9fb3efb5a0490b14f8fc0ceab44c250036b6384b5eca791c62761152d0c79bb0604c104a5fb6f4eb0703f3154bb3db00200000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff09addddcec1d7ba6ad726df49aeea3e93fb0c1037d551236841a60c0c883f2c1f652222313e28459528d920b65115c16c04f3efc82aaedc97be59f3f377c0d3f0000000000000000000000000000000000000000000000000001643ed78e0705000000000000000000000000bdb9e0b47a02c45e3b50973a18452dc23ce72697ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00001b6847dc741a1b0cd08d278845f9d819d87b734759afb55fe2de5cb82a9ae672e497b8238be5e4f32f72d877ba0627e627848cb8a6504aa01d21a347d565198ece133de58ba1c6975fb16a8f1bbda43e7057fe6397fd7e694ab92e9963dff39831ecc21a745e3968a04e9570e4425bc18fa8019c68028196b546d1669c200c6c68747470733a2f2f6d696e746966792d6c61756e63687061642e6e7963332e6331ecc21a745e3968a04e9570e4425bc18fa8019c68028196b546d1669c200c68646e2e6469676974616c6f6365616e7370616365732e636f6d2f63323834316631ecc21a745e3968a04e9570e4425bc18fa8019c68028196b546d1669c200c6936612d306530302d343437302d613933312d6434393239613962343232652e7031ecc21a745e3968a04e9570e4425bc18fa8019c68028196b546d1669c200c6a6e6700000000000000000000000000000000000000000000000000000000000031ecc21a745e3968a04e9570e4425bc18fa8019c68028196b546d1669c200c6b00000000000000000000000000000000000000000000000000000000682f1fd0000000000000000000000000000000000000000000000000000000006830715000000000000000000000000000000000000000000000000000d19c2ff9bf800099558795d61a4d9acfc5f63d1e6061788a850b67a7d4f8e03f7b5b32f7c865ad0000000000000000000000000000000000000000000000000000000068307f60b0d333d0e0795a18292fb4ec2f0eb5fa6f0166bd0c83600ab782c6007b5f0878000000000000000000000000000000000000000000000000000000006830b7a000000000000000000000000000000000000000000000000000d8b72d434c80007d3e3dbe000000000000000000000000000000000000000000000000000000000000000000000000000000003cc6cdda760b79bafa08df41ecfa224f810dceb60000000000000000000000000000000000000044000000000000000000000000000000000000000000000000000000000000aaeb6d7670e522a718067333cd4effffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffbf000000000000000000000000573ded42cde7380452e3a055944138608ef45e120000000000000000000000fa573ded42cde7380452e3a055944138608ef45e120000000200000000000000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000006f8b44af00000000000000000000000000000000000000000000000000000000aa60bdcf00000000000000000000000000000000000000000000000000000000d2762b4500000000000000000000000000000000000000000000000000000000e5e2a0f500000000000000000000000000000000000000000000000000000000f2fde38a00000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000f3f119f100000000000000000000000000000000000000000000000000000000fb796e6c00000000000000000000000000000000000000000000000000000000e5e2a0f600000000000000000000000000000000000000000000000000000000e985e9c500000000000000000000000000000000000000000000000000000000ed9aab5100000000000000000000000000000000000000000000000000000000e079e46000000000000000000000000000000000000000000000000000000000e079e46100000000000000000000000000000000000000000000000000000000e1136b3d00000000000000000000000000000000000000000000000000000000e56e9ac000000000000000000000000000000000000000000000000000000000d2762b4600000000000000000000000000000000000000000000000000000000d5abeb0100000000000000000000000000000000000000000000000000000000b88d4fdd00000000000000000000000000000000000000000000000000000000c87b56dc00000000000000000000000000000000000000000000000000000000c87b56dd00000000000000000000000000000000000000000000000000000000cafd705f00000000000000000000000000000000000000000000000000000000d1c026c900000000000000000000000000000000000000000000000000000000b88d4fde00000000000000000000000000000000000000000000000000000000c3d923a600000000000000000000000000000000000000000000000000000000abd017e900000000000000000000000000000000000000000000000000000000abd017ea00000000000000000000000000000000000000000000000000000000ac19701b00000000000000000000000000000000000000000000000000000000b7c0b8e800000000000000000000000000000000000000000000000000000000aa60bdd000000000000000000000000000000000000000000000000000000000ab7b499300000000000000000000000000000000000000000000000000000000871215d30000000000000000000000000000000000000000000000000000000096db3e8800000000000000000000000000000000000000000000000000000000a42c05b900000000000000000000000000000000000000000000000000000000a42c05ba00000000000000000000000000000000000000000000000000000000a70138c100000000000000000000000000000000000000000000000000000000aa0678ff0000000000000000000000000000000000000000000000000000000096db3e89000000000000000000000000000000000000000000000000000000009e5f94a700000000000000000000000000000000000000000000000000000000a22cb465000000000000000000000000000000000000000000000000000000008e9a85f2000000000000000000000000000000000000000000000000000000008e9a85f30000000000000000000000000000000000000000000000000000000095d89b410000000000000000000000000000000000000000000000000000000096ce3bfa00000000000000000000000000000000000000000000000000000000871215d4000000000000000000000000000000000000000000000000000000008da5cb5b0000000000000000000000000000000000000000000000000000000076ee0152000000000000000000000000000000000000000000000000000000007d4b5a20000000000000000000000000000000000000000000000000000000007d4b5a21000000000000000000000000000000000000000000000000000000007f371aa000000000000000000000000000000000000000000000000000000000858633f20000000000000000000000000000000000000000000000000000000076ee01530000000000000000000000000000000000000000000000000000000079544c8600000000000000000000000000000000000000000000000000000000715018a500000000000000000000000000000000000000000000000000000000715018a60000000000000000000000000000000000000000000000000000000071be5e140000000000000000000000000000000000000000000000000000000072b0d90c000000000000000000000000000000000000000000000000000000006f8b44b00000000000000000000000000000000000000000000000000000000070a082310000000000000000000000000000000000000000000000000000000041d94c9700000000000000000000000000000000000000000000000000000000545b70b1000000000000000000000000000000000000000000000000000000005c1afeca0000000000000000000000000000000000000000000000000000000064f52a1e0000000000000000000000000000000000000000000000000000000064f52a1f0000000000000000000000000000000000000000000000000000000065216a4100000000000000000000000000000000000000000000000000000000691ce970000000000000000000000000000000000000000000000000000000005c1afecb000000000000000000000000000000000000000000000000000000005d99a0cf000000000000000000000000000000000000000000000000000000006352211e0000000000000000000000000000000000000000000000000000000055f804b20000000000000000000000000000000000000000000000000000000055f804b3000000000000000000000000000000000000000000000000000000005944c7530000000000000000000000000000000000000000000000000000000059a2f3bd00000000000000000000000000000000000000000000000000000000545b70b20000000000000000000000000000000000000000000000000000000055f5f06600000000000000000000000000000000000000000000000000000000484b973b000000000000000000000000000000000000000000000000000000004ed69eae000000000000000000000000000000000000000000000000000000004ed69eaf000000000000000000000000000000000000000000000000000000004f115db1000000000000000000000000000000000000000000000000000000005438943700000000000000000000000000000000000000000000000000000000484b973c000000000000000000000000000000000000000000000000000000004b21839e0000000000000000000000000000000000000000000000000000000042b5e15b0000000000000000000000000000000000000000000000000000000042b5e15c00000000000000000000000000000000000000000000000000000000462fed140000000000000000000000000000000000000000000000000000000046fff98d0000000000000000000000000000000000000000000000000000000041d94c980000000000000000000000000000000000000000000000000000000042842e0e0000000000000000000000000000000000000000000000000000000018160ddc0000000000000000000000000000000000000000000000000000000030a08964000000000000000000000000000000000000000000000000000000003c6d5761000000000000000000000000000000000000000000000000000000003c6d5762000000000000000000000000000000000000000000000000000000003ccfd60b00000000000000000000000000000000000000000000000000000000406466a70000000000000000000000000000000000000000000000000000000030a089650000000000000000000000000000000000000000000000000000000030db1d5b000000000000000000000000000000000000000000000000000000003bf303940000000000000000000000000000000000000000000000000000000023b872dc0000000000000000000000000000000000000000000000000000000023b872dd00000000000000000000000000000000000000000000000000000000251c21ec000000000000000000000000000000000000000000000000000000002a55205a0000000000000000000000000000000000000000000000000000000018160ddd0000000000000000000000000000000000000000000000000000000021b8acd700000000000000000000000000000000000000000000000000000000081812fb000000000000000000000000000000000000000000000000000000000c92b630000000000000000000000000000000000000000000000000000000000c92b631000000000000000000000000000000000000000000000000000000000d4c18280000000000000000000000000000000000000000000000000000000012b3651000000000000000000000000000000000000000000000000000000000081812fc00000000000000000000000000000000000000000000000000000000095ea7b30000000000000000000000000000000000000000000000000000000004634d8c0000000000000000000000000000000000000000000000000000000004634d8d0000000000000000000000000000000000000000000000000000000006fdde03000000000000000000000000000000000000000000000000000000000759f2d8000000000000000000000000000000000000000000000000000000000141a4490000000000000000000000000000000000000000000000000000000001ffc9a70000000000000000000000000000000000000020000000800000000000000000118cdaa70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000001e4fbdf70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000200000000000000000000000000000000000040000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff30000000000000000000000000000000000000000000000000000000000000002f000000000000000000000000000000000000000000000000000000000000002e6a736f6e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffdfa14c4b50000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff7f00000000000000000000000000000000000000000000c6171134001122334455000000000000000000000000000000000000004400000016000000000000000000000000000000000000000000000000000000000000000000000000ffffffe00000000000000000000000000000000000000000000000000000000000ff0000e18bc08a00000000000000000000000000000000000000000000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d9553913202000002000000000000000000000000000000040000000000000000000000000000000200000000000000000000000000000000000000000000000000000000ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef1806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000150b7a020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000003ffffffe000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000ffffffffffffffffffffffffffffffffffffffff000000ffffffffffffffffff0000000000000000000000000000000000000000ffffff17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c317fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe02b5dffd9914ddb43acdb6963bacf053a87bf9354300844f6339f17741e25145ab05e92fa000000000000000000000000000000000000000000000000000000009cc7f708afc65944829bd487b90b72536b1951864fbfc14e125fc972a6507f398f4eb604000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000fc4c6036000000000000000000000000000000000000000000000000000000004e487b710000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000012e07630000000000000000000000000000000000000000000000000000000000b562e8dd000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff969f0852000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffe048e71000000000000000000000000000000000000000000000000000000000dd4e010600000000000000000000000000000000000000000000000000000000327c6a56000000000000000000000000000000000000000000000000000000008a164f6300000000000000000000000000000000000000000000000000000000cd0081c200000000000000000000000000000000000000000000000000000000d1a57ed60000000000000000000000000000000000000000000000000000000090b8ec18000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000a11481000000000000000000000000000000000000000000000000000000000059c896be000000000000000000000000000000000000000000000000000000004c80d8be00000000000000000000000000000000000000000000000000000000ea553b3400000000000000000000000000000000000000000000000000000000db89e3f400000000000000000000000000000000000000000000000000000000cfb3b942000000000000000000000000000000000000000000000000000000008c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925df2d9b4200000000000000000000000000000000000000000000000000000000cf4700e400000000000000000000000000000000000000000000000000000000b6d9900a00000000000000000000000000000000000000000000000000000000f4df6ae50000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000005b5e139f0000000000000000000000000000000000000000000000000000000080ac58cd000000000000000000000000000000000000000000000000000000002a55205a00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff000000000000000000000000000000000000000000000000ffffffffffffffc00000000000000000000000000000000000000000000000000000000000000000fce991db9f473d71c110119677bf52dc41f862678aece9e99aa80ab60de38e1d
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.