ETH Price: $3,970.24 (+2.10%)

Contract

0xB109aE8CD22eeE9D8119058Ca3C9F452df6367f3
 

Overview

ETH Balance

0.005916837097250845 ETH

Eth Value

$23.49 (@ $3,970.24/ETH)
Transaction Hash
Method
Block
From
To
Send To Other Ch...206536882024-09-01 5:39:47105 days ago1725169187IN
0xB109aE8C...2df6367f3
0.0005668 ETH0.00013120.62044593
Send To Other Ch...206068522024-08-25 16:39:23112 days ago1724603963IN
0xB109aE8C...2df6367f3
0.00058805 ETH0.000231931.11154913
Send To Other Ch...206067962024-08-25 16:27:59112 days ago1724603279IN
0xB109aE8C...2df6367f3
0.00058805 ETH0.000206920.97856889
Send To Other Ch...206066192024-08-25 15:52:23112 days ago1724601143IN
0xB109aE8C...2df6367f3
0.0005859 ETH0.000241451.14181679
Send To Other Ch...206063362024-08-25 14:55:23112 days ago1724597723IN
0xB109aE8C...2df6367f3
0.0005859 ETH0.000227781.09163191
Send To Other Ch...206062102024-08-25 14:29:59112 days ago1724596199IN
0xB109aE8C...2df6367f3
0.0005859 ETH0.000306511.46892549
Send To Other Ch...206060622024-08-25 14:00:11112 days ago1724594411IN
0xB109aE8C...2df6367f3
0.0005859 ETH0.000340571.63216203
Send To Other Ch...205625352024-08-19 12:00:11118 days ago1724068811IN
0xB109aE8C...2df6367f3
0.00053531 ETH0.000456232.3
Transfer205622742024-08-19 11:07:35118 days ago1724065655IN
0xB109aE8C...2df6367f3
0.00591512 ETH0.000080263.8121039
Send To Other Ch...205143352024-08-12 18:30:35125 days ago1723487435IN
0xB109aE8C...2df6367f3
0.00051139 ETH0.001406226.99007845
Send To Other Ch...205143292024-08-12 18:29:23125 days ago1723487363IN
0xB109aE8C...2df6367f3
0.00051139 ETH0.001342336.67292666
Send To Other Ch...198200432024-05-07 18:41:23222 days ago1715107283IN
0xB109aE8C...2df6367f3
0.00066642 ETH0.001793989.04344943
Send To Other Ch...198200402024-05-07 18:40:47222 days ago1715107247IN
0xB109aE8C...2df6367f3
0.00066642 ETH0.001903399.12163506
Send To Other Ch...197856502024-05-02 23:16:11227 days ago1714691771IN
0xB109aE8C...2df6367f3
0.0006175 ETH0.000919074.63331649
Send To Other Ch...197856452024-05-02 23:15:11227 days ago1714691711IN
0xB109aE8C...2df6367f3
0.0006175 ETH0.000951284.55910642
Send To Other Ch...197856402024-05-02 23:14:11227 days ago1714691651IN
0xB109aE8C...2df6367f3
0.0006175 ETH0.001019654.88678131
Send To Other Ch...196231492024-04-10 5:29:11249 days ago1712726951IN
0xB109aE8C...2df6367f3
0.000701 ETH0.00261313.17289791
Send To Other Ch...196231282024-04-10 5:24:59249 days ago1712726699IN
0xB109aE8C...2df6367f3
0.000701 ETH0.0028331114.08290525
Send To Other Ch...196231242024-04-10 5:24:11249 days ago1712726651IN
0xB109aE8C...2df6367f3
0.000701 ETH0.0030980513.5531699
Set Router192871552024-02-23 1:55:23297 days ago1708653323IN
0xB109aE8C...2df6367f3
0 ETH0.0008710230
Send To Other Ch...192037022024-02-11 8:41:47308 days ago1707640907IN
0xB109aE8C...2df6367f3
0.00062496 ETH0.0050074525
Send To Other Ch...191558842024-02-04 15:37:47315 days ago1707061067IN
0xB109aE8C...2df6367f3
0.00061082 ETH0.0032045716
Send To Other Ch...190995682024-01-27 18:01:11323 days ago1706378471IN
0xB109aE8C...2df6367f3
0.00053882 ETH0.0030111915.03450063
Send To Other Ch...190994332024-01-27 17:33:59323 days ago1706376839IN
0xB109aE8C...2df6367f3
0.00053882 ETH0.0040198819.79400029
Send To Other Ch...190936142024-01-26 22:00:35324 days ago1706306435IN
0xB109aE8C...2df6367f3
0.00058194 ETH0.0028548214.2537354
View all transactions

Latest 25 internal transactions (View All)

Advanced mode:
Parent Transaction Hash Block
From
To
206536882024-09-01 5:39:47105 days ago1725169187
0xB109aE8C...2df6367f3
0.0005668 ETH
206068522024-08-25 16:39:23112 days ago1724603963
0xB109aE8C...2df6367f3
0.00058805 ETH
206067962024-08-25 16:27:59112 days ago1724603279
0xB109aE8C...2df6367f3
0.00058805 ETH
206066192024-08-25 15:52:23112 days ago1724601143
0xB109aE8C...2df6367f3
0.0005859 ETH
206063362024-08-25 14:55:23112 days ago1724597723
0xB109aE8C...2df6367f3
0.0005859 ETH
206062102024-08-25 14:29:59112 days ago1724596199
0xB109aE8C...2df6367f3
0.0005859 ETH
206060622024-08-25 14:00:11112 days ago1724594411
0xB109aE8C...2df6367f3
0.0005859 ETH
205625352024-08-19 12:00:11118 days ago1724068811
0xB109aE8C...2df6367f3
0.00053531 ETH
205143352024-08-12 18:30:35125 days ago1723487435
0xB109aE8C...2df6367f3
0.00051139 ETH
205143292024-08-12 18:29:23125 days ago1723487363
0xB109aE8C...2df6367f3
0.00051139 ETH
198200432024-05-07 18:41:23222 days ago1715107283
0xB109aE8C...2df6367f3
0.00066642 ETH
198200402024-05-07 18:40:47222 days ago1715107247
0xB109aE8C...2df6367f3
0.00066642 ETH
197856502024-05-02 23:16:11227 days ago1714691771
0xB109aE8C...2df6367f3
0.0006175 ETH
197856452024-05-02 23:15:11227 days ago1714691711
0xB109aE8C...2df6367f3
0.0006175 ETH
197856402024-05-02 23:14:11227 days ago1714691651
0xB109aE8C...2df6367f3
0.0006175 ETH
196231492024-04-10 5:29:11249 days ago1712726951
0xB109aE8C...2df6367f3
0.000701 ETH
196231282024-04-10 5:24:59249 days ago1712726699
0xB109aE8C...2df6367f3
0.000701 ETH
196231242024-04-10 5:24:11249 days ago1712726651
0xB109aE8C...2df6367f3
0.000701 ETH
192037022024-02-11 8:41:47308 days ago1707640907
0xB109aE8C...2df6367f3
0.00062496 ETH
191558842024-02-04 15:37:47315 days ago1707061067
0xB109aE8C...2df6367f3
0.00061082 ETH
190995682024-01-27 18:01:11323 days ago1706378471
0xB109aE8C...2df6367f3
0.00053882 ETH
190994332024-01-27 17:33:59323 days ago1706376839
0xB109aE8C...2df6367f3
0.00053882 ETH
190936142024-01-26 22:00:35324 days ago1706306435
0xB109aE8C...2df6367f3
0.00058194 ETH
190936122024-01-26 22:00:11324 days ago1706306411
0xB109aE8C...2df6367f3
0.00058194 ETH
190915422024-01-26 15:01:47324 days ago1706281307
0xB109aE8C...2df6367f3
0.00055921 ETH
View All Internal Transactions
Loading...
Loading

Contract Source Code Verified (Exact Match)

Contract Name:
M1ZSourceSender

Compiler Version
v0.8.20+commit.a1b79de6

Optimization Enabled:
Yes with 200 runs

Other Settings:
paris EvmVersion
File 1 of 29 : M1ZSourceSender.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import '@chainlink/contracts-ccip/src/v0.8/ccip/interfaces/IRouterClient.sol';

import './libs/chainlink/LinkTokenInterface.sol';
import './utils/M1ZPrices.sol';
import './utils/Withdraw.sol';
import './MissingOnez.sol';

contract M1ZSourceSender is M1ZPrices, Withdraw {
    address public i_router;
    address immutable i_link;

    event MessageSent(bytes32 messageId);

    uint256 public maxBatch = 5;
    uint256 public crossChainGasLimit = 1000000;

    MissingOnez public m1z;
    mapping(uint64 => bool) public allowedDestinations;
    bool public canMintCrossChain;

    constructor(
        address initialOwner,
        address router,
        address link,
        uint256 _unitPrice,
        address m1zAddress
    ) M1ZPrices(_unitPrice) Withdraw(initialOwner) {
        i_router = router;
        i_link = link;
        m1z = MissingOnez(m1zAddress);
    }

    receive() external payable {}

    //////////////////////////////////////////
    // FEES GETTER
    //////////////////////////////////////////

    function getMintFee(
        uint256 amount,
        uint64 destinationChainSelector,
        address receiver,
        PayFeesIn payFeesIn
    ) external view returns (uint256) {
        Client.EVM2AnyMessage memory message = Client.EVM2AnyMessage({
            receiver: abi.encode(receiver),
            data: abi.encodeCall(MissingOnez.mint, (amount, _msgSender())),
            tokenAmounts: new Client.EVMTokenAmount[](0),
            extraArgs: Client._argsToBytes(Client.EVMExtraArgsV1({gasLimit: crossChainGasLimit, strict: false})),
            feeToken: payFeesIn == PayFeesIn.LINK ? i_link : address(0)
        });

        return IRouterClient(i_router).getFee(destinationChainSelector, message);
    }

    function getTransferFee(
        uint256[] calldata tokenIds,
        uint256[] calldata ids,
        uint64 destinationChainSelector,
        address receiver,
        PayFeesIn payFeesIn
    ) external view returns (uint256) {
        Client.EVM2AnyMessage memory message = Client.EVM2AnyMessage({
            receiver: abi.encode(receiver),
            data: abi.encodeCall(MissingOnez.mintFromCrossChainTransfer, (tokenIds, ids, _msgSender(), block.chainid)),
            tokenAmounts: new Client.EVMTokenAmount[](0),
            extraArgs: Client._argsToBytes(Client.EVMExtraArgsV1({gasLimit: crossChainGasLimit, strict: false})),
            feeToken: payFeesIn == PayFeesIn.LINK ? i_link : address(0)
        });

        return IRouterClient(i_router).getFee(destinationChainSelector, message);
    }

    //////////////////////////////////////////
    // CROSS-CHAIN
    //////////////////////////////////////////

    /**
     * Cross-chain mint method.
     * This method should be called by users willing to mint from a chain to another through CCIP.
     * @param amount The amount of NFTs to mint.
     * @param destinationChainSelector The destination chainSelector.
     * @param receiver Address of the destination EVM chain contract.
     * @param payFeesIn Whether to pay the fees in native or LINK currency
     */
    function mint(uint256 amount, uint64 destinationChainSelector, address receiver, PayFeesIn payFeesIn) external payable {
        require(allowedDestinations[destinationChainSelector], 'M1ZSourceSender: destination chain is not allowed');
        require(canMintCrossChain, 'M1ZSourceSender: mint is not permitted from this chain to another chain');
        require(amount > 0, 'M1ZSourceSender: must mint at least one');
        require(amount <= maxBatch, 'M1ZSourceSender: cannot mint more than maxBatch at once');

        Client.EVM2AnyMessage memory message = Client.EVM2AnyMessage({
            receiver: abi.encode(receiver),
            data: abi.encodeCall(MissingOnez.mint, (amount, _msgSender())),
            tokenAmounts: new Client.EVMTokenAmount[](0),
            extraArgs: Client._argsToBytes(Client.EVMExtraArgsV1({gasLimit: crossChainGasLimit, strict: false})),
            feeToken: payFeesIn == PayFeesIn.LINK ? i_link : address(0)
        });

        uint256 price = getPrice(amount);
        require(msg.value >= price, 'M1ZSourceSender: did not send enough native tokens to pay');

        uint256 fee = IRouterClient(i_router).getFee(destinationChainSelector, message);
        bytes32 messageId;

        if (payFeesIn == PayFeesIn.LINK) {
            require(LinkTokenInterface(i_link).balanceOf(address(this)) >= fee, 'M1ZSourceSender: contract does not have enough LINK');
            LinkTokenInterface(i_link).approve(i_router, fee);
            messageId = IRouterClient(i_router).ccipSend(destinationChainSelector, message);
        } else {
            require(msg.value >= price + fee, 'M1ZSourceSender: did not send enough native tokens to cover the fees');
            messageId = IRouterClient(i_router).ccipSend{value: fee}(destinationChainSelector, message);
        }

        emit MessageSent(messageId);
    }

    /**
     * Burn an array of nfts from the local chain and send a message to the destination chain to mint them there.
     * @param tokenIds Array of nft tokenIds.
     * @param destinationChainSelector The destination chainSelector.
     * @param receiver Address of the destination EVM chain contract.
     * @param payFeesIn Whether to pay the fees in native or LINK currency
     */
    function sendToOtherChain(
        uint256[] calldata tokenIds,
        uint256[] calldata ids,
        uint64 destinationChainSelector,
        address receiver,
        PayFeesIn payFeesIn
    ) external payable {
        require(allowedDestinations[destinationChainSelector], 'M1ZSourceSender: destination chain is not allowed');
        require(tokenIds.length == ids.length, 'M1ZSourceSender: arrays lengths do not match');
        require(tokenIds.length > 0, 'M1ZSourceSender: must send at least 1 M1Z');
        require(tokenIds.length <= maxBatch, 'M1ZSourceSender: cannot transfer more than maxBatch at once');

        for (uint i = 0; i < tokenIds.length; i++) {
            require(m1z.revealedTokenIds(tokenIds[i]), 'M1ZSourceSender: cannot transfer to another chain if not revealed');
            m1z.burn(tokenIds[i]);
        }

        Client.EVM2AnyMessage memory message = Client.EVM2AnyMessage({
            receiver: abi.encode(receiver),
            data: abi.encodeCall(MissingOnez.mintFromCrossChainTransfer, (tokenIds, ids, _msgSender(), block.chainid)),
            tokenAmounts: new Client.EVMTokenAmount[](0),
            extraArgs: Client._argsToBytes(Client.EVMExtraArgsV1({gasLimit: crossChainGasLimit, strict: false})),
            feeToken: payFeesIn == PayFeesIn.LINK ? i_link : address(0)
        });

        uint256 fee = IRouterClient(i_router).getFee(destinationChainSelector, message);

        bytes32 messageId;
        if (payFeesIn == PayFeesIn.LINK) {
            require(LinkTokenInterface(i_link).balanceOf(address(this)) >= fee, 'M1ZSourceSender: contract does not have enough LINK');
            LinkTokenInterface(i_link).approve(i_router, fee);
            messageId = IRouterClient(i_router).ccipSend(destinationChainSelector, message);
        } else {
            require(msg.value >= fee, 'M1ZSourceSender: did not send enough native tokens to cover the fees');
            messageId = IRouterClient(i_router).ccipSend{value: fee}(destinationChainSelector, message);
        }

        emit MessageSent(messageId);
    }

    //////////////////////////////////////////
    // SETTER
    //////////////////////////////////////////

    function setRouter(address router) external onlyOwner {
        i_router = router;
    }

    function setM1Z(address m1zAddress) external onlyOwner {
        m1z = MissingOnez(m1zAddress);
    }

    function setAllowedDestinations(uint64[] calldata _allowedDestinations, bool isAllowed) external onlyOwner {
        for (uint i = 0; i < _allowedDestinations.length; i++) {
            allowedDestinations[_allowedDestinations[i]] = isAllowed;
        }
    }

    function setCanMintCrossChain(bool _canMintCrossChain) external onlyOwner {
        canMintCrossChain = _canMintCrossChain;
    }

    function setMaxBatch(uint256 _maxBatch) external onlyOwner {
        maxBatch = _maxBatch;
    }

    function setCrossChainGasLimit(uint256 _crossChainGasLimit) external onlyOwner {
        crossChainGasLimit = _crossChainGasLimit;
    }
}

