ERC-721
Overview
Max Total Supply
2 BNFT
Holders
1
Market
Onchain Market Cap
$0.00
Circulating Supply Market Cap
-
Other Info
Token Contract
Balance
2 BNFTLoading...
Loading
Loading...
Loading
Loading...
Loading
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Source Code Verified (Exact Match)
Contract Name:
BuildERC721AC
Compiler Version
v0.8.27+commit.40a35a09
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.27;
import {ERC721ACQueryable, ERC721A, IERC721A} from "./interfaces/creator-token/src/erc721c/extensions/ERC721ACQueryable.sol";
import {MerkleProofLib} from "./interfaces/solady/utils/MerkleProofLib.sol";
import {SafeTransferLib} from "./interfaces/solady/utils/ext/zksync/SafeTransferLib.sol";
import {ERC2981} from "./interfaces/solady/tokens/ERC2981.sol";
import {Ownable} from "./interfaces/solady/auth/Ownable.sol";
contract BuildERC721AC is ERC721ACQueryable, Ownable, ERC2981 {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The user already minted for phase.
error AlreadyMinted();
/// @dev The total supply reached MAX_SUPPLY.
error MaxSupplyReached();
/// @dev The Merkle proof is not valid.
error IncorrectProof();
/// @dev The `msg.value` is incorrect.
error IncorrectValue();
/// @dev Mint not started yet.
error MintNotStarted();
/// @dev The minting phase has started.
error PhaseAlreadyStarted();
/// @dev Public Mint has started.
error PublicMintStarted();
/// @dev Not allow to do action.
error NotAllowed();
/// @dev Only Upto 10 tokens allow to mint.
error Maximum10MintedAllowed();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CONSTANT */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Maximum supply of tokens.
uint256 public constant MAX_SUPPLY = 10000;
/// @dev The price for WL whitelist and public user.
uint256 public constant MINT_PRICE = 0.00001 ether;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* STORAGE */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev OG whitelist mint start timestamp.
uint40 public OG_MINT_TIMESTAMP;
/// @dev WL whitelist mint start timestamp.
uint40 public WL_MINT_TIMESTAMP;
/// @dev OG2 whitelist mint start timestamp.
uint40 public OG2_MINT_TIMESTAMP;
/// @dev The public mint start timestamp.
uint40 public PUBLIC_MINT_TIMESTAMP;
/// @dev Flag for a allow to transfer/trade.
uint8 startTransfer;
/// @dev The merkle root for OG whitelist.
bytes32 public ogMerkleRoot;
/// @dev The merkle root for WL whitelist.
bytes32 public wlMerkleRoot;
/// @dev The baseURI for a token.
string private baseURI;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CONSTRUCTOR */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
constructor(
string memory _name,
string memory _symbol,
address _owner,
uint40 ogTimestamp,
uint40 wlTimestamp,
uint40 og2Timestamp,
uint40 pbTimestamp
) ERC721ACQueryable(_name, _symbol) {
_initializeOwner(_owner);
OG_MINT_TIMESTAMP = ogTimestamp;
OG2_MINT_TIMESTAMP = og2Timestamp;
WL_MINT_TIMESTAMP = wlTimestamp;
PUBLIC_MINT_TIMESTAMP = pbTimestamp;
// Mint first token to deployer
_safeMint(msg.sender, 1);
_setDefaultRoyalty(_owner, 500);
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* MODIFIERS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Modifier for the checking transfer is allowed.
modifier _isTransferable() {
if (startTransfer == 0) revert NotAllowed();
_;
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* MINT OPERATIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Mints tokens for og whitelisted addresses.
function ogMint(address to, bool freeMint, uint64 paidMintQty, uint64 numOfRing, bytes32[] memory _merkleProof)
external
payable
{
if (OG_MINT_TIMESTAMP <= block.timestamp && block.timestamp < WL_MINT_TIMESTAMP) {
// Validate Merkle proof for OG whitelist
if (!MerkleProofLib.verify(_merkleProof, ogMerkleRoot, keccak256(abi.encode(msg.sender, numOfRing)))) {
revert IncorrectProof();
}
if (freeMint) {
// Free OG mint
_ogMint(to, numOfRing);
}
if (paidMintQty != 0) {
// Paid OG mint
_ogPaidMint(to, paidMintQty, numOfRing);
}
return;
}
revert PublicMintStarted();
}
/// @dev Mints tokens for wl whitelisted addresses.
function wlMint(address to, bytes32[] memory _merkleProof) external payable {
if (WL_MINT_TIMESTAMP <= block.timestamp && block.timestamp < OG2_MINT_TIMESTAMP) {
// Validate Merkle proof for OG whitelist
if (!MerkleProofLib.verify(_merkleProof, wlMerkleRoot, keccak256(abi.encodePacked(msg.sender)))) {
revert IncorrectProof();
}
if (_totalMinted() + 1 > MAX_SUPPLY) revert MaxSupplyReached();
uint64 aux = _getAux(msg.sender);
// Check the address `to` has not minted in the WL phase
if ((aux & 16) != 0) revert AlreadyMinted();
// Checks the correct Ether value is sent for the WL mint
if (msg.value != MINT_PRICE) revert IncorrectValue();
_setAux(msg.sender, aux | 16); // Set WL mint flag
_safeMint(to, 1); // Mint 1 token to `to`
return;
}
revert PublicMintStarted();
}
/// @dev Mints tokens for OG whitelisted addresses in Phase 2.
function og2Mint(address to, uint64 paidMintQty, uint64 numOfRing, bytes32[] memory _merkleProof)
external
payable
{
if (OG2_MINT_TIMESTAMP <= block.timestamp && block.timestamp < PUBLIC_MINT_TIMESTAMP) {
// Validate Merkle proof for OG whitelist
if (!MerkleProofLib.verify(_merkleProof, ogMerkleRoot, keccak256(abi.encode(msg.sender, numOfRing)))) {
revert IncorrectProof();
}
if (_totalMinted() + 1 > MAX_SUPPLY) revert MaxSupplyReached();
// Paid OG mint
_og2PaidMint(to, paidMintQty, numOfRing);
return;
}
revert PublicMintStarted();
}
/// @dev Mints `quantity` of tokens for `msg.sender`.
function publicMint(address to, uint64 quantity) external payable {
//if (block.timestamp < PUBLIC_MINT_TIMESTAMP) revert MintNotStarted();
if (msg.value != MINT_PRICE * quantity) revert IncorrectValue();
if (_totalMinted() + quantity > MAX_SUPPLY) revert MaxSupplyReached();
uint64 aux = _getAux(msg.sender);
uint256 mint = (aux & 15) + quantity;
if (mint > 10) revert Maximum10MintedAllowed();
_setAux(msg.sender, aux + quantity);
_safeMint(to, quantity);
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* OWNER OPERATIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Set flag to allow transfers/trading.
/// Note: Once the owner allows transfer, it cannot be undo.
function allowTransfer() external onlyOwner {
startTransfer = uint8(1);
}
/// @dev Sets the sale phase timestamps.
/// Note:
/// Once phase started nobody can changed timestamp for this.
function setTimestamp(uint256 phase, uint40 newTimeStamp) external onlyOwner {
if (phase == 0) {
if (block.timestamp >= OG_MINT_TIMESTAMP) {
revert PhaseAlreadyStarted();
}
OG_MINT_TIMESTAMP = newTimeStamp;
} else if (phase == 1) {
if (block.timestamp >= WL_MINT_TIMESTAMP) {
revert PhaseAlreadyStarted();
}
WL_MINT_TIMESTAMP = newTimeStamp;
} else if (phase == 2) {
if (block.timestamp >= OG2_MINT_TIMESTAMP) {
revert PhaseAlreadyStarted();
}
OG2_MINT_TIMESTAMP = newTimeStamp;
} else {
if (block.timestamp >= PUBLIC_MINT_TIMESTAMP) {
revert PhaseAlreadyStarted();
}
PUBLIC_MINT_TIMESTAMP = newTimeStamp;
}
}
/// @dev Withdraws all available ethers to `to`.
function withdrawETH(address to) external onlyOwner {
SafeTransferLib.safeTransferAllETH(to);
}
/// @dev Sets `baseURI` for `baseURI()`.
function setBaseURI(string memory baseURI_) external onlyOwner {
baseURI = baseURI_;
}
/// @dev Sets the `ogMerkleRoot` or `wlMerkleRoot` for whitelist mint.
function setRoot(bytes32 ogRoot, bytes32 wlRoot) external onlyOwner {
if (ogRoot != ogMerkleRoot) {
if (block.timestamp >= OG_MINT_TIMESTAMP) revert NotAllowed();
ogMerkleRoot = ogRoot;
}
if (wlRoot != wlMerkleRoot) {
if (block.timestamp >= WL_MINT_TIMESTAMP) revert NotAllowed();
wlMerkleRoot = wlRoot;
}
}
/// @dev Sets the default royalty `receiver` and `feeNumerator`.
function setDefaultRoyalty(address receiver, uint96 feeNumerator) external onlyOwner {
_setDefaultRoyalty(receiver, feeNumerator);
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* INTERNAL FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Mint tokens to `to`.
function _ogMint(address to, uint64 numOfRings) internal {
uint64 aux = _getAux(msg.sender);
if ((aux >> 5) & 0x3ff == numOfRings) revert AlreadyMinted();
_setAux(msg.sender, uint64(aux | (numOfRings << 5))); // Set OG free mint flag
_safeMint(to, numOfRings);
}
/// @dev Mint tokens to `to`.
function _ogPaidMint(address to, uint64 qty, uint64 numOfRings) internal {
if (msg.value != (MINT_PRICE * qty)) revert IncorrectValue();
uint64 aux = _getAux(msg.sender);
uint64 mint = ((aux >> 15) & 0x7ff) + qty;
if (mint > (numOfRings << 1)) revert AlreadyMinted();
_setAux(msg.sender, uint64(aux + (qty << 15))); // Set OG paid mint flag
_safeMint(to, qty);
}
/// @dev Mint tokens to `to`.
function _og2PaidMint(address to, uint64 qty, uint64 numOfRings) internal {
if (msg.value != (MINT_PRICE * qty)) revert IncorrectValue();
uint64 aux = _getAux(msg.sender);
uint64 mint = ((aux >> 26) & 0x7ff) + qty;
if (mint > (numOfRings << 1)) revert AlreadyMinted();
_setAux(msg.sender, uint64(aux + (qty << 26))); // Set OG2 paid mint flag
_safeMint(to, qty);
}
/// @dev Returns `baseURI`.
function _baseURI() internal view override(ERC721A) returns (string memory) {
return baseURI;
}
/// @dev Start minting token id from `1`.
function _startTokenId() internal pure override returns (uint256) {
return 1;
}
/// @dev See {ERC721A-supportsInterface}.
function supportsInterface(bytes4 interfaceId)
public
view
virtual
override(ERC721ACQueryable, ERC2981)
returns (bool)
{
return ERC721ACQueryable.supportsInterface(interfaceId) || ERC2981.supportsInterface(interfaceId);
}
/// @dev Throws if the sender is not the owner.
function _requireCallerIsContractOwner() internal view virtual override {
_checkOwner();
}
/// @dev Transfers token `id` from `from` to `to`.
/// Note: Requires `startTransfer != 0`.
function transferFrom(address from, address to, uint256 id)
public
payable
override(ERC721A, IERC721A)
_isTransferable
{
super.transferFrom(from, to, id);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
/// @notice Gas optimized verification of proof of inclusion for a leaf in a Merkle tree.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/MerkleProofLib.sol)
/// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/MerkleProofLib.sol)
/// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/cryptography/MerkleProof.sol)
library MerkleProofLib {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* MERKLE PROOF VERIFICATION OPERATIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Returns whether `leaf` exists in the Merkle tree with `root`, given `proof`.
function verify(bytes32[] memory proof, bytes32 root, bytes32 leaf)
internal
pure
returns (bool isValid)
{
/// @solidity memory-safe-assembly
assembly {
if mload(proof) {
// Initialize `offset` to the offset of `proof` elements in memory.
let offset := add(proof, 0x20)
// Left shift by 5 is equivalent to multiplying by 0x20.
let end := add(offset, shl(5, mload(proof)))
// Iterate over proof elements to compute root hash.
for {} 1 {} {
// Slot of `leaf` in scratch space.
// If the condition is true: 0x20, otherwise: 0x00.
let scratch := shl(5, gt(leaf, mload(offset)))
// Store elements to hash contiguously in scratch space.
// Scratch space is 64 bytes (0x00 - 0x3f) and both elements are 32 bytes.
mstore(scratch, leaf)
mstore(xor(scratch, 0x20), mload(offset))
// Reuse `leaf` to store the hash to reduce stack operations.
leaf := keccak256(0x00, 0x40)
offset := add(offset, 0x20)
if iszero(lt(offset, end)) { break }
}
}
isValid := eq(leaf, root)
}
}
/// @dev Returns whether `leaf` exists in the Merkle tree with `root`, given `proof`.
function verifyCalldata(bytes32[] calldata proof, bytes32 root, bytes32 leaf)
internal
pure
returns (bool isValid)
{
/// @solidity memory-safe-assembly
assembly {
if proof.length {
// Left shift by 5 is equivalent to multiplying by 0x20.
let end := add(proof.offset, shl(5, proof.length))
// Initialize `offset` to the offset of `proof` in the calldata.
let offset := proof.offset
// Iterate over proof elements to compute root hash.
for {} 1 {} {
// Slot of `leaf` in scratch space.
// If the condition is true: 0x20, otherwise: 0x00.
let scratch := shl(5, gt(leaf, calldataload(offset)))
// Store elements to hash contiguously in scratch space.
// Scratch space is 64 bytes (0x00 - 0x3f) and both elements are 32 bytes.
mstore(scratch, leaf)
mstore(xor(scratch, 0x20), calldataload(offset))
// Reuse `leaf` to store the hash to reduce stack operations.
leaf := keccak256(0x00, 0x40)
offset := add(offset, 0x20)
if iszero(lt(offset, end)) { break }
}
}
isValid := eq(leaf, root)
}
}
/// @dev Returns whether all `leaves` exist in the Merkle tree with `root`,
/// given `proof` and `flags`.
///
/// Note:
/// - Breaking the invariant `flags.length == (leaves.length - 1) + proof.length`
/// will always return false.
/// - The sum of the lengths of `proof` and `leaves` must never overflow.
/// - Any non-zero word in the `flags` array is treated as true.
/// - The memory offset of `proof` must be non-zero
/// (i.e. `proof` is not pointing to the scratch space).
function verifyMultiProof(
bytes32[] memory proof,
bytes32 root,
bytes32[] memory leaves,
bool[] memory flags
) internal pure returns (bool isValid) {
// Rebuilds the root by consuming and producing values on a queue.
// The queue starts with the `leaves` array, and goes into a `hashes` array.
// After the process, the last element on the queue is verified
// to be equal to the `root`.
//
// The `flags` array denotes whether the sibling
// should be popped from the queue (`flag == true`), or
// should be popped from the `proof` (`flag == false`).
/// @solidity memory-safe-assembly
assembly {
// Cache the lengths of the arrays.
let leavesLength := mload(leaves)
let proofLength := mload(proof)
let flagsLength := mload(flags)
// Advance the pointers of the arrays to point to the data.
leaves := add(0x20, leaves)
proof := add(0x20, proof)
flags := add(0x20, flags)
// If the number of flags is correct.
for {} eq(add(leavesLength, proofLength), add(flagsLength, 1)) {} {
// For the case where `proof.length + leaves.length == 1`.
if iszero(flagsLength) {
// `isValid = (proof.length == 1 ? proof[0] : leaves[0]) == root`.
isValid := eq(mload(xor(leaves, mul(xor(proof, leaves), proofLength))), root)
break
}
// The required final proof offset if `flagsLength` is not zero, otherwise zero.
let proofEnd := add(proof, shl(5, proofLength))
// We can use the free memory space for the queue.
// We don't need to allocate, since the queue is temporary.
let hashesFront := mload(0x40)
// Copy the leaves into the hashes.
// Sometimes, a little memory expansion costs less than branching.
// Should cost less, even with a high free memory offset of 0x7d00.
leavesLength := shl(5, leavesLength)
for { let i := 0 } iszero(eq(i, leavesLength)) { i := add(i, 0x20) } {
mstore(add(hashesFront, i), mload(add(leaves, i)))
}
// Compute the back of the hashes.
let hashesBack := add(hashesFront, leavesLength)
// This is the end of the memory for the queue.
// We recycle `flagsLength` to save on stack variables (sometimes save gas).
flagsLength := add(hashesBack, shl(5, flagsLength))
for {} 1 {} {
// Pop from `hashes`.
let a := mload(hashesFront)
// Pop from `hashes`.
let b := mload(add(hashesFront, 0x20))
hashesFront := add(hashesFront, 0x40)
// If the flag is false, load the next proof,
// else, pops from the queue.
if iszero(mload(flags)) {
// Loads the next proof.
b := mload(proof)
proof := add(proof, 0x20)
// Unpop from `hashes`.
hashesFront := sub(hashesFront, 0x20)
}
// Advance to the next flag.
flags := add(flags, 0x20)
// Slot of `a` in scratch space.
// If the condition is true: 0x20, otherwise: 0x00.
let scratch := shl(5, gt(a, b))
// Hash the scratch space and push the result onto the queue.
mstore(scratch, a)
mstore(xor(scratch, 0x20), b)
mstore(hashesBack, keccak256(0x00, 0x40))
hashesBack := add(hashesBack, 0x20)
if iszero(lt(hashesBack, flagsLength)) { break }
}
isValid :=
and(
// Checks if the last value in the queue is same as the root.
eq(mload(sub(hashesBack, 0x20)), root),
// And whether all the proofs are used, if required.
eq(proofEnd, proof)
)
break
}
}
}
/// @dev Returns whether all `leaves` exist in the Merkle tree with `root`,
/// given `proof` and `flags`.
///
/// Note:
/// - Breaking the invariant `flags.length == (leaves.length - 1) + proof.length`
/// will always return false.
/// - Any non-zero word in the `flags` array is treated as true.
/// - The calldata offset of `proof` must be non-zero
/// (i.e. `proof` is from a regular Solidity function with a 4-byte selector).
function verifyMultiProofCalldata(
bytes32[] calldata proof,
bytes32 root,
bytes32[] calldata leaves,
bool[] calldata flags
) internal pure returns (bool isValid) {
// Rebuilds the root by consuming and producing values on a queue.
// The queue starts with the `leaves` array, and goes into a `hashes` array.
// After the process, the last element on the queue is verified
// to be equal to the `root`.
//
// The `flags` array denotes whether the sibling
// should be popped from the queue (`flag == true`), or
// should be popped from the `proof` (`flag == false`).
/// @solidity memory-safe-assembly
assembly {
// If the number of flags is correct.
for {} eq(add(leaves.length, proof.length), add(flags.length, 1)) {} {
// For the case where `proof.length + leaves.length == 1`.
if iszero(flags.length) {
// `isValid = (proof.length == 1 ? proof[0] : leaves[0]) == root`.
// forgefmt: disable-next-item
isValid := eq(
calldataload(
xor(leaves.offset, mul(xor(proof.offset, leaves.offset), proof.length))
),
root
)
break
}
// The required final proof offset if `flagsLength` is not zero, otherwise zero.
let proofEnd := add(proof.offset, shl(5, proof.length))
// We can use the free memory space for the queue.
// We don't need to allocate, since the queue is temporary.
let hashesFront := mload(0x40)
// Copy the leaves into the hashes.
// Sometimes, a little memory expansion costs less than branching.
// Should cost less, even with a high free memory offset of 0x7d00.
calldatacopy(hashesFront, leaves.offset, shl(5, leaves.length))
// Compute the back of the hashes.
let hashesBack := add(hashesFront, shl(5, leaves.length))
// This is the end of the memory for the queue.
// We recycle `flagsLength` to save on stack variables (sometimes save gas).
flags.length := add(hashesBack, shl(5, flags.length))
// We don't need to make a copy of `proof.offset` or `flags.offset`,
// as they are pass-by-value (this trick may not always save gas).
for {} 1 {} {
// Pop from `hashes`.
let a := mload(hashesFront)
// Pop from `hashes`.
let b := mload(add(hashesFront, 0x20))
hashesFront := add(hashesFront, 0x40)
// If the flag is false, load the next proof,
// else, pops from the queue.
if iszero(calldataload(flags.offset)) {
// Loads the next proof.
b := calldataload(proof.offset)
proof.offset := add(proof.offset, 0x20)
// Unpop from `hashes`.
hashesFront := sub(hashesFront, 0x20)
}
// Advance to the next flag offset.
flags.offset := add(flags.offset, 0x20)
// Slot of `a` in scratch space.
// If the condition is true: 0x20, otherwise: 0x00.
let scratch := shl(5, gt(a, b))
// Hash the scratch space and push the result onto the queue.
mstore(scratch, a)
mstore(xor(scratch, 0x20), b)
mstore(hashesBack, keccak256(0x00, 0x40))
hashesBack := add(hashesBack, 0x20)
if iszero(lt(hashesBack, flags.length)) { break }
}
isValid :=
and(
// Checks if the last value in the queue is same as the root.
eq(mload(sub(hashesBack, 0x20)), root),
// And whether all the proofs are used, if required.
eq(proofEnd, proof.offset)
)
break
}
}
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* EMPTY CALLDATA HELPERS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Returns an empty calldata bytes32 array.
function emptyProof() internal pure returns (bytes32[] calldata proof) {
/// @solidity memory-safe-assembly
assembly {
proof.length := 0
}
}
/// @dev Returns an empty calldata bytes32 array.
function emptyLeaves() internal pure returns (bytes32[] calldata leaves) {
/// @solidity memory-safe-assembly
assembly {
leaves.length := 0
}
}
/// @dev Returns an empty calldata bool array.
function emptyFlags() internal pure returns (bool[] calldata flags) {
/// @solidity memory-safe-assembly
assembly {
flags.length := 0
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
/// @notice Simple ERC2981 NFT Royalty Standard implementation.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/tokens/ERC2981.sol)
/// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/token/common/ERC2981.sol)
abstract contract ERC2981 {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The royalty fee numerator exceeds the fee denominator.
error RoyaltyOverflow();
/// @dev The royalty receiver cannot be the zero address.
error RoyaltyReceiverIsZeroAddress();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* STORAGE */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The default royalty info is given by:
/// ```
/// let packed := sload(_ERC2981_MASTER_SLOT_SEED)
/// let receiver := shr(96, packed)
/// let royaltyFraction := xor(packed, shl(96, receiver))
/// ```
///
/// The per token royalty info is given by.
/// ```
/// mstore(0x00, tokenId)
/// mstore(0x20, _ERC2981_MASTER_SLOT_SEED)
/// let packed := sload(keccak256(0x00, 0x40))
/// let receiver := shr(96, packed)
/// let royaltyFraction := xor(packed, shl(96, receiver))
/// ```
uint256 private constant _ERC2981_MASTER_SLOT_SEED = 0xaa4ec00224afccfdb7;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* ERC2981 */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Checks that `_feeDenominator` is non-zero.
constructor() {
require(_feeDenominator() != 0, "Fee denominator cannot be zero.");
}
/// @dev Returns the denominator for the royalty amount.
/// Defaults to 10000, which represents fees in basis points.
/// Override this function to return a custom amount if needed.
function _feeDenominator() internal pure virtual returns (uint96) {
return 10000;
}
/// @dev Returns true if this contract implements the interface defined by `interfaceId`.
/// See: https://eips.ethereum.org/EIPS/eip-165
/// This function call must use less than 30000 gas.
function supportsInterface(bytes4 interfaceId) public view virtual returns (bool result) {
/// @solidity memory-safe-assembly
assembly {
let s := shr(224, interfaceId)
// ERC165: 0x01ffc9a7, ERC2981: 0x2a55205a.
result := or(eq(s, 0x01ffc9a7), eq(s, 0x2a55205a))
}
}
/// @dev Returns the `receiver` and `royaltyAmount` for `tokenId` sold at `salePrice`.
function royaltyInfo(uint256 tokenId, uint256 salePrice)
public
view
virtual
returns (address receiver, uint256 royaltyAmount)
{
uint256 feeDenominator = _feeDenominator();
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, tokenId)
mstore(0x20, _ERC2981_MASTER_SLOT_SEED)
let packed := sload(keccak256(0x00, 0x40))
receiver := shr(96, packed)
if iszero(receiver) {
packed := sload(mload(0x20))
receiver := shr(96, packed)
}
let x := salePrice
let y := xor(packed, shl(96, receiver)) // `feeNumerator`.
// Overflow check, equivalent to `require(y == 0 || x <= type(uint256).max / y)`.
// Out-of-gas revert. Should not be triggered in practice, but included for safety.
returndatacopy(returndatasize(), returndatasize(), mul(y, gt(x, div(not(0), y))))
royaltyAmount := div(mul(x, y), feeDenominator)
}
}
/// @dev Sets the default royalty `receiver` and `feeNumerator`.
///
/// Requirements:
/// - `receiver` must not be the zero address.
/// - `feeNumerator` must not be greater than the fee denominator.
function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
uint256 feeDenominator = _feeDenominator();
/// @solidity memory-safe-assembly
assembly {
feeNumerator := shr(160, shl(160, feeNumerator))
if gt(feeNumerator, feeDenominator) {
mstore(0x00, 0x350a88b3) // `RoyaltyOverflow()`.
revert(0x1c, 0x04)
}
let packed := shl(96, receiver)
if iszero(packed) {
mstore(0x00, 0xb4457eaa) // `RoyaltyReceiverIsZeroAddress()`.
revert(0x1c, 0x04)
}
sstore(_ERC2981_MASTER_SLOT_SEED, or(packed, feeNumerator))
}
}
/// @dev Sets the default royalty `receiver` and `feeNumerator` to zero.
function _deleteDefaultRoyalty() internal virtual {
/// @solidity memory-safe-assembly
assembly {
sstore(_ERC2981_MASTER_SLOT_SEED, 0)
}
}
/// @dev Sets the royalty `receiver` and `feeNumerator` for `tokenId`.
///
/// Requirements:
/// - `receiver` must not be the zero address.
/// - `feeNumerator` must not be greater than the fee denominator.
function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator)
internal
virtual
{
uint256 feeDenominator = _feeDenominator();
/// @solidity memory-safe-assembly
assembly {
feeNumerator := shr(160, shl(160, feeNumerator))
if gt(feeNumerator, feeDenominator) {
mstore(0x00, 0x350a88b3) // `RoyaltyOverflow()`.
revert(0x1c, 0x04)
}
let packed := shl(96, receiver)
if iszero(packed) {
mstore(0x00, 0xb4457eaa) // `RoyaltyReceiverIsZeroAddress()`.
revert(0x1c, 0x04)
}
mstore(0x00, tokenId)
mstore(0x20, _ERC2981_MASTER_SLOT_SEED)
sstore(keccak256(0x00, 0x40), or(packed, feeNumerator))
}
}
/// @dev Sets the royalty `receiver` and `feeNumerator` for `tokenId` to zero.
function _resetTokenRoyalty(uint256 tokenId) internal virtual {
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, tokenId)
mstore(0x20, _ERC2981_MASTER_SLOT_SEED)
sstore(keccak256(0x00, 0x40), 0)
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
/// @notice Simple single owner authorization mixin.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/Ownable.sol)
///
/// @dev Note:
/// This implementation does NOT auto-initialize the owner to `msg.sender`.
/// You MUST call the `_initializeOwner` in the constructor / initializer.
///
/// While the ownable portion follows
/// [EIP-173](https://eips.ethereum.org/EIPS/eip-173) for compatibility,
/// the nomenclature for the 2-step ownership handover may be unique to this codebase.
abstract contract Ownable {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The caller is not authorized to call the function.
error Unauthorized();
/// @dev The `newOwner` cannot be the zero address.
error NewOwnerIsZeroAddress();
/// @dev The `pendingOwner` does not have a valid handover request.
error NoHandoverRequest();
/// @dev Cannot double-initialize.
error AlreadyInitialized();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* EVENTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The ownership is transferred from `oldOwner` to `newOwner`.
/// This event is intentionally kept the same as OpenZeppelin's Ownable to be
/// compatible with indexers and [EIP-173](https://eips.ethereum.org/EIPS/eip-173),
/// despite it not being as lightweight as a single argument event.
event OwnershipTransferred(address indexed oldOwner, address indexed newOwner);
/// @dev An ownership handover to `pendingOwner` has been requested.
event OwnershipHandoverRequested(address indexed pendingOwner);
/// @dev The ownership handover to `pendingOwner` has been canceled.
event OwnershipHandoverCanceled(address indexed pendingOwner);
/// @dev `keccak256(bytes("OwnershipTransferred(address,address)"))`.
uint256 private constant _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE =
0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0;
/// @dev `keccak256(bytes("OwnershipHandoverRequested(address)"))`.
uint256 private constant _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE =
0xdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d;
/// @dev `keccak256(bytes("OwnershipHandoverCanceled(address)"))`.
uint256 private constant _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE =
0xfa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* STORAGE */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The owner slot is given by:
/// `bytes32(~uint256(uint32(bytes4(keccak256("_OWNER_SLOT_NOT")))))`.
/// It is intentionally chosen to be a high value
/// to avoid collision with lower slots.
/// The choice of manual storage layout is to enable compatibility
/// with both regular and upgradeable contracts.
bytes32 internal constant _OWNER_SLOT =
0xffffffffffffffffffffffffffffffffffffffffffffffffffffffff74873927;
/// The ownership handover slot of `newOwner` is given by:
/// ```
/// mstore(0x00, or(shl(96, user), _HANDOVER_SLOT_SEED))
/// let handoverSlot := keccak256(0x00, 0x20)
/// ```
/// It stores the expiry timestamp of the two-step ownership handover.
uint256 private constant _HANDOVER_SLOT_SEED = 0x389a75e1;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* INTERNAL FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Override to return true to make `_initializeOwner` prevent double-initialization.
function _guardInitializeOwner() internal pure virtual returns (bool guard) {}
/// @dev Initializes the owner directly without authorization guard.
/// This function must be called upon initialization,
/// regardless of whether the contract is upgradeable or not.
/// This is to enable generalization to both regular and upgradeable contracts,
/// and to save gas in case the initial owner is not the caller.
/// For performance reasons, this function will not check if there
/// is an existing owner.
function _initializeOwner(address newOwner) internal virtual {
if (_guardInitializeOwner()) {
/// @solidity memory-safe-assembly
assembly {
let ownerSlot := _OWNER_SLOT
if sload(ownerSlot) {
mstore(0x00, 0x0dc149f0) // `AlreadyInitialized()`.
revert(0x1c, 0x04)
}
// Clean the upper 96 bits.
newOwner := shr(96, shl(96, newOwner))
// Store the new value.
sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner))))
// Emit the {OwnershipTransferred} event.
log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner)
}
} else {
/// @solidity memory-safe-assembly
assembly {
// Clean the upper 96 bits.
newOwner := shr(96, shl(96, newOwner))
// Store the new value.
sstore(_OWNER_SLOT, newOwner)
// Emit the {OwnershipTransferred} event.
log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner)
}
}
}
/// @dev Sets the owner directly without authorization guard.
function _setOwner(address newOwner) internal virtual {
if (_guardInitializeOwner()) {
/// @solidity memory-safe-assembly
assembly {
let ownerSlot := _OWNER_SLOT
// Clean the upper 96 bits.
newOwner := shr(96, shl(96, newOwner))
// Emit the {OwnershipTransferred} event.
log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner)
// Store the new value.
sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner))))
}
} else {
/// @solidity memory-safe-assembly
assembly {
let ownerSlot := _OWNER_SLOT
// Clean the upper 96 bits.
newOwner := shr(96, shl(96, newOwner))
// Emit the {OwnershipTransferred} event.
log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner)
// Store the new value.
sstore(ownerSlot, newOwner)
}
}
}
/// @dev Throws if the sender is not the owner.
function _checkOwner() internal view virtual {
/// @solidity memory-safe-assembly
assembly {
// If the caller is not the stored owner, revert.
if iszero(eq(caller(), sload(_OWNER_SLOT))) {
mstore(0x00, 0x82b42900) // `Unauthorized()`.
revert(0x1c, 0x04)
}
}
}
/// @dev Returns how long a two-step ownership handover is valid for in seconds.
/// Override to return a different value if needed.
/// Made internal to conserve bytecode. Wrap it in a public function if needed.
function _ownershipHandoverValidFor() internal view virtual returns (uint64) {
return 48 * 3600;
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* PUBLIC UPDATE FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Allows the owner to transfer the ownership to `newOwner`.
function transferOwnership(address newOwner) public payable virtual onlyOwner {
/// @solidity memory-safe-assembly
assembly {
if iszero(shl(96, newOwner)) {
mstore(0x00, 0x7448fbae) // `NewOwnerIsZeroAddress()`.
revert(0x1c, 0x04)
}
}
_setOwner(newOwner);
}
/// @dev Allows the owner to renounce their ownership.
function renounceOwnership() public payable virtual onlyOwner {
_setOwner(address(0));
}
/// @dev Request a two-step ownership handover to the caller.
/// The request will automatically expire in 48 hours (172800 seconds) by default.
function requestOwnershipHandover() public payable virtual {
unchecked {
uint256 expires = block.timestamp + _ownershipHandoverValidFor();
/// @solidity memory-safe-assembly
assembly {
// Compute and set the handover slot to `expires`.
mstore(0x0c, _HANDOVER_SLOT_SEED)
mstore(0x00, caller())
sstore(keccak256(0x0c, 0x20), expires)
// Emit the {OwnershipHandoverRequested} event.
log2(0, 0, _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE, caller())
}
}
}
/// @dev Cancels the two-step ownership handover to the caller, if any.
function cancelOwnershipHandover() public payable virtual {
/// @solidity memory-safe-assembly
assembly {
// Compute and set the handover slot to 0.
mstore(0x0c, _HANDOVER_SLOT_SEED)
mstore(0x00, caller())
sstore(keccak256(0x0c, 0x20), 0)
// Emit the {OwnershipHandoverCanceled} event.
log2(0, 0, _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE, caller())
}
}
/// @dev Allows the owner to complete the two-step ownership handover to `pendingOwner`.
/// Reverts if there is no existing ownership handover requested by `pendingOwner`.
function completeOwnershipHandover(address pendingOwner) public payable virtual onlyOwner {
/// @solidity memory-safe-assembly
assembly {
// Compute and set the handover slot to 0.
mstore(0x0c, _HANDOVER_SLOT_SEED)
mstore(0x00, pendingOwner)
let handoverSlot := keccak256(0x0c, 0x20)
// If the handover does not exist, or has expired.
if gt(timestamp(), sload(handoverSlot)) {
mstore(0x00, 0x6f5e8818) // `NoHandoverRequest()`.
revert(0x1c, 0x04)
}
// Set the handover slot to 0.
sstore(handoverSlot, 0)
}
_setOwner(pendingOwner);
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* PUBLIC READ FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Returns the owner of the contract.
function owner() public view virtual returns (address result) {
/// @solidity memory-safe-assembly
assembly {
result := sload(_OWNER_SLOT)
}
}
/// @dev Returns the expiry timestamp for the two-step ownership handover to `pendingOwner`.
function ownershipHandoverExpiresAt(address pendingOwner)
public
view
virtual
returns (uint256 result)
{
/// @solidity memory-safe-assembly
assembly {
// Compute the handover slot.
mstore(0x0c, _HANDOVER_SLOT_SEED)
mstore(0x00, pendingOwner)
// Load the handover slot.
result := sload(keccak256(0x0c, 0x20))
}
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* MODIFIERS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Marks a function as only callable by the owner.
modifier onlyOwner() virtual {
_checkOwner();
_;
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import {SingleUseETHVault} from "./SingleUseETHVault.sol";
/// @notice Library for force safe transferring ETH and ERC20s in ZKsync.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/ext/zksync/SafeTransferLib.sol)
library SafeTransferLib {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* EVENTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev A single use ETH vault has been created for `to`, with `amount`.
event SingleUseETHVaultCreated(address indexed to, uint256 amount, address vault);
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The ETH transfer has failed.
error ETHTransferFailed();
/// @dev The ERC20 `transferFrom` has failed.
error TransferFromFailed();
/// @dev The ERC20 `transfer` has failed.
error TransferFailed();
/// @dev The ERC20 `approve` has failed.
error ApproveFailed();
/// @dev The ERC20 `totalSupply` query has failed.
error TotalSupplyQueryFailed();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CONSTANTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Suggested gas stipend for contract receiving ETH to perform a few
/// storage reads and writes, but low enough to prevent griefing.
uint256 internal constant GAS_STIPEND_NO_GRIEF = 1000000;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* ETH OPERATIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
// If the ETH transfer MUST succeed with a reasonable gas budget, use the force variants.
//
// The regular variants:
// - Forwards all remaining gas to the target.
// - Reverts if the target reverts.
// - Reverts if the current contract has insufficient balance.
//
// The force variants:
// - Forwards with an optional gas stipend
// (defaults to `GAS_STIPEND_NO_GRIEF`, which is sufficient for most cases).
// - If the target reverts, or if the gas stipend is exhausted,
// creates a temporary contract to force send the ETH via `SELFDESTRUCT`.
// Future compatible with `SENDALL`: https://eips.ethereum.org/EIPS/eip-4758.
// - Reverts if the current contract has insufficient balance.
//
// The try variants:
// - Forwards with a mandatory gas stipend.
// - Instead of reverting, returns whether the transfer succeeded.
/// @dev Sends `amount` (in wei) ETH to `to`.
function safeTransferETH(address to, uint256 amount) internal {
/// @solidity memory-safe-assembly
assembly {
if iszero(call(gas(), to, amount, 0x00, 0x00, 0x00, 0x00)) {
mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
revert(0x1c, 0x04)
}
}
}
/// @dev Sends all the ETH in the current contract to `to`.
function safeTransferAllETH(address to) internal {
/// @solidity memory-safe-assembly
assembly {
// Transfer all the ETH and check if it succeeded or not.
if iszero(call(gas(), to, selfbalance(), 0x00, 0x00, 0x00, 0x00)) {
mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
revert(0x1c, 0x04)
}
}
}
/// @dev Force sends `amount` (in wei) ETH to `to`, with a `gasStipend`.
/// If force transfer is used, returns the vault. Else returns `address(0)`.
function forceSafeTransferETH(address to, uint256 amount, uint256 gasStipend)
internal
returns (address vault)
{
if (amount == uint256(0)) return address(0); // Early return if `amount` is zero.
uint256 selfBalanceBefore = address(this).balance;
/// @solidity memory-safe-assembly
assembly {
if lt(selfBalanceBefore, amount) {
mstore(0x00, 0xb12d13eb) // `ETHTransferFailed()`.
revert(0x1c, 0x04)
}
pop(call(gasStipend, to, amount, 0x00, 0x00, 0x00, 0x00))
}
if (address(this).balance == selfBalanceBefore) {
vault = address(new SingleUseETHVault());
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, shr(96, shl(96, to)))
if iszero(call(gas(), vault, amount, 0x00, 0x20, 0x00, 0x00)) { revert(0x00, 0x00) }
}
emit SingleUseETHVaultCreated(to, amount, vault);
}
}
/// @dev Force sends all the ETH in the current contract to `to`, with a `gasStipend`.
/// If force transfer is used, returns the vault. Else returns `address(0)`.
function forceSafeTransferAllETH(address to, uint256 gasStipend)
internal
returns (address vault)
{
vault = forceSafeTransferETH(to, address(this).balance, gasStipend);
}
/// @dev Force sends `amount` (in wei) ETH to `to`, with `GAS_STIPEND_NO_GRIEF`.
/// If force transfer is used, returns the vault. Else returns `address(0)`.
function forceSafeTransferETH(address to, uint256 amount) internal returns (address vault) {
vault = forceSafeTransferETH(to, amount, GAS_STIPEND_NO_GRIEF);
}
/// @dev Force sends all the ETH in the current contract to `to`, with `GAS_STIPEND_NO_GRIEF`.
/// If force transfer is used, returns the vault. Else returns `address(0)`.
function forceSafeTransferAllETH(address to) internal returns (address vault) {
vault = forceSafeTransferETH(to, address(this).balance, GAS_STIPEND_NO_GRIEF);
}
/// @dev Sends `amount` (in wei) ETH to `to`, with a `gasStipend`.
function trySafeTransferETH(address to, uint256 amount, uint256 gasStipend)
internal
returns (bool success)
{
/// @solidity memory-safe-assembly
assembly {
success := call(gasStipend, to, amount, 0x00, 0x00, 0x00, 0x00)
}
}
/// @dev Sends all the ETH in the current contract to `to`, with a `gasStipend`.
function trySafeTransferAllETH(address to, uint256 gasStipend)
internal
returns (bool success)
{
/// @solidity memory-safe-assembly
assembly {
success := call(gasStipend, to, selfbalance(), 0x00, 0x00, 0x00, 0x00)
}
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* ERC20 OPERATIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Sends `amount` of ERC20 `token` from `from` to `to`.
/// Reverts upon failure.
///
/// The `from` account must have at least `amount` approved for
/// the current contract to manage.
function safeTransferFrom(address token, address from, address to, uint256 amount) internal {
/// @solidity memory-safe-assembly
assembly {
let m := mload(0x40) // Cache the free memory pointer.
mstore(0x60, amount) // Store the `amount` argument.
mstore(0x40, to) // Store the `to` argument.
mstore(0x2c, shl(96, from)) // Store the `from` argument.
mstore(0x0c, 0x23b872dd000000000000000000000000) // `transferFrom(address,address,uint256)`.
let success := call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20)
if iszero(and(eq(mload(0x00), 1), success)) {
if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) {
mstore(0x00, 0x7939f424) // `TransferFromFailed()`.
revert(0x1c, 0x04)
}
}
mstore(0x60, 0) // Restore the zero slot to zero.
mstore(0x40, m) // Restore the free memory pointer.
}
}
/// @dev Sends `amount` of ERC20 `token` from `from` to `to`.
///
/// The `from` account must have at least `amount` approved for the current contract to manage.
function trySafeTransferFrom(address token, address from, address to, uint256 amount)
internal
returns (bool success)
{
/// @solidity memory-safe-assembly
assembly {
let m := mload(0x40) // Cache the free memory pointer.
mstore(0x60, amount) // Store the `amount` argument.
mstore(0x40, to) // Store the `to` argument.
mstore(0x2c, shl(96, from)) // Store the `from` argument.
mstore(0x0c, 0x23b872dd000000000000000000000000) // `transferFrom(address,address,uint256)`.
success := call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20)
if iszero(and(eq(mload(0x00), 1), success)) {
success := lt(or(iszero(extcodesize(token)), returndatasize()), success)
}
mstore(0x60, 0) // Restore the zero slot to zero.
mstore(0x40, m) // Restore the free memory pointer.
}
}
/// @dev Sends all of ERC20 `token` from `from` to `to`.
/// Reverts upon failure.
///
/// The `from` account must have their entire balance approved for the current contract to manage.
function safeTransferAllFrom(address token, address from, address to)
internal
returns (uint256 amount)
{
/// @solidity memory-safe-assembly
assembly {
let m := mload(0x40) // Cache the free memory pointer.
mstore(0x40, to) // Store the `to` argument.
mstore(0x2c, shl(96, from)) // Store the `from` argument.
mstore(0x0c, 0x70a08231000000000000000000000000) // `balanceOf(address)`.
// Read the balance, reverting upon failure.
if iszero(
and( // The arguments of `and` are evaluated from right to left.
gt(returndatasize(), 0x1f), // At least 32 bytes returned.
staticcall(gas(), token, 0x1c, 0x24, 0x60, 0x20)
)
) {
mstore(0x00, 0x7939f424) // `TransferFromFailed()`.
revert(0x1c, 0x04)
}
mstore(0x00, 0x23b872dd) // `transferFrom(address,address,uint256)`.
amount := mload(0x60) // The `amount` is already at 0x60. We'll need to return it.
// Perform the transfer, reverting upon failure.
let success := call(gas(), token, 0, 0x1c, 0x64, 0x00, 0x20)
if iszero(and(eq(mload(0x00), 1), success)) {
if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) {
mstore(0x00, 0x7939f424) // `TransferFromFailed()`.
revert(0x1c, 0x04)
}
}
mstore(0x60, 0) // Restore the zero slot to zero.
mstore(0x40, m) // Restore the free memory pointer.
}
}
/// @dev Sends `amount` of ERC20 `token` from the current contract to `to`.
/// Reverts upon failure.
function safeTransfer(address token, address to, uint256 amount) internal {
/// @solidity memory-safe-assembly
assembly {
mstore(0x14, to) // Store the `to` argument.
mstore(0x34, amount) // Store the `amount` argument.
mstore(0x00, 0xa9059cbb000000000000000000000000) // `transfer(address,uint256)`.
// Perform the transfer, reverting upon failure.
let success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
if iszero(and(eq(mload(0x00), 1), success)) {
if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) {
mstore(0x00, 0x90b8ec18) // `TransferFailed()`.
revert(0x1c, 0x04)
}
}
mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
}
}
/// @dev Sends all of ERC20 `token` from the current contract to `to`.
/// Reverts upon failure.
function safeTransferAll(address token, address to) internal returns (uint256 amount) {
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, 0x70a08231) // Store the function selector of `balanceOf(address)`.
mstore(0x20, address()) // Store the address of the current contract.
// Read the balance, reverting upon failure.
if iszero(
and( // The arguments of `and` are evaluated from right to left.
gt(returndatasize(), 0x1f), // At least 32 bytes returned.
staticcall(gas(), token, 0x1c, 0x24, 0x34, 0x20)
)
) {
mstore(0x00, 0x90b8ec18) // `TransferFailed()`.
revert(0x1c, 0x04)
}
mstore(0x14, to) // Store the `to` argument.
amount := mload(0x34) // The `amount` is already at 0x34. We'll need to return it.
mstore(0x00, 0xa9059cbb000000000000000000000000) // `transfer(address,uint256)`.
// Perform the transfer, reverting upon failure.
let success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
if iszero(and(eq(mload(0x00), 1), success)) {
if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) {
mstore(0x00, 0x90b8ec18) // `TransferFailed()`.
revert(0x1c, 0x04)
}
}
mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
}
}
/// @dev Sets `amount` of ERC20 `token` for `to` to manage on behalf of the current contract.
/// Reverts upon failure.
function safeApprove(address token, address to, uint256 amount) internal {
/// @solidity memory-safe-assembly
assembly {
mstore(0x14, to) // Store the `to` argument.
mstore(0x34, amount) // Store the `amount` argument.
mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`.
let success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
if iszero(and(eq(mload(0x00), 1), success)) {
if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) {
mstore(0x00, 0x3e3f8f73) // `ApproveFailed()`.
revert(0x1c, 0x04)
}
}
mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
}
}
/// @dev Sets `amount` of ERC20 `token` for `to` to manage on behalf of the current contract.
/// If the initial attempt to approve fails, attempts to reset the approved amount to zero,
/// then retries the approval again (some tokens, e.g. USDT, requires this).
/// Reverts upon failure.
function safeApproveWithRetry(address token, address to, uint256 amount) internal {
/// @solidity memory-safe-assembly
assembly {
mstore(0x14, to) // Store the `to` argument.
mstore(0x34, amount) // Store the `amount` argument.
mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`.
// Perform the approval, retrying upon failure.
let success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
if iszero(and(eq(mload(0x00), 1), success)) {
if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) {
mstore(0x34, 0) // Store 0 for the `amount`.
mstore(0x00, 0x095ea7b3000000000000000000000000) // `approve(address,uint256)`.
pop(call(gas(), token, 0, 0x10, 0x44, 0x00, 0x00)) // Reset the approval.
mstore(0x34, amount) // Store back the original `amount`.
// Retry the approval, reverting upon failure.
success := call(gas(), token, 0, 0x10, 0x44, 0x00, 0x20)
if iszero(and(eq(mload(0x00), 1), success)) {
// Check the `extcodesize` again just in case the token selfdestructs lol.
if iszero(lt(or(iszero(extcodesize(token)), returndatasize()), success)) {
mstore(0x00, 0x3e3f8f73) // `ApproveFailed()`.
revert(0x1c, 0x04)
}
}
}
}
mstore(0x34, 0) // Restore the part of the free memory pointer that was overwritten.
}
}
/// @dev Returns the amount of ERC20 `token` owned by `account`.
/// Returns zero if the `token` does not exist.
function balanceOf(address token, address account) internal view returns (uint256 amount) {
/// @solidity memory-safe-assembly
assembly {
mstore(0x14, account) // Store the `account` argument.
mstore(0x00, 0x70a08231000000000000000000000000) // `balanceOf(address)`.
amount :=
mul( // The arguments of `mul` are evaluated from right to left.
mload(0x20),
and( // The arguments of `and` are evaluated from right to left.
gt(returndatasize(), 0x1f), // At least 32 bytes returned.
staticcall(gas(), token, 0x10, 0x24, 0x20, 0x20)
)
)
}
}
/// @dev Returns the total supply of the `token`.
/// Reverts if the token does not exist or does not implement `totalSupply()`.
function totalSupply(address token) internal view returns (uint256 result) {
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, 0x18160ddd) // `totalSupply()`.
if iszero(
and(gt(returndatasize(), 0x1f), staticcall(gas(), token, 0x1c, 0x04, 0x00, 0x20))
) {
mstore(0x00, 0x54cd9435) // `TotalSupplyQueryFailed()`.
revert(0x1c, 0x04)
}
result := mload(0x00)
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../../utils/AutomaticValidatorTransferApproval.sol";
import "../../utils/CreatorTokenBase.sol";
import "erc721a/contracts/extensions/ERC721AQueryable.sol";
import {TOKEN_TYPE_ERC721} from "../../../lib/PermitC/src/Constants.sol";
/**
* @title ERC721ACQueryable
* @author Limit Break, Inc.
* @notice Extends Azuki's ERC721AQueryable implementation with Creator Token functionality, which
* allows the contract owner to update the transfer validation logic by managing a security policy in
* an external transfer validation security policy registry. See {CreatorTokenTransferValidator}.
*/
abstract contract ERC721ACQueryable is ERC721AQueryable, CreatorTokenBase, AutomaticValidatorTransferApproval {
constructor(string memory name_, string memory symbol_) CreatorTokenBase() ERC721A(name_, symbol_) {}
/**
* @notice Overrides behavior of isApprovedFor all such that if an operator is not explicitly approved
* for all, the contract owner can optionally auto-approve the 721-C transfer validator for transfers.
*/
function isApprovedForAll(address owner, address operator) public view virtual override(ERC721A, IERC721A) returns (bool isApproved) {
isApproved = super.isApprovedForAll(owner, operator);
if (!isApproved) {
if (autoApproveTransfersFromValidator) {
isApproved = operator == address(getTransferValidator());
}
}
}
/**
* @notice Indicates whether the contract implements the specified interface.
* @dev Overrides supportsInterface in ERC165.
* @param interfaceId The interface id
* @return true if the contract implements the specified interface, false otherwise
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721A, IERC721A) returns (bool) {
return
interfaceId == type(ICreatorToken).interfaceId ||
interfaceId == type(ICreatorTokenLegacy).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @notice Returns the function selector for the transfer validator's validation function to be called
* @notice for transaction simulation.
*/
function getTransferValidationFunction() external pure returns (bytes4 functionSignature, bool isViewFunction) {
functionSignature = bytes4(keccak256("validateTransfer(address,address,address,uint256)"));
isViewFunction = true;
}
/// @dev Ties the erc721a _beforeTokenTransfers hook to more granular transfer validation logic
function _beforeTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual override {
for (uint256 i = 0; i < quantity;) {
_validateBeforeTransfer(from, to, startTokenId + i);
unchecked {
++i;
}
}
}
/// @dev Ties the erc721a _afterTokenTransfer hook to more granular transfer validation logic
function _afterTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual override {
for (uint256 i = 0; i < quantity;) {
_validateAfterTransfer(from, to, startTokenId + i);
unchecked {
++i;
}
}
}
function _msgSenderERC721A() internal view virtual override returns (address) {
return _msgSender();
}
function _tokenType() internal pure override returns(uint16) {
return uint16(TOKEN_TYPE_ERC721);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../access/OwnablePermissions.sol";
/**
* @title AutomaticValidatorTransferApproval
* @author Limit Break, Inc.
* @notice Base contract mix-in that provides boilerplate code giving the contract owner the
* option to automatically approve a 721-C transfer validator implementation for transfers.
*/
abstract contract AutomaticValidatorTransferApproval is OwnablePermissions {
/// @dev Emitted when the automatic approval flag is modified by the creator.
event AutomaticApprovalOfTransferValidatorSet(bool autoApproved);
/// @dev If true, the collection's transfer validator is automatically approved to transfer holder's tokens.
bool public autoApproveTransfersFromValidator;
/**
* @notice Sets if the transfer validator is automatically approved as an operator for all token owners.
*
* @dev Throws when the caller is not the contract owner.
*
* @param autoApprove If true, the collection's transfer validator will be automatically approved to
* transfer holder's tokens.
*/
function setAutomaticApprovalOfTransfersFromValidator(bool autoApprove) external {
_requireCallerIsContractOwner();
autoApproveTransfersFromValidator = autoApprove;
emit AutomaticApprovalOfTransferValidatorSet(autoApprove);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../access/OwnablePermissions.sol";
import "../interfaces/ICreatorToken.sol";
import "../interfaces/ICreatorTokenLegacy.sol";
import "../interfaces/ITransferValidator.sol";
import "./TransferValidation.sol";
import "../interfaces/ITransferValidatorSetTokenType.sol";
/**
* @title CreatorTokenBase
* @author Limit Break, Inc.
* @notice CreatorTokenBaseV3 is an abstract contract that provides basic functionality for managing token
* transfer policies through an implementation of ICreatorTokenTransferValidator/ICreatorTokenTransferValidatorV2/ICreatorTokenTransferValidatorV3.
* This contract is intended to be used as a base for creator-specific token contracts, enabling customizable transfer
* restrictions and security policies.
*
* <h4>Features:</h4>
* <ul>Ownable: This contract can have an owner who can set and update the transfer validator.</ul>
* <ul>TransferValidation: Implements the basic token transfer validation interface.</ul>
*
* <h4>Benefits:</h4>
* <ul>Provides a flexible and modular way to implement custom token transfer restrictions and security policies.</ul>
* <ul>Allows creators to enforce policies such as account and codehash blacklists, whitelists, and graylists.</ul>
* <ul>Can be easily integrated into other token contracts as a base contract.</ul>
*
* <h4>Intended Usage:</h4>
* <ul>Use as a base contract for creator token implementations that require advanced transfer restrictions and
* security policies.</ul>
* <ul>Set and update the ICreatorTokenTransferValidator implementation contract to enforce desired policies for the
* creator token.</ul>
*
* <h4>Compatibility:</h4>
* <ul>Backward and Forward Compatible - V1/V2/V3 Creator Token Base will work with V1/V2/V3 Transfer Validators.</ul>
*/
abstract contract CreatorTokenBase is OwnablePermissions, TransferValidation, ICreatorToken {
/// @dev Thrown when setting a transfer validator address that has no deployed code.
error CreatorTokenBase__InvalidTransferValidatorContract();
/// @dev The default transfer validator that will be used if no transfer validator has been set by the creator.
address public constant DEFAULT_TRANSFER_VALIDATOR = address(0x721C002B0059009a671D00aD1700c9748146cd1B);
/// @dev Used to determine if the default transfer validator is applied.
/// @dev Set to true when the creator sets a transfer validator address.
bool private isValidatorInitialized;
/// @dev Address of the transfer validator to apply to transactions.
address private transferValidator;
constructor() {
_emitDefaultTransferValidator();
_registerTokenType(DEFAULT_TRANSFER_VALIDATOR);
}
/**
* @notice Sets the transfer validator for the token contract.
*
* @dev Throws when provided validator contract is not the zero address and does not have code.
* @dev Throws when the caller is not the contract owner.
*
* @dev <h4>Postconditions:</h4>
* 1. The transferValidator address is updated.
* 2. The `TransferValidatorUpdated` event is emitted.
*
* @param transferValidator_ The address of the transfer validator contract.
*/
function setTransferValidator(address transferValidator_) public {
_requireCallerIsContractOwner();
bool isValidTransferValidator = transferValidator_.code.length > 0;
if(transferValidator_ != address(0) && !isValidTransferValidator) {
revert CreatorTokenBase__InvalidTransferValidatorContract();
}
emit TransferValidatorUpdated(address(getTransferValidator()), transferValidator_);
isValidatorInitialized = true;
transferValidator = transferValidator_;
_registerTokenType(transferValidator_);
}
/**
* @notice Returns the transfer validator contract address for this token contract.
*/
function getTransferValidator() public view override returns (address validator) {
validator = transferValidator;
if (validator == address(0)) {
if (!isValidatorInitialized) {
validator = DEFAULT_TRANSFER_VALIDATOR;
}
}
}
/**
* @dev Pre-validates a token transfer, reverting if the transfer is not allowed by this token's security policy.
* Inheriting contracts are responsible for overriding the _beforeTokenTransfer function, or its equivalent
* and calling _validateBeforeTransfer so that checks can be properly applied during token transfers.
*
* @dev Be aware that if the msg.sender is the transfer validator, the transfer is automatically permitted, as the
* transfer validator is expected to pre-validate the transfer.
*
* @dev Throws when the transfer doesn't comply with the collection's transfer policy, if the transferValidator is
* set to a non-zero address.
*
* @param caller The address of the caller.
* @param from The address of the sender.
* @param to The address of the receiver.
* @param tokenId The token id being transferred.
*/
function _preValidateTransfer(
address caller,
address from,
address to,
uint256 tokenId,
uint256 /*value*/) internal virtual override {
address validator = getTransferValidator();
if (validator != address(0)) {
if (msg.sender == validator) {
return;
}
ITransferValidator(validator).validateTransfer(caller, from, to, tokenId);
}
}
/**
* @dev Pre-validates a token transfer, reverting if the transfer is not allowed by this token's security policy.
* Inheriting contracts are responsible for overriding the _beforeTokenTransfer function, or its equivalent
* and calling _validateBeforeTransfer so that checks can be properly applied during token transfers.
*
* @dev Be aware that if the msg.sender is the transfer validator, the transfer is automatically permitted, as the
* transfer validator is expected to pre-validate the transfer.
*
* @dev Used for ERC20 and ERC1155 token transfers which have an amount value to validate in the transfer validator.
* @dev The `tokenId` for ERC20 tokens should be set to `0`.
*
* @dev Throws when the transfer doesn't comply with the collection's transfer policy, if the transferValidator is
* set to a non-zero address.
*
* @param caller The address of the caller.
* @param from The address of the sender.
* @param to The address of the receiver.
* @param tokenId The token id being transferred.
* @param amount The amount of token being transferred.
*/
function _preValidateTransfer(
address caller,
address from,
address to,
uint256 tokenId,
uint256 amount,
uint256 /*value*/) internal virtual override {
address validator = getTransferValidator();
if (validator != address(0)) {
if (msg.sender == validator) {
return;
}
ITransferValidator(validator).validateTransfer(caller, from, to, tokenId, amount);
}
}
function _tokenType() internal virtual pure returns(uint16);
function _registerTokenType(address validator) internal {
if (validator != address(0)) {
uint256 validatorCodeSize;
assembly {
validatorCodeSize := extcodesize(validator)
}
if(validatorCodeSize > 0) {
try ITransferValidatorSetTokenType(validator).setTokenTypeOfCollection(address(this), _tokenType()) {
} catch { }
}
}
}
/**
* @dev Used during contract deployment for constructable and cloneable creator tokens
* @dev to emit the `TransferValidatorUpdated` event signaling the validator for the contract
* @dev is the default transfer validator.
*/
function _emitDefaultTransferValidator() internal {
emit TransferValidatorUpdated(address(0), DEFAULT_TRANSFER_VALIDATOR);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
/// @dev Constant bytes32 value of 0x000...000
bytes32 constant ZERO_BYTES32 = bytes32(0);
/// @dev Constant value of 0
uint256 constant ZERO = 0;
/// @dev Constant value of 1
uint256 constant ONE = 1;
/// @dev Constant value representing an open order in storage
uint8 constant ORDER_STATE_OPEN = 0;
/// @dev Constant value representing a filled order in storage
uint8 constant ORDER_STATE_FILLED = 1;
/// @dev Constant value representing a cancelled order in storage
uint8 constant ORDER_STATE_CANCELLED = 2;
/// @dev Constant value representing the ERC721 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC721 = 721;
/// @dev Constant value representing the ERC1155 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC1155 = 1155;
/// @dev Constant value representing the ERC20 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC20 = 20;
/// @dev Constant value to mask the upper bits of a signature that uses a packed `vs` value to extract `s`
bytes32 constant UPPER_BIT_MASK = 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff;
/// @dev EIP-712 typehash used for validating signature based stored approvals
bytes32 constant UPDATE_APPROVAL_TYPEHASH =
keccak256("UpdateApprovalBySignature(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 approvalExpiration,uint256 sigDeadline,uint256 masterNonce)");
/// @dev EIP-712 typehash used for validating a single use permit without additional data
bytes32 constant SINGLE_USE_PERMIT_TYPEHASH =
keccak256("PermitTransferFrom(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 expiration,uint256 masterNonce)");
/// @dev EIP-712 typehash used for validating a single use permit with additional data
string constant SINGLE_USE_PERMIT_TRANSFER_ADVANCED_TYPEHASH_STUB =
"PermitTransferFromWithAdditionalData(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 expiration,uint256 masterNonce,";
/// @dev EIP-712 typehash used for validating an order permit that updates storage as it fills
string constant PERMIT_ORDER_ADVANCED_TYPEHASH_STUB =
"PermitOrderWithAdditionalData(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 salt,address operator,uint256 expiration,uint256 masterNonce,";
/// @dev Pausable flag for stored approval transfers of ERC721 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC721 = 1 << 0;
/// @dev Pausable flag for stored approval transfers of ERC1155 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC1155 = 1 << 1;
/// @dev Pausable flag for stored approval transfers of ERC20 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC20 = 1 << 2;
/// @dev Pausable flag for single use permit transfers of ERC721 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC721 = 1 << 3;
/// @dev Pausable flag for single use permit transfers of ERC1155 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC1155 = 1 << 4;
/// @dev Pausable flag for single use permit transfers of ERC20 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC20 = 1 << 5;
/// @dev Pausable flag for order fill transfers of ERC1155 assets
uint256 constant PAUSABLE_ORDER_TRANSFER_FROM_ERC1155 = 1 << 6;
/// @dev Pausable flag for order fill transfers of ERC20 assets
uint256 constant PAUSABLE_ORDER_TRANSFER_FROM_ERC20 = 1 << 7;// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
/// @notice A single-use vault that allows a designated caller to withdraw all ETH in it.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/ext/zksync/SingleUseETHVault.sol)
contract SingleUseETHVault {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Unable to withdraw all.
error WithdrawAllFailed();
/// @dev Not authorized.
error Unauthorized();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* WITHDRAW ALL */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
fallback() external payable virtual {
/// @solidity memory-safe-assembly
assembly {
mstore(0x40, 0) // Optimization trick to remove free memory pointer initialization.
let owner := sload(0)
// Initialization.
if iszero(owner) {
sstore(0, calldataload(0x00)) // Store the owner.
return(0x00, 0x00) // Early return.
}
// Authorization check.
if iszero(eq(caller(), owner)) {
mstore(0x00, 0x82b42900) // `Unauthorized()`.
revert(0x1c, 0x04)
}
let to := calldataload(0x00)
// If the calldata is less than 32 bytes, zero-left-pad it to 32 bytes.
// Then use the rightmost 20 bytes of the word as the `to` address.
// This allows for the calldata to be `abi.encode(to)` or `abi.encodePacked(to)`.
to := shr(mul(lt(calldatasize(), 0x20), shl(3, sub(0x20, calldatasize()))), to)
// If `to` is `address(0)`, set it to `msg.sender`.
to := xor(mul(xor(to, caller()), iszero(to)), to)
// Transfers the whole balance to `to`.
if iszero(call(gas(), to, selfbalance(), 0x00, 0x00, 0x00, 0x00)) {
mstore(0x00, 0x651aee10) // `WithdrawAllFailed()`.
revert(0x1c, 0x04)
}
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/utils/Context.sol";
abstract contract OwnablePermissions is Context {
function _requireCallerIsContractOwner() internal view virtual;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
interface ICreatorTokenLegacy {
event TransferValidatorUpdated(address oldValidator, address newValidator);
function getTransferValidator() external view returns (address validator);
function setTransferValidator(address validator) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
interface ICreatorToken {
event TransferValidatorUpdated(address oldValidator, address newValidator);
function getTransferValidator() external view returns (address validator);
function setTransferValidator(address validator) external;
function getTransferValidationFunction() external view returns (bytes4 functionSignature, bool isViewFunction);
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
pragma solidity ^0.8.4;
import './IERC721AQueryable.sol';
import '../ERC721A.sol';
/**
* @title ERC721AQueryable.
*
* @dev ERC721A subclass with convenience query functions.
*/
abstract contract ERC721AQueryable is ERC721A, IERC721AQueryable {
/**
* @dev Returns the `TokenOwnership` struct at `tokenId` without reverting.
*
* If the `tokenId` is out of bounds:
*
* - `addr = address(0)`
* - `startTimestamp = 0`
* - `burned = false`
* - `extraData = 0`
*
* If the `tokenId` is burned:
*
* - `addr = <Address of owner before token was burned>`
* - `startTimestamp = <Timestamp when token was burned>`
* - `burned = true`
* - `extraData = <Extra data when token was burned>`
*
* Otherwise:
*
* - `addr = <Address of owner>`
* - `startTimestamp = <Timestamp of start of ownership>`
* - `burned = false`
* - `extraData = <Extra data at start of ownership>`
*/
function explicitOwnershipOf(uint256 tokenId) public view virtual override returns (TokenOwnership memory) {
TokenOwnership memory ownership;
if (tokenId < _startTokenId() || tokenId >= _nextTokenId()) {
return ownership;
}
ownership = _ownershipAt(tokenId);
if (ownership.burned) {
return ownership;
}
return _ownershipOf(tokenId);
}
/**
* @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order.
* See {ERC721AQueryable-explicitOwnershipOf}
*/
function explicitOwnershipsOf(uint256[] calldata tokenIds)
external
view
virtual
override
returns (TokenOwnership[] memory)
{
unchecked {
uint256 tokenIdsLength = tokenIds.length;
TokenOwnership[] memory ownerships = new TokenOwnership[](tokenIdsLength);
for (uint256 i; i != tokenIdsLength; ++i) {
ownerships[i] = explicitOwnershipOf(tokenIds[i]);
}
return ownerships;
}
}
/**
* @dev Returns an array of token IDs owned by `owner`,
* in the range [`start`, `stop`)
* (i.e. `start <= tokenId < stop`).
*
* This function allows for tokens to be queried if the collection
* grows too big for a single call of {ERC721AQueryable-tokensOfOwner}.
*
* Requirements:
*
* - `start < stop`
*/
function tokensOfOwnerIn(
address owner,
uint256 start,
uint256 stop
) external view virtual override returns (uint256[] memory) {
unchecked {
if (start >= stop) revert InvalidQueryRange();
uint256 tokenIdsIdx;
uint256 stopLimit = _nextTokenId();
// Set `start = max(start, _startTokenId())`.
if (start < _startTokenId()) {
start = _startTokenId();
}
// Set `stop = min(stop, stopLimit)`.
if (stop > stopLimit) {
stop = stopLimit;
}
uint256 tokenIdsMaxLength = balanceOf(owner);
// Set `tokenIdsMaxLength = min(balanceOf(owner), stop - start)`,
// to cater for cases where `balanceOf(owner)` is too big.
if (start < stop) {
uint256 rangeLength = stop - start;
if (rangeLength < tokenIdsMaxLength) {
tokenIdsMaxLength = rangeLength;
}
} else {
tokenIdsMaxLength = 0;
}
uint256[] memory tokenIds = new uint256[](tokenIdsMaxLength);
if (tokenIdsMaxLength == 0) {
return tokenIds;
}
// We need to call `explicitOwnershipOf(start)`,
// because the slot at `start` may not be initialized.
TokenOwnership memory ownership = explicitOwnershipOf(start);
address currOwnershipAddr;
// If the starting slot exists (i.e. not burned), initialize `currOwnershipAddr`.
// `ownership.address` will not be zero, as `start` is clamped to the valid token ID range.
if (!ownership.burned) {
currOwnershipAddr = ownership.addr;
}
for (uint256 i = start; i != stop && tokenIdsIdx != tokenIdsMaxLength; ++i) {
ownership = _ownershipAt(i);
if (ownership.burned) {
continue;
}
if (ownership.addr != address(0)) {
currOwnershipAddr = ownership.addr;
}
if (currOwnershipAddr == owner) {
tokenIds[tokenIdsIdx++] = i;
}
}
// Downsize the array to fit.
assembly {
mstore(tokenIds, tokenIdsIdx)
}
return tokenIds;
}
}
/**
* @dev Returns an array of token IDs owned by `owner`.
*
* This function scans the ownership mapping and is O(`totalSupply`) in complexity.
* It is meant to be called off-chain.
*
* See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into
* multiple smaller scans if the collection is large enough to cause
* an out-of-gas error (10K collections should be fine).
*/
function tokensOfOwner(address owner) external view virtual override returns (uint256[] memory) {
unchecked {
uint256 tokenIdsIdx;
address currOwnershipAddr;
uint256 tokenIdsLength = balanceOf(owner);
uint256[] memory tokenIds = new uint256[](tokenIdsLength);
TokenOwnership memory ownership;
for (uint256 i = _startTokenId(); tokenIdsIdx != tokenIdsLength; ++i) {
ownership = _ownershipAt(i);
if (ownership.burned) {
continue;
}
if (ownership.addr != address(0)) {
currOwnershipAddr = ownership.addr;
}
if (currOwnershipAddr == owner) {
tokenIds[tokenIdsIdx++] = i;
}
}
return tokenIds;
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
interface ITransferValidator {
function applyCollectionTransferPolicy(address caller, address from, address to) external view;
function validateTransfer(address caller, address from, address to) external view;
function validateTransfer(address caller, address from, address to, uint256 tokenId) external view;
function validateTransfer(address caller, address from, address to, uint256 tokenId, uint256 amount) external;
function beforeAuthorizedTransfer(address operator, address token, uint256 tokenId) external;
function afterAuthorizedTransfer(address token, uint256 tokenId) external;
function beforeAuthorizedTransfer(address operator, address token) external;
function afterAuthorizedTransfer(address token) external;
function beforeAuthorizedTransfer(address token, uint256 tokenId) external;
function beforeAuthorizedTransferWithAmount(address token, uint256 tokenId, uint256 amount) external;
function afterAuthorizedTransferWithAmount(address token, uint256 tokenId) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
interface ITransferValidatorSetTokenType {
function setTokenTypeOfCollection(address collection, uint16 tokenType) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/utils/Context.sol";
/**
* @title TransferValidation
* @author Limit Break, Inc.
* @notice A mix-in that can be combined with ERC-721 contracts to provide more granular hooks.
* Openzeppelin's ERC721 contract only provides hooks for before and after transfer. This allows
* developers to validate or customize transfers within the context of a mint, a burn, or a transfer.
*/
abstract contract TransferValidation is Context {
/// @dev Thrown when the from and to address are both the zero address.
error ShouldNotMintToBurnAddress();
/*************************************************************************/
/* Transfers Without Amounts */
/*************************************************************************/
/// @dev Inheriting contracts should call this function in the _beforeTokenTransfer function to get more granular hooks.
function _validateBeforeTransfer(address from, address to, uint256 tokenId) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_preValidateMint(_msgSender(), to, tokenId, msg.value);
} else if(toZeroAddress) {
_preValidateBurn(_msgSender(), from, tokenId, msg.value);
} else {
_preValidateTransfer(_msgSender(), from, to, tokenId, msg.value);
}
}
/// @dev Inheriting contracts should call this function in the _afterTokenTransfer function to get more granular hooks.
function _validateAfterTransfer(address from, address to, uint256 tokenId) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_postValidateMint(_msgSender(), to, tokenId, msg.value);
} else if(toZeroAddress) {
_postValidateBurn(_msgSender(), from, tokenId, msg.value);
} else {
_postValidateTransfer(_msgSender(), from, to, tokenId, msg.value);
}
}
/// @dev Optional validation hook that fires before a mint
function _preValidateMint(address caller, address to, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a mint
function _postValidateMint(address caller, address to, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a burn
function _preValidateBurn(address caller, address from, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a burn
function _postValidateBurn(address caller, address from, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a transfer
function _preValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a transfer
function _postValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 value) internal virtual {}
/*************************************************************************/
/* Transfers With Amounts */
/*************************************************************************/
/// @dev Inheriting contracts should call this function in the _beforeTokenTransfer function to get more granular hooks.
function _validateBeforeTransfer(address from, address to, uint256 tokenId, uint256 amount) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_preValidateMint(_msgSender(), to, tokenId, amount, msg.value);
} else if(toZeroAddress) {
_preValidateBurn(_msgSender(), from, tokenId, amount, msg.value);
} else {
_preValidateTransfer(_msgSender(), from, to, tokenId, amount, msg.value);
}
}
/// @dev Inheriting contracts should call this function in the _afterTokenTransfer function to get more granular hooks.
function _validateAfterTransfer(address from, address to, uint256 tokenId, uint256 amount) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_postValidateMint(_msgSender(), to, tokenId, amount, msg.value);
} else if(toZeroAddress) {
_postValidateBurn(_msgSender(), from, tokenId, amount, msg.value);
} else {
_postValidateTransfer(_msgSender(), from, to, tokenId, amount, msg.value);
}
}
/// @dev Optional validation hook that fires before a mint
function _preValidateMint(address caller, address to, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a mint
function _postValidateMint(address caller, address to, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a burn
function _preValidateBurn(address caller, address from, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a burn
function _postValidateBurn(address caller, address from, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a transfer
function _preValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a transfer
function _postValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
}// 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) {
uint256 curr = tokenId;
unchecked {
if (_startTokenId() <= curr)
if (curr < _currentIndex) {
uint256 packed = _packedOwnerships[curr];
// If not burned.
if (packed & _BITMASK_BURNED == 0) {
// Invariant:
// There will always be an initialized ownership slot
// (i.e. `ownership.addr != address(0) && ownership.burned == false`)
// before an unintialized ownership slot
// (i.e. `ownership.addr == address(0) && ownership.burned == false`)
// Hence, `curr` will not underflow.
//
// We can directly compare the packed value.
// If the address is zero, packed will be zero.
while (packed == 0) {
packed = _packedOwnerships[--curr];
}
return packed;
}
}
}
revert OwnerQueryForNonexistentToken();
}
/**
* @dev Returns the unpacked `TokenOwnership` struct from `packed`.
*/
function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) {
ownership.addr = address(uint160(packed));
ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP);
ownership.burned = packed & _BITMASK_BURNED != 0;
ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA);
}
/**
* @dev Packs ownership data into a single uint256.
*/
function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`.
result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags))
}
}
/**
* @dev Returns the `nextInitialized` flag set if `quantity` equals 1.
*/
function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) {
// For branchless setting of the `nextInitialized` flag.
assembly {
// `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`.
result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1))
}
}
// =============================================================
// APPROVAL OPERATIONS
// =============================================================
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the
* zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) public payable virtual override {
address owner = ownerOf(tokenId);
if (_msgSenderERC721A() != owner)
if (!isApprovedForAll(owner, _msgSenderERC721A())) {
revert ApprovalCallerNotOwnerNorApproved();
}
_tokenApprovals[tokenId].value = to;
emit Approval(owner, to, tokenId);
}
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) public view virtual override returns (address) {
if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken();
return _tokenApprovals[tokenId].value;
}
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom}
* for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_operatorApprovals[_msgSenderERC721A()][operator] = approved;
emit ApprovalForAll(_msgSenderERC721A(), operator, approved);
}
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
return _operatorApprovals[owner][operator];
}
/**
* @dev Returns whether `tokenId` exists.
*
* Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
*
* Tokens start existing when they are minted. See {_mint}.
*/
function _exists(uint256 tokenId) internal view virtual returns (bool) {
return
_startTokenId() <= tokenId &&
tokenId < _currentIndex && // If within bounds,
_packedOwnerships[tokenId] & _BITMASK_BURNED == 0; // and not burned.
}
/**
* @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`.
*/
function _isSenderApprovedOrOwner(
address approvedAddress,
address owner,
address msgSender
) private pure returns (bool result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean.
msgSender := and(msgSender, _BITMASK_ADDRESS)
// `msgSender == owner || msgSender == approvedAddress`.
result := or(eq(msgSender, owner), eq(msgSender, approvedAddress))
}
}
/**
* @dev Returns the storage slot and value for the approved address of `tokenId`.
*/
function _getApprovedSlotAndAddress(uint256 tokenId)
private
view
returns (uint256 approvedAddressSlot, address approvedAddress)
{
TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId];
// The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`.
assembly {
approvedAddressSlot := tokenApproval.slot
approvedAddress := sload(approvedAddressSlot)
}
}
// =============================================================
// TRANSFER OPERATIONS
// =============================================================
/**
* @dev Transfers `tokenId` from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) public 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, '');
}
// =============================================================
// 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 v4.4.1 (utils/Context.sol)
pragma solidity ^0.8.0;
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
pragma solidity ^0.8.4;
import '../IERC721A.sol';
/**
* @dev Interface of ERC721AQueryable.
*/
interface IERC721AQueryable is IERC721A {
/**
* Invalid query range (`start` >= `stop`).
*/
error InvalidQueryRange();
/**
* @dev Returns the `TokenOwnership` struct at `tokenId` without reverting.
*
* If the `tokenId` is out of bounds:
*
* - `addr = address(0)`
* - `startTimestamp = 0`
* - `burned = false`
* - `extraData = 0`
*
* If the `tokenId` is burned:
*
* - `addr = <Address of owner before token was burned>`
* - `startTimestamp = <Timestamp when token was burned>`
* - `burned = true`
* - `extraData = <Extra data when token was burned>`
*
* Otherwise:
*
* - `addr = <Address of owner>`
* - `startTimestamp = <Timestamp of start of ownership>`
* - `burned = false`
* - `extraData = <Extra data at start of ownership>`
*/
function explicitOwnershipOf(uint256 tokenId) external view returns (TokenOwnership memory);
/**
* @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order.
* See {ERC721AQueryable-explicitOwnershipOf}
*/
function explicitOwnershipsOf(uint256[] memory tokenIds) external view returns (TokenOwnership[] memory);
/**
* @dev Returns an array of token IDs owned by `owner`,
* in the range [`start`, `stop`)
* (i.e. `start <= tokenId < stop`).
*
* This function allows for tokens to be queried if the collection
* grows too big for a single call of {ERC721AQueryable-tokensOfOwner}.
*
* Requirements:
*
* - `start < stop`
*/
function tokensOfOwnerIn(
address owner,
uint256 start,
uint256 stop
) external view returns (uint256[] memory);
/**
* @dev Returns an array of token IDs owned by `owner`.
*
* This function scans the ownership mapping and is O(`totalSupply`) in complexity.
* It is meant to be called off-chain.
*
* See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into
* multiple smaller scans if the collection is large enough to cause
* an out-of-gas error (10K collections should be fine).
*/
function tokensOfOwner(address owner) external view returns (uint256[] memory);
}// 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);
}{
"evmVersion": "cancun",
"optimizer": {
"enabled": true,
"mode": "3"
},
"outputSelection": {
"*": {
"*": [
"abi"
]
}
},
"detectMissingLibraries": false,
"forceEVMLA": false,
"enableEraVMExtensions": false,
"libraries": {}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"string","name":"_name","type":"string"},{"internalType":"string","name":"_symbol","type":"string"},{"internalType":"address","name":"_owner","type":"address"},{"internalType":"uint40","name":"ogTimestamp","type":"uint40"},{"internalType":"uint40","name":"wlTimestamp","type":"uint40"},{"internalType":"uint40","name":"og2Timestamp","type":"uint40"},{"internalType":"uint40","name":"pbTimestamp","type":"uint40"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AlreadyInitialized","type":"error"},{"inputs":[],"name":"AlreadyMinted","type":"error"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"CreatorTokenBase__InvalidTransferValidatorContract","type":"error"},{"inputs":[],"name":"IncorrectProof","type":"error"},{"inputs":[],"name":"IncorrectValue","type":"error"},{"inputs":[],"name":"InvalidQueryRange","type":"error"},{"inputs":[],"name":"MaxSupplyReached","type":"error"},{"inputs":[],"name":"Maximum10MintedAllowed","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintNotStarted","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"NewOwnerIsZeroAddress","type":"error"},{"inputs":[],"name":"NoHandoverRequest","type":"error"},{"inputs":[],"name":"NotAllowed","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"PhaseAlreadyStarted","type":"error"},{"inputs":[],"name":"PublicMintStarted","type":"error"},{"inputs":[],"name":"RoyaltyOverflow","type":"error"},{"inputs":[],"name":"RoyaltyReceiverIsZeroAddress","type":"error"},{"inputs":[],"name":"ShouldNotMintToBurnAddress","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"autoApproved","type":"bool"}],"name":"AutomaticApprovalOfTransferValidatorSet","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":"pendingOwner","type":"address"}],"name":"OwnershipHandoverCanceled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverRequested","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldValidator","type":"address"},{"indexed":false,"internalType":"address","name":"newValidator","type":"address"}],"name":"TransferValidatorUpdated","type":"event"},{"inputs":[],"name":"DEFAULT_TRANSFER_VALIDATOR","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_SUPPLY","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MINT_PRICE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"OG2_MINT_TIMESTAMP","outputs":[{"internalType":"uint40","name":"","type":"uint40"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"OG_MINT_TIMESTAMP","outputs":[{"internalType":"uint40","name":"","type":"uint40"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"PUBLIC_MINT_TIMESTAMP","outputs":[{"internalType":"uint40","name":"","type":"uint40"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WL_MINT_TIMESTAMP","outputs":[{"internalType":"uint40","name":"","type":"uint40"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"allowTransfer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"autoApproveTransfersFromValidator","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"cancelOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"completeOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"explicitOwnershipOf","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint64","name":"startTimestamp","type":"uint64"},{"internalType":"bool","name":"burned","type":"bool"},{"internalType":"uint24","name":"extraData","type":"uint24"}],"internalType":"struct IERC721A.TokenOwnership","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"explicitOwnershipsOf","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint64","name":"startTimestamp","type":"uint64"},{"internalType":"bool","name":"burned","type":"bool"},{"internalType":"uint24","name":"extraData","type":"uint24"}],"internalType":"struct IERC721A.TokenOwnership[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getTransferValidationFunction","outputs":[{"internalType":"bytes4","name":"functionSignature","type":"bytes4"},{"internalType":"bool","name":"isViewFunction","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"getTransferValidator","outputs":[{"internalType":"address","name":"validator","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"isApproved","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint64","name":"paidMintQty","type":"uint64"},{"internalType":"uint64","name":"numOfRing","type":"uint64"},{"internalType":"bytes32[]","name":"_merkleProof","type":"bytes32[]"}],"name":"og2Mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"ogMerkleRoot","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"bool","name":"freeMint","type":"bool"},{"internalType":"uint64","name":"paidMintQty","type":"uint64"},{"internalType":"uint64","name":"numOfRing","type":"uint64"},{"internalType":"bytes32[]","name":"_merkleProof","type":"bytes32[]"}],"name":"ogMint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"result","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"ownershipHandoverExpiresAt","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint64","name":"quantity","type":"uint64"}],"name":"publicMint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"requestOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"royaltyAmount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"autoApprove","type":"bool"}],"name":"setAutomaticApprovalOfTransfersFromValidator","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":"bytes32","name":"ogRoot","type":"bytes32"},{"internalType":"bytes32","name":"wlRoot","type":"bytes32"}],"name":"setRoot","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"phase","type":"uint256"},{"internalType":"uint40","name":"newTimeStamp","type":"uint40"}],"name":"setTimestamp","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"transferValidator_","type":"address"}],"name":"setTransferValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"tokensOfOwner","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"start","type":"uint256"},{"internalType":"uint256","name":"stop","type":"uint256"}],"name":"tokensOfOwnerIn","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"}],"name":"withdrawETH","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"wlMerkleRoot","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"bytes32[]","name":"_merkleProof","type":"bytes32[]"}],"name":"wlMint","outputs":[],"stateMutability":"payable","type":"function"}]Contract Creation Code
9c4d535b000000000000000000000000000000000000000000000000000000000000000001000801e80434f6e72b1268632cc379ed1d0310744e075729306fcaab88297d0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000016000000000000000000000000000000000000000000000000000000000000000e000000000000000000000000000000000000000000000000000000000000001200000000000000000000000007f0b69afd9aeef5803b4baab0764e71f5bf928050000000000000000000000000000000000000000000000000000000067bb8a3a0000000000000000000000000000000000000000000000000000000067bd10da0000000000000000000000000000000000000000000000000000000067be977a000000000000000000000000000000000000000000000000000000040d71eac400000000000000000000000000000000000000000000000000000000000000094255494c44204e465400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004424e465400000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0004000000000002000c0000000000020000006004100270000007360340019700030000003103550002000000010355000007360040019d000000800d0000390000004000d0043f0000000100200190000000820000c13d000000040030008c000000a20000413d000000000201043b000000e0022002700000075c0020009c000000a40000213d0000077e0020009c000000f80000a13d0000077f0020009c0000017e0000a13d000007800020009c0000023d0000a13d000007810020009c000003110000213d000007840020009c000005620000613d000007850020009c000000a20000c13d000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000402100370000000000502043b000007390050009c000000a20000213d0000002302500039000000000032004b000000a20000813d0000000406500039000000000261034f000000000202043b000007390020009c000000f20000213d0000001f07200039000007fa077001970000003f07700039000007fa07700197000007ba0070009c000000f20000213d00000024055000390000008007700039000000400070043f000000800020043f0000000005520019000000000035004b000000a20000213d0000002003600039000000000331034f000007fa052001980000001f0620018f000000a001500039000000470000613d000000a007000039000000000803034f000000008908043c0000000007970436000000000017004b000000430000c13d000000000006004b000000540000613d000000000353034f0000000305600210000000000601043300000000065601cf000000000656022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000363019f0000000000310435000000a00120003900000000000104350000074901000041000000000101041a0000000002000411000000000012004b00000a5d0000c13d000000800200043d000007390020009c000000f20000213d0000000c01000039000000000501041a000000010050019000000001035002700000007f0330618f0000001f0030008c00000000060000390000000106002039000000000565013f000000010050019000000a8b0000c13d000000200030008c0000007a0000413d000000000010043f0000001f052000390000000505500270000007d30550009a000000200020008c000007a7050040410000001f033000390000000503300270000007d30330009a000000000035004b0000007a0000813d000000000005041b0000000105500039000000000035004b000000760000413d0000001f0020008c00000f010000a13d000000000010043f000007fa0420019800000f660000c13d000000a005000039000007a70300004100000f740000013d0000000002000416000000000002004b000000a20000c13d0000001f0230003900000737022001970000008002200039000000400020043f0000001f0430018f00000738053001980000008002500039000000930000613d0000008006000039000000000701034f000000007807043c0000000006860436000000000026004b0000008f0000c13d000000000004004b000000a00000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000120435000000e00030008c000000df0000813d000000000100001900001cd5000104300000075d0020009c0000011b0000a13d0000075e0020009c000001d00000a13d0000075f0020009c000002480000a13d000007600020009c000003620000213d000007630020009c0000057f0000613d000007640020009c000000a20000c13d000000240030008c000000a20000413d0000000401100370000000000101043b000c00000001001d0000073c0010009c000000a20000213d0000074901000041000000000101041a0000000002000411000000000012004b00000a5d0000c13d0000079f010000410000000c0010043f0000000c01000029000000000010043f0000000001000414000007360010009c0000073601008041000000c001100210000007a3011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000a00000001001d000000000101041a000b00000001001d000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b0000000b0010006c00000cc00000a13d000007a401000041000000000010043f000007a20100004100001cd500010430000000800600043d000007390060009c000000a20000213d0000001f01600039000000000031004b00000000020000190000073a020080410000073a01100197000000000001004b00000000040000190000073a040040410000073a0010009c000000000402c019000000000004004b000000a20000c13d000000800160003900000000050104330000073b0050009c000001560000413d000007cd01000041000000000010043f0000004101000039000000040010043f000007ce0100004100001cd500010430000007900020009c0000021b0000213d000007980020009c0000027b0000213d0000079c0020009c000008b90000613d0000079d0020009c000007e70000613d0000079e0020009c000000a20000c13d000000440030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000402100370000000000202043b0000073c0020009c000000a20000213d0000002401100370000000000101043b000007dd0010009c000000a20000213d0000074903000041000000000303041a0000000004000411000000000034004b00000a5d0000c13d000007dd01100197000027110010008c00000c590000413d000007f301000041000000000010043f000007a20100004100001cd5000104300000076f0020009c0000022c0000213d000007770020009c000002dc0000213d0000077b0020009c000008c00000613d0000077c0020009c000007fb0000613d0000077d0020009c000000a20000c13d000000440030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000402100370000000000202043b0000002401100370000000000101043b000c00000001001d0000073d0010009c000000a20000213d0000074901000041000000000101041a0000000003000411000000000013004b00000a5d0000c13d00000752010000410000000000100443000000000002004b00000c5f0000613d000000010020008c00000c420000613d0000000901000039000000020020008c00000c780000c13d000000000101041a000b00000001001d0000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d0000000b020000290000073d02200197000000000101043b000000000021004b00000c930000813d0000000903000039000000000103041a000007c6011001970000000c011001af000000000013041b000000000100001900001cd40001042e0000001f01500039000007fa011001970000003f01100039000007fa02100197000000400100043d0000000002210019000000000012004b00000000040000390000000104004039000007390020009c000000f20000213d0000000100400190000000f20000c13d0000008004300039000000400020043f0000000002510436000000a0066000390000000007650019000000000047004b000000a20000213d000007fa085001970000001f0750018f000000000026004b00000a910000813d000000000008004b0000017a0000613d000000000a7600190000000009720019000000200990008a000000200aa0008a000000000b890019000000000c8a0019000000000c0c04330000000000cb0435000000200880008c000001740000c13d000000000007004b00000aa70000613d000000000902001900000a9d0000013d000007890020009c000002570000213d0000078d0020009c0000071f0000613d0000078e0020009c000003b90000613d0000078f0020009c000000a20000c13d000000440030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000002402100370000000000202043b000c00000002001d0000000401100370000000000101043b000000000010043f0000075a01000041000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000201041a000007dd0020009c000001a20000213d0000075a01000041000000000201041a000007dd012001980000000003000019000000010300c08a000000000313c0d90000000c0030006b0000000003000019000000000301201900000001040000310000000005430019000000000045004b000000a20000213d000007fa053001980000001f0630018f00000003074003670000000003540019000001b70000613d000000000807034f000000008908043c0000000004940436000000000034004b000001b30000c13d0000006002200270000000000006004b000001c50000613d000000000457034f0000000305600210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000c011000b9000027100110011a000000400300043d000000200430003900000000001404350000000000230435000007360030009c00000736030080410000004001300210000007de011001c700001cd40001042e000007680020009c0000026e0000213d0000076c0020009c000007af0000613d0000076d0020009c000003e00000613d0000076e0020009c000000a20000c13d000000440030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000402100370000000000202043b000c00000002001d0000073c0020009c000000a20000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039000b00000002001d000000000012004b000000a20000c13d0000000001000411000000000010043f0000000701000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b0000000c02000029000000000020043f000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000201041a000007fb022001970000000b03000029000000000232019f000000000021041b000000400100043d0000000000310435000007360010009c000007360100804100000040011002100000000002000414000007360020009c0000073602008041000000c002200210000000000112019f00000741011001c70000800d020000390000000303000039000007b10400004100000000050004110000000c060000290000057a0000013d000007910020009c000002f70000213d000007950020009c000008cb0000613d000007960020009c000008050000613d000007970020009c000000a20000c13d0000000001000416000000000001004b000000a20000c13d000007e401000041000000800010043f0000000101000039000000a00010043f000007eb0100004100001cd40001042e000007700020009c000003040000213d000007740020009c000008d20000613d000007750020009c0000080d0000613d000007760020009c000000a20000c13d0000000001000416000000000001004b000000a20000c13d0000074901000041000000000101041a0000073c01100197000000800010043f000007a00100004100001cd40001042e000007860020009c000006df0000613d000007870020009c000003760000613d000007880020009c000000a20000c13d0000000001000416000000000001004b000000a20000c13d0000000b01000039000008090000013d000007650020009c0000070e0000613d000007660020009c0000037f0000613d000007670020009c000000a20000c13d0000000001000416000000000001004b000000a20000c13d0000000801000039000000000101041a000000d801100270000000800010043f000007a00100004100001cd40001042e0000078a0020009c000007ba0000613d0000078b0020009c000004030000613d0000078c0020009c000000a20000c13d00000000010300191cd316f20000040f000c00000001001d000b00000002001d000a00000003001d000000400100043d000900000001001d00000020020000391cd317040000040f000000090400002900000000000404350000000c010000290000000b020000290000000a030000291cd3179e0000040f000000000100001900001cd40001042e000007690020009c000007c10000613d0000076a0020009c000005450000613d0000076b0020009c000000a20000c13d0000000001000416000000000001004b000000a20000c13d000007ad01000041000000800010043f000007a00100004100001cd40001042e000007990020009c00000a190000613d0000079a0020009c0000085a0000613d0000079b0020009c000000a20000c13d000000440030008c000000a20000413d0000000402100370000000000202043b000b00000002001d0000073c0020009c000000a20000213d0000002401100370000000000201043b000000000002004b00000ec80000613d000000000100041a000000000021004b00000ec80000a13d000a00000002001d000000000020043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000007a60010019800000ec80000c13d000000000001004b000002b60000c13d000c000a0000002d0000000c01000029000000010110008a000c00000001001d000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000000001004b000002a30000613d000c073c0010019b00000000020004110000000c0020006c00000de80000c13d0000000a01000029000000000010043f0000000601000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000b020000290000073c06200197000000000101043b000000000201041a000007ed02200197000000000262019f000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d020000390000000403000039000007ee040000410000000c050000290000000a070000291cd31cc90000040f0000000100200190000000a20000613d0000057d0000013d000007780020009c00000a380000613d000007790020009c000008800000613d0000077a0020009c000000a20000c13d0000074901000041000000000101041a0000000005000411000000000015004b00000a5d0000c13d0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d0200003900000003030000390000074b0400004100000000060000191cd31cc90000040f0000000100200190000000a20000613d0000074901000041000000000001041b000000000100001900001cd40001042e000007920020009c00000a610000613d000007930020009c000008910000613d000007940020009c000000a20000c13d0000000001000416000000000001004b000000a20000c13d0000000801000039000000000101041a000000b0011002700000037b0000013d000007710020009c00000a7d0000613d000007720020009c0000089c0000613d000007730020009c000000a20000c13d0000000001000416000000000001004b000000a20000c13d0000000901000039000000000101041a00000028011002700000037b0000013d000007820020009c000005920000613d000007830020009c000000a20000c13d000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000402100370000000000202043b000007390020009c000000a20000213d0000002304200039000000000034004b000000a20000813d0000000404200039000000000141034f000000000101043b000900000001001d000007390010009c000000a20000213d000800240020003d000000090100002900000005021002100000000801200029000000000031004b000000a20000213d0000003f01200039000007b903100197000007ba0030009c00000009050000290000000806000029000000f20000213d0000008001300039000000400010043f000000800050043f000000000005004b00000cc60000c13d00000020020000390000000002210436000000800300043d00000000003204350000004002100039000000000003004b000003590000613d000000800400003900000000050000190000002004400039000000000604043300000000870604340000073c07700197000000000772043600000000080804330000073908800197000000000087043500000040076000390000000007070433000000000007004b0000000007000039000000010700c0390000004008200039000000000078043500000060066000390000000006060433000007cf066001970000006007200039000000000067043500000080022000390000000105500039000000000035004b000003410000413d0000000002120049000007360020009c00000736020080410000006002200210000007360010009c00000736010080410000004001100210000000000112019f00001cd40001042e000007610020009c000006ce0000613d000007620020009c000000a20000c13d000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000101043b0000073c0010009c000000a20000213d0000079f020000410000000c0020043f000000000010043f0000000c0100003900000020020000391cd31cb40000040f000008090000013d0000000001000416000000000001004b000000a20000c13d0000000901000039000000000101041a0000073d01100197000000800010043f000007a00100004100001cd40001042e000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000201043b000000000002004b00000ae70000613d000000000100041a000000000021004b00000ae70000a13d000c00000002001d000000000020043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000007a60010019800000ae70000c13d0000000c03000039000000000203041a000000010620019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000442013f000000010040019000000a8b0000c13d000000400500043d0000000004150436000000000006004b00000ce10000613d000000000030043f000000000001004b000000000200001900000ce60000613d000007a70300004100000000020000190000000006240019000000000703041a000000000076043500000001033000390000002002200039000000000012004b000003b10000413d00000ce60000013d0000079f010000410000000c0010043f0000000001000411000000000010043f000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000c00000001001d0000000001000414000007360010009c0000073601008041000000c001100210000007a3011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b0000000c02000029000007df0220009a000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d020000390000000203000039000007e004000041000005790000013d000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000101043b000000000001004b0000000002000039000000010200c039000000000021004b000000a20000c13d0000074902000041000000000202041a0000000003000411000000000023004b00000a5d0000c13d0000000802000039000000000302041a000007b203300197000000000001004b0000000004000019000007b30400c041000000000343019f000000000032041b000000800010043f0000000001000414000007360010009c0000073601008041000000c001100210000007b4011001c70000800d020000390000000103000039000007b5040000410000057a0000013d000000840030008c000000a20000413d0000000402100370000000000202043b000a00000002001d0000073c0020009c000000a20000213d0000002402100370000000000202043b000900000002001d000007390020009c000000a20000213d0000004402100370000000000202043b000800000002001d000007390020009c000000a20000213d0000006402100370000000000202043b000007390020009c000000a20000213d0000002304200039000000000034004b000000a20000813d0000000404200039000000000441034f000000000504043b000007390050009c000000f20000213d00000005045002100000003f06400039000007b906600197000007ba0060009c000000f20000213d0000008006600039000000400060043f000000800050043f00000024022000390000000004240019000000000034004b000000a20000213d000000000005004b000004360000613d0000008003000039000000000521034f000000000505043b000000200330003900000000005304350000002002200039000000000042004b0000042f0000413d0000000901000039000000000101041a000c00000001001d000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b0000000c020000290000073d02200197000000000012004b00000cfb0000213d0000000c0200002900000028022002700000073d02200197000000000021004b00000cfb0000813d0000000a01000039000000000101041a000700000001001d00000008010000290000073902100197000000400100043d000000400310003900000000002304350000004002000039000000000221043600000000030004110000073c03300197000600000003001d0000000000320435000007be0010009c000000f20000213d0000006003100039000000400030043f000007360020009c000007360200804100000040022002100000000001010433000007360010009c00000736010080410000006001100210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000112019f0000074a011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000800300043d000000000003004b000004900000613d000000a0020000390000000503300210000b00a00030003d0000000043020434000c00000004001d000000000031004b000000000300003900000020030020390000000000130435000000200130015f000000000202043300000000002104350000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b0000000c030000290000000b0030006c0000000002030019000004790000413d000000070010006c00000fe60000c13d000000000100041a000000000001004b00000cba0000613d000027100010008c00000a790000213d00000009010000290000073901100197000c00000001001d000007ad011000d10000000002000416000000000012004b00000b460000c13d0000000601000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000da02100270000007ff0220018f0000000c02200029000007390020009c00000cba0000213d00000008030000290000000103300210000007c203300197000000000032004b000011320000213d000000c00110027000000009020000290000001a02200210000007d7022001970000000001210019000b00000001001d000007390010009c00000cba0000213d0000000601000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000b02000029000000c002200210000000000101043b000000000301041a000007c003300197000000000223019f000000000021041b000000400100043d000400000001001d000007500010009c000000f20000213d00000004010000290000002002100039000500000002001d000000400020043f00000000000104350000000c0000006b000012010000613d0000000a010000290008073c0010019c000011aa0000613d000000000200041a000900000002001d000b07fc0020016b00000000010000190000000b0010006c00000cba0000213d00000001011000390000000c0010006c000004e50000413d0000000801000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000c02000029000007c1022000d1000000000101043b000000000301041a0000000002230019000000000021041b000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000700000001001d0000000901000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000702000029000000a0022002100000000c03000029000000010030008c00000000030000190000075403006041000000000223019f0000000806000029000000000262019f000000000101043b000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d0200003900000004030000390000075504000041000000000500001900000009070000291cd31cc90000040f0000000100200190000000a20000613d00000009020000290007000c0020002d00000009010000290000000101100039000900000001001d000000070010006c000015a30000613d0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d02000039000000040300003900000755040000410000000005000019000000080600002900000009070000291cd31cc90000040f0000000100200190000005310000c13d000000a20000013d000000840030008c000000a20000413d0000000402100370000000000202043b000c00000002001d0000073c0020009c000000a20000213d0000002402100370000000000202043b000b00000002001d0000073c0020009c000000a20000213d0000006402100370000000000402043b000007390040009c000000a20000213d0000002302400039000000000032004b000000a20000813d0000000402400039000000000221034f000000000202043b0000004401100370000000000101043b000a00000001001d00000024014000391cd317160000040f0000000004010019000002680000013d0000079f010000410000000c0010043f0000000001000411000000000010043f0000000001000414000007360010009c0000073601008041000000c001100210000007a3011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000001041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d020000390000000203000039000007d50400004100000000050004111cd31cc90000040f0000000100200190000000a20000613d000000000100001900001cd40001042e000000440030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000402100370000000000302043b0000073c0030009c000000a20000213d0000002401100370000000000201043b0000073c0020009c000000a20000213d00000000010300191cd31a990000040f000000000001004b0000000001000039000000010100c0390000088a0000013d000000440030008c000000a20000413d0000000402100370000000000202043b000a00000002001d0000073c0020009c000000a20000213d0000002402100370000000000202043b000007390020009c000000a20000213d0000002304200039000000000034004b000000a20000813d0000000404200039000000000441034f000000000504043b000007390050009c000000f20000213d00000005045002100000003f06400039000007b906600197000007ba0060009c000000f20000213d0000008006600039000000400060043f000000800050043f00000024022000390000000004240019000000000034004b000000a20000213d000000000005004b000005bb0000613d0000008003000039000000000521034f000000000505043b000000200330003900000000005304350000002002200039000000000042004b000005b40000413d0000000801000039000000000101041a000c00000001001d000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b0000000c02000029000000d802200270000000000012004b00000cfb0000213d0000000902000039000000000202041a0000073d02200197000000000021004b00000cfb0000813d0000000b01000039000000000101041a000900000001001d000000400100043d00000014020000390000000002210436000000000300041100000060033002100000000000320435000007d00010009c000000f20000213d0000004003100039000000400030043f000007360020009c000007360200804100000040022002100000000001010433000007360010009c00000736010080410000006001100210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000112019f0000074a011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000800300043d000000000003004b000006100000613d000000a0020000390000000503300210000b00a00030003d0000000043020434000c00000004001d000000000031004b000000000300003900000020030020390000000000130435000000200130015f000000000202043300000000002104350000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b0000000c030000290000000b0030006c0000000002030019000005f90000413d000000090010006c00000fe60000c13d000000000100041a000000000001004b00000cba0000613d000027100010008c00000a790000213d00000000010004110000073c01100197000c00000001001d000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000b00000001001d000007d200100198000011320000c13d0000000001000416000007ad0010009c00000b460000c13d0000000c01000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000b02000029000007d102200197000000000101043b000000000301041a000007c003300197000000000232019f000007d2022001c7000000000021041b000000400100043d000b00000001001d000007500010009c000000f20000213d0000000b020000290000002001200039000800000001001d000000400010043f00000000000204350000000a010000290009073c0010019c000011aa0000613d000000000100041a000700000001001d0000000901000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000201041a000007510220009a000000000021041b000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000600000001001d0000000701000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000602000029000000a0022002100000000906000029000000000262019f00000754022001c7000000000101043b000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d0200003900000004030000390000075504000041000000000500001900000007070000291cd31cc90000040f0000000100200190000000a20000613d00000007010000290000000101100039000000000010041b000007450100004100000000001004430000000a0100002900000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b0000057d0000613d000000400600043d0000006401600039000000000300041a0000008002000039000700000002001d0000000000210435000600000003001d000000010130008a000000440260003900000000001204350000075601000041000000000016043500000004016000390000000c020000290000000000210435000000240160003900000000000104350000000b01000029000000000101043300000084026000390000000000120435000007fa051001970000001f0410018f000a00000006001d000000a403600039000000080030006b000013a90000813d000000000005004b000006ca0000613d00000008074000290000000006430019000000200660008a000000200770008a0000000008560019000000000957001900000000090904330000000000980435000000200550008c000006c40000c13d000000000004004b000013c00000613d0000000006030019000013b50000013d000000240030008c000000a20000413d0000000401100370000000000101043b0000073c0010009c000000a20000213d0000074902000041000000000202041a0000000003000411000000000023004b00000a5d0000c13d000000000001004b00000cc30000c13d000007a101000041000000000010043f000007a20100004100001cd500010430000000440030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000002402100370000000000302043b0000000401100370000000000401043b0000074901000041000000000101041a0000000002000411000000000012004b00000a5d0000c13d0000000a01000039000000000101041a000000000014004b000c00000003001d00000b160000c13d0000000b01000039000000000101041a000000000013004b0000057d0000613d0000000801000039000000000101041a000b00000001001d000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d0000000b02000029000000d802200270000000000101043b000000000021004b00000b340000813d0000000c010000290000000b02000039000000000012041b000000000100001900001cd40001042e000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000101043b1cd319f50000040f000000400200043d000c00000002001d1cd3174e0000040f0000000c01000029000007360010009c00000736010080410000004001100210000007ac011001c700001cd40001042e000000640030008c000000a20000413d0000000402100370000000000202043b000b00000002001d0000073c0020009c000000a20000213d0000002402100370000000000202043b000a00000002001d0000073c0020009c000000a20000213d0000004401100370000000000201043b0000000901000039000000000101041a000007e10010019800000b340000613d000000000002004b00000ec80000613d000000000100041a000000000021004b00000ec80000a13d000900000002001d000000000020043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000201041a000007a60020019800000ec80000c13d0000000001020019000000000002004b0000075e0000c13d000c00090000002d0000000c01000029000000010110008a000c00000001001d000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000000001004b0000074b0000613d0000000b020000290000073c02200197000b00000001001d0000073c01100197000c00000002001d000000000021004b00000f620000c13d0000000901000029000000000010043f0000000601000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000600000001001d000000000101041a000700000001001d00000000010004110000073c02100197000800000002001d0000000c0020006c000007a80000613d0000000802000029000000070020006c000007a80000613d0000000c01000029000000000010043f0000000701000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b0000000802000029000000000020043f000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000ff00100190000007a80000c13d0000000801000039000000000101041a000007cb001001980000111a0000613d00000008021002700000073c02200198000007a60000c13d000000ff0010019000000000020000190000074202006041000000080020006b0000111a0000c13d0000000a01000029000a073c0010019c00000fea0000c13d000007e601000041000000000010043f000007ab0100004100001cd5000104300000000001000416000000000001004b000000a20000c13d1cd31ace0000040f0000000901000039000000000201041a000007b602200197000007b7022001c7000000000021041b000000000100001900001cd40001042e0000000001000416000000000001004b000000a20000c13d0000271001000039000000800010043f000007a00100004100001cd40001042e000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000101043b000c00000001001d0000073c0010009c000000a20000213d0000074901000041000000000101041a0000000002000411000000000012004b00000a5d0000c13d000007450100004100000000001004430000000c0100002900000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d0000000c04000029000000000004004b00000bda0000613d000000000101043b000000000001004b00000bda0000c13d000007ae01000041000000000010043f000007ab0100004100001cd500010430000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000201043b0000075800200198000000a20000c13d00000001010000390000075903200197000007f40030009c00000b380000a13d000007f50030009c00000b420000613d000007f60030009c00000b420000613d000007f70030009c00000b420000613d00000b3c0000013d000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000101043b1cd31c690000040f0000073c011001970000088a0000013d0000000001000416000000000001004b000000a20000c13d0000000a01000039000000000101041a000000800010043f000007a00100004100001cd40001042e000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000101043b000800000001001d0000073c0010009c000000a20000213d0000000801000029000000000001004b000008b50000613d000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a0000073901100197000a00000001001d00000005011002100000003f02100039000007bc03200197000000400200043d000700000002001d0000000002230019000000000032004b00000000030000390000000103004039000007390020009c000000f20000213d0000000100300190000000f20000c13d000000400020043f00000007020000290000000a030000290000000002320436000600000002001d0000001f0210018f000000000001004b000008470000613d0000000604000029000000000114001900000000030000310000000203300367000000003503043c0000000004540436000000000014004b000008430000c13d000000000002004b000000400100043d000007ba0010009c000000f20000213d0000008002100039000000400020043f00000060021000390000000000020435000000400210003900000000000204350000002002100039000000000002043500000000000104350000000a0000006b00000cff0000c13d000000400100043d000c00000001001d000000070200002900000b850000013d000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000201043b000000000002004b00000aeb0000613d000000000100041a000000000021004b00000aeb0000a13d000c00000002001d000000000020043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000007a6001001980000000c0100002900000aeb0000c13d000000000010043f0000000601000039000000200010043f000000400200003900000000010000191cd31cb40000040f000000000101041a000008030000013d000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000101043b0000073c0010009c000000a20000213d1cd317860000040f000000400200043d0000000000120435000007360020009c00000736020080410000004001200210000007a5011001c700001cd40001042e0000000001000416000000000001004b000000a20000c13d0000000101000039000000000101041a000007fc01100167000000000200041a0000000001120019000000800010043f000007a00100004100001cd40001042e000000640030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000402100370000000000202043b000700000002001d0000073c0020009c000000a20000213d0000004402100370000000000202043b0000002401100370000000000301043b000000000023004b00000b300000813d000000000100041a000000000021004b0000000001028019000a00000001001d000000010030008c000000010300a0390000000701000029000000000001004b00000b4a0000c13d000007bd01000041000000000010043f000007ab0100004100001cd5000104300000000001000416000000000001004b000000a20000c13d0000074201000041000000800010043f000007a00100004100001cd40001042e0000000001000416000000000001004b000000a20000c13d0000000801000039000000000101041a000007cb001001980000000001000039000000010100c039000000800010043f000007a00100004100001cd40001042e0000000001000416000000000001004b000000a20000c13d1cd317700000040f000000800010043f000007a00100004100001cd40001042e000000a40030008c000000a20000413d0000000402100370000000000202043b000a00000002001d0000073c0020009c000000a20000213d0000002402100370000000000402043b000000000004004b0000000002000039000000010200c039000900000004001d000000000024004b000000a20000c13d0000004402100370000000000202043b000800000002001d000007390020009c000000a20000213d0000006402100370000000000202043b000700000002001d000007390020009c000000a20000213d0000008402100370000000000202043b000007390020009c000000a20000213d0000002304200039000000000034004b000000a20000813d0000000404200039000000000441034f000000000504043b000007390050009c000000f20000213d00000005045002100000003f06400039000007b906600197000007ba0060009c000000f20000213d0000008006600039000000400060043f000000800050043f00000024022000390000000004240019000000000034004b000000a20000213d000000000005004b0000090d0000613d0000008003000039000000000521034f000000000505043b000000200330003900000000005304350000002002200039000000000042004b000009060000413d0000000801000039000000000101041a000c00000001001d000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b0000000c02000029000000b0022002700000073d02200197000000000012004b00000cfb0000213d0000000c02000029000000d802200270000000000021004b00000cfb0000813d0000000a01000039000000000101041a000500000001001d00000007010000290000073903100197000000400100043d0000004002100039000600000003001d00000000003204350000004002000039000000000221043600000000030004110000073c03300197000400000003001d0000000000320435000007be0010009c000000f20000213d0000006003100039000000400030043f000007360020009c000007360200804100000040022002100000000001010433000007360010009c00000736010080410000006001100210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000112019f0000074a011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000800300043d000000000003004b000009680000613d000000a0020000390000000503300210000b00a00030003d0000000043020434000c00000004001d000000000031004b000000000300003900000020030020390000000000130435000000200130015f000000000202043300000000002104350000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b0000000c030000290000000b0030006c0000000002030019000009510000413d000000050010006c00000fe60000c13d000000090000006b0000111e0000c13d0000000801000029000c07390010019c0000057d0000613d0000000c01000029000007ad011000d10000000002000416000000000012004b00000b460000c13d0000000401000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000cf02100270000007ff0220018f0000000c02200029000007390020009c00000cba0000213d00000007030000290000000103300210000007c203300197000000000032004b000011320000213d000000c00110027000000008020000290000000f02200210000007c3022001970000000001210019000b00000001001d000007390010009c00000cba0000213d0000000401000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000b02000029000000c002200210000000000101043b000000000301041a000007c003300197000000000223019f000000000021041b000000400100043d000500000001001d000007500010009c000000f20000213d00000005010000290000002002100039000600000002001d000000400020043f00000000000104350000000a010000290008073c0010019c000011aa0000613d000000000200041a000900000002001d000b07fc0020016b00000000010000190000000b0010006c00000cba0000213d00000001011000390000000c0010006c000009b90000413d0000000801000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000c02000029000007c1022000d1000000000101043b000000000301041a0000000002230019000000000021041b000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000700000001001d0000000901000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000702000029000000a0022002100000000c03000029000000010030008c00000000030000190000075403006041000000000223019f0000000806000029000000000262019f000000000101043b000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d0200003900000004030000390000075504000041000000000500001900000009070000291cd31cc90000040f0000000100200190000000a20000613d00000009020000290007000c0020002d00000009010000290000000101100039000900000001001d000000070010006c000014f70000613d0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d02000039000000040300003900000755040000410000000005000019000000080600002900000009070000291cd31cc90000040f000000010020019000000a050000c13d000000a20000013d0000000001000416000000000001004b000000a20000c13d0000000203000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f000000010050019000000a8b0000c13d000000800010043f000000000004004b00000b000000613d000000000030043f000000000001004b000000000200001900000b050000613d0000073f030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b00000a300000413d00000b050000013d000000240030008c000000a20000413d0000000002000416000000000002004b000000a20000c13d0000000401100370000000000101043b000c00000001001d0000073c0010009c000000a20000213d0000074901000041000000000101041a0000000002000411000000000012004b00000a5d0000c13d000007c4010000410000000000100443000000000100041000000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c70000800a020000391cd31cce0000040f0000000100200190000016520000613d000000000301043b0000000001000414000007360010009c0000073601008041000000c001100210000000000003004b00000c970000c13d0000000c0200002900000c9b0000013d000007f101000041000000000010043f000007a20100004100001cd500010430000000440030008c000000a20000413d0000000402100370000000000202043b000c00000002001d0000073c0020009c000000a20000213d0000002401100370000000000101043b000b00000001001d000007390010009c000000a20000213d0000000b03000029000007ad013000d10000000002000416000000000012004b00000b460000c13d000000000100041a000000010110008a000000000031001a00000cba0000413d0000000001310019000027100010008c00000ca50000a13d000007ea01000041000000000010043f000007ab0100004100001cd5000104300000000001000416000000000001004b000000a20000c13d0000000303000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f000000010050019000000aef0000613d000007cd01000041000000000010043f0000002201000039000000040010043f000007ce0100004100001cd5000104300000000009820019000000000008004b00000a9a0000613d000000000a060019000000000b02001900000000ac0a0434000000000bcb043600000000009b004b00000a960000c13d000000000007004b00000aa70000613d00000000068600190000000307700210000000000809043300000000087801cf000000000878022f00000000060604330000010007700089000000000676022f00000000067601cf000000000686019f000000000069043500000000055200190000000000050435000000a00500043d000007390050009c000000a20000213d0000001f06500039000000000036004b00000000030000190000073a030080410000073a06600197000000000006004b00000000070000190000073a070040410000073a0060009c000000000703c019000000000007004b000000a20000c13d00000080035000390000000003030433000007390030009c000000f20000213d0000001f06300039000007fa066001970000003f06600039000007fa06600197000000400700043d0000000006670019000c00000007001d000000000076004b00000000070000390000000107004039000007390060009c000000f20000213d0000000100700190000000f20000c13d000000400060043f0000000c060000290000000006360436000b00000006001d000000a0055000390000000006530019000000000046004b000000a20000213d000007fa063001970000001f0430018f0000000b0b0000290000000000b5004b00000b870000813d000000000006004b00000ae30000613d000000000845001900000000074b0019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c00000add0000c13d000000000004004b00000b9d0000613d00000000070b001900000b930000013d000007aa01000041000000000010043f000007ab0100004100001cd500010430000007f001000041000000000010043f000007ab0100004100001cd500010430000000800010043f000000000004004b00000b000000613d000000000030043f000000000001004b000000000200001900000b050000613d000007bb030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b00000af80000413d00000b050000013d000007fb02200197000000a00020043f000000000001004b00000020020000390000000002006039000000200220003900000080010000391cd317040000040f000000400100043d000c00000001001d00000080020000391cd316bd0000040f0000000c020000290000000001210049000007360010009c00000736010080410000006001100210000007360020009c00000736020080410000004002200210000000000121019f00001cd40001042e000a00000004001d0000000801000039000000000101041a000b00000001001d000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b0000000b02000029000000b0022002700000073d02200197000000000021004b00000b340000813d0000000a010000290000000a02000039000000000012041b0000000c03000029000006f20000013d000007b801000041000000000010043f000007ab0100004100001cd500010430000007e701000041000000000010043f000007ab0100004100001cd500010430000007f80030009c00000b420000613d000007f90030009c00000b420000613d000000e0022002700000078f0020009c000000000100003900000001010060390000079d0020009c00000001011061bf000000010110018f000000800010043f000007a00100004100001cd40001042e000007e801000041000000000010043f000007ab0100004100001cd500010430000c00000003001d000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000a030000290000000c0230006c000000000300001900000b610000a13d000000000101043b000000000101041a0000073901100197000000000012004b00000000020180190000000003020019000900000003001d00000005013002100000003f02100039000007b903200197000000400200043d000600000002001d0000000002230019000000000032004b00000000030000390000000103004039000007390020009c000000f20000213d0000000100300190000000f20000c13d000000400020043f000000090200002900000006030000290000000002230436000500000002001d0000001f0210018f000000000001004b00000b7f0000613d0000000504000029000000000114001900000000030000310000000203300367000000003503043c0000000004540436000000000014004b00000b7b0000c13d000000000002004b000000090000006b00000d490000c13d000000400100043d000c00000001001d00000006020000291cd317610000040f00000b0c0000013d00000000076b0019000000000006004b00000b900000613d000000000805001900000000090b0019000000008a0804340000000009a90436000000000079004b00000b8c0000c13d000000000004004b00000b9d0000613d00000000056500190000000304400210000000000607043300000000064601cf000000000646022f00000000050504330000010004400089000000000545022f00000000044501cf000000000464019f000000000047043500000000033b00190000000000030435000000c00300043d000a00000003001d0000073c0030009c000000a20000213d000000e00300043d000900000003001d0000073d0030009c000000a20000213d000001000300043d000800000003001d0000073d0030009c000000a20000213d000001200300043d000700000003001d0000073d0030009c000000a20000213d000001400300043d000600000003001d0000073d0030009c000000a20000213d0000000004010433000007390040009c000000f20000213d00050000000d001d0000000203000039000000000503041a000000010650019000000001055002700000007f0550618f0000001f0050008c00000000070000390000000107002039000000000076004b00000a8b0000c13d000000200050008c00000bd20000413d000000000030043f0000001f0640003900000005066002700000073e0660009a000000200040008c0000073f060040410000001f0550003900000005055002700000073e0550009a000000000056004b00000bd20000813d000000000006041b0000000106600039000000000056004b00000bce0000413d0000001f0040008c00000fdb0000a13d000000000030043f000007fa06400198000010750000c13d00000020050000390000073f02000041000010810000013d0000000801000039000000000201041a00000008012002700000073c0110019800000be20000c13d000000ff0020019000000000010000190000074201006041000000400200043d000000200320003900000000004304350000000000120435000007360020009c000007360200804100000040012002100000000002000414000007360020009c0000073602008041000000c002200210000000000112019f00000743011001c70000800d02000039000000010300003900000744040000411cd31cc90000040f0000000100200190000000a20000613d0000000804000039000000000104041a000007af011001970000000c030000290000000802300210000007b002200197000000000112019f00000001011001bf000000000014041b000000000003004b0000057d0000613d000007450100004100000000001004430000000c0100002900000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b0000057d0000613d000007450100004100000000001004430000000c0100002900000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b000000a20000613d000000400300043d0000002401300039000002d102000039000000000021043500000747010000410000000000130435000000040130003900000000020004100000000000210435000007360030009c000b00000003001d0000073601000041000000000103401900000040011002100000000002000414000007360020009c0000073602008041000000c002200210000000000112019f00000748011001c70000000c020000291cd31cc90000040f0000006003100270000107360030019d000300000001035500000001002001900000057d0000613d0000000b01000029000007390010009c000000f20000213d0000000b01000029000000400010043f000000000100001900001cd40001042e0000000801000039000000000101041a000b00000001001d0000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d0000000b02000029000000d802200270000000000101043b000000000021004b00000c930000813d0000000c01000029000000d8011002100000000803000039000000000203041a000007c70220019700000c8f0000013d000000000002004b00000cdb0000c13d000007f201000041000000000010043f000007a20100004100001cd5000104300000000801000039000000000101041a000b00000001001d0000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b0000000b02000029000000b0022002700000073d02200197000000000021004b00000c930000813d0000000c01000029000000b0011002100000074d011001970000000803000039000000000203041a000007c80220019700000c8f0000013d000000000101041a000b00000001001d0000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b0000000b0200002900000028022002700000073d02200197000000000021004b00000c930000813d0000000c0100002900000028011002100000074e011001970000000903000039000000000203041a000007ca02200197000000000112019f000000000013041b000000000100001900001cd40001042e000007c901000041000000000010043f000007ab0100004100001cd5000104300000074a011001c700008009020000390000000c0400002900000000050000191cd31cc90000040f00030000000103550000006001100270000107360010019d00000001002001900000057d0000c13d000007c501000041000000000010043f000007a20100004100001cd50001043000000000010004110000073c01100197000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000c0011002700000000f0210018f0000000b02200029000007390020009c00000de20000a13d000007cd01000041000000000010043f0000001101000039000000040010043f000007ce0100004100001cd5000104300000000a01000029000000000001041b0000000c010000291cd31c9d0000040f000000000100001900001cd40001042e000007cc0030009c000000f20000213d00000000030000190000008004100039000000400040043f0000006004100039000000000004043500000040041000390000000000040435000000200410003900000000000404350000000000010435000000a00430003900000000001404350000002003300039000000000023004b00000e180000813d000000400100043d000007ba0010009c00000cc90000a13d000000f20000013d0000006002200210000000000121019f0000075a02000041000000000012041b000000000100001900001cd40001042e000007fb022001970000000000240435000000000001004b000000200200003900000000020060390000003f02200039000007fa032001970000000002530019000000000032004b00000000030000390000000103004039000007390020009c000000f20000213d0000000100300190000000f20000c13d000000400020043f0000000003050433000000000003004b00000ecc0000c13d000007500020009c000000f20000213d0000002001200039000000400010043f0000000000020435000000400300043d00000f5f0000013d000007dc01000041000000000010043f000007ab0100004100001cd5000104300000000105000039000c00000000001d000900000000001d00000d080000013d0000000c030000290000000105500039000c00000003001d0000000a0030006c000008560000613d000000400100043d000007ba0010009c000000f20000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000b00000005001d000000000050043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000400200043d000007ba0020009c0000000b05000029000000f20000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e80410027000000000004304350000004003200039000007a6001001980000000004000039000000010400c0390000000000430435000000a0031002700000073903300197000000200420003900000000003404350000073c01100197000000000012043500000d030000c13d000000000001004b00000000020100190000000902006029000900000002001d0000073c01200197000000080010006c0000000c0300002900000d040000c13d00000007010000290000000001010433000000000031004b00000fd50000a13d000000050130021000000006011000290000000000510435000000010330003900000d040000013d000000400100043d000007ba0010009c0000000c03000029000000f20000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000400100043d000007ba0010009c000000f20000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000100041a000000000031004b000000000100001900000f830000a13d000000400100043d000007ba0010009c0000000c03000029000000f20000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000030043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000400200043d000007ba0020009c000000f20000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e80410027000000000004304350000004003200039000007a6001001980000000004000039000000010400c03900000000004304350000073c031001970000000002320436000000a00110027000000739011001970000000000120435000800000000001d00000f840000c13d000000400100043d000007ba0010009c0000000c03000029000000f20000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000100041a000000000031004b00000ec80000a13d0000000c01000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000007a60010019800000ec80000c13d000000000001004b00000dcc0000c13d000b000c0000002d0000000b01000029000000010110008a000b00000001001d000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000000001004b00000db90000613d000000400200043d000007ba0020009c000000f20000213d0000008003200039000000400030043f000000e803100270000000600420003900000000003404350000004003200039000007a6001001980000000004000039000000010400c0390000000000430435000000a0031002700000073903300197000000200420003900000000003404350000073c011001970000000000120435000800000000001d000800000001601d00000f840000013d0000000b0020008c00000ef70000413d000007e901000041000000000010043f000007ab0100004100001cd5000104300000000c01000029000000000010043f0000000701000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b00000000020004110000073c02200197000900000002001d000000000020043f000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000ff00100190000002ba0000c13d0000000801000039000000000101041a000007cb0010019800000e140000613d00000008021002700000073c0220019800000e120000c13d000000ff0010019000000000020000190000074202006041000000090020006b000002ba0000613d000007ec01000041000000000010043f000007ab0100004100001cd5000104300000000007000019000000050870021000000000016800190000000201100367000000000301043b000000400100043d000007ba0010009c000000f20000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000400200043d000007ba0020009c000000f20000213d0000008001200039000000400010043f0000006001200039000000000001043500000040012000390000000000010435000000200120003900000000000104350000000000020435000000000003004b00000ebb0000613d000000000100041a000000000031004b00000ebb0000a13d000000400100043d000007ba0010009c000000f20000213d000a00000008001d000b00000007001d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000c00000003001d000000000030043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000400200043d000007ba0020009c000000090500002900000008060000290000000b070000290000000a080000290000000c09000029000000f20000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e80410027000000000004304350000004003200039000007a6001001980000000004000039000000010400c03900000000004304350000073c031001970000000003320436000000a0011002700000073901100197000000000013043500000ebb0000c13d000000400100043d000007ba0010009c000000f20000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000100041a000000000091004b00000ec80000a13d000000000090043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000007a6001001980000000c0200002900000ec80000c13d000000000001004b00000ea40000c13d000000010220008a000c00000002001d000000000020043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000000001004b0000000c0200002900000e910000613d000000400200043d000007ba0020009c000000090500002900000008060000290000000b070000290000000a08000029000000f20000213d0000008003200039000000400030043f000000e80310027000000060042000390000000000340435000007a6001001980000000003000039000000010300c03900000040042000390000000000340435000000a0031002700000073903300197000000200420003900000000003404350000073c011001970000000000120435000000800100043d000000000071004b00000fd50000a13d000000a0018000390000000000210435000000800100043d000000000071004b00000fd50000a13d0000000107700039000000000057004b00000e190000c13d000000400100043d000003380000013d000007ef01000041000000000010043f000007ab0100004100001cd500010430000000a003200039000000400030043f000000800320003900000000000304350000000c090000290000000006030019000000090090008c0000000a3990011a000000f807300210000000010360008a0000000008030433000007a808800197000000000787019f000007a9077001c7000000000073043500000ed10000213d00000000026200490000008102200039000000210660008a00000000002604350000000005050433000007fa095001970000001f0850018f000000400200043d0000002007200039000000000074004b00000f0b0000813d000000000009004b00000ef30000613d000000000b840019000000000a870019000000200aa0008a000000200bb0008a000000000c9a0019000000000d9b0019000000000d0d04330000000000dc0435000000200990008c00000eed0000c13d000000000008004b00000f210000613d000000000a07001900000f170000013d0000000b020000291cd3177a0000040f000000000201001900000000010004111cd31ad80000040f0000000c010000290000000b020000291cd31af10000040f000000000100001900001cd40001042e000000000002004b000000000300001900000f050000613d000000a00300043d0000000304200210000007fc0440027f000007fc04400167000000000443016f000000010320021000000f7f0000013d000000000a970019000000000009004b00000f140000613d000000000b040019000000000c07001900000000bd0b0434000000000cdc04360000000000ac004b00000f100000c13d000000000008004b00000f210000613d0000000004940019000000030880021000000000090a043300000000098901cf000000000989022f00000000040404330000010008800089000000000484022f00000000048401cf000000000494019f00000000004a0435000000000475001900000000000404350000000005060433000007fa075001970000001f0650018f000000000043004b00000f380000813d000000000007004b00000f340000613d00000000096300190000000008640019000000200880008a000000200990008a000000000a780019000000000b790019000000000b0b04330000000000ba0435000000200770008c00000f2e0000c13d000000000006004b00000f4e0000613d000000000804001900000f440000013d0000000008740019000000000007004b00000f410000613d0000000009030019000000000a040019000000009b090434000000000aba043600000000008a004b00000f3d0000c13d000000000006004b00000f4e0000613d00000000037300190000000306600210000000000708043300000000076701cf000000000767022f00000000030304330000010006600089000000000363022f00000000036301cf000000000373019f0000000000380435000000000345001900000000000304350000000003230049000000200430008a00000000004204350000001f03300039000007fa013001970000000004210019000000000014004b00000000010000390000000101004039000007390040009c000000f20000213d0000000100100190000000f20000c13d0000000003040019000000400040043f0000000001030019000c00000003001d00000b0b0000013d000007e201000041000000000010043f000007ab0100004100001cd500010430000007a7030000410000002006000039000000010540008a0000000505500270000007d40550009a000000000706001900000080066000390000000006060433000000000063041b00000020067000390000000103300039000000000053004b00000f6b0000c13d000000a005700039000000000024004b00000f7d0000813d0000000304200210000000f80440018f000007fc0440027f000007fc044001670000000005050433000000000445016f000000000043041b00000001030000390000000104200210000000000234019f000000000021041b000000000100001900001cd40001042e000800000001001d0000000c050000290000000a0050006b000000000300001900000f8b0000c13d0000000601000029000000000031043500000b820000013d000000000300001900000f910000013d0000000b0300002900000001055000390000000a0050006c00000f880000613d000b00000003001d000000090030006c000010d20000613d000000400100043d000007ba0010009c000000f20000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000c00000005001d000000000050043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000400200043d000007ba0020009c0000000c05000029000000f20000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e80410027000000000004304350000004003200039000007a6001001980000000004000039000000010400c0390000000000430435000000a0031002700000073903300197000000200420003900000000003404350000073c01100197000000000012043500000f8d0000c13d000000000001004b00000000020100190000000802006029000800000002001d000000070120014f0000073c001001980000000b0300002900000f8e0000c13d00000006010000290000000001010433000000000031004b00000fd50000a13d000000050130021000000005011000290000000000510435000000010330003900000f8e0000013d000007cd01000041000000000010043f0000003201000039000000040010043f000007ce0100004100001cd500010430000000000004004b00000000010000190000108d0000613d0000000301400210000007fc0110027f000007fc011001670000000002020433000000000112016f0000000102400210000000000121019f0000108d0000013d000007d601000041000000000010043f000007ab0100004100001cd5000104300000000c0000006b00000ff70000613d0000000801000039000000000101041a00000008021002700005073c0020019c00000ff40000c13d0005074200000045000000ff0010019000000ff70000c13d0000000001000411000000050010006c000010e10000c13d000000070000006b00000ffb0000613d0000000601000029000000000001041b0000000c01000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000a01000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000201041a0000000102200039000000000021041b000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000800000001001d0000000901000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000802000029000000a0022002100000000a022001af00000754022001c7000000000101043b000000000021041b0000000b010000290000075400100198000010660000c13d00000009010000290000000101100039000800000001001d000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000000000001004b000010660000c13d000000000100041a000000080010006b000010660000613d0000000801000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b0000000b02000029000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d02000039000000040300003900000755040000410000000c050000290000000a0600002900000009070000291cd31cc90000040f0000000100200190000000a20000613d0000057d0000013d0000073f020000410000002005000039000000010760008a0000000507700270000007400770009a00000000081500190000000008080433000000000082041b00000020055000390000000102200039000000000072004b0000107a0000c13d000000000046004b0000108b0000813d0000000306400210000000f80660018f000007fc0660027f000007fc0660016700000000011500190000000001010433000000000161016f000000000012041b000000010140021000000001011001bf000000000013041b0000000c010000290000000001010433000400000001001d000007390010009c000000f20000213d0000000301000039000000000101041a000000010010019000000001021002700000007f0220618f000300000002001d0000001f0020008c00000000020000390000000102002039000000000121013f000000010010019000000a8b0000c13d0000000301000029000000200010008c000010be0000413d0000000301000039000000000010043f0000000001000414000007360010009c0000073601008041000000c00110021000000741011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d00000004030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000003010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b000010be0000813d000000000002041b0000000102200039000000000012004b000010ba0000413d0000000401000029000000200010008c000010d40000413d0000000301000039000000000010043f0000000001000414000007360010009c0000073601008041000000c00110021000000741011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000200200008a0000000402200180000000000101043b000011360000c13d0000002003000039000011430000013d000000090300002900000f880000013d000000040000006b0000000001000019000011510000613d00000004030000290000000301300210000007fc0110027f000007fc011001670000000b020000290000000002020433000000000112016f0000000102300210000000000121019f000011510000013d00000745010000410000000000100443000000050100002900000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b000000a20000613d000000400300043d00000064013000390000000902000029000000000021043500000044013000390000000a02000029000000000021043500000024013000390000000c020000290000000000210435000007e4010000410000000000130435000000040130003900000008020000290000000000210435000007360030009c000800000003001d0000073601000041000000000103401900000040011002100000000002000414000007360020009c0000073602008041000000c002200210000000000112019f000007e5011001c700000005020000291cd31cce0000040f0000006003100270000107360030019d00030000000103550000000100200190000012050000613d0000000801000029000007390010009c000000f20000213d0000000801000029000000400010043f000000070000006b00000ff90000c13d00000ffb0000013d000007e301000041000000000010043f000007ab0100004100001cd5000104300000000401000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000101041a000c00000001001d000000c501100270000003ff0110018f000000060010006c000011df0000c13d000007db01000041000000000010043f000007ab0100004100001cd500010430000000010320008a00000005033002700000000004310019000000200300003900000001044000390000000c0600002900000000056300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b0000113c0000c13d000000040020006c0000114e0000813d00000004020000290000000302200210000000f80220018f000007fc0220027f000007fc022001670000000c033000290000000003030433000000000223016f000000000021041b0000000401000029000000010110021000000001011001bf0000000302000039000000000012041b0000000103000039000000000030041b000000400100043d0000002002100039000007420400004100000000004204350000000000010435000007360010009c000007360100804100000040011002100000000002000414000007360020009c0000073602008041000000c002200210000000000112019f00000743011001c70000800d0200003900000744040000411cd31cc90000040f0000000100200190000000a20000613d00000745010000410000000000100443000007420100004100000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b000011ae0000c13d0000000a010000290000073c061001970000074901000041000000000061041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d0200003900000003030000390000074b0400004100000000050000191cd31cc90000040f0000000100200190000000a20000613d0000000801000039000000000201041a0000074c022001970000000903000029000000b0033002100000074d03300197000000000223019f0000000803000029000000d803300210000000000232019f0000000903000039000000000403041a000000000021041b00000007010000290000073d01100197000000060200002900000028022002100000074e02200197000000000112019f0000074f02400197000000000121019f000000000013041b000000400100043d000c00000001001d000007500010009c000000f20000213d00000000030004110000000c020000290000002001200039000900000001001d000000400010043f0000000000020435000b073c0030019c000012240000c13d000007d901000041000000000010043f000007ab0100004100001cd50001043000000745010000410000000000100443000007420100004100000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b000000a20000613d000000400300043d0000002401300039000002d102000039000000000021043500000747010000410000000000130435000000040130003900000000020004100000000000210435000007360030009c000c00000003001d0000073601000041000000000103401900000040011002100000000002000414000007360020009c0000073602008041000000c002200210000000000112019f00000748011001c700000742020000411cd31cc90000040f0000006003100270000107360030019d00030000000103550000000100200190000011780000613d0000000c01000029000007390010009c000000f20000213d0000000c01000029000000400010043f000011780000013d0000000401000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000702000029000000c5022002100000000c03000029000007bf03300197000000000223019f000000000101043b000000000301041a000007c003300197000000000232019f000000000021041b000000400100043d000200000001001d000007500010009c000000f20000213d00000002010000290000002002100039000300000002001d000000400020043f0000000000010435000000060000006b000012840000c13d000007da01000041000000000010043f000007ab0100004100001cd50001043000000736033001970000001f0530018f0000073806300198000000400200043d0000000004620019000012110000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000120d0000c13d000000000005004b0000121e0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000007360020009c00000736020080410000004002200210000000000112019f00001cd500010430000000000100041a000800000001001d0000000b01000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d000000000101043b000000000201041a000007510220009a000000000021041b000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000700000001001d0000000801000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000702000029000000a0022002100000000b06000029000000000262019f00000754022001c7000000000101043b000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d0200003900000004030000390000075504000041000000000500001900000008070000291cd31cc90000040f0000000100200190000000a20000613d00000008010000290000000101100039000000000010041b00000745010000410000000000100443000000000100041100000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b0000008002000039000012ed0000c13d0000000a01000029000000600110021200000c5b0000613d000001f4011001bf0000075a02000041000000000012041b0000002001000039000001000010044300000120000004430000075b0100004100001cd40001042e0000000a01000029000b073c0010019c000011aa0000613d000000000200041a000c00000002001d000007fc0320016700000000010000190000000602000029000000000031004b00000cba0000213d0000000101100039000000000021004b0000128c0000413d000500000003001d0000000b01000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000602000029000007c1022000d1000000000101043b000000000301041a0000000002230019000000000021041b000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000900000001001d0000000c01000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f0000000100200190000000a20000613d0000000902000029000000a0022002100000000603000029000000010030008c00000000030000190000075403006041000000000223019f0000000b06000029000000000262019f000000000101043b000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d020000390000000403000039000007550400004100000000050000190000000c070000291cd31cc90000040f0000000100200190000000a20000613d0000000c02000029000900060020002d0000000c010000290000000101100039000c00000001001d000000090010006c0000140c0000613d0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d020000390000000403000039000007550400004100000000050000190000000b060000290000000c070000291cd31cc90000040f0000000100200190000012d90000c13d000000a20000013d000000400500043d0000006401500039000000000300041a0000000000210435000700000003001d000000010130008a000000440250003900000000001204350000075601000041000000000015043500000004015000390000000b020000290000000000210435000000240150003900000000000104350000000c01000029000000000101043300000084025000390000000000120435000007fa041001970000001f0310018f000800000005001d000000a402500039000000090020006b000013160000813d000000000004004b000013120000613d00000009063000290000000005320019000000200550008a000000200660008a0000000007450019000000000846001900000000080804330000000000870435000000200440008c0000130c0000c13d000000000003004b0000132d0000613d0000000005020019000013220000013d0000000005420019000000000004004b0000131f0000613d0000000906000029000000000702001900000000680604340000000007870436000000000057004b0000131b0000c13d000000000003004b0000132d0000613d000900090040002d0000000303300210000000000405043300000000043401cf000000000434022f000000090600002900000000060604330000010003300089000000000636022f00000000033601cf000000000343019f00000000003504350000001f03100039000007fa0330019700000000012100190000000000010435000000a401300039000007360010009c000007360100804100000060011002100000000802000029000007360020009c00000736020080410000004002200210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000121019f0000000b020000291cd31cc90000040f00000060031002700000073603300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000805700029000013500000613d000000000801034f0000000809000029000000008a08043c0000000009a90436000000000059004b0000134c0000c13d000000000006004b0000135d0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000013790000613d0000001f01400039000000600210018f0000000801200029000000000021004b00000000020000390000000102004039000007390010009c000000f20000213d0000000100200190000000f20000c13d000000400010043f000000200030008c000000a20000413d000000080100002900000000010104330000075800100198000000a20000c13d0000075901100197000007560010009c000014ea0000c13d000000000100041a000000070010006c000012790000613d000000a20000013d000000000003004b0000137d0000c13d0000006002000039000013a40000013d0000001f0230003900000737022001970000003f022000390000075704200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000007390040009c000000f20000213d0000000100500190000000f20000c13d000000400040043f0000001f0430018f00000000063204360000073805300198000500000006001d0000000003560019000013970000613d000000000601034f0000000507000029000000006806043c0000000007870436000000000037004b000013930000c13d000000000004004b000013a40000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b000014ea0000613d0000000502000029000014ef0000013d0000000006530019000000000005004b000013b20000613d0000000807000029000000000803001900000000790704340000000008980436000000000068004b000013ae0000c13d000000000004004b000013c00000613d000800080050002d0000000304400210000000000506043300000000054501cf000000000545022f000000080700002900000000070704330000010004400089000000000747022f00000000044701cf000000000454019f00000000004604350000001f04100039000007fa0240019700000000013100190000000000010435000000a401200039000007360010009c000007360100804100000060011002100000000a02000029000007360020009c00000736020080410000004002200210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000121019f00000009020000291cd31cc90000040f00000060031002700000073603300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000a05700029000013e30000613d000000000801034f0000000a09000029000000008a08043c0000000009a90436000000000059004b000013df0000c13d000000000006004b000013f00000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000014bc0000613d0000001f01400039000000600210018f0000000a01200029000000000021004b00000000020000390000000102004039000007390010009c000000f20000213d0000000100200190000000f20000c13d000000400010043f000000200030008c000000a20000413d0000000a0100002900000000010104330000075800100198000000a20000c13d0000075901100197000007560010009c000014ea0000c13d000000000100041a000000060010006c000000a20000c13d0000057d0000013d0000000901000029000000000010041b0000000001000019000000050010006c000000060200002900000cba0000213d0000000101100039000000000021004b0000140f0000413d000007450100004100000000001004430000000a0100002900000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b0000096c0000613d000000400100043d000c00000001001d000000000200041a000500000002001d000900060020007200000003010000290006002000100092000100800000003d0000000c0500002900000064015000390000008002000039000000000021043500000756010000410000000000150435000000040150003900000004020000290000000000210435000000440150003900000009020000290000000000210435000000240150003900000000000104350000000201000029000000000101043300000084025000390000000000120435000007fa041001970000001f0310018f000000a402500039000000030020006b000014540000813d000000000004004b0000144f0000613d00000006053000290000000006320019000000200660008a0000000007460019000000000845001900000000080804330000000000870435000000200440008c000014490000c13d000000000003004b0000146a0000613d00000003040000290000000005020019000014600000013d0000000005420019000000000004004b0000145d0000613d0000000306000029000000000702001900000000680604340000000007870436000000000057004b000014590000c13d000000000003004b0000146a0000613d00000003044000290000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f00000000003504350000001f03100039000007fa0330019700000000012100190000000000010435000000a401300039000007360010009c000007360100804100000060011002100000000c02000029000c00000002001d000007360020009c00000736020080410000004002200210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000121019f0000000b020000291cd31cc90000040f00000060031002700000073603300197000000200030008c0000002004000039000000000403401900000020064001900000000c056000290000148d0000613d000000000701034f0000000c08000029000000007907043c0000000008980436000000000058004b000014890000c13d0000001f074001900000149a0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000016530000613d0000001f01400039000000600210018f0000000c01200029000000000021004b00000000020000390000000102004039000007390010009c000000f20000213d0000000100200190000000f20000c13d000000400010043f000000200030008c000000a20000413d0000000c0200002900000000020204330000075800200198000000a20000c13d0000075902200197000007560020009c000014ea0000c13d00000009030000290000000103300039000900000003001d000000050030006c000c00000001001d0000142d0000413d000000000100041a000000050010006c0000096c0000613d000000a20000013d000000000003004b000014c00000c13d0000006002000039000014e70000013d0000001f0230003900000737022001970000003f022000390000075704200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000007390040009c000000f20000213d0000000100500190000000f20000c13d000000400040043f0000001f0430018f00000000063204360000073805300198000700000006001d0000000003560019000014da0000613d000000000601034f0000000707000029000000006806043c0000000007870436000000000037004b000014d60000c13d000000000004004b000014e70000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b000014ee0000c13d000007d801000041000000000010043f000007ab0100004100001cd5000104300000000702000029000007360020009c00000736020080410000004002200210000007360010009c00000736010080410000006001100210000000000121019f00001cd5000104300000000701000029000000000010041b00000000010000190000000b0010006c00000cba0000213d00000001011000390000000c0010006c000014fa0000413d000007450100004100000000001004430000000a0100002900000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b0000057d0000613d000000400100043d000b00000001001d000000000200041a000a00000002001d000c000c0020007200000006010000290009002000100092000700800000003d0000000b050000290000006401500039000000800200003900000000002104350000075601000041000000000015043500000004015000390000000402000029000000000021043500000044015000390000000c020000290000000000210435000000240150003900000000000104350000000501000029000000000101043300000084025000390000000000120435000007fa041001970000001f0310018f000000a402500039000000060020006b0000153e0000813d000000000004004b000015390000613d00000009053000290000000006320019000000200660008a0000000007460019000000000845001900000000080804330000000000870435000000200440008c000015330000c13d000000000003004b000015540000613d000000060400002900000000050200190000154a0000013d0000000005420019000000000004004b000015470000613d0000000606000029000000000702001900000000680604340000000007870436000000000057004b000015430000c13d000000000003004b000015540000613d00000006044000290000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f00000000003504350000001f03100039000007fa0330019700000000012100190000000000010435000000a401300039000007360010009c000007360100804100000060011002100000000b02000029000b00000002001d000007360020009c00000736020080410000004002200210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000121019f00000008020000291cd31cc90000040f00000060031002700000073603300197000000200030008c0000002004000039000000000403401900000020064001900000000b05600029000015770000613d000000000701034f0000000b08000029000000007907043c0000000008980436000000000058004b000015730000c13d0000001f07400190000015840000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000016830000613d0000001f01400039000000600210018f0000000b01200029000000000021004b00000000020000390000000102004039000007390010009c000000f20000213d0000000100200190000000f20000c13d000000400010043f000000200030008c000000a20000413d0000000b0200002900000000020204330000075800200198000000a20000c13d0000075902200197000007560020009c000014ea0000c13d0000000c030000290000000103300039000c00000003001d0000000a0030006c000b00000001001d000015170000413d0000164e0000013d0000000701000029000000000010041b00000000010000190000000b0010006c00000cba0000213d00000001011000390000000c0010006c000015a60000413d000007450100004100000000001004430000000a0100002900000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000016520000613d000000000101043b000000000001004b0000057d0000613d000000400100043d000b00000001001d000000000200041a000a00000002001d000c000c0020007200000005010000290009002000100092000700800000003d0000000b050000290000006401500039000000800200003900000000002104350000075601000041000000000015043500000004015000390000000602000029000000000021043500000044015000390000000c020000290000000000210435000000240150003900000000000104350000000401000029000000000101043300000084025000390000000000120435000007fa041001970000001f0310018f000000a402500039000000050020006b000015ea0000813d000000000004004b000015e50000613d00000009053000290000000006320019000000200660008a0000000007460019000000000845001900000000080804330000000000870435000000200440008c000015df0000c13d000000000003004b000016000000613d00000005040000290000000005020019000015f60000013d0000000005420019000000000004004b000015f30000613d0000000506000029000000000702001900000000680604340000000007870436000000000057004b000015ef0000c13d000000000003004b000016000000613d00000005044000290000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f00000000003504350000001f03100039000007fa0330019700000000012100190000000000010435000000a401300039000007360010009c000007360100804100000060011002100000000b02000029000b00000002001d000007360020009c00000736020080410000004002200210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000121019f00000008020000291cd31cc90000040f00000060031002700000073603300197000000200030008c0000002004000039000000000403401900000020064001900000000b05600029000016230000613d000000000701034f0000000b08000029000000007907043c0000000008980436000000000058004b0000161f0000c13d0000001f07400190000016300000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000016a00000613d0000001f01400039000000600210018f0000000b01200029000000000021004b00000000020000390000000102004039000007390010009c000000f20000213d0000000100200190000000f20000c13d000000400010043f000000200030008c000000a20000413d0000000b0200002900000000020204330000075800200198000000a20000c13d0000075902200197000007560020009c000014ea0000c13d0000000c030000290000000103300039000c00000003001d0000000a0030006c000b00000001001d000015c30000413d000000000100041a0000000a0010006c000000a20000c13d0000057d0000013d000000000001042f000000000003004b0000165b0000c13d00000060020000390000000001020433000000000001004b000014ea0000613d0000000102000029000014ef0000013d0000001f0230003900000737022001970000003f022000390000075704200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000007390040009c000000f20000213d0000000100500190000000f20000c13d000000400040043f0000001f0430018f00000000063204360000073805300198000100000006001d0000000003560019000016750000613d000000000601034f0000000107000029000000006806043c0000000007870436000000000037004b000016710000c13d000000000004004b000016560000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000016560000013d000000000003004b000014be0000613d0000001f0230003900000737022001970000003f022000390000075704200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000007390040009c000000f20000213d0000000100500190000000f20000c13d000000400040043f0000001f0430018f00000000063204360000073805300198000700000006001d0000000003560019000014da0000613d000000000601034f0000000707000029000000006806043c0000000007870436000000000037004b0000169b0000c13d000014da0000013d000000000003004b000014be0000613d0000001f0230003900000737022001970000003f022000390000075704200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000007390040009c000000f20000213d0000000100500190000000f20000c13d000000400040043f0000001f0430018f00000000063204360000073805300198000700000006001d0000000003560019000014da0000613d000000000601034f0000000707000029000000006806043c0000000007870436000000000037004b000016b80000c13d000014da0000013d0000002003000039000000000331043600000000420204340000000000230435000007fa062001970000001f0520018f0000004001100039000000000014004b000016d60000813d000000000006004b000016d20000613d00000000085400190000000007510019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c000016cc0000c13d000000000005004b000016ec0000613d0000000007010019000016e20000013d0000000007610019000000000006004b000016df0000613d00000000080400190000000009010019000000008a0804340000000009a90436000000000079004b000016db0000c13d000000000005004b000016ec0000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f0000000000470435000000000412001900000000000404350000001f02200039000007fa022001970000000001120019000000000001042d000007fd0010009c000017020000213d000000630010008c000017020000a13d00000002030003670000000401300370000000000101043b0000073c0010009c000017020000213d0000002402300370000000000202043b0000073c0020009c000017020000213d0000004403300370000000000303043b000000000001042d000000000100001900001cd5000104300000001f02200039000007fa022001970000000001120019000000000021004b00000000020000390000000102004039000007390010009c000017100000213d0000000100200190000017100000c13d000000400010043f000000000001042d000007cd01000041000000000010043f0000004101000039000000040010043f000007ce0100004100001cd5000104300000073b0020009c000017460000813d00000000040100190000001f01200039000007fa011001970000003f01100039000007fa05100197000000400100043d0000000005510019000000000015004b00000000070000390000000107004039000007390050009c000017460000213d0000000100700190000017460000c13d000000400050043f00000000052104360000000007420019000000000037004b0000174c0000213d000007fa062001980000001f0720018f00000002044003670000000003650019000017360000613d000000000804034f0000000009050019000000008a08043c0000000009a90436000000000039004b000017320000c13d000000000007004b000017430000613d000000000464034f0000000306700210000000000703043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000043043500000000022500190000000000020435000000000001042d000007cd01000041000000000010043f0000004101000039000000040010043f000007ce0100004100001cd500010430000000000100001900001cd50001043000000000430104340000073c03300197000000000332043600000000040404330000073904400197000000000043043500000040031000390000000003030433000000000003004b0000000003000039000000010300c03900000040042000390000000000340435000000600220003900000060011000390000000001010433000007cf011001970000000000120435000000000001042d00000020030000390000000004310436000000000302043300000000003404350000004001100039000000000003004b0000176f0000613d00000000040000190000002002200039000000000502043300000000015104360000000104400039000000000034004b000017690000413d000000000001042d0000000801000039000000000201041a00000008012002700000073c01100198000017760000613d000000000001042d000000ff0020019000000000010000190000074201006041000000000001042d0000073901100197000007390220019700000000011200190000073b0010009c000017800000813d000000000001042d000007cd01000041000000000010043f0000001101000039000000040010043f000007ce0100004100001cd5000104300000073c01100198000017980000613d000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000179c0000613d000000000101043b000000000101041a0000073901100197000000000001042d000007bd01000041000000000010043f000007ab0100004100001cd500010430000000000100001900001cd500010430000b000000000002000400000004001d000700000002001d0000000902000039000000000202041a000007e100200198000019850000613d000900000001001d000000000003004b000019800000613d000000000100041a000000000031004b000019800000a13d000a00000003001d000000000030043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d000000000101043b000000000101041a000007a600100198000019800000c13d000000000001004b000017d20000c13d0000000a02000029000000010220008a000b00000002001d000000000020043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d000000000101043b000000000101041a000000000001004b0000000b02000029000017bf0000613d00000009020000290000073c02200197000600000001001d0000073c01100197000b00000002001d000000000021004b000019890000c13d0000000a01000029000000000010043f0000000601000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d000000000301043b000000000403041a00000000050004110000073c02500197000800000002001d0000000b0020006c0000181e0000613d000000080040006b0000181e0000613d000500000004001d000300000003001d0000000b01000029000000000010043f0000000701000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d000000000101043b0000000802000029000000000020043f000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d000000000101043b000000000101041a000000ff001001900000000303000029000000050400002900000000050004110000181e0000c13d0000000801000039000000000101041a000007cb00100198000019950000613d00000008021002700000073c022001980000181c0000c13d000000ff0010019000000000020000190000074202006041000000080020006b000019950000c13d00000007010000290009073c0010019c0000198d0000613d0000000b0000006b000018690000613d0000000801000039000000000101041a00000008021002700000073c02200198000018640000613d000000000025004b000018690000613d000500000004001d000300000003001d00000745010000410000000000100443000200000002001d00000004002004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000019840000613d000000000101043b000000000001004b0000197e0000613d000000400300043d00000064013000390000000a02000029000000000021043500000044013000390000000902000029000000000021043500000024013000390000000b020000290000000000210435000007e4010000410000000000130435000000040130003900000008020000290000000000210435000007360030009c000100000003001d0000073601000041000000000103401900000040011002100000000002000414000007360020009c0000073602008041000000c002200210000000000112019f000007e5011001c700000002020000291cd31cce0000040f0000006003100270000107360030019d00030000000103550000000100200190000019cd0000613d00000001010000290000073b0010009c0000000504000029000019c70000813d000000400010043f0000000303000029000018690000013d000000ff00100190000018690000c13d0000074202000041000000000025004b0000182a0000c13d000000000004004b0000186c0000613d000000000003041b0000000b01000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000901000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d000000000101043b000000000201041a0000000102200039000000000021041b000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f0000000100200190000019840000613d000000000101043b000500000001001d0000000a01000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d0000000502000029000000a00220021000000009022001af00000754022001c7000000000101043b000000000021041b00000006010000290000075400100198000018d70000c13d0000000a010000290000000101100039000500000001001d000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d000000000101043b000000000101041a000000000001004b000018d70000c13d000000000100041a000000050010006b000018d70000613d0000000501000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f00000001002001900000197e0000613d000000000101043b0000000602000029000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d02000039000000040300003900000755040000410000000b0500002900000009060000290000000a070000291cd31cc90000040f00000001002001900000197e0000613d00000745010000410000000000100443000000070100002900000004001004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f0000000100200190000019840000613d000000000101043b000000000001004b0000197d0000613d000000400b00043d0000006401b000390000008002000039000700000002001d00000000002104350000004401b000390000000a0200002900000000002104350000002401b000390000000b020000290000000000210435000007560100004100000000001b04350000000401b00039000000080200002900000000002104350000008402b00039000000040100002900000000410104340000000000120435000007fa061001970000001f0510018f000000a403b00039000000000034004b0000191e0000813d000000000006004b0000191a0000613d00000000085400190000000007530019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c000019140000c13d000000000005004b000019340000613d00000000070300190000192a0000013d0000000007630019000000000006004b000019270000613d00000000080400190000000009030019000000008a0804340000000009a90436000000000079004b000019230000c13d000000000005004b000019340000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f00000000004704350000001f04100039000007fa0240019700000000013100190000000000010435000000a401200039000007360010009c000007360100804100000060011002100000073600b0009c000007360200004100000000020b40190000004002200210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000121019f0000000902000029000b0000000b001d1cd31cc90000040f0000000b0b00002900000060031002700000073603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b0019000019590000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000019550000c13d000000000006004b000019660000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000019910000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000007390010009c000019c70000213d0000000100200190000019c70000c13d000000400010043f000000200030008c0000197e0000413d00000000010b043300000758001001980000197e0000c13d0000075901100197000007560010009c000019c30000c13d000000000001042d000000000100001900001cd500010430000007ef01000041000000000010043f000007ab0100004100001cd500010430000000000001042f000007e701000041000000000010043f000007ab0100004100001cd500010430000007e201000041000000000010043f000007ab0100004100001cd500010430000007e601000041000000000010043f000007ab0100004100001cd500010430000000000003004b000019990000c13d0000006002000039000019c00000013d000007e301000041000000000010043f000007ab0100004100001cd5000104300000001f0230003900000737022001970000003f022000390000075704200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000007390040009c000019c70000213d0000000100500190000019c70000c13d000000400040043f0000001f0430018f00000000063204360000073805300198000700000006001d0000000003560019000019b30000613d000000000601034f0000000707000029000000006806043c0000000007870436000000000037004b000019af0000c13d000000000004004b000019c00000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b000019ec0000c13d000007d801000041000000000010043f000007ab0100004100001cd500010430000007cd01000041000000000010043f0000004101000039000000040010043f000007ce0100004100001cd50001043000000736033001970000001f0530018f0000073806300198000000400200043d0000000004620019000019d90000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000019d50000c13d000000000005004b000019e60000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000007360020009c00000736020080410000004002200210000000000112019f00001cd5000104300000000702000029000007360020009c00000736020080410000004002200210000007360010009c00000736010080410000006001100210000000000121019f00001cd50001043000010000000000020000000003010019000000400100043d000007fe0010009c00001a8d0000813d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000400100043d000007ba0010009c00001a8d0000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000003004b00001a8c0000613d000000000200041a000000000032004b00001a8c0000a13d000000400100043d000007ba0010009c00001a8d0000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000100000003001d000000000030043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f000000010020019000001a930000613d000000000301034f000000400100043d000007ba0010009c000000010500002900001a8d0000213d000000000203043b000000000202041a0000008003100039000000400030043f0000006003100039000000e80420027000000000004304350000004003100039000007a6002001980000000004000039000000010400c03900000000004304350000073c032001970000000003310436000000a0022002700000073902200197000000000023043500001a8c0000c13d000000400100043d000007ba0010009c00001a8d0000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000100041a000000000051004b00001a950000a13d000000000050043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f000000010020019000001a930000613d000000000101043b000000000201041a000007a600200198000000010100002900001a950000c13d000000000002004b00001a790000c13d000000010110008a000100000001001d000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f000000010020019000001a930000613d000000000101043b000000000201041a000000000002004b000000010100002900001a660000613d000000400100043d000007ba0010009c00001a8d0000213d0000008003100039000000400030043f000000e80320027000000060041000390000000000340435000007a6002001980000000003000039000000010300c03900000040041000390000000000340435000000a0032002700000073903300197000000200410003900000000003404350000073c022001970000000000210435000000000001042d000007cd01000041000000000010043f0000004101000039000000040010043f000007ce0100004100001cd500010430000000000100001900001cd500010430000007ef01000041000000000010043f000007ab0100004100001cd5000104300001000000000002000100000002001d0000073c01100197000000000010043f0000000701000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f000000010020019000001acc0000613d000000000101043b00000001020000290000073c02200197000100000002001d000000000020043f000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f000000010020019000001acc0000613d000000000101043b000000000101041a000000ff0110019000001abc0000613d000000000001042d0000000801000039000000000201041a000007cb0020019800001aca0000613d00000008012002700000073c0110019800001ac60000c13d000000ff0020019000000000010000190000074201006041000000010010006b00000000010000390000000101006039000000000001042d0000000001000019000000000001042d000000000100001900001cd5000104300000074901000041000000000101041a0000000002000411000000000012004b00001ad40000c13d000000000001042d000007f101000041000000000010043f000007a20100004100001cd5000104300001000000000002000100000002001d0000073c01100197000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f000000010020019000001aef0000613d0000000102000029000000c002200210000000000101043b000000000301041a000007c003300197000000000223019f000000000021041b000000000001042d000000000100001900001cd50001043000090000000000020000000004010019000000400100043d000500000001001d000007ff0010009c00001c510000813d00000005010000290000002003100039000700000003001d000000400030043f0000000000010435000000000002004b00001c610000613d0008073c0040019c00001c650000613d000000000500041a000007fc035001670000000001000019000000000031004b00001c190000213d0000000101100039000000000021004b00001b030000413d000200000003001d000400000004001d000300000002001d0000000801000029000000000010043f0000000501000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c70000801002000039000900000005001d1cd31cce0000040f000000010020019000001b650000613d0000000302000029000007c1022000d1000000000101043b000000000301041a0000000002230019000000000021041b000007520100004100000000001004430000000001000414000007360010009c0000073601008041000000c00110021000000753011001c70000800b020000391cd31cce0000040f000000010020019000001c600000613d000000000101043b000600000001001d0000000901000029000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f000000010020019000001b650000613d0000000602000029000000a0022002100000000303000029000000010030008c00000000030000190000075403006041000000000223019f0000000806000029000000000262019f000000000101043b000000000021041b0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d0200003900000004030000390000075504000041000000000500001900000009070000291cd31cc90000040f000000010020019000001b650000613d0000000902000029000600030020002d00000009070000290000000107700039000000060070006c00001b670000613d0000000001000414000007360010009c0000073601008041000000c0011002100000074a011001c70000800d020000390000000403000039000007550400004100000000050000190000000806000029000900000007001d1cd31cc90000040f000000010020019000001b530000c13d000000000100001900001cd5000104300000000601000029000000000010041b0000000001000019000000030200002900000004030000290000000204000029000000000041004b00001c190000213d0000000101100039000000000021004b00001b6d0000413d0000074501000041000000000010044300000004003004430000000001000414000007360010009c0000073601008041000000c00110021000000746011001c700008002020000391cd31cce0000040f000000010020019000001c600000613d000000000101043b000000000001004b00001c180000613d000000400a00043d000000000200041a000400000002001d000000030320006a0000000701000029000200200010009200000000010004110003073c0010019b000100800000003d000000200900008a0000006401a0003900000080020000390000000000210435000007560100004100000000001a04350000000401a00039000000030200002900000000002104350000004401a00039000600000003001d00000000003104350000002401a000390000000000010435000000050100002900000000010104330000008402a000390000000000120435000000000491016f0000001f0310018f000000a402a00039000000070020006b00001bb10000813d000000000004004b00001bac0000613d00000002053000290000000006320019000000200660008a0000000007460019000000000845001900000000080804330000000000870435000000200440008c00001ba60000c13d000000000003004b00001bc70000613d0000000704000029000000000502001900001bbd0000013d0000000005420019000000000004004b00001bba0000613d0000000706000029000000000702001900000000680604340000000007870436000000000057004b00001bb60000c13d000000000003004b00001bc70000613d00000007044000290000000303300210000000000605043300000000063601cf000000000636022f00000000040404330000010003300089000000000434022f00000000033401cf000000000363019f00000000003504350000001f03100039000000000393016f00000000012100190000000000010435000000a401300039000007360010009c000007360100804100000060011002100000073600a0009c000007360200004100000000020a40190000004002200210000000000121019f0000000002000414000007360020009c0000073602008041000000c002200210000000000121019f000000080200002900090000000a001d1cd31cc90000040f000000090a00002900000060031002700000073603300197000000200030008c00000020040000390000000004034019000000200640019000000000056a001900001beb0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b00001be70000c13d0000001f0740019000001bf80000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000000200900008a00001c1f0000613d0000001f01400039000000600210018f0000000001a20019000000000021004b00000000020000390000000102004039000007390010009c00001c510000213d000000010020019000001c510000c13d000000400010043f000000200030008c00001b650000413d00000000020a0433000007580020019800001b650000c13d0000075902200197000007560020009c000000060300002900001c4d0000c13d0000000103300039000000040030006c000000000a01001900001b8b0000413d000000000100041a000000040010006c00001b650000c13d000000000001042d000007cd01000041000000000010043f0000001101000039000000040010043f000007ce0100004100001cd500010430000000000003004b00001c230000c13d000000600200003900001c4a0000013d0000001f0230003900000737022001970000003f022000390000075704200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000007390040009c00001c510000213d000000010050019000001c510000c13d000000400040043f0000001f0430018f00000000063204360000073805300198000100000006001d000000000356001900001c3d0000613d000000000601034f0000000107000029000000006806043c0000000007870436000000000037004b00001c390000c13d000000000004004b00001c4a0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b00001c570000c13d000007d801000041000000000010043f000007ab0100004100001cd500010430000007cd01000041000000000010043f0000004101000039000000040010043f000007ce0100004100001cd5000104300000000102000029000007360020009c00000736020080410000004002200210000007360010009c00000736010080410000006001100210000000000121019f00001cd500010430000000000001042f000007da01000041000000000010043f000007ab0100004100001cd500010430000007d901000041000000000010043f000007ab0100004100001cd5000104300001000000000002000000000001004b00001c990000613d000000000200041a000000000012004b00001c990000a13d000100000001001d000000000010043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f000000010020019000001c970000613d000000000101043b000000000101041a000007a600100198000000010200002900001c990000c13d000000000001004b00001c960000c13d000000010220008a000100000002001d000000000020043f0000000401000039000000200010043f0000000001000414000007360010009c0000073601008041000000c00110021000000743011001c700008010020000391cd31cce0000040f000000010020019000001c970000613d000000000101043b000000000101041a000000000001004b000000010200002900001c830000613d000000000001042d000000000100001900001cd500010430000007ef01000041000000000010043f000007ab0100004100001cd50001043000010000000000020000074902000041000000000502041a00000000020004140000073c06100197000007360020009c0000073602008041000000c0012002100000074a011001c70000800d0200003900000003030000390000074b04000041000100000006001d1cd31cc90000040f000000010020019000001cb10000613d00000749010000410000000102000029000000000021041b000000000001042d000000000100001900001cd500010430000000000001042f000007360010009c00000736010080410000004001100210000007360020009c00000736020080410000006002200210000000000112019f0000000002000414000007360020009c0000073602008041000000c002200210000000000112019f0000074a011001c700008010020000391cd31cce0000040f000000010020019000001cc70000613d000000000101043b000000000001042d000000000100001900001cd50001043000001ccc002104210000000102000039000000000001042d0000000002000019000000000001042d00001cd1002104230000000102000039000000000001042d0000000002000019000000000001042d00001cd30000043200001cd40001042e00001cd5000104300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000000000000000000000000000ffffffffffffffff80000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000000000ffffffffffbfa87805ed57dc1f0d489ce33be4c4577d74ccde357eeeee058a32c55c44a532405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5acebfa87805ed57dc1f0d489ce33be4c4577d74ccde357eeeee058a32c55c44a5310200000000000000000000000000000000000020000000000000000000000000000000000000000000000000721c002b0059009a671d00ad1700c9748146cd1b0200000000000000000000000000000000000040000000000000000000000000cc5dc080ff977b3c3a211fa63ab74f90f658f5ba9d3236e92c8f59570f442aac1806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000fb2de5d7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff7487392702000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e000000000000000000000ffffffffffffffffffffffffffffffffffffffffffff0000000000ffffffffff0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffff0000000000ffffffffffffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffdffffffffffffffffffffffffffffffffffffffffffffffffeffffffffffffffff796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d9553913202000002000000000000000000000000000000040000000000000000000000000000000200000000000000000000000000000000000000000000000000000000ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef150b7a020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003ffffffe000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000aa4ec00224afccfdb70000000200000000000000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000006221d13b000000000000000000000000000000000000000000000000000000009b08a22e00000000000000000000000000000000000000000000000000000000c23dc68e00000000000000000000000000000000000000000000000000000000e985e9c400000000000000000000000000000000000000000000000000000000f2fde38a00000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000fee81cf400000000000000000000000000000000000000000000000000000000e985e9c500000000000000000000000000000000000000000000000000000000f04e283e00000000000000000000000000000000000000000000000000000000c23dc68f00000000000000000000000000000000000000000000000000000000c87b56dd00000000000000000000000000000000000000000000000000000000db846f7f00000000000000000000000000000000000000000000000000000000a9fc664d00000000000000000000000000000000000000000000000000000000a9fc664e00000000000000000000000000000000000000000000000000000000b88d4fde00000000000000000000000000000000000000000000000000000000c002d23d000000000000000000000000000000000000000000000000000000009b08a22f000000000000000000000000000000000000000000000000000000009e05d24000000000000000000000000000000000000000000000000000000000a22cb465000000000000000000000000000000000000000000000000000000007e55c5d60000000000000000000000000000000000000000000000000000000095d89b400000000000000000000000000000000000000000000000000000000095d89b410000000000000000000000000000000000000000000000000000000099a2557a000000000000000000000000000000000000000000000000000000009a4f41ba000000000000000000000000000000000000000000000000000000007e55c5d7000000000000000000000000000000000000000000000000000000008462151c000000000000000000000000000000000000000000000000000000008da5cb5b00000000000000000000000000000000000000000000000000000000690d831f00000000000000000000000000000000000000000000000000000000690d83200000000000000000000000000000000000000000000000000000000070a0823100000000000000000000000000000000000000000000000000000000715018a6000000000000000000000000000000000000000000000000000000006221d13c000000000000000000000000000000000000000000000000000000006352211e0000000000000000000000000000000000000000000000000000000068ec4eb20000000000000000000000000000000000000000000000000000000023b872dc0000000000000000000000000000000000000000000000000000000042af83fa0000000000000000000000000000000000000000000000000000000054d1f13c0000000000000000000000000000000000000000000000000000000057737ee50000000000000000000000000000000000000000000000000000000057737ee6000000000000000000000000000000000000000000000000000000005bbb21770000000000000000000000000000000000000000000000000000000054d1f13d0000000000000000000000000000000000000000000000000000000055f804b30000000000000000000000000000000000000000000000000000000042af83fb0000000000000000000000000000000000000000000000000000000050ebc2570000000000000000000000000000000000000000000000000000000054c06aee0000000000000000000000000000000000000000000000000000000032cb6b0b0000000000000000000000000000000000000000000000000000000032cb6b0c000000000000000000000000000000000000000000000000000000003c4bbb2d0000000000000000000000000000000000000000000000000000000042842e0e0000000000000000000000000000000000000000000000000000000023b872dd0000000000000000000000000000000000000000000000000000000025692962000000000000000000000000000000000000000000000000000000002a55205a00000000000000000000000000000000000000000000000000000000098144d3000000000000000000000000000000000000000000000000000000001138ebad000000000000000000000000000000000000000000000000000000001138ebae0000000000000000000000000000000000000000000000000000000018160ddd000000000000000000000000000000000000000000000000000000001a6f72ff00000000000000000000000000000000000000000000000000000000098144d4000000000000000000000000000000000000000000000000000000000a302530000000000000000000000000000000000000000000000000000000000d705df60000000000000000000000000000000000000000000000000000000006fdde020000000000000000000000000000000000000000000000000000000006fdde0300000000000000000000000000000000000000000000000000000000081812fc00000000000000000000000000000000000000000000000000000000095ea7b300000000000000000000000000000000000000000000000000000000014635460000000000000000000000000000000000000000000000000000000001ffc9a70000000000000000000000000000000000000000000000000000000004634d8d00000000000000000000000000000000000000000000000000000000389a75e10000000000000000000000000000000000000020000000800000000000000000000000000000000000000000000000000000000000000000000000007448fbae00000000000000000000000000000000000000040000001c000000000000000002000000000000000000000000000000000000200000000c0000000000000000000000000000000000000000000000000000000000000000000000006f5e881800000000000000000000000000000000000000200000000000000000000000000000000100000000000000000000000000000000000000000000000000000000df6966c971051c3d54ec59162606531493a51404a002842f56009d7e5cf4a8c700ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff3000000000000000000000000000000000000000000000000000000000000000a14c4b500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000009184e72a00032483afb00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff0017307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31ffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffff000000000000000000000100000000000000000000000000000000000000000002000000000000000000000000000000000000200000008000000000000000006787c7f9a80aa0f5ceddab2c54f1f5169c0b88e75dd5e19d5e858a64144c7dbcffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffff000000000000000000000000000000000000000000010000000000000000000032c1995a000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0000000000000000000000000000000000000000000000000ffffffffffffff7fc2575a0e9e593c00f959f8c92f12db2869c3395a3b0502d05e2516446f71f85b00000000000000000000000000000000000000000000003fffffffffffffffe08f4eb60400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff9fffffffffffffffff0000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000010000000000000001000000000000000000000000000000000000000000000000fffffffffffffffe000000000000000000000000000000000000000000000000ffffffffffff80009cc7f708afc65944829bd487b90b72536b1951864fbfc14e125fc972a6507f3900000000000000000000000000000000000000000000000000000000b12d13ebffffffffffffffffffffffffffffffffffffffffffffffffffffff00000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000ffffffffffffffffffffffffffffffffffffffffffff0bb25a4e00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffff0000000000ffffffffff00000000000000000000ff000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffffffffffeff4e487b710000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffff000000000000000000000000000000000000000000000000ffffffffffffffbfffffffffffffffef0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000209699368efae3c2ab13a6e9d9f9aceb6c5aebfb5ffd7bd0a9ff6281a30b5739209699368efae3c2ab13a6e9d9f9aceb6c5aebfb5ffd7bd0a9ff6281a30b5738fa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c920027b15500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffffffc000000d1a57ed6000000000000000000000000000000000000000000000000000000005cbd944100000000000000000000000000000000000000000000000000000000b562e8dd00000000000000000000000000000000000000000000000000000000ddefae2800000000000000000000000000000000000000000000000000000000e62edb7d000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff0000000000000000000000000000000000000040000000000000000000000000fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffd5d00dbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d000000000000000000000000000000000000000000ff00000000000000000000a11481000000000000000000000000000000000000000000000000000000000059c896be00000000000000000000000000000000000000000000000000000000caee23ea000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084000000000000000000000000ea553b34000000000000000000000000000000000000000000000000000000003d693ada00000000000000000000000000000000000000000000000000000000d2ade55600000000000000000000000000000000000000000000000000000000e2ebe17a00000000000000000000000000000000000000000000000000000000d05cb609000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000800000000000000000cfb3b94200000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff00000000000000000000000000000000000000008c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925df2d9b4200000000000000000000000000000000000000000000000000000000cf4700e4000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000082b4290000000000000000000000000000000000000000000000000000000000b4457eaa00000000000000000000000000000000000000000000000000000000350a88b380ac58ccffffffffffffffffffffffffffffffffffffffffffffffffffffffff80ac58cd00000000000000000000000000000000000000000000000000000000a07d229a00000000000000000000000000000000000000000000000000000000ad0d7f6c0000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000005b5e139f00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffff80000000000000000000000000000000000000000000000000ffffffffffffffe0935f7d4a141a485e432bdd18a016e93ce6372288ed073a12afc19db3215ff6d3
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
00000000000000000000000000000000000000000000000000000000000000e000000000000000000000000000000000000000000000000000000000000001200000000000000000000000007f0b69afd9aeef5803b4baab0764e71f5bf928050000000000000000000000000000000000000000000000000000000067bb8a3a0000000000000000000000000000000000000000000000000000000067bd10da0000000000000000000000000000000000000000000000000000000067be977a000000000000000000000000000000000000000000000000000000040d71eac400000000000000000000000000000000000000000000000000000000000000094255494c44204e465400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004424e465400000000000000000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : _name (string): BUILD NFT
Arg [1] : _symbol (string): BNFT
Arg [2] : _owner (address): 0x7f0B69afD9AEef5803b4baAB0764e71f5bF92805
Arg [3] : ogTimestamp (uint40): 1740343866
Arg [4] : wlTimestamp (uint40): 1740443866
Arg [5] : og2Timestamp (uint40): 1740543866
Arg [6] : pbTimestamp (uint40): 17405438660
-----Encoded View---------------
11 Constructor Arguments found :
Arg [0] : 00000000000000000000000000000000000000000000000000000000000000e0
Arg [1] : 0000000000000000000000000000000000000000000000000000000000000120
Arg [2] : 0000000000000000000000007f0b69afd9aeef5803b4baab0764e71f5bf92805
Arg [3] : 0000000000000000000000000000000000000000000000000000000067bb8a3a
Arg [4] : 0000000000000000000000000000000000000000000000000000000067bd10da
Arg [5] : 0000000000000000000000000000000000000000000000000000000067be977a
Arg [6] : 000000000000000000000000000000000000000000000000000000040d71eac4
Arg [7] : 0000000000000000000000000000000000000000000000000000000000000009
Arg [8] : 4255494c44204e46540000000000000000000000000000000000000000000000
Arg [9] : 0000000000000000000000000000000000000000000000000000000000000004
Arg [10] : 424e465400000000000000000000000000000000000000000000000000000000
[ Download: CSV Export ]
[ Download: CSV Export ]
A token is a representation of an on-chain or off-chain asset. The token page shows information such as price, total supply, holders, transfers and social links. Learn more about this page in our Knowledge Base.