Source Code
Overview
ETH Balance
0 ETH
ETH Value
$0.00More Info
Private Name Tags
ContractCreator
TokenTracker
Latest 25 from a total of 314 transactions
| Transaction Hash |
|
Block
|
From
|
To
|
|||||
|---|---|---|---|---|---|---|---|---|---|
| Set Approval For... | 35234084 | 8 days ago | IN | 0 ETH | 0.00000441 | ||||
| Transfer From | 34304952 | 15 days ago | IN | 0 ETH | 0.00001256 | ||||
| Set Approval For... | 29740112 | 46 days ago | IN | 0 ETH | 0.00000441 | ||||
| Set Approval For... | 21727289 | 95 days ago | IN | 0 ETH | 0.00000488 | ||||
| Set Approval For... | 21718969 | 95 days ago | IN | 0 ETH | 0.00000441 | ||||
| Set Approval For... | 21044302 | 105 days ago | IN | 0 ETH | 0.00000565 | ||||
| Set Approval For... | 20406039 | 115 days ago | IN | 0 ETH | 0.00000432 | ||||
| Transfer From | 20373490 | 115 days ago | IN | 0 ETH | 0.00001504 | ||||
| Set Approval For... | 20339078 | 116 days ago | IN | 0 ETH | 0.00000491 | ||||
| Set Approval For... | 19875579 | 123 days ago | IN | 0 ETH | 0.00000563 | ||||
| Set Approval For... | 19707049 | 126 days ago | IN | 0 ETH | 0.00000441 | ||||
| Safe Transfer Fr... | 19266813 | 133 days ago | IN | 0 ETH | 0.00001522 | ||||
| Set Approval For... | 19266624 | 133 days ago | IN | 0 ETH | 0.0000043 | ||||
| Set Approval For... | 19237290 | 133 days ago | IN | 0 ETH | 0.00000441 | ||||
| Safe Transfer Fr... | 18997243 | 137 days ago | IN | 0 ETH | 0.00001579 | ||||
| Safe Transfer Fr... | 18993996 | 137 days ago | IN | 0 ETH | 0.00001611 | ||||
| Set Approval For... | 18980003 | 137 days ago | IN | 0 ETH | 0.00000554 | ||||
| Set Approval For... | 18920943 | 138 days ago | IN | 0 ETH | 0.00000369 | ||||
| Set Approval For... | 18920926 | 138 days ago | IN | 0 ETH | 0.00000369 | ||||
| Set Approval For... | 18920901 | 138 days ago | IN | 0 ETH | 0.00000479 | ||||
| Safe Transfer Fr... | 18771492 | 140 days ago | IN | 0 ETH | 0.00001581 | ||||
| Safe Transfer Fr... | 18763867 | 140 days ago | IN | 0 ETH | 0.00001594 | ||||
| Safe Transfer Fr... | 18714861 | 141 days ago | IN | 0 ETH | 0.00001515 | ||||
| Safe Transfer Fr... | 18691774 | 141 days ago | IN | 0 ETH | 0.00001509 | ||||
| Set Approval For... | 18635912 | 142 days ago | IN | 0 ETH | 0.00000394 |
Latest 1 internal transaction
Advanced mode:
| Parent Transaction Hash | Block | From | To | |||
|---|---|---|---|---|---|---|
| 14845033 | 188 days ago | Contract Creation | 0 ETH |
Cross-Chain Transactions
Loading...
Loading
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Name:
ProofOfSuit
Compiler Version
v0.8.24+commit.e11b9ed9
ZkSolc Version
v1.5.15
Optimization Enabled:
Yes with Mode 3
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import "@limitbreak/creator-token-standards/src/token/erc721/ERC721OpenZeppelin.sol";
import "@limitbreak/creator-token-standards/src/erc721c/ERC721C.sol";
import "@limitbreak/creator-token-standards/src/programmable-royalties/BasicRoyalties.sol";
import "@limitbreak/creator-token-standards/src/access/OwnableBasic.sol";
import "@openzeppelin/contracts/utils/Counters.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
/*
██████╗ ██████╗ ██████╗ ██████╗ ███████╗
██╔══██╗██╔══██╗██╔═══██╗██╔═══██╗██╔════╝
██████╔╝██████╔╝██║ ██║██║ ██║█████╗
██╔═══╝ ██╔══██╗██║ ██║██║ ██║██╔══╝
██║ ██║ ██║╚██████╔╝╚██████╔╝██║
╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝
██████╗ ███████╗
██╔═══██╗██╔════╝
██║ ██║█████╗
██║ ██║██╔══╝
╚██████╔╝██║
╚═════╝ ╚═╝
███████╗██╗ ██╗██╗████████╗
██╔════╝██║ ██║██║╚══██╔══╝
███████╗██║ ██║██║ ██║
╚════██║██║ ██║██║ ██║
███████║╚██████╔╝██║ ██║
╚══════╝ ╚═════╝ ╚═╝ ╚═╝
*/
/**
* @title ProofOfSuit
* @dev Implementation using ERC721-C for enforced on-chain royalties
* Inherits from Limit Break's Creator Token Standards
*/
contract ProofOfSuit is OwnableBasic, ERC721C, BasicRoyalties {
using Counters for Counters.Counter;
using Strings for uint256;
Counters.Counter private _tokenIdCounter;
// Supply management
uint256 public constant MAX_SUPPLY = 150;
// Tracking mints per address
mapping(address => bool) public hasMinted;
// Base URI for metadata
string private _baseTokenURI;
// Security policy initialization tracking
bool private _securityPolicyInitialized;
// Errors
error MaxSupplyReached();
error InvalidRoyaltyBasisPoints();
error ZeroAddress();
error AlreadyMinted();
error AlreadyInitialized();
constructor(
string memory name,
string memory symbol,
address _royaltyReceiver,
uint96 _royaltyBasisPoints
)
ERC721OpenZeppelin(name, symbol)
BasicRoyalties(_royaltyReceiver, _royaltyBasisPoints)
{
if (_royaltyReceiver == address(0)) revert ZeroAddress();
if (_royaltyBasisPoints > 10000) revert InvalidRoyaltyBasisPoints();
}
/**
* @dev Initializes the default royalty enforcement security policy
* @notice Call this once after deployment to enable royalty enforcement
*/
function initializeSecurityPolicy() external onlyOwner {
if (_securityPolicyInitialized) revert AlreadyInitialized();
_securityPolicyInitialized = true;
// Set the transfer validator to Limit Break's default validator
// The setTransferValidator function is inherited from CreatorTokenBase
setTransferValidator(0x0000721C310194CcfC01E523fc93C9cCcFa2A0Ac);
}
/**
* @dev Check if security policy has been initialized
*/
function isSecurityPolicyInitialized() public view returns (bool) {
return _securityPolicyInitialized;
}
/**
* @dev Mints a new NFT (one per address only)
*/
function safeMint(address to) public onlyOwner {
if (hasMinted[to]) revert AlreadyMinted();
uint256 tokenId = _tokenIdCounter.current();
if (tokenId >= MAX_SUPPLY) revert MaxSupplyReached();
hasMinted[to] = true;
_tokenIdCounter.increment();
_safeMint(to, tokenId);
}
/**
* @dev Batch mint to multiple addresses (one per address)
*/
function batchMintToAddresses(address[] calldata recipients) public onlyOwner {
uint256 length = recipients.length;
for (uint256 i = 0; i < length; i++) {
safeMint(recipients[i]);
}
}
/**
* @dev Check if an address has already minted
*/
function canMint(address addr) public view returns (bool) {
return !hasMinted[addr];
}
/**
* @dev Returns the total number of tokens minted
*/
function totalSupply() public view returns (uint256) {
return _tokenIdCounter.current();
}
/**
* @dev Updates royalty info
*/
function setDefaultRoyalty(
address receiver,
uint96 feeNumerator
) public onlyOwner {
if (receiver == address(0)) revert ZeroAddress();
if (feeNumerator > 10000) revert InvalidRoyaltyBasisPoints();
_setDefaultRoyalty(receiver, feeNumerator);
}
/**
* @dev Updates base URI for all tokens
*/
function setBaseURI(string memory baseURI) public onlyOwner {
_baseTokenURI = baseURI;
}
/**
* @dev Returns base URI
*/
function _baseURI() internal view virtual override returns (string memory) {
return _baseTokenURI;
}
/**
* @dev Returns token URI
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
_requireMinted(tokenId);
string memory baseURI = _baseURI();
return bytes(baseURI).length > 0
? string(abi.encodePacked(baseURI, tokenId.toString()))
: "";
}
/**
* @dev Override setApprovalForAll to enforce operator filtering
* This ensures only approved operators can be granted approval
*/
function setApprovalForAll(
address operator,
bool approved
) public virtual override {
super.setApprovalForAll(operator, approved);
}
/**
* @dev Override approve to enforce operator filtering
* This ensures only approved operators can be granted approval for specific tokens
*/
function approve(
address to,
uint256 tokenId
) public virtual override {
super.approve(to, tokenId);
}
/**
* @dev See {IERC165-supportsInterface}
*/
function supportsInterface(
bytes4 interfaceId
) public view virtual override(ERC721C, ERC2981) returns (bool) {
return super.supportsInterface(interfaceId);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../utils/AutomaticValidatorTransferApproval.sol";
import "../utils/CreatorTokenBase.sol";
import "../token/erc721/ERC721OpenZeppelin.sol";
import "../interfaces/ITransferValidatorSetTokenType.sol";
import {TOKEN_TYPE_ERC721} from "@limitbreak/permit-c/src/Constants.sol";
/**
* @title ERC721C
* @author Limit Break, Inc.
* @notice Extends OpenZeppelin's ERC721 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 ERC721C is ERC721OpenZeppelin, CreatorTokenBase, AutomaticValidatorTransferApproval {
/**
* @notice Overrides behavior of isApprovedFor all such that if an operator is not explicitly approved
* for all, the contract owner can optionally auto-approve the 721-C transfer validator for transfers.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool isApproved) {
isApproved = super.isApprovedForAll(owner, operator);
if (!isApproved) {
if (autoApproveTransfersFromValidator) {
isApproved = operator == address(getTransferValidator());
}
}
}
/**
* @notice Indicates whether the contract implements the specified interface.
* @dev Overrides supportsInterface in ERC165.
* @param interfaceId The interface id
* @return true if the contract implements the specified interface, false otherwise
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return
interfaceId == type(ICreatorToken).interfaceId ||
interfaceId == type(ICreatorTokenLegacy).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @notice Returns the function selector for the transfer validator's validation function to be called
* @notice for transaction simulation.
*/
function getTransferValidationFunction() external pure returns (bytes4 functionSignature, bool isViewFunction) {
functionSignature = bytes4(keccak256("validateTransfer(address,address,address,uint256)"));
isViewFunction = true;
}
/// @dev Ties the open-zeppelin _beforeTokenTransfer hook to more granular transfer validation logic
function _beforeTokenTransfer(
address from,
address to,
uint256 firstTokenId,
uint256 batchSize) internal virtual override {
for (uint256 i = 0; i < batchSize;) {
_validateBeforeTransfer(from, to, firstTokenId + i);
unchecked {
++i;
}
}
}
/// @dev Ties the open-zeppelin _afterTokenTransfer hook to more granular transfer validation logic
function _afterTokenTransfer(
address from,
address to,
uint256 firstTokenId,
uint256 batchSize) internal virtual override {
for (uint256 i = 0; i < batchSize;) {
_validateAfterTransfer(from, to, firstTokenId + i);
unchecked {
++i;
}
}
}
function _tokenType() internal pure override returns(uint16) {
return uint16(TOKEN_TYPE_ERC721);
}
}
/**
* @title ERC721CInitializable
* @author Limit Break, Inc.
* @notice Initializable implementation of ERC721C to allow for EIP-1167 proxy clones.
*/
abstract contract ERC721CInitializable is ERC721OpenZeppelinInitializable, CreatorTokenBase, AutomaticValidatorTransferApproval {
function initializeERC721(string memory name_, string memory symbol_) public override {
super.initializeERC721(name_, symbol_);
_emitDefaultTransferValidator();
_registerTokenType(getTransferValidator());
}
/**
* @notice Overrides behavior of isApprovedFor all such that if an operator is not explicitly approved
* for all, the contract owner can optionally auto-approve the 721-C transfer validator for transfers.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool isApproved) {
isApproved = super.isApprovedForAll(owner, operator);
if (!isApproved) {
if (autoApproveTransfersFromValidator) {
isApproved = operator == address(getTransferValidator());
}
}
}
/**
* @notice Indicates whether the contract implements the specified interface.
* @dev Overrides supportsInterface in ERC165.
* @param interfaceId The interface id
* @return true if the contract implements the specified interface, false otherwise
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return
interfaceId == type(ICreatorToken).interfaceId ||
interfaceId == type(ICreatorTokenLegacy).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @notice Returns the function selector for the transfer validator's validation function to be called
* @notice for transaction simulation.
*/
function getTransferValidationFunction() external pure returns (bytes4 functionSignature, bool isViewFunction) {
functionSignature = bytes4(keccak256("validateTransfer(address,address,address,uint256)"));
isViewFunction = true;
}
/// @dev Ties the open-zeppelin _beforeTokenTransfer hook to more granular transfer validation logic
function _beforeTokenTransfer(
address from,
address to,
uint256 firstTokenId,
uint256 batchSize) internal virtual override {
for (uint256 i = 0; i < batchSize;) {
_validateBeforeTransfer(from, to, firstTokenId + i);
unchecked {
++i;
}
}
}
/// @dev Ties the open-zeppelin _afterTokenTransfer hook to more granular transfer validation logic
function _afterTokenTransfer(
address from,
address to,
uint256 firstTokenId,
uint256 batchSize) internal virtual override {
for (uint256 i = 0; i < batchSize;) {
_validateAfterTransfer(from, to, firstTokenId + i);
unchecked {
++i;
}
}
}
function _tokenType() internal pure override returns(uint16) {
return uint16(TOKEN_TYPE_ERC721);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../../access/OwnablePermissions.sol";
import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
abstract contract ERC721OpenZeppelinBase is ERC721 {
// Token name
string internal _contractName;
// Token symbol
string internal _contractSymbol;
function name() public view virtual override returns (string memory) {
return _contractName;
}
function symbol() public view virtual override returns (string memory) {
return _contractSymbol;
}
function _setNameAndSymbol(string memory name_, string memory symbol_) internal {
_contractName = name_;
_contractSymbol = symbol_;
}
}
abstract contract ERC721OpenZeppelin is ERC721OpenZeppelinBase {
constructor(string memory name_, string memory symbol_) ERC721("", "") {
_setNameAndSymbol(name_, symbol_);
}
}
abstract contract ERC721OpenZeppelinInitializable is OwnablePermissions, ERC721OpenZeppelinBase {
error ERC721OpenZeppelinInitializable__AlreadyInitializedERC721();
/// @notice Specifies whether or not the contract is initialized
bool private _erc721Initialized;
/// @dev Initializes parameters of ERC721 tokens.
/// These cannot be set in the constructor because this contract is optionally compatible with EIP-1167.
function initializeERC721(string memory name_, string memory symbol_) public virtual {
_requireCallerIsContractOwner();
if(_erc721Initialized) {
revert ERC721OpenZeppelinInitializable__AlreadyInitializedERC721();
}
_erc721Initialized = true;
_setNameAndSymbol(name_, symbol_);
}
}// 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 "./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
// OpenZeppelin Contracts v4.4.1 (utils/Counters.sol)
pragma solidity ^0.8.0;
/**
* @title Counters
* @author Matt Condon (@shrugs)
* @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
* of elements in a mapping, issuing ERC721 ids, or counting request ids.
*
* Include with `using Counters for Counters.Counter;`
*/
library Counters {
struct Counter {
// This variable should never be directly accessed by users of the library: interactions must be restricted to
// the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
// this feature: see https://github.com/ethereum/solidity/issues/4637
uint256 _value; // default: 0
}
function current(Counter storage counter) internal view returns (uint256) {
return counter._value;
}
function increment(Counter storage counter) internal {
unchecked {
counter._value += 1;
}
}
function decrement(Counter storage counter) internal {
uint256 value = counter._value;
require(value > 0, "Counter: decrement overflow");
unchecked {
counter._value = value - 1;
}
}
function reset(Counter storage counter) internal {
counter._value = 0;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)
pragma solidity ^0.8.0;
import "./math/Math.sol";
/**
* @dev String operations.
*/
library Strings {
bytes16 private constant _SYMBOLS = "0123456789abcdef";
uint8 private constant _ADDRESS_LENGTH = 20;
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = Math.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
/// @solidity memory-safe-assembly
assembly {
ptr := add(buffer, add(32, length))
}
while (true) {
ptr--;
/// @solidity memory-safe-assembly
assembly {
mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
}
value /= 10;
if (value == 0) break;
}
return buffer;
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
unchecked {
return toHexString(value, Math.log256(value) + 1);
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = _SYMBOLS[value & 0xf];
value >>= 4;
}
require(value == 0, "Strings: hex length insufficient");
return string(buffer);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
*/
function toHexString(address addr) internal pure returns (string memory) {
return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
interface ITransferValidatorSetTokenType {
function setTokenTypeOfCollection(address collection, uint16 tokenType) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../access/OwnablePermissions.sol";
import "../interfaces/ICreatorToken.sol";
import "../interfaces/ICreatorTokenLegacy.sol";
import "../interfaces/ITransferValidator.sol";
import "./TransferValidation.sol";
import "../interfaces/ITransferValidatorSetTokenType.sol";
/**
* @title CreatorTokenBase
* @author Limit Break, Inc.
* @notice CreatorTokenBaseV3 is an abstract contract that provides basic functionality for managing token
* transfer policies through an implementation of ICreatorTokenTransferValidator/ICreatorTokenTransferValidatorV2/ICreatorTokenTransferValidatorV3.
* This contract is intended to be used as a base for creator-specific token contracts, enabling customizable transfer
* restrictions and security policies.
*
* <h4>Features:</h4>
* <ul>Ownable: This contract can have an owner who can set and update the transfer validator.</ul>
* <ul>TransferValidation: Implements the basic token transfer validation interface.</ul>
*
* <h4>Benefits:</h4>
* <ul>Provides a flexible and modular way to implement custom token transfer restrictions and security policies.</ul>
* <ul>Allows creators to enforce policies such as account and codehash blacklists, whitelists, and graylists.</ul>
* <ul>Can be easily integrated into other token contracts as a base contract.</ul>
*
* <h4>Intended Usage:</h4>
* <ul>Use as a base contract for creator token implementations that require advanced transfer restrictions and
* security policies.</ul>
* <ul>Set and update the ICreatorTokenTransferValidator implementation contract to enforce desired policies for the
* creator token.</ul>
*
* <h4>Compatibility:</h4>
* <ul>Backward and Forward Compatible - V1/V2/V3 Creator Token Base will work with V1/V2/V3 Transfer Validators.</ul>
*/
abstract contract CreatorTokenBase is OwnablePermissions, TransferValidation, ICreatorToken {
/// @dev Thrown when setting a transfer validator address that has no deployed code.
error CreatorTokenBase__InvalidTransferValidatorContract();
/// @dev The default transfer validator that will be used if no transfer validator has been set by the creator.
address public constant DEFAULT_TRANSFER_VALIDATOR = address(0x721C008fdff27BF06E7E123956E2Fe03B63342e3);
/// @dev Used to determine if the default transfer validator is applied.
/// @dev Set to true when the creator sets a transfer validator address.
bool private isValidatorInitialized;
/// @dev Address of the transfer validator to apply to transactions.
address private transferValidator;
constructor() {
_emitDefaultTransferValidator();
_registerTokenType(DEFAULT_TRANSFER_VALIDATOR);
}
/**
* @notice Sets the transfer validator for the token contract.
*
* @dev Throws when provided validator contract is not the zero address and does not have code.
* @dev Throws when the caller is not the contract owner.
*
* @dev <h4>Postconditions:</h4>
* 1. The transferValidator address is updated.
* 2. The `TransferValidatorUpdated` event is emitted.
*
* @param transferValidator_ The address of the transfer validator contract.
*/
function setTransferValidator(address transferValidator_) public {
_requireCallerIsContractOwner();
bool isValidTransferValidator = transferValidator_.code.length > 0;
if(transferValidator_ != address(0) && !isValidTransferValidator) {
revert CreatorTokenBase__InvalidTransferValidatorContract();
}
emit TransferValidatorUpdated(address(getTransferValidator()), transferValidator_);
isValidatorInitialized = true;
transferValidator = transferValidator_;
_registerTokenType(transferValidator_);
}
/**
* @notice Returns the transfer validator contract address for this token contract.
*/
function getTransferValidator() public view override returns (address validator) {
validator = transferValidator;
if (validator == address(0)) {
if (!isValidatorInitialized) {
validator = DEFAULT_TRANSFER_VALIDATOR;
}
}
}
/**
* @dev Pre-validates a token transfer, reverting if the transfer is not allowed by this token's security policy.
* Inheriting contracts are responsible for overriding the _beforeTokenTransfer function, or its equivalent
* and calling _validateBeforeTransfer so that checks can be properly applied during token transfers.
*
* @dev Be aware that if the msg.sender is the transfer validator, the transfer is automatically permitted, as the
* transfer validator is expected to pre-validate the transfer.
*
* @dev Throws when the transfer doesn't comply with the collection's transfer policy, if the transferValidator is
* set to a non-zero address.
*
* @param caller The address of the caller.
* @param from The address of the sender.
* @param to The address of the receiver.
* @param tokenId The token id being transferred.
*/
function _preValidateTransfer(
address caller,
address from,
address to,
uint256 tokenId,
uint256 /*value*/) internal virtual override {
address validator = getTransferValidator();
if (validator != address(0)) {
if (msg.sender == validator) {
return;
}
ITransferValidator(validator).validateTransfer(caller, from, to, tokenId);
}
}
/**
* @dev Pre-validates a token transfer, reverting if the transfer is not allowed by this token's security policy.
* Inheriting contracts are responsible for overriding the _beforeTokenTransfer function, or its equivalent
* and calling _validateBeforeTransfer so that checks can be properly applied during token transfers.
*
* @dev Be aware that if the msg.sender is the transfer validator, the transfer is automatically permitted, as the
* transfer validator is expected to pre-validate the transfer.
*
* @dev Used for ERC20 and ERC1155 token transfers which have an amount value to validate in the transfer validator.
* @dev The `tokenId` for ERC20 tokens should be set to `0`.
*
* @dev Throws when the transfer doesn't comply with the collection's transfer policy, if the transferValidator is
* set to a non-zero address.
*
* @param caller The address of the caller.
* @param from The address of the sender.
* @param to The address of the receiver.
* @param tokenId The token id being transferred.
* @param amount The amount of token being transferred.
*/
function _preValidateTransfer(
address caller,
address from,
address to,
uint256 tokenId,
uint256 amount,
uint256 /*value*/) internal virtual override {
address validator = getTransferValidator();
if (validator != address(0)) {
if (msg.sender == validator) {
return;
}
ITransferValidator(validator).validateTransfer(caller, from, to, tokenId, amount);
}
}
function _tokenType() internal virtual pure returns(uint16);
function _registerTokenType(address validator) internal {
if (validator != address(0)) {
uint256 validatorCodeSize;
assembly {
validatorCodeSize := extcodesize(validator)
}
if(validatorCodeSize > 0) {
try ITransferValidatorSetTokenType(validator).setTokenTypeOfCollection(address(this), _tokenType()) {
} catch { }
}
}
}
/**
* @dev Used during contract deployment for constructable and cloneable creator tokens
* @dev to emit the `TransferValidatorUpdated` event signaling the validator for the contract
* @dev is the default transfer validator.
*/
function _emitDefaultTransferValidator() internal {
emit TransferValidatorUpdated(address(0), DEFAULT_TRANSFER_VALIDATOR);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../access/OwnablePermissions.sol";
/**
* @title AutomaticValidatorTransferApproval
* @author Limit Break, Inc.
* @notice Base contract mix-in that provides boilerplate code giving the contract owner the
* option to automatically approve a 721-C transfer validator implementation for transfers.
*/
abstract contract AutomaticValidatorTransferApproval is OwnablePermissions {
/// @dev Emitted when the automatic approval flag is modified by the creator.
event AutomaticApprovalOfTransferValidatorSet(bool autoApproved);
/// @dev If true, the collection's transfer validator is automatically approved to transfer holder's tokens.
bool public autoApproveTransfersFromValidator;
/**
* @notice Sets if the transfer validator is automatically approved as an operator for all token owners.
*
* @dev Throws when the caller is not the contract owner.
*
* @param autoApprove If true, the collection's transfer validator will be automatically approved to
* transfer holder's tokens.
*/
function setAutomaticApprovalOfTransfersFromValidator(bool autoApprove) external {
_requireCallerIsContractOwner();
autoApproveTransfersFromValidator = autoApprove;
emit AutomaticApprovalOfTransferValidatorSet(autoApprove);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/utils/Context.sol";
abstract contract OwnablePermissions is Context {
function _requireCallerIsContractOwner() internal view virtual;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
/// @dev Constant bytes32 value of 0x000...000
bytes32 constant ZERO_BYTES32 = bytes32(0);
/// @dev Constant value of 0
uint256 constant ZERO = 0;
/// @dev Constant value of 1
uint256 constant ONE = 1;
/// @dev Constant value representing an open order in storage
uint8 constant ORDER_STATE_OPEN = 0;
/// @dev Constant value representing a filled order in storage
uint8 constant ORDER_STATE_FILLED = 1;
/// @dev Constant value representing a cancelled order in storage
uint8 constant ORDER_STATE_CANCELLED = 2;
/// @dev Constant value representing the ERC721 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC721 = 721;
/// @dev Constant value representing the ERC1155 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC1155 = 1155;
/// @dev Constant value representing the ERC20 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC20 = 20;
/// @dev Constant value to mask the upper bits of a signature that uses a packed `vs` value to extract `s`
bytes32 constant UPPER_BIT_MASK = 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff;
/// @dev EIP-712 typehash used for validating signature based stored approvals
bytes32 constant UPDATE_APPROVAL_TYPEHASH =
keccak256("UpdateApprovalBySignature(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 approvalExpiration,uint256 sigDeadline,uint256 masterNonce)");
/// @dev EIP-712 typehash used for validating a single use permit without additional data
bytes32 constant SINGLE_USE_PERMIT_TYPEHASH =
keccak256("PermitTransferFrom(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 expiration,uint256 masterNonce)");
/// @dev EIP-712 typehash used for validating a single use permit with additional data
string constant SINGLE_USE_PERMIT_TRANSFER_ADVANCED_TYPEHASH_STUB =
"PermitTransferFromWithAdditionalData(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 expiration,uint256 masterNonce,";
/// @dev EIP-712 typehash used for validating an order permit that updates storage as it fills
string constant PERMIT_ORDER_ADVANCED_TYPEHASH_STUB =
"PermitOrderWithAdditionalData(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 salt,address operator,uint256 expiration,uint256 masterNonce,";
/// @dev Pausable flag for stored approval transfers of ERC721 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC721 = 1 << 0;
/// @dev Pausable flag for stored approval transfers of ERC1155 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC1155 = 1 << 1;
/// @dev Pausable flag for stored approval transfers of ERC20 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC20 = 1 << 2;
/// @dev Pausable flag for single use permit transfers of ERC721 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC721 = 1 << 3;
/// @dev Pausable flag for single use permit transfers of ERC1155 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC1155 = 1 << 4;
/// @dev Pausable flag for single use permit transfers of ERC20 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC20 = 1 << 5;
/// @dev Pausable flag for order fill transfers of ERC1155 assets
uint256 constant PAUSABLE_ORDER_TRANSFER_FROM_ERC1155 = 1 << 6;
/// @dev Pausable flag for order fill transfers of ERC20 assets
uint256 constant PAUSABLE_ORDER_TRANSFER_FROM_ERC20 = 1 << 7;// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.2) (token/ERC721/ERC721.sol)
pragma solidity ^0.8.0;
import "./IERC721.sol";
import "./IERC721Receiver.sol";
import "./extensions/IERC721Metadata.sol";
import "../../utils/Address.sol";
import "../../utils/Context.sol";
import "../../utils/Strings.sol";
import "../../utils/introspection/ERC165.sol";
/**
* @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
* the Metadata extension, but not including the Enumerable extension, which is available separately as
* {ERC721Enumerable}.
*/
contract ERC721 is Context, ERC165, IERC721, IERC721Metadata {
using Address for address;
using Strings for uint256;
// Token name
string private _name;
// Token symbol
string private _symbol;
// Mapping from token ID to owner address
mapping(uint256 => address) private _owners;
// Mapping owner address to token count
mapping(address => uint256) private _balances;
// Mapping from token ID to approved address
mapping(uint256 => address) private _tokenApprovals;
// Mapping from owner to operator approvals
mapping(address => mapping(address => bool)) private _operatorApprovals;
/**
* @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
*/
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
return
interfaceId == type(IERC721).interfaceId ||
interfaceId == type(IERC721Metadata).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC721-balanceOf}.
*/
function balanceOf(address owner) public view virtual override returns (uint256) {
require(owner != address(0), "ERC721: address zero is not a valid owner");
return _balances[owner];
}
/**
* @dev See {IERC721-ownerOf}.
*/
function ownerOf(uint256 tokenId) public view virtual override returns (address) {
address owner = _ownerOf(tokenId);
require(owner != address(0), "ERC721: invalid token ID");
return owner;
}
/**
* @dev See {IERC721Metadata-name}.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev See {IERC721Metadata-symbol}.
*/
function symbol() public view virtual override returns (string memory) {
return _symbol;
}
/**
* @dev See {IERC721Metadata-tokenURI}.
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
_requireMinted(tokenId);
string memory baseURI = _baseURI();
return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
}
/**
* @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
* token will be the concatenation of the `baseURI` and the `tokenId`. Empty
* by default, can be overridden in child contracts.
*/
function _baseURI() internal view virtual returns (string memory) {
return "";
}
/**
* @dev See {IERC721-approve}.
*/
function approve(address to, uint256 tokenId) public virtual override {
address owner = ERC721.ownerOf(tokenId);
require(to != owner, "ERC721: approval to current owner");
require(
_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
"ERC721: approve caller is not token owner or approved for all"
);
_approve(to, tokenId);
}
/**
* @dev See {IERC721-getApproved}.
*/
function getApproved(uint256 tokenId) public view virtual override returns (address) {
_requireMinted(tokenId);
return _tokenApprovals[tokenId];
}
/**
* @dev See {IERC721-setApprovalForAll}.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_setApprovalForAll(_msgSender(), operator, approved);
}
/**
* @dev See {IERC721-isApprovedForAll}.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
return _operatorApprovals[owner][operator];
}
/**
* @dev See {IERC721-transferFrom}.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) public virtual override {
//solhint-disable-next-line max-line-length
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
_transfer(from, to, tokenId);
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) public virtual override {
safeTransferFrom(from, to, tokenId, "");
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes memory data
) public virtual override {
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
_safeTransfer(from, to, tokenId, data);
}
/**
* @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
* are aware of the ERC721 protocol to prevent tokens from being forever locked.
*
* `data` is additional data, it has no specified format and it is sent in call to `to`.
*
* This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
* implement alternative mechanisms to perform token transfer, such as signature-based.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function _safeTransfer(
address from,
address to,
uint256 tokenId,
bytes memory data
) internal virtual {
_transfer(from, to, tokenId);
require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer");
}
/**
* @dev Returns the owner of the `tokenId`. Does NOT revert if token doesn't exist
*/
function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
return _owners[tokenId];
}
/**
* @dev Returns whether `tokenId` exists.
*
* Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
*
* Tokens start existing when they are minted (`_mint`),
* and stop existing when they are burned (`_burn`).
*/
function _exists(uint256 tokenId) internal view virtual returns (bool) {
return _ownerOf(tokenId) != address(0);
}
/**
* @dev Returns whether `spender` is allowed to manage `tokenId`.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
address owner = ERC721.ownerOf(tokenId);
return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
}
/**
* @dev Safely mints `tokenId` and transfers it to `to`.
*
* Requirements:
*
* - `tokenId` must not exist.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function _safeMint(address to, uint256 tokenId) internal virtual {
_safeMint(to, tokenId, "");
}
/**
* @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
* forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
*/
function _safeMint(
address to,
uint256 tokenId,
bytes memory data
) internal virtual {
_mint(to, tokenId);
require(
_checkOnERC721Received(address(0), to, tokenId, data),
"ERC721: transfer to non ERC721Receiver implementer"
);
}
/**
* @dev Mints `tokenId` and transfers it to `to`.
*
* WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
*
* Requirements:
*
* - `tokenId` must not exist.
* - `to` cannot be the zero address.
*
* Emits a {Transfer} event.
*/
function _mint(address to, uint256 tokenId) internal virtual {
require(to != address(0), "ERC721: mint to the zero address");
require(!_exists(tokenId), "ERC721: token already minted");
_beforeTokenTransfer(address(0), to, tokenId, 1);
// Check that tokenId was not minted by `_beforeTokenTransfer` hook
require(!_exists(tokenId), "ERC721: token already minted");
unchecked {
// Will not overflow unless all 2**256 token ids are minted to the same owner.
// Given that tokens are minted one by one, it is impossible in practice that
// this ever happens. Might change if we allow batch minting.
// The ERC fails to describe this case.
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(address(0), to, tokenId);
_afterTokenTransfer(address(0), to, tokenId, 1);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
* This is an internal function that does not check if the sender is authorized to operate on the token.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/
function _burn(uint256 tokenId) internal virtual {
address owner = ERC721.ownerOf(tokenId);
_beforeTokenTransfer(owner, address(0), tokenId, 1);
// Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
owner = ERC721.ownerOf(tokenId);
// Clear approvals
delete _tokenApprovals[tokenId];
unchecked {
// Cannot overflow, as that would require more tokens to be burned/transferred
// out than the owner initially received through minting and transferring in.
_balances[owner] -= 1;
}
delete _owners[tokenId];
emit Transfer(owner, address(0), tokenId);
_afterTokenTransfer(owner, address(0), tokenId, 1);
}
/**
* @dev Transfers `tokenId` from `from` to `to`.
* As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
*
* Emits a {Transfer} event.
*/
function _transfer(
address from,
address to,
uint256 tokenId
) internal virtual {
require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
require(to != address(0), "ERC721: transfer to the zero address");
_beforeTokenTransfer(from, to, tokenId, 1);
// Check that tokenId was not transferred by `_beforeTokenTransfer` hook
require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
// Clear approvals from the previous owner
delete _tokenApprovals[tokenId];
unchecked {
// `_balances[from]` cannot overflow for the same reason as described in `_burn`:
// `from`'s balance is the number of token held, which is at least one before the current
// transfer.
// `_balances[to]` could overflow in the conditions described in `_mint`. That would require
// all 2**256 token ids to be minted, which in practice is impossible.
_balances[from] -= 1;
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(from, to, tokenId);
_afterTokenTransfer(from, to, tokenId, 1);
}
/**
* @dev Approve `to` to operate on `tokenId`
*
* Emits an {Approval} event.
*/
function _approve(address to, uint256 tokenId) internal virtual {
_tokenApprovals[tokenId] = to;
emit Approval(ERC721.ownerOf(tokenId), to, tokenId);
}
/**
* @dev Approve `operator` to operate on all of `owner` tokens
*
* Emits an {ApprovalForAll} event.
*/
function _setApprovalForAll(
address owner,
address operator,
bool approved
) internal virtual {
require(owner != operator, "ERC721: approve to caller");
_operatorApprovals[owner][operator] = approved;
emit ApprovalForAll(owner, operator, approved);
}
/**
* @dev Reverts if the `tokenId` has not been minted yet.
*/
function _requireMinted(uint256 tokenId) internal view virtual {
require(_exists(tokenId), "ERC721: invalid token ID");
}
/**
* @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
* The call is not executed if the target address is not a contract.
*
* @param from address representing the previous owner of the given token ID
* @param to target address that will receive the tokens
* @param tokenId uint256 ID of the token to be transferred
* @param data bytes optional data to send along with the call
* @return bool whether the call correctly returned the expected magic value
*/
function _checkOnERC721Received(
address from,
address to,
uint256 tokenId,
bytes memory data
) private returns (bool) {
if (to.isContract()) {
try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
return retval == IERC721Receiver.onERC721Received.selector;
} catch (bytes memory reason) {
if (reason.length == 0) {
revert("ERC721: transfer to non ERC721Receiver implementer");
} else {
/// @solidity memory-safe-assembly
assembly {
revert(add(32, reason), mload(reason))
}
}
}
} else {
return true;
}
}
/**
* @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
* - When `from` is zero, the tokens will be minted for `to`.
* - When `to` is zero, ``from``'s tokens will be burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _beforeTokenTransfer(
address from,
address to,
uint256 firstTokenId,
uint256 batchSize
) internal virtual {}
/**
* @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
* - When `from` is zero, the tokens were minted for `to`.
* - When `to` is zero, ``from``'s tokens were burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _afterTokenTransfer(
address from,
address to,
uint256 firstTokenId,
uint256 batchSize
) internal virtual {}
/**
* @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
*
* WARNING: Anyone calling this MUST ensure that the balances remain consistent with the ownership. The invariant
* being that for any address `a` the value returned by `balanceOf(a)` must be equal to the number of tokens such
* that `ownerOf(tokenId)` is `a`.
*/
// solhint-disable-next-line func-name-mixedcase
function __unsafe_increaseBalance(address account, uint256 amount) internal {
_balances[account] += amount;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)
pragma solidity ^0.8.0;
import "../utils/Context.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* By default, the owner account will be the one that deploys the contract. This
* can later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract Ownable is Context {
address private _owner;
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the deployer as the initial owner.
*/
constructor() {
_transferOwnership(_msgSender());
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
require(owner() == _msgSender(), "Ownable: caller is not the owner");
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions anymore. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby removing any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
require(newOwner != address(0), "Ownable: new owner is the zero address");
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (token/common/ERC2981.sol)
pragma solidity ^0.8.0;
import "../../interfaces/IERC2981.sol";
import "../../utils/introspection/ERC165.sol";
/**
* @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information.
*
* Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for
* specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first.
*
* Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the
* fee is specified in basis points by default.
*
* IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
* https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the EIP. Marketplaces are expected to
* voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
*
* _Available since v4.5._
*/
abstract contract ERC2981 is IERC2981, ERC165 {
struct RoyaltyInfo {
address receiver;
uint96 royaltyFraction;
}
RoyaltyInfo private _defaultRoyaltyInfo;
mapping(uint256 => RoyaltyInfo) private _tokenRoyaltyInfo;
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {
return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @inheritdoc IERC2981
*/
function royaltyInfo(uint256 _tokenId, uint256 _salePrice) public view virtual override returns (address, uint256) {
RoyaltyInfo memory royalty = _tokenRoyaltyInfo[_tokenId];
if (royalty.receiver == address(0)) {
royalty = _defaultRoyaltyInfo;
}
uint256 royaltyAmount = (_salePrice * royalty.royaltyFraction) / _feeDenominator();
return (royalty.receiver, royaltyAmount);
}
/**
* @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a
* fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an
* override.
*/
function _feeDenominator() internal pure virtual returns (uint96) {
return 10000;
}
/**
* @dev Sets the royalty information that all ids in this contract will default to.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
require(receiver != address(0), "ERC2981: invalid receiver");
_defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Removes default royalty information.
*/
function _deleteDefaultRoyalty() internal virtual {
delete _defaultRoyaltyInfo;
}
/**
* @dev Sets the royalty information for a specific token id, overriding the global default.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setTokenRoyalty(
uint256 tokenId,
address receiver,
uint96 feeNumerator
) internal virtual {
require(feeNumerator <= _feeDenominator(), "ERC2981: royalty fee will exceed salePrice");
require(receiver != address(0), "ERC2981: Invalid parameters");
_tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Resets royalty information for the token id back to the global default.
*/
function _resetTokenRoyalty(uint256 tokenId) internal virtual {
delete _tokenRoyaltyInfo[tokenId];
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library Math {
enum Rounding {
Down, // Toward negative infinity
Up, // Toward infinity
Zero // Toward zero
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds up instead
* of rounding down.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b - 1) / b can overflow on addition, so we distribute.
return a == 0 ? 0 : (a - 1) / b + 1;
}
/**
* @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
* @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
* with further edits by Uniswap Labs also under MIT license.
*/
function mulDiv(
uint256 x,
uint256 y,
uint256 denominator
) internal pure returns (uint256 result) {
unchecked {
// 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
// use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = prod1 * 2^256 + prod0.
uint256 prod0; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod0 := mul(x, y)
prod1 := sub(sub(mm, prod0), lt(mm, prod0))
}
// Handle non-overflow cases, 256 by 256 division.
if (prod1 == 0) {
return prod0 / denominator;
}
// Make sure the result is less than 2^256. Also prevents denominator == 0.
require(denominator > prod1);
///////////////////////////////////////////////
// 512 by 256 division.
///////////////////////////////////////////////
// Make division exact by subtracting the remainder from [prod1 prod0].
uint256 remainder;
assembly {
// Compute remainder using mulmod.
remainder := mulmod(x, y, denominator)
// Subtract 256 bit number from 512 bit number.
prod1 := sub(prod1, gt(remainder, prod0))
prod0 := sub(prod0, remainder)
}
// Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
// See https://cs.stackexchange.com/q/138556/92363.
// Does not overflow because the denominator cannot be zero at this stage in the function.
uint256 twos = denominator & (~denominator + 1);
assembly {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [prod1 prod0] by twos.
prod0 := div(prod0, twos)
// Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
twos := add(div(sub(0, twos), twos), 1)
}
// Shift in bits from prod1 into prod0.
prod0 |= prod1 * twos;
// Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
// that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv = 1 mod 2^4.
uint256 inverse = (3 * denominator) ^ 2;
// Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
// in modular arithmetic, doubling the correct bits in each step.
inverse *= 2 - denominator * inverse; // inverse mod 2^8
inverse *= 2 - denominator * inverse; // inverse mod 2^16
inverse *= 2 - denominator * inverse; // inverse mod 2^32
inverse *= 2 - denominator * inverse; // inverse mod 2^64
inverse *= 2 - denominator * inverse; // inverse mod 2^128
inverse *= 2 - denominator * inverse; // inverse mod 2^256
// Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
// This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
// less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
// is no longer required.
result = prod0 * inverse;
return result;
}
}
/**
* @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
*/
function mulDiv(
uint256 x,
uint256 y,
uint256 denominator,
Rounding rounding
) internal pure returns (uint256) {
uint256 result = mulDiv(x, y, denominator);
if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
result += 1;
}
return result;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
*
* Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
*/
function sqrt(uint256 a) internal pure returns (uint256) {
if (a == 0) {
return 0;
}
// For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
//
// We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
// `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
//
// This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
// → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
// → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
//
// Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
uint256 result = 1 << (log2(a) >> 1);
// At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
// since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
// every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
// into the expected uint128 result.
unchecked {
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
return min(result, a / result);
}
}
/**
* @notice Calculates sqrt(a), following the selected rounding direction.
*/
function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = sqrt(a);
return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
}
}
/**
* @dev Return the log in base 2, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 128;
}
if (value >> 64 > 0) {
value >>= 64;
result += 64;
}
if (value >> 32 > 0) {
value >>= 32;
result += 32;
}
if (value >> 16 > 0) {
value >>= 16;
result += 16;
}
if (value >> 8 > 0) {
value >>= 8;
result += 8;
}
if (value >> 4 > 0) {
value >>= 4;
result += 4;
}
if (value >> 2 > 0) {
value >>= 2;
result += 2;
}
if (value >> 1 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 2, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log2(value);
return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 10, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10**64) {
value /= 10**64;
result += 64;
}
if (value >= 10**32) {
value /= 10**32;
result += 32;
}
if (value >= 10**16) {
value /= 10**16;
result += 16;
}
if (value >= 10**8) {
value /= 10**8;
result += 8;
}
if (value >= 10**4) {
value /= 10**4;
result += 4;
}
if (value >= 10**2) {
value /= 10**2;
result += 2;
}
if (value >= 10**1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 256, rounded down, of a positive value.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 16;
}
if (value >> 64 > 0) {
value >>= 64;
result += 8;
}
if (value >> 32 > 0) {
value >>= 32;
result += 4;
}
if (value >> 16 > 0) {
value >>= 16;
result += 2;
}
if (value >> 8 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log256(value);
return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0);
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
interface ICreatorToken {
event TransferValidatorUpdated(address oldValidator, address newValidator);
function getTransferValidator() external view returns (address validator);
function setTransferValidator(address validator) external;
function getTransferValidationFunction() external view returns (bytes4 functionSignature, bool isViewFunction);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
interface ITransferValidator {
function applyCollectionTransferPolicy(address caller, address from, address to) external view;
function validateTransfer(address caller, address from, address to) external view;
function validateTransfer(address caller, address from, address to, uint256 tokenId) external view;
function validateTransfer(address caller, address from, address to, uint256 tokenId, uint256 amount) external;
function beforeAuthorizedTransfer(address operator, address token, uint256 tokenId) external;
function afterAuthorizedTransfer(address token, uint256 tokenId) external;
function beforeAuthorizedTransfer(address operator, address token) external;
function afterAuthorizedTransfer(address token) external;
function beforeAuthorizedTransfer(address token, uint256 tokenId) external;
function beforeAuthorizedTransferWithAmount(address token, uint256 tokenId, uint256 amount) external;
function afterAuthorizedTransferWithAmount(address token, uint256 tokenId) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
interface ICreatorTokenLegacy {
event TransferValidatorUpdated(address oldValidator, address newValidator);
function getTransferValidator() external view returns (address validator);
function setTransferValidator(address validator) external;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value
) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) private pure {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
pragma solidity ^0.8.0;
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts 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
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/utils/Context.sol";
/**
* @title TransferValidation
* @author Limit Break, Inc.
* @notice A mix-in that can be combined with ERC-721 contracts to provide more granular hooks.
* Openzeppelin's ERC721 contract only provides hooks for before and after transfer. This allows
* developers to validate or customize transfers within the context of a mint, a burn, or a transfer.
*/
abstract contract TransferValidation is Context {
/// @dev Thrown when the from and to address are both the zero address.
error ShouldNotMintToBurnAddress();
/*************************************************************************/
/* Transfers Without Amounts */
/*************************************************************************/
/// @dev Inheriting contracts should call this function in the _beforeTokenTransfer function to get more granular hooks.
function _validateBeforeTransfer(address from, address to, uint256 tokenId) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_preValidateMint(_msgSender(), to, tokenId, msg.value);
} else if(toZeroAddress) {
_preValidateBurn(_msgSender(), from, tokenId, msg.value);
} else {
_preValidateTransfer(_msgSender(), from, to, tokenId, msg.value);
}
}
/// @dev Inheriting contracts should call this function in the _afterTokenTransfer function to get more granular hooks.
function _validateAfterTransfer(address from, address to, uint256 tokenId) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_postValidateMint(_msgSender(), to, tokenId, msg.value);
} else if(toZeroAddress) {
_postValidateBurn(_msgSender(), from, tokenId, msg.value);
} else {
_postValidateTransfer(_msgSender(), from, to, tokenId, msg.value);
}
}
/// @dev Optional validation hook that fires before a mint
function _preValidateMint(address caller, address to, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a mint
function _postValidateMint(address caller, address to, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a burn
function _preValidateBurn(address caller, address from, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a burn
function _postValidateBurn(address caller, address from, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a transfer
function _preValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a transfer
function _postValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 value) internal virtual {}
/*************************************************************************/
/* Transfers With Amounts */
/*************************************************************************/
/// @dev Inheriting contracts should call this function in the _beforeTokenTransfer function to get more granular hooks.
function _validateBeforeTransfer(address from, address to, uint256 tokenId, uint256 amount) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_preValidateMint(_msgSender(), to, tokenId, amount, msg.value);
} else if(toZeroAddress) {
_preValidateBurn(_msgSender(), from, tokenId, amount, msg.value);
} else {
_preValidateTransfer(_msgSender(), from, to, tokenId, amount, msg.value);
}
}
/// @dev Inheriting contracts should call this function in the _afterTokenTransfer function to get more granular hooks.
function _validateAfterTransfer(address from, address to, uint256 tokenId, uint256 amount) internal virtual {
bool fromZeroAddress = from == address(0);
bool toZeroAddress = to == address(0);
if(fromZeroAddress && toZeroAddress) {
revert ShouldNotMintToBurnAddress();
} else if(fromZeroAddress) {
_postValidateMint(_msgSender(), to, tokenId, amount, msg.value);
} else if(toZeroAddress) {
_postValidateBurn(_msgSender(), from, tokenId, amount, msg.value);
} else {
_postValidateTransfer(_msgSender(), from, to, tokenId, amount, msg.value);
}
}
/// @dev Optional validation hook that fires before a mint
function _preValidateMint(address caller, address to, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a mint
function _postValidateMint(address caller, address to, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a burn
function _preValidateBurn(address caller, address from, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a burn
function _postValidateBurn(address caller, address from, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires before a transfer
function _preValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
/// @dev Optional validation hook that fires after a transfer
function _postValidateTransfer(address caller, address from, address to, uint256 tokenId, uint256 amount, uint256 value) internal virtual {}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (interfaces/IERC2981.sol)
pragma solidity ^0.8.0;
import "../utils/introspection/IERC165.sol";
/**
* @dev Interface for the NFT Royalty Standard.
*
* A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal
* support for royalty payments across all NFT marketplaces and ecosystem participants.
*
* _Available since v4.5._
*/
interface IERC2981 is IERC165 {
/**
* @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of
* exchange. The royalty amount is denominated and should be paid in that same unit of exchange.
*/
function royaltyInfo(uint256 tokenId, uint256 salePrice)
external
view
returns (address receiver, uint256 royaltyAmount);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/IERC721.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC721 compliant contract.
*/
interface IERC721 is IERC165 {
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
*/
event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
/**
* @dev Returns the number of tokens in ``owner``'s account.
*/
function balanceOf(address owner) external view returns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) external view returns (address owner);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes calldata data
) external;
/**
* @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
* are aware of the ERC721 protocol to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) external;
/**
* @dev Transfers `tokenId` token from `from` to `to`.
*
* WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
* or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
* understand this adds an external call which potentially creates a reentrancy vulnerability.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) external;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) external;
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool _approved) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) external view returns (address operator);
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}
*/
function isApprovedForAll(address owner, address operator) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)
pragma solidity ^0.8.0;
/**
* @title ERC721 token receiver interface
* @dev Interface for any contract that wants to support safeTransfers
* from ERC721 asset contracts.
*/
interface IERC721Receiver {
/**
* @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
* by `operator` from `from`, this function is called.
*
* It must return its Solidity selector to confirm the token transfer.
* If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
*
* The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
*/
function onERC721Received(
address operator,
address from,
uint256 tokenId,
bytes calldata data
) external returns (bytes4);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC721.sol";
/**
* @title ERC-721 Non-Fungible Token Standard, optional metadata extension
* @dev See https://eips.ethereum.org/EIPS/eip-721
*/
interface IERC721Metadata is IERC721 {
/**
* @dev Returns the token collection name.
*/
function name() external view returns (string memory);
/**
* @dev Returns the token collection symbol.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) external view returns (string memory);
}// 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);
}{
"evmVersion": "paris",
"optimizer": {
"enabled": true,
"mode": "3"
},
"outputSelection": {
"*": {
"*": [
"abi"
]
}
},
"detectMissingLibraries": false,
"forceEVMLA": false,
"enableEraVMExtensions": false,
"libraries": {}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"address","name":"_royaltyReceiver","type":"address"},{"internalType":"uint96","name":"_royaltyBasisPoints","type":"uint96"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AlreadyInitialized","type":"error"},{"inputs":[],"name":"AlreadyMinted","type":"error"},{"inputs":[],"name":"CreatorTokenBase__InvalidTransferValidatorContract","type":"error"},{"inputs":[],"name":"InvalidRoyaltyBasisPoints","type":"error"},{"inputs":[],"name":"MaxSupplyReached","type":"error"},{"inputs":[],"name":"ShouldNotMintToBurnAddress","type":"error"},{"inputs":[],"name":"ZeroAddress","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"autoApproved","type":"bool"}],"name":"AutomaticApprovalOfTransferValidatorSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"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":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldValidator","type":"address"},{"indexed":false,"internalType":"address","name":"newValidator","type":"address"}],"name":"TransferValidatorUpdated","type":"event"},{"inputs":[],"name":"DEFAULT_TRANSFER_VALIDATOR","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_SUPPLY","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"autoApproveTransfersFromValidator","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"recipients","type":"address[]"}],"name":"batchMintToAddresses","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"canMint","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getTransferValidationFunction","outputs":[{"internalType":"bytes4","name":"functionSignature","type":"bytes4"},{"internalType":"bool","name":"isViewFunction","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"getTransferValidator","outputs":[{"internalType":"address","name":"validator","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"hasMinted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"initializeSecurityPolicy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"isApproved","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"isSecurityPolicyInitialized","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":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"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":"to","type":"address"}],"name":"safeMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"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":"bool","name":"autoApprove","type":"bool"}],"name":"setAutomaticApprovalOfTransfersFromValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"baseURI","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"transferValidator_","type":"address"}],"name":"setTransferValidator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
9c4d535b000000000000000000000000000000000000000000000000000000000000000001000493837eac616e1979b948bed75b0be02016e880c59526ccd2a5a0ea319600000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000157a735491f7402dac1b83d1c96522e7eb77d06000000000000000000000000000000000000000000000000000000000000001f4000000000000000000000000000000000000000000000000000000000000000b50726f6f664f665375697400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000054e49303034000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0002000000000002000900000000000200010000000103550000006003100270000003e70030019d0000008004000039000000400040043f000003e7033001970000000100200190000000390000c13d000000040030008c000000580000413d000000000201043b000000e002200270000004130020009c000000f10000a13d000004140020009c000001280000a13d000004150020009c000001370000a13d000004160020009c0000026d0000a13d000004170020009c000004190000613d000004180020009c000002fe0000613d000004190020009c000000580000c13d0000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000601043b000003ef0060009c000000580000213d0000000801000039000000000201041a000003ef032001970000000005000411000000000053004b000005bc0000c13d000000000006004b000006030000c13d0000040e01000041000000800010043f0000002001000039000000840010043f0000002601000039000000a40010043f0000044301000041000000c40010043f0000044401000041000000e40010043f000004450100004100000f9a000104300000000002000416000000000002004b000000580000c13d0000001f02300039000003e8022001970000008002200039000000400020043f0000001f0530018f000003e9063001980000008002600039000000490000613d000000000701034f000000007807043c0000000004840436000000000024004b000000450000c13d000000000005004b000000560000613d000000000161034f0000000304500210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000120435000000800030008c0000005a0000813d000000000100001900000f9a00010430000000800200043d000003ea0020009c000000580000213d0000001f01200039000000000031004b000000580000813d00000080012000390000000001010433000003eb0010009c000004570000813d0000001f04100039000003ec044001970000003f04400039000003ed05400197000000400400043d0000000005540019000000000045004b00000000060000390000000106004039000003ea0050009c000004570000213d0000000100600190000004570000c13d0000008006300039000000400050043f0000000005140436000000a0022000390000000007210019000000000067004b000000580000213d000000000001004b000000820000613d000000000700001900000000087500190000000009270019000000000909043300000000009804350000002007700039000000000017004b0000007b0000413d000000000141001900000020011000390000000000010435000000a00700043d000003ea0070009c000000580000213d0000001f01700039000000000031004b0000000002000019000003ee02008041000003ee01100197000000000001004b0000000003000019000003ee03004041000003ee0010009c000000000302c019000000000003004b000000580000c13d00000080017000390000000003010433000003ea0030009c000004570000213d0000001f01300039000003ec011001970000003f01100039000003ed02100197000000400100043d0000000002210019000000000012004b00000000080000390000000108004039000003ea0020009c000004570000213d0000000100800190000004570000c13d000000400020043f0000000002310436000000a0077000390000000008730019000000000068004b000000580000213d000000000003004b000000b50000613d000000000600001900000000086200190000000009760019000000000909043300000000009804350000002006600039000000000036004b000000ae0000413d000000000313001900000020033000390000000000030435000000c00300043d000900000003001d000003ef0030009c000000580000213d000000e00300043d000800000003001d000003f00030009c000000580000213d000000400800043d000003f10080009c000004570000213d0000002009800039000000400090043f0000000000080435000000400300043d000003f10030009c000004570000213d0000002006300039000000400060043f00000000000304350000000007080433000003ea0070009c000004570000213d000000000a00041a000000010ca00190000000010ba002700000007f0bb0618f0000001f00b0008c000000000a000039000000010a0020390000000000ca004b0000032e0000c13d0000002000b0008c000000e90000413d0000001f0a700039000000050aa00270000003f20aa0009a000000200070008c000003f30a004041000000000000043f0000001f0bb00039000000050bb00270000003f20bb0009a0000000000ba004b000000e90000813d00000000000a041b000000010aa000390000000000ba004b000000e50000413d0000001f0070008c000008e40000a13d000000000000043f000003f40b700198000008f30000c13d000000200a000039000003f309000041000008ff0000013d0000042c0020009c0000010e0000213d000004380020009c000001610000213d0000043e0020009c000002860000213d000004410020009c000003110000613d000004420020009c000000580000c13d0000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000201043b0000045d00200198000000580000c13d00000001010000390000047b0020009c000005d30000213d0000047f0020009c000003f90000613d000004800020009c000003f90000613d000004810020009c000003f90000613d000005d90000013d0000042d0020009c0000019a0000213d000004330020009c000002a90000213d000004360020009c000003180000613d000004370020009c000000580000c13d0000000001000416000000000001004b000000580000c13d00000000010300190f980ae10000040f000900000001001d000800000002001d0000000002030019000700000003001d00000000010004110f980bfa0000040f0f980b890000040f0000000901000029000000080200002900000007030000290f980c810000040f000000000100001900000f990001042e000004210020009c000001c90000213d000004270020009c000002ca0000213d0000042a0020009c000004420000613d0000042b0020009c000000580000c13d0000000001000416000000000001004b000000580000c13d0000000901000039000000000101041a00000452001001980000034d0000013d0000041c0020009c000001e80000213d0000041f0020009c000003200000613d000004200020009c000000580000c13d0000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000201043b000000000002004b0000000001000039000000010100c039000000010020008c000000580000213d0000000803000039000000000303041a000003ef033001970000000004000411000000000043004b000005bc0000c13d000000000002004b0000000002000019000004540200c0410000000903000039000000000403041a0000045304400197000000000224019f000000000023041b000000800010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000458011001c70000800d0200003900000001030000390000045904000041000001e30000013d000004390020009c000002b40000213d0000043c0020009c000003340000613d0000043d0020009c000000580000c13d0000000002000416000000000002004b000000580000c13d000000440030008c000000580000413d0000000402100370000000000202043b000900000002001d000003ef0020009c000000580000213d0000002401100370000000000101043b000800000001001d000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000003ef01100198000004310000613d000000090010006b000006b60000c13d000000400100043d0000006402100039000004750300004100000000003204350000004402100039000004760300004100000000003204350000002402100039000000210300003900000000003204350000040e020000410000000000210435000000040210003900000020030000390000000000320435000003e70010009c000003e701008041000000400110021000000412011001c700000f9a000104300000042e0020009c000002c10000213d000004310020009c0000033d0000613d000004320020009c000000580000c13d0000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000101043b000900000001001d000003ef0010009c000000580000213d0000000801000039000000000101041a000003ef011001970000000002000411000000000021004b000005bc0000c13d0000000901000029000000000010043f0000000d01000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000000ff00100190000006ae0000c13d0000000c01000039000000000101041a000800000001001d000000960010008c000007810000413d000000400100043d0000046c02000041000006b00000013d000004220020009c000002f10000213d000004250020009c0000045d0000613d000004260020009c000000580000c13d0000000001000416000000000001004b000000580000c13d0000000801000039000000000201041a000003ef032001970000000005000411000000000053004b000005bc0000c13d000003ff02200197000000000021041b0000000001000414000003e70010009c000003e701008041000000c00110021000000400011001c70000800d020000390000000303000039000004010400004100000000060000190f980f8e0000040f0000000100200190000000580000613d000000000100001900000f990001042e0000041d0020009c000003520000613d0000041e0020009c000000580000c13d0000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000101043b000900000001001d000003ef0010009c000000580000213d0000000801000039000000000101041a000003ef011001970000000002000411000000000021004b000005bc0000c13d00000405010000410000000000100443000000090100002900000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000aa30000613d0000000904000029000000000004004b0000020f0000613d000000000101043b000000000001004b000002ee0000613d0000000901000039000000000101041a000003ef01100198000002180000c13d0000000801000039000000000101041a000004520010019800000000010000190000040201006041000000400200043d000000200320003900000000004304350000000000120435000003e70020009c000003e70200804100000040012002100000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f00000403011001c70000800d02000039000000010300003900000404040000410f980f8e0000040f0000000100200190000000580000613d0000000802000039000000000102041a000004530110019700000454011001c7000000000012041b0000000903000039000000000103041a000003ff0110019700000009011001af000000000013041b000000090000006b000001e60000613d00000405010000410000000000100443000000090100002900000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000aa30000613d000000000101043b000000000001004b000001e60000613d00000405010000410000000000100443000000090100002900000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000aa30000613d000000000101043b000000000001004b000000580000613d000000400300043d0000002401300039000002d102000039000000000021043500000407010000410000000000130435000000040130003900000000020004100000000000210435000003e70030009c000800000003001d000003e701000041000000000103401900000040011002100000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f00000408011001c70000000902000029000007450000013d0000041a0020009c000003710000613d0000041b0020009c000000580000c13d0000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000101043b000003ef0010009c000000580000213d000000000010043f0000000d01000039000000200010043f00000000010000190f980f7d0000040f000000000101041a000000ff0010019000000000010000390000000101006039000000800010043f000004510100004100000f990001042e0000043f0020009c0000039c0000613d000004400020009c000000580000c13d0000000001000416000000000001004b000000580000c13d0000000603000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000525013f00000001005001900000032e0000c13d000000800010043f000000000004004b000005cd0000613d000000000030043f000000000001004b000005cb0000613d000003fa0200004100000000040000190000000003040019000000000402041a000000a005300039000000000045043500000001022000390000002004300039000000000014004b000002a00000413d0000069a0000013d000004340020009c000003b50000613d000004350020009c000000580000c13d0000000001000416000000000001004b000000580000c13d0000009601000039000000800010043f000004510100004100000f990001042e0000043a0020009c000003f50000613d0000043b0020009c000000580000c13d0000000001000416000000000001004b000000580000c13d0000047001000041000000800010043f0000000101000039000000a00010043f000004710100004100000f990001042e0000042f0020009c000003fc0000613d000004300020009c000000580000c13d0000000001000416000000000001004b000000580000c13d0000000f010000390000034b0000013d000004280020009c000004740000613d000004290020009c000000580000c13d0000000001000416000000000001004b000000580000c13d0000000801000039000000000101041a000003ef011001970000000002000411000000000021004b000005bc0000c13d0000000f01000039000000000201041a000000ff00200190000005dc0000c13d00000001022001bf000000000021041b00000405010000410000000000100443000004620100004100000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000aa30000613d000000000101043b000000000001004b0000000802000039000006ea0000c13d000000400100043d0000046302000041000006b00000013d000004230020009c000004830000613d000004240020009c000000580000c13d0000000001000416000000000001004b000000580000c13d0000000801000039000000000101041a000003ef01100197000000800010043f000004510100004100000f990001042e0000000002000416000000000002004b000000580000c13d000000440030008c000000580000413d0000000402100370000000000302043b000003ef0030009c000000580000213d0000002401100370000000000201043b000003ef0020009c000000580000213d00000000010300190f980bc40000040f000000000001004b0000000001000039000000010100c0390000047c0000013d0000000001000416000000000001004b000000580000c13d0000040201000041000000800010043f000004510100004100000f990001042e0000000001000416000000000001004b000000580000c13d0000000c01000039000000000101041a000000800010043f000004510100004100000f990001042e0000000001000416000000000001004b000000580000c13d0000000703000039000000000203041a000000010420019000000001012002700000007f0110618f0000001f0010008c00000000050000390000000105002039000000000525013f0000000100500190000005c50000613d0000046d01000041000000000010043f0000002201000039000000040010043f0000046e0100004100000f9a000104300000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000101043b0f980b480000040f0000047c0000013d0000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000101043b000003ef0010009c000000580000213d000000000010043f0000000d01000039000000200010043f00000000010000190f980f7d0000040f000000000101041a000000ff001001900000000001000039000000010100c039000000800010043f000004510100004100000f990001042e0000000002000416000000000002004b000000580000c13d000000440030008c000000580000413d0000000402100370000000000202043b000900000002001d000003ef0020009c000000580000213d0000002401100370000000000101043b000000000001004b0000000002000039000000010200c039000800000002001d000000010010008c000000580000213d0000000002000411000000090020006c0000060f0000c13d0000040e01000041000000800010043f0000002001000039000000840010043f0000001901000039000000a40010043f0000045601000041000000c40010043f000004570100004100000f9a000104300000000002000416000000000002004b000000580000c13d000000840030008c000000580000413d0000000402100370000000000202043b000900000002001d000003ef0020009c000000580000213d0000002402100370000000000202043b000800000002001d000003ef0020009c000000580000213d0000006402100370000000000402043b000003ea0040009c000000580000213d0000002302400039000000000032004b000000580000813d0000000402400039000000000221034f000000000202043b0000004401100370000000000101043b000700000001001d00000024014000390f980b100000040f000600000001001d000000000100041100000007020000290f980bfa0000040f0f980b890000040f0000000901000029000000080200002900000007030000290f980c810000040f000000090100002900000008020000290000000703000029000004140000013d0000000002000416000000000002004b000000580000c13d000000440030008c000000580000413d0000000402100370000000000502043b000003ef0050009c000000580000213d0000002401100370000000000101043b000003f00010009c000000580000213d0000000802000039000000000202041a000003ef022001970000000003000411000000000032004b000005bc0000c13d000000000005004b0000074f0000c13d0000047a01000041000000800010043f000004610100004100000f9a000104300000000002000416000000000002004b000000580000c13d000000440030008c000000580000413d0000002402100370000000000202043b000900000002001d0000000401100370000000000101043b000000000010043f0000000b01000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000400300043d000004090030009c000004570000213d000000000101043b0000004002300039000000400020043f000000000101041a0000002004300039000000a0021002700000000000240435000003ef011001980000000000130435000003e40000c13d000000400300043d000004090030009c000004570000213d0000004001300039000000400010043f0000000a01000039000000000101041a0000002004300039000000a0021002700000000000240435000003ef011001970000000000130435000000090400002900000000034200a9000000000004004b000003eb0000613d00000000044300d9000000000042004b000007700000c13d000027100230011a000000400300043d000000200430003900000000002404350000000000130435000003e70030009c000003e70300804100000040013002100000046f011001c700000f990001042e0000000001000416000000000001004b000000580000c13d0f980b7e0000040f000000800010043f000004510100004100000f990001042e0000000001000416000000000001004b000000580000c13d00000000010300190f980ae10000040f000800000001001d000700000002001d000900000003001d000000400100043d000600000001001d0f980af30000040f00000006010000290000000000010435000000000100041100000009020000290f980bfa0000040f0f980b890000040f0000000801000029000000070200002900000009030000290f980c810000040f00000008010000290000000702000029000000090300002900000006040000290f980ead0000040f0f980dc20000040f000000000100001900000f990001042e0000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000101043b000900000001001d000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000003ef00100198000005e00000c13d000000400100043d0000004402100039000004770300004100000000003204350000002402100039000000180300003900000000003204350000040e020000410000000000210435000000040210003900000020030000390000000000320435000003e70010009c000003e70100804100000040011002100000040f011001c700000f9a000104300000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000402100370000000000502043b000003ea0050009c000000580000213d0000002302500039000000000032004b000000580000813d0000000404500039000000000241034f000000000202043b000003ea0020009c000004570000213d0000001f06200039000003ec06600197000004650060009c0000063f0000a13d0000046d01000041000000000010043f0000004101000039000000040010043f0000046e0100004100000f9a000104300000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000101043b000003ef0010009c000000580000213d000000000001004b000005fd0000c13d0000040e01000041000000800010043f0000002001000039000000840010043f0000002901000039000000a40010043f0000045e01000041000000c40010043f0000045f01000041000000e40010043f000004450100004100000f9a000104300000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000401100370000000000101043b0f980ba00000040f000000400200043d0000000000120435000003e70020009c000003e702008041000000400120021000000446011001c700000f990001042e0000000002000416000000000002004b000000580000c13d000000240030008c000000580000413d0000000402100370000000000202043b000003ea0020009c000000580000213d0000002304200039000000000034004b000000580000813d0000000404200039000000000141034f000000000101043b000300000001001d000003ea0010009c000000580000213d00000003010000290000000501100210000200240020003d0000000201100029000000000031004b000000580000213d0000000801000039000000000101041a000003ef011001970000000002000411000000000021004b000005bc0000c13d000000030000006b000001e60000613d000100800000003d000600000000001d000004ab0000013d00000006020000290000000102200039000600000002001d000000030020006c000001e60000813d0000000601000029000000050110021000000002011000290000000101100367000000000101043b000700000001001d000003ef0010009c000000580000213d0000000801000039000000000101041a000003ef011001970000000002000411000000000021004b000007760000c13d0000000701000029000003ef01100197000900000001001d000000000010043f0000000d01000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000000ff00100190000006ae0000c13d0000000c01000039000000000101041a000800000001001d000000950010008c000001c60000213d0000000901000029000000000010043f0000000d01000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000201041a000004820220019700000001022001bf000000000021041b0000000c02000039000000000102041a0000000101100039000000000012041b000000400200043d000003f10020009c000004570000213d0000002001200039000500000001001d000000400010043f000400000002001d0000000000020435000000090000006b000007a10000613d0000000801000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000003ef00100198000008c00000c13d0000000801000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000003ef00100198000008c00000c13d0000000901000029000000000010043f0000000301000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000201041a0000000102200039000000000021041b0000000801000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000201041a000003ff0220019700000007022001af000000000021041b0000000001000414000003e70010009c000003e701008041000000c00110021000000400011001c70000800d0200003900000004030000390000045a040000410000000005000019000000090600002900000008070000290f980f8e0000040f0000000100200190000000580000613d00000405010000410000000000100443000000070100002900000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000aa30000613d000000000101043b000000000001004b0000000506000029000004a60000613d000000400700043d0000006401700039000000800200003900000000002104350000004401700039000000080200002900000000002104350000045b010000410000000000170435000000040170003900000000020004110000000000210435000000240170003900000000000104350000000401000029000000000101043300000084027000390000000000120435000000a402700039000000000001004b000005720000613d000000000300001900000000042300190000000005630019000000000505043300000000005404350000002003300039000000000013004b0000056b0000413d0000001f03100039000004830330019700000000012100190000000000010435000000a401300039000003e70010009c000003e7010080410000006001100210000003e70070009c000003e70200004100000000020740190000004002200210000000000121019f0000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f0000000902000029000900000007001d0f980f8e0000040f000000090a0000290000006003100270000003e703300197000000200030008c00000020040000390000000004034019000000200640019000000000056a0019000005960000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b000005920000c13d0000001f07400190000005a30000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000008ef0000613d0000001f01400039000000600110018f0000000002a10019000000000012004b00000000010000390000000101004039000003ea0020009c000004570000213d0000000100100190000004570000c13d000000400020043f000000200030008c000000580000413d00000000010a04330000045d00100198000000580000c13d0000045b0010009c000004a60000613d0000040e0100004100000000001204350000000401200039000900000002001d000009620000013d0000040e01000041000000800010043f0000002001000039000000840010043f000000a40010043f0000046601000041000000c40010043f000004570100004100000f9a00010430000000800010043f000000000004004b000005cd0000613d000000000030043f000000000001004b000006900000c13d000000a0010000390000069b0000013d0000048202200197000000a00020043f000000000001004b000000c001000039000000a0010060390000069b0000013d0000047c0020009c000003f90000613d0000047d0020009c000003f90000613d0000047e0020009c000003f90000613d000000800000043f000004510100004100000f990001042e0000046001000041000000800010043f000004610100004100000f9a000104300000000e05000039000000000305041a000000010630019000000001013002700000007f0110618f0000001f0010008c00000000020000390000000102002039000000000232013f00000001002001900000032e0000c13d000000400400043d0000000002140436000000000006004b000007560000613d000000000050043f000000000001004b00000000030000190000075b0000613d000004470500004100000000030000190000000006320019000000000705041a000000000076043500000001055000390000002003300039000000000013004b000005f50000413d0000075b0000013d000000000010043f0000000301000039000000200010043f00000000010000190f980f7d0000040f0000031c0000013d000003ff02200197000000000262019f000000000021041b0000000001000414000003e70010009c000003e701008041000000c00110021000000400011001c70000800d0200003900000003030000390000040104000041000001e30000013d000000000020043f0000000501000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b0000000902000029000000000020043f000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000201041a00000482022001970000000803000029000000000232019f000000000021041b000000400100043d0000000000310435000003e70010009c000003e70100804100000040011002100000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f0000040a011001c70000800d020000390000000303000039000004550400004100000000050004110000000906000029000001e30000013d00000024055000390000003f06600039000003ec066001970000008006600039000000400060043f000000800020043f0000000005520019000000000035004b000000580000213d0000002003400039000000000331034f00000483042001980000001f0520018f000000a001400039000006540000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b000006500000c13d000000000005004b000006610000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a00120003900000000000104350000000801000039000000000101041a000003ef011001970000000002000411000000000021004b000007760000c13d000000800200043d000003ea0020009c000004570000213d0000000e01000039000000000401041a000000010040019000000001034002700000007f0330618f0000001f0030008c00000000050000390000000105002039000000000445013f00000001004001900000032e0000c13d000000200030008c000006880000413d000000000010043f0000001f042000390000000504400270000004670440009a000000200020008c00000447040040410000001f033000390000000503300270000004670330009a000000000034004b000006880000813d000000000004041b0000000104400039000000000034004b000006840000413d0000001f0020008c0000085a0000a13d000000000010043f000003f404200198000008c70000c13d000000a0050000390000044703000041000008d50000013d000003fd0200004100000000040000190000000003040019000000000402041a000000a005300039000000000045043500000001022000390000002004300039000000000014004b000006920000413d000000c001300039000000800210008a00000080010000390f980afe0000040f0000002001000039000000400200043d000900000002001d000000000212043600000080010000390f980acf0000040f00000009020000290000000001210049000003e70010009c000003e7010080410000006001100210000003e70020009c000003e7020080410000004002200210000000000121019f00000f990001042e000000400100043d00000469020000410000000000210435000003e70010009c000003e701008041000000400110021000000464011001c700000f9a000104300000000002000411000000000012004b000007a50000c13d0000000801000029000000000010043f0000000401000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000201041a000003ff0220019700000009022001af000000000021041b0000000801000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000003ef05100198000004310000613d0000000001000414000003e70010009c000003e701008041000000c00110021000000400011001c70000800d0200003900000004030000390000047404000041000000090600002900000008070000290f980f8e0000040f0000000100200190000000580000613d000001e60000013d0000000901000039000000000101041a000003ef01100198000006f20000c13d000000000102041a000004520010019800000000010000190000040201006041000000400200043d0000002003200039000004620400004100000000004304350000000000120435000003e70020009c000003e70200804100000040012002100000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f00000403011001c70000800d02000039000000010300003900000404040000410f980f8e0000040f0000000100200190000000580000613d0000000802000039000000000102041a000004530110019700000454011001c7000000000012041b0000000902000039000000000102041a000003ff0110019700000462011001c7000000000012041b00000405010000410000000000100443000004620100004100000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000aa30000613d000000000101043b000000000001004b000001e60000613d00000405010000410000000000100443000004620100004100000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000aa30000613d000000000101043b000000000001004b000000580000613d000000400300043d0000002401300039000002d102000039000000000021043500000407010000410000000000130435000000040130003900000000020004100000000000210435000003e70030009c000800000003001d000003e701000041000000000103401900000040011002100000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f00000408011001c700000462020000410f980f8e0000040f0000000100200190000001e60000613d0000000801000029000003ea0010009c000004570000213d0000000801000029000000400010043f000000000100001900000f990001042e000003f002100197000027110020008c000007db0000413d0000047901000041000000800010043f000004610100004100000f9a0001043000000482033001970000000000320435000000000001004b000000200300003900000000030060390000003f0130003900000483051001970000000001450019000000000051004b00000000050000390000000105004039000003ea0010009c000004570000213d0000000100500190000004570000c13d000000400010043f0000000005040433000000000005004b000007ed0000c13d000003f10010009c000004570000213d0000002002100039000000400020043f0000000000010435000000400300043d000008560000013d0000046d01000041000000000010043f0000001101000039000000040010043f0000046e0100004100000f9a00010430000000400100043d0000004402100039000004660300004100000000003204350000040e02000041000000000021043500000024021000390000002003000039000000000032043500000004021000390000043c0000013d0000000901000029000000000010043f0000000d01000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000201041a000004820220019700000001022001bf000000000021041b0000000c02000039000000000102041a0000000101100039000000000012041b000000400100043d000700000001001d000003f10010009c000004570000213d00000007020000290000002001200039000000400010043f0000000000020435000000090000006b000008640000c13d000000400100043d00000044021000390000046b03000041000007790000013d000000000010043f0000000501000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b0000000002000411000003ef02200197000700000002001d000000000020043f000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000000ff00100190000006b90000c13d0000000901000039000000000101041a0000045200100198000007d10000613d000003ef01100198000007cf0000c13d0000000801000039000000000101041a000004520010019800000000010000190000040201006041000000070010006b000006b90000613d000000400100043d00000064021000390000047203000041000000000032043500000044021000390000047303000041000000000032043500000024021000390000003d030000390000018f0000013d000000c003000039000000400030043f000000800050043f000000a00020043f000000a001100210000000000151019f0000000a03000039000000000013041b000000c00020043f0000000001000414000003e70010009c000003e701008041000000c00110021000000478011001c70000800d0200003900000002030000390000040b04000041000001600000013d0000000906000029000004480060009c000007f30000413d0000004005000039000004480660012a000007fb0000013d0000044a0060009c000004490660212a000000000500003900000020050020390000044b0060009c00000010055081bf0000044c066081970000044b0660812a0000044d0060009c0000000805508039000003ea066081970000044d0660812a000027100060008c0000000405508039000003e706608197000027100660811a000000640060008c00000002055080390000ffff0660818f000000640660811a000000090060008c00000001055020390000002006500039000003ec076001970000003f06700039000003ed066001970000000006160019000003ea0060009c000004570000213d000000400060043f00000001065000390000000006610436000000000007004b0000081d0000613d0000000007760019000000000800003100000001088003670000000009060019000000008a08043c0000000009a90436000000000079004b000008190000c13d000000000551001900000021055000390000000909000029000000090090008c0000000a7990011a0000000307700210000000010550008a00000000080504330000044e088001970000044f0770021f0000045007700197000000000787019f0000000000750435000008200000213d000000400500043d00000020075000390000000004040433000000000004004b000008380000613d00000000080000190000000009780019000000000a280019000000000a0a04330000000000a904350000002008800039000000000048004b000008310000413d000000000274001900000000000204350000000001010433000000000001004b000008450000613d000000000700001900000000082700190000000009670019000000000909043300000000009804350000002007700039000000000017004b0000083e0000413d00000000022100190000000000020435000000000114001900000000001504350000003f0110003900000483011001970000000002510019000000000012004b00000000010000390000000101004039000003ea0020009c000004570000213d0000000100100190000004570000c13d0000000003020019000000400020043f0000000001050019000900000003001d00000020020000390000000002230436000006a30000013d000000000002004b00000000030000190000085e0000613d000000a00300043d0000000304200210000004840440027f0000048404400167000000000443016f0000000103200210000008e00000013d0000000801000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000003ef00100198000008c00000c13d0000000801000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000101041a000003ef00100198000008c00000c13d0000000901000029000000000010043f0000000301000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000201041a0000000102200039000000000021041b0000000801000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f0000000100200190000000580000613d000000000101043b000000000201041a000003ff022001970000000906000029000000000262019f000000000021041b0000000001000414000003e70010009c000003e701008041000000c00110021000000400011001c70000800d0200003900000004030000390000045a04000041000000000500001900000008070000290f980f8e0000040f0000000100200190000000580000613d00000009010000290f980dd60000040f0000000901000029000000080200002900000007030000290f980de10000040f0f980dc20000040f000000000100001900000f990001042e000000400100043d00000044021000390000046a03000041000000000032043500000024021000390000001c03000039000004370000013d00000447030000410000002006000039000000010540008a0000000505500270000004680550009a000000000706001900000080066000390000000006060433000000000063041b00000020067000390000000103300039000000000053004b000008cc0000c13d000000a005700039000000000024004b000008de0000613d0000000304200210000000f80440018f000004840440027f00000484044001670000000005050433000000000445016f000000000043041b00000001030000390000000104200210000000000234019f000000000021041b000000000100001900000f990001042e000000000007004b0000000008000019000008e80000613d00000000080904330000000309700210000004840990027f0000048409900167000000000898016f0000000107700210000000000778019f0000090b0000013d000000000003004b000009330000c13d00000060020000390000095a0000013d000003f309000041000000200a000039000000010cb0008a000000050cc00270000003f50cc0009a000000000da80019000000000d0d04330000000000d9041b000000200aa0003900000001099000390000000000c9004b000008f80000c13d00000000007b004b000009090000613d000000030b700210000000f80bb0018f000004840bb0027f000004840bb001670000000008a8001900000000080804330000000008b8016f000000000089041b000000010770021000000001077001bf000000000070041b0000000008030433000003ea0080009c000004570000213d0000000107000039000000000a07041a0000000100a001900000000109a002700000007f0990618f0000001f0090008c000000000b000039000000010b002039000000000aab013f0000000100a001900000032e0000c13d000000200090008c0000092b0000413d000000000070043f0000001f0a800039000000050aa00270000003f60aa0009a000000200080008c000003f70a0040410000001f099000390000000509900270000003f60990009a00000000009a004b0000092b0000813d00000000000a041b000000010aa0003900000000009a004b000009270000413d0000001f0080008c000009760000a13d000000000070043f000003f40a800198000009810000c13d0000002009000039000003f7060000410000098d0000013d0000001f02300039000003e8022001970000003f022000390000045c04200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000003ea0040009c000004570000213d0000000100500190000004570000c13d000000400040043f0000001f0430018f0000000006320436000003e905300198000100000006001d00000000035600190000094d0000613d000000000601034f0000000107000029000000006806043c0000000007870436000000000037004b000009490000c13d000000000004004b0000095a0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b0000096d0000c13d000000400200043d000900000002001d0000040e01000041000000000012043500000004012000390f980db50000040f00000009020000290000000001210049000003e70010009c000003e7010080410000006001100210000003e70020009c000003e7020080410000004002200210000000000121019f00000f9a000104300000000102000029000003e70020009c000003e7020080410000004002200210000003e70010009c000003e7010080410000006001100210000000000121019f00000f9a00010430000000000008004b00000000030000190000097a0000613d00000000030604330000000306800210000004840660027f0000048406600167000000000363016f0000000106800210000000000363019f000009990000013d000003f7060000410000002009000039000000010ba0008a000000050bb00270000003f80bb0009a000000000c930019000000000c0c04330000000000c6041b000000200990003900000001066000390000000000b6004b000009860000c13d00000000008a004b000009970000613d000000030a800210000000f80aa0018f000004840aa0027f000004840aa00167000000000393001900000000030304330000000003a3016f000000000036041b000000010380021000000001033001bf000000000037041b0000000006040433000003ea0060009c000004570000213d0000000603000039000000000803041a000000010080019000000001078002700000007f0770618f0000001f0070008c00000000090000390000000109002039000000000889013f00000001008001900000032e0000c13d000000200070008c000009b90000413d000000000030043f0000001f086000390000000508800270000003f90880009a000000200060008c000003fa080040410000001f077000390000000507700270000003f90770009a000000000078004b000009b90000813d000000000008041b0000000108800039000000000078004b000009b50000413d0000001f0060008c000009c10000a13d000000000030043f000003f408600198000009cc0000c13d0000002007000039000003fa05000041000009d80000013d000000000006004b0000000004000019000009c50000613d00000000040504330000000305600210000004840550027f0000048405500167000000000454016f0000000105600210000000000454019f000009e40000013d000003fa050000410000002007000039000000010980008a0000000509900270000003fb0990009a000000000a740019000000000a0a04330000000000a5041b00000020077000390000000105500039000000000095004b000009d10000c13d000000000068004b000009e20000613d0000000308600210000000f80880018f000004840880027f000004840880016700000000047400190000000004040433000000000484016f000000000045041b000000010460021000000001044001bf000000000043041b0000000004010433000003ea0040009c000004570000213d0000000703000039000000000603041a000000010060019000000001056002700000007f0550618f0000001f0050008c00000000070000390000000107002039000000000667013f00000001006001900000032e0000c13d000000200050008c00000a040000413d000000000030043f0000001f064000390000000506600270000003fc0660009a000000200040008c000003fd060040410000001f055000390000000505500270000003fc0550009a000000000056004b00000a040000813d000000000006041b0000000106600039000000000056004b00000a000000413d0000001f0040008c00000a0c0000a13d000000000030043f000003f40640019800000a170000c13d0000002005000039000003fd0200004100000a230000013d000000000004004b000000000100001900000a100000613d00000000010204330000000302400210000004840220027f0000048402200167000000000121016f0000000102400210000000000121019f00000a2f0000013d000003fd020000410000002005000039000000010760008a0000000507700270000003fe0770009a00000000085100190000000008080433000000000082041b00000020055000390000000102200039000000000072004b00000a1c0000c13d000000000046004b00000a2d0000613d0000000306400210000000f80660018f000004840660027f000004840660016700000000015100190000000001010433000000000161016f000000000012041b000000010140021000000001011001bf000000000013041b0000000801000039000000000201041a000003ff032001970000000006000411000000000336019f000000000031041b000000400100043d000700000001001d0000000001000414000003ef05200197000003e70010009c000003e701008041000000c00110021000000400011001c70000800d02000039000000030300003900000401040000410f980f8e0000040f0000000100200190000000580000613d00000007020000290000002001200039000004020300004100000000003104350000000000020435000003e70020009c000003e70200804100000040012002100000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f00000403011001c70000800d02000039000000010300003900000404040000410f980f8e0000040f0000000100200190000000580000613d00000405010000410000000000100443000004020100004100000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000aa30000613d000000000101043b000000000001004b00000a750000c13d000000400100043d0000000802000029000027100020008c00000aa40000a13d00000064021000390000041003000041000000000032043500000044021000390000041103000041000000000032043500000024021000390000002a030000390000018f0000013d00000405010000410000000000100443000004020100004100000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000aa30000613d000000000101043b000000000001004b000000580000613d000000400300043d0000002401300039000002d102000039000000000021043500000407010000410000000000130435000000040130003900000000020004100000000000210435000003e70030009c000700000003001d000003e701000041000000000103401900000040011002100000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f00000408011001c700000402020000410f980f8e0000040f000000010020019000000a680000613d0000000701000029000003ea0010009c000004570000213d0000000701000029000000400010043f00000a680000013d000000000001042f000000090000006b00000aac0000c13d00000044021000390000040d03000041000000000032043500000024021000390000001903000039000004370000013d000004090010009c000004570000213d0000004002100039000000400020043f00000020021000390000000803000029000000000032043500000009050000290000000000510435000000a001300210000000000115019f0000000a02000039000000000012041b000000400100043d0000000000310435000003e70010009c000003e70100804100000040011002100000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f0000040a011001c70000800d0200003900000002030000390000040b040000410f980f8e0000040f0000000100200190000000580000613d0000002001000039000001000010044300000120000004430000040c0100004100000f990001042e00000000430104340000000001320436000000000003004b00000adb0000613d000000000200001900000000051200190000000006240019000000000606043300000000006504350000002002200039000000000032004b00000ad40000413d000000000213001900000000000204350000001f0230003900000483022001970000000001210019000000000001042d000004850010009c00000af10000213d000000630010008c00000af10000a13d00000001030003670000000401300370000000000101043b000003ef0010009c00000af10000213d0000002402300370000000000202043b000003ef0020009c00000af10000213d0000004403300370000000000303043b000000000001042d000000000100001900000f9a00010430000003f40010009c00000af80000813d0000002001100039000000400010043f000000000001042d0000046d01000041000000000010043f0000004101000039000000040010043f0000046e0100004100000f9a000104300000001f0220003900000483022001970000000001120019000000000021004b00000000020000390000000102004039000003ea0010009c00000b0a0000213d000000010020019000000b0a0000c13d000000400010043f000000000001042d0000046d01000041000000000010043f0000004101000039000000040010043f0000046e0100004100000f9a00010430000003eb0020009c00000b400000813d00000000040100190000001f01200039000003ec011001970000003f01100039000003ed05100197000000400100043d0000000005510019000000000015004b00000000060000390000000106004039000003ea0050009c00000b400000213d000000010060019000000b400000c13d000000400050043f00000000052104360000000006420019000000000036004b00000b460000213d00000483062001980000001f0720018f0000000104400367000000000365001900000b300000613d000000000804034f0000000009050019000000008a08043c0000000009a90436000000000039004b00000b2c0000c13d000000000007004b00000b3d0000613d000000000464034f0000000306700210000000000703043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000043043500000000022500190000000000020435000000000001042d0000046d01000041000000000010043f0000004101000039000000040010043f0000046e0100004100000f9a00010430000000000100001900000f9a000104300001000000000002000100000001001d000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000b6b0000613d000000000101043b000000000101041a000003ef0010019800000b6d0000613d0000000101000029000000000010043f0000000401000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000b6b0000613d000000000101043b000000000101041a000003ef01100197000000000001042d000000000100001900000f9a00010430000000400100043d0000004402100039000004770300004100000000003204350000002402100039000000180300003900000000003204350000040e020000410000000000210435000000040210003900000020030000390000000000320435000003e70010009c000003e70100804100000040011002100000040f011001c700000f9a000104300000000901000039000000000101041a000003ef0110019800000b830000613d000000000001042d0000000801000039000000000101041a000004520010019800000000010000190000040201006041000000000001042d000000000001004b00000b8c0000613d000000000001042d000000400100043d00000064021000390000048603000041000000000032043500000044021000390000048703000041000000000032043500000024021000390000002d0300003900000000003204350000040e020000410000000000210435000000040210003900000020030000390000000000320435000003e70010009c000003e701008041000000400110021000000412011001c700000f9a00010430000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000bb10000613d000000000101043b000000000101041a000003ef0110019800000bb30000613d000000000001042d000000000100001900000f9a00010430000000400100043d0000004402100039000004770300004100000000003204350000002402100039000000180300003900000000003204350000040e020000410000000000210435000000040210003900000020030000390000000000320435000003e70010009c000003e70100804100000040011002100000040f011001c700000f9a000104300001000000000002000100000002001d000003ef01100197000000000010043f0000000501000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000bf80000613d000000000101043b0000000102000029000003ef02200197000100000002001d000000000020043f000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000bf80000613d000000000101043b000000000101041a000000ff0110019000000be70000613d000000000001042d0000000901000039000000000101041a000004520010019800000bf60000613d000003ef0110019800000bf20000c13d0000000801000039000000000101041a000004520010019800000000010000190000040201006041000000010010006b00000000010000390000000101006039000000000001042d0000000001000019000000000001042d000000000100001900000f9a000104300005000000000002000300000001001d000200000002001d000000000020043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000c6e0000613d000000000101043b000000000101041a000003ef0110019800000c700000613d0000000302000029000303ef0020019b000000030010006b00000c130000c13d0000000101000039000000000001042d000000000010043f0000000501000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000c6e0000613d000000000101043b0000000302000029000000000020043f000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000c6e0000613d000000000101043b000000000101041a000000ff0110019000000c310000613d000000000001042d0000000003000415000000050330008a00000005033002100000000901000039000000000101041a000004520010019800000c450000613d000003ef0110019800000c3f0000c13d0000000801000039000000000101041a0000045200100198000000000100001900000402010060410000000003000415000000040330008a0000000503300210000000030010006b000000010100003900000c300000613d000100000003001d0000000201000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000c6e0000613d000000000101043b000000000101041a000003ef0010019800000c700000613d0000000201000029000000000010043f0000000401000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000c6e0000613d000000000101043b000000000101041a000003ef01100197000000030010006c0000000001000039000000010100603900000001020000290000000502200270000000000201001f000000000001042d000000000100001900000f9a00010430000000400100043d0000004402100039000004770300004100000000003204350000002402100039000000180300003900000000003204350000040e020000410000000000210435000000040210003900000020030000390000000000320435000003e70010009c000003e70100804100000040011002100000040f011001c700000f9a00010430000a000000000002000700000002001d000800000001001d000400000003001d000000000030043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000d5d0000613d000000000101043b000000000101041a000003ef0210019800000d860000613d0000000801000029000003ef01100197000000000012004b00000d970000c13d0000000701000029000203ef0010019c00000da10000613d000300000002001d00000000010004150000000a0110008a00000005011002100000000003000411000103ef0030019b000a00010000003d000000090400003900000cb30000013d0000000801000039000000000101041a000004520010019800000cf30000613d0000000001000415000000000115004900000000010000020000000001000415000000090110008a000000050110021000000005022002700000000000020032000900010000003d00000cf70000c13d00000000020100190000000005000415000000000104041a000003ef0610019800000ca50000613d000000000063004b00000ca90000613d000600000005001d000700000002001d00000405010000410000000000100443000800000006001d00000004006004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000d5f0000613d000000000101043b000000000001004b00000d5d0000613d000000400300043d00000064013000390000000402000029000000000021043500000044013000390000000202000029000000000021043500000024013000390000000302000029000000000021043500000470010000410000000000130435000000040130003900000001020000290000000000210435000003e70030009c000500000003001d000003e701000041000000000103401900000040011002100000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f00000412011001c700000008020000290f980f930000040f000000010020019000000d600000613d0000000501000029000003ea0010009c000000000300041100000009040000390000000702000029000000060500002900000d800000213d000000400010043f00000ca90000013d0000040206000041000000000063004b00000ca90000613d00000cba0000013d0000000401000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000d5d0000613d000000000101043b000000000101041a000003ef01100198000000030200002900000d860000613d000000000021004b00000d970000c13d0000000401000029000000000010043f0000000401000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000d5d0000613d000000000101043b000000000201041a000003ff02200197000000000021041b0000000301000029000000000010043f0000000301000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000d5d0000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000201000029000000000010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000d5d0000613d000000000101043b000000000201041a0000000102200039000000000021041b0000000401000029000000000010043f0000000201000039000000200010043f0000000001000414000003e70010009c000003e701008041000000c00110021000000403011001c700008010020000390f980f930000040f000000010020019000000d5d0000613d000000000101043b000000000201041a000003ff022001970000000206000029000000000262019f000000000021041b0000000001000414000003e70010009c000003e701008041000000c00110021000000400011001c70000800d0200003900000004030000390000045a04000041000000030500002900000004070000290f980f8e0000040f000000010020019000000d5d0000613d000000000001042d000000000100001900000f9a00010430000000000001042f00000060061002700000001f0460018f000003e905600198000000400200043d000000000352001900000d6c0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b00000d680000c13d000003e706600197000000000004004b00000d7a0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000006001600210000003e70020009c000003e7020080410000004002200210000000000112019f00000f9a000104300000046d01000041000000000010043f0000004101000039000000040010043f0000046e0100004100000f9a00010430000000400100043d0000004402100039000004770300004100000000003204350000002402100039000000180300003900000000003204350000040e020000410000000000210435000000040210003900000020030000390000000000320435000003e70010009c000003e70100804100000040011002100000040f011001c700000f9a00010430000000400100043d0000006402100039000004880300004100000000003204350000004402100039000004890300004100000000003204350000002402100039000000250300003900000daa0000013d000000400100043d00000064021000390000048a03000041000000000032043500000044021000390000048b0300004100000000003204350000002402100039000000240300003900000000003204350000040e020000410000000000210435000000040210003900000020030000390000000000320435000003e70010009c000003e701008041000000400110021000000412011001c700000f9a0001043000000060021000390000048c03000041000000000032043500000040021000390000048d030000410000000000320435000000200210003900000032030000390000000000320435000000200200003900000000002104350000008001100039000000000001042d0001000000000002000000000001004b00000dc60000613d000000000001042d000000400200043d000100000002001d0000040e01000041000000000012043500000004012000390f980db50000040f00000001020000290000000001210049000003e70010009c000003e7010080410000006001100210000003e70020009c000003e7020080410000004002200210000000000121019f00000f9a00010430000003ef0010019800000dd90000613d000000000001042d000000400100043d0000048e020000410000000000210435000003e70010009c000003e701008041000000400110021000000464011001c700000f9a000104300004000000000002000300000003001d000200000002001d00000405020000410000000000200443000400000001001d00000004001004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000e5f0000613d000000000101043b000000000001004b00000e5b0000613d000000400700043d00000064017000390000008002000039000100000002001d00000000002104350000004401700039000000020200002900000000002104350000045b010000410000000000170435000000040170003900000000020004110000000000210435000000240170003900000000000104350000008402700039000000030100002900000000310104340000000000120435000000a402700039000000000001004b00000e120000613d000000000400001900000000052400190000000006430019000000000606043300000000006504350000002004400039000000000014004b00000e0b0000413d0000001f03100039000004830330019700000000012100190000000000010435000000a401300039000003e70010009c000003e7010080410000006001100210000003e70070009c000003e70200004100000000020740190000004002200210000000000121019f0000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f0000000402000029000003ef02200197000400000007001d0f980f8e0000040f000000040b0000290000006003100270000003e703300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900000e380000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00000e340000c13d000000000006004b00000e450000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000010020019000000e600000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000003ea0010009c00000e9e0000213d000000010020019000000e9e0000c13d000000400010043f0000001f0030008c00000e5d0000a13d00000000010b04330000045d0010019800000e5d0000c13d0000045b0010009c00000000010000390000000101006039000000000001042d0000000101000039000000000001042d000000000100001900000f9a00010430000000000001042f000000000003004b00000e640000c13d000000600200003900000e8b0000013d0000001f02300039000003e8022001970000003f022000390000045c04200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000003ea0040009c00000e9e0000213d000000010050019000000e9e0000c13d000000400040043f0000001f0430018f0000000006320436000003e905300198000100000006001d000000000356001900000e7e0000613d000000000601034f0000000107000029000000006806043c0000000007870436000000000037004b00000e7a0000c13d000000000004004b00000e8b0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b00000ea40000c13d000000400200043d000400000002001d0000040e01000041000000000012043500000004012000390f980db50000040f00000004020000290000000001210049000003e70010009c000003e7010080410000006001100210000003e70020009c000003e7020080410000004002200210000000000121019f00000f9a000104300000046d01000041000000000010043f0000004101000039000000040010043f0000046e0100004100000f9a000104300000000102000029000003e70020009c000003e7020080410000004002200210000003e70010009c000003e7010080410000006001100210000000000121019f00000f9a000104300005000000000002000400000004001d000300000003001d000200000001001d00000405010000410000000000100443000500000002001d00000004002004430000000001000414000003e70010009c000003e701008041000000c00110021000000406011001c700008002020000390f980f930000040f000000010020019000000f2e0000613d000000000101043b000000000001004b00000f2a0000613d000000400700043d00000064017000390000008002000039000100000002001d00000000002104350000004401700039000000030200002900000000002104350000000201000029000003ef01100197000000240270003900000000001204350000045b0100004100000000001704350000000401700039000000000200041100000000002104350000008402700039000000040100002900000000310104340000000000120435000000a402700039000000000001004b00000ee10000613d000000000400001900000000052400190000000006430019000000000606043300000000006504350000002004400039000000000014004b00000eda0000413d0000001f03100039000004830330019700000000012100190000000000010435000000a401300039000003e70010009c000003e7010080410000006001100210000003e70070009c000003e70200004100000000020740190000004002200210000000000121019f0000000002000414000003e70020009c000003e702008041000000c002200210000000000112019f0000000502000029000003ef02200197000500000007001d0f980f8e0000040f000000050b0000290000006003100270000003e703300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900000f070000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00000f030000c13d000000000006004b00000f140000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000010020019000000f2f0000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000003ea0010009c00000f6d0000213d000000010020019000000f6d0000c13d000000400010043f0000001f0030008c00000f2c0000a13d00000000010b04330000045d0010019800000f2c0000c13d0000045b0010009c00000000010000390000000101006039000000000001042d0000000101000039000000000001042d000000000100001900000f9a00010430000000000001042f000000000003004b00000f330000c13d000000600200003900000f5a0000013d0000001f02300039000003e8022001970000003f022000390000045c04200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000003ea0040009c00000f6d0000213d000000010050019000000f6d0000c13d000000400040043f0000001f0430018f0000000006320436000003e905300198000100000006001d000000000356001900000f4d0000613d000000000601034f0000000107000029000000006806043c0000000007870436000000000037004b00000f490000c13d000000000004004b00000f5a0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b00000f730000c13d000000400200043d000500000002001d0000040e01000041000000000012043500000004012000390f980db50000040f00000005020000290000000001210049000003e70010009c000003e7010080410000006001100210000003e70020009c000003e7020080410000004002200210000000000121019f00000f9a000104300000046d01000041000000000010043f0000004101000039000000040010043f0000046e0100004100000f9a000104300000000102000029000003e70020009c000003e7020080410000004002200210000003e70010009c000003e7010080410000006001100210000000000121019f00000f9a00010430000000000001042f0000000002000414000003e70020009c000003e702008041000000c002200210000003e70010009c000003e7010080410000004001100210000000000121019f00000403011001c700008010020000390f980f930000040f000000010020019000000f8c0000613d000000000101043b000000000001042d000000000100001900000f9a0001043000000f91002104210000000102000039000000000001042d0000000002000019000000000001042d00000f96002104230000000102000039000000000001042d0000000002000019000000000001042d00000f980000043200000f990001042e00000f9a00010430000000000000000000000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000000000000000000000000000ffffffffffffffff0000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001ffffffffffffffe0000000000000000000000000000000000000000000000003ffffffffffffffe08000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000ffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffdfd6f21326ab749d5729fcba5677c79037b459436ab7bff709c9d06ce9f10c1a9d290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e563000000000000000000000000000000000000000000000000ffffffffffffffe0d6f21326ab749d5729fcba5677c79037b459436ab7bff709c9d06ce9f10c1a9c4ef1d2ad89edf8c4d91132028e8195cdf30bb4b5053d4f8cd260341d4805f30ab10e2d527612073b26eecdfd717e6a320cf44b4afac2b0732d9fcbe2b7fa0cf64ef1d2ad89edf8c4d91132028e8195cdf30bb4b5053d4f8cd260341d4805f30909addddcec1d7ba6ad726df49aeea3e93fb0c1037d551236841a60c0c883f2c1f652222313e28459528d920b65115c16c04f3efc82aaedc97be59f3f377c0d3f09addddcec1d7ba6ad726df49aeea3e93fb0c1037d551236841a60c0c883f2c0599336d74a1247d50642b66dd6abeaa5484f6bd96b415b31bb99e26578c93978a66cc928b5edb82af9bd49922954155ab7b0942694bea4ce44661d9a8736c688599336d74a1247d50642b66dd6abeaa5484f6bd96b415b31bb99e26578c93977ffffffffffffffffffffffff000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0000000000000000000000000721c008fdff27bf06e7e123956e2fe03b63342e30200000000000000000000000000000000000040000000000000000000000000cc5dc080ff977b3c3a211fa63ab74f90f658f5ba9d3236e92c8f59570f442aac1806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000fb2de5d7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffbf02000000000000000000000000000000000000200000000000000000000000008a8bae378cb731c5c40b632330c6836c2f916f48edb967699c86736f9a6a76ef0000000200000000000000000000000000000040000001000000000000000000455243323938313a20696e76616c69642072656365697665720000000000000008c379a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000640000000000000000000000002073616c65507269636500000000000000000000000000000000000000000000455243323938313a20726f79616c7479206665652077696c6c2065786365656400000000000000000000000000000000000000840000000000000000000000000000000000000000000000000000000000000000000000000000000055f804b20000000000000000000000000000000000000000000000000000000095d89b4000000000000000000000000000000000000000000000000000000000b88d4fdd00000000000000000000000000000000000000000000000000000000c87b56dc00000000000000000000000000000000000000000000000000000000c87b56dd00000000000000000000000000000000000000000000000000000000e985e9c500000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000b88d4fde00000000000000000000000000000000000000000000000000000000c2ba474400000000000000000000000000000000000000000000000000000000a22cb46400000000000000000000000000000000000000000000000000000000a22cb46500000000000000000000000000000000000000000000000000000000a9fc664e0000000000000000000000000000000000000000000000000000000095d89b41000000000000000000000000000000000000000000000000000000009e05d2400000000000000000000000000000000000000000000000000000000070a082300000000000000000000000000000000000000000000000000000000073d1bf8d0000000000000000000000000000000000000000000000000000000073d1bf8e000000000000000000000000000000000000000000000000000000008da5cb5b0000000000000000000000000000000000000000000000000000000070a0823100000000000000000000000000000000000000000000000000000000715018a6000000000000000000000000000000000000000000000000000000006352211d000000000000000000000000000000000000000000000000000000006352211e000000000000000000000000000000000000000000000000000000006496c95c0000000000000000000000000000000000000000000000000000000055f804b3000000000000000000000000000000000000000000000000000000006221d13c0000000000000000000000000000000000000000000000000000000018160ddc0000000000000000000000000000000000000000000000000000000038e21ccd0000000000000000000000000000000000000000000000000000000042842e0d0000000000000000000000000000000000000000000000000000000042842e0e000000000000000000000000000000000000000000000000000000005329ef3c0000000000000000000000000000000000000000000000000000000038e21cce0000000000000000000000000000000000000000000000000000000040d097c3000000000000000000000000000000000000000000000000000000002a552059000000000000000000000000000000000000000000000000000000002a55205a0000000000000000000000000000000000000000000000000000000032cb6b0c0000000000000000000000000000000000000000000000000000000018160ddd0000000000000000000000000000000000000000000000000000000023b872dd00000000000000000000000000000000000000000000000000000000081812fb00000000000000000000000000000000000000000000000000000000098144d300000000000000000000000000000000000000000000000000000000098144d4000000000000000000000000000000000000000000000000000000000d705df600000000000000000000000000000000000000000000000000000000081812fc00000000000000000000000000000000000000000000000000000000095ea7b30000000000000000000000000000000000000000000000000000000004634d8c0000000000000000000000000000000000000000000000000000000004634d8d0000000000000000000000000000000000000000000000000000000006fdde0300000000000000000000000000000000000000000000000000000000014635460000000000000000000000000000000000000000000000000000000001ffc9a74f776e61626c653a206e6577206f776e657220697320746865207a65726f2061646472657373000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000840000008000000000000000000000000000000000000000000000000000000020000000000000000000000000bb7b4a454dc3493923482f07822329ed19e8244eff582cc204f8554c3620c3fd0000000000184f03e93ff9f4daa797ed6e38ed64bf6a1f01000000000000000000000000000000000000000000000000000004ee2d6d415b85acef810000000000000000000000000000000000000000000004ee2d6d415b85acef80ffffffff000000000000000000000000000000000000000000000000002386f26fc1000000000000000000000000000000000000ffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000005f5e10000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff30313233343536373839616263646566000000000000000000000000000000007f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000008000000000000000000000000000000000000000ff0000000000000000000000000000000000000000ffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffff000000000000000000000001000000000000000000000000000000000000000017307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c314552433732313a20617070726f766520746f2063616c6c657200000000000000000000000000000000000000000000000000006400000080000000000000000002000000000000000000000000000000000000200000008000000000000000006787c7f9a80aa0f5ceddab2c54f1f5169c0b88e75dd5e19d5e858a64144c7dbcddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef150b7a020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003ffffffe000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff4552433732313a2061646472657373207a65726f206973206e6f7420612076616c6964206f776e657200000000000000000000000000000000000000000000000dc149f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000008000000000000000000000000000000000000000000000721c310194ccfc01e523fc93c9cccfa2a0ac32483afb000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff404f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65724484b5bab23cb6c6dcb7d0f87ddcd612e617dbb100a7d33dfb07aab3c9df3c034484b5bab23cb6c6dcb7d0f87ddcd612e617dbb100a7d33dfb07aab3c9df3c02ddefae28000000000000000000000000000000000000000000000000000000004552433732313a20746f6b656e20616c7265616479206d696e746564000000004552433732313a206d696e7420746f20746865207a65726f2061646472657373d05cb609000000000000000000000000000000000000000000000000000000004e487b710000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000000000000000000000000000000000000000000040000000000000000000000000caee23ea0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000008000000000000000006b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000004552433732313a20617070726f76652063616c6c6572206973206e6f7420746f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92572000000000000000000000000000000000000000000000000000000000000004552433732313a20617070726f76616c20746f2063757272656e74206f776e654552433732313a20696e76616c696420746f6b656e20494400000000000000000200000000000000000000000000000000000020000000c00000000000000000e3f3b65500000000000000000000000000000000000000000000000000000000d92e233d0000000000000000000000000000000000000000000000000000000080ac58ccffffffffffffffffffffffffffffffffffffffffffffffffffffffff80ac58cd00000000000000000000000000000000000000000000000000000000ad0d7f6c00000000000000000000000000000000000000000000000000000000a07d229a0000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000002a55205a000000000000000000000000000000000000000000000000000000005b5e139f00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff72206f7220617070726f766564000000000000000000000000000000000000004552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e656f776e65720000000000000000000000000000000000000000000000000000004552433732313a207472616e736665722066726f6d20696e636f72726563742072657373000000000000000000000000000000000000000000000000000000004552433732313a207472616e7366657220746f20746865207a65726f2061646463656976657220696d706c656d656e74657200000000000000000000000000004552433732313a207472616e7366657220746f206e6f6e2045524337323152655cbd9441000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a264697066735822122040d794248954f1037d2832ec190e3147cf7ebc307a6218f71fb55880a0b4489c64736f6c6378247a6b736f6c633a312e352e31353b736f6c633a302e382e32343b6c6c766d3a312e302e320055
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000157a735491f7402dac1b83d1c96522e7eb77d06000000000000000000000000000000000000000000000000000000000000001f4000000000000000000000000000000000000000000000000000000000000000b50726f6f664f665375697400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000054e49303034000000000000000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : name (string): ProofOfSuit
Arg [1] : symbol (string): NI004
Arg [2] : _royaltyReceiver (address): 0x157A735491f7402dac1B83D1C96522e7eb77d060
Arg [3] : _royaltyBasisPoints (uint96): 500
-----Encoded View---------------
8 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000080
Arg [1] : 00000000000000000000000000000000000000000000000000000000000000c0
Arg [2] : 000000000000000000000000157a735491f7402dac1b83d1c96522e7eb77d060
Arg [3] : 00000000000000000000000000000000000000000000000000000000000001f4
Arg [4] : 000000000000000000000000000000000000000000000000000000000000000b
Arg [5] : 50726f6f664f6653756974000000000000000000000000000000000000000000
Arg [6] : 0000000000000000000000000000000000000000000000000000000000000005
Arg [7] : 4e49303034000000000000000000000000000000000000000000000000000000
Loading...
Loading
Loading...
Loading
Loading...
Loading
Net Worth in USD
$0.00
Net Worth in ETH
0
Multichain Portfolio | 35 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.