File 2 of 29 : IRouterClient.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import {Client} from "../libraries/Client.sol";

interface IRouterClient {
  error UnsupportedDestinationChain(uint64 destChainSelector);
  error InsufficientFeeTokenAmount();
  error InvalidMsgValue();

  /// @notice Checks if the given chain ID is supported for sending/receiving.
  /// @param chainSelector The chain to check.
  /// @return supported is true if it is supported, false if not.
  function isChainSupported(uint64 chainSelector) external view returns (bool supported);

  /// @notice Gets a list of all supported tokens which can be sent or received
  /// to/from a given chain id.
  /// @param chainSelector The chainSelector.
  /// @return tokens The addresses of all tokens that are supported.
  function getSupportedTokens(uint64 chainSelector) external view returns (address[] memory tokens);

  /// @param destinationChainSelector The destination chainSelector
  /// @param message The cross-chain CCIP message including data and/or tokens
  /// @return fee returns guaranteed execution fee for the specified message
  /// delivery to destination chain
  /// @dev returns 0 fee on invalid message.
  function getFee(
    uint64 destinationChainSelector,
    Client.EVM2AnyMessage memory message
  ) external view returns (uint256 fee);

  /// @notice Request a message to be sent to the destination chain
  /// @param destinationChainSelector The destination chain ID
  /// @param message The cross-chain CCIP message including data and/or tokens
  /// @return messageId The message ID
  /// @dev Note if msg.value is larger than the required fee (from getFee) we accept
  /// the overpayment with no refund.
  function ccipSend(
    uint64 destinationChainSelector,
    Client.EVM2AnyMessage calldata message
  ) external payable returns (bytes32);
}

File 3 of 29 : Client.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

// End consumer library.
library Client {
  struct EVMTokenAmount {
    address token; // token address on the local chain.
    uint256 amount; // Amount of tokens.
  }

  struct Any2EVMMessage {
    bytes32 messageId; // MessageId corresponding to ccipSend on source.
    uint64 sourceChainSelector; // Source chain selector.
    bytes sender; // abi.decode(sender) if coming from an EVM chain.
    bytes data; // payload sent in original message.
    EVMTokenAmount[] destTokenAmounts; // Tokens and their amounts in their destination chain representation.
  }

  // If extraArgs is empty bytes, the default is 200k gas limit and strict = false.
  struct EVM2AnyMessage {
    bytes receiver; // abi.encode(receiver address) for dest EVM chains
    bytes data; // Data payload
    EVMTokenAmount[] tokenAmounts; // Token transfers
    address feeToken; // Address of feeToken. address(0) means you will send msg.value.
    bytes extraArgs; // Populate this with _argsToBytes(EVMExtraArgsV1)
  }

  // extraArgs will evolve to support new features
  // bytes4(keccak256("CCIP EVMExtraArgsV1"));
  bytes4 public constant EVM_EXTRA_ARGS_V1_TAG = 0x97a657c9;
  struct EVMExtraArgsV1 {
    uint256 gasLimit; // ATTENTION!!! MAX GAS LIMIT 4M FOR BETA TESTING
    bool strict; // See strict sequencing details below.
  }

  function _argsToBytes(EVMExtraArgsV1 memory extraArgs) internal pure returns (bytes memory bts) {
    return abi.encodeWithSelector(EVM_EXTRA_ARGS_V1_TAG, extraArgs);
  }
}

File 4 of 29 : AccessControl.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/AccessControl.sol)

pragma solidity ^0.8.20;

import {IAccessControl} from "./IAccessControl.sol";
import {Context} from "../utils/Context.sol";
import {ERC165} from "../utils/introspection/ERC165.sol";

/**
 * @dev Contract module that allows children to implement role-based access
 * control mechanisms. This is a lightweight version that doesn't allow enumerating role
 * members except through off-chain means by accessing the contract event logs. Some
 * applications may benefit from on-chain enumerability, for those cases see
 * {AccessControlEnumerable}.
 *
 * Roles are referred to by their `bytes32` identifier. These should be exposed
 * in the external API and be unique. The best way to achieve this is by
 * using `public constant` hash digests:
 *
 * ```solidity
 * bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
 * ```
 *
 * Roles can be used to represent a set of permissions. To restrict access to a
 * function call, use {hasRole}:
 *
 * ```solidity
 * function foo() public {
 *     require(hasRole(MY_ROLE, msg.sender));
 *     ...
 * }
 * ```
 *
 * Roles can be granted and revoked dynamically via the {grantRole} and
 * {revokeRole} functions. Each role has an associated admin role, and only
 * accounts that have a role's admin role can call {grantRole} and {revokeRole}.
 *
 * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
 * that only accounts with this role will be able to grant or revoke other
 * roles. More complex role relationships can be created by using
 * {_setRoleAdmin}.
 *
 * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
 * grant and revoke this role. Extra precautions should be taken to secure
 * accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}
 * to enforce additional security measures for this role.
 */
abstract contract AccessControl is Context, IAccessControl, ERC165 {
    struct RoleData {
        mapping(address account => bool) hasRole;
        bytes32 adminRole;
    }

    mapping(bytes32 role => RoleData) private _roles;

    bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;

    /**
     * @dev Modifier that checks that an account has a specific role. Reverts
     * with an {AccessControlUnauthorizedAccount} error including the required role.
     */
    modifier onlyRole(bytes32 role) {
        _checkRole(role);
        _;
    }

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
    }

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) public view virtual returns (bool) {
        return _roles[role].hasRole[account];
    }

    /**
     * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `_msgSender()`
     * is missing `role`. Overriding this function changes the behavior of the {onlyRole} modifier.
     */
    function _checkRole(bytes32 role) internal view virtual {
        _checkRole(role, _msgSender());
    }

    /**
     * @dev Reverts with an {AccessControlUnauthorizedAccount} error if `account`
     * is missing `role`.
     */
    function _checkRole(bytes32 role, address account) internal view virtual {
        if (!hasRole(role, account)) {
            revert AccessControlUnauthorizedAccount(account, role);
        }
    }

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) public view virtual returns (bytes32) {
        return _roles[role].adminRole;
    }

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleGranted} event.
     */
    function grantRole(bytes32 role, address account) public virtual onlyRole(getRoleAdmin(role)) {
        _grantRole(role, account);
    }

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     *
     * May emit a {RoleRevoked} event.
     */
    function revokeRole(bytes32 role, address account) public virtual onlyRole(getRoleAdmin(role)) {
        _revokeRole(role, account);
    }

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been revoked `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `callerConfirmation`.
     *
     * May emit a {RoleRevoked} event.
     */
    function renounceRole(bytes32 role, address callerConfirmation) public virtual {
        if (callerConfirmation != _msgSender()) {
            revert AccessControlBadConfirmation();
        }

        _revokeRole(role, callerConfirmation);
    }

    /**
     * @dev Sets `adminRole` as ``role``'s admin role.
     *
     * Emits a {RoleAdminChanged} event.
     */
    function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
        bytes32 previousAdminRole = getRoleAdmin(role);
        _roles[role].adminRole = adminRole;
        emit RoleAdminChanged(role, previousAdminRole, adminRole);
    }

    /**
     * @dev Attempts to grant `role` to `account` and returns a boolean indicating if `role` was granted.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleGranted} event.
     */
    function _grantRole(bytes32 role, address account) internal virtual returns (bool) {
        if (!hasRole(role, account)) {
            _roles[role].hasRole[account] = true;
            emit RoleGranted(role, account, _msgSender());
            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Attempts to revoke `role` to `account` and returns a boolean indicating if `role` was revoked.
     *
     * Internal function without access restriction.
     *
     * May emit a {RoleRevoked} event.
     */
    function _revokeRole(bytes32 role, address account) internal virtual returns (bool) {
        if (hasRole(role, account)) {
            _roles[role].hasRole[account] = false;
            emit RoleRevoked(role, account, _msgSender());
            return true;
        } else {
            return false;
        }
    }
}

File 5 of 29 : IAccessControl.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/IAccessControl.sol)

pragma solidity ^0.8.20;

/**
 * @dev External interface of AccessControl declared to support ERC165 detection.
 */
interface IAccessControl {
    /**
     * @dev The `account` is missing a role.
     */
    error AccessControlUnauthorizedAccount(address account, bytes32 neededRole);

    /**
     * @dev The caller of a function is not the expected one.
     *
     * NOTE: Don't confuse with {AccessControlUnauthorizedAccount}.
     */
    error AccessControlBadConfirmation();

    /**
     * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
     *
     * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
     * {RoleAdminChanged} not being emitted signaling this.
     */
    event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);

    /**
     * @dev Emitted when `account` is granted `role`.
     *
     * `sender` is the account that originated the contract call, an admin role
     * bearer except when using {AccessControl-_setupRole}.
     */
    event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Emitted when `account` is revoked `role`.
     *
     * `sender` is the account that originated the contract call:
     *   - if using `revokeRole`, it is the admin role bearer
     *   - if using `renounceRole`, it is the role bearer (i.e. `account`)
     */
    event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);

    /**
     * @dev Returns `true` if `account` has been granted `role`.
     */
    function hasRole(bytes32 role, address account) external view returns (bool);

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {AccessControl-_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) external view returns (bytes32);

    /**
     * @dev Grants `role` to `account`.
     *
     * If `account` had not been already granted `role`, emits a {RoleGranted}
     * event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function grantRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from `account`.
     *
     * If `account` had been granted `role`, emits a {RoleRevoked} event.
     *
     * Requirements:
     *
     * - the caller must have ``role``'s admin role.
     */
    function revokeRole(bytes32 role, address account) external;

    /**
     * @dev Revokes `role` from the calling account.
     *
     * Roles are often managed via {grantRole} and {revokeRole}: this function's
     * purpose is to provide a mechanism for accounts to lose their privileges
     * if they are compromised (such as when a trusted device is misplaced).
     *
     * If the calling account had been granted `role`, emits a {RoleRevoked}
     * event.
     *
     * Requirements:
     *
     * - the caller must be `callerConfirmation`.
     */
    function renounceRole(bytes32 role, address callerConfirmation) external;
}

File 6 of 29 : Ownable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)

pragma solidity ^0.8.20;

import {Context} from "../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.
 *
 * The initial owner is set to the address provided by the deployer. 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;

    /**
     * @dev The caller account is not authorized to perform an operation.
     */
    error OwnableUnauthorizedAccount(address account);

    /**
     * @dev The owner is not a valid owner account. (eg. `address(0)`)
     */
    error OwnableInvalidOwner(address owner);

    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Initializes the contract setting the address provided by the deployer as the initial owner.
     */
    constructor(address initialOwner) {
        if (initialOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(initialOwner);
    }

    /**
     * @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 {
        if (owner() != _msgSender()) {
            revert OwnableUnauthorizedAccount(_msgSender());
        }
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby disabling any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        if (newOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _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);
    }
}

File 7 of 29 : draft-IERC6093.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol)
pragma solidity ^0.8.20;

/**
 * @dev Standard ERC20 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens.
 */
interface IERC20Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC20InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC20InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     * @param allowance Amount of tokens a `spender` is allowed to operate with.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC20InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `spender` to be approved. Used in approvals.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC20InvalidSpender(address spender);
}

/**
 * @dev Standard ERC721 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens.
 */
interface IERC721Errors {
    /**
     * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20.
     * Used in balance queries.
     * @param owner Address of the current owner of a token.
     */
    error ERC721InvalidOwner(address owner);

    /**
     * @dev Indicates a `tokenId` whose `owner` is the zero address.
     * @param tokenId Identifier number of a token.
     */
    error ERC721NonexistentToken(uint256 tokenId);

    /**
     * @dev Indicates an error related to the ownership over a particular token. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param tokenId Identifier number of a token.
     * @param owner Address of the current owner of a token.
     */
    error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC721InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC721InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param tokenId Identifier number of a token.
     */
    error ERC721InsufficientApproval(address operator, uint256 tokenId);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC721InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC721InvalidOperator(address operator);
}

/**
 * @dev Standard ERC1155 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens.
 */
interface IERC1155Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     * @param tokenId Identifier number of a token.
     */
    error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC1155InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC1155InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param owner Address of the current owner of a token.
     */
    error ERC1155MissingApprovalForAll(address operator, address owner);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC1155InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC1155InvalidOperator(address operator);

    /**
     * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
     * Used in batch transfers.
     * @param idsLength Length of the array of token identifiers
     * @param valuesLength Length of the array of token amounts
     */
    error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
}

File 8 of 29 : IERC2981.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC2981.sol)

pragma solidity ^0.8.20;

import {IERC165} from "../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.
 */
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);
}

File 9 of 29 : ERC2981.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/common/ERC2981.sol)

pragma solidity ^0.8.20;

import {IERC2981} from "../../interfaces/IERC2981.sol";
import {IERC165, ERC165} from "../../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.
 */
abstract contract ERC2981 is IERC2981, ERC165 {
    struct RoyaltyInfo {
        address receiver;
        uint96 royaltyFraction;
    }

    RoyaltyInfo private _defaultRoyaltyInfo;
    mapping(uint256 tokenId => RoyaltyInfo) private _tokenRoyaltyInfo;

    /**
     * @dev The default royalty set is invalid (eg. (numerator / denominator) >= 1).
     */
    error ERC2981InvalidDefaultRoyalty(uint256 numerator, uint256 denominator);

    /**
     * @dev The default royalty receiver is invalid.
     */
    error ERC2981InvalidDefaultRoyaltyReceiver(address receiver);

    /**
     * @dev The royalty set for an specific `tokenId` is invalid (eg. (numerator / denominator) >= 1).
     */
    error ERC2981InvalidTokenRoyalty(uint256 tokenId, uint256 numerator, uint256 denominator);

    /**
     * @dev The royalty receiver for `tokenId` is invalid.
     */
    error ERC2981InvalidTokenRoyaltyReceiver(uint256 tokenId, address receiver);

    /**
     * @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 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 {
        uint256 denominator = _feeDenominator();
        if (feeNumerator > denominator) {
            // Royalty fee will exceed the sale price
            revert ERC2981InvalidDefaultRoyalty(feeNumerator, denominator);
        }
        if (receiver == address(0)) {
            revert ERC2981InvalidDefaultRoyaltyReceiver(address(0));
        }

        _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 {
        uint256 denominator = _feeDenominator();
        if (feeNumerator > denominator) {
            // Royalty fee will exceed the sale price
            revert ERC2981InvalidTokenRoyalty(tokenId, feeNumerator, denominator);
        }
        if (receiver == address(0)) {
            revert ERC2981InvalidTokenRoyaltyReceiver(tokenId, address(0));
        }

        _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];
    }
}

File 10 of 29 : IERC20.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol)

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
interface IERC20 {
    /**
     * @dev Emitted when `value` tokens are moved from one account (`from`) to
     * another (`to`).
     *
     * Note that `value` may be zero.
     */
    event Transfer(address indexed from, address indexed to, uint256 value);

    /**
     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
     * a call to {approve}. `value` is the new allowance.
     */
    event Approval(address indexed owner, address indexed spender, uint256 value);

    /**
     * @dev Returns the value of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

    /**
     * @dev Returns the value of tokens owned by `account`.
     */
    function balanceOf(address account) external view returns (uint256);

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transfer(address to, uint256 value) external returns (bool);

    /**
     * @dev Returns the remaining number of tokens that `spender` will be
     * allowed to spend on behalf of `owner` through {transferFrom}. This is
     * zero by default.
     *
     * This value changes when {approve} or {transferFrom} are called.
     */
    function allowance(address owner, address spender) external view returns (uint256);

    /**
     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
     * caller's tokens.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * IMPORTANT: Beware that changing an allowance with this method brings the risk
     * that someone may use both the old and the new allowance by unfortunate
     * transaction ordering. One possible solution to mitigate this race
     * condition is to first reduce the spender's allowance to 0 and set the
     * desired value afterwards:
     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
     *
     * Emits an {Approval} event.
     */
    function approve(address spender, uint256 value) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to` using the
     * allowance mechanism. `value` is then deducted from the caller's
     * allowance.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(address from, address to, uint256 value) external returns (bool);
}

