Feature Tip: Add private address tag to any address under My Name Tag !
Source Code
More Info
Private Name Tags
ContractCreator
TokenTracker
Latest 25 from a total of 876 transactions
| Transaction Hash |
Method
|
Block
|
From
|
|
To
|
||||
|---|---|---|---|---|---|---|---|---|---|
| Set Approval For... | 24493553 | 13 days ago | IN | 0 ETH | 0.00000304 | ||||
| Set Approval For... | 24492607 | 14 days ago | IN | 0 ETH | 0.0000146 | ||||
| Set Approval For... | 23056028 | 214 days ago | IN | 0 ETH | 0.00009137 | ||||
| Set Approval For... | 22247770 | 328 days ago | IN | 0 ETH | 0.00007153 | ||||
| Set Approval For... | 22239078 | 329 days ago | IN | 0 ETH | 0.00059102 | ||||
| Set Approval For... | 22185149 | 336 days ago | IN | 0 ETH | 0.00002774 | ||||
| Set Approval For... | 22184440 | 336 days ago | IN | 0 ETH | 0.00009999 | ||||
| Set Approval For... | 22113480 | 346 days ago | IN | 0 ETH | 0.0000706 | ||||
| Set Approval For... | 22106587 | 347 days ago | IN | 0 ETH | 0.00005564 | ||||
| Set Approval For... | 21924691 | 373 days ago | IN | 0 ETH | 0.00027257 | ||||
| Set Approval For... | 21893386 | 377 days ago | IN | 0 ETH | 0.00007685 | ||||
| Set Approval For... | 21852664 | 383 days ago | IN | 0 ETH | 0.0000766 | ||||
| Set Approval For... | 21839780 | 384 days ago | IN | 0 ETH | 0.00008629 | ||||
| Set Approval For... | 21839695 | 385 days ago | IN | 0 ETH | 0.00012066 | ||||
| Set Approval For... | 21725530 | 400 days ago | IN | 0 ETH | 0.00057986 | ||||
| Transfer From | 21355459 | 452 days ago | IN | 0 ETH | 0.00057263 | ||||
| Transfer From | 21355355 | 452 days ago | IN | 0 ETH | 0.00058583 | ||||
| Set Approval For... | 21305513 | 459 days ago | IN | 0 ETH | 0.0004574 | ||||
| Set Approval For... | 21198038 | 474 days ago | IN | 0 ETH | 0.00091932 | ||||
| Transfer From | 21197378 | 474 days ago | IN | 0 ETH | 0.00089315 | ||||
| Set Approval For... | 21130354 | 484 days ago | IN | 0 ETH | 0.00099261 | ||||
| Set Approval For... | 20986168 | 504 days ago | IN | 0 ETH | 0.00130844 | ||||
| Set Approval For... | 20944229 | 510 days ago | IN | 0 ETH | 0.00107122 | ||||
| Set Approval For... | 20848958 | 523 days ago | IN | 0 ETH | 0.00045071 | ||||
| Set Approval For... | 20789106 | 531 days ago | IN | 0 ETH | 0.00020073 |
Loading...
Loading
Loading...
Loading
Cross-Chain Transactions
Loading...
Loading
Contract Name:
DarkLabs
Compiler Version
v0.8.13+commit.abaa5c0e
Optimization Enabled:
Yes with 200 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.9;
import "@openzeppelin/contracts/utils/Address.sol";
import "operator-filter-registry/src/OperatorFilterer.sol";
import "erc721a/contracts/extensions/ERC721AQueryable.sol";
import "../Common/Merkle.sol";
import "../Common/Signed.sol";
contract DarkLabs is ERC721AQueryable, OperatorFilterer, Merkle, Signed {
using Address for address;
error OperatorDenied();
error AccountNotListed();
error ExceedsSupplyLimit();
error ExceedsWalletLimit();
error FourPackSoldOut();
error InvalidPayment();
error InvalidQuantity();
error InvalidSaleState();
error InvalidDenylistRegistry();
error SaleNotActive();
error UnbalancedInputs();
error MaxSupplyLowerThanTotalSupply();
error SupplyGreaterThanExistingMax();
enum SaleState{
NONE,
WHITELIST
}
struct MintConfig{
uint64 ethPrice;
uint16 maxSupply;
SaleState saleState;
}
MintConfig public config = MintConfig(
1.00 ether, //ethPrice
875, //maxSupply
SaleState.NONE
);
uint8 public batchSize = 4;
uint8 public fourPacks = 95;
string public baseURI = "https://ipfs.io/ipfs/QmY25D51dQ9Pz5vT5tR5gMZ8BCxW1yzCBBJ1PBdxZ5xPPd?";
bool public isOSEnabled = true;
address public crossmintOperator = 0xdAb1a1854214684acE522439684a145E62505233;
modifier onlyCrossmint(){
if(msg.sender != crossmintOperator) revert OperatorDenied();
_;
}
modifier onlyAllowedOperator(address from) override {
if (isOSEnabled && from != msg.sender) {
_checkFilterOperator(msg.sender);
}
_;
}
modifier onlyAllowedOperatorApproval(address operator) override {
if(isOSEnabled){
_checkFilterOperator(operator);
}
_;
}
constructor(address signer)
ERC721A("Dark Labs", "DL")
OperatorFilterer(0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6, true)
Signed(signer)
{
merkleRoot = 0xc0fcbef69c7c199eaf8c0d30b78a648fc01bc7f75505a76ea0371c082b7bf274;
}
function withdraw() external onlyOwner{
Address.sendValue(payable(owner()), address(this).balance);
}
function setBaseURI(string calldata newBaseURI) external onlyOwner{
baseURI = newBaseURI;
}
//payable - public
function mint(uint16 quantity, bytes32[] calldata proof) external payable{
if(!_isValidProof(keccak256(abi.encodePacked(msg.sender)), proof))
revert AccountNotListed();
if(quantity == 1){
_mintPacks(1, msg.sender);
}
else if(quantity == 4){
if(fourPacks == 0) revert FourPackSoldOut();
fourPacks--;
_mintPacks(4, msg.sender);
}
else{
revert InvalidQuantity();
}
}
function crossMint(
uint16 quantity,
address recipient,
bytes memory signature
) external payable onlyCrossmint
{
if(!_verifySignature(abi.encodePacked(recipient), signature))
revert AccountNotListed();
if(quantity == 1){
_mintPacks(1, recipient);
}
else if(quantity == 4){
if(fourPacks == 0) revert FourPackSoldOut();
fourPacks--;
_mintPacks(4, recipient);
}
else{
revert InvalidQuantity();
}
}
//payable - onlyDelegates
function mintTo(uint16[] calldata quantity, address[] calldata recipient) external payable onlyDelegates{
if(quantity.length != recipient.length) revert UnbalancedInputs();
uint256 totalQuantity = 0;
for(uint256 i = 0; i < quantity.length; ++i){
totalQuantity += quantity[i];
}
if(totalSupply() + totalQuantity > config.maxSupply) revert ExceedsSupplyLimit();
for(uint256 i = 0; i < recipient.length; ++i){
_mintBatch(recipient[i], quantity[i]);
}
}
//nonpayable - onlyDelegates
function setBatchSize(uint8 newBatchSize) external onlyDelegates{
batchSize = newBatchSize;
}
function setConfig(MintConfig calldata newConfig) external onlyDelegates{
if(newConfig.maxSupply < totalSupply()) revert MaxSupplyLowerThanTotalSupply();
if(newConfig.maxSupply > config.maxSupply) revert SupplyGreaterThanExistingMax();
if(uint8(newConfig.saleState) > 1) revert InvalidSaleState();
config = newConfig;
}
function setCrossmint(address operator) external onlyDelegates{
crossmintOperator = operator;
}
function setSigner(address signer) external onlyDelegates{
_setSigner(signer);
}
//view - public
function supportsInterface(bytes4 interfaceId) public view
override(IERC721A, ERC721A) returns (bool)
{
return ERC721A.supportsInterface(interfaceId);
}
//internal
function _mintPacks(uint16 quantity, address recipient) internal{
MintConfig memory cfg = config;
if(cfg.saleState != SaleState.WHITELIST)
revert SaleNotActive();
if(msg.value != (quantity * cfg.ethPrice)) revert InvalidPayment();
if(_numberMinted(recipient) > 0) revert ExceedsWalletLimit();
if(totalSupply() + quantity > cfg.maxSupply) revert ExceedsSupplyLimit();
_mintBatch(recipient, quantity );
}
function _mintBatch(address to, uint256 quantity) internal {
while(quantity > 0){
if(quantity > batchSize){
_mint(to, batchSize);
quantity -= batchSize;
}
else{
_mint(to, quantity);
break;
}
}
}
//internal - override
function _startTokenId() internal pure override returns (uint256) {
return 1;
}
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) public view virtual override(IERC721A, ERC721A) returns (string memory) {
if (!_exists(tokenId)) revert URIQueryForNonexistentToken();
return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : "";
}
//OS overrides
function approve(address operator, uint256 tokenId)
public
payable
override(IERC721A, ERC721A)
onlyAllowedOperatorApproval(operator)
{
super.approve(operator, tokenId);
}
function setApprovalForAll(address operator, bool approved)
public
override(IERC721A, ERC721A)
onlyAllowedOperatorApproval(operator)
{
super.setApprovalForAll(operator, approved);
}
function safeTransferFrom(address from, address to, uint256 tokenId)
public
payable
override(IERC721A, ERC721A) onlyAllowedOperator(from)
{
super.safeTransferFrom(from, to, tokenId);
}
function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data)
public
payable
override(IERC721A, ERC721A)
onlyAllowedOperator(from)
{
super.safeTransferFrom(from, to, tokenId, data);
}
function transferFrom(address from, address to, uint256 tokenId)
public
payable
override(IERC721A, ERC721A)
onlyAllowedOperator(from)
{
if (_ownershipAt( tokenId ).extraData > 0)
revert( "Private sale tokens temporarily locked" );
super.transferFrom(from, to, tokenId);
}
}// SPDX-License-Identifier: BSD-3
pragma solidity ^0.8.9;
import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
import "./Delegated.sol";
contract Signed{
// is Delegated{
// is IERC1271{
using ECDSA for bytes32;
address internal _signer;
constructor(address signer) {
_setSigner( signer );
}
function _createHash(bytes memory data) internal virtual view returns (bytes32) {
return keccak256( abi.encodePacked( address(this), msg.sender, data ) );
}
function _getSigner(bytes32 hash, bytes memory signature) internal pure returns(address){
return hash.toEthSignedMessageHash().recover( signature );
}
function _isAuthorizedSigner(address extracted) internal view virtual returns(bool){
return extracted == _signer;
}
function _setSigner(address signer) internal{
_signer = signer;
}
function _verifySignature(bytes memory data, bytes memory signature) internal view returns(bool){
address extracted = _getSigner( _createHash( data ), signature );
return _isAuthorizedSigner(extracted);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.9;
import "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
import "./Delegated.sol";
contract Merkle is Delegated{
bytes32 public merkleRoot = "";
function setMerkleRoot(bytes32 merkleRoot_) external onlyDelegates {
merkleRoot = merkleRoot_;
}
function _isValidProof(bytes32 leaf, bytes32[] memory proof) internal view returns(bool) {
return MerkleProof.processProof(proof, leaf) == merkleRoot;
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.9;
import "@openzeppelin/contracts/access/Ownable.sol";
contract Delegated is Ownable{
mapping(address => bool) internal _delegates;
modifier onlyDelegates {
require(_delegates[msg.sender], "Invalid delegate" );
_;
}
constructor()
Ownable(){
setDelegate(owner(), true);
}
//onlyOwner
function isDelegate(address addr) external view onlyOwner returns(bool) {
return _delegates[addr];
}
function setDelegate(address addr, bool isDelegate_) public onlyOwner {
_delegates[addr] = isDelegate_;
}
function transferOwnership(address newOwner) public virtual override onlyOwner {
setDelegate(newOwner, true);
super.transferOwnership(newOwner);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.13;
import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.sol";
/**
* @title OperatorFilterer
* @notice Abstract contract whose constructor automatically registers and optionally subscribes to or copies another
* registrant's entries in the OperatorFilterRegistry.
* @dev This smart contract is meant to be inherited by token contracts so they can use the following:
* - `onlyAllowedOperator` modifier for `transferFrom` and `safeTransferFrom` methods.
* - `onlyAllowedOperatorApproval` modifier for `approve` and `setApprovalForAll` methods.
*/
abstract contract OperatorFilterer {
error OperatorNotAllowed(address operator);
IOperatorFilterRegistry public constant OPERATOR_FILTER_REGISTRY =
IOperatorFilterRegistry(0x000000000000AAeB6D7670E522A718067333cd4E);
constructor(address subscriptionOrRegistrantToCopy, bool subscribe) {
// If an inheriting token contract is deployed to a network without the registry deployed, the modifier
// will not revert, but the contract will need to be registered with the registry once it is deployed in
// order for the modifier to filter addresses.
if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
if (subscribe) {
OPERATOR_FILTER_REGISTRY.registerAndSubscribe(address(this), subscriptionOrRegistrantToCopy);
} else {
if (subscriptionOrRegistrantToCopy != address(0)) {
OPERATOR_FILTER_REGISTRY.registerAndCopyEntries(address(this), subscriptionOrRegistrantToCopy);
} else {
OPERATOR_FILTER_REGISTRY.register(address(this));
}
}
}
}
modifier onlyAllowedOperator(address from) virtual {
// Allow spending tokens from addresses with balance
// Note that this still allows listings and marketplaces with escrow to transfer tokens if transferred
// from an EOA.
if (from != msg.sender) {
_checkFilterOperator(msg.sender);
}
_;
}
modifier onlyAllowedOperatorApproval(address operator) virtual {
_checkFilterOperator(operator);
_;
}
function _checkFilterOperator(address operator) internal view virtual {
// Check registry code length to facilitate testing in environments without a deployed registry.
if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
if (!OPERATOR_FILTER_REGISTRY.isOperatorAllowed(address(this), operator)) {
revert OperatorNotAllowed(operator);
}
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.13;
interface IOperatorFilterRegistry {
function isOperatorAllowed(address registrant, address operator) external view returns (bool);
function register(address registrant) external;
function registerAndSubscribe(address registrant, address subscription) external;
function registerAndCopyEntries(address registrant, address registrantToCopy) external;
function unregister(address addr) external;
function updateOperator(address registrant, address operator, bool filtered) external;
function updateOperators(address registrant, address[] calldata operators, bool filtered) external;
function updateCodeHash(address registrant, bytes32 codehash, bool filtered) external;
function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external;
function subscribe(address registrant, address registrantToSubscribe) external;
function unsubscribe(address registrant, bool copyExistingEntries) external;
function subscriptionOf(address addr) external returns (address registrant);
function subscribers(address registrant) external returns (address[] memory);
function subscriberAt(address registrant, uint256 index) external returns (address);
function copyEntriesOf(address registrant, address registrantToCopy) external;
function isOperatorFiltered(address registrant, address operator) external returns (bool);
function isCodeHashOfFiltered(address registrant, address operatorWithCode) external returns (bool);
function isCodeHashFiltered(address registrant, bytes32 codeHash) external returns (bool);
function filteredOperators(address addr) external returns (address[] memory);
function filteredCodeHashes(address addr) external returns (bytes32[] memory);
function filteredOperatorAt(address registrant, uint256 index) external returns (address);
function filteredCodeHashAt(address registrant, uint256 index) external returns (bytes32);
function isRegistered(address addr) external returns (bool);
function codeHashOf(address addr) external returns (bytes32);
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
pragma solidity ^0.8.4;
import '../IERC721A.sol';
/**
* @dev Interface of ERC721AQueryable.
*/
interface IERC721AQueryable is IERC721A {
/**
* Invalid query range (`start` >= `stop`).
*/
error InvalidQueryRange();
/**
* @dev Returns the `TokenOwnership` struct at `tokenId` without reverting.
*
* If the `tokenId` is out of bounds:
*
* - `addr = address(0)`
* - `startTimestamp = 0`
* - `burned = false`
* - `extraData = 0`
*
* If the `tokenId` is burned:
*
* - `addr = <Address of owner before token was burned>`
* - `startTimestamp = <Timestamp when token was burned>`
* - `burned = true`
* - `extraData = <Extra data when token was burned>`
*
* Otherwise:
*
* - `addr = <Address of owner>`
* - `startTimestamp = <Timestamp of start of ownership>`
* - `burned = false`
* - `extraData = <Extra data at start of ownership>`
*/
function explicitOwnershipOf(uint256 tokenId) external view returns (TokenOwnership memory);
/**
* @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order.
* See {ERC721AQueryable-explicitOwnershipOf}
*/
function explicitOwnershipsOf(uint256[] memory tokenIds) external view returns (TokenOwnership[] memory);
/**
* @dev Returns an array of token IDs owned by `owner`,
* in the range [`start`, `stop`)
* (i.e. `start <= tokenId < stop`).
*
* This function allows for tokens to be queried if the collection
* grows too big for a single call of {ERC721AQueryable-tokensOfOwner}.
*
* Requirements:
*
* - `start < stop`
*/
function tokensOfOwnerIn(
address owner,
uint256 start,
uint256 stop
) external view returns (uint256[] memory);
/**
* @dev Returns an array of token IDs owned by `owner`.
*
* This function scans the ownership mapping and is O(`totalSupply`) in complexity.
* It is meant to be called off-chain.
*
* See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into
* multiple smaller scans if the collection is large enough to cause
* an out-of-gas error (10K collections should be fine).
*/
function tokensOfOwner(address owner) external view returns (uint256[] memory);
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
pragma solidity ^0.8.4;
import './IERC721AQueryable.sol';
import '../ERC721A.sol';
/**
* @title ERC721AQueryable.
*
* @dev ERC721A subclass with convenience query functions.
*/
abstract contract ERC721AQueryable is ERC721A, IERC721AQueryable {
/**
* @dev Returns the `TokenOwnership` struct at `tokenId` without reverting.
*
* If the `tokenId` is out of bounds:
*
* - `addr = address(0)`
* - `startTimestamp = 0`
* - `burned = false`
* - `extraData = 0`
*
* If the `tokenId` is burned:
*
* - `addr = <Address of owner before token was burned>`
* - `startTimestamp = <Timestamp when token was burned>`
* - `burned = true`
* - `extraData = <Extra data when token was burned>`
*
* Otherwise:
*
* - `addr = <Address of owner>`
* - `startTimestamp = <Timestamp of start of ownership>`
* - `burned = false`
* - `extraData = <Extra data at start of ownership>`
*/
function explicitOwnershipOf(uint256 tokenId) public view virtual override returns (TokenOwnership memory) {
TokenOwnership memory ownership;
if (tokenId < _startTokenId() || tokenId >= _nextTokenId()) {
return ownership;
}
ownership = _ownershipAt(tokenId);
if (ownership.burned) {
return ownership;
}
return _ownershipOf(tokenId);
}
/**
* @dev Returns an array of `TokenOwnership` structs at `tokenIds` in order.
* See {ERC721AQueryable-explicitOwnershipOf}
*/
function explicitOwnershipsOf(uint256[] calldata tokenIds)
external
view
virtual
override
returns (TokenOwnership[] memory)
{
unchecked {
uint256 tokenIdsLength = tokenIds.length;
TokenOwnership[] memory ownerships = new TokenOwnership[](tokenIdsLength);
for (uint256 i; i != tokenIdsLength; ++i) {
ownerships[i] = explicitOwnershipOf(tokenIds[i]);
}
return ownerships;
}
}
/**
* @dev Returns an array of token IDs owned by `owner`,
* in the range [`start`, `stop`)
* (i.e. `start <= tokenId < stop`).
*
* This function allows for tokens to be queried if the collection
* grows too big for a single call of {ERC721AQueryable-tokensOfOwner}.
*
* Requirements:
*
* - `start < stop`
*/
function tokensOfOwnerIn(
address owner,
uint256 start,
uint256 stop
) external view virtual override returns (uint256[] memory) {
unchecked {
if (start >= stop) revert InvalidQueryRange();
uint256 tokenIdsIdx;
uint256 stopLimit = _nextTokenId();
// Set `start = max(start, _startTokenId())`.
if (start < _startTokenId()) {
start = _startTokenId();
}
// Set `stop = min(stop, stopLimit)`.
if (stop > stopLimit) {
stop = stopLimit;
}
uint256 tokenIdsMaxLength = balanceOf(owner);
// Set `tokenIdsMaxLength = min(balanceOf(owner), stop - start)`,
// to cater for cases where `balanceOf(owner)` is too big.
if (start < stop) {
uint256 rangeLength = stop - start;
if (rangeLength < tokenIdsMaxLength) {
tokenIdsMaxLength = rangeLength;
}
} else {
tokenIdsMaxLength = 0;
}
uint256[] memory tokenIds = new uint256[](tokenIdsMaxLength);
if (tokenIdsMaxLength == 0) {
return tokenIds;
}
// We need to call `explicitOwnershipOf(start)`,
// because the slot at `start` may not be initialized.
TokenOwnership memory ownership = explicitOwnershipOf(start);
address currOwnershipAddr;
// If the starting slot exists (i.e. not burned), initialize `currOwnershipAddr`.
// `ownership.address` will not be zero, as `start` is clamped to the valid token ID range.
if (!ownership.burned) {
currOwnershipAddr = ownership.addr;
}
for (uint256 i = start; i != stop && tokenIdsIdx != tokenIdsMaxLength; ++i) {
ownership = _ownershipAt(i);
if (ownership.burned) {
continue;
}
if (ownership.addr != address(0)) {
currOwnershipAddr = ownership.addr;
}
if (currOwnershipAddr == owner) {
tokenIds[tokenIdsIdx++] = i;
}
}
// Downsize the array to fit.
assembly {
mstore(tokenIds, tokenIdsIdx)
}
return tokenIds;
}
}
/**
* @dev Returns an array of token IDs owned by `owner`.
*
* This function scans the ownership mapping and is O(`totalSupply`) in complexity.
* It is meant to be called off-chain.
*
* See {ERC721AQueryable-tokensOfOwnerIn} for splitting the scan into
* multiple smaller scans if the collection is large enough to cause
* an out-of-gas error (10K collections should be fine).
*/
function tokensOfOwner(address owner) external view virtual override returns (uint256[] memory) {
unchecked {
uint256 tokenIdsIdx;
address currOwnershipAddr;
uint256 tokenIdsLength = balanceOf(owner);
uint256[] memory tokenIds = new uint256[](tokenIdsLength);
TokenOwnership memory ownership;
for (uint256 i = _startTokenId(); tokenIdsIdx != tokenIdsLength; ++i) {
ownership = _ownershipAt(i);
if (ownership.burned) {
continue;
}
if (ownership.addr != address(0)) {
currOwnershipAddr = ownership.addr;
}
if (currOwnershipAddr == owner) {
tokenIds[tokenIdsIdx++] = i;
}
}
return tokenIds;
}
}
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
pragma solidity ^0.8.4;
/**
* @dev Interface of ERC721A.
*/
interface IERC721A {
/**
* The caller must own the token or be an approved operator.
*/
error ApprovalCallerNotOwnerNorApproved();
/**
* The token does not exist.
*/
error ApprovalQueryForNonexistentToken();
/**
* Cannot query the balance for the zero address.
*/
error BalanceQueryForZeroAddress();
/**
* Cannot mint to the zero address.
*/
error MintToZeroAddress();
/**
* The quantity of tokens minted must be more than zero.
*/
error MintZeroQuantity();
/**
* The token does not exist.
*/
error OwnerQueryForNonexistentToken();
/**
* The caller must own the token or be an approved operator.
*/
error TransferCallerNotOwnerNorApproved();
/**
* The token must be owned by `from`.
*/
error TransferFromIncorrectOwner();
/**
* Cannot safely transfer to a contract that does not implement the
* ERC721Receiver interface.
*/
error TransferToNonERC721ReceiverImplementer();
/**
* Cannot transfer to the zero address.
*/
error TransferToZeroAddress();
/**
* The token does not exist.
*/
error URIQueryForNonexistentToken();
/**
* The `quantity` minted with ERC2309 exceeds the safety limit.
*/
error MintERC2309QuantityExceedsLimit();
/**
* The `extraData` cannot be set on an unintialized ownership slot.
*/
error OwnershipNotInitializedForExtraData();
// =============================================================
// STRUCTS
// =============================================================
struct TokenOwnership {
// The address of the owner.
address addr;
// Stores the start time of ownership with minimal overhead for tokenomics.
uint64 startTimestamp;
// Whether the token has been burned.
bool burned;
// Arbitrary data similar to `startTimestamp` that can be set via {_extraData}.
uint24 extraData;
}
// =============================================================
// TOKEN COUNTERS
// =============================================================
/**
* @dev Returns the total number of tokens in existence.
* Burned tokens will reduce the count.
* To get the total number of tokens minted, please see {_totalMinted}.
*/
function totalSupply() external view returns (uint256);
// =============================================================
// IERC165
// =============================================================
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
* to learn more about how these ids are created.
*
* This function call must use less than 30000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
// =============================================================
// IERC721
// =============================================================
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables
* (`approved`) `operator` to manage all of its assets.
*/
event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
/**
* @dev Returns the number of tokens in `owner`'s account.
*/
function balanceOf(address owner) external view returns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) external view returns (address owner);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`,
* checking first that contract recipients are aware of the ERC721 protocol
* to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be have been allowed to move
* this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes calldata data
) external payable;
/**
* @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) external payable;
/**
* @dev Transfers `tokenId` from `from` to `to`.
*
* WARNING: Usage of this method is discouraged, use {safeTransferFrom}
* whenever possible.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) external payable;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the
* zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) external payable;
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom}
* for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool _approved) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) external view returns (address operator);
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address owner, address operator) external view returns (bool);
// =============================================================
// IERC721Metadata
// =============================================================
/**
* @dev Returns the token collection name.
*/
function name() external view returns (string memory);
/**
* @dev Returns the token collection symbol.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) external view returns (string memory);
// =============================================================
// IERC2309
// =============================================================
/**
* @dev Emitted when tokens in `fromTokenId` to `toTokenId`
* (inclusive) is transferred from `from` to `to`, as defined in the
* [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard.
*
* See {_mintERC2309} for more details.
*/
event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to);
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
pragma solidity ^0.8.4;
import './IERC721A.sol';
/**
* @dev Interface of ERC721 token receiver.
*/
interface ERC721A__IERC721Receiver {
function onERC721Received(
address operator,
address from,
uint256 tokenId,
bytes calldata data
) external returns (bytes4);
}
/**
* @title ERC721A
*
* @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721)
* Non-Fungible Token Standard, including the Metadata extension.
* Optimized for lower gas during batch mints.
*
* Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...)
* starting from `_startTokenId()`.
*
* Assumptions:
*
* - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply.
* - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256).
*/
contract ERC721A is IERC721A {
// Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364).
struct TokenApprovalRef {
address value;
}
// =============================================================
// CONSTANTS
// =============================================================
// Mask of an entry in packed address data.
uint256 private constant _BITMASK_ADDRESS_DATA_ENTRY = (1 << 64) - 1;
// The bit position of `numberMinted` in packed address data.
uint256 private constant _BITPOS_NUMBER_MINTED = 64;
// The bit position of `numberBurned` in packed address data.
uint256 private constant _BITPOS_NUMBER_BURNED = 128;
// The bit position of `aux` in packed address data.
uint256 private constant _BITPOS_AUX = 192;
// Mask of all 256 bits in packed address data except the 64 bits for `aux`.
uint256 private constant _BITMASK_AUX_COMPLEMENT = (1 << 192) - 1;
// The bit position of `startTimestamp` in packed ownership.
uint256 private constant _BITPOS_START_TIMESTAMP = 160;
// The bit mask of the `burned` bit in packed ownership.
uint256 private constant _BITMASK_BURNED = 1 << 224;
// The bit position of the `nextInitialized` bit in packed ownership.
uint256 private constant _BITPOS_NEXT_INITIALIZED = 225;
// The bit mask of the `nextInitialized` bit in packed ownership.
uint256 private constant _BITMASK_NEXT_INITIALIZED = 1 << 225;
// The bit position of `extraData` in packed ownership.
uint256 private constant _BITPOS_EXTRA_DATA = 232;
// Mask of all 256 bits in a packed ownership except the 24 bits for `extraData`.
uint256 private constant _BITMASK_EXTRA_DATA_COMPLEMENT = (1 << 232) - 1;
// The mask of the lower 160 bits for addresses.
uint256 private constant _BITMASK_ADDRESS = (1 << 160) - 1;
// The maximum `quantity` that can be minted with {_mintERC2309}.
// This limit is to prevent overflows on the address data entries.
// For a limit of 5000, a total of 3.689e15 calls to {_mintERC2309}
// is required to cause an overflow, which is unrealistic.
uint256 private constant _MAX_MINT_ERC2309_QUANTITY_LIMIT = 5000;
// The `Transfer` event signature is given by:
// `keccak256(bytes("Transfer(address,address,uint256)"))`.
bytes32 private constant _TRANSFER_EVENT_SIGNATURE =
0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef;
// =============================================================
// STORAGE
// =============================================================
// The next token ID to be minted.
uint256 private _currentIndex;
// The number of tokens burned.
uint256 private _burnCounter;
// Token name
string private _name;
// Token symbol
string private _symbol;
// Mapping from token ID to ownership details
// An empty struct value does not necessarily mean the token is unowned.
// See {_packedOwnershipOf} implementation for details.
//
// Bits Layout:
// - [0..159] `addr`
// - [160..223] `startTimestamp`
// - [224] `burned`
// - [225] `nextInitialized`
// - [232..255] `extraData`
mapping(uint256 => uint256) private _packedOwnerships;
// Mapping owner address to address data.
//
// Bits Layout:
// - [0..63] `balance`
// - [64..127] `numberMinted`
// - [128..191] `numberBurned`
// - [192..255] `aux`
mapping(address => uint256) private _packedAddressData;
// Mapping from token ID to approved address.
mapping(uint256 => TokenApprovalRef) private _tokenApprovals;
// Mapping from owner to operator approvals
mapping(address => mapping(address => bool)) private _operatorApprovals;
// =============================================================
// CONSTRUCTOR
// =============================================================
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
_currentIndex = _startTokenId();
}
// =============================================================
// TOKEN COUNTING OPERATIONS
// =============================================================
/**
* @dev Returns the starting token ID.
* To change the starting token ID, please override this function.
*/
function _startTokenId() internal view virtual returns (uint256) {
return 0;
}
/**
* @dev Returns the next token ID to be minted.
*/
function _nextTokenId() internal view virtual returns (uint256) {
return _currentIndex;
}
/**
* @dev Returns the total number of tokens in existence.
* Burned tokens will reduce the count.
* To get the total number of tokens minted, please see {_totalMinted}.
*/
function totalSupply() public view virtual override returns (uint256) {
// Counter underflow is impossible as _burnCounter cannot be incremented
// more than `_currentIndex - _startTokenId()` times.
unchecked {
return _currentIndex - _burnCounter - _startTokenId();
}
}
/**
* @dev Returns the total amount of tokens minted in the contract.
*/
function _totalMinted() internal view virtual returns (uint256) {
// Counter underflow is impossible as `_currentIndex` does not decrement,
// and it is initialized to `_startTokenId()`.
unchecked {
return _currentIndex - _startTokenId();
}
}
/**
* @dev Returns the total number of tokens burned.
*/
function _totalBurned() internal view virtual returns (uint256) {
return _burnCounter;
}
// =============================================================
// ADDRESS DATA OPERATIONS
// =============================================================
/**
* @dev Returns the number of tokens in `owner`'s account.
*/
function balanceOf(address owner) public view virtual override returns (uint256) {
if (owner == address(0)) revert BalanceQueryForZeroAddress();
return _packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY;
}
/**
* Returns the number of tokens minted by `owner`.
*/
function _numberMinted(address owner) internal view returns (uint256) {
return (_packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY;
}
/**
* Returns the number of tokens burned by or on behalf of `owner`.
*/
function _numberBurned(address owner) internal view returns (uint256) {
return (_packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY;
}
/**
* Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
*/
function _getAux(address owner) internal view returns (uint64) {
return uint64(_packedAddressData[owner] >> _BITPOS_AUX);
}
/**
* Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
* If there are multiple variables, please pack them into a uint64.
*/
function _setAux(address owner, uint64 aux) internal virtual {
uint256 packed = _packedAddressData[owner];
uint256 auxCasted;
// Cast `aux` with assembly to avoid redundant masking.
assembly {
auxCasted := aux
}
packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX);
_packedAddressData[owner] = packed;
}
// =============================================================
// IERC165
// =============================================================
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
* to learn more about how these ids are created.
*
* This function call must use less than 30000 gas.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
// The interface IDs are constants representing the first 4 bytes
// of the XOR of all function selectors in the interface.
// See: [ERC165](https://eips.ethereum.org/EIPS/eip-165)
// (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`)
return
interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165.
interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721.
interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata.
}
// =============================================================
// IERC721Metadata
// =============================================================
/**
* @dev Returns the token collection name.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev Returns the token collection symbol.
*/
function symbol() public view virtual override returns (string memory) {
return _symbol;
}
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
if (!_exists(tokenId)) revert URIQueryForNonexistentToken();
string memory baseURI = _baseURI();
return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : '';
}
/**
* @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
* token will be the concatenation of the `baseURI` and the `tokenId`. Empty
* by default, it can be overridden in child contracts.
*/
function _baseURI() internal view virtual returns (string memory) {
return '';
}
// =============================================================
// OWNERSHIPS OPERATIONS
// =============================================================
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) public view virtual override returns (address) {
return address(uint160(_packedOwnershipOf(tokenId)));
}
/**
* @dev Gas spent here starts off proportional to the maximum mint batch size.
* It gradually moves to O(1) as tokens get transferred around over time.
*/
function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) {
return _unpackedOwnership(_packedOwnershipOf(tokenId));
}
/**
* @dev Returns the unpacked `TokenOwnership` struct at `index`.
*/
function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) {
return _unpackedOwnership(_packedOwnerships[index]);
}
/**
* @dev Initializes the ownership slot minted at `index` for efficiency purposes.
*/
function _initializeOwnershipAt(uint256 index) internal virtual {
if (_packedOwnerships[index] == 0) {
_packedOwnerships[index] = _packedOwnershipOf(index);
}
}
/**
* Returns the packed ownership data of `tokenId`.
*/
function _packedOwnershipOf(uint256 tokenId) private view returns (uint256) {
uint256 curr = tokenId;
unchecked {
if (_startTokenId() <= curr)
if (curr < _currentIndex) {
uint256 packed = _packedOwnerships[curr];
// If not burned.
if (packed & _BITMASK_BURNED == 0) {
// Invariant:
// There will always be an initialized ownership slot
// (i.e. `ownership.addr != address(0) && ownership.burned == false`)
// before an unintialized ownership slot
// (i.e. `ownership.addr == address(0) && ownership.burned == false`)
// Hence, `curr` will not underflow.
//
// We can directly compare the packed value.
// If the address is zero, packed will be zero.
while (packed == 0) {
packed = _packedOwnerships[--curr];
}
return packed;
}
}
}
revert OwnerQueryForNonexistentToken();
}
/**
* @dev Returns the unpacked `TokenOwnership` struct from `packed`.
*/
function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) {
ownership.addr = address(uint160(packed));
ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP);
ownership.burned = packed & _BITMASK_BURNED != 0;
ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA);
}
/**
* @dev Packs ownership data into a single uint256.
*/
function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`.
result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags))
}
}
/**
* @dev Returns the `nextInitialized` flag set if `quantity` equals 1.
*/
function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) {
// For branchless setting of the `nextInitialized` flag.
assembly {
// `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`.
result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1))
}
}
// =============================================================
// APPROVAL OPERATIONS
// =============================================================
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the
* zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) public payable virtual override {
address owner = ownerOf(tokenId);
if (_msgSenderERC721A() != owner)
if (!isApprovedForAll(owner, _msgSenderERC721A())) {
revert ApprovalCallerNotOwnerNorApproved();
}
_tokenApprovals[tokenId].value = to;
emit Approval(owner, to, tokenId);
}
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) public view virtual override returns (address) {
if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken();
return _tokenApprovals[tokenId].value;
}
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom}
* for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_operatorApprovals[_msgSenderERC721A()][operator] = approved;
emit ApprovalForAll(_msgSenderERC721A(), operator, approved);
}
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
return _operatorApprovals[owner][operator];
}
/**
* @dev Returns whether `tokenId` exists.
*
* Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
*
* Tokens start existing when they are minted. See {_mint}.
*/
function _exists(uint256 tokenId) internal view virtual returns (bool) {
return
_startTokenId() <= tokenId &&
tokenId < _currentIndex && // If within bounds,
_packedOwnerships[tokenId] & _BITMASK_BURNED == 0; // and not burned.
}
/**
* @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`.
*/
function _isSenderApprovedOrOwner(
address approvedAddress,
address owner,
address msgSender
) private pure returns (bool result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean.
msgSender := and(msgSender, _BITMASK_ADDRESS)
// `msgSender == owner || msgSender == approvedAddress`.
result := or(eq(msgSender, owner), eq(msgSender, approvedAddress))
}
}
/**
* @dev Returns the storage slot and value for the approved address of `tokenId`.
*/
function _getApprovedSlotAndAddress(uint256 tokenId)
private
view
returns (uint256 approvedAddressSlot, address approvedAddress)
{
TokenApprovalRef storage tokenApproval = _tokenApprovals[tokenId];
// The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`.
assembly {
approvedAddressSlot := tokenApproval.slot
approvedAddress := sload(approvedAddressSlot)
}
}
// =============================================================
// TRANSFER OPERATIONS
// =============================================================
/**
* @dev Transfers `tokenId` from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) public payable virtual override {
uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);
if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner();
(uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);
// The nested ifs save around 20+ gas over a compound boolean condition.
if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();
if (to == address(0)) revert TransferToZeroAddress();
_beforeTokenTransfers(from, to, tokenId, 1);
// Clear approvals from the previous owner.
assembly {
if approvedAddress {
// This is equivalent to `delete _tokenApprovals[tokenId]`.
sstore(approvedAddressSlot, 0)
}
}
// Underflow of the sender's balance is impossible because we check for
// ownership above and the recipient's balance can't realistically overflow.
// Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
unchecked {
// We can directly increment and decrement the balances.
--_packedAddressData[from]; // Updates: `balance -= 1`.
++_packedAddressData[to]; // Updates: `balance += 1`.
// Updates:
// - `address` to the next owner.
// - `startTimestamp` to the timestamp of transfering.
// - `burned` to `false`.
// - `nextInitialized` to `true`.
_packedOwnerships[tokenId] = _packOwnershipData(
to,
_BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked)
);
// If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
uint256 nextTokenId = tokenId + 1;
// If the next slot's address is zero and not burned (i.e. packed value is zero).
if (_packedOwnerships[nextTokenId] == 0) {
// If the next slot is within bounds.
if (nextTokenId != _currentIndex) {
// Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
_packedOwnerships[nextTokenId] = prevOwnershipPacked;
}
}
}
}
emit Transfer(from, to, tokenId);
_afterTokenTransfers(from, to, tokenId, 1);
}
/**
* @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) public payable virtual override {
safeTransferFrom(from, to, tokenId, '');
}
/**
* @dev Safely transfers `tokenId` token from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes memory _data
) public payable virtual override {
transferFrom(from, to, tokenId);
if (to.code.length != 0)
if (!_checkContractOnERC721Received(from, to, tokenId, _data)) {
revert TransferToNonERC721ReceiverImplementer();
}
}
/**
* @dev Hook that is called before a set of serially-ordered token IDs
* are about to be transferred. This includes minting.
* And also called before burning one token.
*
* `startTokenId` - the first token ID to be transferred.
* `quantity` - the amount to be transferred.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
* transferred to `to`.
* - When `from` is zero, `tokenId` will be minted for `to`.
* - When `to` is zero, `tokenId` will be burned by `from`.
* - `from` and `to` are never both zero.
*/
function _beforeTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual {}
/**
* @dev Hook that is called after a set of serially-ordered token IDs
* have been transferred. This includes minting.
* And also called after one token has been burned.
*
* `startTokenId` - the first token ID to be transferred.
* `quantity` - the amount to be transferred.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` has been
* transferred to `to`.
* - When `from` is zero, `tokenId` has been minted for `to`.
* - When `to` is zero, `tokenId` has been burned by `from`.
* - `from` and `to` are never both zero.
*/
function _afterTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual {}
/**
* @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract.
*
* `from` - Previous owner of the given token ID.
* `to` - Target address that will receive the token.
* `tokenId` - Token ID to be transferred.
* `_data` - Optional data to send along with the call.
*
* Returns whether the call correctly returned the expected magic value.
*/
function _checkContractOnERC721Received(
address from,
address to,
uint256 tokenId,
bytes memory _data
) private returns (bool) {
try ERC721A__IERC721Receiver(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data) returns (
bytes4 retval
) {
return retval == ERC721A__IERC721Receiver(to).onERC721Received.selector;
} catch (bytes memory reason) {
if (reason.length == 0) {
revert TransferToNonERC721ReceiverImplementer();
} else {
assembly {
revert(add(32, reason), mload(reason))
}
}
}
}
// =============================================================
// MINT OPERATIONS
// =============================================================
/**
* @dev Mints `quantity` tokens and transfers them to `to`.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `quantity` must be greater than 0.
*
* Emits a {Transfer} event for each mint.
*/
function _mint(address to, uint256 quantity) internal virtual {
uint256 startTokenId = _currentIndex;
if (quantity == 0) revert MintZeroQuantity();
_beforeTokenTransfers(address(0), to, startTokenId, quantity);
// Overflows are incredibly unrealistic.
// `balance` and `numberMinted` have a maximum limit of 2**64.
// `tokenId` has a maximum limit of 2**256.
unchecked {
// Updates:
// - `balance += quantity`.
// - `numberMinted += quantity`.
//
// We can directly add to the `balance` and `numberMinted`.
_packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);
// Updates:
// - `address` to the owner.
// - `startTimestamp` to the timestamp of minting.
// - `burned` to `false`.
// - `nextInitialized` to `quantity == 1`.
_packedOwnerships[startTokenId] = _packOwnershipData(
to,
_nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
);
uint256 toMasked;
uint256 end = startTokenId + quantity;
// Use assembly to loop and emit the `Transfer` event for gas savings.
// The duplicated `log4` removes an extra check and reduces stack juggling.
// The assembly, together with the surrounding Solidity code, have been
// delicately arranged to nudge the compiler into producing optimized opcodes.
assembly {
// Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
toMasked := and(to, _BITMASK_ADDRESS)
// Emit the `Transfer` event.
log4(
0, // Start of data (0, since no data).
0, // End of data (0, since no data).
_TRANSFER_EVENT_SIGNATURE, // Signature.
0, // `address(0)`.
toMasked, // `to`.
startTokenId // `tokenId`.
)
// The `iszero(eq(,))` check ensures that large values of `quantity`
// that overflows uint256 will make the loop run out of gas.
// The compiler will optimize the `iszero` away for performance.
for {
let tokenId := add(startTokenId, 1)
} iszero(eq(tokenId, end)) {
tokenId := add(tokenId, 1)
} {
// Emit the `Transfer` event. Similar to above.
log4(0, 0, _TRANSFER_EVENT_SIGNATURE, 0, toMasked, tokenId)
}
}
if (toMasked == 0) revert MintToZeroAddress();
_currentIndex = end;
}
_afterTokenTransfers(address(0), to, startTokenId, quantity);
}
/**
* @dev Mints `quantity` tokens and transfers them to `to`.
*
* This function is intended for efficient minting only during contract creation.
*
* It emits only one {ConsecutiveTransfer} as defined in
* [ERC2309](https://eips.ethereum.org/EIPS/eip-2309),
* instead of a sequence of {Transfer} event(s).
*
* Calling this function outside of contract creation WILL make your contract
* non-compliant with the ERC721 standard.
* For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309
* {ConsecutiveTransfer} event is only permissible during contract creation.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `quantity` must be greater than 0.
*
* Emits a {ConsecutiveTransfer} event.
*/
function _mintERC2309(address to, uint256 quantity) internal virtual {
uint256 startTokenId = _currentIndex;
if (to == address(0)) revert MintToZeroAddress();
if (quantity == 0) revert MintZeroQuantity();
if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) revert MintERC2309QuantityExceedsLimit();
_beforeTokenTransfers(address(0), to, startTokenId, quantity);
// Overflows are unrealistic due to the above check for `quantity` to be below the limit.
unchecked {
// Updates:
// - `balance += quantity`.
// - `numberMinted += quantity`.
//
// We can directly add to the `balance` and `numberMinted`.
_packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);
// Updates:
// - `address` to the owner.
// - `startTimestamp` to the timestamp of minting.
// - `burned` to `false`.
// - `nextInitialized` to `quantity == 1`.
_packedOwnerships[startTokenId] = _packOwnershipData(
to,
_nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
);
emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to);
_currentIndex = startTokenId + quantity;
}
_afterTokenTransfers(address(0), to, startTokenId, quantity);
}
/**
* @dev Safely mints `quantity` tokens and transfers them to `to`.
*
* Requirements:
*
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called for each safe transfer.
* - `quantity` must be greater than 0.
*
* See {_mint}.
*
* Emits a {Transfer} event for each mint.
*/
function _safeMint(
address to,
uint256 quantity,
bytes memory _data
) internal virtual {
_mint(to, quantity);
unchecked {
if (to.code.length != 0) {
uint256 end = _currentIndex;
uint256 index = end - quantity;
do {
if (!_checkContractOnERC721Received(address(0), to, index++, _data)) {
revert TransferToNonERC721ReceiverImplementer();
}
} while (index < end);
// Reentrancy protection.
if (_currentIndex != end) revert();
}
}
}
/**
* @dev Equivalent to `_safeMint(to, quantity, '')`.
*/
function _safeMint(address to, uint256 quantity) internal virtual {
_safeMint(to, quantity, '');
}
// =============================================================
// BURN OPERATIONS
// =============================================================
/**
* @dev Equivalent to `_burn(tokenId, false)`.
*/
function _burn(uint256 tokenId) internal virtual {
_burn(tokenId, false);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/
function _burn(uint256 tokenId, bool approvalCheck) internal virtual {
uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);
address from = address(uint160(prevOwnershipPacked));
(uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);
if (approvalCheck) {
// The nested ifs save around 20+ gas over a compound boolean condition.
if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();
}
_beforeTokenTransfers(from, address(0), tokenId, 1);
// Clear approvals from the previous owner.
assembly {
if approvedAddress {
// This is equivalent to `delete _tokenApprovals[tokenId]`.
sstore(approvedAddressSlot, 0)
}
}
// Underflow of the sender's balance is impossible because we check for
// ownership above and the recipient's balance can't realistically overflow.
// Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
unchecked {
// Updates:
// - `balance -= 1`.
// - `numberBurned += 1`.
//
// We can directly decrement the balance, and increment the number burned.
// This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`.
_packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1;
// Updates:
// - `address` to the last owner.
// - `startTimestamp` to the timestamp of burning.
// - `burned` to `true`.
// - `nextInitialized` to `true`.
_packedOwnerships[tokenId] = _packOwnershipData(
from,
(_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked)
);
// If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
uint256 nextTokenId = tokenId + 1;
// If the next slot's address is zero and not burned (i.e. packed value is zero).
if (_packedOwnerships[nextTokenId] == 0) {
// If the next slot is within bounds.
if (nextTokenId != _currentIndex) {
// Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
_packedOwnerships[nextTokenId] = prevOwnershipPacked;
}
}
}
}
emit Transfer(from, address(0), tokenId);
_afterTokenTransfers(from, address(0), tokenId, 1);
// Overflow not possible, as _burnCounter cannot be exceed _currentIndex times.
unchecked {
_burnCounter++;
}
}
// =============================================================
// EXTRA DATA OPERATIONS
// =============================================================
/**
* @dev Directly sets the extra data for the ownership data `index`.
*/
function _setExtraDataAt(uint256 index, uint24 extraData) internal virtual {
uint256 packed = _packedOwnerships[index];
if (packed == 0) revert OwnershipNotInitializedForExtraData();
uint256 extraDataCasted;
// Cast `extraData` with assembly to avoid redundant masking.
assembly {
extraDataCasted := extraData
}
packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA);
_packedOwnerships[index] = packed;
}
/**
* @dev Called during each token transfer to set the 24bit `extraData` field.
* Intended to be overridden by the cosumer contract.
*
* `previousExtraData` - the value of `extraData` before transfer.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
* transferred to `to`.
* - When `from` is zero, `tokenId` will be minted for `to`.
* - When `to` is zero, `tokenId` will be burned by `from`.
* - `from` and `to` are never both zero.
*/
function _extraData(
address from,
address to,
uint24 previousExtraData
) internal view virtual returns (uint24) {}
/**
* @dev Returns the next extra data for the packed ownership data.
* The returned result is shifted into position.
*/
function _nextExtraData(
address from,
address to,
uint256 prevOwnershipPacked
) private view returns (uint256) {
uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA);
return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA;
}
// =============================================================
// OTHER OPERATIONS
// =============================================================
/**
* @dev Returns the message sender (defaults to `msg.sender`).
*
* If you are writing GSN compatible contracts, you need to override this function.
*/
function _msgSenderERC721A() internal view virtual returns (address) {
return msg.sender;
}
/**
* @dev Converts a uint256 to its ASCII string decimal representation.
*/
function _toString(uint256 value) internal pure virtual returns (string memory str) {
assembly {
// The maximum value of a uint256 contains 78 digits (1 byte per digit), but
// we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned.
// We will need 1 word for the trailing zeros padding, 1 word for the length,
// and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0.
let m := add(mload(0x40), 0xa0)
// Update the free memory pointer to allocate.
mstore(0x40, m)
// Assign the `str` to the end.
str := sub(m, 0x20)
// Zeroize the slot after the string.
mstore(str, 0)
// Cache the end of the memory to calculate the length later.
let end := str
// We write the string from rightmost digit to leftmost digit.
// The following is essentially a do-while loop that also handles the zero case.
// prettier-ignore
for { let temp := value } 1 {} {
str := sub(str, 1)
// Write the character to the pointer.
// The ASCII index of the '0' character is 48.
mstore8(str, add(48, mod(temp, 10)))
// Keep dividing `temp` until zero.
temp := div(temp, 10)
// prettier-ignore
if iszero(temp) { break }
}
let length := sub(end, str)
// Move the pointer 32 bytes leftwards to make room for the length.
str := sub(str, 0x20)
// Store the length.
mstore(str, length)
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library Math {
enum Rounding {
Down, // Toward negative infinity
Up, // Toward infinity
Zero // Toward zero
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds up instead
* of rounding down.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b - 1) / b can overflow on addition, so we distribute.
return a == 0 ? 0 : (a - 1) / b + 1;
}
/**
* @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
* @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
* with further edits by Uniswap Labs also under MIT license.
*/
function mulDiv(
uint256 x,
uint256 y,
uint256 denominator
) internal pure returns (uint256 result) {
unchecked {
// 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
// use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = prod1 * 2^256 + prod0.
uint256 prod0; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod0 := mul(x, y)
prod1 := sub(sub(mm, prod0), lt(mm, prod0))
}
// Handle non-overflow cases, 256 by 256 division.
if (prod1 == 0) {
return prod0 / denominator;
}
// Make sure the result is less than 2^256. Also prevents denominator == 0.
require(denominator > prod1);
///////////////////////////////////////////////
// 512 by 256 division.
///////////////////////////////////////////////
// Make division exact by subtracting the remainder from [prod1 prod0].
uint256 remainder;
assembly {
// Compute remainder using mulmod.
remainder := mulmod(x, y, denominator)
// Subtract 256 bit number from 512 bit number.
prod1 := sub(prod1, gt(remainder, prod0))
prod0 := sub(prod0, remainder)
}
// Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
// See https://cs.stackexchange.com/q/138556/92363.
// Does not overflow because the denominator cannot be zero at this stage in the function.
uint256 twos = denominator & (~denominator + 1);
assembly {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [prod1 prod0] by twos.
prod0 := div(prod0, twos)
// Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
twos := add(div(sub(0, twos), twos), 1)
}
// Shift in bits from prod1 into prod0.
prod0 |= prod1 * twos;
// Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
// that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv = 1 mod 2^4.
uint256 inverse = (3 * denominator) ^ 2;
// Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
// in modular arithmetic, doubling the correct bits in each step.
inverse *= 2 - denominator * inverse; // inverse mod 2^8
inverse *= 2 - denominator * inverse; // inverse mod 2^16
inverse *= 2 - denominator * inverse; // inverse mod 2^32
inverse *= 2 - denominator * inverse; // inverse mod 2^64
inverse *= 2 - denominator * inverse; // inverse mod 2^128
inverse *= 2 - denominator * inverse; // inverse mod 2^256
// Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
// This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
// less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
// is no longer required.
result = prod0 * inverse;
return result;
}
}
/**
* @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
*/
function mulDiv(
uint256 x,
uint256 y,
uint256 denominator,
Rounding rounding
) internal pure returns (uint256) {
uint256 result = mulDiv(x, y, denominator);
if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
result += 1;
}
return result;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
*
* Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
*/
function sqrt(uint256 a) internal pure returns (uint256) {
if (a == 0) {
return 0;
}
// For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
//
// We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
// `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
//
// This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
// → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
// → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
//
// Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
uint256 result = 1 << (log2(a) >> 1);
// At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
// since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
// every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
// into the expected uint128 result.
unchecked {
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
return min(result, a / result);
}
}
/**
* @notice Calculates sqrt(a), following the selected rounding direction.
*/
function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = sqrt(a);
return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
}
}
/**
* @dev Return the log in base 2, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 128;
}
if (value >> 64 > 0) {
value >>= 64;
result += 64;
}
if (value >> 32 > 0) {
value >>= 32;
result += 32;
}
if (value >> 16 > 0) {
value >>= 16;
result += 16;
}
if (value >> 8 > 0) {
value >>= 8;
result += 8;
}
if (value >> 4 > 0) {
value >>= 4;
result += 4;
}
if (value >> 2 > 0) {
value >>= 2;
result += 2;
}
if (value >> 1 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 2, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log2(value);
return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 10, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10**64) {
value /= 10**64;
result += 64;
}
if (value >= 10**32) {
value /= 10**32;
result += 32;
}
if (value >= 10**16) {
value /= 10**16;
result += 16;
}
if (value >= 10**8) {
value /= 10**8;
result += 8;
}
if (value >= 10**4) {
value /= 10**4;
result += 4;
}
if (value >= 10**2) {
value /= 10**2;
result += 2;
}
if (value >= 10**1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 256, rounded down, of a positive value.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 16;
}
if (value >> 64 > 0) {
value >>= 64;
result += 8;
}
if (value >> 32 > 0) {
value >>= 32;
result += 4;
}
if (value >> 16 > 0) {
value >>= 16;
result += 2;
}
if (value >> 8 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log256(value);
return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/cryptography/MerkleProof.sol)
pragma solidity ^0.8.0;
/**
* @dev These functions deal with verification of Merkle Tree proofs.
*
* The tree and the proofs can be generated using our
* https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
* You will find a quickstart guide in the readme.
*
* WARNING: You should avoid using leaf values that are 64 bytes long prior to
* hashing, or use a hash function other than keccak256 for hashing leaves.
* This is because the concatenation of a sorted pair of internal nodes in
* the merkle tree could be reinterpreted as a leaf value.
* OpenZeppelin's JavaScript library generates merkle trees that are safe
* against this attack out of the box.
*/
library MerkleProof {
/**
* @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
* defined by `root`. For this, a `proof` must be provided, containing
* sibling hashes on the branch from the leaf to the root of the tree. Each
* pair of leaves and each pair of pre-images are assumed to be sorted.
*/
function verify(
bytes32[] memory proof,
bytes32 root,
bytes32 leaf
) internal pure returns (bool) {
return processProof(proof, leaf) == root;
}
/**
* @dev Calldata version of {verify}
*
* _Available since v4.7._
*/
function verifyCalldata(
bytes32[] calldata proof,
bytes32 root,
bytes32 leaf
) internal pure returns (bool) {
return processProofCalldata(proof, leaf) == root;
}
/**
* @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
* from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
* hash matches the root of the tree. When processing the proof, the pairs
* of leafs & pre-images are assumed to be sorted.
*
* _Available since v4.4._
*/
function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {
bytes32 computedHash = leaf;
for (uint256 i = 0; i < proof.length; i++) {
computedHash = _hashPair(computedHash, proof[i]);
}
return computedHash;
}
/**
* @dev Calldata version of {processProof}
*
* _Available since v4.7._
*/
function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {
bytes32 computedHash = leaf;
for (uint256 i = 0; i < proof.length; i++) {
computedHash = _hashPair(computedHash, proof[i]);
}
return computedHash;
}
/**
* @dev Returns true if the `leaves` can be simultaneously proven to be a part of a merkle tree defined by
* `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
*
* CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.
*
* _Available since v4.7._
*/
function multiProofVerify(
bytes32[] memory proof,
bool[] memory proofFlags,
bytes32 root,
bytes32[] memory leaves
) internal pure returns (bool) {
return processMultiProof(proof, proofFlags, leaves) == root;
}
/**
* @dev Calldata version of {multiProofVerify}
*
* CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.
*
* _Available since v4.7._
*/
function multiProofVerifyCalldata(
bytes32[] calldata proof,
bool[] calldata proofFlags,
bytes32 root,
bytes32[] memory leaves
) internal pure returns (bool) {
return processMultiProofCalldata(proof, proofFlags, leaves) == root;
}
/**
* @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
* proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
* leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
* respectively.
*
* CAUTION: Not all merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
* is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
* tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
*
* _Available since v4.7._
*/
function processMultiProof(
bytes32[] memory proof,
bool[] memory proofFlags,
bytes32[] memory leaves
) internal pure returns (bytes32 merkleRoot) {
// This function rebuild the root hash by traversing the tree up from the leaves. The root is rebuilt by
// consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
// `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
// the merkle tree.
uint256 leavesLen = leaves.length;
uint256 totalHashes = proofFlags.length;
// Check proof validity.
require(leavesLen + proof.length - 1 == totalHashes, "MerkleProof: invalid multiproof");
// The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
// `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
bytes32[] memory hashes = new bytes32[](totalHashes);
uint256 leafPos = 0;
uint256 hashPos = 0;
uint256 proofPos = 0;
// At each step, we compute the next hash using two values:
// - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
// get the next hash.
// - depending on the flag, either another value for the "main queue" (merging branches) or an element from the
// `proof` array.
for (uint256 i = 0; i < totalHashes; i++) {
bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
bytes32 b = proofFlags[i] ? leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++] : proof[proofPos++];
hashes[i] = _hashPair(a, b);
}
if (totalHashes > 0) {
return hashes[totalHashes - 1];
} else if (leavesLen > 0) {
return leaves[0];
} else {
return proof[0];
}
}
/**
* @dev Calldata version of {processMultiProof}.
*
* CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.
*
* _Available since v4.7._
*/
function processMultiProofCalldata(
bytes32[] calldata proof,
bool[] calldata proofFlags,
bytes32[] memory leaves
) internal pure returns (bytes32 merkleRoot) {
// This function rebuild the root hash by traversing the tree up from the leaves. The root is rebuilt by
// consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
// `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
// the merkle tree.
uint256 leavesLen = leaves.length;
uint256 totalHashes = proofFlags.length;
// Check proof validity.
require(leavesLen + proof.length - 1 == totalHashes, "MerkleProof: invalid multiproof");
// The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
// `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
bytes32[] memory hashes = new bytes32[](totalHashes);
uint256 leafPos = 0;
uint256 hashPos = 0;
uint256 proofPos = 0;
// At each step, we compute the next hash using two values:
// - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
// get the next hash.
// - depending on the flag, either another value for the "main queue" (merging branches) or an element from the
// `proof` array.
for (uint256 i = 0; i < totalHashes; i++) {
bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
bytes32 b = proofFlags[i] ? leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++] : proof[proofPos++];
hashes[i] = _hashPair(a, b);
}
if (totalHashes > 0) {
return hashes[totalHashes - 1];
} else if (leavesLen > 0) {
return leaves[0];
} else {
return proof[0];
}
}
function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {
return a < b ? _efficientHash(a, b) : _efficientHash(b, a);
}
function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, a)
mstore(0x20, b)
value := keccak256(0x00, 0x40)
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/cryptography/ECDSA.sol)
pragma solidity ^0.8.0;
import "../Strings.sol";
/**
* @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
*
* These functions can be used to verify that a message was signed by the holder
* of the private keys of a given address.
*/
library ECDSA {
enum RecoverError {
NoError,
InvalidSignature,
InvalidSignatureLength,
InvalidSignatureS,
InvalidSignatureV // Deprecated in v4.8
}
function _throwError(RecoverError error) private pure {
if (error == RecoverError.NoError) {
return; // no error: do nothing
} else if (error == RecoverError.InvalidSignature) {
revert("ECDSA: invalid signature");
} else if (error == RecoverError.InvalidSignatureLength) {
revert("ECDSA: invalid signature length");
} else if (error == RecoverError.InvalidSignatureS) {
revert("ECDSA: invalid signature 's' value");
}
}
/**
* @dev Returns the address that signed a hashed message (`hash`) with
* `signature` or error string. This address can then be used for verification purposes.
*
* The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
* this function rejects them by requiring the `s` value to be in the lower
* half order, and the `v` value to be either 27 or 28.
*
* IMPORTANT: `hash` _must_ be the result of a hash operation for the
* verification to be secure: it is possible to craft signatures that
* recover to arbitrary addresses for non-hashed data. A safe way to ensure
* this is by receiving a hash of the original message (which may otherwise
* be too long), and then calling {toEthSignedMessageHash} on it.
*
* Documentation for signature generation:
* - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
* - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
*
* _Available since v4.3._
*/
function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
if (signature.length == 65) {
bytes32 r;
bytes32 s;
uint8 v;
// ecrecover takes the signature parameters, and the only way to get them
// currently is to use assembly.
/// @solidity memory-safe-assembly
assembly {
r := mload(add(signature, 0x20))
s := mload(add(signature, 0x40))
v := byte(0, mload(add(signature, 0x60)))
}
return tryRecover(hash, v, r, s);
} else {
return (address(0), RecoverError.InvalidSignatureLength);
}
}
/**
* @dev Returns the address that signed a hashed message (`hash`) with
* `signature`. This address can then be used for verification purposes.
*
* The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
* this function rejects them by requiring the `s` value to be in the lower
* half order, and the `v` value to be either 27 or 28.
*
* IMPORTANT: `hash` _must_ be the result of a hash operation for the
* verification to be secure: it is possible to craft signatures that
* recover to arbitrary addresses for non-hashed data. A safe way to ensure
* this is by receiving a hash of the original message (which may otherwise
* be too long), and then calling {toEthSignedMessageHash} on it.
*/
function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, signature);
_throwError(error);
return recovered;
}
/**
* @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
*
* See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
*
* _Available since v4.3._
*/
function tryRecover(
bytes32 hash,
bytes32 r,
bytes32 vs
) internal pure returns (address, RecoverError) {
bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
uint8 v = uint8((uint256(vs) >> 255) + 27);
return tryRecover(hash, v, r, s);
}
/**
* @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
*
* _Available since v4.2._
*/
function recover(
bytes32 hash,
bytes32 r,
bytes32 vs
) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, r, vs);
_throwError(error);
return recovered;
}
/**
* @dev Overload of {ECDSA-tryRecover} that receives the `v`,
* `r` and `s` signature fields separately.
*
* _Available since v4.3._
*/
function tryRecover(
bytes32 hash,
uint8 v,
bytes32 r,
bytes32 s
) internal pure returns (address, RecoverError) {
// EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
// unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
// the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
// signatures from current libraries generate a unique signature with an s-value in the lower half order.
//
// If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
// with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
// vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
// these malleable signatures as well.
if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
return (address(0), RecoverError.InvalidSignatureS);
}
// If the signature is valid (and not malleable), return the signer address
address signer = ecrecover(hash, v, r, s);
if (signer == address(0)) {
return (address(0), RecoverError.InvalidSignature);
}
return (signer, RecoverError.NoError);
}
/**
* @dev Overload of {ECDSA-recover} that receives the `v`,
* `r` and `s` signature fields separately.
*/
function recover(
bytes32 hash,
uint8 v,
bytes32 r,
bytes32 s
) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, v, r, s);
_throwError(error);
return recovered;
}
/**
* @dev Returns an Ethereum Signed Message, created from a `hash`. This
* produces hash corresponding to the one signed with the
* https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
* JSON-RPC method as part of EIP-191.
*
* See {recover}.
*/
function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
// 32 is the length in bytes of hash,
// enforced by the type signature above
return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash));
}
/**
* @dev Returns an Ethereum Signed Message, created from `s`. This
* produces hash corresponding to the one signed with the
* https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
* JSON-RPC method as part of EIP-191.
*
* See {recover}.
*/
function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", Strings.toString(s.length), s));
}
/**
* @dev Returns an Ethereum Signed Typed Data, created from a
* `domainSeparator` and a `structHash`. This produces hash corresponding
* to the one signed with the
* https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
* JSON-RPC method as part of EIP-712.
*
* See {recover}.
*/
function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash));
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)
pragma solidity ^0.8.0;
import "./math/Math.sol";
/**
* @dev String operations.
*/
library Strings {
bytes16 private constant _SYMBOLS = "0123456789abcdef";
uint8 private constant _ADDRESS_LENGTH = 20;
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = Math.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
/// @solidity memory-safe-assembly
assembly {
ptr := add(buffer, add(32, length))
}
while (true) {
ptr--;
/// @solidity memory-safe-assembly
assembly {
mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
}
value /= 10;
if (value == 0) break;
}
return buffer;
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
unchecked {
return toHexString(value, Math.log256(value) + 1);
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = _SYMBOLS[value & 0xf];
value >>= 4;
}
require(value == 0, "Strings: hex length insufficient");
return string(buffer);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
*/
function toHexString(address addr) internal pure returns (string memory) {
return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
pragma solidity ^0.8.0;
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value
) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) private pure {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)
pragma solidity ^0.8.0;
import "../utils/Context.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* By default, the owner account will be the one that deploys the contract. This
* can later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract Ownable is Context {
address private _owner;
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the deployer as the initial owner.
*/
constructor() {
_transferOwnership(_msgSender());
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
require(owner() == _msgSender(), "Ownable: caller is not the owner");
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions anymore. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby removing any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
require(newOwner != address(0), "Ownable: new owner is the zero address");
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
}{
"remappings": [],
"optimizer": {
"enabled": true,
"runs": 200
},
"evmVersion": "london",
"libraries": {},
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"address","name":"signer","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AccountNotListed","type":"error"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"ExceedsSupplyLimit","type":"error"},{"inputs":[],"name":"ExceedsWalletLimit","type":"error"},{"inputs":[],"name":"FourPackSoldOut","type":"error"},{"inputs":[],"name":"InvalidDenylistRegistry","type":"error"},{"inputs":[],"name":"InvalidPayment","type":"error"},{"inputs":[],"name":"InvalidQuantity","type":"error"},{"inputs":[],"name":"InvalidQueryRange","type":"error"},{"inputs":[],"name":"InvalidSaleState","type":"error"},{"inputs":[],"name":"MaxSupplyLowerThanTotalSupply","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"OperatorDenied","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"OperatorNotAllowed","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"SaleNotActive","type":"error"},{"inputs":[],"name":"SupplyGreaterThanExistingMax","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":"UnbalancedInputs","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":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"OPERATOR_FILTER_REGISTRY","outputs":[{"internalType":"contract IOperatorFilterRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"batchSize","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"config","outputs":[{"internalType":"uint64","name":"ethPrice","type":"uint64"},{"internalType":"uint16","name":"maxSupply","type":"uint16"},{"internalType":"enum DarkLabs.SaleState","name":"saleState","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint16","name":"quantity","type":"uint16"},{"internalType":"address","name":"recipient","type":"address"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"crossMint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"crossmintOperator","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"explicitOwnershipOf","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint64","name":"startTimestamp","type":"uint64"},{"internalType":"bool","name":"burned","type":"bool"},{"internalType":"uint24","name":"extraData","type":"uint24"}],"internalType":"struct IERC721A.TokenOwnership","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"explicitOwnershipsOf","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint64","name":"startTimestamp","type":"uint64"},{"internalType":"bool","name":"burned","type":"bool"},{"internalType":"uint24","name":"extraData","type":"uint24"}],"internalType":"struct IERC721A.TokenOwnership[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"fourPacks","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"isDelegate","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"isOSEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"merkleRoot","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint16","name":"quantity","type":"uint16"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"name":"mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint16[]","name":"quantity","type":"uint16[]"},{"internalType":"address[]","name":"recipient","type":"address[]"}],"name":"mintTo","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","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":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","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":"uint8","name":"newBatchSize","type":"uint8"}],"name":"setBatchSize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint64","name":"ethPrice","type":"uint64"},{"internalType":"uint16","name":"maxSupply","type":"uint16"},{"internalType":"enum DarkLabs.SaleState","name":"saleState","type":"uint8"}],"internalType":"struct DarkLabs.MintConfig","name":"newConfig","type":"tuple"}],"name":"setConfig","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"setCrossmint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"bool","name":"isDelegate_","type":"bool"}],"name":"setDelegate","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"merkleRoot_","type":"bytes32"}],"name":"setMerkleRoot","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"signer","type":"address"}],"name":"setSigner","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"tokensOfOwner","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"start","type":"uint256"},{"internalType":"uint256","name":"stop","type":"uint256"}],"name":"tokensOfOwnerIn","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
6000600a819055670de0b6b3a764000060805261036b60a05260c052600c80546001600160581b03191669036b0de0b6b3a7640000179055600d8054615f0461ffff19909116179055610160604052604460e0818152906200351b6101003980516200007491600e91602090910190620003f8565b50600f80546001600160a81b03191674dab1a1854214684ace522439684a145e6250523301179055348015620000a957600080fd5b506040516200355f3803806200355f833981016040819052620000cc916200049e565b80733cc6cdda760b79bafa08df41ecfa224f810dceb66001604051806040016040528060098152602001684461726b204c61627360b81b81525060405180604001604052806002815260200161111360f21b815250816002908051906020019062000139929190620003f8565b5080516200014f906003906020840190620003f8565b50600160005550506daaeb6d7670e522a718067333cd4e3b156200029c578015620001ea57604051633e9f1edf60e11b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e90637d3e3dbe906044015b600060405180830381600087803b158015620001cb57600080fd5b505af1158015620001e0573d6000803e3d6000fd5b505050506200029c565b6001600160a01b038216156200023b5760405163a0af290360e01b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e9063a0af290390604401620001b0565b604051632210724360e11b81523060048201526daaeb6d7670e522a718067333cd4e90634420e48690602401600060405180830381600087803b1580156200028257600080fd5b505af115801562000297573d6000803e3d6000fd5b505050505b50620002aa90503362000310565b620002c9620002c16008546001600160a01b031690565b600162000362565b600b80546001600160a01b0319166001600160a01b03831617905550507fc0fcbef69c7c199eaf8c0d30b78a648fc01bc7f75505a76ea0371c082b7bf274600a556200050c565b600880546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6200036c62000397565b6001600160a01b03919091166000908152600960205260409020805460ff1916911515919091179055565b6008546001600160a01b03163314620003f65760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640160405180910390fd5b565b8280546200040690620004d0565b90600052602060002090601f0160209004810192826200042a576000855562000475565b82601f106200044557805160ff191683800117855562000475565b8280016001018555821562000475579182015b828111156200047557825182559160200191906001019062000458565b506200048392915062000487565b5090565b5b8082111562000483576000815560010162000488565b600060208284031215620004b157600080fd5b81516001600160a01b0381168114620004c957600080fd5b9392505050565b600181811c90821680620004e557607f821691505b6020821081036200050657634e487b7160e01b600052602260045260246000fd5b50919050565b612fff806200051c6000396000f3fe6080604052600436106102465760003560e01c80636352211e1161013957806399a2557a116100b6578063c87b56dd1161007a578063c87b56dd146106cf578063da41bfe1146106ef578063e0a912bb14610702578063e985e9c514610715578063f2fde38b1461075e578063f4daaba11461077e57600080fd5b806399a2557a1461063c578063a22cb4651461065c578063ae7bf4c81461067c578063b88d4fde1461068f578063c23dc68f146106a257600080fd5b806379502c55116100fd57806379502c55146105755780637cb64759146105bc5780638462151c146105dc5780638da5cb5b1461060957806395d89b411461062757600080fd5b80636352211e146104eb5780636c0360eb1461050b5780636c19e7831461052057806370a0823114610540578063715018a61461056057600080fd5b806323b872dd116101c757806342842e0e1161018b57806342842e0e1461044b5780634a994eef1461045e57806355f804b31461047e5780635bbb21771461049e5780636091f4f2146104cb57600080fd5b806323b872dd146103cb5780632eb4a7ab146103de5780633ccfd60b146103f45780633cd1ec4d1461040957806341f434341461042957600080fd5b80630d3c721a1161020e5780630d3c721a1461030f5780631434d0c21461034057806318160ddd146103605780631be03c101461038c5780631c812a43146103b157600080fd5b806301ffc9a71461024b57806306fdde031461028057806307779627146102a2578063081812fc146102c2578063095ea7b3146102fa575b600080fd5b34801561025757600080fd5b5061026b6102663660046125c8565b610798565b60405190151581526020015b60405180910390f35b34801561028c57600080fd5b506102956107a9565b604051610277919061263d565b3480156102ae57600080fd5b5061026b6102bd366004612667565b61083b565b3480156102ce57600080fd5b506102e26102dd366004612682565b610868565b6040516001600160a01b039091168152602001610277565b61030d61030836600461269b565b6108ac565b005b34801561031b57600080fd5b50600d5461032e90610100900460ff1681565b60405160ff9091168152602001610277565b34801561034c57600080fd5b5061030d61035b3660046126c5565b6108d1565b34801561036c57600080fd5b5061037e600154600054036000190190565b604051908152602001610277565b34801561039857600080fd5b50600f546102e29061010090046001600160a01b031681565b3480156103bd57600080fd5b50600f5461026b9060ff1681565b61030d6103d93660046126e8565b61091f565b3480156103ea57600080fd5b5061037e600a5481565b34801561040057600080fd5b5061030d6109cc565b34801561041557600080fd5b5061030d610424366004612724565b6109f1565b34801561043557600080fd5b506102e26daaeb6d7670e522a718067333cd4e81565b61030d6104593660046126e8565b610af6565b34801561046a57600080fd5b5061030d61047936600461274a565b610b2c565b34801561048a57600080fd5b5061030d610499366004612781565b610b5f565b3480156104aa57600080fd5b506104be6104b9366004612836565b610b73565b60405161027791906128b3565b3480156104d757600080fd5b5061030d6104e6366004612667565b610c3e565b3480156104f757600080fd5b506102e2610506366004612682565b610c95565b34801561051757600080fd5b50610295610ca0565b34801561052c57600080fd5b5061030d61053b366004612667565b610d2e565b34801561054c57600080fd5b5061037e61055b366004612667565b610d7e565b34801561056c57600080fd5b5061030d610dcc565b34801561058157600080fd5b50600c546105ad906001600160401b03811690600160401b810461ffff1690600160501b900460ff1683565b6040516102779392919061290b565b3480156105c857600080fd5b5061030d6105d7366004612682565b610dde565b3480156105e857600080fd5b506105fc6105f7366004612667565b610e12565b6040516102779190612951565b34801561061557600080fd5b506008546001600160a01b03166102e2565b34801561063357600080fd5b50610295610f1a565b34801561064857600080fd5b506105fc610657366004612989565b610f29565b34801561066857600080fd5b5061030d61067736600461274a565b6110b0565b61030d61068a3660046129bc565b6110d0565b61030d61069d366004612ac9565b611239565b3480156106ae57600080fd5b506106c26106bd366004612682565b611277565b6040516102779190612b30565b3480156106db57600080fd5b506102956106ea366004612682565b6112ff565b61030d6106fd366004612b4e565b611383565b61030d610710366004612ba2565b6114b4565b34801561072157600080fd5b5061026b610730366004612c01565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b34801561076a57600080fd5b5061030d610779366004612667565b6115c3565b34801561078a57600080fd5b50600d5461032e9060ff1681565b60006107a3826115df565b92915050565b6060600280546107b890612c34565b80601f01602080910402602001604051908101604052809291908181526020018280546107e490612c34565b80156108315780601f1061080657610100808354040283529160200191610831565b820191906000526020600020905b81548152906001019060200180831161081457829003601f168201915b5050505050905090565b600061084561162d565b506001600160a01b03811660009081526009602052604090205460ff165b919050565b600061087382611687565b610890576040516333d1c03960e21b815260040160405180910390fd5b506000908152600660205260409020546001600160a01b031690565b600f54829060ff16156108c2576108c2816116bc565b6108cc8383611775565b505050565b3360009081526009602052604090205460ff166109095760405162461bcd60e51b815260040161090090612c68565b60405180910390fd5b600d805460ff191660ff92909216919091179055565b600f54839060ff16801561093c57506001600160a01b0381163314155b1561094a5761094a336116bc565b600061095583611815565b6060015162ffffff1611156109bb5760405162461bcd60e51b815260206004820152602660248201527f507269766174652073616c6520746f6b656e732074656d706f726172696c79206044820152651b1bd8dad95960d21b6064820152608401610900565b6109c6848484611851565b50505050565b6109d461162d565b6109ef6109e96008546001600160a01b031690565b476119e6565b565b3360009081526009602052604090205460ff16610a205760405162461bcd60e51b815260040161090090612c68565b610a31600154600054036000190190565b610a416040830160208401612c92565b61ffff161015610a6357604051629323df60e01b815260040160405180910390fd5b600c54600160401b900461ffff16610a816040830160208401612c92565b61ffff161115610aa45760405163bcb4ad3960e01b815260040160405180910390fd5b6001610ab66060830160408401612cbc565b6001811115610ac757610ac76128f5565b60ff161115610ae957604051633482502f60e01b815260040160405180910390fd5b80600c6108cc8282612cd9565b600f54839060ff168015610b1357506001600160a01b0381163314155b15610b2157610b21336116bc565b6109c6848484611aff565b610b3461162d565b6001600160a01b03919091166000908152600960205260409020805460ff1916911515919091179055565b610b6761162d565b6108cc600e8383612519565b6060816000816001600160401b03811115610b9057610b90612a27565b604051908082528060200260200182016040528015610be257816020015b604080516080810182526000808252602080830182905292820181905260608201528252600019909201910181610bae5790505b50905060005b828114610c3557610c10868683818110610c0457610c04612d8a565b90506020020135611277565b828281518110610c2257610c22612d8a565b6020908102919091010152600101610be8565b50949350505050565b3360009081526009602052604090205460ff16610c6d5760405162461bcd60e51b815260040161090090612c68565b600f80546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b60006107a382611b1a565b600e8054610cad90612c34565b80601f0160208091040260200160405190810160405280929190818152602001828054610cd990612c34565b8015610d265780601f10610cfb57610100808354040283529160200191610d26565b820191906000526020600020905b815481529060010190602001808311610d0957829003601f168201915b505050505081565b3360009081526009602052604090205460ff16610d5d5760405162461bcd60e51b815260040161090090612c68565b600b80546001600160a01b0319166001600160a01b03831617905550565b50565b60006001600160a01b038216610da7576040516323d3ad8160e21b815260040160405180910390fd5b506001600160a01b03166000908152600560205260409020546001600160401b031690565b610dd461162d565b6109ef6000611b89565b3360009081526009602052604090205460ff16610e0d5760405162461bcd60e51b815260040161090090612c68565b600a55565b60606000806000610e2285610d7e565b90506000816001600160401b03811115610e3e57610e3e612a27565b604051908082528060200260200182016040528015610e67578160200160208202803683370190505b509050610e9460408051608081018252600080825260208201819052918101829052606081019190915290565b60015b838614610f0e57610ea781611815565b91508160400151610f065781516001600160a01b031615610ec757815194505b876001600160a01b0316856001600160a01b031603610f065780838780600101985081518110610ef957610ef9612d8a565b6020026020010181815250505b600101610e97565b50909695505050505050565b6060600380546107b890612c34565b6060818310610f4b57604051631960ccad60e11b815260040160405180910390fd5b600080610f5760005490565b90506001851015610f6757600194505b80841115610f73578093505b6000610f7e87610d7e565b905084861015610f9d5785850381811015610f97578091505b50610fa1565b5060005b6000816001600160401b03811115610fbb57610fbb612a27565b604051908082528060200260200182016040528015610fe4578160200160208202803683370190505b50905081600003610ffa5793506110a992505050565b600061100588611277565b905060008160400151611016575080515b885b8881141580156110285750848714155b1561109d5761103681611815565b925082604001516110955782516001600160a01b03161561105657825191505b8a6001600160a01b0316826001600160a01b031603611095578084888060010199508151811061108857611088612d8a565b6020026020010181815250505b600101611018565b50505092835250909150505b9392505050565b600f54829060ff16156110c6576110c6816116bc565b6108cc8383611bdb565b3360009081526009602052604090205460ff166110ff5760405162461bcd60e51b815260040161090090612c68565b82811461111f576040516312674e4f60e31b815260040160405180910390fd5b6000805b848110156111725785858281811061113d5761113d612d8a565b90506020020160208101906111529190612c92565b6111609061ffff1683612db6565b915061116b81612dce565b9050611123565b50600c54600160401b900461ffff1681611193600154600054036000190190565b61119d9190612db6565b11156111bc57604051630341a76560e21b815260040160405180910390fd5b60005b82811015611231576112218484838181106111dc576111dc612d8a565b90506020020160208101906111f19190612667565b87878481811061120357611203612d8a565b90506020020160208101906112189190612c92565b61ffff16611c47565b61122a81612dce565b90506111bf565b505050505050565b600f54849060ff16801561125657506001600160a01b0381163314155b1561126457611264336116bc565b61127085858585611c90565b5050505050565b60408051608081018252600080825260208201819052918101829052606081019190915260408051608081018252600080825260208201819052918101829052606081019190915260018310806112d057506000548310155b156112db5792915050565b6112e483611815565b90508060400151156112f65792915050565b6110a983611cd4565b606061130a82611687565b61132757604051630a14c4b560e41b815260040160405180910390fd5b600e805461133490612c34565b905060000361135257604051806020016040528060008152506107a3565b600e61135d83611d09565b60405160200161136e929190612e03565b60405160208183030381529060405292915050565b6040516bffffffffffffffffffffffff193360601b1660208201526113f49060340160405160208183030381529060405280519060200120838380806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250611d4d92505050565b611411576040516311f4c44b60e21b815260040160405180910390fd5b8261ffff16600103611428576108cc600133611d64565b8261ffff1660040361149b57600d54610100900460ff1660000361145f576040516313cec9c560e01b815260040160405180910390fd5b600d8054610100900460ff1690600161147783612ea9565b91906101000a81548160ff021916908360ff160217905550506108cc600433611d64565b60405163524f409b60e01b815260040160405180910390fd5b600f5461010090046001600160a01b031633146114e45760405163026862e360e21b815260040160405180910390fd5b6040516bffffffffffffffffffffffff19606084901b16602082015261151c9060340160405160208183030381529060405282611ecd565b611539576040516311f4c44b60e21b815260040160405180910390fd5b8261ffff16600103611550576108cc600183611d64565b8261ffff1660040361149b57600d54610100900460ff16600003611587576040516313cec9c560e01b815260040160405180910390fd5b600d8054610100900460ff1690600161159f83612ea9565b91906101000a81548160ff021916908360ff160217905550506108cc600483611d64565b6115cb61162d565b6115d6816001610b2c565b610d7b81611f04565b60006301ffc9a760e01b6001600160e01b03198316148061161057506380ac58cd60e01b6001600160e01b03198316145b806107a35750506001600160e01b031916635b5e139f60e01b1490565b6008546001600160a01b031633146109ef5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610900565b60008160011115801561169b575060005482105b80156107a3575050600090815260046020526040902054600160e01b161590565b6daaeb6d7670e522a718067333cd4e3b15610d7b57604051633185c44d60e21b81523060048201526001600160a01b03821660248201526daaeb6d7670e522a718067333cd4e9063c617113490604401602060405180830381865afa158015611729573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061174d9190612ec6565b610d7b57604051633b79c77360e21b81526001600160a01b0382166004820152602401610900565b600061178082610c95565b9050336001600160a01b038216146117b95761179c8133610730565b6117b9576040516367d9dca160e11b815260040160405180910390fd5b60008281526006602052604080822080546001600160a01b0319166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b6040805160808101825260008082526020820181905291810182905260608101919091526000828152600460205260409020546107a390611f7a565b600061185c82611b1a565b9050836001600160a01b0316816001600160a01b03161461188f5760405162a1148160e81b815260040160405180910390fd5b60008281526006602052604090208054338082146001600160a01b038816909114176118dc576118bf8633610730565b6118dc57604051632ce44b5f60e11b815260040160405180910390fd5b6001600160a01b03851661190357604051633a954ecd60e21b815260040160405180910390fd5b801561190e57600082555b6001600160a01b038681166000908152600560205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260046020526040812091909155600160e11b841690036119a05760018401600081815260046020526040812054900361199e57600054811461199e5760008181526004602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4611231565b80471015611a365760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e63650000006044820152606401610900565b6000826001600160a01b03168260405160006040518083038185875af1925050503d8060008114611a83576040519150601f19603f3d011682016040523d82523d6000602084013e611a88565b606091505b50509050806108cc5760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d617920686176652072657665727465640000000000006064820152608401610900565b6108cc83838360405180602001604052806000815250611239565b60008180600111611b7057600054811015611b705760008181526004602052604081205490600160e01b82169003611b6e575b806000036110a9575060001901600081815260046020526040902054611b4d565b505b604051636f96cda160e11b815260040160405180910390fd5b600880546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b3360008181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b8015611c8c57600d5460ff16811115611c8257600d54611c6b90839060ff16611fc1565b600d54611c7b9060ff1682612ee3565b9050611c47565b611c8c8282611fc1565b5050565b611c9b84848461091f565b6001600160a01b0383163b156109c657611cb7848484846120bf565b6109c6576040516368d2bf6b60e11b815260040160405180910390fd5b6040805160808101825260008082526020820181905291810182905260608101919091526107a3611d0483611b1a565b611f7a565b606060a06040510180604052602081039150506000815280825b600183039250600a81066030018353600a900480611d235750819003601f19909101908152919050565b6000600a54611d5c83856121aa565b149392505050565b60408051606081018252600c80546001600160401b0381168352600160401b810461ffff166020840152600093830190600160501b900460ff166001811115611daf57611daf6128f5565b6001811115611dc057611dc06128f5565b9052509050600181604001516001811115611ddd57611ddd6128f5565b14611dfb5760405163b7b2409760e01b815260040160405180910390fd5b8051611e0b9061ffff8516612efa565b6001600160401b03163414611e335760405163078d696560e31b815260040160405180910390fd5b6001600160a01b038216600090815260056020526040808220546001600160401b03911c161115611e7757604051635107dbe760e01b815260040160405180910390fd5b806020015161ffff168361ffff16611e96600154600054036000190190565b611ea09190612db6565b1115611ebf57604051630341a76560e21b815260040160405180910390fd5b6108cc828461ffff16611c47565b600080611ee2611edc856121f7565b8461222b565b9050611efc81600b546001600160a01b0391821691161490565b949350505050565b611f0c61162d565b6001600160a01b038116611f715760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610900565b610d7b81611b89565b604080516080810182526001600160a01b038316815260a083901c6001600160401b03166020820152600160e01b831615159181019190915260e89190911c606082015290565b6000805490829003611fe65760405163b562e8dd60e01b815260040160405180910390fd5b6001600160a01b03831660008181526005602090815260408083208054680100000000000000018802019055848352600490915281206001851460e11b4260a01b178317905582840190839083907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a4600183015b81811461209557808360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600080a460010161205d565b50816000036120b657604051622e076360e81b815260040160405180910390fd5b60005550505050565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a02906120f4903390899088908890600401612f29565b6020604051808303816000875af192505050801561212f575060408051601f3d908101601f1916820190925261212c91810190612f66565b60015b61218d573d80801561215d576040519150601f19603f3d011682016040523d82523d6000602084013e612162565b606091505b508051600003612185576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050949350505050565b600081815b84518110156121ef576121db828683815181106121ce576121ce612d8a565b6020026020010151612240565b9150806121e781612dce565b9150506121af565b509392505050565b600030338360405160200161220e93929190612f83565b604051602081830303815290604052805190602001209050919050565b60006110a98261223a8561226f565b906122aa565b600081831061225c5760008281526020849052604090206110a9565b60008381526020839052604090206110a9565b6040517f19457468657265756d205369676e6564204d6573736167653a0a3332000000006020820152603c8101829052600090605c0161220e565b60008060006122b985856122c6565b915091506121ef8161230b565b60008082516041036122fc5760208301516040840151606085015160001a6122f087828585612455565b94509450505050612304565b506000905060025b9250929050565b600081600481111561231f5761231f6128f5565b036123275750565b600181600481111561233b5761233b6128f5565b036123885760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e617475726500000000000000006044820152606401610900565b600281600481111561239c5761239c6128f5565b036123e95760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e677468006044820152606401610900565b60038160048111156123fd576123fd6128f5565b03610d7b5760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c604482015261756560f01b6064820152608401610900565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083111561248c5750600090506003612510565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa1580156124e0573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b03811661250957600060019250925050612510565b9150600090505b94509492505050565b82805461252590612c34565b90600052602060002090601f016020900481019282612547576000855561258d565b82601f106125605782800160ff1982351617855561258d565b8280016001018555821561258d579182015b8281111561258d578235825591602001919060010190612572565b5061259992915061259d565b5090565b5b80821115612599576000815560010161259e565b6001600160e01b031981168114610d7b57600080fd5b6000602082840312156125da57600080fd5b81356110a9816125b2565b60005b838110156126005781810151838201526020016125e8565b838111156109c65750506000910152565b600081518084526126298160208601602086016125e5565b601f01601f19169290920160200192915050565b6020815260006110a96020830184612611565b80356001600160a01b038116811461086357600080fd5b60006020828403121561267957600080fd5b6110a982612650565b60006020828403121561269457600080fd5b5035919050565b600080604083850312156126ae57600080fd5b6126b783612650565b946020939093013593505050565b6000602082840312156126d757600080fd5b813560ff811681146110a957600080fd5b6000806000606084860312156126fd57600080fd5b61270684612650565b925061271460208501612650565b9150604084013590509250925092565b60006060828403121561273657600080fd5b50919050565b8015158114610d7b57600080fd5b6000806040838503121561275d57600080fd5b61276683612650565b915060208301356127768161273c565b809150509250929050565b6000806020838503121561279457600080fd5b82356001600160401b03808211156127ab57600080fd5b818501915085601f8301126127bf57600080fd5b8135818111156127ce57600080fd5b8660208285010111156127e057600080fd5b60209290920196919550909350505050565b60008083601f84011261280457600080fd5b5081356001600160401b0381111561281b57600080fd5b6020830191508360208260051b850101111561230457600080fd5b6000806020838503121561284957600080fd5b82356001600160401b0381111561285f57600080fd5b61286b858286016127f2565b90969095509350505050565b80516001600160a01b031682526020808201516001600160401b03169083015260408082015115159083015260609081015162ffffff16910152565b6020808252825182820181905260009190848201906040850190845b81811015610f0e576128e2838551612877565b92840192608092909201916001016128cf565b634e487b7160e01b600052602160045260246000fd5b6001600160401b038416815261ffff83166020820152606081016002831061294357634e487b7160e01b600052602160045260246000fd5b826040830152949350505050565b6020808252825182820181905260009190848201906040850190845b81811015610f0e5783518352928401929184019160010161296d565b60008060006060848603121561299e57600080fd5b6129a784612650565b95602085013595506040909401359392505050565b600080600080604085870312156129d257600080fd5b84356001600160401b03808211156129e957600080fd5b6129f5888389016127f2565b90965094506020870135915080821115612a0e57600080fd5b50612a1b878288016127f2565b95989497509550505050565b634e487b7160e01b600052604160045260246000fd5b600082601f830112612a4e57600080fd5b81356001600160401b0380821115612a6857612a68612a27565b604051601f8301601f19908116603f01168101908282118183101715612a9057612a90612a27565b81604052838152866020858801011115612aa957600080fd5b836020870160208301376000602085830101528094505050505092915050565b60008060008060808587031215612adf57600080fd5b612ae885612650565b9350612af660208601612650565b92506040850135915060608501356001600160401b03811115612b1857600080fd5b612b2487828801612a3d565b91505092959194509250565b608081016107a38284612877565b61ffff81168114610d7b57600080fd5b600080600060408486031215612b6357600080fd5b8335612b6e81612b3e565b925060208401356001600160401b03811115612b8957600080fd5b612b95868287016127f2565b9497909650939450505050565b600080600060608486031215612bb757600080fd5b8335612bc281612b3e565b9250612bd060208501612650565b915060408401356001600160401b03811115612beb57600080fd5b612bf786828701612a3d565b9150509250925092565b60008060408385031215612c1457600080fd5b612c1d83612650565b9150612c2b60208401612650565b90509250929050565b600181811c90821680612c4857607f821691505b60208210810361273657634e487b7160e01b600052602260045260246000fd5b60208082526010908201526f496e76616c69642064656c656761746560801b604082015260600190565b600060208284031215612ca457600080fd5b81356110a981612b3e565b60028110610d7b57600080fd5b600060208284031215612cce57600080fd5b81356110a981612caf565b81356001600160401b038116808214612cf157600080fd5b825467ffffffffffffffff1981168217845591506020840135612d1381612b3e565b69ffff0000000000000000604091821b1669ffffffffffffffffffff19841683178117855590850135612d4581612caf565b60028110612d6357634e487b7160e01b600052602160045260246000fd5b6affffffffffffffffffffff19939093169091171760509190911b60ff60501b1617905550565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60008219821115612dc957612dc9612da0565b500190565b600060018201612de057612de0612da0565b5060010190565b60008151612df98185602086016125e5565b9290920192915050565b600080845481600182811c915080831680612e1f57607f831692505b60208084108203612e3e57634e487b7160e01b86526022600452602486fd5b818015612e525760018114612e6357612e90565b60ff19861689528489019650612e90565b60008b81526020902060005b86811015612e885781548b820152908501908301612e6f565b505084890196505b505050505050612ea08185612de7565b95945050505050565b600060ff821680612ebc57612ebc612da0565b6000190192915050565b600060208284031215612ed857600080fd5b81516110a98161273c565b600082821015612ef557612ef5612da0565b500390565b60006001600160401b0380831681851681830481118215151615612f2057612f20612da0565b02949350505050565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090612f5c90830184612611565b9695505050505050565b600060208284031215612f7857600080fd5b81516110a9816125b2565b60006bffffffffffffffffffffffff19808660601b168352808560601b166014840152508251612fba8160288501602087016125e5565b9190910160280194935050505056fea26469706673582212209532bc61e04c34200f79647bb35d6cac81bafb83c6962694feb8294603e6cbe164736f6c634300080d003368747470733a2f2f697066732e696f2f697066732f516d593235443531645139507a35765435745235674d5a384243785731797a4342424a31504264785a35785050643f000000000000000000000000243eed63b365f896b21ba837ad3fbdb2c2ef518f
Deployed Bytecode
0x6080604052600436106102465760003560e01c80636352211e1161013957806399a2557a116100b6578063c87b56dd1161007a578063c87b56dd146106cf578063da41bfe1146106ef578063e0a912bb14610702578063e985e9c514610715578063f2fde38b1461075e578063f4daaba11461077e57600080fd5b806399a2557a1461063c578063a22cb4651461065c578063ae7bf4c81461067c578063b88d4fde1461068f578063c23dc68f146106a257600080fd5b806379502c55116100fd57806379502c55146105755780637cb64759146105bc5780638462151c146105dc5780638da5cb5b1461060957806395d89b411461062757600080fd5b80636352211e146104eb5780636c0360eb1461050b5780636c19e7831461052057806370a0823114610540578063715018a61461056057600080fd5b806323b872dd116101c757806342842e0e1161018b57806342842e0e1461044b5780634a994eef1461045e57806355f804b31461047e5780635bbb21771461049e5780636091f4f2146104cb57600080fd5b806323b872dd146103cb5780632eb4a7ab146103de5780633ccfd60b146103f45780633cd1ec4d1461040957806341f434341461042957600080fd5b80630d3c721a1161020e5780630d3c721a1461030f5780631434d0c21461034057806318160ddd146103605780631be03c101461038c5780631c812a43146103b157600080fd5b806301ffc9a71461024b57806306fdde031461028057806307779627146102a2578063081812fc146102c2578063095ea7b3146102fa575b600080fd5b34801561025757600080fd5b5061026b6102663660046125c8565b610798565b60405190151581526020015b60405180910390f35b34801561028c57600080fd5b506102956107a9565b604051610277919061263d565b3480156102ae57600080fd5b5061026b6102bd366004612667565b61083b565b3480156102ce57600080fd5b506102e26102dd366004612682565b610868565b6040516001600160a01b039091168152602001610277565b61030d61030836600461269b565b6108ac565b005b34801561031b57600080fd5b50600d5461032e90610100900460ff1681565b60405160ff9091168152602001610277565b34801561034c57600080fd5b5061030d61035b3660046126c5565b6108d1565b34801561036c57600080fd5b5061037e600154600054036000190190565b604051908152602001610277565b34801561039857600080fd5b50600f546102e29061010090046001600160a01b031681565b3480156103bd57600080fd5b50600f5461026b9060ff1681565b61030d6103d93660046126e8565b61091f565b3480156103ea57600080fd5b5061037e600a5481565b34801561040057600080fd5b5061030d6109cc565b34801561041557600080fd5b5061030d610424366004612724565b6109f1565b34801561043557600080fd5b506102e26daaeb6d7670e522a718067333cd4e81565b61030d6104593660046126e8565b610af6565b34801561046a57600080fd5b5061030d61047936600461274a565b610b2c565b34801561048a57600080fd5b5061030d610499366004612781565b610b5f565b3480156104aa57600080fd5b506104be6104b9366004612836565b610b73565b60405161027791906128b3565b3480156104d757600080fd5b5061030d6104e6366004612667565b610c3e565b3480156104f757600080fd5b506102e2610506366004612682565b610c95565b34801561051757600080fd5b50610295610ca0565b34801561052c57600080fd5b5061030d61053b366004612667565b610d2e565b34801561054c57600080fd5b5061037e61055b366004612667565b610d7e565b34801561056c57600080fd5b5061030d610dcc565b34801561058157600080fd5b50600c546105ad906001600160401b03811690600160401b810461ffff1690600160501b900460ff1683565b6040516102779392919061290b565b3480156105c857600080fd5b5061030d6105d7366004612682565b610dde565b3480156105e857600080fd5b506105fc6105f7366004612667565b610e12565b6040516102779190612951565b34801561061557600080fd5b506008546001600160a01b03166102e2565b34801561063357600080fd5b50610295610f1a565b34801561064857600080fd5b506105fc610657366004612989565b610f29565b34801561066857600080fd5b5061030d61067736600461274a565b6110b0565b61030d61068a3660046129bc565b6110d0565b61030d61069d366004612ac9565b611239565b3480156106ae57600080fd5b506106c26106bd366004612682565b611277565b6040516102779190612b30565b3480156106db57600080fd5b506102956106ea366004612682565b6112ff565b61030d6106fd366004612b4e565b611383565b61030d610710366004612ba2565b6114b4565b34801561072157600080fd5b5061026b610730366004612c01565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b34801561076a57600080fd5b5061030d610779366004612667565b6115c3565b34801561078a57600080fd5b50600d5461032e9060ff1681565b60006107a3826115df565b92915050565b6060600280546107b890612c34565b80601f01602080910402602001604051908101604052809291908181526020018280546107e490612c34565b80156108315780601f1061080657610100808354040283529160200191610831565b820191906000526020600020905b81548152906001019060200180831161081457829003601f168201915b5050505050905090565b600061084561162d565b506001600160a01b03811660009081526009602052604090205460ff165b919050565b600061087382611687565b610890576040516333d1c03960e21b815260040160405180910390fd5b506000908152600660205260409020546001600160a01b031690565b600f54829060ff16156108c2576108c2816116bc565b6108cc8383611775565b505050565b3360009081526009602052604090205460ff166109095760405162461bcd60e51b815260040161090090612c68565b60405180910390fd5b600d805460ff191660ff92909216919091179055565b600f54839060ff16801561093c57506001600160a01b0381163314155b1561094a5761094a336116bc565b600061095583611815565b6060015162ffffff1611156109bb5760405162461bcd60e51b815260206004820152602660248201527f507269766174652073616c6520746f6b656e732074656d706f726172696c79206044820152651b1bd8dad95960d21b6064820152608401610900565b6109c6848484611851565b50505050565b6109d461162d565b6109ef6109e96008546001600160a01b031690565b476119e6565b565b3360009081526009602052604090205460ff16610a205760405162461bcd60e51b815260040161090090612c68565b610a31600154600054036000190190565b610a416040830160208401612c92565b61ffff161015610a6357604051629323df60e01b815260040160405180910390fd5b600c54600160401b900461ffff16610a816040830160208401612c92565b61ffff161115610aa45760405163bcb4ad3960e01b815260040160405180910390fd5b6001610ab66060830160408401612cbc565b6001811115610ac757610ac76128f5565b60ff161115610ae957604051633482502f60e01b815260040160405180910390fd5b80600c6108cc8282612cd9565b600f54839060ff168015610b1357506001600160a01b0381163314155b15610b2157610b21336116bc565b6109c6848484611aff565b610b3461162d565b6001600160a01b03919091166000908152600960205260409020805460ff1916911515919091179055565b610b6761162d565b6108cc600e8383612519565b6060816000816001600160401b03811115610b9057610b90612a27565b604051908082528060200260200182016040528015610be257816020015b604080516080810182526000808252602080830182905292820181905260608201528252600019909201910181610bae5790505b50905060005b828114610c3557610c10868683818110610c0457610c04612d8a565b90506020020135611277565b828281518110610c2257610c22612d8a565b6020908102919091010152600101610be8565b50949350505050565b3360009081526009602052604090205460ff16610c6d5760405162461bcd60e51b815260040161090090612c68565b600f80546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b60006107a382611b1a565b600e8054610cad90612c34565b80601f0160208091040260200160405190810160405280929190818152602001828054610cd990612c34565b8015610d265780601f10610cfb57610100808354040283529160200191610d26565b820191906000526020600020905b815481529060010190602001808311610d0957829003601f168201915b505050505081565b3360009081526009602052604090205460ff16610d5d5760405162461bcd60e51b815260040161090090612c68565b600b80546001600160a01b0319166001600160a01b03831617905550565b50565b60006001600160a01b038216610da7576040516323d3ad8160e21b815260040160405180910390fd5b506001600160a01b03166000908152600560205260409020546001600160401b031690565b610dd461162d565b6109ef6000611b89565b3360009081526009602052604090205460ff16610e0d5760405162461bcd60e51b815260040161090090612c68565b600a55565b60606000806000610e2285610d7e565b90506000816001600160401b03811115610e3e57610e3e612a27565b604051908082528060200260200182016040528015610e67578160200160208202803683370190505b509050610e9460408051608081018252600080825260208201819052918101829052606081019190915290565b60015b838614610f0e57610ea781611815565b91508160400151610f065781516001600160a01b031615610ec757815194505b876001600160a01b0316856001600160a01b031603610f065780838780600101985081518110610ef957610ef9612d8a565b6020026020010181815250505b600101610e97565b50909695505050505050565b6060600380546107b890612c34565b6060818310610f4b57604051631960ccad60e11b815260040160405180910390fd5b600080610f5760005490565b90506001851015610f6757600194505b80841115610f73578093505b6000610f7e87610d7e565b905084861015610f9d5785850381811015610f97578091505b50610fa1565b5060005b6000816001600160401b03811115610fbb57610fbb612a27565b604051908082528060200260200182016040528015610fe4578160200160208202803683370190505b50905081600003610ffa5793506110a992505050565b600061100588611277565b905060008160400151611016575080515b885b8881141580156110285750848714155b1561109d5761103681611815565b925082604001516110955782516001600160a01b03161561105657825191505b8a6001600160a01b0316826001600160a01b031603611095578084888060010199508151811061108857611088612d8a565b6020026020010181815250505b600101611018565b50505092835250909150505b9392505050565b600f54829060ff16156110c6576110c6816116bc565b6108cc8383611bdb565b3360009081526009602052604090205460ff166110ff5760405162461bcd60e51b815260040161090090612c68565b82811461111f576040516312674e4f60e31b815260040160405180910390fd5b6000805b848110156111725785858281811061113d5761113d612d8a565b90506020020160208101906111529190612c92565b6111609061ffff1683612db6565b915061116b81612dce565b9050611123565b50600c54600160401b900461ffff1681611193600154600054036000190190565b61119d9190612db6565b11156111bc57604051630341a76560e21b815260040160405180910390fd5b60005b82811015611231576112218484838181106111dc576111dc612d8a565b90506020020160208101906111f19190612667565b87878481811061120357611203612d8a565b90506020020160208101906112189190612c92565b61ffff16611c47565b61122a81612dce565b90506111bf565b505050505050565b600f54849060ff16801561125657506001600160a01b0381163314155b1561126457611264336116bc565b61127085858585611c90565b5050505050565b60408051608081018252600080825260208201819052918101829052606081019190915260408051608081018252600080825260208201819052918101829052606081019190915260018310806112d057506000548310155b156112db5792915050565b6112e483611815565b90508060400151156112f65792915050565b6110a983611cd4565b606061130a82611687565b61132757604051630a14c4b560e41b815260040160405180910390fd5b600e805461133490612c34565b905060000361135257604051806020016040528060008152506107a3565b600e61135d83611d09565b60405160200161136e929190612e03565b60405160208183030381529060405292915050565b6040516bffffffffffffffffffffffff193360601b1660208201526113f49060340160405160208183030381529060405280519060200120838380806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250611d4d92505050565b611411576040516311f4c44b60e21b815260040160405180910390fd5b8261ffff16600103611428576108cc600133611d64565b8261ffff1660040361149b57600d54610100900460ff1660000361145f576040516313cec9c560e01b815260040160405180910390fd5b600d8054610100900460ff1690600161147783612ea9565b91906101000a81548160ff021916908360ff160217905550506108cc600433611d64565b60405163524f409b60e01b815260040160405180910390fd5b600f5461010090046001600160a01b031633146114e45760405163026862e360e21b815260040160405180910390fd5b6040516bffffffffffffffffffffffff19606084901b16602082015261151c9060340160405160208183030381529060405282611ecd565b611539576040516311f4c44b60e21b815260040160405180910390fd5b8261ffff16600103611550576108cc600183611d64565b8261ffff1660040361149b57600d54610100900460ff16600003611587576040516313cec9c560e01b815260040160405180910390fd5b600d8054610100900460ff1690600161159f83612ea9565b91906101000a81548160ff021916908360ff160217905550506108cc600483611d64565b6115cb61162d565b6115d6816001610b2c565b610d7b81611f04565b60006301ffc9a760e01b6001600160e01b03198316148061161057506380ac58cd60e01b6001600160e01b03198316145b806107a35750506001600160e01b031916635b5e139f60e01b1490565b6008546001600160a01b031633146109ef5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610900565b60008160011115801561169b575060005482105b80156107a3575050600090815260046020526040902054600160e01b161590565b6daaeb6d7670e522a718067333cd4e3b15610d7b57604051633185c44d60e21b81523060048201526001600160a01b03821660248201526daaeb6d7670e522a718067333cd4e9063c617113490604401602060405180830381865afa158015611729573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061174d9190612ec6565b610d7b57604051633b79c77360e21b81526001600160a01b0382166004820152602401610900565b600061178082610c95565b9050336001600160a01b038216146117b95761179c8133610730565b6117b9576040516367d9dca160e11b815260040160405180910390fd5b60008281526006602052604080822080546001600160a01b0319166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b6040805160808101825260008082526020820181905291810182905260608101919091526000828152600460205260409020546107a390611f7a565b600061185c82611b1a565b9050836001600160a01b0316816001600160a01b03161461188f5760405162a1148160e81b815260040160405180910390fd5b60008281526006602052604090208054338082146001600160a01b038816909114176118dc576118bf8633610730565b6118dc57604051632ce44b5f60e11b815260040160405180910390fd5b6001600160a01b03851661190357604051633a954ecd60e21b815260040160405180910390fd5b801561190e57600082555b6001600160a01b038681166000908152600560205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260046020526040812091909155600160e11b841690036119a05760018401600081815260046020526040812054900361199e57600054811461199e5760008181526004602052604090208490555b505b83856001600160a01b0316876001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4611231565b80471015611a365760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e63650000006044820152606401610900565b6000826001600160a01b03168260405160006040518083038185875af1925050503d8060008114611a83576040519150601f19603f3d011682016040523d82523d6000602084013e611a88565b606091505b50509050806108cc5760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d617920686176652072657665727465640000000000006064820152608401610900565b6108cc83838360405180602001604052806000815250611239565b60008180600111611b7057600054811015611b705760008181526004602052604081205490600160e01b82169003611b6e575b806000036110a9575060001901600081815260046020526040902054611b4d565b505b604051636f96cda160e11b815260040160405180910390fd5b600880546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b3360008181526007602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b8015611c8c57600d5460ff16811115611c8257600d54611c6b90839060ff16611fc1565b600d54611c7b9060ff1682612ee3565b9050611c47565b611c8c8282611fc1565b5050565b611c9b84848461091f565b6001600160a01b0383163b156109c657611cb7848484846120bf565b6109c6576040516368d2bf6b60e11b815260040160405180910390fd5b6040805160808101825260008082526020820181905291810182905260608101919091526107a3611d0483611b1a565b611f7a565b606060a06040510180604052602081039150506000815280825b600183039250600a81066030018353600a900480611d235750819003601f19909101908152919050565b6000600a54611d5c83856121aa565b149392505050565b60408051606081018252600c80546001600160401b0381168352600160401b810461ffff166020840152600093830190600160501b900460ff166001811115611daf57611daf6128f5565b6001811115611dc057611dc06128f5565b9052509050600181604001516001811115611ddd57611ddd6128f5565b14611dfb5760405163b7b2409760e01b815260040160405180910390fd5b8051611e0b9061ffff8516612efa565b6001600160401b03163414611e335760405163078d696560e31b815260040160405180910390fd5b6001600160a01b038216600090815260056020526040808220546001600160401b03911c161115611e7757604051635107dbe760e01b815260040160405180910390fd5b806020015161ffff168361ffff16611e96600154600054036000190190565b611ea09190612db6565b1115611ebf57604051630341a76560e21b815260040160405180910390fd5b6108cc828461ffff16611c47565b600080611ee2611edc856121f7565b8461222b565b9050611efc81600b546001600160a01b0391821691161490565b949350505050565b611f0c61162d565b6001600160a01b038116611f715760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610900565b610d7b81611b89565b604080516080810182526001600160a01b038316815260a083901c6001600160401b03166020820152600160e01b831615159181019190915260e89190911c606082015290565b6000805490829003611fe65760405163b562e8dd60e01b815260040160405180910390fd5b6001600160a01b03831660008181526005602090815260408083208054680100000000000000018802019055848352600490915281206001851460e11b4260a01b178317905582840190839083907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a4600183015b81811461209557808360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600080a460010161205d565b50816000036120b657604051622e076360e81b815260040160405180910390fd5b60005550505050565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a02906120f4903390899088908890600401612f29565b6020604051808303816000875af192505050801561212f575060408051601f3d908101601f1916820190925261212c91810190612f66565b60015b61218d573d80801561215d576040519150601f19603f3d011682016040523d82523d6000602084013e612162565b606091505b508051600003612185576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050949350505050565b600081815b84518110156121ef576121db828683815181106121ce576121ce612d8a565b6020026020010151612240565b9150806121e781612dce565b9150506121af565b509392505050565b600030338360405160200161220e93929190612f83565b604051602081830303815290604052805190602001209050919050565b60006110a98261223a8561226f565b906122aa565b600081831061225c5760008281526020849052604090206110a9565b60008381526020839052604090206110a9565b6040517f19457468657265756d205369676e6564204d6573736167653a0a3332000000006020820152603c8101829052600090605c0161220e565b60008060006122b985856122c6565b915091506121ef8161230b565b60008082516041036122fc5760208301516040840151606085015160001a6122f087828585612455565b94509450505050612304565b506000905060025b9250929050565b600081600481111561231f5761231f6128f5565b036123275750565b600181600481111561233b5761233b6128f5565b036123885760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e617475726500000000000000006044820152606401610900565b600281600481111561239c5761239c6128f5565b036123e95760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e677468006044820152606401610900565b60038160048111156123fd576123fd6128f5565b03610d7b5760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c604482015261756560f01b6064820152608401610900565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083111561248c5750600090506003612510565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa1580156124e0573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b03811661250957600060019250925050612510565b9150600090505b94509492505050565b82805461252590612c34565b90600052602060002090601f016020900481019282612547576000855561258d565b82601f106125605782800160ff1982351617855561258d565b8280016001018555821561258d579182015b8281111561258d578235825591602001919060010190612572565b5061259992915061259d565b5090565b5b80821115612599576000815560010161259e565b6001600160e01b031981168114610d7b57600080fd5b6000602082840312156125da57600080fd5b81356110a9816125b2565b60005b838110156126005781810151838201526020016125e8565b838111156109c65750506000910152565b600081518084526126298160208601602086016125e5565b601f01601f19169290920160200192915050565b6020815260006110a96020830184612611565b80356001600160a01b038116811461086357600080fd5b60006020828403121561267957600080fd5b6110a982612650565b60006020828403121561269457600080fd5b5035919050565b600080604083850312156126ae57600080fd5b6126b783612650565b946020939093013593505050565b6000602082840312156126d757600080fd5b813560ff811681146110a957600080fd5b6000806000606084860312156126fd57600080fd5b61270684612650565b925061271460208501612650565b9150604084013590509250925092565b60006060828403121561273657600080fd5b50919050565b8015158114610d7b57600080fd5b6000806040838503121561275d57600080fd5b61276683612650565b915060208301356127768161273c565b809150509250929050565b6000806020838503121561279457600080fd5b82356001600160401b03808211156127ab57600080fd5b818501915085601f8301126127bf57600080fd5b8135818111156127ce57600080fd5b8660208285010111156127e057600080fd5b60209290920196919550909350505050565b60008083601f84011261280457600080fd5b5081356001600160401b0381111561281b57600080fd5b6020830191508360208260051b850101111561230457600080fd5b6000806020838503121561284957600080fd5b82356001600160401b0381111561285f57600080fd5b61286b858286016127f2565b90969095509350505050565b80516001600160a01b031682526020808201516001600160401b03169083015260408082015115159083015260609081015162ffffff16910152565b6020808252825182820181905260009190848201906040850190845b81811015610f0e576128e2838551612877565b92840192608092909201916001016128cf565b634e487b7160e01b600052602160045260246000fd5b6001600160401b038416815261ffff83166020820152606081016002831061294357634e487b7160e01b600052602160045260246000fd5b826040830152949350505050565b6020808252825182820181905260009190848201906040850190845b81811015610f0e5783518352928401929184019160010161296d565b60008060006060848603121561299e57600080fd5b6129a784612650565b95602085013595506040909401359392505050565b600080600080604085870312156129d257600080fd5b84356001600160401b03808211156129e957600080fd5b6129f5888389016127f2565b90965094506020870135915080821115612a0e57600080fd5b50612a1b878288016127f2565b95989497509550505050565b634e487b7160e01b600052604160045260246000fd5b600082601f830112612a4e57600080fd5b81356001600160401b0380821115612a6857612a68612a27565b604051601f8301601f19908116603f01168101908282118183101715612a9057612a90612a27565b81604052838152866020858801011115612aa957600080fd5b836020870160208301376000602085830101528094505050505092915050565b60008060008060808587031215612adf57600080fd5b612ae885612650565b9350612af660208601612650565b92506040850135915060608501356001600160401b03811115612b1857600080fd5b612b2487828801612a3d565b91505092959194509250565b608081016107a38284612877565b61ffff81168114610d7b57600080fd5b600080600060408486031215612b6357600080fd5b8335612b6e81612b3e565b925060208401356001600160401b03811115612b8957600080fd5b612b95868287016127f2565b9497909650939450505050565b600080600060608486031215612bb757600080fd5b8335612bc281612b3e565b9250612bd060208501612650565b915060408401356001600160401b03811115612beb57600080fd5b612bf786828701612a3d565b9150509250925092565b60008060408385031215612c1457600080fd5b612c1d83612650565b9150612c2b60208401612650565b90509250929050565b600181811c90821680612c4857607f821691505b60208210810361273657634e487b7160e01b600052602260045260246000fd5b60208082526010908201526f496e76616c69642064656c656761746560801b604082015260600190565b600060208284031215612ca457600080fd5b81356110a981612b3e565b60028110610d7b57600080fd5b600060208284031215612cce57600080fd5b81356110a981612caf565b81356001600160401b038116808214612cf157600080fd5b825467ffffffffffffffff1981168217845591506020840135612d1381612b3e565b69ffff0000000000000000604091821b1669ffffffffffffffffffff19841683178117855590850135612d4581612caf565b60028110612d6357634e487b7160e01b600052602160045260246000fd5b6affffffffffffffffffffff19939093169091171760509190911b60ff60501b1617905550565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60008219821115612dc957612dc9612da0565b500190565b600060018201612de057612de0612da0565b5060010190565b60008151612df98185602086016125e5565b9290920192915050565b600080845481600182811c915080831680612e1f57607f831692505b60208084108203612e3e57634e487b7160e01b86526022600452602486fd5b818015612e525760018114612e6357612e90565b60ff19861689528489019650612e90565b60008b81526020902060005b86811015612e885781548b820152908501908301612e6f565b505084890196505b505050505050612ea08185612de7565b95945050505050565b600060ff821680612ebc57612ebc612da0565b6000190192915050565b600060208284031215612ed857600080fd5b81516110a98161273c565b600082821015612ef557612ef5612da0565b500390565b60006001600160401b0380831681851681830481118215151615612f2057612f20612da0565b02949350505050565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090612f5c90830184612611565b9695505050505050565b600060208284031215612f7857600080fd5b81516110a9816125b2565b60006bffffffffffffffffffffffff19808660601b168352808560601b166014840152508251612fba8160288501602087016125e5565b9190910160280194935050505056fea26469706673582212209532bc61e04c34200f79647bb35d6cac81bafb83c6962694feb8294603e6cbe164736f6c634300080d0033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000243eed63b365f896b21ba837ad3fbdb2c2ef518f
-----Decoded View---------------
Arg [0] : signer (address): 0x243Eed63b365f896b21BA837Ad3fBdB2c2EF518F
-----Encoded View---------------
1 Constructor Arguments found :
Arg [0] : 000000000000000000000000243eed63b365f896b21ba837ad3fbdb2c2ef518f
Loading...
Loading
Loading...
Loading
Net Worth in USD
$0.00
Net Worth in ETH
0
Multichain Portfolio | 33 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.