ERC-721
Overview
Max Total Supply
2 BEARISH
Holders
1
Total Transfers
-
Market
Onchain Market Cap
$0.00
Circulating Supply Market Cap
-
Other Info
Token Contract
Loading...
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:
BearishHonoraries
Compiler Version
v0.8.28+commit.7893614a
ZkSolc Version
v1.5.10
Optimization Enabled:
Yes with Mode 3
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.28;
import "erc721a/contracts/ERC721A.sol";
import "erc721a/contracts/extensions/ERC721AQueryable.sol";
import "erc721a/contracts/extensions/ERC721ABurnable.sol";
import {Ownable} from "solady/src/auth/Ownable.sol";
/**
* @title BEARISH Honoraries
* @notice Airdropped to the community for their contributions to the project. BUT also burned based on number of votes.
* @author @bearish_af
*/
contract BearishHonoraries is
ERC721A,
ERC721AQueryable,
ERC721ABurnable,
Ownable
{
string public baseURIValue;
struct Vote {
uint256 numVotes;
uint256 requiredVotes;
}
mapping(uint256 => Vote) public votes;
mapping(uint256 => mapping(address => bool)) public voted;
mapping(uint256 => address) public burnedBy;
uint256 public burnThreshold;
error AlreadyVoted();
error NotEnoughVotes();
error TokenDoesNotExist();
constructor(
string memory baseURI_
) ERC721A("Bearish Honoraries", "BEARISH") {
_initializeOwner(msg.sender);
baseURIValue = baseURI_;
}
/**
* @notice Mint honorary NFTs
* @dev Only owner can mint
*/
function mint() external onlyOwner {
_mint(msg.sender, 1);
votes[totalSupply()].requiredVotes = 200;
}
/**
* @notice Burn a token
* @dev Only burns if the number of votes is greater than or equal to the required votes. Trustless.
* @param tokenId The token ID to burn
*/
function votedBurn(uint256 tokenId) external {
if (votes[tokenId].numVotes < votes[tokenId].requiredVotes)
revert NotEnoughVotes();
burnedBy[tokenId] = msg.sender;
_burn(tokenId);
}
/**
* @notice Force burn a token
* @param tokenId The token ID to burn
*/
function forceBurn(uint256 tokenId) external onlyOwner {
burnedBy[tokenId] = msg.sender;
_burn(tokenId);
}
/**
* @notice Get the starting token ID
* @return The starting token ID
*/
function _startTokenId() internal pure override returns (uint256) {
return 1;
}
/**
* @notice Get the base URI for the token metadata
* @return The base URI
*/
function baseURI() public view returns (string memory) {
return baseURIValue;
}
/**
* @notice Set the base URI for the token metadata
* @param newBaseURI The new base URI
*/
function setBaseURI(string memory newBaseURI) external onlyOwner {
baseURIValue = newBaseURI;
}
/**
* @notice Get the required votes for a token
* @param tokenId The token ID
* @return The required votes
*/
function requiredVotes(uint256 tokenId) public view returns (uint256) {
return votes[tokenId].requiredVotes;
}
/**
* @notice Get the number of votes for a token
* @param tokenId The token ID
* @return The number of votes
*/
function numVotes(uint256 tokenId) public view returns (uint256) {
return votes[tokenId].numVotes;
}
/**
* @notice Vote for a token
* @param tokenId The token ID
*/
function vote(uint256 tokenId) external {
if (voted[tokenId][msg.sender]) revert AlreadyVoted();
if (!_exists(tokenId)) revert TokenDoesNotExist();
voted[tokenId][msg.sender] = true;
votes[tokenId].numVotes++;
}
/**
* @notice Set the required votes for a token
* @param tokenId The token ID
* @param newRequiredVotes The new required votes
*/
function setRequiredVotes(
uint256 tokenId,
uint256 newRequiredVotes
) external onlyOwner {
if (!_exists(tokenId)) revert TokenDoesNotExist();
votes[tokenId].requiredVotes = newRequiredVotes;
}
}// 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
// ERC721A Contracts v4.3.0
// 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()`.
*
* The `_sequentialUpTo()` function can be overriden to enable spot mints
* (i.e. non-consecutive mints) for `tokenId`s greater than `_sequentialUpTo()`.
*
* Assumptions:
*
* - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply.
* - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256).
*/
contract 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;
// The amount of tokens minted above `_sequentialUpTo()`.
// We call these spot mints (i.e. non-sequential mints).
uint256 private _spotMinted;
// =============================================================
// CONSTRUCTOR
// =============================================================
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
_currentIndex = _startTokenId();
if (_sequentialUpTo() < _startTokenId()) _revert(SequentialUpToTooSmall.selector);
}
// =============================================================
// TOKEN COUNTING OPERATIONS
// =============================================================
/**
* @dev Returns the starting token ID for sequential mints.
*
* Override this function to change the starting token ID for sequential mints.
*
* Note: The value returned must never change after any tokens have been minted.
*/
function _startTokenId() internal view virtual returns (uint256) {
return 0;
}
/**
* @dev Returns the maximum token ID (inclusive) for sequential mints.
*
* Override this function to return a value less than 2**256 - 1,
* but greater than `_startTokenId()`, to enable spot (non-sequential) mints.
*
* Note: The value returned must never change after any tokens have been minted.
*/
function _sequentialUpTo() internal view virtual returns (uint256) {
return type(uint256).max;
}
/**
* @dev Returns the next token ID to be minted.
*/
function _nextTokenId() internal view virtual returns (uint256) {
return _currentIndex;
}
/**
* @dev Returns the total number of tokens in existence.
* Burned tokens will reduce the count.
* To get the total number of tokens minted, please see {_totalMinted}.
*/
function totalSupply() public view virtual override returns (uint256 result) {
// Counter underflow is impossible as `_burnCounter` cannot be incremented
// more than `_currentIndex + _spotMinted - _startTokenId()` times.
unchecked {
// With spot minting, the intermediate `result` can be temporarily negative,
// and the computation must be unchecked.
result = _currentIndex - _burnCounter - _startTokenId();
if (_sequentialUpTo() != type(uint256).max) result += _spotMinted;
}
}
/**
* @dev Returns the total amount of tokens minted in the contract.
*/
function _totalMinted() internal view virtual returns (uint256 result) {
// Counter underflow is impossible as `_currentIndex` does not decrement,
// and it is initialized to `_startTokenId()`.
unchecked {
result = _currentIndex - _startTokenId();
if (_sequentialUpTo() != type(uint256).max) result += _spotMinted;
}
}
/**
* @dev Returns the total number of tokens burned.
*/
function _totalBurned() internal view virtual returns (uint256) {
return _burnCounter;
}
/**
* @dev Returns the total number of tokens that are spot-minted.
*/
function _totalSpotMinted() internal view virtual returns (uint256) {
return _spotMinted;
}
// =============================================================
// ADDRESS DATA OPERATIONS
// =============================================================
/**
* @dev Returns the number of tokens in `owner`'s account.
*/
function balanceOf(address owner) public view virtual override returns (uint256) {
if (owner == address(0)) _revert(BalanceQueryForZeroAddress.selector);
return _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.selector);
string memory baseURI = _baseURI();
return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : '';
}
/**
* @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
* token will be the concatenation of the `baseURI` and the `tokenId`. Empty
* by default, it can be overridden in child contracts.
*/
function _baseURI() internal view virtual returns (string memory) {
return '';
}
// =============================================================
// OWNERSHIPS OPERATIONS
// =============================================================
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) public view virtual override returns (address) {
return address(uint160(_packedOwnershipOf(tokenId)));
}
/**
* @dev Gas spent here starts off proportional to the maximum mint batch size.
* It gradually moves to O(1) as tokens get transferred around over time.
*/
function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) {
return _unpackedOwnership(_packedOwnershipOf(tokenId));
}
/**
* @dev Returns the unpacked `TokenOwnership` struct at `index`.
*/
function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) {
return _unpackedOwnership(_packedOwnerships[index]);
}
/**
* @dev Returns whether the ownership slot at `index` is initialized.
* An uninitialized slot does not necessarily mean that the slot has no owner.
*/
function _ownershipIsInitialized(uint256 index) internal view virtual returns (bool) {
return _packedOwnerships[index] != 0;
}
/**
* @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);
}
}
/**
* @dev Returns the packed ownership data of `tokenId`.
*/
function _packedOwnershipOf(uint256 tokenId) private view returns (uint256 packed) {
if (_startTokenId() <= tokenId) {
packed = _packedOwnerships[tokenId];
if (tokenId > _sequentialUpTo()) {
if (_packedOwnershipExists(packed)) return packed;
_revert(OwnerQueryForNonexistentToken.selector);
}
// If the data at the starting slot does not exist, start the scan.
if (packed == 0) {
if (tokenId >= _currentIndex) _revert(OwnerQueryForNonexistentToken.selector);
// Invariant:
// There will always be an initialized ownership slot
// (i.e. `ownership.addr != address(0) && ownership.burned == false`)
// before an unintialized ownership slot
// (i.e. `ownership.addr == address(0) && ownership.burned == false`)
// Hence, `tokenId` will not underflow.
//
// We can directly compare the packed value.
// If the address is zero, packed will be zero.
for (;;) {
unchecked {
packed = _packedOwnerships[--tokenId];
}
if (packed == 0) continue;
if (packed & _BITMASK_BURNED == 0) return packed;
// Otherwise, the token is burned, and we must revert.
// This handles the case of batch burned tokens, where only the burned bit
// of the starting slot is set, and remaining slots are left uninitialized.
_revert(OwnerQueryForNonexistentToken.selector);
}
}
// Otherwise, the data exists and we can skip the scan.
// This is possible because we have already achieved the target condition.
// This saves 2143 gas on transfers of initialized tokens.
// If the token is not burned, return `packed`. Otherwise, revert.
if (packed & _BITMASK_BURNED == 0) return packed;
}
_revert(OwnerQueryForNonexistentToken.selector);
}
/**
* @dev Returns the unpacked `TokenOwnership` struct from `packed`.
*/
function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) {
ownership.addr = address(uint160(packed));
ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP);
ownership.burned = packed & _BITMASK_BURNED != 0;
ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA);
}
/**
* @dev Packs ownership data into a single uint256.
*/
function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`.
result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags))
}
}
/**
* @dev Returns the `nextInitialized` flag set if `quantity` equals 1.
*/
function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) {
// For branchless setting of the `nextInitialized` flag.
assembly {
// `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`.
result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1))
}
}
// =============================================================
// APPROVAL OPERATIONS
// =============================================================
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account. See {ERC721A-_approve}.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
*/
function approve(address to, uint256 tokenId) public payable virtual override {
_approve(to, tokenId, true);
}
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) public view virtual override returns (address) {
if (!_exists(tokenId)) _revert(ApprovalQueryForNonexistentToken.selector);
return _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 result) {
if (_startTokenId() <= tokenId) {
if (tokenId > _sequentialUpTo()) return _packedOwnershipExists(_packedOwnerships[tokenId]);
if (tokenId < _currentIndex) {
uint256 packed;
while ((packed = _packedOwnerships[tokenId]) == 0) --tokenId;
result = packed & _BITMASK_BURNED == 0;
}
}
}
/**
* @dev Returns whether `packed` represents a token that exists.
*/
function _packedOwnershipExists(uint256 packed) private pure returns (bool result) {
assembly {
// The following is equivalent to `owner != address(0) && burned == false`.
// Symbolically tested.
result := gt(and(packed, _BITMASK_ADDRESS), and(packed, _BITMASK_BURNED))
}
}
/**
* @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`.
*/
function _isSenderApprovedOrOwner(
address approvedAddress,
address owner,
address msgSender
) private pure returns (bool result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean.
msgSender := and(msgSender, _BITMASK_ADDRESS)
// `msgSender == owner || msgSender == approvedAddress`.
result := or(eq(msgSender, owner), eq(msgSender, approvedAddress))
}
}
/**
* @dev Returns the storage slot and value for the approved address of `tokenId`.
*/
function _getApprovedSlotAndAddress(uint256 tokenId)
private
view
returns (uint256 approvedAddressSlot, address approvedAddress)
{
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);
// Mask `from` to the lower 160 bits, in case the upper bits somehow aren't clean.
from = address(uint160(uint256(uint160(from)) & _BITMASK_ADDRESS));
if (address(uint160(prevOwnershipPacked)) != from) _revert(TransferFromIncorrectOwner.selector);
(uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);
// The nested ifs save around 20+ gas over a compound boolean condition.
if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
if (!isApprovedForAll(from, _msgSenderERC721A())) _revert(TransferCallerNotOwnerNorApproved.selector);
_beforeTokenTransfers(from, to, tokenId, 1);
// Clear approvals from the previous owner.
assembly {
if approvedAddress {
// This is equivalent to `delete _tokenApprovals[tokenId]`.
sstore(approvedAddressSlot, 0)
}
}
// Underflow of the sender's balance is impossible because we check for
// ownership above and the recipient's balance can't realistically overflow.
// Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
unchecked {
// We can directly increment and decrement the balances.
--_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;
}
}
}
}
// Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS;
assembly {
// Emit the `Transfer` event.
log4(
0, // Start of data (0, since no data).
0, // End of data (0, since no data).
_TRANSFER_EVENT_SIGNATURE, // Signature.
from, // `from`.
toMasked, // `to`.
tokenId // `tokenId`.
)
}
if (toMasked == 0) _revert(TransferToZeroAddress.selector);
_afterTokenTransfers(from, to, tokenId, 1);
}
/**
* @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) public payable virtual override {
safeTransferFrom(from, to, tokenId, '');
}
/**
* @dev Safely transfers `tokenId` token from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes memory _data
) public payable virtual override {
transferFrom(from, to, tokenId);
if (to.code.length != 0)
if (!_checkContractOnERC721Received(from, to, tokenId, _data)) {
_revert(TransferToNonERC721ReceiverImplementer.selector);
}
}
/**
* @dev Hook that is called before a set of serially-ordered token IDs
* are about to be transferred. This includes minting.
* And also called before burning one token.
*
* `startTokenId` - the first token ID to be transferred.
* `quantity` - the amount to be transferred.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
* transferred to `to`.
* - When `from` is zero, `tokenId` will be minted for `to`.
* - When `to` is zero, `tokenId` will be burned by `from`.
* - `from` and `to` are never both zero.
*/
function _beforeTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual {}
/**
* @dev Hook that is called after a set of serially-ordered token IDs
* have been transferred. This includes minting.
* And also called after one token has been burned.
*
* `startTokenId` - the first token ID to be transferred.
* `quantity` - the amount to be transferred.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` has been
* transferred to `to`.
* - When `from` is zero, `tokenId` has been minted for `to`.
* - When `to` is zero, `tokenId` has been burned by `from`.
* - `from` and `to` are never both zero.
*/
function _afterTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual {}
/**
* @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract.
*
* `from` - Previous owner of the given token ID.
* `to` - Target address that will receive the token.
* `tokenId` - Token ID to be transferred.
* `_data` - Optional data to send along with the call.
*
* Returns whether the call correctly returned the expected magic value.
*/
function _checkContractOnERC721Received(
address from,
address to,
uint256 tokenId,
bytes memory _data
) private returns (bool) {
try ERC721A__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.selector);
}
assembly {
revert(add(32, reason), mload(reason))
}
}
}
// =============================================================
// MINT OPERATIONS
// =============================================================
/**
* @dev Mints `quantity` tokens and transfers them to `to`.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `quantity` must be greater than 0.
*
* Emits a {Transfer} event for each mint.
*/
function _mint(address to, uint256 quantity) internal virtual {
uint256 startTokenId = _currentIndex;
if (quantity == 0) _revert(MintZeroQuantity.selector);
_beforeTokenTransfers(address(0), to, startTokenId, quantity);
// Overflows are incredibly unrealistic.
// `balance` and `numberMinted` have a maximum limit of 2**64.
// `tokenId` has a maximum limit of 2**256.
unchecked {
// Updates:
// - `address` to the owner.
// - `startTimestamp` to the timestamp of minting.
// - `burned` to `false`.
// - `nextInitialized` to `quantity == 1`.
_packedOwnerships[startTokenId] = _packOwnershipData(
to,
_nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
);
// Updates:
// - `balance += quantity`.
// - `numberMinted += quantity`.
//
// We can directly add to the `balance` and `numberMinted`.
_packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);
// Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS;
if (toMasked == 0) _revert(MintToZeroAddress.selector);
uint256 end = startTokenId + quantity;
uint256 tokenId = startTokenId;
if (end - 1 > _sequentialUpTo()) _revert(SequentialMintExceedsLimit.selector);
do {
assembly {
// Emit the `Transfer` event.
log4(
0, // Start of data (0, since no data).
0, // End of data (0, since no data).
_TRANSFER_EVENT_SIGNATURE, // Signature.
0, // `address(0)`.
toMasked, // `to`.
tokenId // `tokenId`.
)
}
// The `!=` check ensures that large values of `quantity`
// that overflows uint256 will make the loop run out of gas.
} while (++tokenId != end);
_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.selector);
if (quantity == 0) _revert(MintZeroQuantity.selector);
if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) _revert(MintERC2309QuantityExceedsLimit.selector);
_beforeTokenTransfers(address(0), to, startTokenId, quantity);
// Overflows are unrealistic due to the above check for `quantity` to be below the limit.
unchecked {
// Updates:
// - `balance += quantity`.
// - `numberMinted += quantity`.
//
// We can directly add to the `balance` and `numberMinted`.
_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)
);
if (startTokenId + quantity - 1 > _sequentialUpTo()) _revert(SequentialMintExceedsLimit.selector);
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.selector);
}
} while (index < end);
// This prevents reentrancy to `_safeMint`.
// It does not prevent reentrancy to `_safeMintSpot`.
if (_currentIndex != end) revert();
}
}
}
/**
* @dev Equivalent to `_safeMint(to, quantity, '')`.
*/
function _safeMint(address to, uint256 quantity) internal virtual {
_safeMint(to, quantity, '');
}
/**
* @dev Mints a single token at `tokenId`.
*
* Note: A spot-minted `tokenId` that has been burned can be re-minted again.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `tokenId` must be greater than `_sequentialUpTo()`.
* - `tokenId` must not exist.
*
* Emits a {Transfer} event for each mint.
*/
function _mintSpot(address to, uint256 tokenId) internal virtual {
if (tokenId <= _sequentialUpTo()) _revert(SpotMintTokenIdTooSmall.selector);
uint256 prevOwnershipPacked = _packedOwnerships[tokenId];
if (_packedOwnershipExists(prevOwnershipPacked)) _revert(TokenAlreadyExists.selector);
_beforeTokenTransfers(address(0), to, tokenId, 1);
// Overflows are incredibly unrealistic.
// The `numberMinted` for `to` is incremented by 1, and has a max limit of 2**64 - 1.
// `_spotMinted` is incremented by 1, and has a max limit of 2**256 - 1.
unchecked {
// Updates:
// - `address` to the owner.
// - `startTimestamp` to the timestamp of minting.
// - `burned` to `false`.
// - `nextInitialized` to `true` (as `quantity == 1`).
_packedOwnerships[tokenId] = _packOwnershipData(
to,
_nextInitializedFlag(1) | _nextExtraData(address(0), to, prevOwnershipPacked)
);
// Updates:
// - `balance += 1`.
// - `numberMinted += 1`.
//
// We can directly add to the `balance` and `numberMinted`.
_packedAddressData[to] += (1 << _BITPOS_NUMBER_MINTED) | 1;
// Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
uint256 toMasked = uint256(uint160(to)) & _BITMASK_ADDRESS;
if (toMasked == 0) _revert(MintToZeroAddress.selector);
assembly {
// Emit the `Transfer` event.
log4(
0, // Start of data (0, since no data).
0, // End of data (0, since no data).
_TRANSFER_EVENT_SIGNATURE, // Signature.
0, // `address(0)`.
toMasked, // `to`.
tokenId // `tokenId`.
)
}
++_spotMinted;
}
_afterTokenTransfers(address(0), to, tokenId, 1);
}
/**
* @dev Safely mints a single token at `tokenId`.
*
* Note: A spot-minted `tokenId` that has been burned can be re-minted again.
*
* Requirements:
*
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}.
* - `tokenId` must be greater than `_sequentialUpTo()`.
* - `tokenId` must not exist.
*
* See {_mintSpot}.
*
* Emits a {Transfer} event.
*/
function _safeMintSpot(
address to,
uint256 tokenId,
bytes memory _data
) internal virtual {
_mintSpot(to, tokenId);
unchecked {
if (to.code.length != 0) {
uint256 currentSpotMinted = _spotMinted;
if (!_checkContractOnERC721Received(address(0), to, tokenId, _data)) {
_revert(TransferToNonERC721ReceiverImplementer.selector);
}
// This prevents reentrancy to `_safeMintSpot`.
// It does not prevent reentrancy to `_safeMint`.
if (_spotMinted != currentSpotMinted) revert();
}
}
}
/**
* @dev Equivalent to `_safeMintSpot(to, tokenId, '')`.
*/
function _safeMintSpot(address to, uint256 tokenId) internal virtual {
_safeMintSpot(to, tokenId, '');
}
// =============================================================
// APPROVAL OPERATIONS
// =============================================================
/**
* @dev Equivalent to `_approve(to, tokenId, false)`.
*/
function _approve(address to, uint256 tokenId) internal virtual {
_approve(to, tokenId, false);
}
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the
* zero address clears previous approvals.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function _approve(
address to,
uint256 tokenId,
bool approvalCheck
) internal virtual {
address owner = ownerOf(tokenId);
if (approvalCheck && _msgSenderERC721A() != owner)
if (!isApprovedForAll(owner, _msgSenderERC721A())) {
_revert(ApprovalCallerNotOwnerNorApproved.selector);
}
_tokenApprovals[tokenId].value = to;
emit Approval(owner, to, tokenId);
}
// =============================================================
// BURN OPERATIONS
// =============================================================
/**
* @dev Equivalent to `_burn(tokenId, false)`.
*/
function _burn(uint256 tokenId) internal virtual {
_burn(tokenId, false);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/
function _burn(uint256 tokenId, bool approvalCheck) internal virtual {
uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);
address from = address(uint160(prevOwnershipPacked));
(uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);
if (approvalCheck) {
// The nested ifs save around 20+ gas over a compound boolean condition.
if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
if (!isApprovedForAll(from, _msgSenderERC721A())) _revert(TransferCallerNotOwnerNorApproved.selector);
}
_beforeTokenTransfers(from, address(0), tokenId, 1);
// Clear approvals from the previous owner.
assembly {
if approvedAddress {
// This is equivalent to `delete _tokenApprovals[tokenId]`.
sstore(approvedAddressSlot, 0)
}
}
// Underflow of the sender's balance is impossible because we check for
// ownership above and the recipient's balance can't realistically overflow.
// Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
unchecked {
// Updates:
// - `balance -= 1`.
// - `numberBurned += 1`.
//
// We can directly decrement the balance, and increment the number burned.
// This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`.
_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 + _spotMinted` 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.selector);
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)
}
}
/**
* @dev For more efficient reverts.
*/
function _revert(bytes4 errorSelector) internal pure {
assembly {
mstore(0x00, errorSelector)
revert(0x00, 0x04)
}
}
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.3.0
// Creator: Chiru Labs
pragma solidity ^0.8.4;
import './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 ownership)
{
unchecked {
if (tokenId >= _startTokenId()) {
if (tokenId > _sequentialUpTo()) return _ownershipAt(tokenId);
if (tokenId < _nextTokenId()) {
// If the `tokenId` is within bounds,
// scan backwards for the initialized ownership slot.
while (!_ownershipIsInitialized(tokenId)) --tokenId;
return _ownershipAt(tokenId);
}
}
}
}
/**
* @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order.
* See {ERC721AQueryable-explicitOwnershipOf}
*/
function explicitOwnershipsOf(uint256[] calldata tokenIds)
external
view
virtual
override
returns (TokenOwnership[] memory)
{
TokenOwnership[] memory ownerships;
uint256 i = tokenIds.length;
assembly {
// Grab the free memory pointer.
ownerships := mload(0x40)
// Store the length.
mstore(ownerships, i)
// Allocate one word for the length,
// `tokenIds.length` words for the pointers.
i := shl(5, i) // Multiply `i` by 32.
mstore(0x40, add(add(ownerships, 0x20), i))
}
while (i != 0) {
uint256 tokenId;
assembly {
i := sub(i, 0x20)
tokenId := calldataload(add(tokenIds.offset, i))
}
TokenOwnership memory ownership = explicitOwnershipOf(tokenId);
assembly {
// Store the pointer of `ownership` in the `ownerships` array.
mstore(add(add(ownerships, 0x20), i), ownership)
}
}
return ownerships;
}
/**
* @dev Returns an array of token IDs owned by `owner`,
* in the range [`start`, `stop`)
* (i.e. `start <= tokenId < stop`).
*
* This function allows for tokens to be queried if the collection
* grows too big for a single call of {ERC721AQueryable-tokensOfOwner}.
*
* Requirements:
*
* - `start < stop`
*/
function tokensOfOwnerIn(
address owner,
uint256 start,
uint256 stop
) external view virtual override returns (uint256[] memory) {
return _tokensOfOwnerIn(owner, start, stop);
}
/**
* @dev Returns an array of token IDs owned by `owner`.
*
* This function scans the ownership mapping and is O(`totalSupply`) in complexity.
* It is meant to be called off-chain.
*
* See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into
* multiple smaller scans if the collection is large enough to cause
* an out-of-gas error (10K collections should be fine).
*/
function tokensOfOwner(address owner) external view virtual override returns (uint256[] memory) {
// If spot mints are enabled, full-range scan is disabled.
if (_sequentialUpTo() != type(uint256).max) _revert(NotCompatibleWithSpotMints.selector);
uint256 start = _startTokenId();
uint256 stop = _nextTokenId();
uint256[] memory tokenIds;
if (start != stop) tokenIds = _tokensOfOwnerIn(owner, start, stop);
return tokenIds;
}
/**
* @dev Helper function for returning an array of token IDs owned by `owner`.
*
* Note that this function is optimized for smaller bytecode size over runtime gas,
* since it is meant to be called off-chain.
*/
function _tokensOfOwnerIn(
address owner,
uint256 start,
uint256 stop
) private view returns (uint256[] memory tokenIds) {
unchecked {
if (start >= stop) _revert(InvalidQueryRange.selector);
// Set `start = max(start, _startTokenId())`.
if (start < _startTokenId()) start = _startTokenId();
uint256 nextTokenId = _nextTokenId();
// If spot mints are enabled, scan all the way until the specified `stop`.
uint256 stopLimit = _sequentialUpTo() != type(uint256).max ? stop : nextTokenId;
// Set `stop = min(stop, stopLimit)`.
if (stop >= stopLimit) stop = stopLimit;
// Number of tokens to scan.
uint256 tokenIdsMaxLength = balanceOf(owner);
// Set `tokenIdsMaxLength` to zero if the range contains no tokens.
if (start >= stop) tokenIdsMaxLength = 0;
// If there are one or more tokens to scan.
if (tokenIdsMaxLength != 0) {
// Set `tokenIdsMaxLength = min(balanceOf(owner), tokenIdsMaxLength)`.
if (stop - start <= tokenIdsMaxLength) tokenIdsMaxLength = stop - start;
uint256 m; // Start of available memory.
assembly {
// Grab the free memory pointer.
tokenIds := mload(0x40)
// Allocate one word for the length, and `tokenIdsMaxLength` words
// for the data. `shl(5, x)` is equivalent to `mul(32, x)`.
m := add(tokenIds, shl(5, add(tokenIdsMaxLength, 1)))
mstore(0x40, m)
}
// We need to call `explicitOwnershipOf(start)`,
// because the slot at `start` may not be initialized.
TokenOwnership memory ownership = explicitOwnershipOf(start);
address currOwnershipAddr;
// If the starting slot exists (i.e. not burned),
// initialize `currOwnershipAddr`.
// `ownership.address` will not be zero,
// as `start` is clamped to the valid token ID range.
if (!ownership.burned) currOwnershipAddr = ownership.addr;
uint256 tokenIdsIdx;
// Use a do-while, which is slightly more efficient for this case,
// as the array will at least contain one element.
do {
if (_sequentialUpTo() != type(uint256).max) {
// Skip the remaining unused sequential slots.
if (start == nextTokenId) start = _sequentialUpTo() + 1;
// Reset `currOwnershipAddr`, as each spot-minted token is a batch of one.
if (start > _sequentialUpTo()) currOwnershipAddr = address(0);
}
ownership = _ownershipAt(start); // This implicitly allocates memory.
assembly {
switch mload(add(ownership, 0x40))
// if `ownership.burned == false`.
case 0 {
// if `ownership.addr != address(0)`.
// The `addr` already has it's upper 96 bits clearned,
// since it is written to memory with regular Solidity.
if mload(ownership) {
currOwnershipAddr := mload(ownership)
}
// if `currOwnershipAddr == owner`.
// The `shl(96, x)` is to make the comparison agnostic to any
// dirty upper 96 bits in `owner`.
if iszero(shl(96, xor(currOwnershipAddr, owner))) {
tokenIdsIdx := add(tokenIdsIdx, 1)
mstore(add(tokenIds, shl(5, tokenIdsIdx)), start)
}
}
// Otherwise, reset `currOwnershipAddr`.
// This handles the case of batch burned tokens
// (burned bit of first slot set, remaining slots left uninitialized).
default {
currOwnershipAddr := 0
}
start := add(start, 1)
// Free temporary memory implicitly allocated for ownership
// to avoid quadratic memory expansion costs.
mstore(0x40, m)
}
} while (!(start == stop || tokenIdsIdx == tokenIdsMaxLength));
// Store the length of the array.
assembly {
mstore(tokenIds, tokenIdsIdx)
}
}
}
}
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.3.0
// Creator: Chiru Labs
pragma solidity ^0.8.4;
import './IERC721ABurnable.sol';
import '../ERC721A.sol';
/**
* @title ERC721ABurnable.
*
* @dev ERC721A token that can be irreversibly burned (destroyed).
*/
abstract contract ERC721ABurnable is ERC721A, IERC721ABurnable {
/**
* @dev Burns `tokenId`. See {ERC721A-_burn}.
*
* Requirements:
*
* - The caller must own `tokenId` or be an approved operator.
*/
function burn(uint256 tokenId) public virtual override {
_burn(tokenId, true);
}
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.3.0
// 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();
/**
* `_sequentialUpTo()` must be greater than `_startTokenId()`.
*/
error SequentialUpToTooSmall();
/**
* The `tokenId` of a sequential mint exceeds `_sequentialUpTo()`.
*/
error SequentialMintExceedsLimit();
/**
* Spot minting requires a `tokenId` greater than `_sequentialUpTo()`.
*/
error SpotMintTokenIdTooSmall();
/**
* Cannot mint over a token that already exists.
*/
error TokenAlreadyExists();
/**
* The feature is not compatible with spot mints.
*/
error NotCompatibleWithSpotMints();
// =============================================================
// STRUCTS
// =============================================================
struct TokenOwnership {
// The address of the owner.
address addr;
// Stores the start time of ownership with minimal overhead for tokenomics.
uint64 startTimestamp;
// Whether the token has been burned.
bool burned;
// Arbitrary data similar to `startTimestamp` that can be set via {_extraData}.
uint24 extraData;
}
// =============================================================
// TOKEN COUNTERS
// =============================================================
/**
* @dev Returns the total number of tokens in existence.
* Burned tokens will reduce the count.
* To get the total number of tokens minted, please see {_totalMinted}.
*/
function totalSupply() external view returns (uint256);
// =============================================================
// IERC165
// =============================================================
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
* to learn more about how these ids are created.
*
* This function call must use less than 30000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
// =============================================================
// IERC721
// =============================================================
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables
* (`approved`) `operator` to manage all of its assets.
*/
event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
/**
* @dev Returns the number of tokens in `owner`'s account.
*/
function balanceOf(address owner) external view returns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) external view returns (address owner);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`,
* checking first that contract recipients are aware of the ERC721 protocol
* to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be have been allowed to move
* this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes calldata data
) external payable;
/**
* @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) external payable;
/**
* @dev Transfers `tokenId` from `from` to `to`.
*
* WARNING: Usage of this method is discouraged, use {safeTransferFrom}
* whenever possible.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) external payable;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the
* zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) external payable;
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom}
* for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool _approved) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) external view returns (address operator);
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address owner, address operator) external view returns (bool);
// =============================================================
// IERC721Metadata
// =============================================================
/**
* @dev Returns the token collection name.
*/
function name() external view returns (string memory);
/**
* @dev Returns the token collection symbol.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) external view returns (string memory);
// =============================================================
// IERC2309
// =============================================================
/**
* @dev Emitted when tokens in `fromTokenId` to `toTokenId`
* (inclusive) is transferred from `from` to `to`, as defined in the
* [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard.
*
* See {_mintERC2309} for more details.
*/
event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to);
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.3.0
// 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.3.0
// Creator: Chiru Labs
pragma solidity ^0.8.4;
import '../IERC721A.sol';
/**
* @dev Interface of ERC721ABurnable.
*/
interface IERC721ABurnable is IERC721A {
/**
* @dev Burns `tokenId`. See {ERC721A-_burn}.
*
* Requirements:
*
* - The caller must own `tokenId` or be an approved operator.
*/
function burn(uint256 tokenId) external;
}{
"evmVersion": "paris",
"optimizer": {
"enabled": true,
"mode": "3",
"runs": 200
},
"outputSelection": {
"*": {
"*": [
"abi"
]
}
},
"detectMissingLibraries": false,
"forceEVMLA": false,
"enableEraVMExtensions": false,
"libraries": {}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[{"internalType":"string","name":"baseURI_","type":"string"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AlreadyInitialized","type":"error"},{"inputs":[],"name":"AlreadyVoted","type":"error"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"InvalidQueryRange","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"NewOwnerIsZeroAddress","type":"error"},{"inputs":[],"name":"NoHandoverRequest","type":"error"},{"inputs":[],"name":"NotCompatibleWithSpotMints","type":"error"},{"inputs":[],"name":"NotEnoughVotes","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"SequentialMintExceedsLimit","type":"error"},{"inputs":[],"name":"SequentialUpToTooSmall","type":"error"},{"inputs":[],"name":"SpotMintTokenIdTooSmall","type":"error"},{"inputs":[],"name":"TokenAlreadyExists","type":"error"},{"inputs":[],"name":"TokenDoesNotExist","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":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"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURIValue","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"burnThreshold","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"burnedBy","outputs":[{"internalType":"address","name":"","type":"address"}],"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":"ownership","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"explicitOwnershipsOf","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint64","name":"startTimestamp","type":"uint64"},{"internalType":"bool","name":"burned","type":"bool"},{"internalType":"uint24","name":"extraData","type":"uint24"}],"internalType":"struct IERC721A.TokenOwnership[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"forceBurn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"numVotes","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","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":[],"name":"renounceOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"requestOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"requiredVotes","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"newBaseURI","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"newRequiredVotes","type":"uint256"}],"name":"setRequiredVotes","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"tokensOfOwner","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"start","type":"uint256"},{"internalType":"uint256","name":"stop","type":"uint256"}],"name":"tokensOfOwnerIn","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"vote","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"","type":"address"}],"name":"voted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"votedBurn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"votes","outputs":[{"internalType":"uint256","name":"numVotes","type":"uint256"},{"internalType":"uint256","name":"requiredVotes","type":"uint256"}],"stateMutability":"view","type":"function"}]Contract Creation Code
9c4d535b00000000000000000000000000000000000000000000000000000000000000000100048b688acc077315b283db1199cc3696485a6faf8ba532b32fd285530a51000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002b68747470733a2f2f626561726973682e61662f6170692f6d657461646174612f686f6e6f7261726965732f000000000000000000000000000000000000000000
Deployed Bytecode
0x0001000000000002000800000000000200000000000103550000008004000039000000400040043f000000600310027000000401033001970000000100200190000000730000c13d000000040030008c00000a850000413d000000000201043b000000e002200270000004120020009c000001010000213d0000042e0020009c000001180000213d0000043c0020009c0000016a0000213d000004430020009c000002210000a13d000004440020009c000003260000613d000004450020009c000003450000613d000004460020009c00000a850000c13d000000440030008c00000a850000413d0000000402100370000000000202043b000700000002001d0000040d0020009c00000a850000213d0000002401100370000000000101043b000000000001004b000003950000613d000600000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b0000004e0000c13d000000000100041a0000000602000029000000000021004b000003950000a13d000000010220008a000800000002001d000000000020043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b00000008020000290000003b0000613d0000045300100198000003950000c13d0008040d0010019b0000000002000411000000080020006c000008930000c13d0000000601000029000000000010043f0000000601000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d00000007020000290000040d06200197000000000101043b000000000201041a0000046502200197000000000262019f000000000021041b0000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d020000390000000403000039000004720400004100000008050000290000000607000029000004680000013d0000000002000416000000000002004b00000a850000c13d0000001f0230003900000402022001970000008002200039000000400020043f0000001f0530018f00000403063001980000008002600039000000830000613d000000000701034f000000007807043c0000000004840436000000000024004b0000007f0000c13d000000000005004b000000900000613d000000000161034f0000000304500210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000120435000000200030008c00000a850000413d000000800200043d000004040020009c00000a850000213d0000001f01200039000000000031004b000000000400001900000405040080410000040501100197000000000001004b00000000050000190000040505004041000004050010009c000000000504c019000000000005004b00000a850000c13d00000080012000390000000001010433000004040010009c000007940000213d0000001f041000390000047c044001970000003f044000390000047c04400197000000400600043d0000000004460019000000000064004b00000000050000390000000105004039000004040040009c000007940000213d0000000100500190000007940000c13d0000008003300039000000400040043f000800000006001d0000000004160436000700000004001d000000a0022000390000000004210019000000000034004b00000a850000213d000000000001004b0000000706000029000000c60000613d000000000300001900000000043600190000000005230019000000000505043300000000005404350000002003300039000000000013004b000000bf0000413d000000080110002900000020011000390000000000010435000000400200043d000004060020009c000007940000213d0000004001200039000000400010043f0000001201000039000000000412043600000407010000410000000000140435000000400900043d000004060090009c000007940000213d0000004001900039000000400010043f0000000701000039000000000a190436000004080100004100000000001a04350000000003020433000004040030009c000007940000213d0000000201000039000000000501041a000000010650019000000001055002700000007f0550618f0000001f0050008c00000000070000390000000107002039000000000076004b000003860000c13d000000200050008c000000f90000413d000000000010043f0000001f063000390000000506600270000004090660009a000000200030008c0000040a060040410000001f055000390000000505500270000004090550009a000000000056004b000000f90000813d000000000006041b0000000106600039000000000056004b000000f50000413d0000001f0030008c000006fc0000a13d000000000010043f0000047c06300198000007780000c13d00000020050000390000040a04000041000007840000013d000004130020009c0000014f0000213d000004210020009c0000019d0000213d000004280020009c000002390000a13d000004290020009c000003680000613d0000042a0020009c000003780000613d0000042b0020009c00000a850000c13d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b0000040d0010009c00000a850000213d10010ca40000040f000003710000013d0000042f0020009c000001c40000213d000004360020009c0000025c0000a13d000004370020009c0000038c0000613d000004380020009c000003990000613d000004390020009c00000a850000c13d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b000800000001001d000000000010043f0000000a01000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000700000001001d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b0000000101100039000000000101041a000000070010006b000005720000813d0000046601000041000000000010043f00000455010000410000100300010430000004140020009c0000020a0000213d0000041b0020009c000002710000a13d0000041c0020009c000003a70000613d0000041d0020009c000003ea0000613d0000041e0020009c00000a850000c13d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b10010e770000040f000000400200043d000800000002001d10010b7f0000040f0000000801000029000004010010009c0000040101008041000000400110021000000456011001c7000010020001042e0000043d0020009c000002d20000a13d0000043e0020009c000004070000613d0000043f0020009c0000040c0000613d000004400020009c00000a850000c13d000000440030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000002402100370000000000202043b000700000002001d0000000401100370000000000301043b0000040e01000041000000000101041a0000000002000411000000000012004b000005ec0000c13d000000000003004b000009020000613d000000000100041a000000000031004b000009020000a13d000600000003001d000800000003001d000000000030043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b0000076a0000c13d0000000803000029000000000003004b000000010330008a000001870000c13d000006190000013d000004220020009c000002e10000a13d000004230020009c000004330000613d000004240020009c000004470000613d000004250020009c00000a850000c13d0000000001000416000000000001004b00000a850000c13d0000000303000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000003860000c13d000000800010043f000000000004004b000006300000613d000000000030043f000000000001004b0000000002000019000006350000613d00000459030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000001bc0000413d000006350000013d000004300020009c000002f40000a13d000004310020009c000004500000613d000004320020009c0000046d0000613d000004330020009c00000a850000c13d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000402100370000000000202043b000004040020009c00000a850000213d0000002304200039000000000034004b00000a850000813d000700040020003d0000000704100360000000000404043b000004040040009c00000a850000213d000000050540021000000000025200190000002402200039000000000032004b00000a850000213d0000000006050019000000800040043f000000a002500039000000400020043f000000000004004b000007070000c13d00000020010000390000000001120436000000800300043d00000000003104350000004001200039000000000003004b0000063d0000613d000000800400003900000000050000190000002004400039000000000604043300000000870604340000040d07700197000000000771043600000000080804330000040408800197000000000087043500000040076000390000000007070433000000000007004b0000000007000039000000010700c03900000040081000390000000000780435000000600660003900000000060604330000045f066001970000006007100039000000000067043500000080011000390000000105500039000000000035004b000001f10000413d0000063d0000013d000004150020009c000003070000a13d000004160020009c000004d20000613d000004170020009c000005010000613d000004180020009c00000a850000c13d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b0000040d0010009c00000a850000213d00000449020000410000000c0020043f000000000010043f0000000c0100003900000020020000390000058f0000013d000004470020009c000005120000613d000004480020009c00000a850000c13d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000201043b000004750020019800000a850000c13d00000001010000390000047602200197000004770020009c000005f50000613d000004780020009c000005f50000613d000004790020009c000000000100c019000000800010043f0000044a01000041000010020001042e0000042c0020009c000005550000613d0000042d0020009c00000a850000c13d0000000001000416000000000001004b00000a850000c13d0000000903000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000003860000c13d000000800010043f000000000004004b000006300000613d000000000030043f000000000001004b0000000002000019000006350000613d0000045c030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000002540000413d000006350000013d0000043a0020009c000005690000613d0000043b0020009c00000a850000c13d000000000103001910010b030000040f000800000001001d000700000002001d000600000003001d000000400100043d000500000001001d000000200200003910010b350000040f0000000504000029000000000004043500000008010000290000000702000029000000060300002910010cbc0000040f0000000001000019000010020001042e0000041f0020009c000005830000613d000004200020009c00000a850000c13d000000640030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000402100370000000000202043b000400000002001d0000040d0020009c00000a850000213d0000004402100370000000000202043b0000002401100370000000000301043b000000000023004b000006b00000813d000000000100041a000000000012004b0000000002018019000300000002001d000000010030008c000000010300a0390000000401000029000000000001004b000006b80000613d000700000003001d000000000010043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000100600000003d000000000101043b0000000703000029000000030230006b00000aa60000a13d000000000101041a000004040110019800000aa60000613d000000000012004b0000000002018019000200000002001d0000000501200210000000400200043d000100000002001d00000000012100190000002001100039000000400010043f000600000001001d000004580010009c000007940000213d00000006020000290000008001200039000000400010043f0000006001200039000000000001043500000040012000390000000000010435000000200120003900000000000104350000000000020435000000000100041a000000000031004b0000000001000019000009060000a13d0000000701000029000800000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b000009a30000c13d0000000801000029000000010110008a000002be0000013d000004410020009c000005940000613d000004420020009c00000a850000c13d0000000001000416000000000001004b00000a850000c13d0000000101000039000000000101041a0000047d01100167000000000200041a0000000001120019000000800010043f0000044a01000041000010020001042e000004260020009c000005d70000613d000004270020009c00000a850000c13d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b000000000010043f0000000a01000039000000200010043f0000004002000039000000000100001910010fe20000040f0000000101100039000005900000013d000004340020009c000005f00000613d000004350020009c00000a850000c13d000000440030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000002402100370000000000202043b000800000002001d0000040d0020009c00000a850000213d0000000401100370000000000101043b000000000010043f0000000b010000390000031b0000013d000004190020009c000005f80000613d0000041a0020009c00000a850000c13d000000440030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000402100370000000000202043b0000040d0020009c00000a850000213d0000002401100370000000000101043b000800000001001d0000040d0010009c00000a850000213d000000000020043f0000000701000039000000200010043f0000004002000039000000000100001910010fe20000040f000000080200002910010b250000040f000000000101041a000000ff001001900000000001000039000000010100c039000003710000013d0000000001000416000000000001004b00000a850000c13d0000000203000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f0000000100500190000003860000c13d000000800010043f000000000004004b000006300000613d000000000030043f000000000001004b0000000002000019000006350000613d0000040a030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b0000033d0000413d000006350000013d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000201043b000000000002004b000006cb0000613d000000000100041a000000000021004b000006cb0000a13d000700000002001d000800000002001d000000000020043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b000006c00000c13d0000000802000029000000000002004b000000010220008a000003520000c13d000006190000013d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b10010edf0000040f0000040d01100197000000400200043d0000000000120435000004010020009c0000040102008041000000400120021000000451011001c7000010020001042e0000000001000416000000000001004b00000a850000c13d0000000903000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000552013f00000001005001900000061f0000613d0000046201000041000000000010043f0000002201000039000000040010043f00000463010000410000100300010430000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b000000000001004b000006460000c13d0000047301000041000000000010043f00000455010000410000100300010430000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b000000000010043f0000000c01000039000000200010043f0000004002000039000000000100001910010fe20000040f0000044b0000013d000000440030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000402100370000000000202043b000800000002001d0000040d0020009c00000a850000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039000700000002001d000000000012004b00000a850000c13d0000000001000411000000000010043f0000000701000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b0000000802000029000000000020043f000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000201041a0000047e022001970000000703000029000000000232019f000000000021041b000000400100043d0000000000310435000004010010009c000004010100804100000040011002100000000002000414000004010020009c0000040102008041000000c002200210000000000112019f0000040c011001c70000800d020000390000000303000039000004570400004100000000050004110000000806000029000004680000013d000000840030008c00000a850000413d0000000402100370000000000202043b000800000002001d0000040d0020009c00000a850000213d0000002402100370000000000202043b000700000002001d0000040d0020009c00000a850000213d0000006402100370000000000402043b000004040040009c00000a850000213d0000002302400039000000000032004b00000a850000813d0000000402400039000000000221034f000000000202043b0000004401100370000000000101043b000600000001001d000000240140003910010b470000040f00000000040100190000026b0000013d000000000103001910010b030000040f10010ba10000040f0000000001000019000010020001042e00000449010000410000000c0010043f0000000001000411000000000010043f0000044e0100004100000000001004430000000001000414000004010010009c0000040101008041000000c0011002100000044f011001c70000800b0200003910010ffc0000040f0000000100200190000008630000613d000000000101043b000800000001001d0000000001000414000004010010009c0000040101008041000000c0011002100000044d011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b00000008020000290000046c0220009a000000000021041b0000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d0200003900000002030000390000046d04000041000004670000013d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b000300000001001d0000040d0010009c00000a850000213d000000000100041a000000000001004b000006b00000613d0002000100100094000006b40000c13d00000080010000390000006002000039000800000001001d10010b920000040f0000063c0000013d0000000001000416000000000001004b00000a850000c13d0000040e01000041000000000101041a0000040d01100197000000800010043f0000044a01000041000010020001042e00000449010000410000000c0010043f0000000001000411000000000010043f0000000001000414000004010010009c0000040101008041000000c0011002100000044d011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000001041b0000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d0200003900000002030000390000046404000041000000000500041110010ff70000040f000000010020019000000a850000613d0000000001000019000010020001042e000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000402100370000000000502043b000004040050009c00000a850000213d0000002302500039000000000032004b00000a850000813d0000000406500039000000000261034f000000000202043b000004040020009c000007940000213d0000001f072000390000047c077001970000003f077000390000047c07700197000004580070009c000007940000213d00000024055000390000008007700039000000400070043f000000800020043f0000000005520019000000000035004b00000a850000213d0000002003600039000000000331034f0000047c052001980000001f0620018f000000a001500039000004970000613d000000a007000039000000000803034f000000008908043c0000000007970436000000000017004b000004930000c13d000000000006004b000004a40000613d000000000353034f0000000305600210000000000601043300000000065601cf000000000656022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000363019f0000000000310435000000a00120003900000000000104350000040e01000041000000000101041a0000000002000411000000000012004b000005ec0000c13d000000800200043d000004040020009c000007940000213d0000000901000039000000000501041a000000010050019000000001035002700000007f0330618f0000001f0030008c00000000060000390000000106002039000000000565013f0000000100500190000003860000c13d000000200030008c000004ca0000413d000000000010043f0000001f052000390000000505500270000004600550009a000000200020008c0000045c050040410000001f033000390000000503300270000004600330009a000000000035004b000004ca0000813d000000000005041b0000000105500039000000000035004b000004c60000413d0000001f0020008c000009d40000a13d000000000010043f0000047c0420019800000a870000c13d000000a0050000390000045c0300004100000a950000013d000000240030008c00000a850000413d0000000401100370000000000101043b000800000001001d0000040d0010009c00000a850000213d0000040e01000041000000000101041a0000000002000411000000000012004b000005ec0000c13d00000449010000410000000c0010043f0000000801000029000000000010043f0000000001000414000004010010009c0000040101008041000000c0011002100000044d011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000600000001001d000000000101041a000700000001001d0000044e0100004100000000001004430000000001000414000004010010009c0000040101008041000000c0011002100000044f011001c70000800b0200003910010ffc0000040f0000000100200190000008630000613d000000000101043b000000070010006c000007d90000a13d0000045001000041000000000010043f0000044c010000410000100300010430000000240030008c00000a850000413d0000000401100370000000000101043b0000040d0010009c00000a850000213d0000040e02000041000000000202041a0000000003000411000000000023004b000005ec0000c13d000000000001004b000007dc0000c13d0000044b01000041000000000010043f0000044c010000410000100300010430000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b000700000001001d000000000010043f0000000b01000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b00000000020004110000040d02200197000600000002001d000000000020043f000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000ff00100190000006bc0000c13d0000000702000029000000000002004b000009020000613d000000000100041a000000000021004b000009020000a13d000800000002001d000000000020043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b000008cf0000c13d0000000802000029000000000002004b000000010220008a0000053f0000c13d000006190000013d000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b000000000010043f0000000a01000039000000200010043f0000004002000039000000000100001910010fe20000040f0000000102100039000000000202041a000000000101041a000000800010043f000000a00020043f0000045d01000041000010020001042e000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b000800000001001d10010ed50000040f0000000801000029000000000010043f0000000c01000039000000200010043f0000004002000039000000000100001910010fe20000040f00000000020004110000040d02200197000000000301041a0000046503300197000000000223019f000000000021041b000000080100002910010f130000040f0000000001000019000010020001042e000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000101043b000000000010043f0000000a01000039000000200010043f0000004002000039000000000100001910010fe20000040f000000000101041a000000800010043f0000044a01000041000010020001042e0000000001000416000000000001004b00000a850000c13d0000040e01000041000000000101041a0000000002000411000000000012004b000005ec0000c13d000000000100041a000800000001001d0000044e0100004100000000001004430000000001000414000004010010009c0000040101008041000000c0011002100000044f011001c70000800b0200003910010ffc0000040f0000000100200190000008630000613d000000000101043b000700000001001d0000000801000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d00000000020004110000040d022001970000000703000029000000a003300210000000000323019f0000046a033001c7000000000101043b000000000031041b000000000020043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000201041a0000046f0220009a000000000021041b0000000001000411000000000001004b000007df0000c13d0000047001000041000000000010043f000004550100004100001003000104300000040e01000041000000000101041a0000000005000411000000000015004b000005ec0000c13d0000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d0200003900000003030000390000041004000041000000000600001910010ff70000040f000000010020019000000a850000613d0000040e01000041000000000001041b0000000001000019000010020001042e0000046e01000041000000000010043f0000044c0100004100001003000104300000000001000416000000000001004b00000a850000c13d0000000d01000039000000000101041a000000800010043f0000044a01000041000010020001042e000000240030008c00000a850000413d0000000002000416000000000002004b00000a850000c13d0000000401100370000000000201043b000000000002004b000006e40000613d000000000100041a000000000021004b000006e40000a13d000800000002001d000000000020043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b000006cf0000c13d0000000802000029000000000002004b000000010220008a000006040000c13d0000046201000041000000000010043f0000001101000039000000040010043f00000463010000410000100300010430000000800010043f000000000004004b000006300000613d000000000030043f000000000001004b0000000002000019000006350000613d0000045c030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000006280000413d000006350000013d0000047e02200197000000a00020043f000000000001004b000000200200003900000000020060390000002002200039000000800100003910010b350000040f000000400100043d000800000001001d000000800200003910010aee0000040f00000008020000290000000001210049000004010010009c00000401010080410000006001100210000004010020009c00000401020080410000004002200210000000000121019f000010020001042e000700000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000201041a000000000002004b0000066f0000c13d000000000100041a0000000702000029000000000021004b000003950000a13d0000000001020019000000010110008a000800000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000201041a000000000002004b00000008010000290000065c0000613d00000453002001980000000701000029000003950000c13d000800000002001d000000000010043f0000000601000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d00000008020000290000040d02200197000000000101043b000600000001001d000000000301041a00000000010004110000040d01100197000000000021004b000500000002001d000007f20000613d000000000031004b000007f20000613d000400000001001d000300000003001d000000000020043f0000000701000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b0000000402000029000000000020043f000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000ff0010019000000005020000290000000303000029000007f20000c13d0000046701000041000000000010043f000004550100004100001003000104300000045a01000041000000000010043f00000455010000410000100300010430000100000001001d0000000301000029000000000001004b000006e80000c13d0000045b01000041000000000010043f000004550100004100001003000104300000047a01000041000000000010043f0000045501000041000010030001043000000453001001980000000701000029000006cb0000c13d000000000010043f0000000601000039000000200010043f0000004002000039000000000100001910010fe20000040f000000000101041a000003700000013d0000047401000041000000000010043f000004550100004100001003000104300000045300100198000006e40000c13d000000400100043d000800000001001d000000200200003910010b350000040f00000008010000290000000000010435000000400100043d000700000001001d000000200200003910010b350000040f00000007030000290000000000030435000000400200043d000800000002001d00000020010000390000000002120436000000000103001910010adc0000040f0000063c0000013d0000045401000041000000000010043f00000455010000410000100300010430000000000010043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000400300043d000000000101043b000000000101041a0000040401100198000008640000c13d00000000010300190000006002000039000004440000013d000000000003004b0000000002000019000007900000613d00000003023002100000047d0220027f0000047d022001670000000004040433000000000224016f0000000103300210000000000232019f000007900000013d0000045e0040009c000007940000213d0000000703600029000000000331034f000000000403043b0000008003200039000000400030043f0000006003200039000000000003043500000040032000390000000000030435000000200320003900000000000304350000000000020435000000000004004b0000075f0000613d000000000300041a000000000043004b0000075f0000a13d000600000006001d000800000004001d000000000040043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b0000072f0000c13d0000000804000029000000010440008a0000071b0000013d000000400100043d000004580010009c0000000803000029000007940000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000030043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000400200043d000004580020009c0000000606000029000007940000213d000000000301034f0000000001000367000000000303043b000000000303041a0000008004200039000000400040043f0000006004200039000000e805300270000000000054043500000453003001980000000004000039000000010400c039000000400520003900000000004504350000040d043001970000000004420436000000a00330027000000404033001970000000000340435000000200460008c00000080036000390000000000230435000000400200043d000001e80000613d0000000703400029000000000331034f000004580020009c00000000060400190000070b0000a13d000007940000013d00000453001001980000000601000029000009020000c13d000000000010043f0000000a01000039000000200010043f0000004002000039000000000100001910010fe20000040f00000001011000390000000702000029000000000021041b0000000001000019000010020001042e0000040a040000410000002005000039000000010760008a00000005077002700000040b0770009a00000000082500190000000008080433000000000084041b00000020055000390000000104400039000000000074004b0000077d0000c13d000000000036004b0000078e0000813d0000000306300210000000f80660018f0000047d0660027f0000047d0660016700000000022500190000000002020433000000000262016f000000000024041b000000010230021000000001022001bf000000000021041b0000000004090433000004040040009c0000079a0000a13d0000046201000041000000000010043f0000004101000039000000040010043f000004630100004100001003000104300000000303000039000000000103041a000000010010019000000001051002700000007f0550618f0000001f0050008c00000000020000390000000102002039000000000121013f0000000100100190000003860000c13d00040000000a001d000300000009001d000500000005001d000000200050008c000600000004001d000007c70000413d000000000030043f0000000001000414000004010010009c0000040101008041000000c0011002100000040c011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d00000006040000290000001f024000390000000502200270000000200040008c0000000002004019000000000301043b00000005010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b0000000303000039000007c70000813d000000000002041b0000000102200039000000000012004b000007c30000413d000000200040008c000008c20000413d000000000030043f0000000001000414000004010010009c0000040101008041000000c0011002100000040c011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000200200008a0000000602200180000000000101043b000009e10000c13d0000002003000039000009ee0000013d0000000601000029000000000001041b000000080100002910010fcb0000040f0000000001000019000010020001042e00000000010000190000000100100190000008b60000c13d0000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d0200003900000004030000390000046b0400004100000000050000190000000006000411000000080700002910010ff70000040f00000001002001900000000101000039000007e00000c13d00000a850000013d000000000003004b000007f60000613d0000000601000029000000000001041b000000000020043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000201041a000004680220009a000000000021041b0000044e0100004100000000001004430000000001000414000004010010009c0000040101008041000000c0011002100000044f011001c70000800b0200003910010ffc0000040f0000000100200190000008630000613d000000000101043b000600000001001d0000000701000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d0000000602000029000000a00220021000000005022001af00000469022001c7000000000101043b000000000021041b00000008010000290000046a001001980000084f0000c13d00000007010000290000000101100039000600000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b0000084f0000c13d000000000100041a000000060010006b0000084f0000613d0000000601000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b0000000802000029000000000021041b0000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d0200003900000004030000390000046b0400004100000005050000290000000006000019000000070700002910010ff70000040f000000010020019000000a850000613d0000000101000039000000000201041a0000000102200039000000000021041b0000000001000019000010020001042e000000000001042f000000020010006b00000000020100190000000202004029000200000002001d0000000501200210000500000003001d00000000011300190000002001100039000000400010043f000600000001001d000004580010009c000007940000213d00000006020000290000008001200039000000400010043f0000006001200039000000000001043500000040012000390000000000010435000000200120003900000000000104350000000000020435000000000100041a000000020010008c0000000001000019000009530000413d0000000101000039000800000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000000001004b00000a540000c13d0000000801000029000000010110008a0000087f0000013d0000000801000029000000000010043f0000000701000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b00000000020004110000040d02200197000000000020043f000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000101041a000000ff00100190000000540000c13d0000047101000041000000000010043f0000045501000041000010030001043000000008020000290000000101200039000000000010041b0000000101000039000000000101041a000000000112004910010b150000040f0000000101100039000000c802000039000000000021041b0000000001000019000010020001042e000000060000006b0000000001000019000009fc0000613d000000060300002900000003013002100000047d0110027f0000047d0110016700000004020000290000000002020433000000000112016f0000000102300210000000000121019f000009fc0000013d00000453001001980000000701000029000009020000c13d000000000010043f0000000b01000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b0000000602000029000000000020043f000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000201041a0000047e0220019700000001022001bf000000000021041b0000000701000029000000000010043f0000000a01000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000000101043b000000000201041a000000010220003a000006190000613d00000aa00000013d0000047b01000041000000000010043f00000455010000410000100300010430000800000001001d000500000000001d00000000010000190000000705000029000009100000013d000800000000001d0000000601000029000000400010043f000000010550003900000001010000390000000100100190000009170000613d000000030050006c00000aa30000613d0000000502000029000000020020006c00000aa30000613d000000400100043d000004580010009c000007940000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000700000005001d000000000050043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000400200043d000004580020009c0000000705000029000007940000213d000000000101043b000000000101041a0000006003200039000000e8041002700000000000430435000000400320003900000453001001980000000004000039000000010400c0390000000000430435000000a0031002700000040403300197000000200420003900000000003404350000040d0110019700000000001204350000090b0000c13d000000000001004b00000000020100190000000802006029000800000002001d000000040120014f0000040d001001980000090c0000c13d00000005010000290000000101100039000500000001001d0000000501100210000000010110002900000000005104350000090c0000013d000700000001001d0000000105000039000400000000001d000000000100001900000005020000290000095f0000013d000700000000001d00000005020000290000000601000029000000400010043f000000010550003900000001010000390000000100100190000009660000613d000000010050006c00000ab60000613d0000000403000029000000020030006c00000ab60000613d000000400100043d000004580010009c000007940000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000800000005001d000000000050043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000400200043d000004580020009c0000000805000029000007940000213d000000000101043b000000000101041a0000006003200039000000e8041002700000000000430435000000400320003900000453001001980000000004000039000000010400c0390000000000430435000000a0031002700000040403300197000000200420003900000000003404350000040d011001970000000000120435000009590000c13d000000000001004b00000000020100190000000702006029000700000002001d000000030120014f0000040d0010019800000005020000290000095b0000c13d00000004010000290000000101100039000400000001001d0000000501100210000000000121001900000000005104350000095b0000013d000000400100043d000004580010009c000007940000213d0000008002100039000000400020043f00000060021000390000000000020435000000400210003900000000000204350000002002100039000000000002043500000000000104350000000801000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000400200043d000004580020009c000007940000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e8041002700000000000430435000000400320003900000453001001980000000004000039000000010400c0390000000000430435000000a0031002700000040403300197000000200420003900000000003404350000040d011001970000000000120435000800000000001d000800000001601d000009070000013d000000000002004b0000000003000019000009d80000613d000000a00300043d00000003042002100000047d0440027f0000047d04400167000000000443016f0000000103200210000000000234019f000000000021041b0000000001000019000010020001042e000000010320008a0000000503300270000000000431001900000020030000390000000104400039000000030600002900000000056300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b000009e70000c13d000000060020006c000009f90000813d00000006020000290000000302200210000000f80220018f0000047d0220027f0000047d0220016700000003033000290000000003030433000000000223016f000000000021041b0000000601000029000000010110021000000001011001bf0000000303000039000000000013041b0000000101000039000600000001001d000000000010041b00000000010004110000040d061001970000040e01000041000000000061041b0000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d020000390000041004000041000000000500001910010ff70000040f000000010020019000000a850000613d00000008010000290000000001010433000500000001001d000004040010009c000007940000213d0000000901000039000000000101041a000000010010019000000001021002700000007f0220618f000400000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000003860000c13d0000000401000029000000200010008c00000a400000413d0000000901000039000000000010043f0000000001000414000004010010009c0000040101008041000000c0011002100000040c011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d00000005030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000004010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b00000a400000813d000000000002041b0000000102200039000000000012004b00000a3c0000413d0000000501000029000000200010008c00000aaa0000413d0000000901000039000000000010043f0000000001000414000004010010009c0000040101008041000000c0011002100000040c011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000200200008a0000000502200180000000000101043b00000aba0000c13d000000200300003900000ac70000013d000000400100043d000004580010009c000007940000213d0000008002100039000000400020043f00000060021000390000000000020435000000400210003900000000000204350000002002100039000000000002043500000000000104350000000801000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000a850000613d000000400200043d000004580020009c000007940000213d000000000101043b000000000101041a0000008003200039000000400030043f0000006003200039000000e8041002700000000000430435000000400320003900000453001001980000000004000039000000010400c0390000000000430435000000a0031002700000040403300197000000200420003900000000003404350000040d011001970000000000120435000700000000001d000700000001601d000009540000013d000000000100001900001003000104300000045c030000410000002006000039000000010540008a0000000505500270000004610550009a000000000706001900000080066000390000000006060433000000000063041b00000020067000390000000103300039000000000053004b00000a8c0000c13d000000a005700039000000000024004b00000a9e0000813d0000000304200210000000f80440018f0000047d0440027f0000047d044001670000000005050433000000000445016f000000000043041b000000010420021000000001024001bf000000000021041b0000000001000019000010020001042e000000010100002900000005020000290000000000210435000000400100043d000800000001001d0000000102000029000004450000013d000000050000006b000000000100001900000ad50000613d000000050300002900000003013002100000047d0110027f0000047d0110016700000007020000290000000002020433000000000112016f000600010030021800000ad40000013d00000004010000290000000000120435000000400100043d000004440000013d000000010320008a0000000503300270000000000431001900000020030000390000000104400039000000080600002900000000056300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b00000ac00000c13d000000050020006c00000ad20000813d00000005020000290000000302200210000000f80220018f0000047d0220027f0000047d0220016700000008033000290000000003030433000000000223016f000000000021041b0000000501000029000000010110021000000006011001af0000000902000039000000000012041b0000002001000039000001000010044300000120000004430000041101000041000010020001042e00000000430104340000000001320436000000000003004b00000ae80000613d000000000200001900000000051200190000000006240019000000000606043300000000006504350000002002200039000000000032004b00000ae10000413d000000000213001900000000000204350000001f023000390000047c022001970000000001210019000000000001042d00000020030000390000000004310436000000003202043400000000002404350000004001100039000000000002004b00000afd0000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b00000af60000413d000000000312001900000000000304350000001f022000390000047c022001970000000001120019000000000001042d0000047f0010009c00000b130000213d000000630010008c00000b130000a13d00000000030003670000000401300370000000000101043b0000040d0010009c00000b130000213d0000002402300370000000000202043b0000040d0020009c00000b130000213d0000004403300370000000000303043b000000000001042d00000000010000190000100300010430000000000010043f0000000a01000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000b230000613d000000000101043b000000000001042d000000000100001900001003000104300000040d02200197000000000020043f000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000b330000613d000000000101043b000000000001042d000000000100001900001003000104300000001f022000390000047c022001970000000001120019000000000021004b00000000020000390000000102004039000004040010009c00000b410000213d000000010020019000000b410000c13d000000400010043f000000000001042d0000046201000041000000000010043f0000004101000039000000040010043f00000463010000410000100300010430000004800020009c00000b770000813d00000000040100190000001f012000390000047c011001970000003f011000390000047c05100197000000400100043d0000000005510019000000000015004b00000000070000390000000107004039000004040050009c00000b770000213d000000010070019000000b770000c13d000000400050043f00000000052104360000000007420019000000000037004b00000b7d0000213d0000047c062001980000001f0720018f0000000004400367000000000365001900000b670000613d000000000804034f0000000009050019000000008a08043c0000000009a90436000000000039004b00000b630000c13d000000000007004b00000b740000613d000000000464034f0000000306700210000000000703043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000043043500000000022500190000000000020435000000000001042d0000046201000041000000000010043f0000004101000039000000040010043f000004630100004100001003000104300000000001000019000010030001043000000000430104340000040d03300197000000000332043600000000040404330000040404400197000000000043043500000040031000390000000003030433000000000003004b0000000003000039000000010300c039000000400420003900000000003404350000006002200039000000600110003900000000010104330000045f011001970000000000120435000000000001042d00000020030000390000000004310436000000000302043300000000003404350000004001100039000000000003004b00000ba00000613d00000000040000190000002002200039000000000502043300000000015104360000000104400039000000000034004b00000b9a0000413d000000000001042d0007000000000002000300000002001d000500000001001d000600000003001d000000000003004b00000c930000613d0000000601000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d000000000101043b000000000101041a000000000001004b00000bcf0000c13d000000000100041a000000060010006c00000c930000a13d0000000602000029000000010220008a000700000002001d000000000020043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d000000000101043b000000000101041a000000000001004b000000070200002900000bbc0000613d000004530010019800000c930000c13d00000005020000290000040d02200197000400000001001d0000040d01100197000700000002001d000000000021004b00000c970000c13d0000000601000029000000000010043f0000000601000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d000000000201043b000000000302041a00000000010004110000040d04100197000000070040006c00000c100000613d000000000034004b00000c100000613d000500000004001d000100000003001d000200000002001d0000000701000029000000000010043f0000000701000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d000000000101043b0000000502000029000000000020043f000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d000000000101043b000000000101041a000000ff001001900000000202000029000000010300002900000ca00000613d000000000003004b00000c130000613d000000000002041b0000000701000029000000000010043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d000000000101043b000000000201041a000000010220008a000000000021041b00000003010000290000040d01100197000500000001001d000000000010043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d000000000101043b000000000201041a0000000102200039000000000021041b0000044e0100004100000000001004430000000001000414000004010010009c0000040101008041000000c0011002100000044f011001c70000800b0200003910010ffc0000040f000000010020019000000c9b0000613d000000000101043b000300000001001d0000000601000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d0000000302000029000000a00220021000000005022001af0000046a022001c7000000000101043b000000000021041b00000004010000290000046a0010019800000c800000c13d00000006010000290000000101100039000300000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d000000000101043b000000000101041a000000000001004b00000c800000c13d000000000100041a000000030010006b00000c800000613d0000000301000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000c910000613d000000000101043b0000000402000029000000000021041b0000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d0200003900000004030000390000046b0400004100000007050000290000000506000029000000060700002910010ff70000040f000000010020019000000c910000613d000000050000006b00000c9c0000613d000000000001042d000000000100001900001003000104300000047301000041000000000010043f000004550100004100001003000104300000048101000041000000000010043f00000455010000410000100300010430000000000001042f0000048201000041000000000010043f000004550100004100001003000104300000046701000041000000000010043f000004550100004100001003000104300000040d0110019800000cb60000613d000000000010043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000cba0000613d000000000101043b000000000101041a0000040401100197000000000001042d0000045b01000041000000000010043f00000455010000410000100300010430000000000100001900001003000104300008000000000002000100000004001d000500000002001d000600000001001d000700000003001d000000000003004b00000e250000613d0000000701000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d000000000101043b000000000101041a000000000001004b00000ceb0000c13d000000000100041a000000070010006c00000e250000a13d0000000702000029000000010220008a000800000002001d000000000020043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d000000000101043b000000000101041a000000000001004b000000080200002900000cd80000613d000004530010019800000e250000c13d00000006020000290000040d02200197000300000001001d0000040d01100197000800000002001d000000000021004b00000e2a0000c13d0000000701000029000000000010043f0000000601000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d000000000301043b000000000403041a00000000010004110000040d02100197000400000002001d000000080020006c00000d2c0000613d000000040040006b00000d2c0000613d000200000004001d000600000003001d0000000801000029000000000010043f0000000701000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d000000000101043b0000000402000029000000000020043f000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d000000000101043b000000000101041a000000ff001001900000000603000029000000020400002900000e360000613d000000000004004b00000d2f0000613d000000000003041b0000000801000029000000000010043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d000000000101043b000000000201041a000000010220008a000000000021041b00000005010000290000040d01100197000600000001001d000000000010043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d000000000101043b000000000201041a0000000102200039000000000021041b0000044e0100004100000000001004430000000001000414000004010010009c0000040101008041000000c0011002100000044f011001c70000800b0200003910010ffc0000040f000000010020019000000e290000613d000000000101043b000200000001001d0000000701000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d0000000202000029000000a00220021000000006022001af0000046a022001c7000000000101043b000000000021041b00000003010000290000046a0010019800000d9c0000c13d00000007010000290000000101100039000200000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d000000000101043b000000000101041a000000000001004b00000d9c0000c13d000000000100041a000000020010006b00000d9c0000613d0000000201000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000e230000613d000000000101043b0000000302000029000000000021041b0000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d0200003900000004030000390000046b0400004100000008050000290000000606000029000000070700002910010ff70000040f000000010020019000000e230000613d000000060000006b00000e2e0000613d00000483010000410000000000100443000000050100002900000004001004430000000001000414000004010010009c0000040101008041000000c00110021000000484011001c7000080020200003910010ffc0000040f000000010020019000000e290000613d000000000101043b000000000001004b00000e220000613d000000400700043d00000064017000390000008002000039000500000002001d0000000000210435000000440170003900000007020000290000000000210435000000240170003900000008020000290000000000210435000004850100004100000000001704350000000401700039000000040200002900000000002104350000008402700039000000010100002900000000310104340000000000120435000000a402700039000000000001004b00000ddb0000613d000000000400001900000000052400190000000006430019000000000606043300000000006504350000002004400039000000000014004b00000dd40000413d0000001f031000390000047c0330019700000000012100190000000000010435000000a401300039000004010010009c00000401010080410000006001100210000004010070009c000004010200004100000000020740190000004002200210000000000121019f0000000002000414000004010020009c0000040102008041000000c002200210000000000112019f0000000602000029000800000007001d10010ff70000040f000000080b00002900000060031002700000040103300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900000e000000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00000dfc0000c13d000000000006004b00000e0d0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000010020019000000e320000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000004040010009c00000e680000213d000000010020019000000e680000c13d000000400010043f000000200030008c00000e230000413d00000000010b0433000004750010019800000e230000c13d0000047601100197000004850010009c00000e640000c13d000000000001042d000000000100001900001003000104300000047301000041000000000010043f00000455010000410000100300010430000000000001042f0000048101000041000000000010043f000004550100004100001003000104300000048201000041000000000010043f00000455010000410000100300010430000000000003004b00000e3a0000c13d000000600200003900000e610000013d0000046701000041000000000010043f000004550100004100001003000104300000001f0230003900000402022001970000003f022000390000048604200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000004040040009c00000e680000213d000000010050019000000e680000c13d000000400040043f0000001f0430018f00000000063204360000040305300198000500000006001d000000000356001900000e540000613d000000000601034f0000000507000029000000006806043c0000000007870436000000000037004b00000e500000c13d000000000004004b00000e610000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b00000e6e0000c13d0000048701000041000000000010043f000004550100004100001003000104300000046201000041000000000010043f0000004101000039000000040010043f000004630100004100001003000104300000000502000029000004010020009c00000401020080410000004002200210000004010010009c00000401010080410000006001100210000000000121019f000010030001043000010000000000020000000003010019000000400100043d000004880010009c00000ecf0000813d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000003004b00000ecc0000613d000000000200041a000000000032004b00000ecc0000a13d000100000003001d000000000030043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000ecd0000613d000000000101043b000000000101041a000000000001004b00000e9e0000c13d0000000103000029000000010330008a00000e8a0000013d000000400100043d000004580010009c000000010300002900000ecf0000213d0000008002100039000000400020043f0000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000030043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000ecd0000613d000000000301034f000000400100043d000004580010009c00000ecf0000213d000000000203043b000000000202041a0000008003100039000000400030043f0000006003100039000000e804200270000000000043043500000453002001980000000003000039000000010300c039000000400410003900000000003404350000040d032001970000000003310436000000a00220027000000404022001970000000000230435000000000001042d000000000100001900001003000104300000046201000041000000000010043f0000004101000039000000040010043f000004630100004100001003000104300000040e01000041000000000101041a0000000002000411000000000012004b00000edb0000c13d000000000001042d0000046e01000041000000000010043f0000044c0100004100001003000104300001000000000002000000000001004b00000f0f0000613d000100000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000f0d0000613d000000000101043b000000000101041a000000000001004b00000f0a0000c13d000000000100041a0000000102000029000000000021004b00000f0f0000a13d000000010220008a000100000002001d000000000020043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000f0d0000613d000000000101043b000000000101041a000000000001004b000000010200002900000ef70000613d000004530010019800000f0f0000c13d000000000001042d000000000100001900001003000104300000047301000041000000000010043f000004550100004100001003000104300004000000000002000000000001004b00000fc60000613d000300000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000fc40000613d000000000101043b000000000101041a000000000001004b00000f3e0000c13d000000000100041a0000000302000029000000000021004b00000fc60000a13d000000010220008a000400000002001d000000000020043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000fc40000613d000000000101043b000000000101041a000000000001004b000000040200002900000f2b0000613d000400000001001d0000045300100198000000030100002900000fc60000c13d000000000010043f0000000601000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000fc40000613d00000004020000290000040d03200197000000000101043b000000000201041a000000000002004b00000f550000613d000000000001041b000200000003001d000000000030043f0000000501000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000fc40000613d000000000101043b000000000201041a000004680220009a000000000021041b0000044e0100004100000000001004430000000001000414000004010010009c0000040101008041000000c0011002100000044f011001c70000800b0200003910010ffc0000040f000000010020019000000fca0000613d000000000101043b000100000001001d0000000301000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000fc40000613d0000000102000029000000a0022002100000000205000029000000000225019f00000469022001c7000000000101043b000000000021041b00000004010000290000046a0010019800000fb20000c13d00000003010000290000000101100039000100000001001d000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000fc40000613d000000000101043b000000000101041a000000000001004b000000020500002900000fb20000c13d000000000100041a000000010010006b00000fb20000613d0000000101000029000000000010043f0000000401000039000000200010043f0000000001000414000004010010009c0000040101008041000000c00110021000000452011001c7000080100200003910010ffc0000040f000000010020019000000fc40000613d000000000101043b0000000402000029000000000021041b00000002050000290000000001000414000004010010009c0000040101008041000000c0011002100000040f011001c70000800d0200003900000004030000390000046b040000410000000006000019000000030700002910010ff70000040f000000010020019000000fc40000613d0000000101000039000000000201041a0000000102200039000000000021041b000000000001042d000000000100001900001003000104300000047301000041000000000010043f00000455010000410000100300010430000000000001042f00010000000000020000040e02000041000000000502041a00000000020004140000040d06100197000004010020009c0000040102008041000000c0012002100000040f011001c70000800d0200003900000003030000390000041004000041000100000006001d10010ff70000040f000000010020019000000fdf0000613d0000040e010000410000000102000029000000000021041b000000000001042d00000000010000190000100300010430000000000001042f000004010010009c00000401010080410000004001100210000004010020009c00000401020080410000006002200210000000000112019f0000000002000414000004010020009c0000040102008041000000c002200210000000000112019f0000040f011001c7000080100200003910010ffc0000040f000000010020019000000ff50000613d000000000101043b000000000001042d0000000001000019000010030001043000000ffa002104210000000102000039000000000001042d0000000002000019000000000001042d00000fff002104230000000102000039000000000001042d0000000002000019000000000001042d0000100100000432000010020001042e000010030001043000000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000000000000000000000000000ffffffffffffffff8000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffbf4265617269736820486f6e6f72617269657300000000000000000000000000004245415249534800000000000000000000000000000000000000000000000000bfa87805ed57dc1f0d489ce33be4c4577d74ccde357eeeee058a32c55c44a532405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5acebfa87805ed57dc1f0d489ce33be4c4577d74ccde357eeeee058a32c55c44a5310200000000000000000000000000000000000020000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff7487392702000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e00000000200000000000000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000005df8132f0000000000000000000000000000000000000000000000000000000097087ce500000000000000000000000000000000000000000000000000000000c87b56dc00000000000000000000000000000000000000000000000000000000f04e283d00000000000000000000000000000000000000000000000000000000f04e283e00000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000fee81cf400000000000000000000000000000000000000000000000000000000c87b56dd00000000000000000000000000000000000000000000000000000000e985e9c500000000000000000000000000000000000000000000000000000000a22cb46400000000000000000000000000000000000000000000000000000000a22cb46500000000000000000000000000000000000000000000000000000000b88d4fde00000000000000000000000000000000000000000000000000000000c23dc68f0000000000000000000000000000000000000000000000000000000097087ce60000000000000000000000000000000000000000000000000000000099a2557a00000000000000000000000000000000000000000000000000000000715018a5000000000000000000000000000000000000000000000000000000008462151b000000000000000000000000000000000000000000000000000000008462151c000000000000000000000000000000000000000000000000000000008da5cb5b0000000000000000000000000000000000000000000000000000000095d89b4100000000000000000000000000000000000000000000000000000000715018a6000000000000000000000000000000000000000000000000000000007a16f3f2000000000000000000000000000000000000000000000000000000006352211d000000000000000000000000000000000000000000000000000000006352211e000000000000000000000000000000000000000000000000000000006c0360eb0000000000000000000000000000000000000000000000000000000070a08231000000000000000000000000000000000000000000000000000000005df813300000000000000000000000000000000000000000000000000000000061795d6a0000000000000000000000000000000000000000000000000000000031c10da2000000000000000000000000000000000000000000000000000000004f6d38cf0000000000000000000000000000000000000000000000000000000054d1f13c0000000000000000000000000000000000000000000000000000000054d1f13d0000000000000000000000000000000000000000000000000000000055f804b3000000000000000000000000000000000000000000000000000000005bbb2177000000000000000000000000000000000000000000000000000000004f6d38d0000000000000000000000000000000000000000000000000000000005277b4ae0000000000000000000000000000000000000000000000000000000042966c670000000000000000000000000000000000000000000000000000000042966c680000000000000000000000000000000000000000000000000000000043470a89000000000000000000000000000000000000000000000000000000004cee79e40000000000000000000000000000000000000000000000000000000031c10da30000000000000000000000000000000000000000000000000000000042842e0e000000000000000000000000000000000000000000000000000000001249c58a0000000000000000000000000000000000000000000000000000000023b872dc0000000000000000000000000000000000000000000000000000000023b872dd000000000000000000000000000000000000000000000000000000002569296200000000000000000000000000000000000000000000000000000000287d50c5000000000000000000000000000000000000000000000000000000001249c58b0000000000000000000000000000000000000000000000000000000018160ddd0000000000000000000000000000000000000000000000000000000006fdde020000000000000000000000000000000000000000000000000000000006fdde0300000000000000000000000000000000000000000000000000000000081812fc00000000000000000000000000000000000000000000000000000000095ea7b3000000000000000000000000000000000000000000000000000000000121b93f0000000000000000000000000000000000000000000000000000000001ffc9a700000000000000000000000000000000000000000000000000000000389a75e10000000000000000000000000000000000000020000000800000000000000000000000000000000000000000000000000000000000000000000000007448fbae00000000000000000000000000000000000000040000001c000000000000000002000000000000000000000000000000000000200000000c0000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d955391320200000200000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000006f5e8818000000000000000000000000000000000000002000000000000000000000000002000000000000000000000000000000000000400000000000000000000000000000000100000000000000000000000000000000000000000000000000000000a14c4b50000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000008000000000000000000000000017307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31000000000000000000000000000000000000000000000000ffffffffffffff7fc2575a0e9e593c00f959f8c92f12db2869c3395a3b0502d05e2516446f71f85b32c1995a000000000000000000000000000000000000000000000000000000008f4eb604000000000000000000000000000000000000000000000000000000006e1540171b6c0c960b71a7020d9f60077f6af931a8bbf590da0223dacf75c7af000000000000000000000000000000000000004000000080000000000000000000000000000000000000000000000000000000000000000007fffffffffffff60000000000000000000000000000000000000000000000000000000000ffffff91eabfe8e493f369f48e58fdf2609ff8809506ce57440a6f25fddc25308a385191eabfe8e493f369f48e58fdf2609ff8809506ce57440a6f25fddc25308a38504e487b71000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000024000000000000000000000000fa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92ffffffffffffffffffffffff00000000000000000000000000000000000000000b7b8dc60000000000000000000000000000000000000000000000000000000059c896be00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff0000000000000000000000000000000100000003000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffd5d00dbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d0000000000000000000000000000000000000000000000000000000082b42900fffffffffffffffffffffffffffffffffffffffffffffffeffffffffffffffff2e07630000000000000000000000000000000000000000000000000000000000cfb3b942000000000000000000000000000000000000000000000000000000008c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925df2d9b4200000000000000000000000000000000000000000000000000000000cf4700e40000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000005b5e139f0000000000000000000000000000000000000000000000000000000080ac58cd000000000000000000000000000000000000000000000000000000007c9a1cf900000000000000000000000000000000000000000000000000000000ceea21b600000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000010000000000000000a114810000000000000000000000000000000000000000000000000000000000ea553b34000000000000000000000000000000000000000000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000150b7a020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003ffffffe0d1a57ed600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff80000000000000000000000000000000000000000000000000000000000000000019294e343ebf9c508e5057f3b2ea227c3bc441294c1f750331ffe25f28987d61
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002b68747470733a2f2f626561726973682e61662f6170692f6d657461646174612f686f6e6f7261726965732f000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : baseURI_ (string): https://bearish.af/api/metadata/honoraries/
-----Encoded View---------------
4 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000020
Arg [1] : 000000000000000000000000000000000000000000000000000000000000002b
Arg [2] : 68747470733a2f2f626561726973682e61662f6170692f6d657461646174612f
Arg [3] : 686f6e6f7261726965732f000000000000000000000000000000000000000000
[ 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.