File 11 of 29 : ERC721.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/ERC721.sol)

pragma solidity ^0.8.20;

import {IERC721} from './IERC721.sol';
import {IERC721Receiver} from './IERC721Receiver.sol';
import {IERC721Metadata} from './extensions/IERC721Metadata.sol';
import {Context} from '../../utils/Context.sol';
import {Strings} from '../../utils/Strings.sol';
import {IERC165, ERC165} from '../../utils/introspection/ERC165.sol';
import {IERC721Errors} from '../../interfaces/draft-IERC6093.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}.
 */
abstract contract ERC721 is Context, ERC165, IERC721, IERC721Metadata, IERC721Errors {
    using Strings for uint256;

    // Token name
    string private _name;

    // Token symbol
    string private _symbol;

    mapping(uint256 tokenId => address) private _owners;

    mapping(address owner => uint256) private _balances;

    mapping(uint256 tokenId => address) private _tokenApprovals;

    mapping(address owner => mapping(address operator => 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 returns (uint256) {
        if (owner == address(0)) {
            revert ERC721InvalidOwner(address(0));
        }
        return _balances[owner];
    }

    /**
     * @dev See {IERC721-ownerOf}.
     */
    function ownerOf(uint256 tokenId) public view virtual returns (address) {
        return _requireOwned(tokenId);
    }

    /**
     * @dev See {IERC721Metadata-name}.
     */
    function name() public view virtual returns (string memory) {
        return _name;
    }

    /**
     * @dev See {IERC721Metadata-symbol}.
     */
    function symbol() public view virtual returns (string memory) {
        return _symbol;
    }

    /**
     * @dev See {IERC721Metadata-tokenURI}.
     */
    function tokenURI(uint256 tokenId) public view virtual returns (string memory) {
        _requireOwned(tokenId);

        string memory baseURI = _baseURI();
        return bytes(baseURI).length > 0 ? string.concat(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 {
        _approve(to, tokenId, _msgSender());
    }

    /**
     * @dev See {IERC721-getApproved}.
     */
    function getApproved(uint256 tokenId) public view virtual returns (address) {
        _requireOwned(tokenId);

        return _getApproved(tokenId);
    }

    /**
     * @dev See {IERC721-setApprovalForAll}.
     */
    function setApprovalForAll(address operator, bool approved) public virtual {
        _setApprovalForAll(_msgSender(), operator, approved);
    }

    /**
     * @dev See {IERC721-isApprovedForAll}.
     */
    function isApprovedForAll(address owner, address operator) public view virtual returns (bool) {
        return _operatorApprovals[owner][operator];
    }

    /**
     * @dev See {IERC721-transferFrom}.
     */
    function transferFrom(address from, address to, uint256 tokenId) public virtual {
        if (to == address(0)) {
            revert ERC721InvalidReceiver(address(0));
        }
        // Setting an "auth" arguments enables the `_isAuthorized` check which verifies that the token exists
        // (from != 0). Therefore, it is not needed to verify that the return value is not 0 here.
        address previousOwner = _update(to, tokenId, _msgSender());
        if (previousOwner != from) {
            revert ERC721IncorrectOwner(from, tokenId, previousOwner);
        }
    }

    /**
     * @dev See {IERC721-safeTransferFrom}.
     */
    function safeTransferFrom(address from, address to, uint256 tokenId) public {
        safeTransferFrom(from, to, tokenId, '');
    }

    /**
     * @dev See {IERC721-safeTransferFrom}.
     */
    function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public virtual {
        transferFrom(from, to, tokenId);
        _checkOnERC721Received(from, to, tokenId, data);
    }

    /**
     * @dev Returns the owner of the `tokenId`. Does NOT revert if token doesn't exist
     *
     * IMPORTANT: Any overrides to this function that add ownership of tokens not tracked by the
     * core ERC721 logic MUST be matched with the use of {_increaseBalance} to keep balances
     * consistent with ownership. The invariant to preserve is 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`.
     */
    function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
        return _owners[tokenId];
    }

    /**
     * @dev Returns the approved address for `tokenId`. Returns 0 if `tokenId` is not minted.
     */
    function _getApproved(uint256 tokenId) internal view virtual returns (address) {
        return _tokenApprovals[tokenId];
    }

    /**
     * @dev Returns whether `spender` is allowed to manage `owner`'s tokens, or `tokenId` in
     * particular (ignoring whether it is owned by `owner`).
     *
     * WARNING: This function assumes that `owner` is the actual owner of `tokenId` and does not verify this
     * assumption.
     */
    function _isAuthorized(address owner, address spender, uint256 tokenId) internal view virtual returns (bool) {
        return spender != address(0) && (owner == spender || isApprovedForAll(owner, spender) || _getApproved(tokenId) == spender);
    }

    /**
     * @dev Checks if `spender` can operate on `tokenId`, assuming the provided `owner` is the actual owner.
     * Reverts if `spender` does not have approval from the provided `owner` for the given token or for all its assets
     * the `spender` for the specific `tokenId`.
     *
     * WARNING: This function assumes that `owner` is the actual owner of `tokenId` and does not verify this
     * assumption.
     */
    function _checkAuthorized(address owner, address spender, uint256 tokenId) internal view virtual {
        if (!_isAuthorized(owner, spender, tokenId)) {
            if (owner == address(0)) {
                revert ERC721NonexistentToken(tokenId);
            } else {
                revert ERC721InsufficientApproval(spender, tokenId);
            }
        }
    }

    /**
     * @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
     *
     * NOTE: the value is limited to type(uint128).max. This protect against _balance overflow. It is unrealistic that
     * a uint256 would ever overflow from increments when these increments are bounded to uint128 values.
     *
     * WARNING: Increasing an account's balance using this function tends to be paired with an override of the
     * {_ownerOf} function to resolve the ownership of the corresponding tokens so that balances and ownership
     * remain consistent with one another.
     */
    function _increaseBalance(address account, uint128 value) internal virtual {
        unchecked {
            _balances[account] += value;
        }
    }

    /**
     * @dev Transfers `tokenId` from its current owner to `to`, or alternatively mints (or burns) if the current owner
     * (or `to`) is the zero address. Returns the owner of the `tokenId` before the update.
     *
     * The `auth` argument is optional. If the value passed is non 0, then this function will check that
     * `auth` is either the owner of the token, or approved to operate on the token (by the owner).
     *
     * Emits a {Transfer} event.
     *
     * NOTE: If overriding this function in a way that tracks balances, see also {_increaseBalance}.
     */
    function _update(address to, uint256 tokenId, address auth) internal virtual returns (address) {
        address from = _ownerOf(tokenId);

        // Perform (optional) operator check
        if (auth != address(0)) {
            _checkAuthorized(from, auth, tokenId);
        }

        // Execute the update
        if (from != address(0)) {
            // Clear approval. No need to re-authorize or emit the Approval event
            _approve(address(0), tokenId, address(0), false);

            unchecked {
                _balances[from] -= 1;
            }
        }

        if (to != address(0)) {
            unchecked {
                _balances[to] += 1;
            }
        }

        _owners[tokenId] = to;

        emit Transfer(from, to, tokenId);

        return from;
    }

    /**
     * @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 {
        if (to == address(0)) {
            revert ERC721InvalidReceiver(address(0));
        }
        address previousOwner = _update(to, tokenId, address(0));
        if (previousOwner != address(0)) {
            revert ERC721InvalidSender(address(0));
        }
    }

    /**
     * @dev Mints `tokenId`, transfers it to `to` and checks for `to` acceptance.
     *
     * 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 {
        _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);
        _checkOnERC721Received(address(0), to, tokenId, data);
    }

    /**
     * @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 {
        address previousOwner = _update(address(0), tokenId, address(0));
        if (previousOwner == address(0)) {
            revert ERC721NonexistentToken(tokenId);
        }
    }

    /**
     * @dev Transfers `tokenId` from `from` to `to`.
     *  As opposed to {transferFrom}, this imposes no restrictions on _msgSender().
     *
     * 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 {
        if (to == address(0)) {
            revert ERC721InvalidReceiver(address(0));
        }
        address previousOwner = _update(to, tokenId, address(0));
        if (previousOwner == address(0)) {
            revert ERC721NonexistentToken(tokenId);
        } else if (previousOwner != from) {
            revert ERC721IncorrectOwner(from, tokenId, previousOwner);
        }
    }

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`, checking that contract recipients
     * are aware of the ERC721 standard 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 like {safeTransferFrom} in the sense that it invokes
     * {IERC721Receiver-onERC721Received} on the receiver, and can be used to e.g.
     * implement alternative mechanisms to perform token transfer, such as signature-based.
     *
     * Requirements:
     *
     * - `tokenId` token must exist and be owned by `from`.
     * - `to` cannot be the zero address.
     * - `from` cannot be the zero address.
     * - 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) internal {
        _safeTransfer(from, to, tokenId, '');
    }

    /**
     * @dev Same as {xref-ERC721-_safeTransfer-address-address-uint256-}[`_safeTransfer`], with an additional `data` parameter which is
     * forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
     */
    function _safeTransfer(address from, address to, uint256 tokenId, bytes memory data) internal virtual {
        _transfer(from, to, tokenId);
        _checkOnERC721Received(from, to, tokenId, data);
    }

    /**
     * @dev Approve `to` to operate on `tokenId`
     *
     * The `auth` argument is optional. If the value passed is non 0, then this function will check that `auth` is
     * either the owner of the token, or approved to operate on all tokens held by this owner.
     *
     * Emits an {Approval} event.
     *
     * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.
     */
    function _approve(address to, uint256 tokenId, address auth) internal {
        _approve(to, tokenId, auth, true);
    }

    /**
     * @dev Variant of `_approve` with an optional flag to enable or disable the {Approval} event. The event is not
     * emitted in the context of transfers.
     */
    function _approve(address to, uint256 tokenId, address auth, bool emitEvent) internal virtual {
        // Avoid reading the owner unless necessary
        if (emitEvent || auth != address(0)) {
            address owner = _requireOwned(tokenId);

            // We do not use _isAuthorized because single-token approvals should not be able to call approve
            if (auth != address(0) && owner != auth && !isApprovedForAll(owner, auth)) {
                revert ERC721InvalidApprover(auth);
            }

            if (emitEvent) {
                emit Approval(owner, to, tokenId);
            }
        }

        _tokenApprovals[tokenId] = to;
    }

    /**
     * @dev Approve `operator` to operate on all of `owner` tokens
     *
     * Requirements:
     * - operator can't be the address zero.
     *
     * Emits an {ApprovalForAll} event.
     */
    function _setApprovalForAll(address owner, address operator, bool approved) internal virtual {
        if (operator == address(0)) {
            revert ERC721InvalidOperator(operator);
        }
        _operatorApprovals[owner][operator] = approved;
        emit ApprovalForAll(owner, operator, approved);
    }

    /**
     * @dev Reverts if the `tokenId` doesn't have a current owner (it hasn't been minted, or it has been burned).
     * Returns the owner.
     *
     * Overrides to ownership logic should be done to {_ownerOf}.
     */
    function _requireOwned(uint256 tokenId) internal view returns (address) {
        address owner = _ownerOf(tokenId);
        if (owner == address(0)) {
            revert ERC721NonexistentToken(tokenId);
        }
        return owner;
    }

    /**
     * @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target address. This will revert if the
     * recipient doesn't accept the token transfer. 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
     */
    function _checkOnERC721Received(address from, address to, uint256 tokenId, bytes memory data) private {
        if (to.code.length > 0) {
            try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
                if (retval != IERC721Receiver.onERC721Received.selector) {
                    revert ERC721InvalidReceiver(to);
                }
            } catch (bytes memory reason) {
                if (reason.length == 0) {
                    revert ERC721InvalidReceiver(to);
                } else {
                    /// @solidity memory-safe-assembly
                    assembly {
                        revert(add(32, reason), mload(reason))
                    }
                }
            }
        }
    }
}

File 12 of 29 : ERC721Burnable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/extensions/ERC721Burnable.sol)

pragma solidity ^0.8.20;

import {ERC721} from "../ERC721.sol";
import {Context} from "../../../utils/Context.sol";

/**
 * @title ERC721 Burnable Token
 * @dev ERC721 Token that can be burned (destroyed).
 */
abstract contract ERC721Burnable is Context, ERC721 {
    /**
     * @dev Burns `tokenId`. See {ERC721-_burn}.
     *
     * Requirements:
     *
     * - The caller must own `tokenId` or be an approved operator.
     */
    function burn(uint256 tokenId) public virtual {
        // Setting an "auth" arguments enables the `_isAuthorized` check which verifies that the token exists
        // (from != 0). Therefore, it is not needed to verify that the return value is not 0 here.
        _update(address(0), tokenId, _msgSender());
    }
}

File 13 of 29 : ERC721Enumerable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/extensions/ERC721Enumerable.sol)

