Source Code
Overview
ETH Balance
0 ETHETH Value
$0.00Loading...
Loading
Contract Name:
SignatureERC721
Compiler Version
v0.8.16+commit.07a7930e
Optimization Enabled:
Yes with 200 runs
Other Settings:
london EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity 0.8.16;
import "@openzeppelin/contracts/utils/Address.sol";
import "@openzeppelin/contracts/token/common/ERC2981.sol";
import "./common/Helper.sol";
import "../../mint-voucher/V3/MintVoucherV3.sol";
import "../../cloneable-helper/CloneableNFT.sol";
import "../../cloneable-helper/CloneableERC721A.sol";
/**
* @title SignatureERC721 - An ERC721 token contract with cloning capabilities and signature-based minting
*/
contract SignatureERC721 is CloneableERC721A, ERC2981, MintVoucherContractV3, CloneableNFT {
constructor() CloneableNFT() {}
/**********************************************************************************************************
EXTERNAL
**********************************************************************************************************/
/**
* @notice Initialize the contract with initial parameters
* @param admin The address of the admin
* @param owner_ The address of the contract owner
* @param signer The address of the signer
* @param maxSupply_ The maximum supply of tokens
* @param soulBound_ A flag indicating if tokens are soul-bound
* @param name_ The name of the token
* @param symbol_ The symbol of the token
* @param baseURI_ The base URI for the token
* @param baseContractURI_ The base contract URI
*/
function initialize(
address admin,
address owner_,
address signer,
uint128 maxSupply_,
bool soulBound_,
string memory name_,
string memory symbol_,
string memory baseURI_,
string memory baseContractURI_
) external initializer {
CloneableERC721A(address(this)).initialize(name_, symbol_);
_initialize(admin, owner_, signer, maxSupply_, soulBound_, name_, symbol_, baseURI_, baseContractURI_);
}
/**
* @notice Mint an NFT with a valid MintVoucher and signature
* @param voucher The MintVoucher that contains the specific mint details
* @param signature The signature that must originate from an authorized signer
*/
function mintWithVoucher(MintVoucherV3 calldata voucher, bytes calldata signature) external payable {
if (currentSupply + voucher.quantity > maxSupply) {
revert CommonError.ValueExceedsMaxSupply();
}
currentSupply += uint128(voucher.quantity);
_mintWithVoucher(voucher, signature);
}
/**
* @notice Mint multiple NFTs by an ADMIN
* @param to The address to send the NFT tokens to
* @param quantity The number of NFT tokens to mint
*/
function adminMintMultiple(address to, uint256 quantity) external adminOrOwnerOnly {
if (currentSupply + quantity > maxSupply) {
revert CommonError.ValueExceedsMaxSupply();
}
currentSupply += uint128(quantity);
_safeMint(to, quantity);
}
/**
* @notice Set permanent base URI to the NFT collection
* @param baseURI_ The base URI to set permanent to
*/
function setPermanentBaseURI(string memory baseURI_) external adminOrOwnerOnly {
setBaseURI(baseURI_);
baseURIPermanent = true;
}
/**
* @notice Burn an NFT by the contract owner or the token owner
* @param tokenId The ID of the NFT token
*/
function burn(uint256 tokenId) external {
currentSupply--;
if (baseURIPermanent) {
maxSupply--;
}
_burn(tokenId, true);
}
/**
* @notice Set the default royalty for the contract
* @param receiver The address of the royalty receiver
* @param feeNumerator The royalty fee numerator
*/
function setDefaultRoyalty(address receiver, uint96 feeNumerator) external adminOrOwnerOnly {
_setDefaultRoyalty(receiver, feeNumerator);
}
/**
* @notice Set the royalty for a specific token
* @param tokenId The ID of the token
* @param receiver The address of the royalty receiver
* @param feeNumerator The royalty fee numerator
*/
function setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) external adminOrOwnerOnly {
_setTokenRoyalty(tokenId, receiver, feeNumerator);
}
/**
* @notice Reset the royalty for a specific token
* @param tokenId The ID of the token
*/
function resetTokenRoyalty(uint256 tokenId) external adminOrOwnerOnly {
_resetTokenRoyalty(tokenId);
}
/**
* @notice Set the contract URI
* @param contractURI_ The contract URI to set
*/
function setContractURI(string memory contractURI_) external adminOrOwnerOnly {
emit ContractURIUpdated(contractURI, contractURI_);
contractURI = contractURI_;
}
/**********************************************************************************************************
PUBLIC
**********************************************************************************************************/
/**
* @notice Set the base URI for the token collection
* @param baseURI_ The base URI to set
*/
function setBaseURI(string memory baseURI_) public adminOrOwnerOnly {
if (baseURIPermanent) {
revert CommonError.CannotUpdatePermanentURI();
}
baseURI = baseURI_;
emit BaseURIUpdated(baseURI_);
}
/**
* @notice Set the maximum supply of the NFT collection
* @param maxSupply_ The maximum supply of the NFT collection
*/
function setMaxSupply(uint128 maxSupply_) public adminOrOwnerOnly {
if (maxSupply_ > maxSupply) {
revert CommonError.CannotIncreaseMaxSupply();
}
if (maxSupply_ == maxSupply) {
return;
}
if (maxSupply_ < currentSupply) {
revert CommonError.ValueBelowCurrentSupply();
}
emit MaxSupplyUpdated(maxSupply, maxSupply_);
maxSupply = maxSupply_;
}
/**
* @notice Check if a contract supports a given interface
* @param interfaceId The interface ID to check
* @return True if the contract supports the interface, false otherwise
*/
function supportsInterface(
bytes4 interfaceId
) public view override(AccessControl, CloneableERC721A, ERC2981) returns (bool) {
return
AccessControl.supportsInterface(interfaceId) ||
CloneableERC721A.supportsInterface(interfaceId) ||
ERC2981.supportsInterface(interfaceId);
}
/**
* @notice Set approval for a specific address to manage tokens
* @param operator The address to approve
* @param approved True to approve, false to revoke approval
*/
function setApprovalForAll(address operator, bool approved) public override isTransferAllowed {
super.setApprovalForAll(operator, approved);
}
/**
* @notice Approve an operator to manage a specific token
* @param operator The operator to approve
* @param tokenId The ID of the token to approve
*/
function approve(address operator, uint256 tokenId) public payable override isTransferAllowed {
super.approve(operator, tokenId);
}
/**
* @notice Transfer a token from one address to another
* @param from The address to transfer from
* @param to The address to transfer to
* @param tokenId The ID of the token to transfer
*/
function transferFrom(address from, address to, uint256 tokenId) public payable override isTransferAllowed {
super.transferFrom(from, to, tokenId);
}
/**
* @notice Safely transfer a token from one address to another
* @param from The address to transfer from
* @param to The address to transfer to
* @param tokenId The ID of the token to transfer
*/
function safeTransferFrom(address from, address to, uint256 tokenId) public payable override isTransferAllowed {
super.safeTransferFrom(from, to, tokenId);
}
/**
* @notice Safely transfer a token from one address to another with additional data
* @param from The address to transfer from
* @param to The address to transfer to
* @param tokenId The ID of the token to transfer
* @param data Additional data for the transfer
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes memory data
) public payable override isTransferAllowed {
super.safeTransferFrom(from, to, tokenId, data);
}
/**********************************************************************************************************
INTERNAL
**********************************************************************************************************/
/**
* @dev Get the starting token ID for the collection
* @return The starting token ID
*/
function _startTokenId() internal pure override returns (uint256) {
return 1;
}
/**
* @dev Handle the minting of a token with a voucher
* @param to The address to send the NFT token to
* @param voucher The MintVoucher that contains the specific mint details
*/
function _handleMint(address to, MintVoucherV3 calldata voucher) internal override {
_safeMint(to, voucher.quantity);
}
/**
* @dev Override the base URI function to return the current base URI
* @return The current base URI
*/
function _baseURI() internal view override returns (string memory) {
return baseURI;
}
}// 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) (token/common/ERC2981.sol)
pragma solidity ^0.8.0;
import "../../interfaces/IERC2981.sol";
import "../../utils/introspection/ERC165.sol";
/**
* @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information.
*
* Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for
* specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first.
*
* Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the
* fee is specified in basis points by default.
*
* IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
* https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to
* voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
*
* _Available since v4.5._
*/
abstract contract ERC2981 is IERC2981, ERC165 {
struct RoyaltyInfo {
address receiver;
uint96 royaltyFraction;
}
RoyaltyInfo private _defaultRoyaltyInfo;
mapping(uint256 => RoyaltyInfo) private _tokenRoyaltyInfo;
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {
return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @inheritdoc IERC2981
*/
function royaltyInfo(uint256 _tokenId, uint256 _salePrice) public view virtual override returns (address, uint256) {
RoyaltyInfo memory royalty = _tokenRoyaltyInfo[_tokenId];
if (royalty.receiver == address(0)) {
royalty = _defaultRoyaltyInfo;
}
uint256 royaltyAmount = (_salePrice * royalty.royaltyFraction) / _feeDenominator();
return (royalty.receiver, royaltyAmount);
}
/**
* @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a
* fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an
* override.
*/
function _feeDenominator() internal pure virtual returns (uint96) {
return 10000;
}
/**
* @dev Sets the royalty information that all ids in this contract will default to.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
require(receiver != address(0), "ERC2981: invalid receiver");
_defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Removes default royalty information.
*/
function _deleteDefaultRoyalty() internal virtual {
delete _defaultRoyaltyInfo;
}
/**
* @dev Sets the royalty information for a specific token id, overriding the global default.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setTokenRoyalty(
uint256 tokenId,
address receiver,
uint96 feeNumerator
) internal virtual {
require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
require(receiver != address(0), "ERC2981: Invalid parameters");
_tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Resets royalty information for the token id back to the global default.
*/
function _resetTokenRoyalty(uint256 tokenId) internal virtual {
delete _tokenRoyaltyInfo[tokenId];
}
}// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.16;
import "@openzeppelin/contracts/access/AccessControl.sol";
import "@openzeppelin/contracts/access/Ownable2Step.sol";
import "@openzeppelin/contracts/proxy/utils/Initializable.sol";
// Custom error message for when admin and owner addresses are both zero
error InvalidAdminAndOwnerAddress();
library CommonFunction {
/**
* @dev Default contract URI generation function.
* @param baseContractURI_ The base contract URI.
* @return The concatenated contract URI.
*/
function _defaultContractURI(string memory baseContractURI_) internal view returns (string memory) {
return
bytes(baseContractURI_).length > 0
? string(abi.encodePacked(baseContractURI_, Strings.toHexString(uint256(uint160(address(this))), 20)))
: "";
}
}
library CommonError {
error CannotBeZeroAddress();
error CannotIncreaseMaxSupply();
error CannotUpdatePermanentURI();
error NotApprovedNorOwner();
error ValueCannotBeZero();
error ValueExceedsMaxSupply();
error ValueBelowCurrentSupply();
error InsufficientPayment();
error InvalidPaymentAmount();
error InvalidVoucher();
error TokenAlreadyExists();
error TokenNonExistent();
error TransferNotAllowed();
}
/**
* @title CommonAccess
* @dev A contract that provides common access control functionality.
*/
contract CommonAccess is Initializable, AccessControl, Ownable2Step {
/**
* @dev Initialize the contract with admin and owner addresses.
* @param admin_ The address of the admin.
* @param owner_ The address of the owner.
*/
function initialize(address admin_, address owner_) public virtual onlyInitializing {
if (admin_ == address(0) && owner_ == address(0)) {
revert InvalidAdminAndOwnerAddress();
}
if (admin_ != address(0)) _grantRole(DEFAULT_ADMIN_ROLE, admin_);
if (owner_ != address(0)) {
_transferOwnership(owner_);
} else {
_transferOwnership(admin_);
}
}
/**
* @dev Modifier to restrict access to admin or owner only.
*/
modifier adminOrOwnerOnly() {
if (owner() != _msgSender()) {
_checkRole(DEFAULT_ADMIN_ROLE);
}
_;
}
/**
* @dev Grant admin role to an account.
* @param account The address of the account to grant admin role.
*/
function grantAdminRole(address account) external onlyOwner {
_grantRole(DEFAULT_ADMIN_ROLE, account);
}
/**
* @dev Revoke admin role from an account.
* @param account The address of the account to revoke admin role.
*/
function revokeAdminRole(address account) external onlyOwner {
_revokeRole(DEFAULT_ADMIN_ROLE, account);
}
}
/**
* @title CommonSoulBound
* @dev A contract that provides common functionality for soul-bound tokens.
*/
contract CommonSoulBound is Initializable {
bool private _SOULBOUND;
event SoulBoundToken();
/**
* @dev Initialize the contract with the soul-bound flag.
* @param soulbound_ A flag indicating whether tokens are soul-bound.
*/
function initialize(bool soulbound_) public virtual onlyInitializing {
_SOULBOUND = soulbound_;
if (_SOULBOUND) emit SoulBoundToken();
}
/**
* @dev Modifier to check if transfers are allowed based on the soul-bound setting.
*/
modifier isTransferAllowed() {
if (_SOULBOUND) revert CommonError.TransferNotAllowed();
_;
}
}// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.16;
import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import "./MintVoucherVerificationV3.sol";
import "../../platform/nft/common/Helper.sol";
// Abstract contract for handling minting via voucher system (version 3)
abstract contract MintVoucherContractV3 is MintVoucherVerificationV3 {
using SafeERC20 for IERC20;
// Cancels a voucher by updating the last nonce for the sender and emits an event
function cancelVoucher(uint256 voucherNonce) external {
updateLastNonce(_msgSender(), voucherNonce); // Track the latest nonce for the user
emit VoucherCancelled(_msgSender(), voucherNonce); // Emit the cancellation event
}
function _commonVoucherValidation(MintVoucherV3 calldata voucher, bytes calldata signature) internal view {
// Check if the voucher has expired based on the expiry timestamp
if (voucher.expiry < block.timestamp) {
revert VoucherIsExpired(); // Revert if voucher is expired
}
// Check the length of array
if (voucher.feeRecipientAmounts.length != voucher.feeRecipients.length) {
revert InvalidVoucherFeeInput();
}
// Verify the signature of the voucher to ensure authenticity
verifySignatureV3(voucher, signature);
}
// Main function to handle minting using a voucher
function _mintWithVoucher(MintVoucherV3 calldata voucher, bytes calldata signature) internal virtual {
_commonVoucherValidation(voucher, signature);
// Prevent replay attacks by ensuring the nonce is used only once
updateLastNonce(_msgSender(), voucher.nonce);
// Handle ETH payment if the currency is address(0), which indicates ETH
if (voucher.currency == address(0)) {
_handleEthPayment(voucher);
} else {
// Handle ERC20 token payments
_handleERC20Payment(voucher);
}
// Handle the minting process (defined in the child contract)
_handleMint(_msgSender(), voucher);
// Emit an event to indicate that the voucher was successfully redeemed
emit VoucherRedeemed(signature);
}
// Abstract function to handle the actual minting logic (implemented in derived contracts)
function _handleMint(address to, MintVoucherV3 calldata voucher) internal virtual;
// Function to handle ETH payment for the voucher
function _handleEthPayment(MintVoucherV3 calldata voucher) internal {
uint256 sum = 0; // Initialize sum for fee recipient amounts
// Iterate over all fee recipients to transfer their allocated ETH
for (uint256 i = 0; i < voucher.feeRecipientAmounts.length; i++) {
sum += voucher.feeRecipientAmounts[i];
// Only send if the recipient amount is greater than 0
if (voucher.feeRecipientAmounts[i] > 0) {
// Ensure that the recipient address is not the zero address
if (voucher.feeRecipients[i] == address(0)) {
revert CommonError.CannotBeZeroAddress(); // Revert if recipient is zero address
}
// Transfer the amount to the recipient using the Address utility
Address.sendValue(payable(voucher.feeRecipients[i]), voucher.feeRecipientAmounts[i]);
}
}
if (sum != msg.value) {
revert InvalidVoucherAmount(); // Revert if there's a mismatch
}
}
// Function to handle ERC20 token payments for the voucher
function _handleERC20Payment(MintVoucherV3 calldata voucher) internal {
// Iterate over all fee recipients to transfer their allocated ERC20 tokens
for (uint256 i = 0; i < voucher.feeRecipientAmounts.length; i++) {
// Only transfer if the recipient amount is greater than 0
if (voucher.feeRecipientAmounts[i] > 0) {
// Ensure that the recipient address is not the zero address
if (voucher.feeRecipients[i] == address(0)) {
revert CommonError.CannotBeZeroAddress(); // Revert if recipient is zero address
}
// Transfer the ERC20 tokens from the sender to the recipient
IERC20(voucher.currency).safeTransferFrom(
_msgSender(),
voucher.feeRecipients[i],
voucher.feeRecipientAmounts[i]
);
}
}
}
}pragma solidity 0.8.16;
import "./Cloneable.sol";
import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import "../mint-voucher/MintVoucherVerification.sol";
import "../platform/nft/common/Helper.sol";
contract CloneableNFT is Cloneable, CommonAccess, CommonSoulBound, MintVoucherVerification {
using SafeERC20 for IERC20;
uint128 public currentSupply;
uint128 public maxSupply;
bool public baseURIPermanent;
string public contractURI;
string public baseURI;
string internal _tokenName;
string internal _tokenSymbol;
event ContractURIUpdated(string prevURI, string newURI);
event MaxSupplyUpdated(uint128 oldMaxSupply, uint128 newMaxSupply);
event BaseURIUpdated(string newlyUpdatedURI);
event PermanentURI(string _value, uint256 indexed _id);
event TokenMaxSupplyUpdated(uint256 indexed tokenId, uint128 oldMaxSupply, uint128 newMaxSupply);
/***********************************************|
| Internal |
|______________________________________________*/
function _initialize(
address admin,
address owner_,
address signer,
uint128 maxSupply_,
bool soulBound_,
string memory name_,
string memory symbol_,
string memory baseURI_,
string memory baseContractURI_
) internal virtual {
CommonAccess(address(this)).initialize(admin, owner_);
CommonSoulBound(address(this)).initialize(soulBound_);
MintVoucherVerification(address(this)).initialize(signer);
// initialization workarounds
_tokenName = name_;
_tokenSymbol = symbol_;
// initialize state variables
if (maxSupply_ == 0) {
revert CommonError.ValueCannotBeZero();
}
if (bytes(baseURI_).length > 0) {
baseURI = baseURI_;
emit BaseURIUpdated(baseURI_);
}
maxSupply = maxSupply_;
contractURI = CommonFunction._defaultContractURI(baseContractURI_);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "erc721a/contracts/IERC721A.sol";
import "@openzeppelin/contracts/proxy/utils/Initializable.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 CloneableERC721A
*
* @dev Fork of ERC721A but with an initializer for use with Clones.
*/
contract CloneableERC721A is Initializable, 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;
// =============================================================
// INITIALIZER
// =============================================================
function initialize(string memory name_, string memory symbol_) public onlyInitializing {
_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.6.0) (interfaces/IERC2981.sol)
pragma solidity ^0.8.0;
import "../utils/introspection/IERC165.sol";
/**
* @dev Interface for the NFT Royalty Standard.
*
* A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal
* support for royalty payments across all NFT marketplaces and ecosystem participants.
*
* _Available since v4.5._
*/
interface IERC2981 is IERC165 {
/**
* @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of
* exchange. The royalty amount is denominated and should be paid in that same unit of exchange.
*/
function royaltyInfo(uint256 tokenId, uint256 salePrice)
external
view
returns (address receiver, uint256 royaltyAmount);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
pragma solidity ^0.8.0;
import "./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*
* Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
*/
abstract contract ERC165 is IERC165 {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IERC165).interfaceId;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (access/AccessControl.sol)
pragma solidity ^0.8.0;
import "./IAccessControl.sol";
import "../utils/Context.sol";
import "../utils/Strings.sol";
import "../utils/introspection/ERC165.sol";
/**
* @dev Contract module that allows children to implement role-based access
* control mechanisms. This is a lightweight version that doesn't allow enumerating role
* members except through off-chain means by accessing the contract event logs. Some
* applications may benefit from on-chain enumerability, for those cases see
* {AccessControlEnumerable}.
*
* Roles are referred to by their `bytes32` identifier. These should be exposed
* in the external API and be unique. The best way to achieve this is by
* using `public constant` hash digests:
*
* ```
* bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
* ```
*
* Roles can be used to represent a set of permissions. To restrict access to a
* function call, use {hasRole}:
*
* ```
* function foo() public {
* require(hasRole(MY_ROLE, msg.sender));
* ...
* }
* ```
*
* Roles can be granted and revoked dynamically via the {grantRole} and
* {revokeRole} functions. Each role has an associated admin role, and only
* accounts that have a role's admin role can call {grantRole} and {revokeRole}.
*
* By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
* that only accounts with this role will be able to grant or revoke other
* roles. More complex role relationships can be created by using
* {_setRoleAdmin}.
*
* WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
* grant and revoke this role. Extra precautions should be taken to secure
* accounts that have been granted it.
*/
abstract contract AccessControl is Context, IAccessControl, ERC165 {
struct RoleData {
mapping(address => bool) members;
bytes32 adminRole;
}
mapping(bytes32 => RoleData) private _roles;
bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
/**
* @dev Modifier that checks that an account has a specific role. Reverts
* with a standardized message including the required role.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*
* _Available since v4.1._
*/
modifier onlyRole(bytes32 role) {
_checkRole(role);
_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) public view virtual override returns (bool) {
return _roles[role].members[account];
}
/**
* @dev Revert with a standard message if `_msgSender()` is missing `role`.
* Overriding this function changes the behavior of the {onlyRole} modifier.
*
* Format of the revert message is described in {_checkRole}.
*
* _Available since v4.6._
*/
function _checkRole(bytes32 role) internal view virtual {
_checkRole(role, _msgSender());
}
/**
* @dev Revert with a standard message if `account` is missing `role`.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*/
function _checkRole(bytes32 role, address account) internal view virtual {
if (!hasRole(role, account)) {
revert(
string(
abi.encodePacked(
"AccessControl: account ",
Strings.toHexString(account),
" is missing role ",
Strings.toHexString(uint256(role), 32)
)
)
);
}
}
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {
return _roles[role].adminRole;
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*
* May emit a {RoleGranted} event.
*/
function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_grantRole(role, account);
}
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*
* May emit a {RoleRevoked} event.
*/
function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_revokeRole(role, account);
}
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been revoked `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*
* May emit a {RoleRevoked} event.
*/
function renounceRole(bytes32 role, address account) public virtual override {
require(account == _msgSender(), "AccessControl: can only renounce roles for self");
_revokeRole(role, account);
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event. Note that unlike {grantRole}, this function doesn't perform any
* checks on the calling account.
*
* May emit a {RoleGranted} event.
*
* [WARNING]
* ====
* This function should only be called from the constructor when setting
* up the initial roles for the system.
*
* Using this function in any other way is effectively circumventing the admin
* system imposed by {AccessControl}.
* ====
*
* NOTE: This function is deprecated in favor of {_grantRole}.
*/
function _setupRole(bytes32 role, address account) internal virtual {
_grantRole(role, account);
}
/**
* @dev Sets `adminRole` as ``role``'s admin role.
*
* Emits a {RoleAdminChanged} event.
*/
function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
bytes32 previousAdminRole = getRoleAdmin(role);
_roles[role].adminRole = adminRole;
emit RoleAdminChanged(role, previousAdminRole, adminRole);
}
/**
* @dev Grants `role` to `account`.
*
* Internal function without access restriction.
*
* May emit a {RoleGranted} event.
*/
function _grantRole(bytes32 role, address account) internal virtual {
if (!hasRole(role, account)) {
_roles[role].members[account] = true;
emit RoleGranted(role, account, _msgSender());
}
}
/**
* @dev Revokes `role` from `account`.
*
* Internal function without access restriction.
*
* May emit a {RoleRevoked} event.
*/
function _revokeRole(bytes32 role, address account) internal virtual {
if (hasRole(role, account)) {
_roles[role].members[account] = false;
emit RoleRevoked(role, account, _msgSender());
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (access/Ownable2Step.sol)
pragma solidity ^0.8.0;
import "./Ownable.sol";
/**
* @dev Contract module which provides 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} and {acceptOwnership}.
*
* This module is used through inheritance. It will make available all functions
* from parent (Ownable).
*/
abstract contract Ownable2Step is Ownable {
address private _pendingOwner;
event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);
/**
* @dev Returns the address of the pending owner.
*/
function pendingOwner() public view virtual returns (address) {
return _pendingOwner;
}
/**
* @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual override onlyOwner {
_pendingOwner = newOwner;
emit OwnershipTransferStarted(owner(), newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual override {
delete _pendingOwner;
super._transferOwnership(newOwner);
}
/**
* @dev The new owner accepts the ownership transfer.
*/
function acceptOwnership() external {
address sender = _msgSender();
require(pendingOwner() == sender, "Ownable2Step: caller is not the new owner");
_transferOwnership(sender);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.1) (proxy/utils/Initializable.sol)
pragma solidity ^0.8.2;
import "../../utils/Address.sol";
/**
* @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
* behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
* external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
* function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
*
* The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
* reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
* case an upgrade adds a module that needs to be initialized.
*
* For example:
*
* [.hljs-theme-light.nopadding]
* ```
* contract MyToken is ERC20Upgradeable {
* function initialize() initializer public {
* __ERC20_init("MyToken", "MTK");
* }
* }
* contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
* function initializeV2() reinitializer(2) public {
* __ERC20Permit_init("MyToken");
* }
* }
* ```
*
* TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
* possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
*
* CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
* that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
*
* [CAUTION]
* ====
* Avoid leaving a contract uninitialized.
*
* An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
* contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
* the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
*
* [.hljs-theme-light.nopadding]
* ```
* /// @custom:oz-upgrades-unsafe-allow constructor
* constructor() {
* _disableInitializers();
* }
* ```
* ====
*/
abstract contract Initializable {
/**
* @dev Indicates that the contract has been initialized.
* @custom:oz-retyped-from bool
*/
uint8 private _initialized;
/**
* @dev Indicates that the contract is in the process of being initialized.
*/
bool private _initializing;
/**
* @dev Triggered when the contract has been initialized or reinitialized.
*/
event Initialized(uint8 version);
/**
* @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
* `onlyInitializing` functions can be used to initialize parent contracts.
*
* Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
* constructor.
*
* Emits an {Initialized} event.
*/
modifier initializer() {
bool isTopLevelCall = !_initializing;
require(
(isTopLevelCall && _initialized < 1) || (!Address.isContract(address(this)) && _initialized == 1),
"Initializable: contract is already initialized"
);
_initialized = 1;
if (isTopLevelCall) {
_initializing = true;
}
_;
if (isTopLevelCall) {
_initializing = false;
emit Initialized(1);
}
}
/**
* @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
* contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
* used to initialize parent contracts.
*
* A reinitializer may be used after the original initialization step. This is essential to configure modules that
* are added through upgrades and that require initialization.
*
* When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
* cannot be nested. If one is invoked in the context of another, execution will revert.
*
* Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
* a contract, executing them in the right order is up to the developer or operator.
*
* WARNING: setting the version to 255 will prevent any future reinitialization.
*
* Emits an {Initialized} event.
*/
modifier reinitializer(uint8 version) {
require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
_initialized = version;
_initializing = true;
_;
_initializing = false;
emit Initialized(version);
}
/**
* @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
* {initializer} and {reinitializer} modifiers, directly or indirectly.
*/
modifier onlyInitializing() {
require(_initializing, "Initializable: contract is not initializing");
_;
}
/**
* @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
* Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
* to any version. It is recommended to use this to lock implementation contracts that are designed to be called
* through proxies.
*
* Emits an {Initialized} event the first time it is successfully executed.
*/
function _disableInitializers() internal virtual {
require(!_initializing, "Initializable: contract is initializing");
if (_initialized < type(uint8).max) {
_initialized = type(uint8).max;
emit Initialized(type(uint8).max);
}
}
/**
* @dev Returns the highest version that has been initialized. See {reinitializer}.
*/
function _getInitializedVersion() internal view returns (uint8) {
return _initialized;
}
/**
* @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
*/
function _isInitializing() internal view returns (bool) {
return _initializing;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC20/utils/SafeERC20.sol)
pragma solidity ^0.8.0;
import "../IERC20.sol";
import "../extensions/draft-IERC20Permit.sol";
import "../../../utils/Address.sol";
/**
* @title SafeERC20
* @dev Wrappers around ERC20 operations that throw on failure (when the token
* contract returns false). Tokens that return no value (and instead revert or
* throw on failure) are also supported, non-reverting calls are assumed to be
* successful.
* To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
* which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
*/
library SafeERC20 {
using Address for address;
function safeTransfer(
IERC20 token,
address to,
uint256 value
) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
}
function safeTransferFrom(
IERC20 token,
address from,
address to,
uint256 value
) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
}
/**
* @dev Deprecated. This function has issues similar to the ones found in
* {IERC20-approve}, and its usage is discouraged.
*
* Whenever possible, use {safeIncreaseAllowance} and
* {safeDecreaseAllowance} instead.
*/
function safeApprove(
IERC20 token,
address spender,
uint256 value
) internal {
// safeApprove should only be called when setting an initial allowance,
// or when resetting it to zero. To increase and decrease it, use
// 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
require(
(value == 0) || (token.allowance(address(this), spender) == 0),
"SafeERC20: approve from non-zero to non-zero allowance"
);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
}
function safeIncreaseAllowance(
IERC20 token,
address spender,
uint256 value
) internal {
uint256 newAllowance = token.allowance(address(this), spender) + value;
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
function safeDecreaseAllowance(
IERC20 token,
address spender,
uint256 value
) internal {
unchecked {
uint256 oldAllowance = token.allowance(address(this), spender);
require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
uint256 newAllowance = oldAllowance - value;
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
}
function safePermit(
IERC20Permit token,
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) internal {
uint256 nonceBefore = token.nonces(owner);
token.permit(owner, spender, value, deadline, v, r, s);
uint256 nonceAfter = token.nonces(owner);
require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed");
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*/
function _callOptionalReturn(IERC20 token, bytes memory data) private {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
// the target address contains contract code and also asserts for success in the low-level call.
bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
if (returndata.length > 0) {
// Return data is optional
require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
}
}
}// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.16;
import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
import "../MintVoucherVerification.sol";
// Abstract contract for verifying Mint Vouchers (Version 3)
abstract contract MintVoucherVerificationV3 is MintVoucherVerification {
struct MintVoucherV3 {
address[] feeRecipients; // Array of addresses to receive a portion of the payment
uint256[] feeRecipientAmounts; // Array of amounts corresponding to the fee recipients
uint256 quantity; // Number of tokens to mint
uint256 nonce; // Unique number to prevent replay attacks
uint256 expiry; // Expiry timestamp of the voucher
uint256 tokenId; // ID of the token being minted
address currency; // Address of the ERC20 currency (or 0x0 for ETH)
bytes extra; // Extra data field for future extensions
}
// Function to verify the signature of the voucher to ensure it is authentic
function verifySignatureV3(
MintVoucherV3 calldata voucher, // The voucher containing all relevant data
bytes calldata signature // Signature to verify the voucher's authenticity
) internal view {
// Create a digest by hashing the voucher's contents and converting it to Ethereum signed message format
bytes32 digest = ECDSA.toEthSignedMessageHash(hashV3(voucher));
// Recover the signer's address from the provided signature
address recoveredSigner = ECDSA.recover(digest, signature);
// Verify if the recovered signer has the SIGNER_ROLE in the contract
if (!hasRole(SIGNER_ROLE, recoveredSigner)) {
revert InvalidSignature(); // Revert if the signature is invalid or signer is unauthorized
}
}
// Internal function to hash the contents of the MintVoucherV3, used for signature verification
function hashV3(MintVoucherV3 calldata voucher) internal view returns (bytes32) {
return
keccak256(
abi.encodePacked(
abi.encode(voucher.feeRecipients, voucher.feeRecipientAmounts),
abi.encode(
voucher.quantity,
voucher.nonce,
voucher.expiry,
voucher.tokenId,
voucher.currency,
voucher.extra,
_msgSender(),
address(this),
block.chainid
)
)
);
}
}pragma solidity 0.8.16;
import "@openzeppelin/contracts/proxy/utils/Initializable.sol";
import "./ICloneable.sol";
import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
contract Cloneable is ICloneable, Initializable {
constructor() {
_disableInitializers();
}
/***********************************************|
| External |
|______________________________________________*/
function isInitialized() external view returns (bool) {
return _getInitializedVersion() > 0;
}
}// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.16;
import "@openzeppelin/contracts/access/AccessControl.sol";
import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
import "./MintVoucherCapability.sol";
import "../platform/nft/common/Helper.sol";
import "./MintVoucherErrors.sol";
import "@openzeppelin/contracts/proxy/utils/Initializable.sol";
/**
* @title MintVoucherVerification
* @notice MintVoucherVerification is intended to be used to
* restrict minting via an off chain mint limiting server that issues vouchers.
* This contract handles the validation of the voucher and signature.
* @dev Non-voucher related validation logic such as checking availably supply and funds should
* be implemented in the caller functions.
*/
abstract contract MintVoucherVerification is Initializable, AccessControl, MintVoucherErrors, MintVoucherCapability {
// The recovered signer must have this role
bytes32 public constant SIGNER_ROLE = keccak256("SIGNER_ROLE");
// Track nonce of each account to be able to mark vouchers as filled or canceled
mapping(address => uint256) private lastNonce;
/**
* @dev The MintVoucher struct contains the specific mint details. This data
* along with the contract address and the msg sender will be included in
* the signed message. Some of these fields may not be used depending on
* the situation. Currency should be zero address if payment is in native currency.
* tokenId is necessary for ERC1155 implementations but for ERC721 it is up to
* the implementation.
*/
struct MintVoucher {
address netRecipient;
address initialRecipient;
uint256 initialRecipientAmount;
uint256 quantity;
uint256 nonce;
uint256 expiry;
uint256 price;
uint256 tokenId;
address currency;
}
/**
* @param signer An address that will sign the vouchers. The signing address
* will be recovered from the signature and verified to match
* this signer.
*/
function initialize(address signer) public virtual onlyInitializing {
_grantRole(SIGNER_ROLE, signer);
}
/**
* @dev Recover signer from signature and mint voucher data. Validate the signer
* has the required role.
* @param netRecipient The address to transfer the net funds minus initial payout, if any
* @param initialRecipient The address to transfer an initial payout
* @param initialRecipientAmount The amount to send to initial recipient
* @param quantity The quantity to mint
* @param nonce The mint voucher nonce used for replay protection
* @param expiry The mint voucher expiration
* @param price The price per unit
* @param tokenId The tokenId to mint
* @param currency The currency for payment
* @param signature The signature to validate
*/
function verifySignature(
address netRecipient,
address initialRecipient,
uint256 initialRecipientAmount,
uint256 quantity,
uint256 nonce,
uint256 expiry,
uint256 price,
uint256 tokenId,
address currency,
bytes calldata signature
) internal view {
bytes32 digest = ECDSA.toEthSignedMessageHash(
hash(
netRecipient,
initialRecipient,
initialRecipientAmount,
quantity,
nonce,
expiry,
price,
tokenId,
currency
)
);
address recoveredSigner = ECDSA.recover(digest, signature);
if (!hasRole(SIGNER_ROLE, recoveredSigner)) {
revert InvalidSignature();
}
}
/**
* @dev Hash the mint voucher data, msg sender, and contract address. The lastNonce
* needs to be updated with the voucher nonce prior to hashing.
* @param netRecipient The address to transfer the net funds minus initial payout, if any
* @param initialRecipient The address to transfer an initial payout
* @param initialRecipientAmount The amount to send to initial recipient
* @param quantity The quantity to mint
* @param nonce The mint voucher nonce used for replay protection
* @param expiry The mint voucher expiration
* @param price The price per unit
* @param tokenId The tokenId to mint
* @param currency The currency for payment
*/
function hash(
address netRecipient,
address initialRecipient,
uint256 initialRecipientAmount,
uint256 quantity,
uint256 nonce,
uint256 expiry,
uint256 price,
uint256 tokenId,
address currency
) internal view returns (bytes32) {
return
keccak256(
abi.encode(
netRecipient,
initialRecipient,
initialRecipientAmount,
quantity,
nonce,
expiry,
price,
tokenId,
currency,
_msgSender(),
address(this),
block.chainid
)
);
}
/**
* @dev Set the last nonce used for an account. Any oucher with a nonce below or
* equal to this nonce is no invalid.
* @param account The account to set the nonce for
* @param nonce The new nonce
*/
function updateLastNonce(address account, uint256 nonce) internal {
// Cannot decrease the last used nonce
if (nonce <= getLastNonce(account)) {
revert VoucherNonceTooLow();
}
lastNonce[account] = nonce;
}
/**
* @notice Get the last used nonce for an account.
* @dev A valid voucher must have a nonce higher than this
* @param account The account to get the nonce for
*/
function getLastNonce(address account) public view virtual returns (uint256) {
return lastNonce[account];
}
}// SPDX-License-Identifier: MIT
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
pragma solidity ^0.8.4;
/**
* @dev Interface of ERC721A.
*/
interface IERC721A {
/**
* The caller must own the token or be an approved operator.
*/
error ApprovalCallerNotOwnerNorApproved();
/**
* The token does not exist.
*/
error ApprovalQueryForNonexistentToken();
/**
* Cannot query the balance for the zero address.
*/
error BalanceQueryForZeroAddress();
/**
* Cannot mint to the zero address.
*/
error MintToZeroAddress();
/**
* The quantity of tokens minted must be more than zero.
*/
error MintZeroQuantity();
/**
* The token does not exist.
*/
error OwnerQueryForNonexistentToken();
/**
* The caller must own the token or be an approved operator.
*/
error TransferCallerNotOwnerNorApproved();
/**
* The token must be owned by `from`.
*/
error TransferFromIncorrectOwner();
/**
* Cannot safely transfer to a contract that does not implement the
* ERC721Receiver interface.
*/
error TransferToNonERC721ReceiverImplementer();
/**
* Cannot transfer to the zero address.
*/
error TransferToZeroAddress();
/**
* The token does not exist.
*/
error URIQueryForNonexistentToken();
/**
* The `quantity` minted with ERC2309 exceeds the safety limit.
*/
error MintERC2309QuantityExceedsLimit();
/**
* The `extraData` cannot be set on an unintialized ownership slot.
*/
error OwnershipNotInitializedForExtraData();
// =============================================================
// STRUCTS
// =============================================================
struct TokenOwnership {
// The address of the owner.
address addr;
// Stores the start time of ownership with minimal overhead for tokenomics.
uint64 startTimestamp;
// Whether the token has been burned.
bool burned;
// Arbitrary data similar to `startTimestamp` that can be set via {_extraData}.
uint24 extraData;
}
// =============================================================
// TOKEN COUNTERS
// =============================================================
/**
* @dev Returns the total number of tokens in existence.
* Burned tokens will reduce the count.
* To get the total number of tokens minted, please see {_totalMinted}.
*/
function totalSupply() external view returns (uint256);
// =============================================================
// IERC165
// =============================================================
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
* to learn more about how these ids are created.
*
* This function call must use less than 30000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
// =============================================================
// IERC721
// =============================================================
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables
* (`approved`) `operator` to manage all of its assets.
*/
event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
/**
* @dev Returns the number of tokens in `owner`'s account.
*/
function balanceOf(address owner) external view returns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) external view returns (address owner);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`,
* checking first that contract recipients are aware of the ERC721 protocol
* to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be have been allowed to move
* this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes calldata data
) external payable;
/**
* @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) external payable;
/**
* @dev Transfers `tokenId` from `from` to `to`.
*
* WARNING: Usage of this method is discouraged, use {safeTransferFrom}
* whenever possible.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) external payable;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the
* zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) external payable;
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom}
* for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool _approved) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) external view returns (address operator);
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address owner, address operator) external view returns (bool);
// =============================================================
// IERC721Metadata
// =============================================================
/**
* @dev Returns the token collection name.
*/
function name() external view returns (string memory);
/**
* @dev Returns the token collection symbol.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) external view returns (string memory);
// =============================================================
// IERC2309
// =============================================================
/**
* @dev Emitted when tokens in `fromTokenId` to `toTokenId`
* (inclusive) is transferred from `from` to `to`, as defined in the
* [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard.
*
* See {_mintERC2309} for more details.
*/
event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)
pragma solidity ^0.8.0;
/**
* @dev External interface of AccessControl declared to support ERC165 detection.
*/
interface IAccessControl {
/**
* @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
*
* `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
* {RoleAdminChanged} not being emitted signaling this.
*
* _Available since v3.1._
*/
event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
/**
* @dev Emitted when `account` is granted `role`.
*
* `sender` is the account that originated the contract call, an admin role
* bearer except when using {AccessControl-_setupRole}.
*/
event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Emitted when `account` is revoked `role`.
*
* `sender` is the account that originated the contract call:
* - if using `revokeRole`, it is the admin role bearer
* - if using `renounceRole`, it is the role bearer (i.e. `account`)
*/
event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) external view returns (bool);
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {AccessControl-_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) external view returns (bytes32);
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function grantRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function revokeRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been granted `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*/
function renounceRole(bytes32 role, address account) external;
}// 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/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 (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);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
/**
* @dev Returns the amount of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the amount of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves `amount` tokens from the caller's account to `to`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address to, uint256 amount) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 amount) external returns (bool);
/**
* @dev Moves `amount` tokens from `from` to `to` using the
* allowance mechanism. `amount` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 amount
) external returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-IERC20Permit.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
* https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
*
* Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
* presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
* need to send a transaction, and thus is not required to hold Ether at all.
*/
interface IERC20Permit {
/**
* @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
* given ``owner``'s signed approval.
*
* IMPORTANT: The same issues {IERC20-approve} has related to transaction
* ordering also apply here.
*
* Emits an {Approval} event.
*
* Requirements:
*
* - `spender` cannot be the zero address.
* - `deadline` must be a timestamp in the future.
* - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
* over the EIP712-formatted function arguments.
* - the signature must use ``owner``'s current nonce (see {nonces}).
*
* For more information on the signature format, see the
* https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
* section].
*/
function permit(
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) external;
/**
* @dev Returns the current nonce for `owner`. This value must be
* included whenever a signature is generated for {permit}.
*
* Every successful call to {permit} increases ``owner``'s nonce by one. This
* prevents a signature from being used multiple times.
*/
function nonces(address owner) external view returns (uint256);
/**
* @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
*/
// solhint-disable-next-line func-name-mixedcase
function DOMAIN_SEPARATOR() external view returns (bytes32);
}// 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));
}
}pragma solidity 0.8.16;
interface ICloneable {
function isInitialized() external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.2) (token/ERC721/ERC721.sol)
pragma solidity ^0.8.0;
import "./IERC721.sol";
import "./IERC721Receiver.sol";
import "./extensions/IERC721Metadata.sol";
import "../../utils/Address.sol";
import "../../utils/Context.sol";
import "../../utils/Strings.sol";
import "../../utils/introspection/ERC165.sol";
/**
* @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
* the Metadata extension, but not including the Enumerable extension, which is available separately as
* {ERC721Enumerable}.
*/
contract ERC721 is Context, ERC165, IERC721, IERC721Metadata {
using Address for address;
using Strings for uint256;
// Token name
string private _name;
// Token symbol
string private _symbol;
// Mapping from token ID to owner address
mapping(uint256 => address) private _owners;
// Mapping owner address to token count
mapping(address => uint256) private _balances;
// Mapping from token ID to approved address
mapping(uint256 => address) private _tokenApprovals;
// Mapping from owner to operator approvals
mapping(address => mapping(address => bool)) private _operatorApprovals;
/**
* @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
*/
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
return
interfaceId == type(IERC721).interfaceId ||
interfaceId == type(IERC721Metadata).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC721-balanceOf}.
*/
function balanceOf(address owner) public view virtual override returns (uint256) {
require(owner != address(0), "ERC721: address zero is not a valid owner");
return _balances[owner];
}
/**
* @dev See {IERC721-ownerOf}.
*/
function ownerOf(uint256 tokenId) public view virtual override returns (address) {
address owner = _ownerOf(tokenId);
require(owner != address(0), "ERC721: invalid token ID");
return owner;
}
/**
* @dev See {IERC721Metadata-name}.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev See {IERC721Metadata-symbol}.
*/
function symbol() public view virtual override returns (string memory) {
return _symbol;
}
/**
* @dev See {IERC721Metadata-tokenURI}.
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
_requireMinted(tokenId);
string memory baseURI = _baseURI();
return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
}
/**
* @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, can be overridden in child contracts.
*/
function _baseURI() internal view virtual returns (string memory) {
return "";
}
/**
* @dev See {IERC721-approve}.
*/
function approve(address to, uint256 tokenId) public virtual override {
address owner = ERC721.ownerOf(tokenId);
require(to != owner, "ERC721: approval to current owner");
require(
_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
"ERC721: approve caller is not token owner or approved for all"
);
_approve(to, tokenId);
}
/**
* @dev See {IERC721-getApproved}.
*/
function getApproved(uint256 tokenId) public view virtual override returns (address) {
_requireMinted(tokenId);
return _tokenApprovals[tokenId];
}
/**
* @dev See {IERC721-setApprovalForAll}.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_setApprovalForAll(_msgSender(), operator, approved);
}
/**
* @dev See {IERC721-isApprovedForAll}.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
return _operatorApprovals[owner][operator];
}
/**
* @dev See {IERC721-transferFrom}.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) public virtual override {
//solhint-disable-next-line max-line-length
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
_transfer(from, to, tokenId);
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) public virtual override {
safeTransferFrom(from, to, tokenId, "");
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes memory data
) public virtual override {
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
_safeTransfer(from, to, tokenId, data);
}
/**
* @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.
*
* `data` is additional data, it has no specified format and it is sent in call to `to`.
*
* This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
* implement alternative mechanisms to perform token transfer, such as signature-based.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function _safeTransfer(
address from,
address to,
uint256 tokenId,
bytes memory data
) internal virtual {
_transfer(from, to, tokenId);
require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer");
}
/**
* @dev Returns the owner of the `tokenId`. Does NOT revert if token doesn't exist
*/
function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
return _owners[tokenId];
}
/**
* @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 (`_mint`),
* and stop existing when they are burned (`_burn`).
*/
function _exists(uint256 tokenId) internal view virtual returns (bool) {
return _ownerOf(tokenId) != address(0);
}
/**
* @dev Returns whether `spender` is allowed to manage `tokenId`.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
address owner = ERC721.ownerOf(tokenId);
return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
}
/**
* @dev Safely mints `tokenId` and transfers it to `to`.
*
* Requirements:
*
* - `tokenId` must not exist.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function _safeMint(address to, uint256 tokenId) internal virtual {
_safeMint(to, tokenId, "");
}
/**
* @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
* forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
*/
function _safeMint(
address to,
uint256 tokenId,
bytes memory data
) internal virtual {
_mint(to, tokenId);
require(
_checkOnERC721Received(address(0), to, tokenId, data),
"ERC721: transfer to non ERC721Receiver implementer"
);
}
/**
* @dev Mints `tokenId` and transfers it to `to`.
*
* WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
*
* Requirements:
*
* - `tokenId` must not exist.
* - `to` cannot be the zero address.
*
* Emits a {Transfer} event.
*/
function _mint(address to, uint256 tokenId) internal virtual {
require(to != address(0), "ERC721: mint to the zero address");
require(!_exists(tokenId), "ERC721: token already minted");
_beforeTokenTransfer(address(0), to, tokenId, 1);
// Check that tokenId was not minted by `_beforeTokenTransfer` hook
require(!_exists(tokenId), "ERC721: token already minted");
unchecked {
// Will not overflow unless all 2**256 token ids are minted to the same owner.
// Given that tokens are minted one by one, it is impossible in practice that
// this ever happens. Might change if we allow batch minting.
// The ERC fails to describe this case.
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(address(0), to, tokenId);
_afterTokenTransfer(address(0), to, tokenId, 1);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
* This is an internal function that does not check if the sender is authorized to operate on the token.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/
function _burn(uint256 tokenId) internal virtual {
address owner = ERC721.ownerOf(tokenId);
_beforeTokenTransfer(owner, address(0), tokenId, 1);
// Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
owner = ERC721.ownerOf(tokenId);
// Clear approvals
delete _tokenApprovals[tokenId];
unchecked {
// Cannot overflow, as that would require more tokens to be burned/transferred
// out than the owner initially received through minting and transferring in.
_balances[owner] -= 1;
}
delete _owners[tokenId];
emit Transfer(owner, address(0), tokenId);
_afterTokenTransfer(owner, address(0), tokenId, 1);
}
/**
* @dev Transfers `tokenId` from `from` to `to`.
* As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
*
* Emits a {Transfer} event.
*/
function _transfer(
address from,
address to,
uint256 tokenId
) internal virtual {
require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
require(to != address(0), "ERC721: transfer to the zero address");
_beforeTokenTransfer(from, to, tokenId, 1);
// Check that tokenId was not transferred by `_beforeTokenTransfer` hook
require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
// Clear approvals from the previous owner
delete _tokenApprovals[tokenId];
unchecked {
// `_balances[from]` cannot overflow for the same reason as described in `_burn`:
// `from`'s balance is the number of token held, which is at least one before the current
// transfer.
// `_balances[to]` could overflow in the conditions described in `_mint`. That would require
// all 2**256 token ids to be minted, which in practice is impossible.
_balances[from] -= 1;
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(from, to, tokenId);
_afterTokenTransfer(from, to, tokenId, 1);
}
/**
* @dev Approve `to` to operate on `tokenId`
*
* Emits an {Approval} event.
*/
function _approve(address to, uint256 tokenId) internal virtual {
_tokenApprovals[tokenId] = to;
emit Approval(ERC721.ownerOf(tokenId), to, tokenId);
}
/**
* @dev Approve `operator` to operate on all of `owner` tokens
*
* Emits an {ApprovalForAll} event.
*/
function _setApprovalForAll(
address owner,
address operator,
bool approved
) internal virtual {
require(owner != operator, "ERC721: approve to caller");
_operatorApprovals[owner][operator] = approved;
emit ApprovalForAll(owner, operator, approved);
}
/**
* @dev Reverts if the `tokenId` has not been minted yet.
*/
function _requireMinted(uint256 tokenId) internal view virtual {
require(_exists(tokenId), "ERC721: invalid token ID");
}
/**
* @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
* The call is not executed if the target address is not a contract.
*
* @param from address representing the previous owner of the given token ID
* @param to target address that will receive the tokens
* @param tokenId uint256 ID of the token to be transferred
* @param data bytes optional data to send along with the call
* @return bool whether the call correctly returned the expected magic value
*/
function _checkOnERC721Received(
address from,
address to,
uint256 tokenId,
bytes memory data
) private returns (bool) {
if (to.isContract()) {
try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
return retval == IERC721Receiver.onERC721Received.selector;
} catch (bytes memory reason) {
if (reason.length == 0) {
revert("ERC721: transfer to non ERC721Receiver implementer");
} else {
/// @solidity memory-safe-assembly
assembly {
revert(add(32, reason), mload(reason))
}
}
}
} else {
return true;
}
}
/**
* @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
* - When `from` is zero, the tokens will be minted for `to`.
* - When `to` is zero, ``from``'s tokens will be burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _beforeTokenTransfer(
address from,
address to,
uint256 firstTokenId,
uint256 batchSize
) internal virtual {}
/**
* @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
* - When `from` is zero, the tokens were minted for `to`.
* - When `to` is zero, ``from``'s tokens were burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _afterTokenTransfer(
address from,
address to,
uint256 firstTokenId,
uint256 batchSize
) internal virtual {}
/**
* @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
*
* WARNING: Anyone calling this MUST ensure that the balances remain consistent with the ownership. The invariant
* being that for any address `a` the value returned by `balanceOf(a)` must be equal to the number of tokens such
* that `ownerOf(tokenId)` is `a`.
*/
// solhint-disable-next-line func-name-mixedcase
function __unsafe_increaseBalance(address account, uint256 amount) internal {
_balances[account] += amount;
}
}// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.16;
/**
* @dev This is the interface for the MintVoucherCapability
*/
interface MintVoucherCapability {
event VoucherRedeemed(bytes signature);
event VoucherCancelled(address minter, uint256 nonce);
}// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.16;
/**
* @title MintVoucherErrors
* @notice MintVoucherErrors contatins errors related to MintVoucher verification
*/
interface MintVoucherErrors {
/**
* @dev Revert with an error when attempting to mint with an invalid voucher.
* This may be due to many reasons, including, but not limited to, an
* attempting to mint a voucher signed by an unauthorized signer,
* insufficient funds sent, attempting to mint more than allocated, and
* attempting to mint a different buyer's voucher,
*/
error InvalidSignature();
/**
* @dev Revert with an error when attempting to mint with an expired voucher.
*/
error VoucherIsExpired();
/**
* @dev Revert with an error when attempting to mint a voucher that has
* already been filled or canceled.
*/
error VoucherNonceTooLow();
/**
* @dev Revert with an error when attempting to mint a voucher that has
* mismatch price and sum of fee recipient amounts
*/
error InvalidVoucherAmount();
/**
* @dev Revert with an error when attempting to mint a voucher that has
* mismatch length of feeRecipientAmounts and feeRecipients
*/
error InvalidVoucherFeeInput();
}// 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) (token/ERC721/IERC721.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC721 compliant contract.
*/
interface IERC721 is IERC165 {
/**
* @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`.
*
* 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 calldata data
) external;
/**
* @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 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
) external;
/**
* @dev Transfers `tokenId` token from `from` to `to`.
*
* WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
* or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
* understand this adds an external call which potentially creates a reentrancy vulnerability.
*
* 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;
/**
* @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;
/**
* @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);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)
pragma solidity ^0.8.0;
/**
* @title ERC721 token receiver interface
* @dev Interface for any contract that wants to support safeTransfers
* from ERC721 asset contracts.
*/
interface IERC721Receiver {
/**
* @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
* by `operator` from `from`, this function is called.
*
* It must return its Solidity selector to confirm the token transfer.
* If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
*
* The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
*/
function onERC721Received(
address operator,
address from,
uint256 tokenId,
bytes calldata data
) external returns (bytes4);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC721.sol";
/**
* @title ERC-721 Non-Fungible Token Standard, optional metadata extension
* @dev See https://eips.ethereum.org/EIPS/eip-721
*/
interface IERC721Metadata is IERC721 {
/**
* @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);
}{
"remappings": [
"@ensdomains/=node_modules/@ensdomains/",
"@float-capital/=node_modules/@float-capital/",
"@gnosis.pm/=node_modules/@gnosis.pm/",
"@openzeppelin/=node_modules/@openzeppelin/",
"ds-test/=lib/forge-std/lib/ds-test/src/",
"erc721a/=node_modules/erc721a/",
"eth-gas-reporter/=node_modules/eth-gas-reporter/",
"forge-std/=lib/forge-std/src/",
"hardhat/=node_modules/hardhat/"
],
"optimizer": {
"enabled": true,
"runs": 200,
"details": {
"constantOptimizer": true,
"yul": true
}
},
"metadata": {
"useLiteralContent": false,
"bytecodeHash": "none"
},
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"evmVersion": "london",
"viaIR": false,
"libraries": {}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"CannotBeZeroAddress","type":"error"},{"inputs":[],"name":"CannotIncreaseMaxSupply","type":"error"},{"inputs":[],"name":"CannotUpdatePermanentURI","type":"error"},{"inputs":[],"name":"InvalidAdminAndOwnerAddress","type":"error"},{"inputs":[],"name":"InvalidSignature","type":"error"},{"inputs":[],"name":"InvalidVoucherAmount","type":"error"},{"inputs":[],"name":"InvalidVoucherFeeInput","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferNotAllowed","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"ValueBelowCurrentSupply","type":"error"},{"inputs":[],"name":"ValueCannotBeZero","type":"error"},{"inputs":[],"name":"ValueExceedsMaxSupply","type":"error"},{"inputs":[],"name":"VoucherIsExpired","type":"error"},{"inputs":[],"name":"VoucherNonceTooLow","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"newlyUpdatedURI","type":"string"}],"name":"BaseURIUpdated","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":false,"internalType":"string","name":"prevURI","type":"string"},{"indexed":false,"internalType":"string","name":"newURI","type":"string"}],"name":"ContractURIUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint128","name":"oldMaxSupply","type":"uint128"},{"indexed":false,"internalType":"uint128","name":"newMaxSupply","type":"uint128"}],"name":"MaxSupplyUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","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":false,"internalType":"string","name":"_value","type":"string"},{"indexed":true,"internalType":"uint256","name":"_id","type":"uint256"}],"name":"PermanentURI","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[],"name":"SoulBoundToken","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint128","name":"oldMaxSupply","type":"uint128"},{"indexed":false,"internalType":"uint128","name":"newMaxSupply","type":"uint128"}],"name":"TokenMaxSupplyUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"minter","type":"address"},{"indexed":false,"internalType":"uint256","name":"nonce","type":"uint256"}],"name":"VoucherCancelled","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bytes","name":"signature","type":"bytes"}],"name":"VoucherRedeemed","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SIGNER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"adminMintMultiple","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURIPermanent","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"voucherNonce","type":"uint256"}],"name":"cancelVoucher","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"contractURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentSupply","outputs":[{"internalType":"uint128","name":"","type":"uint128"}],"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":"account","type":"address"}],"name":"getLastNonce","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"grantAdminRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"admin_","type":"address"},{"internalType":"address","name":"owner_","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"signer","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"soulbound_","type":"bool"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"admin","type":"address"},{"internalType":"address","name":"owner_","type":"address"},{"internalType":"address","name":"signer","type":"address"},{"internalType":"uint128","name":"maxSupply_","type":"uint128"},{"internalType":"bool","name":"soulBound_","type":"bool"},{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"},{"internalType":"string","name":"baseURI_","type":"string"},{"internalType":"string","name":"baseContractURI_","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"isInitialized","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupply","outputs":[{"internalType":"uint128","name":"","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"address[]","name":"feeRecipients","type":"address[]"},{"internalType":"uint256[]","name":"feeRecipientAmounts","type":"uint256[]"},{"internalType":"uint256","name":"quantity","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"expiry","type":"uint256"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"currency","type":"address"},{"internalType":"bytes","name":"extra","type":"bytes"}],"internalType":"struct MintVoucherVerificationV3.MintVoucherV3","name":"voucher","type":"tuple"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"mintWithVoucher","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":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"resetTokenRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"revokeAdminRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"baseURI_","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"contractURI_","type":"string"}],"name":"setContractURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint128","name":"maxSupply_","type":"uint128"}],"name":"setMaxSupply","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"baseURI_","type":"string"}],"name":"setPermanentBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setTokenRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"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"}]Contract Creation Code
60806040523480156200001157600080fd5b506200001c6200002d565b6200002733620000ef565b6200016b565b600054610100900460ff16156200009a5760405162461bcd60e51b815260206004820152602760248201527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469604482015266616c697a696e6760c81b606482015260840160405180910390fd5b60005460ff9081161015620000ed576000805460ff191660ff9081179091556040519081527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b565b600d80546001600160a01b0319169055620001168162000119602090811b6200183017901c565b50565b600c80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b614071806200017b6000396000f3fe6080604052600436106102ff5760003560e01c8063899cb14811610190578063bed3ac50116100dc578063d5abeb0111610095578063e8a3d4851161006f578063e8a3d48514610927578063e985e9c51461093c578063ecc6aa2514610985578063f2fde38b146109a557600080fd5b8063d5abeb01146108c2578063de8817d9146108e9578063e30c39781461090957600080fd5b8063bed3ac5014610802578063c4d66de814610822578063c634b78e14610842578063c87b56dd14610862578063d53a822f14610882578063d547741f146108a257600080fd5b806395d89b4111610149578063a217fddf11610123578063a217fddf14610784578063a22cb46514610799578063b009fdd5146107b9578063b88d4fde146107ef57600080fd5b806395d89b411461071b5780639a19c7b014610730578063a1ebf35d1461075057600080fd5b8063899cb1481461066a5780638a616bc01461067d5780638ac068a21461069d5780638da5cb5b146106bd57806391d14854146106db578063938e3d7b146106fb57600080fd5b8063392e53cd1161024f5780635944c7531161020857806370a08231116101e257806370a08231146105e8578063715018a614610608578063771282f61461061d57806379ba50971461065557600080fd5b80635944c753146105935780636352211e146105b35780636c0360eb146105d357600080fd5b8063392e53cd146104eb57806342842e0e1461050057806342966c6814610513578063485cc955146105335780634cd88b761461055357806355f804b31461057357600080fd5b806318160ddd116102bc5780632a55205a116102965780632a55205a1461044c5780632e4853941461048b5780632f2ff15d146104ab57806336568abe146104cb57600080fd5b806318160ddd146103e257806323b872dd14610409578063248a9ca31461041c57600080fd5b806301ffc9a71461030457806304634d8d1461033957806306fdde031461035b578063081812fc1461037d578063095ea7b3146103b55780631179ebad146103c8575b600080fd5b34801561031057600080fd5b5061032461031f36600461338f565b6109c5565b60405190151581526020015b60405180910390f35b34801561034557600080fd5b506103596103543660046133df565b6109f4565b005b34801561036757600080fd5b50610370610a1e565b6040516103309190613462565b34801561038957600080fd5b5061039d610398366004613475565b610ab0565b6040516001600160a01b039091168152602001610330565b6103596103c336600461348e565b610af4565b3480156103d457600080fd5b506010546103249060ff1681565b3480156103ee57600080fd5b5060025460015403600019015b604051908152602001610330565b6103596104173660046134b8565b610b29565b34801561042857600080fd5b506103fb610437366004613475565b6000908152600b602052604090206001015490565b34801561045857600080fd5b5061046c6104673660046134f4565b610b64565b604080516001600160a01b039093168352602083019190915201610330565b34801561049757600080fd5b506103596104a63660046135c2565b610c12565b3480156104b757600080fd5b506103596104c63660046135f7565b610c47565b3480156104d757600080fd5b506103596104e63660046135f7565b610c6c565b3480156104f757600080fd5b50610324610ceb565b61035961050e3660046134b8565b610d03565b34801561051f57600080fd5b5061035961052e366004613475565b610d39565b34801561053f57600080fd5b5061035961054e36600461361a565b610dd4565b34801561055f57600080fd5b5061035961056e366004613644565b610e72565b34801561057f57600080fd5b5061035961058e3660046135c2565b610ebb565b34801561059f57600080fd5b506103596105ae3660046136a8565b610f42565b3480156105bf57600080fd5b5061039d6105ce366004613475565b610f69565b3480156105df57600080fd5b50610370610f74565b3480156105f457600080fd5b506103fb6106033660046136e4565b611002565b34801561061457600080fd5b50610359611051565b34801561062957600080fd5b50600f5461063d906001600160801b031681565b6040516001600160801b039091168152602001610330565b34801561066157600080fd5b50610359611065565b6103596106783660046136ff565b6110dc565b34801561068957600080fd5b50610359610698366004613475565b611171565b3480156106a957600080fd5b506103596106b83660046137b6565b61119e565b3480156106c957600080fd5b50600c546001600160a01b031661039d565b3480156106e757600080fd5b506103246106f63660046135f7565b6112a8565b34801561070757600080fd5b506103596107163660046135c2565b6112d3565b34801561072757600080fd5b50610370611335565b34801561073c57600080fd5b5061035961074b3660046136e4565b611344565b34801561075c57600080fd5b506103fb7fe2f4eaae4a9751e85a3e4a7b9587827a877f29914755229b07a7b2da98285f7081565b34801561079057600080fd5b506103fb600081565b3480156107a557600080fd5b506103596107b43660046137ea565b611357565b3480156107c557600080fd5b506103fb6107d43660046136e4565b6001600160a01b03166000908152600e602052604090205490565b6103596107fd366004613821565b61138c565b34801561080e57600080fd5b5061035961081d366004613475565b6113c9565b34801561082e57600080fd5b5061035961083d3660046136e4565b611409565b34801561084e57600080fd5b5061035961085d3660046136e4565b61145a565b34801561086e57600080fd5b5061037061087d366004613475565b61146d565b34801561088e57600080fd5b5061035961089d36600461389d565b6114f1565b3480156108ae57600080fd5b506103596108bd3660046135f7565b61156b565b3480156108ce57600080fd5b50600f5461063d90600160801b90046001600160801b031681565b3480156108f557600080fd5b506103596109043660046138ba565b611590565b34801561091557600080fd5b50600d546001600160a01b031661039d565b34801561093357600080fd5b5061037061170a565b34801561094857600080fd5b5061032461095736600461361a565b6001600160a01b03918216600090815260086020908152604080832093909416825291909152205460ff1690565b34801561099157600080fd5b506103596109a036600461348e565b611717565b3480156109b157600080fd5b506103596109c03660046136e4565b6117bf565b60006109d082611882565b806109df57506109df826118a7565b806109ee57506109ee826118f5565b92915050565b600c546001600160a01b03163314610a1057610a10600061192a565b610a1a8282611934565b5050565b606060038054610a2d906139bb565b80601f0160208091040260200160405190810160405280929190818152602001828054610a59906139bb565b8015610aa65780601f10610a7b57610100808354040283529160200191610aa6565b820191906000526020600020905b815481529060010190602001808311610a8957829003601f168201915b5050505050905090565b6000610abb826119ee565b610ad8576040516333d1c03960e21b815260040160405180910390fd5b506000908152600760205260409020546001600160a01b031690565b600d54600160a01b900460ff1615610b1f57604051638cd22d1960e01b815260040160405180910390fd5b610a1a8282611a23565b600d54600160a01b900460ff1615610b5457604051638cd22d1960e01b815260040160405180910390fd5b610b5f838383611ac3565b505050565b6000828152600a602090815260408083208151808301909252546001600160a01b038116808352600160a01b9091046001600160601b0316928201929092528291610bd95750604080518082019091526009546001600160a01b0381168252600160a01b90046001600160601b031660208201525b602081015160009061271090610bf8906001600160601b031687613a0b565b610c029190613a2a565b91519350909150505b9250929050565b600c546001600160a01b03163314610c2e57610c2e600061192a565b610c3781610ebb565b506010805460ff19166001179055565b6000828152600b6020526040902060010154610c628161192a565b610b5f8383611c54565b6001600160a01b0381163314610ce15760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b610a1a8282611cda565b600080610cfa60005460ff1690565b60ff1611905090565b600d54600160a01b900460ff1615610d2e57604051638cd22d1960e01b815260040160405180910390fd5b610b5f838383611d41565b600f80546001600160801b0316906000610d5283613a4c565b82546001600160801b039182166101009390930a92830291909202199091161790555060105460ff1615610dc657600f8054600160801b90046001600160801b0316906010610da083613a4c565b91906101000a8154816001600160801b0302191690836001600160801b03160217905550505b610dd1816001611d5c565b50565b600054610100900460ff16610dfb5760405162461bcd60e51b8152600401610cd890613a6f565b6001600160a01b038216158015610e1957506001600160a01b038116155b15610e375760405163cd80353560e01b815260040160405180910390fd5b6001600160a01b03821615610e5157610e51600083611c54565b6001600160a01b03811615610e6957610a1a81611e8c565b610a1a82611e8c565b600054610100900460ff16610e995760405162461bcd60e51b8152600401610cd890613a6f565b6003610ea58382613b00565b506004610eb28282613b00565b50600180555050565b600c546001600160a01b03163314610ed757610ed7600061192a565b60105460ff1615610efb57604051633900de5360e01b815260040160405180910390fd5b6012610f078282613b00565b507f6741b2fc379fad678116fe3d4d4b9a1a184ab53ba36b86ad0fa66340b1ab41ad81604051610f379190613462565b60405180910390a150565b600c546001600160a01b03163314610f5e57610f5e600061192a565b610b5f838383611ea5565b60006109ee82611f70565b60128054610f81906139bb565b80601f0160208091040260200160405190810160405280929190818152602001828054610fad906139bb565b8015610ffa5780601f10610fcf57610100808354040283529160200191610ffa565b820191906000526020600020905b815481529060010190602001808311610fdd57829003601f168201915b505050505081565b60006001600160a01b03821661102b576040516323d3ad8160e21b815260040160405180910390fd5b506001600160a01b031660009081526006602052604090205467ffffffffffffffff1690565b611059611fdf565b6110636000611e8c565b565b600d5433906001600160a01b031681146110d35760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b6064820152608401610cd8565b610dd181611e8c565b600f546001600160801b03600160801b82048116916111019160408701359116613bc0565b11156111205760405163b4632d5160e01b815260040160405180910390fd5b600f8054604085013591906000906111429084906001600160801b0316613bd3565b92506101000a8154816001600160801b0302191690836001600160801b03160217905550610b5f838383612039565b600c546001600160a01b0316331461118d5761118d600061192a565b6000908152600a6020526040812055565b600c546001600160a01b031633146111ba576111ba600061192a565b600f546001600160801b03600160801b909104811690821611156111f15760405163c4469e5b60e01b815260040160405180910390fd5b600f546001600160801b03828116600160801b9092041614610dd157600f546001600160801b03908116908216101561123d5760405163e9519eaf60e01b815260040160405180910390fd5b600f54604080516001600160801b03600160801b9093048316815291831660208301527f30009ebdfe108ec5238d9bfdb65c7cd05abaf5879f705788da7feda30d415fb4910160405180910390a1600f80546001600160801b03808416600160801b02911617905550565b6000918252600b602090815260408084206001600160a01b0393909316845291905290205460ff1690565b600c546001600160a01b031633146112ef576112ef600061192a565b7fc9c7c3fe08b88b4df9d4d47ef47d2c43d55c025a0ba88ca442580ed9e7348a16601182604051611321929190613bfa565b60405180910390a16011610a1a8282613b00565b606060048054610a2d906139bb565b61134c611fdf565b610dd1600082611cda565b600d54600160a01b900460ff161561138257604051638cd22d1960e01b815260040160405180910390fd5b610a1a82826120d1565b600d54600160a01b900460ff16156113b757604051638cd22d1960e01b815260040160405180910390fd5b6113c38484848461213d565b50505050565b6113d33382612181565b60408051338152602081018390527f3df5d8f8ab64f627d3b9fb62a5f047e29b7f4c287c9ce1b095ab5465a28ab34c9101610f37565b600054610100900460ff166114305760405162461bcd60e51b8152600401610cd890613a6f565b610dd17fe2f4eaae4a9751e85a3e4a7b9587827a877f29914755229b07a7b2da98285f7082611c54565b611462611fdf565b610dd1600082611c54565b6060611478826119ee565b61149557604051630a14c4b560e41b815260040160405180910390fd5b600061149f6121d5565b905080516000036114bf57604051806020016040528060008152506114ea565b806114c9846121e4565b6040516020016114da929190613c99565b6040516020818303038152906040525b9392505050565b600054610100900460ff166115185760405162461bcd60e51b8152600401610cd890613a6f565b600d805460ff60a01b1916600160a01b8315158102919091179182905560ff91041615610dd1576040517fc2812778e8871cf60af834692db801a7a79df8acead429394ed6c876b992418d90600090a150565b6000828152600b60205260409020600101546115868161192a565b610b5f8383611cda565b600054610100900460ff16158080156115b05750600054600160ff909116105b806115ca5750303b1580156115ca575060005460ff166001145b61162d5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610cd8565b6000805460ff191660011790558015611650576000805461ff0019166101001790555b60405163266c45bb60e11b81523090634cd88b76906116759088908890600401613cc8565b600060405180830381600087803b15801561168f57600080fd5b505af11580156116a3573d6000803e3d6000fd5b505050506116b88a8a8a8a8a8a8a8a8a612228565b80156116fe576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050505050565b60118054610f81906139bb565b600c546001600160a01b0316331461173357611733600061192a565b600f546001600160801b03600160801b820481169161175491849116613bc0565b11156117735760405163b4632d5160e01b815260040160405180910390fd5b600f80548291906000906117919084906001600160801b0316613bd3565b92506101000a8154816001600160801b0302191690836001600160801b03160217905550610a1a82826123f7565b6117c7611fdf565b600d80546001600160a01b0383166001600160a01b031990911681179091556117f8600c546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b600c80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60006001600160e01b03198216637965db0b60e01b14806109ee57506109ee826118f5565b60006301ffc9a760e01b6001600160e01b0319831614806118d857506380ac58cd60e01b6001600160e01b03198316145b806109ee5750506001600160e01b031916635b5e139f60e01b1490565b60006001600160e01b0319821663152a902d60e11b14806109ee57506301ffc9a760e01b6001600160e01b03198316146109ee565b610dd18133612411565b6127106001600160601b038216111561195f5760405162461bcd60e51b8152600401610cd890613ced565b6001600160a01b0382166119b55760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c6964207265636569766572000000000000006044820152606401610cd8565b604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600955565b600081600111158015611a02575060015482105b80156109ee575050600090815260056020526040902054600160e01b161590565b6000611a2e82610f69565b9050336001600160a01b03821614611a6757611a4a8133610957565b611a67576040516367d9dca160e11b815260040160405180910390fd5b60008281526007602052604080822080546001600160a01b0319166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b6000611ace82611f70565b9050836001600160a01b0316816001600160a01b031614611b015760405162a1148160e81b815260040160405180910390fd5b60008281526007602052604090208054611b2d8187335b6001600160a01b039081169116811491141790565b611b5857611b3b8633610957565b611b5857604051632ce44b5f60e11b815260040160405180910390fd5b6001600160a01b038516611b7f57604051633a954ecd60e21b815260040160405180910390fd5b8015611b8a57600082555b6001600160a01b038681166000908152600660205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260056020526040812091909155600160e11b84169003611c1c57600184016000818152600560205260408120549003611c1a576001548114611c1a5760008181526005602052604090208490555b505b83856001600160a01b0316876001600160a01b031660008051602061404583398151915260405160405180910390a45b505050505050565b611c5e82826112a8565b610a1a576000828152600b602090815260408083206001600160a01b03851684529091529020805460ff19166001179055611c963390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b611ce482826112a8565b15610a1a576000828152600b602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b610b5f8383836040518060200160405280600081525061138c565b6000611d6783611f70565b905080600080611d8586600090815260076020526040902080549091565b915091508415611dc557611d9a818433611b18565b611dc557611da88333610957565b611dc557604051632ce44b5f60e11b815260040160405180910390fd5b8015611dd057600082555b6001600160a01b038316600081815260066020526040902080546001600160801b030190554260a01b17600360e01b17600087815260056020526040812091909155600160e11b85169003611e5557600186016000818152600560205260408120549003611e53576001548114611e535760008181526005602052604090208590555b505b60405186906000906001600160a01b03861690600080516020614045833981519152908390a4505060028054600101905550505050565b600d80546001600160a01b0319169055610dd181611830565b6127106001600160601b0382161115611ed05760405162461bcd60e51b8152600401610cd890613ced565b6001600160a01b038216611f265760405162461bcd60e51b815260206004820152601b60248201527f455243323938313a20496e76616c696420706172616d657465727300000000006044820152606401610cd8565b6040805180820182526001600160a01b0393841681526001600160601b0392831660208083019182526000968752600a90529190942093519051909116600160a01b029116179055565b60008180600111611fc657600154811015611fc65760008181526005602052604081205490600160e01b82169003611fc4575b806000036114ea575060001901600081815260056020526040902054611fa3565b505b604051636f96cda160e11b815260040160405180910390fd5b600c546001600160a01b031633146110635760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610cd8565b61204483838361246a565b612052338460600135612181565b600061206460e0850160c086016136e4565b6001600160a01b0316036120805761207b836124d3565b612089565b61208983612630565b612093338461275a565b7fd787a81976c7ae74647fc73d6574ab6333e0d888828e3b934b2570a70b78384e82826040516120c4929190613d60565b60405180910390a1505050565b3360008181526008602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b612148848484610b29565b6001600160a01b0383163b156113c35761216484848484612768565b6113c3576040516368d2bf6b60e11b815260040160405180910390fd5b6001600160a01b0382166000908152600e602052604090205481116121b9576040516313b42f4d60e31b815260040160405180910390fd5b6001600160a01b039091166000908152600e6020526040902055565b606060128054610a2d906139bb565b606060a06040510180604052602081039150506000815280825b600183039250600a81066030018353600a9004806121fe5750819003601f19909101908152919050565b60405163485cc95560e01b81526001600160a01b03808b16600483015289166024820152309063485cc95590604401600060405180830381600087803b15801561227157600080fd5b505af1158015612285573d6000803e3d6000fd5b505060405163d53a822f60e01b8152871515600482015230925063d53a822f9150602401600060405180830381600087803b1580156122c357600080fd5b505af11580156122d7573d6000803e3d6000fd5b505060405163189acdbd60e31b81526001600160a01b038a16600482015230925063c4d66de89150602401600060405180830381600087803b15801561231c57600080fd5b505af1158015612330573d6000803e3d6000fd5b5050505083601390816123439190613b00565b5060146123508482613b00565b50856001600160801b031660000361237b576040516363868c5560e11b815260040160405180910390fd5b8151156123c757601261238e8382613b00565b507f6741b2fc379fad678116fe3d4d4b9a1a184ab53ba36b86ad0fa66340b1ab41ad826040516123be9190613462565b60405180910390a15b600f80546001600160801b03808916600160801b0291161790556123ea81612854565b6011906116fe9082613b00565b610a1a8282604051806020016040528060008152506128a6565b61241b82826112a8565b610a1a5761242881612913565b612433836020612925565b604051602001612444929190613d74565b60408051601f198184030181529082905262461bcd60e51b8252610cd891600401613462565b428360800135101561248f5760405163455c7d6b60e11b815260040160405180910390fd5b6124998380613de9565b90506124a86020850185613de9565b9050146124c85760405163154c1d8360e11b815260040160405180910390fd5b610b5f838383612ac1565b6000805b6124e46020840184613de9565b905081101561260f576124fa6020840184613de9565b8281811061250a5761250a613e33565b905060200201358261251c9190613bc0565b9150600061252d6020850185613de9565b8381811061253d5761253d613e33565b9050602002013511156125fd5760006125568480613de9565b8381811061256657612566613e33565b905060200201602081019061257b91906136e4565b6001600160a01b0316036125a257604051631e7d738760e21b815260040160405180910390fd5b6125fd6125af8480613de9565b838181106125bf576125bf613e33565b90506020020160208101906125d491906136e4565b6125e16020860186613de9565b848181106125f1576125f1613e33565b90506020020135612b61565b8061260781613e49565b9150506124d7565b50348114610a1a576040516358e66ccd60e11b815260040160405180910390fd5b60005b6126406020830183613de9565b9050811015610a1a5760006126586020840184613de9565b8381811061266857612668613e33565b9050602002013511156127485760006126818380613de9565b8381811061269157612691613e33565b90506020020160208101906126a691906136e4565b6001600160a01b0316036126cd57604051631e7d738760e21b815260040160405180910390fd5b612748336126db8480613de9565b848181106126eb576126eb613e33565b905060200201602081019061270091906136e4565b61270d6020860186613de9565b8581811061271d5761271d613e33565b905060200201358560c001602081019061273791906136e4565b6001600160a01b0316929190612c7a565b8061275281613e49565b915050612633565b610a1a8282604001356123f7565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a029061279d903390899088908890600401613e62565b6020604051808303816000875af19250505080156127d8575060408051601f3d908101601f191682019092526127d591810190613e9f565b60015b612836573d808015612806576040519150601f19603f3d011682016040523d82523d6000602084013e61280b565b606091505b50805160000361282e576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b1490505b949350505050565b6060600082511161287457604051806020016040528060008152506109ee565b81612880306014612925565b604051602001612891929190613c99565b60405160208183030381529060405292915050565b6128b08383612cd4565b6001600160a01b0383163b15610b5f576001548281035b6128da6000868380600101945086612768565b6128f7576040516368d2bf6b60e11b815260040160405180910390fd5b8181106128c757816001541461290c57600080fd5b5050505050565b60606109ee6001600160a01b03831660145b60606000612934836002613a0b565b61293f906002613bc0565b67ffffffffffffffff81111561295757612957613516565b6040519080825280601f01601f191660200182016040528015612981576020820181803683370190505b509050600360fc1b8160008151811061299c5761299c613e33565b60200101906001600160f81b031916908160001a905350600f60fb1b816001815181106129cb576129cb613e33565b60200101906001600160f81b031916908160001a90535060006129ef846002613a0b565b6129fa906001613bc0565b90505b6001811115612a72576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110612a2e57612a2e613e33565b1a60f81b828281518110612a4457612a44613e33565b60200101906001600160f81b031916908160001a90535060049490941c93612a6b81613ebc565b90506129fd565b5083156114ea5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610cd8565b6000612ad4612acf85612dae565b612e70565b90506000612b188285858080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250612eab92505050565b9050612b447fe2f4eaae4a9751e85a3e4a7b9587827a877f29914755229b07a7b2da98285f70826112a8565b61290c57604051638baa579f60e01b815260040160405180910390fd5b80471015612bb15760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e63650000006044820152606401610cd8565b6000826001600160a01b03168260405160006040518083038185875af1925050503d8060008114612bfe576040519150601f19603f3d011682016040523d82523d6000602084013e612c03565b606091505b5050905080610b5f5760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d617920686176652072657665727465640000000000006064820152608401610cd8565b604080516001600160a01b0385811660248301528416604482015260648082018490528251808303909101815260849091019091526020810180516001600160e01b03166323b872dd60e01b1790526113c3908590612ecf565b6001546000829003612cf95760405163b562e8dd60e01b815260040160405180910390fd5b6001600160a01b03831660008181526006602090815260408083208054680100000000000000018802019055848352600590915281206001851460e11b4260a01b178317905582840190839083906000805160206140458339815191528180a4600183015b818114612d845780836000600080516020614045833981519152600080a4600101612d5e565b5081600003612da557604051622e076360e81b815260040160405180910390fd5b60015550505050565b6000612dba8280613de9565b612dc76020850185613de9565b604051602001612dda9493929190613ed3565b60408051601f198184030181529181528301356060840135608085013560a0860135612e0c60e0880160c089016136e4565b612e1960e0890189613f4f565b333046604051602001612e359a99989796959493929190613f96565b60408051601f1981840301815290829052612e539291602001613c99565b604051602081830303815290604052805190602001209050919050565b6040517f19457468657265756d205369676e6564204d6573736167653a0a3332000000006020820152603c8101829052600090605c01612e53565b6000806000612eba8585612fa1565b91509150612ec781612fe3565b509392505050565b6000612f24826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b031661312d9092919063ffffffff16565b805190915015610b5f5780806020019051810190612f429190613ff5565b610b5f5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610cd8565b6000808251604103612fd75760208301516040840151606085015160001a612fcb8782858561313c565b94509450505050610c0b565b50600090506002610c0b565b6000816004811115612ff757612ff7614012565b03612fff5750565b600181600481111561301357613013614012565b036130605760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e617475726500000000000000006044820152606401610cd8565b600281600481111561307457613074614012565b036130c15760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e677468006044820152606401610cd8565b60038160048111156130d5576130d5614012565b03610dd15760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c604482015261756560f01b6064820152608401610cd8565b606061284c8484600085613200565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083111561317357506000905060036131f7565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa1580156131c7573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166131f0576000600192509250506131f7565b9150600090505b94509492505050565b6060824710156132615760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610cd8565b600080866001600160a01b0316858760405161327d9190614028565b60006040518083038185875af1925050503d80600081146132ba576040519150601f19603f3d011682016040523d82523d6000602084013e6132bf565b606091505b50915091506132d0878383876132db565b979650505050505050565b6060831561334a578251600003613343576001600160a01b0385163b6133435760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610cd8565b508161284c565b61284c838381511561335f5781518083602001fd5b8060405162461bcd60e51b8152600401610cd89190613462565b6001600160e01b031981168114610dd157600080fd5b6000602082840312156133a157600080fd5b81356114ea81613379565b80356001600160a01b03811681146133c357600080fd5b919050565b80356001600160601b03811681146133c357600080fd5b600080604083850312156133f257600080fd5b6133fb836133ac565b9150613409602084016133c8565b90509250929050565b60005b8381101561342d578181015183820152602001613415565b50506000910152565b6000815180845261344e816020860160208601613412565b601f01601f19169290920160200192915050565b6020815260006114ea6020830184613436565b60006020828403121561348757600080fd5b5035919050565b600080604083850312156134a157600080fd5b6134aa836133ac565b946020939093013593505050565b6000806000606084860312156134cd57600080fd5b6134d6846133ac565b92506134e4602085016133ac565b9150604084013590509250925092565b6000806040838503121561350757600080fd5b50508035926020909101359150565b634e487b7160e01b600052604160045260246000fd5b600067ffffffffffffffff8084111561354757613547613516565b604051601f8501601f19908116603f0116810190828211818310171561356f5761356f613516565b8160405280935085815286868601111561358857600080fd5b858560208301376000602087830101525050509392505050565b600082601f8301126135b357600080fd5b6114ea8383356020850161352c565b6000602082840312156135d457600080fd5b813567ffffffffffffffff8111156135eb57600080fd5b61284c848285016135a2565b6000806040838503121561360a57600080fd5b82359150613409602084016133ac565b6000806040838503121561362d57600080fd5b613636836133ac565b9150613409602084016133ac565b6000806040838503121561365757600080fd5b823567ffffffffffffffff8082111561366f57600080fd5b61367b868387016135a2565b9350602085013591508082111561369157600080fd5b5061369e858286016135a2565b9150509250929050565b6000806000606084860312156136bd57600080fd5b833592506136cd602085016133ac565b91506136db604085016133c8565b90509250925092565b6000602082840312156136f657600080fd5b6114ea826133ac565b60008060006040848603121561371457600080fd5b833567ffffffffffffffff8082111561372c57600080fd5b90850190610100828803121561374157600080fd5b9093506020850135908082111561375757600080fd5b818601915086601f83011261376b57600080fd5b81358181111561377a57600080fd5b87602082850101111561378c57600080fd5b6020830194508093505050509250925092565b80356001600160801b03811681146133c357600080fd5b6000602082840312156137c857600080fd5b6114ea8261379f565b8015158114610dd157600080fd5b80356133c3816137d1565b600080604083850312156137fd57600080fd5b613806836133ac565b91506020830135613816816137d1565b809150509250929050565b6000806000806080858703121561383757600080fd5b613840856133ac565b935061384e602086016133ac565b925060408501359150606085013567ffffffffffffffff81111561387157600080fd5b8501601f8101871361388257600080fd5b6138918782356020840161352c565b91505092959194509250565b6000602082840312156138af57600080fd5b81356114ea816137d1565b60008060008060008060008060006101208a8c0312156138d957600080fd5b6138e28a6133ac565b98506138f060208b016133ac565b97506138fe60408b016133ac565b965061390c60608b0161379f565b955061391a60808b016137df565b945060a08a013567ffffffffffffffff8082111561393757600080fd5b6139438d838e016135a2565b955060c08c013591508082111561395957600080fd5b6139658d838e016135a2565b945060e08c013591508082111561397b57600080fd5b6139878d838e016135a2565b93506101008c013591508082111561399e57600080fd5b506139ab8c828d016135a2565b9150509295985092959850929598565b600181811c908216806139cf57607f821691505b6020821081036139ef57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b6000816000190483118215151615613a2557613a256139f5565b500290565b600082613a4757634e487b7160e01b600052601260045260246000fd5b500490565b60006001600160801b03821680613a6557613a656139f5565b6000190192915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b601f821115610b5f57600081815260208120601f850160051c81016020861015613ae15750805b601f850160051c820191505b81811015611c4c57828155600101613aed565b815167ffffffffffffffff811115613b1a57613b1a613516565b613b2e81613b2884546139bb565b84613aba565b602080601f831160018114613b635760008415613b4b5750858301515b600019600386901b1c1916600185901b178555611c4c565b600085815260208120601f198616915b82811015613b9257888601518255948401946001909101908401613b73565b5085821015613bb05787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b808201808211156109ee576109ee6139f5565b6001600160801b03818116838216019080821115613bf357613bf36139f5565b5092915050565b604081526000808454613c0c816139bb565b8060408601526060600180841660008114613c2e5760018114613c4857613c79565b60ff1985168884015283151560051b880183019550613c79565b8960005260208060002060005b86811015613c705781548b8201870152908401908201613c55565b8a018501975050505b50505050508281036020840152613c908185613436565b95945050505050565b60008351613cab818460208801613412565b835190830190613cbf818360208801613412565b01949350505050565b604081526000613cdb6040830185613436565b8281036020840152613c908185613436565b6020808252602a908201527f455243323938313a20726f79616c7479206665652077696c6c206578636565646040820152692073616c65507269636560b01b606082015260800190565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60208152600061284c602083018486613d37565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613dac816017850160208801613412565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351613ddd816028840160208801613412565b01602801949350505050565b6000808335601e19843603018112613e0057600080fd5b83018035915067ffffffffffffffff821115613e1b57600080fd5b6020019150600581901b3603821315610c0b57600080fd5b634e487b7160e01b600052603260045260246000fd5b600060018201613e5b57613e5b6139f5565b5060010190565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090613e9590830184613436565b9695505050505050565b600060208284031215613eb157600080fd5b81516114ea81613379565b600081613ecb57613ecb6139f5565b506000190190565b6040808252810184905260008560608301825b87811015613f14576001600160a01b03613eff846133ac565b16825260209283019290910190600101613ee6565b5083810360208501528481526001600160fb1b03851115613f3457600080fd5b8460051b915081866020830137016020019695505050505050565b6000808335601e19843603018112613f6657600080fd5b83018035915067ffffffffffffffff821115613f8157600080fd5b602001915036819003821315610c0b57600080fd5b60006101208c83528b60208401528a604084015289606084015260018060a01b03808a1660808501528160a0850152613fd2828501898b613d37565b96811660c08501529490941660e083015250610100015250979650505050505050565b60006020828403121561400757600080fd5b81516114ea816137d1565b634e487b7160e01b600052602160045260246000fd5b6000825161403a818460208701613412565b919091019291505056feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa164736f6c6343000810000a
Deployed Bytecode
0x6080604052600436106102ff5760003560e01c8063899cb14811610190578063bed3ac50116100dc578063d5abeb0111610095578063e8a3d4851161006f578063e8a3d48514610927578063e985e9c51461093c578063ecc6aa2514610985578063f2fde38b146109a557600080fd5b8063d5abeb01146108c2578063de8817d9146108e9578063e30c39781461090957600080fd5b8063bed3ac5014610802578063c4d66de814610822578063c634b78e14610842578063c87b56dd14610862578063d53a822f14610882578063d547741f146108a257600080fd5b806395d89b4111610149578063a217fddf11610123578063a217fddf14610784578063a22cb46514610799578063b009fdd5146107b9578063b88d4fde146107ef57600080fd5b806395d89b411461071b5780639a19c7b014610730578063a1ebf35d1461075057600080fd5b8063899cb1481461066a5780638a616bc01461067d5780638ac068a21461069d5780638da5cb5b146106bd57806391d14854146106db578063938e3d7b146106fb57600080fd5b8063392e53cd1161024f5780635944c7531161020857806370a08231116101e257806370a08231146105e8578063715018a614610608578063771282f61461061d57806379ba50971461065557600080fd5b80635944c753146105935780636352211e146105b35780636c0360eb146105d357600080fd5b8063392e53cd146104eb57806342842e0e1461050057806342966c6814610513578063485cc955146105335780634cd88b761461055357806355f804b31461057357600080fd5b806318160ddd116102bc5780632a55205a116102965780632a55205a1461044c5780632e4853941461048b5780632f2ff15d146104ab57806336568abe146104cb57600080fd5b806318160ddd146103e257806323b872dd14610409578063248a9ca31461041c57600080fd5b806301ffc9a71461030457806304634d8d1461033957806306fdde031461035b578063081812fc1461037d578063095ea7b3146103b55780631179ebad146103c8575b600080fd5b34801561031057600080fd5b5061032461031f36600461338f565b6109c5565b60405190151581526020015b60405180910390f35b34801561034557600080fd5b506103596103543660046133df565b6109f4565b005b34801561036757600080fd5b50610370610a1e565b6040516103309190613462565b34801561038957600080fd5b5061039d610398366004613475565b610ab0565b6040516001600160a01b039091168152602001610330565b6103596103c336600461348e565b610af4565b3480156103d457600080fd5b506010546103249060ff1681565b3480156103ee57600080fd5b5060025460015403600019015b604051908152602001610330565b6103596104173660046134b8565b610b29565b34801561042857600080fd5b506103fb610437366004613475565b6000908152600b602052604090206001015490565b34801561045857600080fd5b5061046c6104673660046134f4565b610b64565b604080516001600160a01b039093168352602083019190915201610330565b34801561049757600080fd5b506103596104a63660046135c2565b610c12565b3480156104b757600080fd5b506103596104c63660046135f7565b610c47565b3480156104d757600080fd5b506103596104e63660046135f7565b610c6c565b3480156104f757600080fd5b50610324610ceb565b61035961050e3660046134b8565b610d03565b34801561051f57600080fd5b5061035961052e366004613475565b610d39565b34801561053f57600080fd5b5061035961054e36600461361a565b610dd4565b34801561055f57600080fd5b5061035961056e366004613644565b610e72565b34801561057f57600080fd5b5061035961058e3660046135c2565b610ebb565b34801561059f57600080fd5b506103596105ae3660046136a8565b610f42565b3480156105bf57600080fd5b5061039d6105ce366004613475565b610f69565b3480156105df57600080fd5b50610370610f74565b3480156105f457600080fd5b506103fb6106033660046136e4565b611002565b34801561061457600080fd5b50610359611051565b34801561062957600080fd5b50600f5461063d906001600160801b031681565b6040516001600160801b039091168152602001610330565b34801561066157600080fd5b50610359611065565b6103596106783660046136ff565b6110dc565b34801561068957600080fd5b50610359610698366004613475565b611171565b3480156106a957600080fd5b506103596106b83660046137b6565b61119e565b3480156106c957600080fd5b50600c546001600160a01b031661039d565b3480156106e757600080fd5b506103246106f63660046135f7565b6112a8565b34801561070757600080fd5b506103596107163660046135c2565b6112d3565b34801561072757600080fd5b50610370611335565b34801561073c57600080fd5b5061035961074b3660046136e4565b611344565b34801561075c57600080fd5b506103fb7fe2f4eaae4a9751e85a3e4a7b9587827a877f29914755229b07a7b2da98285f7081565b34801561079057600080fd5b506103fb600081565b3480156107a557600080fd5b506103596107b43660046137ea565b611357565b3480156107c557600080fd5b506103fb6107d43660046136e4565b6001600160a01b03166000908152600e602052604090205490565b6103596107fd366004613821565b61138c565b34801561080e57600080fd5b5061035961081d366004613475565b6113c9565b34801561082e57600080fd5b5061035961083d3660046136e4565b611409565b34801561084e57600080fd5b5061035961085d3660046136e4565b61145a565b34801561086e57600080fd5b5061037061087d366004613475565b61146d565b34801561088e57600080fd5b5061035961089d36600461389d565b6114f1565b3480156108ae57600080fd5b506103596108bd3660046135f7565b61156b565b3480156108ce57600080fd5b50600f5461063d90600160801b90046001600160801b031681565b3480156108f557600080fd5b506103596109043660046138ba565b611590565b34801561091557600080fd5b50600d546001600160a01b031661039d565b34801561093357600080fd5b5061037061170a565b34801561094857600080fd5b5061032461095736600461361a565b6001600160a01b03918216600090815260086020908152604080832093909416825291909152205460ff1690565b34801561099157600080fd5b506103596109a036600461348e565b611717565b3480156109b157600080fd5b506103596109c03660046136e4565b6117bf565b60006109d082611882565b806109df57506109df826118a7565b806109ee57506109ee826118f5565b92915050565b600c546001600160a01b03163314610a1057610a10600061192a565b610a1a8282611934565b5050565b606060038054610a2d906139bb565b80601f0160208091040260200160405190810160405280929190818152602001828054610a59906139bb565b8015610aa65780601f10610a7b57610100808354040283529160200191610aa6565b820191906000526020600020905b815481529060010190602001808311610a8957829003601f168201915b5050505050905090565b6000610abb826119ee565b610ad8576040516333d1c03960e21b815260040160405180910390fd5b506000908152600760205260409020546001600160a01b031690565b600d54600160a01b900460ff1615610b1f57604051638cd22d1960e01b815260040160405180910390fd5b610a1a8282611a23565b600d54600160a01b900460ff1615610b5457604051638cd22d1960e01b815260040160405180910390fd5b610b5f838383611ac3565b505050565b6000828152600a602090815260408083208151808301909252546001600160a01b038116808352600160a01b9091046001600160601b0316928201929092528291610bd95750604080518082019091526009546001600160a01b0381168252600160a01b90046001600160601b031660208201525b602081015160009061271090610bf8906001600160601b031687613a0b565b610c029190613a2a565b91519350909150505b9250929050565b600c546001600160a01b03163314610c2e57610c2e600061192a565b610c3781610ebb565b506010805460ff19166001179055565b6000828152600b6020526040902060010154610c628161192a565b610b5f8383611c54565b6001600160a01b0381163314610ce15760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b610a1a8282611cda565b600080610cfa60005460ff1690565b60ff1611905090565b600d54600160a01b900460ff1615610d2e57604051638cd22d1960e01b815260040160405180910390fd5b610b5f838383611d41565b600f80546001600160801b0316906000610d5283613a4c565b82546001600160801b039182166101009390930a92830291909202199091161790555060105460ff1615610dc657600f8054600160801b90046001600160801b0316906010610da083613a4c565b91906101000a8154816001600160801b0302191690836001600160801b03160217905550505b610dd1816001611d5c565b50565b600054610100900460ff16610dfb5760405162461bcd60e51b8152600401610cd890613a6f565b6001600160a01b038216158015610e1957506001600160a01b038116155b15610e375760405163cd80353560e01b815260040160405180910390fd5b6001600160a01b03821615610e5157610e51600083611c54565b6001600160a01b03811615610e6957610a1a81611e8c565b610a1a82611e8c565b600054610100900460ff16610e995760405162461bcd60e51b8152600401610cd890613a6f565b6003610ea58382613b00565b506004610eb28282613b00565b50600180555050565b600c546001600160a01b03163314610ed757610ed7600061192a565b60105460ff1615610efb57604051633900de5360e01b815260040160405180910390fd5b6012610f078282613b00565b507f6741b2fc379fad678116fe3d4d4b9a1a184ab53ba36b86ad0fa66340b1ab41ad81604051610f379190613462565b60405180910390a150565b600c546001600160a01b03163314610f5e57610f5e600061192a565b610b5f838383611ea5565b60006109ee82611f70565b60128054610f81906139bb565b80601f0160208091040260200160405190810160405280929190818152602001828054610fad906139bb565b8015610ffa5780601f10610fcf57610100808354040283529160200191610ffa565b820191906000526020600020905b815481529060010190602001808311610fdd57829003601f168201915b505050505081565b60006001600160a01b03821661102b576040516323d3ad8160e21b815260040160405180910390fd5b506001600160a01b031660009081526006602052604090205467ffffffffffffffff1690565b611059611fdf565b6110636000611e8c565b565b600d5433906001600160a01b031681146110d35760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b6064820152608401610cd8565b610dd181611e8c565b600f546001600160801b03600160801b82048116916111019160408701359116613bc0565b11156111205760405163b4632d5160e01b815260040160405180910390fd5b600f8054604085013591906000906111429084906001600160801b0316613bd3565b92506101000a8154816001600160801b0302191690836001600160801b03160217905550610b5f838383612039565b600c546001600160a01b0316331461118d5761118d600061192a565b6000908152600a6020526040812055565b600c546001600160a01b031633146111ba576111ba600061192a565b600f546001600160801b03600160801b909104811690821611156111f15760405163c4469e5b60e01b815260040160405180910390fd5b600f546001600160801b03828116600160801b9092041614610dd157600f546001600160801b03908116908216101561123d5760405163e9519eaf60e01b815260040160405180910390fd5b600f54604080516001600160801b03600160801b9093048316815291831660208301527f30009ebdfe108ec5238d9bfdb65c7cd05abaf5879f705788da7feda30d415fb4910160405180910390a1600f80546001600160801b03808416600160801b02911617905550565b6000918252600b602090815260408084206001600160a01b0393909316845291905290205460ff1690565b600c546001600160a01b031633146112ef576112ef600061192a565b7fc9c7c3fe08b88b4df9d4d47ef47d2c43d55c025a0ba88ca442580ed9e7348a16601182604051611321929190613bfa565b60405180910390a16011610a1a8282613b00565b606060048054610a2d906139bb565b61134c611fdf565b610dd1600082611cda565b600d54600160a01b900460ff161561138257604051638cd22d1960e01b815260040160405180910390fd5b610a1a82826120d1565b600d54600160a01b900460ff16156113b757604051638cd22d1960e01b815260040160405180910390fd5b6113c38484848461213d565b50505050565b6113d33382612181565b60408051338152602081018390527f3df5d8f8ab64f627d3b9fb62a5f047e29b7f4c287c9ce1b095ab5465a28ab34c9101610f37565b600054610100900460ff166114305760405162461bcd60e51b8152600401610cd890613a6f565b610dd17fe2f4eaae4a9751e85a3e4a7b9587827a877f29914755229b07a7b2da98285f7082611c54565b611462611fdf565b610dd1600082611c54565b6060611478826119ee565b61149557604051630a14c4b560e41b815260040160405180910390fd5b600061149f6121d5565b905080516000036114bf57604051806020016040528060008152506114ea565b806114c9846121e4565b6040516020016114da929190613c99565b6040516020818303038152906040525b9392505050565b600054610100900460ff166115185760405162461bcd60e51b8152600401610cd890613a6f565b600d805460ff60a01b1916600160a01b8315158102919091179182905560ff91041615610dd1576040517fc2812778e8871cf60af834692db801a7a79df8acead429394ed6c876b992418d90600090a150565b6000828152600b60205260409020600101546115868161192a565b610b5f8383611cda565b600054610100900460ff16158080156115b05750600054600160ff909116105b806115ca5750303b1580156115ca575060005460ff166001145b61162d5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610cd8565b6000805460ff191660011790558015611650576000805461ff0019166101001790555b60405163266c45bb60e11b81523090634cd88b76906116759088908890600401613cc8565b600060405180830381600087803b15801561168f57600080fd5b505af11580156116a3573d6000803e3d6000fd5b505050506116b88a8a8a8a8a8a8a8a8a612228565b80156116fe576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050505050565b60118054610f81906139bb565b600c546001600160a01b0316331461173357611733600061192a565b600f546001600160801b03600160801b820481169161175491849116613bc0565b11156117735760405163b4632d5160e01b815260040160405180910390fd5b600f80548291906000906117919084906001600160801b0316613bd3565b92506101000a8154816001600160801b0302191690836001600160801b03160217905550610a1a82826123f7565b6117c7611fdf565b600d80546001600160a01b0383166001600160a01b031990911681179091556117f8600c546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b600c80546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60006001600160e01b03198216637965db0b60e01b14806109ee57506109ee826118f5565b60006301ffc9a760e01b6001600160e01b0319831614806118d857506380ac58cd60e01b6001600160e01b03198316145b806109ee5750506001600160e01b031916635b5e139f60e01b1490565b60006001600160e01b0319821663152a902d60e11b14806109ee57506301ffc9a760e01b6001600160e01b03198316146109ee565b610dd18133612411565b6127106001600160601b038216111561195f5760405162461bcd60e51b8152600401610cd890613ced565b6001600160a01b0382166119b55760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c6964207265636569766572000000000000006044820152606401610cd8565b604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600955565b600081600111158015611a02575060015482105b80156109ee575050600090815260056020526040902054600160e01b161590565b6000611a2e82610f69565b9050336001600160a01b03821614611a6757611a4a8133610957565b611a67576040516367d9dca160e11b815260040160405180910390fd5b60008281526007602052604080822080546001600160a01b0319166001600160a01b0387811691821790925591518593918516917f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591a4505050565b6000611ace82611f70565b9050836001600160a01b0316816001600160a01b031614611b015760405162a1148160e81b815260040160405180910390fd5b60008281526007602052604090208054611b2d8187335b6001600160a01b039081169116811491141790565b611b5857611b3b8633610957565b611b5857604051632ce44b5f60e11b815260040160405180910390fd5b6001600160a01b038516611b7f57604051633a954ecd60e21b815260040160405180910390fd5b8015611b8a57600082555b6001600160a01b038681166000908152600660205260408082208054600019019055918716808252919020805460010190554260a01b17600160e11b17600085815260056020526040812091909155600160e11b84169003611c1c57600184016000818152600560205260408120549003611c1a576001548114611c1a5760008181526005602052604090208490555b505b83856001600160a01b0316876001600160a01b031660008051602061404583398151915260405160405180910390a45b505050505050565b611c5e82826112a8565b610a1a576000828152600b602090815260408083206001600160a01b03851684529091529020805460ff19166001179055611c963390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b611ce482826112a8565b15610a1a576000828152600b602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b610b5f8383836040518060200160405280600081525061138c565b6000611d6783611f70565b905080600080611d8586600090815260076020526040902080549091565b915091508415611dc557611d9a818433611b18565b611dc557611da88333610957565b611dc557604051632ce44b5f60e11b815260040160405180910390fd5b8015611dd057600082555b6001600160a01b038316600081815260066020526040902080546001600160801b030190554260a01b17600360e01b17600087815260056020526040812091909155600160e11b85169003611e5557600186016000818152600560205260408120549003611e53576001548114611e535760008181526005602052604090208590555b505b60405186906000906001600160a01b03861690600080516020614045833981519152908390a4505060028054600101905550505050565b600d80546001600160a01b0319169055610dd181611830565b6127106001600160601b0382161115611ed05760405162461bcd60e51b8152600401610cd890613ced565b6001600160a01b038216611f265760405162461bcd60e51b815260206004820152601b60248201527f455243323938313a20496e76616c696420706172616d657465727300000000006044820152606401610cd8565b6040805180820182526001600160a01b0393841681526001600160601b0392831660208083019182526000968752600a90529190942093519051909116600160a01b029116179055565b60008180600111611fc657600154811015611fc65760008181526005602052604081205490600160e01b82169003611fc4575b806000036114ea575060001901600081815260056020526040902054611fa3565b505b604051636f96cda160e11b815260040160405180910390fd5b600c546001600160a01b031633146110635760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610cd8565b61204483838361246a565b612052338460600135612181565b600061206460e0850160c086016136e4565b6001600160a01b0316036120805761207b836124d3565b612089565b61208983612630565b612093338461275a565b7fd787a81976c7ae74647fc73d6574ab6333e0d888828e3b934b2570a70b78384e82826040516120c4929190613d60565b60405180910390a1505050565b3360008181526008602090815260408083206001600160a01b03871680855290835292819020805460ff191686151590811790915590519081529192917f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a35050565b612148848484610b29565b6001600160a01b0383163b156113c35761216484848484612768565b6113c3576040516368d2bf6b60e11b815260040160405180910390fd5b6001600160a01b0382166000908152600e602052604090205481116121b9576040516313b42f4d60e31b815260040160405180910390fd5b6001600160a01b039091166000908152600e6020526040902055565b606060128054610a2d906139bb565b606060a06040510180604052602081039150506000815280825b600183039250600a81066030018353600a9004806121fe5750819003601f19909101908152919050565b60405163485cc95560e01b81526001600160a01b03808b16600483015289166024820152309063485cc95590604401600060405180830381600087803b15801561227157600080fd5b505af1158015612285573d6000803e3d6000fd5b505060405163d53a822f60e01b8152871515600482015230925063d53a822f9150602401600060405180830381600087803b1580156122c357600080fd5b505af11580156122d7573d6000803e3d6000fd5b505060405163189acdbd60e31b81526001600160a01b038a16600482015230925063c4d66de89150602401600060405180830381600087803b15801561231c57600080fd5b505af1158015612330573d6000803e3d6000fd5b5050505083601390816123439190613b00565b5060146123508482613b00565b50856001600160801b031660000361237b576040516363868c5560e11b815260040160405180910390fd5b8151156123c757601261238e8382613b00565b507f6741b2fc379fad678116fe3d4d4b9a1a184ab53ba36b86ad0fa66340b1ab41ad826040516123be9190613462565b60405180910390a15b600f80546001600160801b03808916600160801b0291161790556123ea81612854565b6011906116fe9082613b00565b610a1a8282604051806020016040528060008152506128a6565b61241b82826112a8565b610a1a5761242881612913565b612433836020612925565b604051602001612444929190613d74565b60408051601f198184030181529082905262461bcd60e51b8252610cd891600401613462565b428360800135101561248f5760405163455c7d6b60e11b815260040160405180910390fd5b6124998380613de9565b90506124a86020850185613de9565b9050146124c85760405163154c1d8360e11b815260040160405180910390fd5b610b5f838383612ac1565b6000805b6124e46020840184613de9565b905081101561260f576124fa6020840184613de9565b8281811061250a5761250a613e33565b905060200201358261251c9190613bc0565b9150600061252d6020850185613de9565b8381811061253d5761253d613e33565b9050602002013511156125fd5760006125568480613de9565b8381811061256657612566613e33565b905060200201602081019061257b91906136e4565b6001600160a01b0316036125a257604051631e7d738760e21b815260040160405180910390fd5b6125fd6125af8480613de9565b838181106125bf576125bf613e33565b90506020020160208101906125d491906136e4565b6125e16020860186613de9565b848181106125f1576125f1613e33565b90506020020135612b61565b8061260781613e49565b9150506124d7565b50348114610a1a576040516358e66ccd60e11b815260040160405180910390fd5b60005b6126406020830183613de9565b9050811015610a1a5760006126586020840184613de9565b8381811061266857612668613e33565b9050602002013511156127485760006126818380613de9565b8381811061269157612691613e33565b90506020020160208101906126a691906136e4565b6001600160a01b0316036126cd57604051631e7d738760e21b815260040160405180910390fd5b612748336126db8480613de9565b848181106126eb576126eb613e33565b905060200201602081019061270091906136e4565b61270d6020860186613de9565b8581811061271d5761271d613e33565b905060200201358560c001602081019061273791906136e4565b6001600160a01b0316929190612c7a565b8061275281613e49565b915050612633565b610a1a8282604001356123f7565b604051630a85bd0160e11b81526000906001600160a01b0385169063150b7a029061279d903390899088908890600401613e62565b6020604051808303816000875af19250505080156127d8575060408051601f3d908101601f191682019092526127d591810190613e9f565b60015b612836573d808015612806576040519150601f19603f3d011682016040523d82523d6000602084013e61280b565b606091505b50805160000361282e576040516368d2bf6b60e11b815260040160405180910390fd5b805181602001fd5b6001600160e01b031916630a85bd0160e11b1490505b949350505050565b6060600082511161287457604051806020016040528060008152506109ee565b81612880306014612925565b604051602001612891929190613c99565b60405160208183030381529060405292915050565b6128b08383612cd4565b6001600160a01b0383163b15610b5f576001548281035b6128da6000868380600101945086612768565b6128f7576040516368d2bf6b60e11b815260040160405180910390fd5b8181106128c757816001541461290c57600080fd5b5050505050565b60606109ee6001600160a01b03831660145b60606000612934836002613a0b565b61293f906002613bc0565b67ffffffffffffffff81111561295757612957613516565b6040519080825280601f01601f191660200182016040528015612981576020820181803683370190505b509050600360fc1b8160008151811061299c5761299c613e33565b60200101906001600160f81b031916908160001a905350600f60fb1b816001815181106129cb576129cb613e33565b60200101906001600160f81b031916908160001a90535060006129ef846002613a0b565b6129fa906001613bc0565b90505b6001811115612a72576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110612a2e57612a2e613e33565b1a60f81b828281518110612a4457612a44613e33565b60200101906001600160f81b031916908160001a90535060049490941c93612a6b81613ebc565b90506129fd565b5083156114ea5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610cd8565b6000612ad4612acf85612dae565b612e70565b90506000612b188285858080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250612eab92505050565b9050612b447fe2f4eaae4a9751e85a3e4a7b9587827a877f29914755229b07a7b2da98285f70826112a8565b61290c57604051638baa579f60e01b815260040160405180910390fd5b80471015612bb15760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e63650000006044820152606401610cd8565b6000826001600160a01b03168260405160006040518083038185875af1925050503d8060008114612bfe576040519150601f19603f3d011682016040523d82523d6000602084013e612c03565b606091505b5050905080610b5f5760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d617920686176652072657665727465640000000000006064820152608401610cd8565b604080516001600160a01b0385811660248301528416604482015260648082018490528251808303909101815260849091019091526020810180516001600160e01b03166323b872dd60e01b1790526113c3908590612ecf565b6001546000829003612cf95760405163b562e8dd60e01b815260040160405180910390fd5b6001600160a01b03831660008181526006602090815260408083208054680100000000000000018802019055848352600590915281206001851460e11b4260a01b178317905582840190839083906000805160206140458339815191528180a4600183015b818114612d845780836000600080516020614045833981519152600080a4600101612d5e565b5081600003612da557604051622e076360e81b815260040160405180910390fd5b60015550505050565b6000612dba8280613de9565b612dc76020850185613de9565b604051602001612dda9493929190613ed3565b60408051601f198184030181529181528301356060840135608085013560a0860135612e0c60e0880160c089016136e4565b612e1960e0890189613f4f565b333046604051602001612e359a99989796959493929190613f96565b60408051601f1981840301815290829052612e539291602001613c99565b604051602081830303815290604052805190602001209050919050565b6040517f19457468657265756d205369676e6564204d6573736167653a0a3332000000006020820152603c8101829052600090605c01612e53565b6000806000612eba8585612fa1565b91509150612ec781612fe3565b509392505050565b6000612f24826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b031661312d9092919063ffffffff16565b805190915015610b5f5780806020019051810190612f429190613ff5565b610b5f5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610cd8565b6000808251604103612fd75760208301516040840151606085015160001a612fcb8782858561313c565b94509450505050610c0b565b50600090506002610c0b565b6000816004811115612ff757612ff7614012565b03612fff5750565b600181600481111561301357613013614012565b036130605760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e617475726500000000000000006044820152606401610cd8565b600281600481111561307457613074614012565b036130c15760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e677468006044820152606401610cd8565b60038160048111156130d5576130d5614012565b03610dd15760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c604482015261756560f01b6064820152608401610cd8565b606061284c8484600085613200565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083111561317357506000905060036131f7565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa1580156131c7573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166131f0576000600192509250506131f7565b9150600090505b94509492505050565b6060824710156132615760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610cd8565b600080866001600160a01b0316858760405161327d9190614028565b60006040518083038185875af1925050503d80600081146132ba576040519150601f19603f3d011682016040523d82523d6000602084013e6132bf565b606091505b50915091506132d0878383876132db565b979650505050505050565b6060831561334a578251600003613343576001600160a01b0385163b6133435760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610cd8565b508161284c565b61284c838381511561335f5781518083602001fd5b8060405162461bcd60e51b8152600401610cd89190613462565b6001600160e01b031981168114610dd157600080fd5b6000602082840312156133a157600080fd5b81356114ea81613379565b80356001600160a01b03811681146133c357600080fd5b919050565b80356001600160601b03811681146133c357600080fd5b600080604083850312156133f257600080fd5b6133fb836133ac565b9150613409602084016133c8565b90509250929050565b60005b8381101561342d578181015183820152602001613415565b50506000910152565b6000815180845261344e816020860160208601613412565b601f01601f19169290920160200192915050565b6020815260006114ea6020830184613436565b60006020828403121561348757600080fd5b5035919050565b600080604083850312156134a157600080fd5b6134aa836133ac565b946020939093013593505050565b6000806000606084860312156134cd57600080fd5b6134d6846133ac565b92506134e4602085016133ac565b9150604084013590509250925092565b6000806040838503121561350757600080fd5b50508035926020909101359150565b634e487b7160e01b600052604160045260246000fd5b600067ffffffffffffffff8084111561354757613547613516565b604051601f8501601f19908116603f0116810190828211818310171561356f5761356f613516565b8160405280935085815286868601111561358857600080fd5b858560208301376000602087830101525050509392505050565b600082601f8301126135b357600080fd5b6114ea8383356020850161352c565b6000602082840312156135d457600080fd5b813567ffffffffffffffff8111156135eb57600080fd5b61284c848285016135a2565b6000806040838503121561360a57600080fd5b82359150613409602084016133ac565b6000806040838503121561362d57600080fd5b613636836133ac565b9150613409602084016133ac565b6000806040838503121561365757600080fd5b823567ffffffffffffffff8082111561366f57600080fd5b61367b868387016135a2565b9350602085013591508082111561369157600080fd5b5061369e858286016135a2565b9150509250929050565b6000806000606084860312156136bd57600080fd5b833592506136cd602085016133ac565b91506136db604085016133c8565b90509250925092565b6000602082840312156136f657600080fd5b6114ea826133ac565b60008060006040848603121561371457600080fd5b833567ffffffffffffffff8082111561372c57600080fd5b90850190610100828803121561374157600080fd5b9093506020850135908082111561375757600080fd5b818601915086601f83011261376b57600080fd5b81358181111561377a57600080fd5b87602082850101111561378c57600080fd5b6020830194508093505050509250925092565b80356001600160801b03811681146133c357600080fd5b6000602082840312156137c857600080fd5b6114ea8261379f565b8015158114610dd157600080fd5b80356133c3816137d1565b600080604083850312156137fd57600080fd5b613806836133ac565b91506020830135613816816137d1565b809150509250929050565b6000806000806080858703121561383757600080fd5b613840856133ac565b935061384e602086016133ac565b925060408501359150606085013567ffffffffffffffff81111561387157600080fd5b8501601f8101871361388257600080fd5b6138918782356020840161352c565b91505092959194509250565b6000602082840312156138af57600080fd5b81356114ea816137d1565b60008060008060008060008060006101208a8c0312156138d957600080fd5b6138e28a6133ac565b98506138f060208b016133ac565b97506138fe60408b016133ac565b965061390c60608b0161379f565b955061391a60808b016137df565b945060a08a013567ffffffffffffffff8082111561393757600080fd5b6139438d838e016135a2565b955060c08c013591508082111561395957600080fd5b6139658d838e016135a2565b945060e08c013591508082111561397b57600080fd5b6139878d838e016135a2565b93506101008c013591508082111561399e57600080fd5b506139ab8c828d016135a2565b9150509295985092959850929598565b600181811c908216806139cf57607f821691505b6020821081036139ef57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b6000816000190483118215151615613a2557613a256139f5565b500290565b600082613a4757634e487b7160e01b600052601260045260246000fd5b500490565b60006001600160801b03821680613a6557613a656139f5565b6000190192915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b601f821115610b5f57600081815260208120601f850160051c81016020861015613ae15750805b601f850160051c820191505b81811015611c4c57828155600101613aed565b815167ffffffffffffffff811115613b1a57613b1a613516565b613b2e81613b2884546139bb565b84613aba565b602080601f831160018114613b635760008415613b4b5750858301515b600019600386901b1c1916600185901b178555611c4c565b600085815260208120601f198616915b82811015613b9257888601518255948401946001909101908401613b73565b5085821015613bb05787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b808201808211156109ee576109ee6139f5565b6001600160801b03818116838216019080821115613bf357613bf36139f5565b5092915050565b604081526000808454613c0c816139bb565b8060408601526060600180841660008114613c2e5760018114613c4857613c79565b60ff1985168884015283151560051b880183019550613c79565b8960005260208060002060005b86811015613c705781548b8201870152908401908201613c55565b8a018501975050505b50505050508281036020840152613c908185613436565b95945050505050565b60008351613cab818460208801613412565b835190830190613cbf818360208801613412565b01949350505050565b604081526000613cdb6040830185613436565b8281036020840152613c908185613436565b6020808252602a908201527f455243323938313a20726f79616c7479206665652077696c6c206578636565646040820152692073616c65507269636560b01b606082015260800190565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60208152600061284c602083018486613d37565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613dac816017850160208801613412565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351613ddd816028840160208801613412565b01602801949350505050565b6000808335601e19843603018112613e0057600080fd5b83018035915067ffffffffffffffff821115613e1b57600080fd5b6020019150600581901b3603821315610c0b57600080fd5b634e487b7160e01b600052603260045260246000fd5b600060018201613e5b57613e5b6139f5565b5060010190565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090613e9590830184613436565b9695505050505050565b600060208284031215613eb157600080fd5b81516114ea81613379565b600081613ecb57613ecb6139f5565b506000190190565b6040808252810184905260008560608301825b87811015613f14576001600160a01b03613eff846133ac565b16825260209283019290910190600101613ee6565b5083810360208501528481526001600160fb1b03851115613f3457600080fd5b8460051b915081866020830137016020019695505050505050565b6000808335601e19843603018112613f6657600080fd5b83018035915067ffffffffffffffff821115613f8157600080fd5b602001915036819003821315610c0b57600080fd5b60006101208c83528b60208401528a604084015289606084015260018060a01b03808a1660808501528160a0850152613fd2828501898b613d37565b96811660c08501529490941660e083015250610100015250979650505050505050565b60006020828403121561400757600080fd5b81516114ea816137d1565b634e487b7160e01b600052602160045260246000fd5b6000825161403a818460208701613412565b919091019291505056feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa164736f6c6343000810000a
Loading...
Loading
Loading...
Loading
Loading...
Loading
0x8CBc7733fa63521F97B19a9659819D77dD28A61e
Net Worth in USD
$0.00
Net Worth in ETH
0
Multichain Portfolio | 35 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
Loading...
Loading
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.