Overview
APE Balance
APE Value
$0.00More Info
Private Name Tags
ContractCreator
TokenTracker
Multichain Info
Latest 25 from a total of 1,709 transactions
| Transaction Hash |
|
Block
|
From
|
To
|
|||||
|---|---|---|---|---|---|---|---|---|---|
| Set Approval For... | 32422516 | 9 days ago | IN | 0 APE | 0.00248268 | ||||
| Set Approval For... | 32422488 | 9 days ago | IN | 0 APE | 0.00248268 | ||||
| Set Approval For... | 31152719 | 37 days ago | IN | 0 APE | 0.00247414 | ||||
| Safe Transfer Fr... | 30384316 | 49 days ago | IN | 0 APE | 0.00082757 | ||||
| Set Approval For... | 26432476 | 78 days ago | IN | 0 APE | 0.00061891 | ||||
| Set Approval For... | 26352825 | 79 days ago | IN | 0 APE | 0.00062105 | ||||
| Set Approval For... | 25282814 | 95 days ago | IN | 0 APE | 0.00062105 | ||||
| Set Approval For... | 25084266 | 100 days ago | IN | 0 APE | 0.00062105 | ||||
| Safe Transfer Fr... | 24870622 | 105 days ago | IN | 0 APE | 0.00082724 | ||||
| Set Approval For... | 24715180 | 109 days ago | IN | 0 APE | 0.00061891 | ||||
| Set Approval For... | 23975743 | 125 days ago | IN | 0 APE | 0.00117807 | ||||
| Set Approval For... | 23536835 | 131 days ago | IN | 0 APE | 0.00061891 | ||||
| Set Approval For... | 23321429 | 138 days ago | IN | 0 APE | 0.00062105 | ||||
| Set Approval For... | 23147577 | 141 days ago | IN | 0 APE | 0.00062105 | ||||
| Set Approval For... | 23147539 | 141 days ago | IN | 0 APE | 0.00062105 | ||||
| Set Approval For... | 23144431 | 142 days ago | IN | 0 APE | 0.00062105 | ||||
| Set Approval For... | 21508102 | 157 days ago | IN | 0 APE | 0.00062105 | ||||
| Set Approval For... | 21508062 | 157 days ago | IN | 0 APE | 0.00062105 | ||||
| Set Approval For... | 21191443 | 158 days ago | IN | 0 APE | 0.00061891 | ||||
| Set Approval For... | 20745504 | 162 days ago | IN | 0 APE | 0.00062105 | ||||
| Set Approval For... | 20063351 | 177 days ago | IN | 0 APE | 0.00117807 | ||||
| Set Approval For... | 20063339 | 177 days ago | IN | 0 APE | 0.00117593 | ||||
| Set Approval For... | 19668422 | 185 days ago | IN | 0 APE | 0.00117593 | ||||
| Set Approval For... | 19556972 | 188 days ago | IN | 0 APE | 0.00117807 | ||||
| Set Approval For... | 19555763 | 188 days ago | IN | 0 APE | 0.00117593 |
View more zero value Internal Transactions in Advanced View mode
Cross-Chain Transactions
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.23;
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "@limitbreak/creator-token-contracts/contracts/access/OwnableBasic.sol";
import "@limitbreak/creator-token-contracts/contracts/access/OwnableInitializable.sol";
import "@limitbreak/creator-token-contracts/contracts/erc1155c/ERC1155C.sol";
import "@limitbreak/creator-token-contracts/contracts/programmable-royalties/BasicRoyalties.sol";
contract GeezNutz is ERC1155C, BasicRoyalties, OwnableBasic {
using Strings for uint256;
string public name;
string public symbol;
string public baseUri;
mapping(uint256 => uint256) private _totalSupply;
constructor(
address royaltyReceiver_,
uint96 royaltyFeeNumerator_,
string memory _baseUri,
string memory name_,
string memory symbol_
)
BasicRoyalties(royaltyReceiver_, royaltyFeeNumerator_)
ERC1155OpenZeppelin(_baseUri)
{
name = name_;
symbol = symbol_;
baseUri = _baseUri;
}
function airdrop(
uint256 _tokenId,
address[] calldata _recipients,
uint256[] calldata _amounts
) external {
_requireCallerIsContractOwner();
require(
_recipients.length == _amounts.length,
"Mismatched recipients and amounts"
);
for (uint256 i = 0; i < _recipients.length; i++) {
_mint(_recipients[i], _tokenId, _amounts[i], "");
}
}
function burn(address _from, uint256 _tokenId, uint256 _amount) external {
require(
msg.sender == _from || isApprovedForAll(_from, msg.sender),
"Caller is not owner nor approved"
);
require(
balanceOf(_from, _tokenId) >= _amount,
"Insufficient balance to burn"
);
_burn(_from, _tokenId, _amount);
}
function totalSupply(uint256 _tokenId) public view returns (uint256) {
return _totalSupply[_tokenId];
}
function setBaseURI(string memory _baseUri) public {
_requireCallerIsContractOwner();
baseUri = _baseUri;
}
function uri(
uint256 _tokenId
) public view override returns (string memory) {
return
string(
abi.encodePacked(
super.uri(_tokenId),
_tokenId.toString(),
".json"
)
);
}
function setDefaultRoyalty(address receiver, uint96 feeNumerator) public {
_requireCallerIsContractOwner();
_setDefaultRoyalty(receiver, feeNumerator);
}
function setTokenRoyalty(
uint256 tokenId,
address receiver,
uint96 feeNumerator
) public {
_requireCallerIsContractOwner();
_setTokenRoyalty(tokenId, receiver, feeNumerator);
}
function supportsInterface(
bytes4 interfaceId
) public view virtual override(ERC1155C, ERC2981) returns (bool) {
return super.supportsInterface(interfaceId);
}
function _mint(
address to,
uint256 tokenId,
uint256 amount,
bytes memory data
) internal override {
super._mint(to, tokenId, amount, data);
_totalSupply[tokenId] += amount;
}
function _burn(
address from,
uint256 tokenId,
uint256 amount
) internal override {
super._burn(from, tokenId, amount);
_totalSupply[tokenId] -= amount;
}
function withdraw() external {
_requireCallerIsContractOwner();
uint256 balance = address(this).balance;
require(balance > 0, "No APE to withdraw");
payable(msg.sender).transfer(balance);
}
function withdrawTokens(address tokenAddress) external {
_requireCallerIsContractOwner();
IERC20 token = IERC20(tokenAddress);
uint256 balance = token.balanceOf(address(this));
require(balance > 0, "No tokens to withdraw");
require(token.transfer(msg.sender, balance), "Token transfer failed");
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "./OwnablePermissions.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
abstract contract OwnableBasic is OwnablePermissions, Ownable {
function _requireCallerIsContractOwner() internal view virtual override {
_checkOwner();
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "./OwnablePermissions.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
abstract contract OwnableInitializable is OwnablePermissions, Ownable {
error InitializableOwnable__OwnerAlreadyInitialized();
bool private _ownerInitialized;
/**
* @dev When EIP-1167 is used to clone a contract that inherits Ownable permissions,
* this is required to assign the initial contract owner, as the constructor is
* not called during the cloning process.
*/
function initializeOwner(address owner_) public {
if (owner() != address(0) || _ownerInitialized) {
revert InitializableOwnable__OwnerAlreadyInitialized();
}
_transferOwnership(owner_);
}
function _requireCallerIsContractOwner() internal view virtual override {
_checkOwner();
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/utils/Context.sol";
abstract contract OwnablePermissions is Context {
function _requireCallerIsContractOwner() internal view virtual;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../utils/CreatorTokenBase.sol";
import "../token/erc1155/ERC1155OpenZeppelin.sol";
/**
* @title ERC1155C
* @author Limit Break, Inc.
* @notice Extends OpenZeppelin's ERC1155 implementation with Creator Token functionality, which
* allows the contract owner to update the transfer validation logic by managing a security policy in
* an external transfer validation security policy registry. See {CreatorTokenTransferValidator}.
*/
abstract contract ERC1155C is ERC1155OpenZeppelin, CreatorTokenBase {
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(ICreatorToken).interfaceId || super.supportsInterface(interfaceId);
}
/// @dev Ties the open-zeppelin _beforeTokenTransfer hook to more granular transfer validation logic
function _beforeTokenTransfer(
address /*operator*/,
address from,
address to,
uint256[] memory ids,
uint256[] memory /*amounts*/,
bytes memory /*data*/
) internal virtual override {
uint256 idsArrayLength = ids.length;
for (uint256 i = 0; i < idsArrayLength;) {
_validateBeforeTransfer(from, to, ids[i]);
unchecked {
++i;
}
}
}
/// @dev Ties the open-zeppelin _afterTokenTransfer hook to more granular transfer validation logic
function _afterTokenTransfer(
address /*operator*/,
address from,
address to,
uint256[] memory ids,
uint256[] memory /*amounts*/,
bytes memory /*data*/
) internal virtual override {
uint256 idsArrayLength = ids.length;
for (uint256 i = 0; i < idsArrayLength;) {
_validateAfterTransfer(from, to, ids[i]);
unchecked {
++i;
}
}
}
}
/**
* @title ERC1155CInitializable
* @author Limit Break, Inc.
* @notice Initializable implementation of ERC1155C to allow for EIP-1167 proxy clones.
*/
abstract contract ERC1155CInitializable is ERC1155OpenZeppelinInitializable, CreatorTokenBase {
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(ICreatorToken).interfaceId || super.supportsInterface(interfaceId);
}
/// @dev Ties the open-zeppelin _beforeTokenTransfer hook to more granular transfer validation logic
function _beforeTokenTransfer(
address /*operator*/,
address from,
address to,
uint256[] memory ids,
uint256[] memory /*amounts*/,
bytes memory /*data*/
) internal virtual override {
uint256 idsArrayLength = ids.length;
for (uint256 i = 0; i < idsArrayLength;) {
_validateBeforeTransfer(from, to, ids[i]);
unchecked {
++i;
}
}
}
/// @dev Ties the open-zeppelin _afterTokenTransfer hook to more granular transfer validation logic
function _afterTokenTransfer(
address /*operator*/,
address from,
address to,
uint256[] memory ids,
uint256[] memory /*amounts*/,
bytes memory /*data*/
) internal virtual override {
uint256 idsArrayLength = ids.length;
for (uint256 i = 0; i < idsArrayLength;) {
_validateAfterTransfer(from, to, ids[i]);
unchecked {
++i;
}
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../interfaces/ICreatorTokenTransferValidator.sol";
interface ICreatorToken {
event TransferValidatorUpdated(address oldValidator, address newValidator);
function getTransferValidator() external view returns (ICreatorTokenTransferValidator);
function getSecurityPolicy() external view returns (CollectionSecurityPolicy memory);
function getWhitelistedOperators() external view returns (address[] memory);
function getPermittedContractReceivers() external view returns (address[] memory);
function isOperatorWhitelisted(address operator) external view returns (bool);
function isContractReceiverPermitted(address receiver) external view returns (bool);
function isTransferAllowed(address caller, address from, address to) external view returns (bool);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "./IEOARegistry.sol";
import "./ITransferSecurityRegistry.sol";
import "./ITransferValidator.sol";
interface ICreatorTokenTransferValidator is ITransferSecurityRegistry, ITransferValidator, IEOARegistry {}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
interface IEOARegistry is IERC165 {
function isVerifiedEOA(address account) external view returns (bool);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../utils/TransferPolicy.sol";
interface ITransferSecurityRegistry {
event AddedToAllowlist(AllowlistTypes indexed kind, uint256 indexed id, address indexed account);
event CreatedAllowlist(AllowlistTypes indexed kind, uint256 indexed id, string indexed name);
event ReassignedAllowlistOwnership(AllowlistTypes indexed kind, uint256 indexed id, address indexed newOwner);
event RemovedFromAllowlist(AllowlistTypes indexed kind, uint256 indexed id, address indexed account);
event SetAllowlist(AllowlistTypes indexed kind, address indexed collection, uint120 indexed id);
event SetTransferSecurityLevel(address indexed collection, TransferSecurityLevels level);
function createOperatorWhitelist(string calldata name) external returns (uint120);
function createPermittedContractReceiverAllowlist(string calldata name) external returns (uint120);
function reassignOwnershipOfOperatorWhitelist(uint120 id, address newOwner) external;
function reassignOwnershipOfPermittedContractReceiverAllowlist(uint120 id, address newOwner) external;
function renounceOwnershipOfOperatorWhitelist(uint120 id) external;
function renounceOwnershipOfPermittedContractReceiverAllowlist(uint120 id) external;
function setTransferSecurityLevelOfCollection(address collection, TransferSecurityLevels level) external;
function setOperatorWhitelistOfCollection(address collection, uint120 id) external;
function setPermittedContractReceiverAllowlistOfCollection(address collection, uint120 id) external;
function addOperatorToWhitelist(uint120 id, address operator) external;
function addPermittedContractReceiverToAllowlist(uint120 id, address receiver) external;
function removeOperatorFromWhitelist(uint120 id, address operator) external;
function removePermittedContractReceiverFromAllowlist(uint120 id, address receiver) external;
function getCollectionSecurityPolicy(address collection) external view returns (CollectionSecurityPolicy memory);
function getWhitelistedOperators(uint120 id) external view returns (address[] memory);
function getPermittedContractReceivers(uint120 id) external view returns (address[] memory);
function isOperatorWhitelisted(uint120 id, address operator) external view returns (bool);
function isContractReceiverPermitted(uint120 id, address receiver) external view returns (bool);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../utils/TransferPolicy.sol";
interface ITransferValidator {
function applyCollectionTransferPolicy(address caller, address from, address to) external view;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/token/common/ERC2981.sol";
/**
* @title BasicRoyaltiesBase
* @author Limit Break, Inc.
* @dev Base functionality of an NFT mix-in contract implementing the most basic form of programmable royalties.
*/
abstract contract BasicRoyaltiesBase is ERC2981 {
event DefaultRoyaltySet(address indexed receiver, uint96 feeNumerator);
event TokenRoyaltySet(uint256 indexed tokenId, address indexed receiver, uint96 feeNumerator);
function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual override {
super._setDefaultRoyalty(receiver, feeNumerator);
emit DefaultRoyaltySet(receiver, feeNumerator);
}
function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual override {
super._setTokenRoyalty(tokenId, receiver, feeNumerator);
emit TokenRoyaltySet(tokenId, receiver, feeNumerator);
}
}
/**
* @title BasicRoyalties
* @author Limit Break, Inc.
* @notice Constructable BasicRoyalties Contract implementation.
*/
abstract contract BasicRoyalties is BasicRoyaltiesBase {
constructor(address receiver, uint96 feeNumerator) {
_setDefaultRoyalty(receiver, feeNumerator);
}
}
/**
* @title BasicRoyaltiesInitializable
* @author Limit Break, Inc.
* @notice Initializable BasicRoyalties Contract implementation to allow for EIP-1167 clones.
*/
abstract contract BasicRoyaltiesInitializable is BasicRoyaltiesBase {}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../../access/OwnablePermissions.sol";
import "@openzeppelin/contracts/token/ERC1155/ERC1155.sol";
abstract contract ERC1155OpenZeppelinBase is ERC1155 {
}
abstract contract ERC1155OpenZeppelin is ERC1155OpenZeppelinBase {
constructor(string memory uri_) ERC1155(uri_) {}
}
abstract contract ERC1155OpenZeppelinInitializable is OwnablePermissions, ERC1155OpenZeppelinBase {
error ERC1155OpenZeppelinInitializable__AlreadyInitializedERC1155();
bool private _erc1155Initialized;
function initializeERC1155(string memory uri_) public {
_requireCallerIsContractOwner();
if(_erc1155Initialized) {
revert ERC1155OpenZeppelinInitializable__AlreadyInitializedERC1155();
}
_erc1155Initialized = true;
_setURI(uri_);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../access/OwnablePermissions.sol";
import "../interfaces/ICreatorToken.sol";
import "../interfaces/ICreatorTokenTransferValidator.sol";
import "../utils/TransferValidation.sol";
import "@openzeppelin/contracts/interfaces/IERC165.sol";
/**
* @title CreatorTokenBase
* @author Limit Break, Inc.
* @notice CreatorTokenBase is an abstract contract that provides basic functionality for managing token
* transfer policies through an implementation of ICreatorTokenTransferValidator. This contract is intended to be used
* as a base for creator-specific token contracts, enabling customizable transfer restrictions and security policies.
*
* <h4>Features:</h4>
* <ul>Ownable: This contract can have an owner who can set and update the transfer validator.</ul>
* <ul>TransferValidation: Implements the basic token transfer validation interface.</ul>
* <ul>ICreatorToken: Implements the interface for creator tokens, providing view functions for token security policies.</ul>
*
* <h4>Benefits:</h4>
* <ul>Provides a flexible and modular way to implement custom token transfer restrictions and security policies.</ul>
* <ul>Allows creators to enforce policies such as whitelisted operators and permitted contract receivers.</ul>
* <ul>Can be easily integrated into other token contracts as a base contract.</ul>
*
* <h4>Intended Usage:</h4>
* <ul>Use as a base contract for creator token implementations that require advanced transfer restrictions and
* security policies.</ul>
* <ul>Set and update the ICreatorTokenTransferValidator implementation contract to enforce desired policies for the
* creator token.</ul>
*/
abstract contract CreatorTokenBase is OwnablePermissions, TransferValidation, ICreatorToken {
error CreatorTokenBase__InvalidTransferValidatorContract();
error CreatorTokenBase__SetTransferValidatorFirst();
address public constant DEFAULT_TRANSFER_VALIDATOR = address(0x0000721C310194CcfC01E523fc93C9cCcFa2A0Ac);
TransferSecurityLevels public constant DEFAULT_TRANSFER_SECURITY_LEVEL = TransferSecurityLevels.One;
uint120 public constant DEFAULT_OPERATOR_WHITELIST_ID = uint120(1);
ICreatorTokenTransferValidator private transferValidator;
/**
* @notice Allows the contract owner to set the transfer validator to the official validator contract
* and set the security policy to the recommended default settings.
* @dev May be overridden to change the default behavior of an individual collection.
*/
function setToDefaultSecurityPolicy() public virtual {
_requireCallerIsContractOwner();
setTransferValidator(DEFAULT_TRANSFER_VALIDATOR);
ICreatorTokenTransferValidator(DEFAULT_TRANSFER_VALIDATOR).setTransferSecurityLevelOfCollection(address(this), DEFAULT_TRANSFER_SECURITY_LEVEL);
ICreatorTokenTransferValidator(DEFAULT_TRANSFER_VALIDATOR).setOperatorWhitelistOfCollection(address(this), DEFAULT_OPERATOR_WHITELIST_ID);
}
/**
* @notice Allows the contract owner to set the transfer validator to a custom validator contract
* and set the security policy to their own custom settings.
*/
function setToCustomValidatorAndSecurityPolicy(
address validator,
TransferSecurityLevels level,
uint120 operatorWhitelistId,
uint120 permittedContractReceiversAllowlistId) public {
_requireCallerIsContractOwner();
setTransferValidator(validator);
ICreatorTokenTransferValidator(validator).
setTransferSecurityLevelOfCollection(address(this), level);
ICreatorTokenTransferValidator(validator).
setOperatorWhitelistOfCollection(address(this), operatorWhitelistId);
ICreatorTokenTransferValidator(validator).
setPermittedContractReceiverAllowlistOfCollection(address(this), permittedContractReceiversAllowlistId);
}
/**
* @notice Allows the contract owner to set the security policy to their own custom settings.
* @dev Reverts if the transfer validator has not been set.
*/
function setToCustomSecurityPolicy(
TransferSecurityLevels level,
uint120 operatorWhitelistId,
uint120 permittedContractReceiversAllowlistId) public {
_requireCallerIsContractOwner();
ICreatorTokenTransferValidator validator = getTransferValidator();
if (address(validator) == address(0)) {
revert CreatorTokenBase__SetTransferValidatorFirst();
}
validator.setTransferSecurityLevelOfCollection(address(this), level);
validator.setOperatorWhitelistOfCollection(address(this), operatorWhitelistId);
validator.setPermittedContractReceiverAllowlistOfCollection(address(this), permittedContractReceiversAllowlistId);
}
/**
* @notice Sets the transfer validator for the token contract.
*
* @dev Throws when provided validator contract is not the zero address and doesn't support
* the ICreatorTokenTransferValidator interface.
* @dev Throws when the caller is not the contract owner.
*
* @dev <h4>Postconditions:</h4>
* 1. The transferValidator address is updated.
* 2. The `TransferValidatorUpdated` event is emitted.
*
* @param transferValidator_ The address of the transfer validator contract.
*/
function setTransferValidator(address transferValidator_) public {
_requireCallerIsContractOwner();
bool isValidTransferValidator = false;
if(transferValidator_.code.length > 0) {
try IERC165(transferValidator_).supportsInterface(type(ICreatorTokenTransferValidator).interfaceId)
returns (bool supportsInterface) {
isValidTransferValidator = supportsInterface;
} catch {}
}
if(transferValidator_ != address(0) && !isValidTransferValidator) {
revert CreatorTokenBase__InvalidTransferValidatorContract();
}
emit TransferValidatorUpdated(address(transferValidator), transferValidator_);
transferValidator = ICreatorTokenTransferValidator(transferValidator_);
}
/**
* @notice Returns the transfer validator contract address for this token contract.
*/
function getTransferValidator() public view override returns (ICreatorTokenTransferValidator) {
return transferValidator;
}
/**
* @notice Returns the security policy for this token contract, which includes:
* Transfer security level, operator whitelist id, permitted contract receiver allowlist id.
*/
function getSecurityPolicy() public view override returns (CollectionSecurityPolicy memory) {
if (address(transferValidator) != address(0)) {
return transferValidator.getCollectionSecurityPolicy(address(this));
}
return CollectionSecurityPolicy({
transferSecurityLevel: TransferSecurityLevels.Zero,
operatorWhitelistId: 0,
permittedContractReceiversId: 0
});
}
/**
* @notice Returns the list of all whitelisted operators for this token contract.
* @dev This can be an expensive call and should only be used in view-only functions.
*/
function getWhitelistedOperators() public view override returns (address[] memory) {
if (address(transferValidator) != address(0)) {
return transferValidator.getWhitelistedOperators(
transferValidator.getCollectionSecurityPolicy(address(this)).operatorWhitelistId);
}
return new address[](0);
}
/**
* @notice Returns the list of permitted contract receivers for this token contract.
* @dev This can be an expensive call and should only be used in view-only functions.
*/
function getPermittedContractReceivers() public view override returns (address[] memory) {
if (address(transferValidator) != address(0)) {
return transferValidator.getPermittedContractReceivers(
transferValidator.getCollectionSecurityPolicy(address(this)).permittedContractReceiversId);
}
return new address[](0);
}
/**
* @notice Checks if an operator is whitelisted for this token contract.
* @param operator The address of the operator to check.
*/
function isOperatorWhitelisted(address operator) public view override returns (bool) {
if (address(transferValidator) != address(0)) {
return transferValidator.isOperatorWhitelisted(
transferValidator.getCollectionSecurityPolicy(address(this)).operatorWhitelistId, operator);
}
return false;
}
/**
* @notice Checks if a contract receiver is permitted for this token contract.
* @param receiver The address of the receiver to check.
*/
function isContractReceiverPermitted(address receiver) public view override returns (bool) {
if (address(transferValidator) != address(0)) {
return transferValidator.isContractReceiverPermitted(
transferValidator.getCollectionSecurityPolicy(address(this)).permittedContractReceiversId, receiver);
}
return false;
}
/**
* @notice Determines if a transfer is allowed based on the token contract's security policy. Use this function
* to simulate whether or not a transfer made by the specified `caller` from the `from` address to the `to`
* address would be allowed by this token's security policy.
*
* @notice This function only checks the security policy restrictions and does not check whether token ownership
* or approvals are in place.
*
* @param caller The address of the simulated caller.
* @param from The address of the sender.
* @param to The address of the receiver.
* @return True if the transfer is allowed, false otherwise.
*/
function isTransferAllowed(address caller, address from, address to) public view override returns (bool) {
if (address(transferValidator) != address(0)) {
try transferValidator.applyCollectionTransferPolicy(caller, from, to) {
return true;
} catch {
return false;
}
}
return true;
}
/**
* @dev Pre-validates a token transfer, reverting if the transfer is not allowed by this token's security policy.
* Inheriting contracts are responsible for overriding the _beforeTokenTransfer function, or its equivalent
* and calling _validateBeforeTransfer so that checks can be properly applied during token transfers.
*
* @dev Throws when the transfer doesn't comply with the collection's transfer policy, if the transferValidator is
* set to a non-zero address.
*
* @param caller The address of the caller.
* @param from The address of the sender.
* @param to The address of the receiver.
*/
function _preValidateTransfer(
address caller,
address from,
address to,
uint256 /*tokenId*/,
uint256 /*value*/) internal virtual override {
if (address(transferValidator) != address(0)) {
transferValidator.applyCollectionTransferPolicy(caller, from, to);
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
enum AllowlistTypes {
Operators,
PermittedContractReceivers
}
enum ReceiverConstraints {
None,
NoCode,
EOA
}
enum CallerConstraints {
None,
OperatorWhitelistEnableOTC,
OperatorWhitelistDisableOTC
}
enum StakerConstraints {
None,
CallerIsTxOrigin,
EOA
}
enum TransferSecurityLevels {
Zero,
One,
Two,
Three,
Four,
Five,
Six
}
struct TransferSecurityPolicy {
CallerConstraints callerConstraints;
ReceiverConstraints receiverConstraints;
}
struct CollectionSecurityPolicy {
TransferSecurityLevels transferSecurityLevel;
uint120 operatorWhitelistId;
uint120 permittedContractReceiversId;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/utils/Context.sol";
/**
* @title TransferValidation
* @author Limit Break, Inc.
* @notice A mix-in that can be combined with ERC-721 contracts to provide more granular hooks.
* Openzeppelin's ERC721 contract only provides hooks for before and after transfer. This allows
* developers to validate or customize transfers within the context of a mint, a burn, or a transfer.
*/
abstract contract TransferValidation is Context {
error ShouldNotMintToBurnAddress();
/// @dev Inheriting contracts should call this function in the _beforeTokenTransfer function to get more granular hooks.
function _validateBeforeTransfer(address from, address to, uint256 tokenId) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_preValidateMint(_msgSender(), to, tokenId, msg.value);
} else if(toZeroAddress) {
_preValidateBurn(_msgSender(), from, tokenId, msg.value);
} else {
_preValidateTransfer(_msgSender(), from, to, tokenId, msg.value);
}
}
/// @dev Inheriting contracts should call this function in the _afterTokenTransfer function to get more granular hooks.
function _validateAfterTransfer(address from, address to, uint256 tokenId) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_postValidateMint(_msgSender(), to, tokenId, msg.value);
} else if(toZeroAddress) {
_postValidateBurn(_msgSender(), from, tokenId, msg.value);
} else {
_postValidateTransfer(_msgSender(), from, to, tokenId, msg.value);
}
}
/// @dev Optional validation hook that fires before a mint
function _preValidateMint(address caller, address to, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a mint
function _postValidateMint(address caller, address to, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a burn
function _preValidateBurn(address caller, address from, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a burn
function _postValidateBurn(address caller, address from, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a transfer
function _preValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a transfer
function _postValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 value) internal virtual {}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.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. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby disabling any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
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 v4.4.1 (interfaces/IERC165.sol) pragma solidity ^0.8.0; import "../utils/introspection/IERC165.sol";
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.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 (last updated v4.9.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: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC1155/ERC1155.sol)
pragma solidity ^0.8.0;
import "./IERC1155.sol";
import "./IERC1155Receiver.sol";
import "./extensions/IERC1155MetadataURI.sol";
import "../../utils/Address.sol";
import "../../utils/Context.sol";
import "../../utils/introspection/ERC165.sol";
/**
* @dev Implementation of the basic standard multi-token.
* See https://eips.ethereum.org/EIPS/eip-1155
* Originally based on code by Enjin: https://github.com/enjin/erc-1155
*
* _Available since v3.1._
*/
contract ERC1155 is Context, ERC165, IERC1155, IERC1155MetadataURI {
using Address for address;
// Mapping from token ID to account balances
mapping(uint256 => mapping(address => uint256)) private _balances;
// Mapping from account to operator approvals
mapping(address => mapping(address => bool)) private _operatorApprovals;
// Used as the URI for all token types by relying on ID substitution, e.g. https://token-cdn-domain/{id}.json
string private _uri;
/**
* @dev See {_setURI}.
*/
constructor(string memory uri_) {
_setURI(uri_);
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
return
interfaceId == type(IERC1155).interfaceId ||
interfaceId == type(IERC1155MetadataURI).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC1155MetadataURI-uri}.
*
* This implementation returns the same URI for *all* token types. It relies
* on the token type ID substitution mechanism
* https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
*
* Clients calling this function must replace the `\{id\}` substring with the
* actual token type ID.
*/
function uri(uint256) public view virtual override returns (string memory) {
return _uri;
}
/**
* @dev See {IERC1155-balanceOf}.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function balanceOf(address account, uint256 id) public view virtual override returns (uint256) {
require(account != address(0), "ERC1155: address zero is not a valid owner");
return _balances[id][account];
}
/**
* @dev See {IERC1155-balanceOfBatch}.
*
* Requirements:
*
* - `accounts` and `ids` must have the same length.
*/
function balanceOfBatch(
address[] memory accounts,
uint256[] memory ids
) public view virtual override returns (uint256[] memory) {
require(accounts.length == ids.length, "ERC1155: accounts and ids length mismatch");
uint256[] memory batchBalances = new uint256[](accounts.length);
for (uint256 i = 0; i < accounts.length; ++i) {
batchBalances[i] = balanceOf(accounts[i], ids[i]);
}
return batchBalances;
}
/**
* @dev See {IERC1155-setApprovalForAll}.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_setApprovalForAll(_msgSender(), operator, approved);
}
/**
* @dev See {IERC1155-isApprovedForAll}.
*/
function isApprovedForAll(address account, address operator) public view virtual override returns (bool) {
return _operatorApprovals[account][operator];
}
/**
* @dev See {IERC1155-safeTransferFrom}.
*/
function safeTransferFrom(
address from,
address to,
uint256 id,
uint256 amount,
bytes memory data
) public virtual override {
require(
from == _msgSender() || isApprovedForAll(from, _msgSender()),
"ERC1155: caller is not token owner or approved"
);
_safeTransferFrom(from, to, id, amount, data);
}
/**
* @dev See {IERC1155-safeBatchTransferFrom}.
*/
function safeBatchTransferFrom(
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) public virtual override {
require(
from == _msgSender() || isApprovedForAll(from, _msgSender()),
"ERC1155: caller is not token owner or approved"
);
_safeBatchTransferFrom(from, to, ids, amounts, data);
}
/**
* @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `from` must have a balance of tokens of type `id` of at least `amount`.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function _safeTransferFrom(
address from,
address to,
uint256 id,
uint256 amount,
bytes memory data
) internal virtual {
require(to != address(0), "ERC1155: transfer to the zero address");
address operator = _msgSender();
uint256[] memory ids = _asSingletonArray(id);
uint256[] memory amounts = _asSingletonArray(amount);
_beforeTokenTransfer(operator, from, to, ids, amounts, data);
uint256 fromBalance = _balances[id][from];
require(fromBalance >= amount, "ERC1155: insufficient balance for transfer");
unchecked {
_balances[id][from] = fromBalance - amount;
}
_balances[id][to] += amount;
emit TransferSingle(operator, from, to, id, amount);
_afterTokenTransfer(operator, from, to, ids, amounts, data);
_doSafeTransferAcceptanceCheck(operator, from, to, id, amount, data);
}
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_safeTransferFrom}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function _safeBatchTransferFrom(
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) internal virtual {
require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch");
require(to != address(0), "ERC1155: transfer to the zero address");
address operator = _msgSender();
_beforeTokenTransfer(operator, from, to, ids, amounts, data);
for (uint256 i = 0; i < ids.length; ++i) {
uint256 id = ids[i];
uint256 amount = amounts[i];
uint256 fromBalance = _balances[id][from];
require(fromBalance >= amount, "ERC1155: insufficient balance for transfer");
unchecked {
_balances[id][from] = fromBalance - amount;
}
_balances[id][to] += amount;
}
emit TransferBatch(operator, from, to, ids, amounts);
_afterTokenTransfer(operator, from, to, ids, amounts, data);
_doSafeBatchTransferAcceptanceCheck(operator, from, to, ids, amounts, data);
}
/**
* @dev Sets a new URI for all token types, by relying on the token type ID
* substitution mechanism
* https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
*
* By this mechanism, any occurrence of the `\{id\}` substring in either the
* URI or any of the amounts in the JSON file at said URI will be replaced by
* clients with the token type ID.
*
* For example, the `https://token-cdn-domain/\{id\}.json` URI would be
* interpreted by clients as
* `https://token-cdn-domain/000000000000000000000000000000000000000000000000000000000004cce0.json`
* for token type ID 0x4cce0.
*
* See {uri}.
*
* Because these URIs cannot be meaningfully represented by the {URI} event,
* this function emits no events.
*/
function _setURI(string memory newuri) internal virtual {
_uri = newuri;
}
/**
* @dev Creates `amount` tokens of token type `id`, and assigns them to `to`.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function _mint(address to, uint256 id, uint256 amount, bytes memory data) internal virtual {
require(to != address(0), "ERC1155: mint to the zero address");
address operator = _msgSender();
uint256[] memory ids = _asSingletonArray(id);
uint256[] memory amounts = _asSingletonArray(amount);
_beforeTokenTransfer(operator, address(0), to, ids, amounts, data);
_balances[id][to] += amount;
emit TransferSingle(operator, address(0), to, id, amount);
_afterTokenTransfer(operator, address(0), to, ids, amounts, data);
_doSafeTransferAcceptanceCheck(operator, address(0), to, id, amount, data);
}
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function _mintBatch(
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) internal virtual {
require(to != address(0), "ERC1155: mint to the zero address");
require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch");
address operator = _msgSender();
_beforeTokenTransfer(operator, address(0), to, ids, amounts, data);
for (uint256 i = 0; i < ids.length; i++) {
_balances[ids[i]][to] += amounts[i];
}
emit TransferBatch(operator, address(0), to, ids, amounts);
_afterTokenTransfer(operator, address(0), to, ids, amounts, data);
_doSafeBatchTransferAcceptanceCheck(operator, address(0), to, ids, amounts, data);
}
/**
* @dev Destroys `amount` tokens of token type `id` from `from`
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `from` must have at least `amount` tokens of token type `id`.
*/
function _burn(address from, uint256 id, uint256 amount) internal virtual {
require(from != address(0), "ERC1155: burn from the zero address");
address operator = _msgSender();
uint256[] memory ids = _asSingletonArray(id);
uint256[] memory amounts = _asSingletonArray(amount);
_beforeTokenTransfer(operator, from, address(0), ids, amounts, "");
uint256 fromBalance = _balances[id][from];
require(fromBalance >= amount, "ERC1155: burn amount exceeds balance");
unchecked {
_balances[id][from] = fromBalance - amount;
}
emit TransferSingle(operator, from, address(0), id, amount);
_afterTokenTransfer(operator, from, address(0), ids, amounts, "");
}
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_burn}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
*/
function _burnBatch(address from, uint256[] memory ids, uint256[] memory amounts) internal virtual {
require(from != address(0), "ERC1155: burn from the zero address");
require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch");
address operator = _msgSender();
_beforeTokenTransfer(operator, from, address(0), ids, amounts, "");
for (uint256 i = 0; i < ids.length; i++) {
uint256 id = ids[i];
uint256 amount = amounts[i];
uint256 fromBalance = _balances[id][from];
require(fromBalance >= amount, "ERC1155: burn amount exceeds balance");
unchecked {
_balances[id][from] = fromBalance - amount;
}
}
emit TransferBatch(operator, from, address(0), ids, amounts);
_afterTokenTransfer(operator, from, address(0), ids, amounts, "");
}
/**
* @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, "ERC1155: setting approval status for self");
_operatorApprovals[owner][operator] = approved;
emit ApprovalForAll(owner, operator, approved);
}
/**
* @dev Hook that is called before any token transfer. This includes minting
* and burning, as well as batched variants.
*
* The same hook is called on both single and batched variants. For single
* transfers, the length of the `ids` and `amounts` arrays will be 1.
*
* Calling conditions (for each `id` and `amount` pair):
*
* - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
* of token type `id` will be transferred to `to`.
* - When `from` is zero, `amount` tokens of token type `id` will be minted
* for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
* will be burned.
* - `from` and `to` are never both zero.
* - `ids` and `amounts` have the same, non-zero length.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _beforeTokenTransfer(
address operator,
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) internal virtual {}
/**
* @dev Hook that is called after any token transfer. This includes minting
* and burning, as well as batched variants.
*
* The same hook is called on both single and batched variants. For single
* transfers, the length of the `id` and `amount` arrays will be 1.
*
* Calling conditions (for each `id` and `amount` pair):
*
* - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
* of token type `id` will be transferred to `to`.
* - When `from` is zero, `amount` tokens of token type `id` will be minted
* for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
* will be burned.
* - `from` and `to` are never both zero.
* - `ids` and `amounts` have the same, non-zero length.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _afterTokenTransfer(
address operator,
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) internal virtual {}
function _doSafeTransferAcceptanceCheck(
address operator,
address from,
address to,
uint256 id,
uint256 amount,
bytes memory data
) private {
if (to.isContract()) {
try IERC1155Receiver(to).onERC1155Received(operator, from, id, amount, data) returns (bytes4 response) {
if (response != IERC1155Receiver.onERC1155Received.selector) {
revert("ERC1155: ERC1155Receiver rejected tokens");
}
} catch Error(string memory reason) {
revert(reason);
} catch {
revert("ERC1155: transfer to non-ERC1155Receiver implementer");
}
}
}
function _doSafeBatchTransferAcceptanceCheck(
address operator,
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) private {
if (to.isContract()) {
try IERC1155Receiver(to).onERC1155BatchReceived(operator, from, ids, amounts, data) returns (
bytes4 response
) {
if (response != IERC1155Receiver.onERC1155BatchReceived.selector) {
revert("ERC1155: ERC1155Receiver rejected tokens");
}
} catch Error(string memory reason) {
revert(reason);
} catch {
revert("ERC1155: transfer to non-ERC1155Receiver implementer");
}
}
}
function _asSingletonArray(uint256 element) private pure returns (uint256[] memory) {
uint256[] memory array = new uint256[](1);
array[0] = element;
return array;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC1155/extensions/IERC1155MetadataURI.sol)
pragma solidity ^0.8.0;
import "../IERC1155.sol";
/**
* @dev Interface of the optional ERC1155MetadataExtension interface, as defined
* in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[EIP].
*
* _Available since v3.1._
*/
interface IERC1155MetadataURI is IERC1155 {
/**
* @dev Returns the URI for token type `id`.
*
* If the `\{id\}` substring is present in the URI, it must be replaced by
* clients with the actual token type ID.
*/
function uri(uint256 id) external view returns (string memory);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC1155/IERC1155.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC1155 compliant contract, as defined in the
* https://eips.ethereum.org/EIPS/eip-1155[EIP].
*
* _Available since v3.1._
*/
interface IERC1155 is IERC165 {
/**
* @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
*/
event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
/**
* @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
* transfers.
*/
event TransferBatch(
address indexed operator,
address indexed from,
address indexed to,
uint256[] ids,
uint256[] values
);
/**
* @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
* `approved`.
*/
event ApprovalForAll(address indexed account, address indexed operator, bool approved);
/**
* @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
*
* If an {URI} event was emitted for `id`, the standard
* https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
* returned by {IERC1155MetadataURI-uri}.
*/
event URI(string value, uint256 indexed id);
/**
* @dev Returns the amount of tokens of token type `id` owned by `account`.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function balanceOf(address account, uint256 id) external view returns (uint256);
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
*
* Requirements:
*
* - `accounts` and `ids` must have the same length.
*/
function balanceOfBatch(
address[] calldata accounts,
uint256[] calldata ids
) external view returns (uint256[] memory);
/**
* @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
*
* Emits an {ApprovalForAll} event.
*
* Requirements:
*
* - `operator` cannot be the caller.
*/
function setApprovalForAll(address operator, bool approved) external;
/**
* @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address account, address operator) external view returns (bool);
/**
* @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
* - `from` must have a balance of tokens of type `id` of at least `amount`.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes calldata data) external;
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function safeBatchTransferFrom(
address from,
address to,
uint256[] calldata ids,
uint256[] calldata amounts,
bytes calldata data
) external;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (token/ERC1155/IERC1155Receiver.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165.sol";
/**
* @dev _Available since v3.1._
*/
interface IERC1155Receiver is IERC165 {
/**
* @dev Handles the receipt of a single ERC1155 token type. This function is
* called at the end of a `safeTransferFrom` after the balance has been updated.
*
* NOTE: To accept the transfer, this must return
* `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
* (i.e. 0xf23a6e61, or its own function selector).
*
* @param operator The address which initiated the transfer (i.e. msg.sender)
* @param from The address which previously owned the token
* @param id The ID of the token being transferred
* @param value The amount of tokens being transferred
* @param data Additional data with no specified format
* @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
*/
function onERC1155Received(
address operator,
address from,
uint256 id,
uint256 value,
bytes calldata data
) external returns (bytes4);
/**
* @dev Handles the receipt of a multiple ERC1155 token types. This function
* is called at the end of a `safeBatchTransferFrom` after the balances have
* been updated.
*
* NOTE: To accept the transfer(s), this must return
* `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
* (i.e. 0xbc197c81, or its own function selector).
*
* @param operator The address which initiated the batch transfer (i.e. msg.sender)
* @param from The address which previously owned the token
* @param ids An array containing ids of each token being transferred (order and length must match values array)
* @param values An array containing amounts of each token being transferred (order and length must match ids array)
* @param data Additional data with no specified format
* @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
*/
function onERC1155BatchReceived(
address operator,
address from,
uint256[] calldata ids,
uint256[] calldata values,
bytes calldata data
) external returns (bytes4);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.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 (last updated v4.9.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
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [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://consensys.net/diligence/blog/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.8.0/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.9.4) (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;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
}// 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 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 (last updated v4.9.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) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return prod0 / denominator;
}
// Make sure the result is less than 2^256. Also prevents denominator == 0.
require(denominator > prod1, "Math: mulDiv overflow");
///////////////////////////////////////////////
// 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 256, 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 << 3) < value ? 1 : 0);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard signed math utilities missing in the Solidity language.
*/
library SignedMath {
/**
* @dev Returns the largest of two signed numbers.
*/
function max(int256 a, int256 b) internal pure returns (int256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two signed numbers.
*/
function min(int256 a, int256 b) internal pure returns (int256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two signed numbers without overflow.
* The result is rounded towards zero.
*/
function average(int256 a, int256 b) internal pure returns (int256) {
// Formula from the book "Hacker's Delight"
int256 x = (a & b) + ((a ^ b) >> 1);
return x + (int256(uint256(x) >> 255) & (a ^ b));
}
/**
* @dev Returns the absolute unsigned value of a signed value.
*/
function abs(int256 n) internal pure returns (uint256) {
unchecked {
// must be unchecked in order to support `n = type(int256).min`
return uint256(n >= 0 ? n : -n);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)
pragma solidity ^0.8.0;
import "./math/Math.sol";
import "./math/SignedMath.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 `int256` to its ASCII `string` decimal representation.
*/
function toString(int256 value) internal pure returns (string memory) {
return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMath.abs(value))));
}
/**
* @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);
}
/**
* @dev Returns true if the two strings are equal.
*/
function equal(string memory a, string memory b) internal pure returns (bool) {
return keccak256(bytes(a)) == keccak256(bytes(b));
}
}{
"optimizer": {
"enabled": true,
"runs": 200
},
"evmVersion": "paris",
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"libraries": {}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"address","name":"royaltyReceiver_","type":"address"},{"internalType":"uint96","name":"royaltyFeeNumerator_","type":"uint96"},{"internalType":"string","name":"_baseUri","type":"string"},{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"CreatorTokenBase__InvalidTransferValidatorContract","type":"error"},{"inputs":[],"name":"CreatorTokenBase__SetTransferValidatorFirst","type":"error"},{"inputs":[],"name":"ShouldNotMintToBurnAddress","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"DefaultRoyaltySet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"TokenRoyaltySet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"TransferBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"TransferSingle","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldValidator","type":"address"},{"indexed":false,"internalType":"address","name":"newValidator","type":"address"}],"name":"TransferValidatorUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"value","type":"string"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"}],"name":"URI","type":"event"},{"inputs":[],"name":"DEFAULT_OPERATOR_WHITELIST_ID","outputs":[{"internalType":"uint120","name":"","type":"uint120"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_TRANSFER_SECURITY_LEVEL","outputs":[{"internalType":"enum TransferSecurityLevels","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_TRANSFER_VALIDATOR","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"address[]","name":"_recipients","type":"address[]"},{"internalType":"uint256[]","name":"_amounts","type":"uint256[]"}],"name":"airdrop","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"}],"name":"balanceOfBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseUri","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_from","type":"address"},{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"getPermittedContractReceivers","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getSecurityPolicy","outputs":[{"components":[{"internalType":"enum TransferSecurityLevels","name":"transferSecurityLevel","type":"uint8"},{"internalType":"uint120","name":"operatorWhitelistId","type":"uint120"},{"internalType":"uint120","name":"permittedContractReceiversId","type":"uint120"}],"internalType":"struct CollectionSecurityPolicy","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getTransferValidator","outputs":[{"internalType":"contract ICreatorTokenTransferValidator","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getWhitelistedOperators","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"isContractReceiverPermitted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"isOperatorWhitelisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"caller","type":"address"},{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"}],"name":"isTransferAllowed","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","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":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"","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":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeBatchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"_baseUri","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"enum TransferSecurityLevels","name":"level","type":"uint8"},{"internalType":"uint120","name":"operatorWhitelistId","type":"uint120"},{"internalType":"uint120","name":"permittedContractReceiversAllowlistId","type":"uint120"}],"name":"setToCustomSecurityPolicy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"},{"internalType":"enum TransferSecurityLevels","name":"level","type":"uint8"},{"internalType":"uint120","name":"operatorWhitelistId","type":"uint120"},{"internalType":"uint120","name":"permittedContractReceiversAllowlistId","type":"uint120"}],"name":"setToCustomValidatorAndSecurityPolicy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"setToDefaultSecurityPolicy","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":"address","name":"transferValidator_","type":"address"}],"name":"setTransferValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"uri","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"tokenAddress","type":"address"}],"name":"withdrawTokens","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
60806040523480156200001157600080fd5b5060405162003ca938038062003ca9833981016040819052620000349162000320565b84848480620000438162000098565b506200005290508282620000aa565b506200006090503362000101565b60076200006e838262000484565b5060086200007d828262000484565b5060096200008c848262000484565b50505050505062000550565b6002620000a6828262000484565b5050565b620000b6828262000153565b6040516001600160601b03821681526001600160a01b038316907f8a8bae378cb731c5c40b632330c6836c2f916f48edb967699c86736f9a6a76ef9060200160405180910390a25050565b600680546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6127106001600160601b0382161115620001c75760405162461bcd60e51b815260206004820152602a60248201527f455243323938313a20726f79616c7479206665652077696c6c206578636565646044820152692073616c65507269636560b01b60648201526084015b60405180910390fd5b6001600160a01b0382166200021f5760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c6964207265636569766572000000000000006044820152606401620001be565b604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600455565b634e487b7160e01b600052604160045260246000fd5b600082601f8301126200028057600080fd5b81516001600160401b03808211156200029d576200029d62000258565b604051601f8301601f19908116603f01168101908282118183101715620002c857620002c862000258565b8160405283815260209250866020858801011115620002e657600080fd5b600091505b838210156200030a5785820183015181830184015290820190620002eb565b6000602085830101528094505050505092915050565b600080600080600060a086880312156200033957600080fd5b85516001600160a01b03811681146200035157600080fd5b60208701519095506001600160601b03811681146200036f57600080fd5b60408701519094506001600160401b03808211156200038d57600080fd5b6200039b89838a016200026e565b94506060880151915080821115620003b257600080fd5b620003c089838a016200026e565b93506080880151915080821115620003d757600080fd5b50620003e6888289016200026e565b9150509295509295909350565b600181811c908216806200040857607f821691505b6020821081036200042957634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156200047f576000816000526020600020601f850160051c810160208610156200045a5750805b601f850160051c820191505b818110156200047b5782815560010162000466565b5050505b505050565b81516001600160401b03811115620004a057620004a062000258565b620004b881620004b18454620003f3565b846200042f565b602080601f831160018114620004f05760008415620004d75750858301515b600019600386901b1c1916600185901b1785556200047b565b600085815260208120601f198616915b82811015620005215788860151825594840194600190910190840162000500565b5085821015620005405787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b61374980620005606000396000f3fe608060405234801561001057600080fd5b50600436106102265760003560e01c80635d4c1d4611610130578063a9fc664e116100b8578063e985e9c51161007c578063e985e9c5146104d6578063f242432a14610512578063f2fde38b14610525578063f5298aca14610538578063fd762d921461054b57600080fd5b8063a9fc664e14610473578063bd85b03914610486578063be537f43146104a6578063d007af5c146104bb578063d5516e7f146104c357600080fd5b80638da5cb5b116100ff5780638da5cb5b1461042c57806395d89b411461043d5780639abc8320146104455780639d645a441461044d578063a22cb4651461046057600080fd5b80635d4c1d46146103e957806361347162146104095780636c3b86991461041c578063715018a61461042457600080fd5b80632a55205a116101b3578063495c8bf911610182578063495c8bf91461037b57806349df728c146103905780634e1273f4146103a357806355f804b3146103c35780635944c753146103d657600080fd5b80632a55205a1461031b5780632e8da8291461034d5780632eb2c2d6146103605780633ccfd60b1461037357600080fd5b806306fdde03116101fa57806306fdde03146102ba578063098144d4146102cf5780630e89341c146102e05780631b25b077146102f35780631c33b3281461030657600080fd5b8062fdd58e1461022b578063014635461461025157806301ffc9a71461028257806304634d8d146102a5575b600080fd5b61023e6102393660046127dd565b61055e565b6040519081526020015b60405180910390f35b61026a71721c310194ccfc01e523fc93c9cccfa2a0ac81565b6040516001600160a01b039091168152602001610248565b61029561029036600461281f565b6105f7565b6040519015158152602001610248565b6102b86102b3366004612858565b610602565b005b6102c2610618565b60405161024891906128dd565b6003546001600160a01b031661026a565b6102c26102ee3660046128f0565b6106a6565b610295610301366004612909565b6106e1565b61030e600181565b6040516102489190612976565b61032e610329366004612984565b61077a565b604080516001600160a01b039093168352602083019190915201610248565b61029561035b3660046129a6565b610828565b6102b861036e366004612b1b565b610934565b6102b8610980565b6103836109f8565b6040516102489190612bc8565b6102b861039e3660046129a6565b610b09565b6103b66103b1366004612c15565b610c82565b6040516102489190612d1d565b6102b86103d1366004612d30565b610da3565b6102b86103e4366004612d80565b610db7565b6103f1600181565b6040516001600160781b039091168152602001610248565b6102b8610417366004612de0565b610dca565b6102b8610f35565b6102b861102e565b6006546001600160a01b031661026a565b6102c2611042565b6102c261104f565b61029561045b3660046129a6565b61105c565b6102b861046e366004612e2e565b611124565b6102b86104813660046129a6565b61112f565b61023e6104943660046128f0565b6000908152600a602052604090205490565b6104ae611250565b6040516102489190612e67565b61038361130b565b6102b86104d1366004612ee7565b6113c4565b6102956104e4366004612f60565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205460ff1690565b6102b8610520366004612f8e565b611499565b6102b86105333660046129a6565b6114de565b6102b8610546366004612ff6565b611557565b6102b861055936600461302b565b611623565b60006001600160a01b0383166105ce5760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b506000818152602081815260408083206001600160a01b03861684529091529020545b92915050565b60006105f182611722565b61060a611747565b610614828261174f565b5050565b6007805461062590613087565b80601f016020809104026020016040519081016040528092919081815260200182805461065190613087565b801561069e5780601f106106735761010080835404028352916020019161069e565b820191906000526020600020905b81548152906001019060200180831161068157829003601f168201915b505050505081565b60606106b1826117a4565b6106ba83611838565b6040516020016106cb9291906130c1565b6040516020818303038152906040529050919050565b6003546000906001600160a01b03161561076f5760035460405163050bf71960e31b81526001600160a01b038681166004830152858116602483015284811660448301529091169063285fb8c89060640160006040518083038186803b15801561074a57600080fd5b505afa92505050801561075b575060015b61076757506000610773565b506001610773565b5060015b9392505050565b60008281526005602090815260408083208151808301909252546001600160a01b038116808352600160a01b9091046001600160601b03169282019290925282916107ef5750604080518082019091526004546001600160a01b0381168252600160a01b90046001600160601b031660208201525b60208101516000906127109061080e906001600160601b031687613116565b610818919061312d565b91519350909150505b9250929050565b6003546000906001600160a01b03161561092c57600354604051635caaa2a960e11b81523060048201526001600160a01b039091169063d72dde5e90829063b955455290602401606060405180830381865afa15801561088c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906108b0919061314f565b602001516040516001600160e01b031960e084901b1681526001600160781b0390911660048201526001600160a01b03851660248201526044015b602060405180830381865afa158015610908573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105f191906131c0565b506000919050565b6001600160a01b038516331480610950575061095085336104e4565b61096c5760405162461bcd60e51b81526004016105c5906131dd565b61097985858585856118ca565b5050505050565b610988611747565b47806109cb5760405162461bcd60e51b81526020600482015260126024820152714e6f2041504520746f20776974686472617760701b60448201526064016105c5565b604051339082156108fc029083906000818181858888f19350505050158015610614573d6000803e3d6000fd5b6003546060906001600160a01b031615610af657600354604051635caaa2a960e11b81523060048201526001600160a01b0390911690633fe5df9990829063b955455290602401606060405180830381865afa158015610a5c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a80919061314f565b602001516040516001600160e01b031960e084901b1681526001600160781b0390911660048201526024015b600060405180830381865afa158015610ac9573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610af1919081019061322b565b905090565b5060408051600081526020810190915290565b610b11611747565b6040516370a0823160e01b815230600482015281906000906001600160a01b038316906370a0823190602401602060405180830381865afa158015610b5a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b7e91906132cf565b905060008111610bc85760405162461bcd60e51b81526020600482015260156024820152744e6f20746f6b656e7320746f20776974686472617760581b60448201526064016105c5565b60405163a9059cbb60e01b8152336004820152602481018290526001600160a01b0383169063a9059cbb906044016020604051808303816000875af1158015610c15573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c3991906131c0565b610c7d5760405162461bcd60e51b8152602060048201526015602482015274151bdad95b881d1c985b9cd9995c8819985a5b1959605a1b60448201526064016105c5565b505050565b60608151835114610ce75760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b60648201526084016105c5565b600083516001600160401b03811115610d0257610d026129c3565b604051908082528060200260200182016040528015610d2b578160200160208202803683370190505b50905060005b8451811015610d9b57610d76858281518110610d4f57610d4f6132e8565b6020026020010151858381518110610d6957610d696132e8565b602002602001015161055e565b828281518110610d8857610d886132e8565b6020908102919091010152600101610d31565b509392505050565b610dab611747565b60096106148282613346565b610dbf611747565b610c7d838383611ab4565b610dd2611747565b6000610de66003546001600160a01b031690565b90506001600160a01b038116610e0f57604051631cffe3dd60e11b815260040160405180910390fd5b604051630368065360e61b81526001600160a01b0382169063da0194c090610e3d9030908890600401613405565b600060405180830381600087803b158015610e5757600080fd5b505af1158015610e6b573d6000803e3d6000fd5b5050604051631182550160e11b81526001600160a01b0384169250632304aa029150610e9d9030908790600401613422565b600060405180830381600087803b158015610eb757600080fd5b505af1158015610ecb573d6000803e3d6000fd5b505060405163235d10c560e21b81526001600160a01b0384169250638d7443149150610efd9030908690600401613422565b600060405180830381600087803b158015610f1757600080fd5b505af1158015610f2b573d6000803e3d6000fd5b5050505050505050565b610f3d611747565b610f5871721c310194ccfc01e523fc93c9cccfa2a0ac61112f565b604051630368065360e61b815271721c310194ccfc01e523fc93c9cccfa2a0ac9063da0194c090610f90903090600190600401613405565b600060405180830381600087803b158015610faa57600080fd5b505af1158015610fbe573d6000803e3d6000fd5b5050604051631182550160e11b815271721c310194ccfc01e523fc93c9cccfa2a0ac9250632304aa029150610ffa903090600190600401613422565b600060405180830381600087803b15801561101457600080fd5b505af1158015611028573d6000803e3d6000fd5b50505050565b611036611b0e565b6110406000611b68565b565b6008805461062590613087565b6009805461062590613087565b6003546000906001600160a01b03161561092c57600354604051635caaa2a960e11b81523060048201526001600160a01b0390911690639445f53090829063b955455290602401606060405180830381865afa1580156110c0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110e4919061314f565b60409081015190516001600160e01b031960e084901b1681526001600160781b0390911660048201526001600160a01b03851660248201526044016108eb565b610614338383611bba565b611137611747565b60006001600160a01b0382163b156111b2576040516301ffc9a760e01b8152600060048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa9250505080156111aa575060408051601f3d908101601f191682019092526111a7918101906131c0565b60015b156111b25790505b6001600160a01b038216158015906111c8575080155b156111e6576040516332483afb60e01b815260040160405180910390fd5b600354604080516001600160a01b03928316815291841660208301527fcc5dc080ff977b3c3a211fa63ab74f90f658f5ba9d3236e92c8f59570f442aac910160405180910390a150600380546001600160a01b0319166001600160a01b0392909216919091179055565b60408051606081018252600080825260208201819052918101919091526003546001600160a01b0316156112ea57600354604051635caaa2a960e11b81523060048201526001600160a01b039091169063b955455290602401606060405180830381865afa1580156112c6573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610af1919061314f565b50604080516060810182526000808252602082018190529181019190915290565b6003546060906001600160a01b031615610af657600354604051635caaa2a960e11b81523060048201526001600160a01b03909116906317e94a6c90829063b955455290602401606060405180830381865afa15801561136f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611393919061314f565b60409081015190516001600160e01b031960e084901b1681526001600160781b039091166004820152602401610aac565b6113cc611747565b8281146114255760405162461bcd60e51b815260206004820152602160248201527f4d69736d61746368656420726563697069656e747320616e6420616d6f756e746044820152607360f81b60648201526084016105c5565b60005b8381101561149157611489858583818110611445576114456132e8565b905060200201602081019061145a91906129a6565b8785858581811061146d5761146d6132e8565b9050602002013560405180602001604052806000815250611c92565b600101611428565b505050505050565b6001600160a01b0385163314806114b557506114b585336104e4565b6114d15760405162461bcd60e51b81526004016105c5906131dd565b6109798585858585611cc7565b6114e6611b0e565b6001600160a01b03811661154b5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016105c5565b61155481611b68565b50565b336001600160a01b0384161480611573575061157383336104e4565b6115bf5760405162461bcd60e51b815260206004820181905260248201527f43616c6c6572206973206e6f74206f776e6572206e6f7220617070726f76656460448201526064016105c5565b806115ca848461055e565b10156116185760405162461bcd60e51b815260206004820152601c60248201527f496e73756666696369656e742062616c616e636520746f206275726e0000000060448201526064016105c5565b610c7d838383611e0d565b61162b611747565b6116348461112f565b604051630368065360e61b81526001600160a01b0385169063da0194c0906116629030908790600401613405565b600060405180830381600087803b15801561167c57600080fd5b505af1158015611690573d6000803e3d6000fd5b5050604051631182550160e11b81526001600160a01b0387169250632304aa0291506116c29030908690600401613422565b600060405180830381600087803b1580156116dc57600080fd5b505af11580156116f0573d6000803e3d6000fd5b505060405163235d10c560e21b81526001600160a01b0387169250638d7443149150610efd9030908590600401613422565b60006001600160e01b0319821663152a902d60e11b14806105f157506105f182611e40565b611040611b0e565b6117598282611e65565b6040516001600160601b03821681526001600160a01b038316907f8a8bae378cb731c5c40b632330c6836c2f916f48edb967699c86736f9a6a76ef9060200160405180910390a25050565b6060600280546117b390613087565b80601f01602080910402602001604051908101604052809291908181526020018280546117df90613087565b801561182c5780601f106118015761010080835404028352916020019161182c565b820191906000526020600020905b81548152906001019060200180831161180f57829003601f168201915b50505050509050919050565b6060600061184583611f1f565b60010190506000816001600160401b03811115611864576118646129c3565b6040519080825280601f01601f19166020018201604052801561188e576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461189857509392505050565b815183511461192c5760405162461bcd60e51b815260206004820152602860248201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206044820152670dad2e6dac2e8c6d60c31b60648201526084016105c5565b6001600160a01b0384166119525760405162461bcd60e51b81526004016105c590613444565b33611961818787878787611ff7565b60005b8451811015611a40576000858281518110611981576119816132e8565b60200260200101519050600085838151811061199f5761199f6132e8565b602090810291909101810151600084815280835260408082206001600160a01b038e1683529093529190912054909150818110156119ef5760405162461bcd60e51b81526004016105c590613489565b6000838152602081815260408083206001600160a01b038e8116855292528083208585039055908b16825281208054849290611a2c9084906134d3565b909155505060019093019250611964915050565b50846001600160a01b0316866001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb8787604051611a909291906134e6565b60405180910390a4611aa6818787878787612030565b611491818787878787612069565b611abf8383836121cd565b6040516001600160601b03821681526001600160a01b0383169084907f7f5b076c952c0ec86e5425963c1326dd0f03a3595c19f81d765e8ff559a6e33c906020015b60405180910390a3505050565b6006546001600160a01b031633146110405760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016105c5565b600680546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b816001600160a01b0316836001600160a01b031603611c2d5760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b60648201526084016105c5565b6001600160a01b03838116600081815260016020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c319101611b01565b611c9e84848484612298565b6000838152600a602052604081208054849290611cbc9084906134d3565b909155505050505050565b6001600160a01b038416611ced5760405162461bcd60e51b81526004016105c590613444565b336000611cf9856123c1565b90506000611d06856123c1565b9050611d16838989858589611ff7565b6000868152602081815260408083206001600160a01b038c16845290915290205485811015611d575760405162461bcd60e51b81526004016105c590613489565b6000878152602081815260408083206001600160a01b038d8116855292528083208985039055908a16825281208054889290611d949084906134d3565b909155505060408051888152602081018890526001600160a01b03808b16928c821692918816917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a4611df4848a8a86868a612030565b611e02848a8a8a8a8a61240c565b505050505050505050565b611e188383836124c7565b6000828152600a602052604081208054839290611e36908490613514565b9091555050505050565b60006001600160e01b031982166310c8aba560e31b14806105f157506105f182612661565b6127106001600160601b0382161115611e905760405162461bcd60e51b81526004016105c590613527565b6001600160a01b038216611ee65760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c69642072656365697665720000000000000060448201526064016105c5565b604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600455565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b8310611f5e5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310611f8a576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc100008310611fa857662386f26fc10000830492506010015b6305f5e1008310611fc0576305f5e100830492506008015b6127108310611fd457612710830492506004015b60648310611fe6576064830492506002015b600a83106105f15760010192915050565b825160005b81811015610f2b57612028878787848151811061201b5761201b6132e8565b60200260200101516126b1565b600101611ffc565b825160005b81811015610f2b576120618787878481518110612054576120546132e8565b6020026020010151612707565b600101612035565b6001600160a01b0384163b156114915760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906120ad9089908990889088908890600401613571565b6020604051808303816000875af19250505080156120e8575060408051601f3d908101601f191682019092526120e5918101906135cf565b60015b612194576120f46135ec565b806308c379a00361212d5750612108613608565b80612113575061212f565b8060405162461bcd60e51b81526004016105c591906128dd565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b60648201526084016105c5565b6001600160e01b0319811663bc197c8160e01b146121c45760405162461bcd60e51b81526004016105c590613691565b50505050505050565b6127106001600160601b03821611156121f85760405162461bcd60e51b81526004016105c590613527565b6001600160a01b03821661224e5760405162461bcd60e51b815260206004820152601b60248201527f455243323938313a20496e76616c696420706172616d6574657273000000000060448201526064016105c5565b6040805180820182526001600160a01b0393841681526001600160601b0392831660208083019182526000968752600590529190942093519051909116600160a01b029116179055565b6001600160a01b0384166122f85760405162461bcd60e51b815260206004820152602160248201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736044820152607360f81b60648201526084016105c5565b336000612304856123c1565b90506000612311856123c1565b905061232283600089858589611ff7565b6000868152602081815260408083206001600160a01b038b168452909152812080548792906123529084906134d3565b909155505060408051878152602081018790526001600160a01b03808a1692600092918716917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a46123b283600089858589612030565b6121c48360008989898961240c565b604080516001808252818301909252606091600091906020808301908036833701905050905082816000815181106123fb576123fb6132e8565b602090810291909101015292915050565b6001600160a01b0384163b156114915760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e619061245090899089908890889088906004016136d9565b6020604051808303816000875af192505050801561248b575060408051601f3d908101601f19168201909252612488918101906135cf565b60015b612497576120f46135ec565b6001600160e01b0319811663f23a6e6160e01b146121c45760405162461bcd60e51b81526004016105c590613691565b6001600160a01b0383166125295760405162461bcd60e51b815260206004820152602360248201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260448201526265737360e81b60648201526084016105c5565b336000612535846123c1565b90506000612542846123c1565b905061256283876000858560405180602001604052806000815250611ff7565b6000858152602081815260408083206001600160a01b038a168452909152902054848110156125df5760405162461bcd60e51b8152602060048201526024808201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604482015263616e636560e01b60648201526084016105c5565b6000868152602081815260408083206001600160a01b038b81168086529184528285208a8703905582518b81529384018a90529092908816917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a46121c484886000868660405180602001604052806000815250612030565b60006001600160e01b03198216636cdb3d1360e11b148061269257506001600160e01b031982166303a24d0760e21b145b806105f157506301ffc9a760e01b6001600160e01b03198316146105f1565b6001600160a01b0383811615908316158180156126cb5750805b156126e957604051635cbd944160e01b815260040160405180910390fd5b81156126f5575b610979565b806126f057610979338686863461274e565b6001600160a01b0383811615908316158180156127215750805b1561273f57604051635cbd944160e01b815260040160405180910390fd5b816126f057806126f057610979565b6003546001600160a01b0316156109795760035460405163050bf71960e31b81526001600160a01b038781166004830152868116602483015285811660448301529091169063285fb8c89060640160006040518083038186803b1580156127b457600080fd5b505afa158015611e02573d6000803e3d6000fd5b6001600160a01b038116811461155457600080fd5b600080604083850312156127f057600080fd5b82356127fb816127c8565b946020939093013593505050565b6001600160e01b03198116811461155457600080fd5b60006020828403121561283157600080fd5b813561077381612809565b80356001600160601b038116811461285357600080fd5b919050565b6000806040838503121561286b57600080fd5b8235612876816127c8565b91506128846020840161283c565b90509250929050565b60005b838110156128a8578181015183820152602001612890565b50506000910152565b600081518084526128c981602086016020860161288d565b601f01601f19169290920160200192915050565b60208152600061077360208301846128b1565b60006020828403121561290257600080fd5b5035919050565b60008060006060848603121561291e57600080fd5b8335612929816127c8565b92506020840135612939816127c8565b91506040840135612949816127c8565b809150509250925092565b6007811061297257634e487b7160e01b600052602160045260246000fd5b9052565b602081016105f18284612954565b6000806040838503121561299757600080fd5b50508035926020909101359150565b6000602082840312156129b857600080fd5b8135610773816127c8565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b03811182821017156129fe576129fe6129c3565b6040525050565b60006001600160401b03821115612a1e57612a1e6129c3565b5060051b60200190565b600082601f830112612a3957600080fd5b81356020612a4682612a05565b604051612a5382826129d9565b80915083815260208101915060208460051b870101935086841115612a7757600080fd5b602086015b84811015612a935780358352918301918301612a7c565b509695505050505050565b60006001600160401b03831115612ab757612ab76129c3565b604051612ace601f8501601f1916602001826129d9565b809150838152848484011115612ae357600080fd5b83836020830137600060208583010152509392505050565b600082601f830112612b0c57600080fd5b61077383833560208501612a9e565b600080600080600060a08688031215612b3357600080fd5b8535612b3e816127c8565b94506020860135612b4e816127c8565b935060408601356001600160401b0380821115612b6a57600080fd5b612b7689838a01612a28565b94506060880135915080821115612b8c57600080fd5b612b9889838a01612a28565b93506080880135915080821115612bae57600080fd5b50612bbb88828901612afb565b9150509295509295909350565b6020808252825182820181905260009190848201906040850190845b81811015612c095783516001600160a01b031683529284019291840191600101612be4565b50909695505050505050565b60008060408385031215612c2857600080fd5b82356001600160401b0380821115612c3f57600080fd5b818501915085601f830112612c5357600080fd5b81356020612c6082612a05565b604051612c6d82826129d9565b83815260059390931b8501820192828101915089841115612c8d57600080fd5b948201945b83861015612cb4578535612ca5816127c8565b82529482019490820190612c92565b96505086013592505080821115612cca57600080fd5b50612cd785828601612a28565b9150509250929050565b60008151808452602080850194506020840160005b83811015612d1257815187529582019590820190600101612cf6565b509495945050505050565b6020815260006107736020830184612ce1565b600060208284031215612d4257600080fd5b81356001600160401b03811115612d5857600080fd5b8201601f81018413612d6957600080fd5b612d7884823560208401612a9e565b949350505050565b600080600060608486031215612d9557600080fd5b833592506020840135612da7816127c8565b9150612db56040850161283c565b90509250925092565b6007811061155457600080fd5b6001600160781b038116811461155457600080fd5b600080600060608486031215612df557600080fd5b8335612e0081612dbe565b92506020840135612e1081612dcb565b9150604084013561294981612dcb565b801515811461155457600080fd5b60008060408385031215612e4157600080fd5b8235612e4c816127c8565b91506020830135612e5c81612e20565b809150509250929050565b6000606082019050612e7a828451612954565b60208301516001600160781b038082166020850152806040860151166040850152505092915050565b60008083601f840112612eb557600080fd5b5081356001600160401b03811115612ecc57600080fd5b6020830191508360208260051b850101111561082157600080fd5b600080600080600060608688031215612eff57600080fd5b8535945060208601356001600160401b0380821115612f1d57600080fd5b612f2989838a01612ea3565b90965094506040880135915080821115612f4257600080fd5b50612f4f88828901612ea3565b969995985093965092949392505050565b60008060408385031215612f7357600080fd5b8235612f7e816127c8565b91506020830135612e5c816127c8565b600080600080600060a08688031215612fa657600080fd5b8535612fb1816127c8565b94506020860135612fc1816127c8565b9350604086013592506060860135915060808601356001600160401b03811115612fea57600080fd5b612bbb88828901612afb565b60008060006060848603121561300b57600080fd5b8335613016816127c8565b95602085013595506040909401359392505050565b6000806000806080858703121561304157600080fd5b843561304c816127c8565b9350602085013561305c81612dbe565b9250604085013561306c81612dcb565b9150606085013561307c81612dcb565b939692955090935050565b600181811c9082168061309b57607f821691505b6020821081036130bb57634e487b7160e01b600052602260045260246000fd5b50919050565b600083516130d381846020880161288d565b8351908301906130e781836020880161288d565b64173539b7b760d91b9101908152600501949350505050565b634e487b7160e01b600052601160045260246000fd5b80820281158282048414176105f1576105f1613100565b60008261314a57634e487b7160e01b600052601260045260246000fd5b500490565b60006060828403121561316157600080fd5b604051606081018181106001600160401b0382111715613183576131836129c3565b604052825161319181612dbe565b815260208301516131a181612dcb565b602082015260408301516131b481612dcb565b60408201529392505050565b6000602082840312156131d257600080fd5b815161077381612e20565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b6000602080838503121561323e57600080fd5b82516001600160401b0381111561325457600080fd5b8301601f8101851361326557600080fd5b805161327081612a05565b60405161327d82826129d9565b82815260059290921b830184019184810191508783111561329d57600080fd5b928401925b828410156132c45783516132b5816127c8565b825292840192908401906132a2565b979650505050505050565b6000602082840312156132e157600080fd5b5051919050565b634e487b7160e01b600052603260045260246000fd5b601f821115610c7d576000816000526020600020601f850160051c810160208610156133275750805b601f850160051c820191505b8181101561149157828155600101613333565b81516001600160401b0381111561335f5761335f6129c3565b6133738161336d8454613087565b846132fe565b602080601f8311600181146133a857600084156133905750858301515b600019600386901b1c1916600185901b178555611491565b600085815260208120601f198616915b828110156133d7578886015182559484019460019091019084016133b8565b50858210156133f55787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b0383168152604081016107736020830184612954565b6001600160a01b039290921682526001600160781b0316602082015260400190565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b808201808211156105f1576105f1613100565b6040815260006134f96040830185612ce1565b828103602084015261350b8185612ce1565b95945050505050565b818103818111156105f1576105f1613100565b6020808252602a908201527f455243323938313a20726f79616c7479206665652077696c6c206578636565646040820152692073616c65507269636560b01b606082015260800190565b6001600160a01b0386811682528516602082015260a06040820181905260009061359d90830186612ce1565b82810360608401526135af8186612ce1565b905082810360808401526135c381856128b1565b98975050505050505050565b6000602082840312156135e157600080fd5b815161077381612809565b600060033d11156136055760046000803e5060005160e01c5b90565b600060443d10156136165790565b6040516003193d81016004833e81513d6001600160401b03816024840111818411171561364557505050505090565b828501915081518181111561365d5750505050505090565b843d87010160208285010111156136775750505050505090565b613686602082860101876129d9565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b6001600160a01b03868116825285166020820152604081018490526060810183905260a0608082018190526000906132c4908301846128b156fea2646970667358221220eb440aa454fc45057503ab4c73813c963815be091d4e5a7921c74b75595a9dba64736f6c63430008170033000000000000000000000000f494348c04be6999a3058b56068b7c84c5f50a3400000000000000000000000000000000000000000000000000000000000002b200000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000005268747470733a2f2f62616679626569617a377a736a767775367a78646a69777078773337697532336f7834627235646e6f6a7062697069326b66687578726435326e712e697066732e7733732e6c696e6b2f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000094765657a204e75747a000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044e55545a00000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x608060405234801561001057600080fd5b50600436106102265760003560e01c80635d4c1d4611610130578063a9fc664e116100b8578063e985e9c51161007c578063e985e9c5146104d6578063f242432a14610512578063f2fde38b14610525578063f5298aca14610538578063fd762d921461054b57600080fd5b8063a9fc664e14610473578063bd85b03914610486578063be537f43146104a6578063d007af5c146104bb578063d5516e7f146104c357600080fd5b80638da5cb5b116100ff5780638da5cb5b1461042c57806395d89b411461043d5780639abc8320146104455780639d645a441461044d578063a22cb4651461046057600080fd5b80635d4c1d46146103e957806361347162146104095780636c3b86991461041c578063715018a61461042457600080fd5b80632a55205a116101b3578063495c8bf911610182578063495c8bf91461037b57806349df728c146103905780634e1273f4146103a357806355f804b3146103c35780635944c753146103d657600080fd5b80632a55205a1461031b5780632e8da8291461034d5780632eb2c2d6146103605780633ccfd60b1461037357600080fd5b806306fdde03116101fa57806306fdde03146102ba578063098144d4146102cf5780630e89341c146102e05780631b25b077146102f35780631c33b3281461030657600080fd5b8062fdd58e1461022b578063014635461461025157806301ffc9a71461028257806304634d8d146102a5575b600080fd5b61023e6102393660046127dd565b61055e565b6040519081526020015b60405180910390f35b61026a71721c310194ccfc01e523fc93c9cccfa2a0ac81565b6040516001600160a01b039091168152602001610248565b61029561029036600461281f565b6105f7565b6040519015158152602001610248565b6102b86102b3366004612858565b610602565b005b6102c2610618565b60405161024891906128dd565b6003546001600160a01b031661026a565b6102c26102ee3660046128f0565b6106a6565b610295610301366004612909565b6106e1565b61030e600181565b6040516102489190612976565b61032e610329366004612984565b61077a565b604080516001600160a01b039093168352602083019190915201610248565b61029561035b3660046129a6565b610828565b6102b861036e366004612b1b565b610934565b6102b8610980565b6103836109f8565b6040516102489190612bc8565b6102b861039e3660046129a6565b610b09565b6103b66103b1366004612c15565b610c82565b6040516102489190612d1d565b6102b86103d1366004612d30565b610da3565b6102b86103e4366004612d80565b610db7565b6103f1600181565b6040516001600160781b039091168152602001610248565b6102b8610417366004612de0565b610dca565b6102b8610f35565b6102b861102e565b6006546001600160a01b031661026a565b6102c2611042565b6102c261104f565b61029561045b3660046129a6565b61105c565b6102b861046e366004612e2e565b611124565b6102b86104813660046129a6565b61112f565b61023e6104943660046128f0565b6000908152600a602052604090205490565b6104ae611250565b6040516102489190612e67565b61038361130b565b6102b86104d1366004612ee7565b6113c4565b6102956104e4366004612f60565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205460ff1690565b6102b8610520366004612f8e565b611499565b6102b86105333660046129a6565b6114de565b6102b8610546366004612ff6565b611557565b6102b861055936600461302b565b611623565b60006001600160a01b0383166105ce5760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b506000818152602081815260408083206001600160a01b03861684529091529020545b92915050565b60006105f182611722565b61060a611747565b610614828261174f565b5050565b6007805461062590613087565b80601f016020809104026020016040519081016040528092919081815260200182805461065190613087565b801561069e5780601f106106735761010080835404028352916020019161069e565b820191906000526020600020905b81548152906001019060200180831161068157829003601f168201915b505050505081565b60606106b1826117a4565b6106ba83611838565b6040516020016106cb9291906130c1565b6040516020818303038152906040529050919050565b6003546000906001600160a01b03161561076f5760035460405163050bf71960e31b81526001600160a01b038681166004830152858116602483015284811660448301529091169063285fb8c89060640160006040518083038186803b15801561074a57600080fd5b505afa92505050801561075b575060015b61076757506000610773565b506001610773565b5060015b9392505050565b60008281526005602090815260408083208151808301909252546001600160a01b038116808352600160a01b9091046001600160601b03169282019290925282916107ef5750604080518082019091526004546001600160a01b0381168252600160a01b90046001600160601b031660208201525b60208101516000906127109061080e906001600160601b031687613116565b610818919061312d565b91519350909150505b9250929050565b6003546000906001600160a01b03161561092c57600354604051635caaa2a960e11b81523060048201526001600160a01b039091169063d72dde5e90829063b955455290602401606060405180830381865afa15801561088c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906108b0919061314f565b602001516040516001600160e01b031960e084901b1681526001600160781b0390911660048201526001600160a01b03851660248201526044015b602060405180830381865afa158015610908573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105f191906131c0565b506000919050565b6001600160a01b038516331480610950575061095085336104e4565b61096c5760405162461bcd60e51b81526004016105c5906131dd565b61097985858585856118ca565b5050505050565b610988611747565b47806109cb5760405162461bcd60e51b81526020600482015260126024820152714e6f2041504520746f20776974686472617760701b60448201526064016105c5565b604051339082156108fc029083906000818181858888f19350505050158015610614573d6000803e3d6000fd5b6003546060906001600160a01b031615610af657600354604051635caaa2a960e11b81523060048201526001600160a01b0390911690633fe5df9990829063b955455290602401606060405180830381865afa158015610a5c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a80919061314f565b602001516040516001600160e01b031960e084901b1681526001600160781b0390911660048201526024015b600060405180830381865afa158015610ac9573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610af1919081019061322b565b905090565b5060408051600081526020810190915290565b610b11611747565b6040516370a0823160e01b815230600482015281906000906001600160a01b038316906370a0823190602401602060405180830381865afa158015610b5a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b7e91906132cf565b905060008111610bc85760405162461bcd60e51b81526020600482015260156024820152744e6f20746f6b656e7320746f20776974686472617760581b60448201526064016105c5565b60405163a9059cbb60e01b8152336004820152602481018290526001600160a01b0383169063a9059cbb906044016020604051808303816000875af1158015610c15573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c3991906131c0565b610c7d5760405162461bcd60e51b8152602060048201526015602482015274151bdad95b881d1c985b9cd9995c8819985a5b1959605a1b60448201526064016105c5565b505050565b60608151835114610ce75760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b60648201526084016105c5565b600083516001600160401b03811115610d0257610d026129c3565b604051908082528060200260200182016040528015610d2b578160200160208202803683370190505b50905060005b8451811015610d9b57610d76858281518110610d4f57610d4f6132e8565b6020026020010151858381518110610d6957610d696132e8565b602002602001015161055e565b828281518110610d8857610d886132e8565b6020908102919091010152600101610d31565b509392505050565b610dab611747565b60096106148282613346565b610dbf611747565b610c7d838383611ab4565b610dd2611747565b6000610de66003546001600160a01b031690565b90506001600160a01b038116610e0f57604051631cffe3dd60e11b815260040160405180910390fd5b604051630368065360e61b81526001600160a01b0382169063da0194c090610e3d9030908890600401613405565b600060405180830381600087803b158015610e5757600080fd5b505af1158015610e6b573d6000803e3d6000fd5b5050604051631182550160e11b81526001600160a01b0384169250632304aa029150610e9d9030908790600401613422565b600060405180830381600087803b158015610eb757600080fd5b505af1158015610ecb573d6000803e3d6000fd5b505060405163235d10c560e21b81526001600160a01b0384169250638d7443149150610efd9030908690600401613422565b600060405180830381600087803b158015610f1757600080fd5b505af1158015610f2b573d6000803e3d6000fd5b5050505050505050565b610f3d611747565b610f5871721c310194ccfc01e523fc93c9cccfa2a0ac61112f565b604051630368065360e61b815271721c310194ccfc01e523fc93c9cccfa2a0ac9063da0194c090610f90903090600190600401613405565b600060405180830381600087803b158015610faa57600080fd5b505af1158015610fbe573d6000803e3d6000fd5b5050604051631182550160e11b815271721c310194ccfc01e523fc93c9cccfa2a0ac9250632304aa029150610ffa903090600190600401613422565b600060405180830381600087803b15801561101457600080fd5b505af1158015611028573d6000803e3d6000fd5b50505050565b611036611b0e565b6110406000611b68565b565b6008805461062590613087565b6009805461062590613087565b6003546000906001600160a01b03161561092c57600354604051635caaa2a960e11b81523060048201526001600160a01b0390911690639445f53090829063b955455290602401606060405180830381865afa1580156110c0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110e4919061314f565b60409081015190516001600160e01b031960e084901b1681526001600160781b0390911660048201526001600160a01b03851660248201526044016108eb565b610614338383611bba565b611137611747565b60006001600160a01b0382163b156111b2576040516301ffc9a760e01b8152600060048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa9250505080156111aa575060408051601f3d908101601f191682019092526111a7918101906131c0565b60015b156111b25790505b6001600160a01b038216158015906111c8575080155b156111e6576040516332483afb60e01b815260040160405180910390fd5b600354604080516001600160a01b03928316815291841660208301527fcc5dc080ff977b3c3a211fa63ab74f90f658f5ba9d3236e92c8f59570f442aac910160405180910390a150600380546001600160a01b0319166001600160a01b0392909216919091179055565b60408051606081018252600080825260208201819052918101919091526003546001600160a01b0316156112ea57600354604051635caaa2a960e11b81523060048201526001600160a01b039091169063b955455290602401606060405180830381865afa1580156112c6573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610af1919061314f565b50604080516060810182526000808252602082018190529181019190915290565b6003546060906001600160a01b031615610af657600354604051635caaa2a960e11b81523060048201526001600160a01b03909116906317e94a6c90829063b955455290602401606060405180830381865afa15801561136f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611393919061314f565b60409081015190516001600160e01b031960e084901b1681526001600160781b039091166004820152602401610aac565b6113cc611747565b8281146114255760405162461bcd60e51b815260206004820152602160248201527f4d69736d61746368656420726563697069656e747320616e6420616d6f756e746044820152607360f81b60648201526084016105c5565b60005b8381101561149157611489858583818110611445576114456132e8565b905060200201602081019061145a91906129a6565b8785858581811061146d5761146d6132e8565b9050602002013560405180602001604052806000815250611c92565b600101611428565b505050505050565b6001600160a01b0385163314806114b557506114b585336104e4565b6114d15760405162461bcd60e51b81526004016105c5906131dd565b6109798585858585611cc7565b6114e6611b0e565b6001600160a01b03811661154b5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016105c5565b61155481611b68565b50565b336001600160a01b0384161480611573575061157383336104e4565b6115bf5760405162461bcd60e51b815260206004820181905260248201527f43616c6c6572206973206e6f74206f776e6572206e6f7220617070726f76656460448201526064016105c5565b806115ca848461055e565b10156116185760405162461bcd60e51b815260206004820152601c60248201527f496e73756666696369656e742062616c616e636520746f206275726e0000000060448201526064016105c5565b610c7d838383611e0d565b61162b611747565b6116348461112f565b604051630368065360e61b81526001600160a01b0385169063da0194c0906116629030908790600401613405565b600060405180830381600087803b15801561167c57600080fd5b505af1158015611690573d6000803e3d6000fd5b5050604051631182550160e11b81526001600160a01b0387169250632304aa0291506116c29030908690600401613422565b600060405180830381600087803b1580156116dc57600080fd5b505af11580156116f0573d6000803e3d6000fd5b505060405163235d10c560e21b81526001600160a01b0387169250638d7443149150610efd9030908590600401613422565b60006001600160e01b0319821663152a902d60e11b14806105f157506105f182611e40565b611040611b0e565b6117598282611e65565b6040516001600160601b03821681526001600160a01b038316907f8a8bae378cb731c5c40b632330c6836c2f916f48edb967699c86736f9a6a76ef9060200160405180910390a25050565b6060600280546117b390613087565b80601f01602080910402602001604051908101604052809291908181526020018280546117df90613087565b801561182c5780601f106118015761010080835404028352916020019161182c565b820191906000526020600020905b81548152906001019060200180831161180f57829003601f168201915b50505050509050919050565b6060600061184583611f1f565b60010190506000816001600160401b03811115611864576118646129c3565b6040519080825280601f01601f19166020018201604052801561188e576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461189857509392505050565b815183511461192c5760405162461bcd60e51b815260206004820152602860248201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206044820152670dad2e6dac2e8c6d60c31b60648201526084016105c5565b6001600160a01b0384166119525760405162461bcd60e51b81526004016105c590613444565b33611961818787878787611ff7565b60005b8451811015611a40576000858281518110611981576119816132e8565b60200260200101519050600085838151811061199f5761199f6132e8565b602090810291909101810151600084815280835260408082206001600160a01b038e1683529093529190912054909150818110156119ef5760405162461bcd60e51b81526004016105c590613489565b6000838152602081815260408083206001600160a01b038e8116855292528083208585039055908b16825281208054849290611a2c9084906134d3565b909155505060019093019250611964915050565b50846001600160a01b0316866001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb8787604051611a909291906134e6565b60405180910390a4611aa6818787878787612030565b611491818787878787612069565b611abf8383836121cd565b6040516001600160601b03821681526001600160a01b0383169084907f7f5b076c952c0ec86e5425963c1326dd0f03a3595c19f81d765e8ff559a6e33c906020015b60405180910390a3505050565b6006546001600160a01b031633146110405760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016105c5565b600680546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b816001600160a01b0316836001600160a01b031603611c2d5760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b60648201526084016105c5565b6001600160a01b03838116600081815260016020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c319101611b01565b611c9e84848484612298565b6000838152600a602052604081208054849290611cbc9084906134d3565b909155505050505050565b6001600160a01b038416611ced5760405162461bcd60e51b81526004016105c590613444565b336000611cf9856123c1565b90506000611d06856123c1565b9050611d16838989858589611ff7565b6000868152602081815260408083206001600160a01b038c16845290915290205485811015611d575760405162461bcd60e51b81526004016105c590613489565b6000878152602081815260408083206001600160a01b038d8116855292528083208985039055908a16825281208054889290611d949084906134d3565b909155505060408051888152602081018890526001600160a01b03808b16928c821692918816917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a4611df4848a8a86868a612030565b611e02848a8a8a8a8a61240c565b505050505050505050565b611e188383836124c7565b6000828152600a602052604081208054839290611e36908490613514565b9091555050505050565b60006001600160e01b031982166310c8aba560e31b14806105f157506105f182612661565b6127106001600160601b0382161115611e905760405162461bcd60e51b81526004016105c590613527565b6001600160a01b038216611ee65760405162461bcd60e51b815260206004820152601960248201527f455243323938313a20696e76616c69642072656365697665720000000000000060448201526064016105c5565b604080518082019091526001600160a01b039092168083526001600160601b039091166020909201829052600160a01b90910217600455565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b8310611f5e5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310611f8a576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc100008310611fa857662386f26fc10000830492506010015b6305f5e1008310611fc0576305f5e100830492506008015b6127108310611fd457612710830492506004015b60648310611fe6576064830492506002015b600a83106105f15760010192915050565b825160005b81811015610f2b57612028878787848151811061201b5761201b6132e8565b60200260200101516126b1565b600101611ffc565b825160005b81811015610f2b576120618787878481518110612054576120546132e8565b6020026020010151612707565b600101612035565b6001600160a01b0384163b156114915760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906120ad9089908990889088908890600401613571565b6020604051808303816000875af19250505080156120e8575060408051601f3d908101601f191682019092526120e5918101906135cf565b60015b612194576120f46135ec565b806308c379a00361212d5750612108613608565b80612113575061212f565b8060405162461bcd60e51b81526004016105c591906128dd565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b60648201526084016105c5565b6001600160e01b0319811663bc197c8160e01b146121c45760405162461bcd60e51b81526004016105c590613691565b50505050505050565b6127106001600160601b03821611156121f85760405162461bcd60e51b81526004016105c590613527565b6001600160a01b03821661224e5760405162461bcd60e51b815260206004820152601b60248201527f455243323938313a20496e76616c696420706172616d6574657273000000000060448201526064016105c5565b6040805180820182526001600160a01b0393841681526001600160601b0392831660208083019182526000968752600590529190942093519051909116600160a01b029116179055565b6001600160a01b0384166122f85760405162461bcd60e51b815260206004820152602160248201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736044820152607360f81b60648201526084016105c5565b336000612304856123c1565b90506000612311856123c1565b905061232283600089858589611ff7565b6000868152602081815260408083206001600160a01b038b168452909152812080548792906123529084906134d3565b909155505060408051878152602081018790526001600160a01b03808a1692600092918716917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a46123b283600089858589612030565b6121c48360008989898961240c565b604080516001808252818301909252606091600091906020808301908036833701905050905082816000815181106123fb576123fb6132e8565b602090810291909101015292915050565b6001600160a01b0384163b156114915760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e619061245090899089908890889088906004016136d9565b6020604051808303816000875af192505050801561248b575060408051601f3d908101601f19168201909252612488918101906135cf565b60015b612497576120f46135ec565b6001600160e01b0319811663f23a6e6160e01b146121c45760405162461bcd60e51b81526004016105c590613691565b6001600160a01b0383166125295760405162461bcd60e51b815260206004820152602360248201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260448201526265737360e81b60648201526084016105c5565b336000612535846123c1565b90506000612542846123c1565b905061256283876000858560405180602001604052806000815250611ff7565b6000858152602081815260408083206001600160a01b038a168452909152902054848110156125df5760405162461bcd60e51b8152602060048201526024808201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604482015263616e636560e01b60648201526084016105c5565b6000868152602081815260408083206001600160a01b038b81168086529184528285208a8703905582518b81529384018a90529092908816917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a46121c484886000868660405180602001604052806000815250612030565b60006001600160e01b03198216636cdb3d1360e11b148061269257506001600160e01b031982166303a24d0760e21b145b806105f157506301ffc9a760e01b6001600160e01b03198316146105f1565b6001600160a01b0383811615908316158180156126cb5750805b156126e957604051635cbd944160e01b815260040160405180910390fd5b81156126f5575b610979565b806126f057610979338686863461274e565b6001600160a01b0383811615908316158180156127215750805b1561273f57604051635cbd944160e01b815260040160405180910390fd5b816126f057806126f057610979565b6003546001600160a01b0316156109795760035460405163050bf71960e31b81526001600160a01b038781166004830152868116602483015285811660448301529091169063285fb8c89060640160006040518083038186803b1580156127b457600080fd5b505afa158015611e02573d6000803e3d6000fd5b6001600160a01b038116811461155457600080fd5b600080604083850312156127f057600080fd5b82356127fb816127c8565b946020939093013593505050565b6001600160e01b03198116811461155457600080fd5b60006020828403121561283157600080fd5b813561077381612809565b80356001600160601b038116811461285357600080fd5b919050565b6000806040838503121561286b57600080fd5b8235612876816127c8565b91506128846020840161283c565b90509250929050565b60005b838110156128a8578181015183820152602001612890565b50506000910152565b600081518084526128c981602086016020860161288d565b601f01601f19169290920160200192915050565b60208152600061077360208301846128b1565b60006020828403121561290257600080fd5b5035919050565b60008060006060848603121561291e57600080fd5b8335612929816127c8565b92506020840135612939816127c8565b91506040840135612949816127c8565b809150509250925092565b6007811061297257634e487b7160e01b600052602160045260246000fd5b9052565b602081016105f18284612954565b6000806040838503121561299757600080fd5b50508035926020909101359150565b6000602082840312156129b857600080fd5b8135610773816127c8565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b03811182821017156129fe576129fe6129c3565b6040525050565b60006001600160401b03821115612a1e57612a1e6129c3565b5060051b60200190565b600082601f830112612a3957600080fd5b81356020612a4682612a05565b604051612a5382826129d9565b80915083815260208101915060208460051b870101935086841115612a7757600080fd5b602086015b84811015612a935780358352918301918301612a7c565b509695505050505050565b60006001600160401b03831115612ab757612ab76129c3565b604051612ace601f8501601f1916602001826129d9565b809150838152848484011115612ae357600080fd5b83836020830137600060208583010152509392505050565b600082601f830112612b0c57600080fd5b61077383833560208501612a9e565b600080600080600060a08688031215612b3357600080fd5b8535612b3e816127c8565b94506020860135612b4e816127c8565b935060408601356001600160401b0380821115612b6a57600080fd5b612b7689838a01612a28565b94506060880135915080821115612b8c57600080fd5b612b9889838a01612a28565b93506080880135915080821115612bae57600080fd5b50612bbb88828901612afb565b9150509295509295909350565b6020808252825182820181905260009190848201906040850190845b81811015612c095783516001600160a01b031683529284019291840191600101612be4565b50909695505050505050565b60008060408385031215612c2857600080fd5b82356001600160401b0380821115612c3f57600080fd5b818501915085601f830112612c5357600080fd5b81356020612c6082612a05565b604051612c6d82826129d9565b83815260059390931b8501820192828101915089841115612c8d57600080fd5b948201945b83861015612cb4578535612ca5816127c8565b82529482019490820190612c92565b96505086013592505080821115612cca57600080fd5b50612cd785828601612a28565b9150509250929050565b60008151808452602080850194506020840160005b83811015612d1257815187529582019590820190600101612cf6565b509495945050505050565b6020815260006107736020830184612ce1565b600060208284031215612d4257600080fd5b81356001600160401b03811115612d5857600080fd5b8201601f81018413612d6957600080fd5b612d7884823560208401612a9e565b949350505050565b600080600060608486031215612d9557600080fd5b833592506020840135612da7816127c8565b9150612db56040850161283c565b90509250925092565b6007811061155457600080fd5b6001600160781b038116811461155457600080fd5b600080600060608486031215612df557600080fd5b8335612e0081612dbe565b92506020840135612e1081612dcb565b9150604084013561294981612dcb565b801515811461155457600080fd5b60008060408385031215612e4157600080fd5b8235612e4c816127c8565b91506020830135612e5c81612e20565b809150509250929050565b6000606082019050612e7a828451612954565b60208301516001600160781b038082166020850152806040860151166040850152505092915050565b60008083601f840112612eb557600080fd5b5081356001600160401b03811115612ecc57600080fd5b6020830191508360208260051b850101111561082157600080fd5b600080600080600060608688031215612eff57600080fd5b8535945060208601356001600160401b0380821115612f1d57600080fd5b612f2989838a01612ea3565b90965094506040880135915080821115612f4257600080fd5b50612f4f88828901612ea3565b969995985093965092949392505050565b60008060408385031215612f7357600080fd5b8235612f7e816127c8565b91506020830135612e5c816127c8565b600080600080600060a08688031215612fa657600080fd5b8535612fb1816127c8565b94506020860135612fc1816127c8565b9350604086013592506060860135915060808601356001600160401b03811115612fea57600080fd5b612bbb88828901612afb565b60008060006060848603121561300b57600080fd5b8335613016816127c8565b95602085013595506040909401359392505050565b6000806000806080858703121561304157600080fd5b843561304c816127c8565b9350602085013561305c81612dbe565b9250604085013561306c81612dcb565b9150606085013561307c81612dcb565b939692955090935050565b600181811c9082168061309b57607f821691505b6020821081036130bb57634e487b7160e01b600052602260045260246000fd5b50919050565b600083516130d381846020880161288d565b8351908301906130e781836020880161288d565b64173539b7b760d91b9101908152600501949350505050565b634e487b7160e01b600052601160045260246000fd5b80820281158282048414176105f1576105f1613100565b60008261314a57634e487b7160e01b600052601260045260246000fd5b500490565b60006060828403121561316157600080fd5b604051606081018181106001600160401b0382111715613183576131836129c3565b604052825161319181612dbe565b815260208301516131a181612dcb565b602082015260408301516131b481612dcb565b60408201529392505050565b6000602082840312156131d257600080fd5b815161077381612e20565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b6000602080838503121561323e57600080fd5b82516001600160401b0381111561325457600080fd5b8301601f8101851361326557600080fd5b805161327081612a05565b60405161327d82826129d9565b82815260059290921b830184019184810191508783111561329d57600080fd5b928401925b828410156132c45783516132b5816127c8565b825292840192908401906132a2565b979650505050505050565b6000602082840312156132e157600080fd5b5051919050565b634e487b7160e01b600052603260045260246000fd5b601f821115610c7d576000816000526020600020601f850160051c810160208610156133275750805b601f850160051c820191505b8181101561149157828155600101613333565b81516001600160401b0381111561335f5761335f6129c3565b6133738161336d8454613087565b846132fe565b602080601f8311600181146133a857600084156133905750858301515b600019600386901b1c1916600185901b178555611491565b600085815260208120601f198616915b828110156133d7578886015182559484019460019091019084016133b8565b50858210156133f55787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b0383168152604081016107736020830184612954565b6001600160a01b039290921682526001600160781b0316602082015260400190565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b808201808211156105f1576105f1613100565b6040815260006134f96040830185612ce1565b828103602084015261350b8185612ce1565b95945050505050565b818103818111156105f1576105f1613100565b6020808252602a908201527f455243323938313a20726f79616c7479206665652077696c6c206578636565646040820152692073616c65507269636560b01b606082015260800190565b6001600160a01b0386811682528516602082015260a06040820181905260009061359d90830186612ce1565b82810360608401526135af8186612ce1565b905082810360808401526135c381856128b1565b98975050505050505050565b6000602082840312156135e157600080fd5b815161077381612809565b600060033d11156136055760046000803e5060005160e01c5b90565b600060443d10156136165790565b6040516003193d81016004833e81513d6001600160401b03816024840111818411171561364557505050505090565b828501915081518181111561365d5750505050505090565b843d87010160208285010111156136775750505050505090565b613686602082860101876129d9565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b6001600160a01b03868116825285166020820152604081018490526060810183905260a0608082018190526000906132c4908301846128b156fea2646970667358221220eb440aa454fc45057503ab4c73813c963815be091d4e5a7921c74b75595a9dba64736f6c63430008170033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000f494348c04be6999a3058b56068b7c84c5f50a3400000000000000000000000000000000000000000000000000000000000002b200000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000005268747470733a2f2f62616679626569617a377a736a767775367a78646a69777078773337697532336f7834627235646e6f6a7062697069326b66687578726435326e712e697066732e7733732e6c696e6b2f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000094765657a204e75747a000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044e55545a00000000000000000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : royaltyReceiver_ (address): 0xF494348C04BE6999A3058b56068b7C84c5F50a34
Arg [1] : royaltyFeeNumerator_ (uint96): 690
Arg [2] : _baseUri (string): https://bafybeiaz7zsjvwu6zxdjiwpxw37iu23ox4br5dnojpbipi2kfhuxrd52nq.ipfs.w3s.link/
Arg [3] : name_ (string): Geez Nutz
Arg [4] : symbol_ (string): NUTZ
-----Encoded View---------------
13 Constructor Arguments found :
Arg [0] : 000000000000000000000000f494348c04be6999a3058b56068b7c84c5f50a34
Arg [1] : 00000000000000000000000000000000000000000000000000000000000002b2
Arg [2] : 00000000000000000000000000000000000000000000000000000000000000a0
Arg [3] : 0000000000000000000000000000000000000000000000000000000000000120
Arg [4] : 0000000000000000000000000000000000000000000000000000000000000160
Arg [5] : 0000000000000000000000000000000000000000000000000000000000000052
Arg [6] : 68747470733a2f2f62616679626569617a377a736a767775367a78646a697770
Arg [7] : 78773337697532336f7834627235646e6f6a7062697069326b66687578726435
Arg [8] : 326e712e697066732e7733732e6c696e6b2f0000000000000000000000000000
Arg [9] : 0000000000000000000000000000000000000000000000000000000000000009
Arg [10] : 4765657a204e75747a0000000000000000000000000000000000000000000000
Arg [11] : 0000000000000000000000000000000000000000000000000000000000000004
Arg [12] : 4e55545a00000000000000000000000000000000000000000000000000000000
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.