pragma solidity ^0.8.20;

import {ERC721} from "../ERC721.sol";
import {IERC721Enumerable} from "./IERC721Enumerable.sol";
import {IERC165} from "../../../utils/introspection/ERC165.sol";

/**
 * @dev This implements an optional extension of {ERC721} defined in the EIP that adds enumerability
 * of all the token ids in the contract as well as all token ids owned by each account.
 *
 * CAUTION: `ERC721` extensions that implement custom `balanceOf` logic, such as `ERC721Consecutive`,
 * interfere with enumerability and should not be used together with `ERC721Enumerable`.
 */
abstract contract ERC721Enumerable is ERC721, IERC721Enumerable {
    mapping(address owner => mapping(uint256 index => uint256)) private _ownedTokens;
    mapping(uint256 tokenId => uint256) private _ownedTokensIndex;

    uint256[] private _allTokens;
    mapping(uint256 tokenId => uint256) private _allTokensIndex;

    /**
     * @dev An `owner`'s token query was out of bounds for `index`.
     *
     * NOTE: The owner being `address(0)` indicates a global out of bounds index.
     */
    error ERC721OutOfBoundsIndex(address owner, uint256 index);

    /**
     * @dev Batch mint is not allowed.
     */
    error ERC721EnumerableForbiddenBatchMint();

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC721) returns (bool) {
        return interfaceId == type(IERC721Enumerable).interfaceId || super.supportsInterface(interfaceId);
    }

    /**
     * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}.
     */
    function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual returns (uint256) {
        if (index >= balanceOf(owner)) {
            revert ERC721OutOfBoundsIndex(owner, index);
        }
        return _ownedTokens[owner][index];
    }

    /**
     * @dev See {IERC721Enumerable-totalSupply}.
     */
    function totalSupply() public view virtual returns (uint256) {
        return _allTokens.length;
    }

    /**
     * @dev See {IERC721Enumerable-tokenByIndex}.
     */
    function tokenByIndex(uint256 index) public view virtual returns (uint256) {
        if (index >= totalSupply()) {
            revert ERC721OutOfBoundsIndex(address(0), index);
        }
        return _allTokens[index];
    }

    /**
     * @dev See {ERC721-_update}.
     */
    function _update(address to, uint256 tokenId, address auth) internal virtual override returns (address) {
        address previousOwner = super._update(to, tokenId, auth);

        if (previousOwner == address(0)) {
            _addTokenToAllTokensEnumeration(tokenId);
        } else if (previousOwner != to) {
            _removeTokenFromOwnerEnumeration(previousOwner, tokenId);
        }
        if (to == address(0)) {
            _removeTokenFromAllTokensEnumeration(tokenId);
        } else if (previousOwner != to) {
            _addTokenToOwnerEnumeration(to, tokenId);
        }

        return previousOwner;
    }

    /**
     * @dev Private function to add a token to this extension's ownership-tracking data structures.
     * @param to address representing the new owner of the given token ID
     * @param tokenId uint256 ID of the token to be added to the tokens list of the given address
     */
    function _addTokenToOwnerEnumeration(address to, uint256 tokenId) private {
        uint256 length = balanceOf(to) - 1;
        _ownedTokens[to][length] = tokenId;
        _ownedTokensIndex[tokenId] = length;
    }

    /**
     * @dev Private function to add a token to this extension's token tracking data structures.
     * @param tokenId uint256 ID of the token to be added to the tokens list
     */
    function _addTokenToAllTokensEnumeration(uint256 tokenId) private {
        _allTokensIndex[tokenId] = _allTokens.length;
        _allTokens.push(tokenId);
    }

    /**
     * @dev Private function to remove a token from this extension's ownership-tracking data structures. Note that
     * while the token is not assigned a new owner, the `_ownedTokensIndex` mapping is _not_ updated: this allows for
     * gas optimizations e.g. when performing a transfer operation (avoiding double writes).
     * This has O(1) time complexity, but alters the order of the _ownedTokens array.
     * @param from address representing the previous owner of the given token ID
     * @param tokenId uint256 ID of the token to be removed from the tokens list of the given address
     */
    function _removeTokenFromOwnerEnumeration(address from, uint256 tokenId) private {
        // To prevent a gap in from's tokens array, we store the last token in the index of the token to delete, and
        // then delete the last slot (swap and pop).

        uint256 lastTokenIndex = balanceOf(from);
        uint256 tokenIndex = _ownedTokensIndex[tokenId];

        // When the token to delete is the last token, the swap operation is unnecessary
        if (tokenIndex != lastTokenIndex) {
            uint256 lastTokenId = _ownedTokens[from][lastTokenIndex];

            _ownedTokens[from][tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
            _ownedTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index
        }

        // This also deletes the contents at the last position of the array
        delete _ownedTokensIndex[tokenId];
        delete _ownedTokens[from][lastTokenIndex];
    }

    /**
     * @dev Private function to remove a token from this extension's token tracking data structures.
     * This has O(1) time complexity, but alters the order of the _allTokens array.
     * @param tokenId uint256 ID of the token to be removed from the tokens list
     */
    function _removeTokenFromAllTokensEnumeration(uint256 tokenId) private {
        // To prevent a gap in the tokens array, we store the last token in the index of the token to delete, and
        // then delete the last slot (swap and pop).

        uint256 lastTokenIndex = _allTokens.length - 1;
        uint256 tokenIndex = _allTokensIndex[tokenId];

        // When the token to delete is the last token, the swap operation is unnecessary. However, since this occurs so
        // rarely (when the last minted token is burnt) that we still do the swap here to avoid the gas cost of adding
        // an 'if' statement (like in _removeTokenFromOwnerEnumeration)
        uint256 lastTokenId = _allTokens[lastTokenIndex];

        _allTokens[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
        _allTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index

        // This also deletes the contents at the last position of the array
        delete _allTokensIndex[tokenId];
        _allTokens.pop();
    }

    /**
     * See {ERC721-_increaseBalance}. We need that to account tokens that were minted in batch
     */
    function _increaseBalance(address account, uint128 amount) internal virtual override {
        if (amount > 0) {
            revert ERC721EnumerableForbiddenBatchMint();
        }
        super._increaseBalance(account, amount);
    }
}

File 14 of 29 : IERC721Enumerable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/extensions/IERC721Enumerable.sol)

pragma solidity ^0.8.20;

import {IERC721} from "../IERC721.sol";

/**
 * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
 * @dev See https://eips.ethereum.org/EIPS/eip-721
 */
interface IERC721Enumerable is IERC721 {
    /**
     * @dev Returns the total amount of tokens stored by the contract.
     */
    function totalSupply() external view returns (uint256);

    /**
     * @dev Returns a token ID owned by `owner` at a given `index` of its token list.
     * Use along with {balanceOf} to enumerate all of ``owner``'s tokens.
     */
    function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);

    /**
     * @dev Returns a token ID at a given `index` of all the tokens stored by the contract.
     * Use along with {totalSupply} to enumerate all tokens.
     */
    function tokenByIndex(uint256 index) external view returns (uint256);
}

File 15 of 29 : IERC721Metadata.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/extensions/IERC721Metadata.sol)

pragma solidity ^0.8.20;

import {IERC721} from "../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);
}

File 16 of 29 : IERC721.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/IERC721.sol)

pragma solidity ^0.8.20;

import {IERC165} from "../../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 address zero.
     *
     * 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);
}

File 17 of 29 : IERC721Receiver.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/IERC721Receiver.sol)

pragma solidity ^0.8.20;

/**
 * @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);
}

File 18 of 29 : Context.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/Context.sol)

pragma solidity ^0.8.20;

/**
 * @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;
    }
}

File 19 of 29 : ERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/ERC165.sol)

pragma solidity ^0.8.20;

import {IERC165} from "./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);
 * }
 * ```
 */
abstract contract ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

File 20 of 29 : IERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol)

pragma solidity ^0.8.20;

/**
 * @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);
}

File 21 of 29 : Math.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/math/Math.sol)

pragma solidity ^0.8.20;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    /**
     * @dev Muldiv operation overflow.
     */
    error MathOverflowedMulDiv();

    enum Rounding {
        Floor, // Toward negative infinity
        Ceil, // Toward positive infinity
        Trunc, // Toward zero
        Expand // Away from zero
    }

    /**
     * @dev Returns the addition of two unsigned integers, with an overflow flag.
     */
    function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            uint256 c = a + b;
            if (c < a) return (false, 0);
            return (true, c);
        }
    }

    /**
     * @dev Returns the subtraction of two unsigned integers, with an overflow flag.
     */
    function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            if (b > a) return (false, 0);
            return (true, a - b);
        }
    }

    /**
     * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
     */
    function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
            // benefit is lost if 'b' is also tested.
            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
            if (a == 0) return (true, 0);
            uint256 c = a * b;
            if (c / a != b) return (false, 0);
            return (true, c);
        }
    }

    /**
     * @dev Returns the division of two unsigned integers, with a division by zero flag.
     */
    function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            if (b == 0) return (false, 0);
            return (true, a / b);
        }
    }

    /**
     * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
     */
    function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
        unchecked {
            if (b == 0) return (false, 0);
            return (true, a % b);
        }
    }

    /**
     * @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 towards infinity instead
     * of rounding towards zero.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        if (b == 0) {
            // Guarantee the same behavior as in a regular Solidity division.
            return a / b;
        }

        // (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 = x * y; // Least significant 256 bits of the product
            uint256 prod1; // Most significant 256 bits of the product
            assembly {
                let mm := mulmod(x, y, not(0))
                prod1 := sub(sub(mm, prod0), lt(mm, prod0))
            }

            // Handle non-overflow cases, 256 by 256 division.
            if (prod1 == 0) {
                // Solidity will revert if denominator == 0, unlike the div opcode on its own.
                // The surrounding unchecked block does not change this fact.
                // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            if (denominator <= prod1) {
                revert MathOverflowedMulDiv();
            }

            ///////////////////////////////////////////////
            // 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.

            uint256 twos = denominator & (0 - denominator);
            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 (unsignedRoundsUp(rounding) && 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
     * towards zero.
     *
     * 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 + (unsignedRoundsUp(rounding) && result * result < a ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 2 of a positive value rounded towards zero.
     * 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 + (unsignedRoundsUp(rounding) && 1 << result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 10 of a positive value rounded towards zero.
     * 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 + (unsignedRoundsUp(rounding) && 10 ** result < value ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 256 of a positive value rounded towards zero.
     * Returns 0 if given 0.
     *
     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
     */
    function log256(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 16;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 8;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 4;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 2;
            }
            if (value >> 8 > 0) {
                result += 1;
            }
        }
        return result;
    }

    /**
     * @dev Return the log in base 256, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log256(value);
            return result + (unsignedRoundsUp(rounding) && 1 << (result << 3) < value ? 1 : 0);
        }
    }

    /**
     * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.
     */
    function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {
        return uint8(rounding) % 2 == 1;
    }
}

File 22 of 29 : SignedMath.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/math/SignedMath.sol)

pragma solidity ^0.8.20;

/**
 * @dev Standard signed math utilities missing in the Solidity language.
 */
library SignedMath {
    /**
     * @dev Returns the largest of two signed numbers.
     */
    function max(int256 a, int256 b) internal pure returns (int256) {
        return a > b ? a : b;
    }

    /**
     * @dev Returns the smallest of two signed numbers.
     */
    function min(int256 a, int256 b) internal pure returns (int256) {
        return a < b ? a : b;
    }

    /**
     * @dev Returns the average of two signed numbers without overflow.
     * The result is rounded towards zero.
     */
    function average(int256 a, int256 b) internal pure returns (int256) {
        // Formula from the book "Hacker's Delight"
        int256 x = (a & b) + ((a ^ b) >> 1);
        return x + (int256(uint256(x) >> 255) & (a ^ b));
    }

    /**
     * @dev Returns the absolute unsigned value of a signed value.
     */
    function abs(int256 n) internal pure returns (uint256) {
        unchecked {
            // must be unchecked in order to support `n = type(int256).min`
            return uint256(n >= 0 ? n : -n);
        }
    }
}

File 23 of 29 : Strings.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/Strings.sol)

pragma solidity ^0.8.20;

import {Math} from "./math/Math.sol";
import {SignedMath} from "./math/SignedMath.sol";

/**
 * @dev String operations.
 */
library Strings {
    bytes16 private constant HEX_DIGITS = "0123456789abcdef";
    uint8 private constant ADDRESS_LENGTH = 20;

    /**
     * @dev The `value` string doesn't fit in the specified `length`.
     */
    error StringsInsufficientHexLength(uint256 value, uint256 length);

    /**
     * @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), HEX_DIGITS))
                }
                value /= 10;
                if (value == 0) break;
            }
            return buffer;
        }
    }

    /**
     * @dev Converts a `int256` to its ASCII `string` decimal representation.
     */
    function toStringSigned(int256 value) internal pure returns (string memory) {
        return string.concat(value < 0 ? "-" : "", toString(SignedMath.abs(value)));
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
     */
    function toHexString(uint256 value) internal pure returns (string memory) {
        unchecked {
            return toHexString(value, Math.log256(value) + 1);
        }
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
     */
    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
        uint256 localValue = value;
        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] = HEX_DIGITS[localValue & 0xf];
            localValue >>= 4;
        }
        if (localValue != 0) {
            revert StringsInsufficientHexLength(value, length);
        }
        return string(buffer);
    }

    /**
     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal
     * representation.
     */
    function toHexString(address addr) internal pure returns (string memory) {
        return toHexString(uint256(uint160(addr)), ADDRESS_LENGTH);
    }

    /**
     * @dev Returns true if the two strings are equal.
     */
    function equal(string memory a, string memory b) internal pure returns (bool) {
        return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b));
    }
}

File 24 of 29 : LinkTokenInterface.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

interface LinkTokenInterface {
    function allowance(
        address owner,
        address spender
    ) external view returns (uint256 remaining);

    function approve(
        address spender,
        uint256 value
    ) external returns (bool success);

    function balanceOf(address owner) external view returns (uint256 balance);

    function decimals() external view returns (uint8 decimalPlaces);

    function decreaseApproval(
        address spender,
        uint256 addedValue
    ) external returns (bool success);

    function increaseApproval(
        address spender,
        uint256 subtractedValue
    ) external;

    function name() external view returns (string memory tokenName);

    function symbol() external view returns (string memory tokenSymbol);

    function totalSupply() external view returns (uint256 totalTokensIssued);

    function transfer(
        address to,
        uint256 value
    ) external returns (bool success);

    function transferAndCall(
        address to,
        uint256 value,
        bytes calldata data
    ) external returns (bool success);

    function transferFrom(
        address from,
        address to,
        uint256 value
    ) external returns (bool success);
}

File 25 of 29 : MissingOnez.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import '@openzeppelin/contracts/access/AccessControl.sol';
import '@openzeppelin/contracts/token/ERC721/extensions/ERC721Burnable.sol';
import '@openzeppelin/contracts/token/ERC721/extensions/ERC721Enumerable.sol';
import '@openzeppelin/contracts/token/common/ERC2981.sol';
import '@openzeppelin/contracts/utils/Strings.sol';

import './utils/RandomPoolId.sol';
import './utils/M1ZPrices.sol';
import './utils/Withdraw.sol';
import './utils/StringUtils.sol';

contract MissingOnez is RandomPoolId, M1ZPrices, Withdraw, ERC721, ERC721Burnable, ERC721Enumerable, ERC2981, AccessControl {
    using Strings for uint256;
    using StringUtils for string;

    event Minted(uint256 timestamp, address sender, uint256 tokenId);
    event Revealed(uint256 timestamp, address sender, uint256 tokenId, uint256 id);
    event AutoRevealed(uint256 timestamp, address sender, uint256 tokenId, uint256 id);
    event SentCrossChain(uint256 timestamp, address sender, uint256[] tokenIds, uint256 destChainId);
    event ReceivedCrossChain(uint256 timestamp, address sender, uint256[] tokenIds, uint256[] ids, uint256 fromChainId);

    bytes32 public constant CROSS_CHAIN_ROLE = keccak256('CROSS_CHAIN_ROLE');

    uint96 public constant MAX_BATCH_MINT = 10;
    uint96 public constant ROYALTIES_VALUE = 500;

    string public baseURI;
    address public royaltyRecipient;
    string public unrevealedPath;
    uint256 public currentSupply;

    // tokenId mapped to randomly assigned id
    mapping(uint256 => uint256) private _tokenIdMap;

    mapping(uint256 => bool) public revealedTokenIds;

    bool public isMintOpen;

    constructor(
        address initialOwner,
        address _royaltyRecipient,
        uint256 _unitPrice,
        uint256 mintMinId,
        uint256 mintMaxId,
        string memory _unrevealedPath
    ) RandomPoolId(mintMinId, mintMaxId) M1ZPrices(_unitPrice) Withdraw(initialOwner) ERC721('Missing Onez', 'M1Z') {
        baseURI = 'https://cdn.madskullz.io/missingonez/metadata/';
        royaltyRecipient = _royaltyRecipient;
        unrevealedPath = _unrevealedPath;
        _setDefaultRoyalty(_royaltyRecipient, ROYALTIES_VALUE);

        _grantRole(DEFAULT_ADMIN_ROLE, _msgSender());
        _grantRole(CROSS_CHAIN_ROLE, _msgSender());
    }

    //////////////////////////////////////////
    // MINT
    //////////////////////////////////////////

    /**
     * @dev CALLED BY CHAINLINK
     * Free-mint method.
     * This method should be called either:
     * - by the M1ZDestinationMinter contract when called by CCIP (eg: paid mint from another chain)
     * - by the CROSS_CHAIN_ROLE to free mint M1Z for giveaways
     * @param amount quantity of M1Z to mint.
     * @param to sender of the cross-chain call.
     */
    function mint(uint256 amount, address to) external onlyRole(CROSS_CHAIN_ROLE) {
        require(isMintOpen, 'M1Z: mint is not open');
        randomMint(amount, to);
    }

    /**
     * Normal paid mint method.
     * This is the method used when minting on the current chain.
     * @param amount quantity of M1Z to mint.
     */
    function paidMint(uint256 amount) external payable {
        require(isMintOpen, 'M1Z: mint is not open');
        uint256 price = getPrice(amount);

        require(msg.value >= price, 'M1Z: did not send enough native tokens');
        randomMint(amount, _msgSender());
    }

    function randomMint(uint256 amount, address to) internal {
        require(amount > 0, 'M1Z: must mint at least one');
        require(amount <= MAX_BATCH_MINT, 'M1Z: cannot mint more than MAX_BATCH_MINT at once');
        require(amount <= supplyLeft(), 'M1Z: not enough supply left to mint');

        for (uint256 i = 0; i < amount; i++) {
            uint256 tokenId = currentSupply + _minId;
            _safeMint(to, tokenId);
            currentSupply++;

            emit Minted(block.timestamp, _msgSender(), tokenId);
        }
    }

    /**
     * @dev CALLED BY CHAINLINK
     * Cross-chain transfer mint method.
     * This method should only be called by the M1ZDestinationMinter contract when called by CCIP.
     * It's only used when transfering an NFT from one chain to another.
     * @param to sender of the cross-chain call.
     */
    function mintFromCrossChainTransfer(
        uint256[] calldata tokenIds,
        uint256[] calldata ids,
        address to,
        uint256 fromChainId
    ) external onlyRole(CROSS_CHAIN_ROLE) {
        require(tokenIds.length == ids.length, 'M1Z: arrays lengths do not match');
        require(tokenIds.length > 0, 'M1Z: must transfer at least one');
        for (uint256 i = 0; i < tokenIds.length; i++) {
            _safeMint(to, tokenIds[i]);
            _tokenIdMap[tokenIds[i]] = ids[i];
            revealedTokenIds[tokenIds[i]] = true;
        }
        emit ReceivedCrossChain(block.timestamp, to, tokenIds, ids, fromChainId);
    }

    //////////////////////////////////////////
    // BURN
    //////////////////////////////////////////

    /**
     * @dev CALLED BY CHAINLINK
     */
    function burn(uint256 tokenId) public override(ERC721Burnable) onlyRole(CROSS_CHAIN_ROLE) {
        super.burn(tokenId);
    }

    //////////////////////////////////////////
    // REVEAL
    //////////////////////////////////////////

    function reveal(uint256 tokenId) external {
        _checkAuthorized(_ownerOf(tokenId), _msgSender(), tokenId);
        require(!revealedTokenIds[tokenId], 'M1Z: already revealed');

        uint256 id = _randomize();
        _tokenIdMap[tokenId] = id;
        revealedTokenIds[tokenId] = true;

        emit Revealed(block.timestamp, _msgSender(), tokenId, id);
    }

    function autoReveal(uint256 tokenId) external onlyOwner {
        require(!revealedTokenIds[tokenId], 'M1Z: already revealed');

        uint256 id = _randomize();
        _tokenIdMap[tokenId] = id;
        revealedTokenIds[tokenId] = true;

        emit AutoRevealed(block.timestamp, _msgSender(), tokenId, id);
    }

    //////////////////////////////////////////
    // GETTER
    //////////////////////////////////////////

    function _baseURI() internal view override returns (string memory) {
        return baseURI;
    }

    function tokenURI(uint256 tokenId) public view override returns (string memory) {
        _requireOwned(tokenId);

        if (revealedTokenIds[tokenId]) {
            return
                bytes(baseURI).length > 0
                    ? string(abi.encodePacked(baseURI, _tokenIdMap[tokenId].toString().padStart(4, '0'), '.json'))
                    : '';
        } else {
            return string(abi.encodePacked(baseURI, unrevealedPath));
        }
    }

    function supplyLeft() public view returns (uint256) {
        return maxSupply() - currentSupply;
    }

    //////////////////////////////////////////
    // SETTER
    //////////////////////////////////////////

    function setBaseUri(string calldata _baseUri) external onlyOwner {
        baseURI = _baseUri;
    }

    function setUnrevealedPath(string memory _unrevealedPath) external onlyOwner {
        unrevealedPath = _unrevealedPath;
    }

    function setRoyaltyRecipient(address _royaltyRecipient) external onlyOwner {
        royaltyRecipient = _royaltyRecipient;
        _setDefaultRoyalty(_royaltyRecipient, ROYALTIES_VALUE);
    }

    function setMintOpen(bool _isMintOpen) external onlyOwner {
        isMintOpen = _isMintOpen;
    }

    //////////////////////////////////////////
    // MANDATORY OVERRIDES
    //////////////////////////////////////////

    function _update(address to, uint256 tokenId, address auth) internal override(ERC721, ERC721Enumerable) returns (address) {
        return super._update(to, tokenId, auth);
    }

    function _increaseBalance(address account, uint128 value) internal override(ERC721, ERC721Enumerable) {
        super._increaseBalance(account, value);
    }

    // The following functions are overrides required by Solidity.
    function supportsInterface(bytes4 interfaceId) public view override(ERC2981, ERC721, ERC721Enumerable, AccessControl) returns (bool) {
        return super.supportsInterface(interfaceId);
    }
}

File 26 of 29 : M1ZPrices.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import '@openzeppelin/contracts/access/Ownable.sol';

abstract contract M1ZPrices is Ownable {
    enum PayFeesIn {
        Native,
        LINK
    }

    // Unit price for 1 M1Z
    uint256 public unitPrice;

    constructor(uint256 _unitPrice) {
        unitPrice = _unitPrice;
    }

    function getPrice(uint256 amount) public view returns (uint256 price) {
        price = amount * unitPrice;
        if (amount > 1) {
            price = (price * (100 - amount)) / 100;
        }
    }

    function setUnitPrice(uint256 _unitPrice) external onlyOwner {
        unitPrice = _unitPrice;
    }
}

File 27 of 29 : RandomPoolId.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {Context} from '@openzeppelin/contracts/utils/Context.sol';

abstract contract RandomPoolId is Context {
    // Minimum value of the ids range
    uint256 internal immutable _minId;
    // Maximum value of the ids range
    uint256 private immutable _maxId;
    // Size of the actual range of available ids
    uint256 internal _rangeLength;
    // TokenID cache for random id generation
    mapping(uint256 => uint256) private _swappedIds;

    constructor(uint256 minId, uint256 maxId) {
        _minId = minId;
        _maxId = maxId;
        _rangeLength = maxId - minId;
    }

    function _randomize() internal virtual returns (uint256) {
        require(_rangeLength > 0, 'Randomize: cannot pick another id as they where all picked already');
        uint256 randomIndex = _randomNumber(0, _rangeLength);
        uint256 id = _swappedIds[randomIndex];

        if (id == 0) {
            id = randomIndex;
        }

        // Swap last one with the picked one.
        // Last one can be a previously picked one as well, thats why we check.
        if (_swappedIds[_rangeLength - 1] == 0) {
            _swappedIds[randomIndex] = _rangeLength - 1;
        } else {
            _swappedIds[randomIndex] = _swappedIds[_rangeLength - 1];
        }
        _rangeLength--;

        return id + _minId;
    }

    /**
     * Function to generate a random number within a given range.
     * @param min min range for the random number.
     * @param max max range for the random number.
     */
    function _randomNumber(uint256 min, uint256 max) internal view virtual returns (uint256) {
        require(max >= min, 'RandomNumber: invalid range');
        uint256 randNumber = uint256(
            keccak256(abi.encodePacked(block.prevrandao, block.timestamp, _msgSender(), blockhash(block.number)))
        ) % (max - min + 1);
        return randNumber + min;
    }

    function maxSupply() public view returns (uint256) {
        return _maxId - _minId;
    }
}

File 28 of 29 : StringUtils.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.20;

/**
 * @dev String operations.
 */
library StringUtils {
    /**
     * @dev Pads on the left of a `string` as many `value` character as `amount` quantity.
     */
    function padStart(string memory baseString, uint256 amount, string memory value) internal pure returns (string memory) {
        for (uint256 i = bytes(baseString).length; i < amount; i++) {
            baseString = string(abi.encodePacked(value, baseString));
        }
        return baseString;
    }
}

File 29 of 29 : Withdraw.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import '@openzeppelin/contracts/access/Ownable.sol';
import '@openzeppelin/contracts/token/ERC20/IERC20.sol';
import '@openzeppelin/contracts/token/ERC721/IERC721.sol';
import '@openzeppelin/contracts/token/ERC721/extensions/IERC721Enumerable.sol';

abstract contract Withdraw is Ownable {
    error FailedToWithdrawEth(address owner, address target, uint256 value);

    constructor(address initialOwner) Ownable(initialOwner) {}

    function withdraw(address beneficiary) external onlyOwner {
        uint256 amount = address(this).balance;
        (bool sent, ) = beneficiary.call{value: amount}('');
        if (!sent) revert FailedToWithdrawEth(_msgSender(), beneficiary, amount);
    }

    function withdrawToken(address beneficiary, address token) external onlyOwner {
        uint256 amount = IERC20(token).balanceOf(address(this));
        IERC20(token).transfer(beneficiary, amount);
    }

    function withdrawERC721(address erc721) external onlyOwner {
        require(IERC721(erc721).balanceOf(address(this)) > 0, 'Withdraw: contract does not own any ERC721');
        IERC721(erc721).transferFrom(address(this), _msgSender(), IERC721Enumerable(erc721).tokenOfOwnerByIndex(address(this), 0));
    }
}

Settings
{
  "optimizer": {
    "enabled": true,
    "runs": 200
  },
  "evmVersion": "paris",
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "metadata": {
    "useLiteralContent": true
  },
  "libraries": {}
}

Contract Security Audit

Contract ABI

[{"inputs":[{"internalType":"address","name":"initialOwner","type":"address"},{"internalType":"address","name":"router","type":"address"},{"internalType":"address","name":"link","type":"address"},{"internalType":"uint256","name":"_unitPrice","type":"uint256"},{"internalType":"address","name":"m1zAddress","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"target","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"FailedToWithdrawEth","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bytes32","name":"messageId","type":"bytes32"}],"name":"MessageSent","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"},{"inputs":[{"internalType":"uint64","name":"","type":"uint64"}],"name":"allowedDestinations","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"canMintCrossChain","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"crossChainGasLimit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint64","name":"destinationChainSelector","type":"uint64"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"enum M1ZPrices.PayFeesIn","name":"payFeesIn","type":"uint8"}],"name":"getMintFee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"getPrice","outputs":[{"internalType":"uint256","name":"price","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint64","name":"destinationChainSelector","type":"uint64"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"enum M1ZPrices.PayFeesIn","name":"payFeesIn","type":"uint8"}],"name":"getTransferFee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"i_router","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"m1z","outputs":[{"internalType":"contract MissingOnez","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxBatch","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint64","name":"destinationChainSelector","type":"uint64"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"enum M1ZPrices.PayFeesIn","name":"payFeesIn","type":"uint8"}],"name":"mint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint64","name":"destinationChainSelector","type":"uint64"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"enum M1ZPrices.PayFeesIn","name":"payFeesIn","type":"uint8"}],"name":"sendToOtherChain","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint64[]","name":"_allowedDestinations","type":"uint64[]"},{"internalType":"bool","name":"isAllowed","type":"bool"}],"name":"setAllowedDestinations","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_canMintCrossChain","type":"bool"}],"name":"setCanMintCrossChain","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_crossChainGasLimit","type":"uint256"}],"name":"setCrossChainGasLimit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"m1zAddress","type":"address"}],"name":"setM1Z","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_maxBatch","type":"uint256"}],"name":"setMaxBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"router","type":"address"}],"name":"setRouter","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_unitPrice","type":"uint256"}],"name":"setUnitPrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unitPrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"beneficiary","type":"address"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"erc721","type":"address"}],"name":"withdrawERC721","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"beneficiary","type":"address"},{"internalType":"address","name":"token","type":"address"}],"name":"withdrawToken","outputs":[],"stateMutability":"nonpayable","type":"function"},{"stateMutability":"payable","type":"receive"}]

60a06040526005600355620f42406004553480156200001d57600080fd5b50604051620024383803806200243883398101604081905262000040916200012c565b8482816001600160a01b0381166200007257604051631e4fbdf760e01b81526000600482015260240160405180910390fd5b6200007d81620000bf565b5060015550600280546001600160a01b03199081166001600160a01b039687161790915592841660805260058054909316931692909217905550620001939050565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b80516001600160a01b03811681146200012757600080fd5b919050565b600080600080600060a086880312156200014557600080fd5b62000150866200010f565b945062000160602087016200010f565b935062000170604087016200010f565b92506060860151915062000187608087016200010f565b90509295509295909350565b608051612258620001e0600039600081816109a501528181610aa401528181610b5e01528181610e97015281816114b601528181611635015281816116ef0152611a5b01526122586000f3fe60806040526004361061016a5760003560e01c8063a2a23838116100d1578063db1058aa1161008a578063e757223011610064578063e757223014610418578063f2fde38b14610438578063f91c1b4014610458578063f9f3a0bd1461047857600080fd5b8063db1058aa146103c2578063dc1b7328146103e2578063e73faa2d1461040257600080fd5b8063a2a23838146102ff578063b51a2e271461031f578063c0d786551461034f578063d44dc29f1461036f578063d468044d1461038f578063da4b8fab146103a257600080fd5b806351cff8d91161012357806351cff8d914610234578063581bdd161461025457806367765b871461028c578063715018a6146102a257806389bcb3e8146102b75780638da5cb5b146102e157600080fd5b80630a9be41414610176578063300b23d81461019f5780633aeac4e1146101c157806341610db9146101e1578063432779f5146101f45780634f15ec211461021457600080fd5b3661017157005b600080fd5b34801561018257600080fd5b5061018c60045481565b6040519081526020015b60405180910390f35b3480156101ab57600080fd5b506101bf6101ba366004611c02565b610498565b005b3480156101cd57600080fd5b506101bf6101dc366004611c32565b6104a5565b6101bf6101ef366004611cd8565b610595565b34801561020057600080fd5b506101bf61020f366004611d88565b610d23565b34801561022057600080fd5b5061018c61022f366004611ddf565b610d9d565b34801561024057600080fd5b506101bf61024f366004611e2c565b610f67565b34801561026057600080fd5b50600254610274906001600160a01b031681565b6040516001600160a01b039091168152602001610196565b34801561029857600080fd5b5061018c60035481565b3480156102ae57600080fd5b506101bf611000565b3480156102c357600080fd5b506007546102d19060ff1681565b6040519015158152602001610196565b3480156102ed57600080fd5b506000546001600160a01b0316610274565b34801561030b57600080fd5b506101bf61031a366004611e2c565b611014565b34801561032b57600080fd5b506102d161033a366004611e4e565b60066020526000908152604090205460ff1681565b34801561035b57600080fd5b506101bf61036a366004611e2c565b61103e565b34801561037b57600080fd5b506101bf61038a366004611e2c565b611068565b6101bf61039d366004611ddf565b611225565b3480156103ae57600080fd5b50600554610274906001600160a01b031681565b3480156103ce57600080fd5b506101bf6103dd366004611e69565b6118bb565b3480156103ee57600080fd5b506101bf6103fd366004611c02565b6118d6565b34801561040e57600080fd5b5061018c60015481565b34801561042457600080fd5b5061018c610433366004611c02565b6118e3565b34801561044457600080fd5b506101bf610453366004611e2c565b611926565b34801561046457600080fd5b5061018c610473366004611cd8565b611964565b34801561048457600080fd5b506101bf610493366004611c02565b611b2e565b6104a0611b3b565b600355565b6104ad611b3b565b6040516370a0823160e01b81523060048201526000906001600160a01b038316906370a0823190602401602060405180830381865afa1580156104f4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105189190611e86565b60405163a9059cbb60e01b81526001600160a01b038581166004830152602482018390529192509083169063a9059cbb906044016020604051808303816000875af115801561056b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061058f9190611e9f565b50505050565b67ffffffffffffffff831660009081526006602052604090205460ff166105d75760405162461bcd60e51b81526004016105ce90611ebc565b60405180910390fd5b85841461063b5760405162461bcd60e51b815260206004820152602c60248201527f4d315a536f7572636553656e6465723a20617272617973206c656e677468732060448201526b0c8de40dcdee840dac2e8c6d60a31b60648201526084016105ce565b8561069a5760405162461bcd60e51b815260206004820152602960248201527f4d315a536f7572636553656e6465723a206d7573742073656e64206174206c6560448201526830b9ba1018902698ad60b91b60648201526084016105ce565b6003548611156107125760405162461bcd60e51b815260206004820152603b60248201527f4d315a536f7572636553656e6465723a2063616e6e6f74207472616e7366657260448201527f206d6f7265207468616e206d61784261746368206174206f6e6365000000000060648201526084016105ce565b60005b868110156108af576005546001600160a01b031663e04813e289898481811061074057610740611f0d565b905060200201356040518263ffffffff1660e01b815260040161076591815260200190565b602060405180830381865afa158015610782573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107a69190611e9f565b6108225760405162461bcd60e51b815260206004820152604160248201527f4d315a536f7572636553656e6465723a2063616e6e6f74207472616e7366657260448201527f20746f20616e6f7468657220636861696e206966206e6f742072657665616c656064820152601960fa1b608482015260a4016105ce565b6005546001600160a01b03166342966c6889898481811061084557610845611f0d565b905060200201356040518263ffffffff1660e01b815260040161086a91815260200190565b600060405180830381600087803b15801561088457600080fd5b505af1158015610898573d6000803e3d6000fd5b5050505080806108a790611f39565b915050610715565b506040805160a081019091526001600160a01b03831660c08201526000908060e081016040516020818303038152906040528152602001898989896108f13390565b4660405160240161090796959493929190611f84565b60408051601f19818403018152919052602080820180516001600160e01b03166346e90c4b60e11b17905290825201600060405190808252806020026020018201604052801561097d57816020015b60408051808201909152600080825260208201528152602001906001900390816109565790505b508152602001600184600181111561099757610997611fca565b146109a35760006109c5565b7f00000000000000000000000000000000000000000000000000000000000000005b6001600160a01b031681526020016109f56040518060400160405280600454815260200160001515815250611b68565b90526002546040516320487ded60e01b81529192506000916001600160a01b03909116906320487ded90610a2f9088908690600401612026565b602060405180830381865afa158015610a4c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a709190611e86565b905060006001846001811115610a8857610a88611fca565b03610c4a576040516370a0823160e01b815230600482015282907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a0823190602401602060405180830381865afa158015610af3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b179190611e86565b1015610b355760405162461bcd60e51b81526004016105ce90612100565b60025460405163095ea7b360e01b81526001600160a01b039182166004820152602481018490527f00000000000000000000000000000000000000000000000000000000000000009091169063095ea7b3906044016020604051808303816000875af1158015610ba9573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bcd9190611e9f565b506002546040516396f4e9f960e01b81526001600160a01b03909116906396f4e9f990610c009089908790600401612026565b6020604051808303816000875af1158015610c1f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c439190611e86565b9050610ce4565b81341015610c6a5760405162461bcd60e51b81526004016105ce90612153565b6002546040516396f4e9f960e01b81526001600160a01b03909116906396f4e9f9908490610c9e908a908890600401612026565b60206040518083038185885af1158015610cbc573d6000803e3d6000fd5b50505050506040513d601f19601f82011682018060405250810190610ce19190611e86565b90505b6040518181527f54791b38f3859327992a1ca0590ad3c0f08feba98d1a4f56ab0dca74d203392a9060200160405180910390a150505050505050505050565b610d2b611b3b565b60005b8281101561058f578160066000868685818110610d4d57610d4d611f0d565b9050602002016020810190610d629190611e4e565b67ffffffffffffffff1681526020810191909152604001600020805460ff191691151591909117905580610d9581611f39565b915050610d2e565b6040805160a081019091526001600160a01b03831660c082015260009081908060e08101604051602081830303815290604052815260200187610ddd3390565b60405160248101929092526001600160a01b0316604482015260640160408051601f19818403018152919052602080820180516001600160e01b03166394bf804d60e01b179052908252016000604051908082528060200260200182016040528015610e6f57816020015b6040805180820190915260008082526020820152815260200190600190039081610e485790505b5081526020016001856001811115610e8957610e89611fca565b14610e95576000610eb7565b7f00000000000000000000000000000000000000000000000000000000000000005b6001600160a01b03168152602001610ee76040518060400160405280600454815260200160001515815250611b68565b90526002546040516320487ded60e01b81529192506001600160a01b0316906320487ded90610f1c9088908590600401612026565b602060405180830381865afa158015610f39573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f5d9190611e86565b9695505050505050565b610f6f611b3b565b60405147906000906001600160a01b0384169083908381818185875af1925050503d8060008114610fbc576040519150601f19603f3d011682016040523d82523d6000602084013e610fc1565b606091505b5050905080610ffb57604051639d11f56360e01b81523360048201526001600160a01b0384166024820152604481018390526064016105ce565b505050565b611008611b3b565b6110126000611bb2565b565b61101c611b3b565b600580546001600160a01b0319166001600160a01b0392909216919091179055565b611046611b3b565b600280546001600160a01b0319166001600160a01b0392909216919091179055565b611070611b3b565b6040516370a0823160e01b81523060048201526000906001600160a01b038316906370a0823190602401602060405180830381865afa1580156110b7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110db9190611e86565b1161113b5760405162461bcd60e51b815260206004820152602a60248201527f57697468647261773a20636f6e747261637420646f6573206e6f74206f776e20604482015269616e792045524337323160b01b60648201526084016105ce565b6001600160a01b0381166323b872dd3033604051632f745c5960e01b8152306004820152600060248201526001600160a01b03861690632f745c5990604401602060405180830381865afa158015611197573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111bb9190611e86565b6040516001600160e01b031960e086901b1681526001600160a01b0393841660048201529290911660248301526044820152606401600060405180830381600087803b15801561120a57600080fd5b505af115801561121e573d6000803e3d6000fd5b5050505050565b67ffffffffffffffff831660009081526006602052604090205460ff1661125e5760405162461bcd60e51b81526004016105ce90611ebc565b60075460ff166112e65760405162461bcd60e51b815260206004820152604760248201527f4d315a536f7572636553656e6465723a206d696e74206973206e6f742070657260448201527f6d69747465642066726f6d207468697320636861696e20746f20616e6f746865606482015266391031b430b4b760c91b608482015260a4016105ce565b600084116113465760405162461bcd60e51b815260206004820152602760248201527f4d315a536f7572636553656e6465723a206d757374206d696e74206174206c65604482015266617374206f6e6560c81b60648201526084016105ce565b6003548411156113be5760405162461bcd60e51b815260206004820152603760248201527f4d315a536f7572636553656e6465723a2063616e6e6f74206d696e74206d6f7260448201527f65207468616e206d61784261746368206174206f6e636500000000000000000060648201526084016105ce565b6040805160a081019091526001600160a01b03831660c08201526000908060e081016040516020818303038152906040528152602001866113fc3390565b60405160248101929092526001600160a01b0316604482015260640160408051601f19818403018152919052602080820180516001600160e01b03166394bf804d60e01b17905290825201600060405190808252806020026020018201604052801561148e57816020015b60408051808201909152600080825260208201528152602001906001900390816114675790505b50815260200160018460018111156114a8576114a8611fca565b146114b45760006114d6565b7f00000000000000000000000000000000000000000000000000000000000000005b6001600160a01b031681526020016115066040518060400160405280600454815260200160001515815250611b68565b905290506000611515866118e3565b90508034101561158d5760405162461bcd60e51b815260206004820152603960248201527f4d315a536f7572636553656e6465723a20646964206e6f742073656e6420656e60448201527f6f756768206e617469766520746f6b656e7320746f207061790000000000000060648201526084016105ce565b6002546040516320487ded60e01b81526000916001600160a01b0316906320487ded906115c09089908790600401612026565b602060405180830381865afa1580156115dd573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116019190611e86565b90506000600185600181111561161957611619611fca565b036117db576040516370a0823160e01b815230600482015282907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a0823190602401602060405180830381865afa158015611684573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116a89190611e86565b10156116c65760405162461bcd60e51b81526004016105ce90612100565b60025460405163095ea7b360e01b81526001600160a01b039182166004820152602481018490527f00000000000000000000000000000000000000000000000000000000000000009091169063095ea7b3906044016020604051808303816000875af115801561173a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061175e9190611e9f565b506002546040516396f4e9f960e01b81526001600160a01b03909116906396f4e9f990611791908a908890600401612026565b6020604051808303816000875af11580156117b0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906117d49190611e86565b905061187e565b6117e582846121bd565b3410156118045760405162461bcd60e51b81526004016105ce90612153565b6002546040516396f4e9f960e01b81526001600160a01b03909116906396f4e9f9908490611838908b908990600401612026565b60206040518083038185885af1158015611856573d6000803e3d6000fd5b50505050506040513d601f19601f8201168201806040525081019061187b9190611e86565b90505b6040518181527f54791b38f3859327992a1ca0590ad3c0f08feba98d1a4f56ab0dca74d203392a9060200160405180910390a15050505050505050565b6118c3611b3b565b6007805460ff1916911515919091179055565b6118de611b3b565b600155565b6000600154826118f391906121d6565b9050600182111561192157606461190a83826121ed565b61191490836121d6565b61191e9190612200565b90505b919050565b61192e611b3b565b6001600160a01b03811661195857604051631e4fbdf760e01b8152600060048201526024016105ce565b61196181611bb2565b50565b6040805160a081019091526001600160a01b03831660c082015260009081908060e0810160405160208183030381529060405281526020018a8a8a8a6119a73390565b466040516024016119bd96959493929190611f84565b60408051601f19818403018152919052602080820180516001600160e01b03166346e90c4b60e11b179052908252016000604051908082528060200260200182016040528015611a3357816020015b6040805180820190915260008082526020820152815260200190600190039081611a0c5790505b5081526020016001856001811115611a4d57611a4d611fca565b14611a59576000611a7b565b7f00000000000000000000000000000000000000000000000000000000000000005b6001600160a01b03168152602001611aab6040518060400160405280600454815260200160001515815250611b68565b90526002546040516320487ded60e01b81529192506001600160a01b0316906320487ded90611ae09088908590600401612026565b602060405180830381865afa158015611afd573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b219190611e86565b9998505050505050505050565b611b36611b3b565b600455565b6000546001600160a01b031633146110125760405163118cdaa760e01b81523360048201526024016105ce565b6040805182516024820152602092830151151560448083019190915282518083039091018152606490910190915290810180516001600160e01b03166397a657c960e01b17905290565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b600060208284031215611c1457600080fd5b5035919050565b80356001600160a01b038116811461192157600080fd5b60008060408385031215611c4557600080fd5b611c4e83611c1b565b9150611c5c60208401611c1b565b90509250929050565b60008083601f840112611c7757600080fd5b50813567ffffffffffffffff811115611c8f57600080fd5b6020830191508360208260051b8501011115611caa57600080fd5b9250929050565b803567ffffffffffffffff8116811461192157600080fd5b80356002811061192157600080fd5b600080600080600080600060a0888a031215611cf357600080fd5b873567ffffffffffffffff80821115611d0b57600080fd5b611d178b838c01611c65565b909950975060208a0135915080821115611d3057600080fd5b50611d3d8a828b01611c65565b9096509450611d50905060408901611cb1565b9250611d5e60608901611c1b565b9150611d6c60808901611cc9565b905092959891949750929550565b801515811461196157600080fd5b600080600060408486031215611d9d57600080fd5b833567ffffffffffffffff811115611db457600080fd5b611dc086828701611c65565b9094509250506020840135611dd481611d7a565b809150509250925092565b60008060008060808587031215611df557600080fd5b84359350611e0560208601611cb1565b9250611e1360408601611c1b565b9150611e2160608601611cc9565b905092959194509250565b600060208284031215611e3e57600080fd5b611e4782611c1b565b9392505050565b600060208284031215611e6057600080fd5b611e4782611cb1565b600060208284031215611e7b57600080fd5b8135611e4781611d7a565b600060208284031215611e9857600080fd5b5051919050565b600060208284031215611eb157600080fd5b8151611e4781611d7a565b60208082526031908201527f4d315a536f7572636553656e6465723a2064657374696e6174696f6e206368616040820152701a5b881a5cc81b9bdd08185b1b1bddd959607a1b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b600060018201611f4b57611f4b611f23565b5060010190565b81835260006001600160fb1b03831115611f6b57600080fd5b8260051b80836020870137939093016020019392505050565b608081526000611f9860808301888a611f52565b8281036020840152611fab818789611f52565b6001600160a01b03959095166040840152505060600152949350505050565b634e487b7160e01b600052602160045260246000fd5b6000815180845260005b8181101561200657602081850181015186830182015201611fea565b506000602082860101526020601f19601f83011685010191505092915050565b6000604067ffffffffffffffff8516835260208181850152845160a08386015261205360e0860182611fe0565b905081860151603f19808784030160608801526120708383611fe0565b88860151888203830160808a01528051808352908601945060009350908501905b808410156120c357845180516001600160a01b0316835286015186830152938501936001939093019290860190612091565b5060608901516001600160a01b031660a08901526080890151888203830160c08a015295506120f28187611fe0565b9a9950505050505050505050565b60208082526033908201527f4d315a536f7572636553656e6465723a20636f6e747261637420646f6573206e6040820152726f74206861766520656e6f756768204c494e4b60681b606082015260800190565b60208082526044908201527f4d315a536f7572636553656e6465723a20646964206e6f742073656e6420656e60408201527f6f756768206e617469766520746f6b656e7320746f20636f76657220746865206060820152636665657360e01b608082015260a00190565b808201808211156121d0576121d0611f23565b92915050565b80820281158282048414176121d0576121d0611f23565b818103818111156121d0576121d0611f23565b60008261221d57634e487b7160e01b600052601260045260246000fd5b50049056fea2646970667358221220f13ba7299c9ddae494298b9bfce7b039006f43e970bcfa3f1b18401c01b31ea064736f6c6343000814003300000000000000000000000000058e802800f23319e166bc3fa0003d5ab6a055000000000000000000000000e561d5e02207fb5eb32cca20a699e0d8919a1476000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca00000000000000000000000000000000000000000000003627e8f712373c00000000000000000000000000002f23357ce83cb17c5b0f78ccd18330858bc3ca6f

Deployed Bytecode

0x60806040526004361061016a5760003560e01c8063a2a23838116100d1578063db1058aa1161008a578063e757223011610064578063e757223014610418578063f2fde38b14610438578063f91c1b4014610458578063f9f3a0bd1461047857600080fd5b8063db1058aa146103c2578063dc1b7328146103e2578063e73faa2d1461040257600080fd5b8063a2a23838146102ff578063b51a2e271461031f578063c0d786551461034f578063d44dc29f1461036f578063d468044d1461038f578063da4b8fab146103a257600080fd5b806351cff8d91161012357806351cff8d914610234578063581bdd161461025457806367765b871461028c578063715018a6146102a257806389bcb3e8146102b75780638da5cb5b146102e157600080fd5b80630a9be41414610176578063300b23d81461019f5780633aeac4e1146101c157806341610db9146101e1578063432779f5146101f45780634f15ec211461021457600080fd5b3661017157005b600080fd5b34801561018257600080fd5b5061018c60045481565b6040519081526020015b60405180910390f35b3480156101ab57600080fd5b506101bf6101ba366004611c02565b610498565b005b3480156101cd57600080fd5b506101bf6101dc366004611c32565b6104a5565b6101bf6101ef366004611cd8565b610595565b34801561020057600080fd5b506101bf61020f366004611d88565b610d23565b34801561022057600080fd5b5061018c61022f366004611ddf565b610d9d565b34801561024057600080fd5b506101bf61024f366004611e2c565b610f67565b34801561026057600080fd5b50600254610274906001600160a01b031681565b6040516001600160a01b039091168152602001610196565b34801561029857600080fd5b5061018c60035481565b3480156102ae57600080fd5b506101bf611000565b3480156102c357600080fd5b506007546102d19060ff1681565b6040519015158152602001610196565b3480156102ed57600080fd5b506000546001600160a01b0316610274565b34801561030b57600080fd5b506101bf61031a366004611e2c565b611014565b34801561032b57600080fd5b506102d161033a366004611e4e565b60066020526000908152604090205460ff1681565b34801561035b57600080fd5b506101bf61036a366004611e2c565b61103e565b34801561037b57600080fd5b506101bf61038a366004611e2c565b611068565b6101bf61039d366004611ddf565b611225565b3480156103ae57600080fd5b50600554610274906001600160a01b031681565b3480156103ce57600080fd5b506101bf6103dd366004611e69565b6118bb565b3480156103ee57600080fd5b506101bf6103fd366004611c02565b6118d6565b34801561040e57600080fd5b5061018c60015481565b34801561042457600080fd5b5061018c610433366004611c02565b6118e3565b34801561044457600080fd5b506101bf610453366004611e2c565b611926565b34801561046457600080fd5b5061018c610473366004611cd8565b611964565b34801561048457600080fd5b506101bf610493366004611c02565b611b2e565b6104a0611b3b565b600355565b6104ad611b3b565b6040516370a0823160e01b81523060048201526000906001600160a01b038316906370a0823190602401602060405180830381865afa1580156104f4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105189190611e86565b60405163a9059cbb60e01b81526001600160a01b038581166004830152602482018390529192509083169063a9059cbb906044016020604051808303816000875af115801561056b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061058f9190611e9f565b50505050565b67ffffffffffffffff831660009081526006602052604090205460ff166105d75760405162461bcd60e51b81526004016105ce90611ebc565b60405180910390fd5b85841461063b5760405162461bcd60e51b815260206004820152602c60248201527f4d315a536f7572636553656e6465723a20617272617973206c656e677468732060448201526b0c8de40dcdee840dac2e8c6d60a31b60648201526084016105ce565b8561069a5760405162461bcd60e51b815260206004820152602960248201527f4d315a536f7572636553656e6465723a206d7573742073656e64206174206c6560448201526830b9ba1018902698ad60b91b60648201526084016105ce565b6003548611156107125760405162461bcd60e51b815260206004820152603b60248201527f4d315a536f7572636553656e6465723a2063616e6e6f74207472616e7366657260448201527f206d6f7265207468616e206d61784261746368206174206f6e6365000000000060648201526084016105ce565b60005b868110156108af576005546001600160a01b031663e04813e289898481811061074057610740611f0d565b905060200201356040518263ffffffff1660e01b815260040161076591815260200190565b602060405180830381865afa158015610782573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107a69190611e9f565b6108225760405162461bcd60e51b815260206004820152604160248201527f4d315a536f7572636553656e6465723a2063616e6e6f74207472616e7366657260448201527f20746f20616e6f7468657220636861696e206966206e6f742072657665616c656064820152601960fa1b608482015260a4016105ce565b6005546001600160a01b03166342966c6889898481811061084557610845611f0d565b905060200201356040518263ffffffff1660e01b815260040161086a91815260200190565b600060405180830381600087803b15801561088457600080fd5b505af1158015610898573d6000803e3d6000fd5b5050505080806108a790611f39565b915050610715565b506040805160a081019091526001600160a01b03831660c08201526000908060e081016040516020818303038152906040528152602001898989896108f13390565b4660405160240161090796959493929190611f84565b60408051601f19818403018152919052602080820180516001600160e01b03166346e90c4b60e11b17905290825201600060405190808252806020026020018201604052801561097d57816020015b60408051808201909152600080825260208201528152602001906001900390816109565790505b508152602001600184600181111561099757610997611fca565b146109a35760006109c5565b7f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca5b6001600160a01b031681526020016109f56040518060400160405280600454815260200160001515815250611b68565b90526002546040516320487ded60e01b81529192506000916001600160a01b03909116906320487ded90610a2f9088908690600401612026565b602060405180830381865afa158015610a4c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a709190611e86565b905060006001846001811115610a8857610a88611fca565b03610c4a576040516370a0823160e01b815230600482015282907f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca6001600160a01b0316906370a0823190602401602060405180830381865afa158015610af3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b179190611e86565b1015610b355760405162461bcd60e51b81526004016105ce90612100565b60025460405163095ea7b360e01b81526001600160a01b039182166004820152602481018490527f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca9091169063095ea7b3906044016020604051808303816000875af1158015610ba9573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bcd9190611e9f565b506002546040516396f4e9f960e01b81526001600160a01b03909116906396f4e9f990610c009089908790600401612026565b6020604051808303816000875af1158015610c1f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c439190611e86565b9050610ce4565b81341015610c6a5760405162461bcd60e51b81526004016105ce90612153565b6002546040516396f4e9f960e01b81526001600160a01b03909116906396f4e9f9908490610c9e908a908890600401612026565b60206040518083038185885af1158015610cbc573d6000803e3d6000fd5b50505050506040513d601f19601f82011682018060405250810190610ce19190611e86565b90505b6040518181527f54791b38f3859327992a1ca0590ad3c0f08feba98d1a4f56ab0dca74d203392a9060200160405180910390a150505050505050505050565b610d2b611b3b565b60005b8281101561058f578160066000868685818110610d4d57610d4d611f0d565b9050602002016020810190610d629190611e4e565b67ffffffffffffffff1681526020810191909152604001600020805460ff191691151591909117905580610d9581611f39565b915050610d2e565b6040805160a081019091526001600160a01b03831660c082015260009081908060e08101604051602081830303815290604052815260200187610ddd3390565b60405160248101929092526001600160a01b0316604482015260640160408051601f19818403018152919052602080820180516001600160e01b03166394bf804d60e01b179052908252016000604051908082528060200260200182016040528015610e6f57816020015b6040805180820190915260008082526020820152815260200190600190039081610e485790505b5081526020016001856001811115610e8957610e89611fca565b14610e95576000610eb7565b7f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca5b6001600160a01b03168152602001610ee76040518060400160405280600454815260200160001515815250611b68565b90526002546040516320487ded60e01b81529192506001600160a01b0316906320487ded90610f1c9088908590600401612026565b602060405180830381865afa158015610f39573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f5d9190611e86565b9695505050505050565b610f6f611b3b565b60405147906000906001600160a01b0384169083908381818185875af1925050503d8060008114610fbc576040519150601f19603f3d011682016040523d82523d6000602084013e610fc1565b606091505b5050905080610ffb57604051639d11f56360e01b81523360048201526001600160a01b0384166024820152604481018390526064016105ce565b505050565b611008611b3b565b6110126000611bb2565b565b61101c611b3b565b600580546001600160a01b0319166001600160a01b0392909216919091179055565b611046611b3b565b600280546001600160a01b0319166001600160a01b0392909216919091179055565b611070611b3b565b6040516370a0823160e01b81523060048201526000906001600160a01b038316906370a0823190602401602060405180830381865afa1580156110b7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110db9190611e86565b1161113b5760405162461bcd60e51b815260206004820152602a60248201527f57697468647261773a20636f6e747261637420646f6573206e6f74206f776e20604482015269616e792045524337323160b01b60648201526084016105ce565b6001600160a01b0381166323b872dd3033604051632f745c5960e01b8152306004820152600060248201526001600160a01b03861690632f745c5990604401602060405180830381865afa158015611197573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111bb9190611e86565b6040516001600160e01b031960e086901b1681526001600160a01b0393841660048201529290911660248301526044820152606401600060405180830381600087803b15801561120a57600080fd5b505af115801561121e573d6000803e3d6000fd5b5050505050565b67ffffffffffffffff831660009081526006602052604090205460ff1661125e5760405162461bcd60e51b81526004016105ce90611ebc565b60075460ff166112e65760405162461bcd60e51b815260206004820152604760248201527f4d315a536f7572636553656e6465723a206d696e74206973206e6f742070657260448201527f6d69747465642066726f6d207468697320636861696e20746f20616e6f746865606482015266391031b430b4b760c91b608482015260a4016105ce565b600084116113465760405162461bcd60e51b815260206004820152602760248201527f4d315a536f7572636553656e6465723a206d757374206d696e74206174206c65604482015266617374206f6e6560c81b60648201526084016105ce565b6003548411156113be5760405162461bcd60e51b815260206004820152603760248201527f4d315a536f7572636553656e6465723a2063616e6e6f74206d696e74206d6f7260448201527f65207468616e206d61784261746368206174206f6e636500000000000000000060648201526084016105ce565b6040805160a081019091526001600160a01b03831660c08201526000908060e081016040516020818303038152906040528152602001866113fc3390565b60405160248101929092526001600160a01b0316604482015260640160408051601f19818403018152919052602080820180516001600160e01b03166394bf804d60e01b17905290825201600060405190808252806020026020018201604052801561148e57816020015b60408051808201909152600080825260208201528152602001906001900390816114675790505b50815260200160018460018111156114a8576114a8611fca565b146114b45760006114d6565b7f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca5b6001600160a01b031681526020016115066040518060400160405280600454815260200160001515815250611b68565b905290506000611515866118e3565b90508034101561158d5760405162461bcd60e51b815260206004820152603960248201527f4d315a536f7572636553656e6465723a20646964206e6f742073656e6420656e60448201527f6f756768206e617469766520746f6b656e7320746f207061790000000000000060648201526084016105ce565b6002546040516320487ded60e01b81526000916001600160a01b0316906320487ded906115c09089908790600401612026565b602060405180830381865afa1580156115dd573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116019190611e86565b90506000600185600181111561161957611619611fca565b036117db576040516370a0823160e01b815230600482015282907f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca6001600160a01b0316906370a0823190602401602060405180830381865afa158015611684573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116a89190611e86565b10156116c65760405162461bcd60e51b81526004016105ce90612100565b60025460405163095ea7b360e01b81526001600160a01b039182166004820152602481018490527f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca9091169063095ea7b3906044016020604051808303816000875af115801561173a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061175e9190611e9f565b506002546040516396f4e9f960e01b81526001600160a01b03909116906396f4e9f990611791908a908890600401612026565b6020604051808303816000875af11580156117b0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906117d49190611e86565b905061187e565b6117e582846121bd565b3410156118045760405162461bcd60e51b81526004016105ce90612153565b6002546040516396f4e9f960e01b81526001600160a01b03909116906396f4e9f9908490611838908b908990600401612026565b60206040518083038185885af1158015611856573d6000803e3d6000fd5b50505050506040513d601f19601f8201168201806040525081019061187b9190611e86565b90505b6040518181527f54791b38f3859327992a1ca0590ad3c0f08feba98d1a4f56ab0dca74d203392a9060200160405180910390a15050505050505050565b6118c3611b3b565b6007805460ff1916911515919091179055565b6118de611b3b565b600155565b6000600154826118f391906121d6565b9050600182111561192157606461190a83826121ed565b61191490836121d6565b61191e9190612200565b90505b919050565b61192e611b3b565b6001600160a01b03811661195857604051631e4fbdf760e01b8152600060048201526024016105ce565b61196181611bb2565b50565b6040805160a081019091526001600160a01b03831660c082015260009081908060e0810160405160208183030381529060405281526020018a8a8a8a6119a73390565b466040516024016119bd96959493929190611f84565b60408051601f19818403018152919052602080820180516001600160e01b03166346e90c4b60e11b179052908252016000604051908082528060200260200182016040528015611a3357816020015b6040805180820190915260008082526020820152815260200190600190039081611a0c5790505b5081526020016001856001811115611a4d57611a4d611fca565b14611a59576000611a7b565b7f000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca5b6001600160a01b03168152602001611aab6040518060400160405280600454815260200160001515815250611b68565b90526002546040516320487ded60e01b81529192506001600160a01b0316906320487ded90611ae09088908590600401612026565b602060405180830381865afa158015611afd573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b219190611e86565b9998505050505050505050565b611b36611b3b565b600455565b6000546001600160a01b031633146110125760405163118cdaa760e01b81523360048201526024016105ce565b6040805182516024820152602092830151151560448083019190915282518083039091018152606490910190915290810180516001600160e01b03166397a657c960e01b17905290565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b600060208284031215611c1457600080fd5b5035919050565b80356001600160a01b038116811461192157600080fd5b60008060408385031215611c4557600080fd5b611c4e83611c1b565b9150611c5c60208401611c1b565b90509250929050565b60008083601f840112611c7757600080fd5b50813567ffffffffffffffff811115611c8f57600080fd5b6020830191508360208260051b8501011115611caa57600080fd5b9250929050565b803567ffffffffffffffff8116811461192157600080fd5b80356002811061192157600080fd5b600080600080600080600060a0888a031215611cf357600080fd5b873567ffffffffffffffff80821115611d0b57600080fd5b611d178b838c01611c65565b909950975060208a0135915080821115611d3057600080fd5b50611d3d8a828b01611c65565b9096509450611d50905060408901611cb1565b9250611d5e60608901611c1b565b9150611d6c60808901611cc9565b905092959891949750929550565b801515811461196157600080fd5b600080600060408486031215611d9d57600080fd5b833567ffffffffffffffff811115611db457600080fd5b611dc086828701611c65565b9094509250506020840135611dd481611d7a565b809150509250925092565b60008060008060808587031215611df557600080fd5b84359350611e0560208601611cb1565b9250611e1360408601611c1b565b9150611e2160608601611cc9565b905092959194509250565b600060208284031215611e3e57600080fd5b611e4782611c1b565b9392505050565b600060208284031215611e6057600080fd5b611e4782611cb1565b600060208284031215611e7b57600080fd5b8135611e4781611d7a565b600060208284031215611e9857600080fd5b5051919050565b600060208284031215611eb157600080fd5b8151611e4781611d7a565b60208082526031908201527f4d315a536f7572636553656e6465723a2064657374696e6174696f6e206368616040820152701a5b881a5cc81b9bdd08185b1b1bddd959607a1b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b600060018201611f4b57611f4b611f23565b5060010190565b81835260006001600160fb1b03831115611f6b57600080fd5b8260051b80836020870137939093016020019392505050565b608081526000611f9860808301888a611f52565b8281036020840152611fab818789611f52565b6001600160a01b03959095166040840152505060600152949350505050565b634e487b7160e01b600052602160045260246000fd5b6000815180845260005b8181101561200657602081850181015186830182015201611fea565b506000602082860101526020601f19601f83011685010191505092915050565b6000604067ffffffffffffffff8516835260208181850152845160a08386015261205360e0860182611fe0565b905081860151603f19808784030160608801526120708383611fe0565b88860151888203830160808a01528051808352908601945060009350908501905b808410156120c357845180516001600160a01b0316835286015186830152938501936001939093019290860190612091565b5060608901516001600160a01b031660a08901526080890151888203830160c08a015295506120f28187611fe0565b9a9950505050505050505050565b60208082526033908201527f4d315a536f7572636553656e6465723a20636f6e747261637420646f6573206e6040820152726f74206861766520656e6f756768204c494e4b60681b606082015260800190565b60208082526044908201527f4d315a536f7572636553656e6465723a20646964206e6f742073656e6420656e60408201527f6f756768206e617469766520746f6b656e7320746f20636f76657220746865206060820152636665657360e01b608082015260a00190565b808201808211156121d0576121d0611f23565b92915050565b80820281158282048414176121d0576121d0611f23565b818103818111156121d0576121d0611f23565b60008261221d57634e487b7160e01b600052601260045260246000fd5b50049056fea2646970667358221220f13ba7299c9ddae494298b9bfce7b039006f43e970bcfa3f1b18401c01b31ea064736f6c63430008140033

Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)

00000000000000000000000000058e802800f23319e166bc3fa0003d5ab6a055000000000000000000000000e561d5e02207fb5eb32cca20a699e0d8919a1476000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca00000000000000000000000000000000000000000000003627e8f712373c00000000000000000000000000002f23357ce83cb17c5b0f78ccd18330858bc3ca6f

-----Decoded View---------------
Arg [0] : initialOwner (address): 0x00058e802800f23319E166Bc3Fa0003D5Ab6a055
Arg [1] : router (address): 0xE561d5E02207fb5eB32cca20a699E0d8919a1476
Arg [2] : link (address): 0x514910771AF9Ca656af840dff83E8264EcF986CA
Arg [3] : _unitPrice (uint256): 999000000000000000000
Arg [4] : m1zAddress (address): 0x2F23357ce83cb17C5B0F78CCD18330858BC3cA6f

-----Encoded View---------------
5 Constructor Arguments found :
Arg [0] : 00000000000000000000000000058e802800f23319e166bc3fa0003d5ab6a055
Arg [1] : 000000000000000000000000e561d5e02207fb5eb32cca20a699e0d8919a1476
Arg [2] : 000000000000000000000000514910771af9ca656af840dff83e8264ecf986ca
Arg [3] : 00000000000000000000000000000000000000000000003627e8f712373c0000
Arg [4] : 0000000000000000000000002f23357ce83cb17c5b0f78ccd18330858bc3ca6f


Block Transaction Difficulty Gas Used Reward
View All Blocks Produced

Block Uncle Number Difficulty Gas Used Reward
View All Uncles
Loading...
Loading
Loading...
Loading

Validator Index Block Amount
View All Withdrawals

Transaction Hash Block Value Eth2 PubKey Valid
View All Deposits
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.