Token

Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.25;

import "../lib/ERC1155P/contracts/ERC1155P.sol";
import "solady/src/auth/Ownable.sol";

contract EnsAuctionDrops is ERC1155P, Ownable {
    mapping(uint256 => string) private _tokenURIs;
    string private _contractURI;
    
    event ContractURIUpdated();
    
    error Soulbound();
    error InvalidArrayLengths();

    constructor() ERC1155P("EnsAuctionDrops", "EADROP") {
        _initializeOwner(msg.sender);
    }

    function contractURI() public view returns (string memory) {
        return _contractURI;
    }

    function uri(uint256 id) public view virtual override returns (string memory) {
        return _tokenURIs[id];
    }

    function airdrop(uint256 tokenId, address[] calldata recipients) external onlyOwner {
        for (uint256 i; i < recipients.length; ++i) {
            _mint(recipients[i], tokenId, 1, "");
        }
    }

    function mint(address to, uint256 id, uint256 amount) external virtual onlyOwner {
        _mint(to, id, amount, "");
    }

    function mintBatch(address to, uint256[] calldata ids, uint256[] calldata amounts) public onlyOwner {
        _mintBatch(to, ids, amounts, "");
    }

    function burn(address from, uint256 id, uint256 amount) external onlyOwner {
        _burn(from, id, amount);
    }

    function burnBatch(address from, uint256[] calldata ids, uint256[] calldata amounts) external onlyOwner {
        _burnBatch(from, ids, amounts);
    }

    function setURI(uint256 tokenId, string calldata tokenURI) external virtual onlyOwner {
        _tokenURIs[tokenId] = tokenURI;
        emit URI(uri(tokenId), tokenId);
    }

    function setContractURI(string calldata newURI) external onlyOwner {
        _contractURI = newURI;
        emit ContractURIUpdated();
    }

    function _beforeTokenTransfer(
        address operator,
        address from,
        address to,
        uint256 id,
        uint256 amount,
        bytes memory data
    ) internal virtual override {
        super._beforeTokenTransfer(operator, from, to, id, amount, data);

        if (from != address(0) && to != address(0)) {
            revert Soulbound();
        }
    }

    function _beforeBatchTokenTransfer(
        address operator,
        address from,
        address to,
        uint256[] calldata ids,
        uint256[] calldata amounts,
        bytes memory data
    ) internal virtual override {
        super._beforeBatchTokenTransfer(operator, from, to, ids, amounts, data);

        if (from != address(0) && to != address(0)) {
            revert Soulbound();
        }
    }
}

// SPDX-License-Identifier: MIT
// ERC721P Contracts v1.0.0
// Creator: 0xjustadev/0xth0mas
// Special thanks to those who provided early feedback and reviews:
//  - 0xQuit, emo.eth, Layerr,
//  - euphoric.eth, Gallwas, Rookmate
//  - and wagglefoot

pragma solidity >=0.8.17;

import "./IERC1155P.sol";

/**
 * @dev Interface of ERC1155 token receiver.
 */
interface ERC1155P__IERC1155Receiver {
    function onERC1155Received(
        address operator,
        address from,
        uint256 id,
        uint256 value,
        bytes calldata data
    ) external returns (bytes4);

    function onERC1155BatchReceived(
        address operator,
        address from,
        uint256[] calldata ids,
        uint256[] calldata values,
        bytes calldata data
    ) external returns (bytes4);
}

/**
 * @dev Interface for IERC1155MetadataURI.
 */

interface ERC1155P__IERC1155MetadataURI {
    /**
     * @dev Returns the URI for token type `id`.
     *
     * If the `\{id\}` substring is present in the URI, it must be replaced by
     * clients with the actual token type ID.
     */
    function uri(uint256 id) external view returns (string memory);
}

 /**
 * @title ERC721P
 *
 * @dev Implementation of the basic standard multi-token.
 * See https://eips.ethereum.org/EIPS/eip-1155 including the Metadata extension.
 * Optimized for lower gas for users collecting multiple tokens.
 *
 * Assumptions:
 * - An owner cannot have more than 2**16 - 1 of a single token
 * - The maximum token ID cannot exceed 2**100 - 1
 */
contract ERC1155P is IERC1155P, ERC1155P__IERC1155MetadataURI {

    /**
     * @dev MAX_ACCOUNT_TOKEN_BALANCE is 2^16-1 because token balances are
     *      are being packed into 16 bits within each bucket.
     */
    uint256 private constant MAX_ACCOUNT_TOKEN_BALANCE = 0xFFFF;

    /**
     * @dev MAX_TOKEN_ID is derived from custom storage pointer location for 
     *      account/token balance data. Wallet address is shifted 96 bits left
     *      and leaves 96 bits for bucket #'s. Each bucket holds 16 token balances
     *      2^96*16-1 = MAX_TOKEN_ID
     */
    uint256 private constant MAX_TOKEN_ID = 0xFFFFFFFFFFFFFFFFFFFFFFFFF;

    // The `TransferSingle` event signature is given by:
    // `keccak256(bytes("TransferSingle(address,address,address,uint256,uint256)"))`.
    bytes32 private constant _TRANSFER_SINGLE_EVENT_SIGNATURE =
        0xc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62;
    // The `TransferBatch` event signature is given by:
    // `keccak256(bytes("TransferBatch(address,address,address,uint256[],uint256[])"))`.
    bytes32 private constant _TRANSFER_BATCH_EVENT_SIGNATURE =
        0x4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb;
    // The `ApprovalForAll` event signature is given by:
    // `keccak256(bytes("ApprovalForAll(address,address,bool)"))`.
    bytes32 private constant _APPROVAL_FOR_ALL_EVENT_SIGNATURE =
        0x17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31;

    string public name; //collection name
    string public symbol; //collection symbol

    // Optional mapping for token URIs
    mapping(uint256 => string) private _tokenURIs;

    /**
     * @dev constructor initialization of name and symbol parameters
     * @param _name the name to display for the collection
     * @param _symbol the symbol for the token collection
     */
    constructor(string memory _name, string memory _symbol) {
        name = _name;
        symbol = _symbol;
    }

    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30000 gas.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        // The interface IDs are constants representing the first 4 bytes
        // of the XOR of all function selectors in the interface.
        // See: [ERC165](https://eips.ethereum.org/EIPS/eip-165)
        // (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`)
        return
            interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165.
            interfaceId == 0xd9b67a26 || // ERC165 interface ID for ERC1155.
            interfaceId == 0x0e89341c; // ERC165 interface ID for ERC1155MetadataURI.
    }
    
    /**
     * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
     */
    function uri(uint256 id) public view virtual override returns (string memory) {
        string memory tokenURI = _tokenURIs[id];
        string memory baseURI = _baseURI();

        return bytes(tokenURI).length > 0 ? 
            tokenURI : 
            bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(id))) : '';
    }

    /**
     * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
     * token will be the concatenation of the `baseURI` and the `tokenId`. Empty
     * by default, it can be overridden in child contracts.
     */
    function _baseURI() internal view virtual returns (string memory) {
        return '';
    }

    /**
     * @dev Sets `tokenURI` as the tokenURI of `tokenId`.
     */
    function _setURI(uint256 tokenId, string calldata tokenURI) internal virtual {
        _tokenURIs[tokenId] = tokenURI;
        emit URI(uri(tokenId), tokenId);
    }

    /**
     * @dev See {IERC1155-balanceOf}.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     */
    function balanceOf(address account, uint256 id) public view virtual override returns (uint256) {
        if(account == address(0)) { _revert(BalanceQueryForZeroAddress.selector); }
        return getBalance(account, id);
    }

    /**
     * @dev Gets the balance of an account's token id from packed token data
     *
     */
    function getBalance(address account, uint256 id) private view returns (uint256 _balance) {
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, or(shl(96, account), shr(4, id)))
            _balance := shr(shl(4, and(id, 0x0F)), and(sload(mload(ptr)), shl(shl(4, and(id, 0x0F)), 0xFFFF)))
        }
        return _balance;
    }

    /**
     * @dev Sets the balance of an account's token id in packed token data
     *
     */
    function setBalance(address account, uint256 id, uint256 amount) private {
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, or(shl(96, account), shr(4, id)))
            mstore(add(ptr, 0x20), sload(mload(ptr)))
            mstore(add(ptr, 0x20), or(and(not(shl(shl(4, and(id, 0x0F)), 0xFFFF)), mload(add(ptr, 0x20))), shl(shl(4, and(id, 0x0F)), amount)))
            sstore(mload(ptr), mload(add(ptr, 0x20)))
        }
    }

    /**
     * @dev See {IERC1155-balanceOfBatch}.
     *
     * Requirements:
     *
     * - `accounts` and `ids` must have the same length.
     */
    function balanceOfBatch(
        address[] calldata accounts,
        uint256[] calldata ids
    ) public view virtual override returns (uint256[] memory) {
        if(accounts.length != ids.length) { _revert(ArrayLengthMismatch.selector); }

        uint256[] memory batchBalances = new uint256[](accounts.length);

        for(uint256 i = 0; i < accounts.length;) {
            batchBalances[i] = balanceOf(accounts[i], ids[i]);
            unchecked {
                ++i;
            }
        }

        return batchBalances;
    }

    /**
     * @dev See {IERC1155-isApprovedForAll}.
     */
    function isApprovedForAll(address account, address operator) public view virtual override returns (bool _approved) {
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, account)
            mstore(add(ptr, 0x20), operator)
            let slot := keccak256(ptr, 0x40)
            _approved := sload(slot)
        }
        return _approved; 
    }

    /**
     * @dev See {IERC1155-safeTransferFrom}.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 id,
        uint256 amount,
        bytes memory data
    ) public virtual override {
        _safeTransferFrom(from, to, id, amount, data);
    }

    /**
     * @dev See {IERC1155-safeBatchTransferFrom}.
     */
    function safeBatchTransferFrom(
        address from,
        address to,
        uint256[] calldata ids,
        uint256[] calldata amounts,
        bytes memory data
    ) public virtual override {
        _safeBatchTransferFrom(from, to, ids, amounts, data);
    }

    /**
     * @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
     *
     * Emits a {TransferSingle} event.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - `from` must have a balance of tokens of type `id` of at least `amount`.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
     * acceptance magic value.
     */
    function _safeTransferFrom(
        address from,
        address to,
        uint256 id,
        uint256 amount,
        bytes memory data
    ) internal virtual {
        if(id > MAX_TOKEN_ID) { _revert(ExceedsMaximumTokenId.selector); }
        if(to == address(0)) { _revert(TransferToZeroAddress.selector); }
        
        if(from != _msgSenderERC1155P())
            if (!isApprovedForAll(from, _msgSenderERC1155P())) _revert(TransferCallerNotOwnerNorApproved.selector);

        address operator = _msgSenderERC1155P();

        _beforeTokenTransfer(operator, from, to, id, amount, data);

        if(from != to) {
            uint256 fromBalance = getBalance(from, id);
            if(amount > fromBalance) { _revert(TransferExceedsBalance.selector); }
            uint256 toBalance = getBalance(to, id);
            unchecked {
                fromBalance -= amount;
                toBalance += amount;
            }
            if(toBalance > MAX_ACCOUNT_TOKEN_BALANCE) { _revert(ExceedsMaximumBalance.selector); }
            setBalance(from, id, fromBalance);
            setBalance(to, id, toBalance);   
        }

        assembly {
            // Emit the `TransferSingle` event.
            let memOffset := mload(0x40)
            mstore(memOffset, id)
            mstore(add(memOffset, 0x20), amount)
            log4(
                memOffset, // Start of data .
                0x40, // Length of data.
                _TRANSFER_SINGLE_EVENT_SIGNATURE, // Signature.
                operator, // `operator`.
                from, // `from`.
                to // `to`.
            )
        }

        _afterTokenTransfer(operator, from, to, id, amount, data);

        if(to.code.length != 0)
            if(!_checkContractOnERC1155Received(from, to, id, amount, data))  {
                _revert(TransferToNonERC1155ReceiverImplementer.selector);
            }
    }

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_safeTransferFrom}.
     *
     * Emits a {TransferBatch} event.
     *
     * Requirements:
     *
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
     * acceptance magic value.
     */
    function _safeBatchTransferFrom(
        address from,
        address to,
        uint256[] calldata ids,
        uint256[] calldata amounts,
        bytes memory data
    ) internal virtual {
        if(to == address(0)) { _revert(TransferToZeroAddress.selector); }
        if(ids.length != amounts.length) { _revert(ArrayLengthMismatch.selector); }

        if(from != _msgSenderERC1155P())
            if (!isApprovedForAll(from, _msgSenderERC1155P())) _revert(TransferCallerNotOwnerNorApproved.selector);

        address operator = _msgSenderERC1155P();

        _beforeBatchTokenTransfer(operator, from, to, ids, amounts, data);

        if(from != to) {
            for (uint256 i = 0; i < ids.length;) {
                uint256 id = ids[i];
                uint256 amount = amounts[i];
                if(id > MAX_TOKEN_ID) { _revert(ExceedsMaximumTokenId.selector); }

                uint256 fromBalance = getBalance(from, id);
                if(amount > fromBalance) { _revert(TransferExceedsBalance.selector); }
                uint256 toBalance = getBalance(to, id);
                unchecked {
                    fromBalance -= amount;
                    toBalance += amount;
                }
                if(toBalance > MAX_ACCOUNT_TOKEN_BALANCE) { _revert(ExceedsMaximumBalance.selector); }
                setBalance(from, id, fromBalance);
                setBalance(to, id, toBalance);
                unchecked {
                    ++i;
                }
            }
        }

        assembly {
            let memOffset := mload(0x40)
            mstore(memOffset, 0x40)
            mstore(add(memOffset,0x20), add(0x60, mul(0x20,ids.length)))
            mstore(add(memOffset,0x40), ids.length)
            calldatacopy(add(memOffset,0x60), ids.offset, mul(0x20,ids.length))
            mstore(add(add(memOffset,0x60),mul(0x20,ids.length)), amounts.length)
            calldatacopy(add(add(memOffset,0x80),mul(0x20,ids.length)), amounts.offset, mul(0x20,amounts.length))
            log4(
                memOffset, 
                add(0x80,mul(0x40,amounts.length)),
                _TRANSFER_BATCH_EVENT_SIGNATURE, // Signature.
                operator, // `operator`.
                from, // `from`.
                to // `to`.
            )
        }

        _afterBatchTokenTransfer(operator, from, to, ids, amounts, data);


        if(to.code.length != 0)
            if(!_checkContractOnERC1155BatchReceived(from, to, ids, amounts, data))  {
                _revert(TransferToNonERC1155ReceiverImplementer.selector);
            }
    }

    /**
     * @dev Creates `amount` tokens of token type `id`, and assigns them to `to`.
     *
     * Emits a {TransferSingle} event.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
     * acceptance magic value.
     */
    function _mint(address to, uint256 id, uint256 amount, bytes memory data) internal virtual {
        if(id > MAX_TOKEN_ID) { _revert(ExceedsMaximumTokenId.selector); }
        if(to == address(0)) { _revert(MintToZeroAddress.selector); }
        if(amount == 0) { _revert(MintZeroQuantity.selector); }

        address operator = _msgSenderERC1155P();

        _beforeTokenTransfer(operator, address(0), to, id, amount, data);

        uint256 toBalance = getBalance(to, id);
        unchecked {
            toBalance += amount;
        }
        if(toBalance > MAX_ACCOUNT_TOKEN_BALANCE) { _revert(ExceedsMaximumBalance.selector); }
        setBalance(to, id, toBalance);

        assembly {
            // Emit the `TransferSingle` event.
            let memOffset := mload(0x40)
            mstore(memOffset, id)
            mstore(add(memOffset, 0x20), amount)
            log4(
                memOffset, // Start of data .
                0x40, // Length of data.
                _TRANSFER_SINGLE_EVENT_SIGNATURE, // Signature.
                operator, // `operator`.
                0, // `from`.
                to // `to`.
            )
        }

        _afterTokenTransfer(operator, address(0), to, id, amount, data);

        if(to.code.length != 0)
            if(!_checkContractOnERC1155Received(address(0), to, id, amount, data))  {
                _revert(TransferToNonERC1155ReceiverImplementer.selector);
            }
    }

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}.
     *
     * Emits a {TransferBatch} event.
     *
     * Requirements:
     *
     * - `ids` and `amounts` must have the same length.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
     * acceptance magic value.
     */
    function _mintBatch(
        address to,
        uint256[] calldata ids,
        uint256[] calldata amounts,
        bytes memory data
    ) internal virtual {
        if(to == address(0)) { _revert(MintToZeroAddress.selector); }
        if(ids.length != amounts.length) { _revert(ArrayLengthMismatch.selector); }

        address operator = _msgSenderERC1155P();

        _beforeBatchTokenTransfer(operator, address(0), to, ids, amounts, data);

        uint256 id;
        uint256 amount;
        for (uint256 i = 0; i < ids.length;) {
            id = ids[i];
            amount = amounts[i];
            if(id > MAX_TOKEN_ID) { _revert(ExceedsMaximumTokenId.selector); }
            if(amount == 0) { _revert(MintZeroQuantity.selector); }

            uint256 toBalance = getBalance(to, id);
            unchecked {
                toBalance += amount;
            }
            if(toBalance > MAX_ACCOUNT_TOKEN_BALANCE) { _revert(ExceedsMaximumBalance.selector); }
            setBalance(to, id, toBalance);
            unchecked {
                ++i;
            }
        }

        assembly {
            let memOffset := mload(0x40)
            mstore(memOffset, 0x40)
            mstore(add(memOffset,0x20), add(0x60, mul(0x20,ids.length)))
            mstore(add(memOffset,0x40), ids.length)
            calldatacopy(add(memOffset,0x60), ids.offset, mul(0x20,ids.length))
            mstore(add(add(memOffset,0x60),mul(0x20,ids.length)), amounts.length)
            calldatacopy(add(add(memOffset,0x80),mul(0x20,ids.length)), amounts.offset, mul(0x20,amounts.length))
            log4(
                memOffset, 
                add(0x80,mul(0x40,amounts.length)),
                _TRANSFER_BATCH_EVENT_SIGNATURE, // Signature.
                operator, // `operator`.
                0, // `from`.
                to // `to`.
            )
        }

        _afterBatchTokenTransfer(operator, address(0), to, ids, amounts, data);

        if(to.code.length != 0)
            if(!_checkContractOnERC1155BatchReceived(address(0), to, ids, amounts, data))  {
                _revert(TransferToNonERC1155ReceiverImplementer.selector);
            }
    }

    /**
     * @dev Destroys `amount` tokens of token type `id` from `from`
     *
     * Emits a {TransferSingle} event.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `from` must have at least `amount` tokens of token type `id`.
     */
    function _burn(address from, uint256 id, uint256 amount) internal virtual {
        if(id > MAX_TOKEN_ID) { _revert(ExceedsMaximumTokenId.selector); }
        if(from == address(0)) { _revert(BurnFromZeroAddress.selector); }

        address operator = _msgSenderERC1155P();

        _beforeTokenTransfer(operator, from, address(0), id, amount, "");

        uint256 fromBalance = getBalance(from, id);
        if(amount > fromBalance) { _revert(BurnExceedsBalance.selector); }
        unchecked {
            fromBalance -= amount;
        }
        setBalance(from, id, fromBalance);

        assembly {
            // Emit the `TransferSingle` event.
            let memOffset := mload(0x40)
            mstore(memOffset, id)
            mstore(add(memOffset, 0x20), amount)
            log4(
                memOffset, // Start of data.
                0x40, // Length of data.
                _TRANSFER_SINGLE_EVENT_SIGNATURE, // Signature.
                operator, // `operator`.
                from, // `from`.
                0 // `to`.
            )
        }

        _afterTokenTransfer(operator, from, address(0), id, amount, "");
    }

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_burn}.
     *
     * Emits a {TransferBatch} event.
     *
     * Requirements:
     *
     * - `ids` and `amounts` must have the same length.
     */
    function _burnBatch(address from, uint256[] calldata ids, uint256[] calldata amounts) internal virtual {
        if(from == address(0)) { _revert(BurnFromZeroAddress.selector); }
        if(ids.length != amounts.length) { _revert(ArrayLengthMismatch.selector); }

        address operator = _msgSenderERC1155P();

        _beforeBatchTokenTransfer(operator, from, address(0), ids, amounts, "");

        for (uint256 i = 0; i < ids.length;) {
            uint256 id = ids[i];
            uint256 amount = amounts[i];
            if(id > MAX_TOKEN_ID) { _revert(ExceedsMaximumTokenId.selector); }

            uint256 fromBalance = getBalance(from, id);
            if(amount > fromBalance) { _revert(BurnExceedsBalance.selector); }
            unchecked {
                fromBalance -= amount;
            }
            setBalance(from, id, fromBalance);
            unchecked {
                ++i;
            }
        }

        assembly {
            let memOffset := mload(0x40)
            mstore(memOffset, 0x40)
            mstore(add(memOffset,0x20), add(0x60, mul(0x20,ids.length)))
            mstore(add(memOffset,0x40), ids.length)
            calldatacopy(add(memOffset,0x60), ids.offset, mul(0x20,ids.length))
            mstore(add(add(memOffset,0x60),mul(0x20,ids.length)), amounts.length)
            calldatacopy(add(add(memOffset,0x80),mul(0x20,ids.length)), amounts.offset, mul(0x20,amounts.length))
            log4(
                memOffset, 
                add(0x80,mul(0x40,amounts.length)),
                _TRANSFER_BATCH_EVENT_SIGNATURE, // Signature.
                operator, // `operator`.
                from, // `from`.
                0 // `to`.
            )
        }

        _afterBatchTokenTransfer(operator, from, address(0), ids, amounts, "");
    }

    /**
     * @dev Approve or remove `operator` as an operator for the caller.
     * Operators can call {transferFrom} or {safeTransferFrom}
     * for any token owned by the caller.
     *
     * Emits an {ApprovalForAll} event.
     */
    function setApprovalForAll(address operator, bool approved) public virtual override {
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, caller())
            mstore(add(ptr, 0x20), operator)
            let slot := keccak256(ptr, 0x40)
            sstore(slot, approved)
            mstore(ptr, approved)
            log3(
                ptr,
                0x20,
                _APPROVAL_FOR_ALL_EVENT_SIGNATURE,
                caller(),
                operator
            )
        }
    }

    /**
     * @dev Hook that is called before any single token transfer. This includes minting
     * and burning.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
     * of token type `id` will be  transferred to `to`.
     * - When `from` is zero, `amount` tokens of token type `id` will be minted
     * for `to`.
     * - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
     * will be burned.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _beforeTokenTransfer(
        address operator,
        address from,
        address to,
        uint256 id,
        uint256 amount,
        bytes memory data
    ) internal virtual {}

    

    /**
     * @dev Hook that is called before any batch token transfer. This includes minting
     * and burning.
     *
     * Calling conditions (for each `id` and `amount` pair):
     *
     * - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
     * of token type `id` will be  transferred to `to`.
     * - When `from` is zero, `amount` tokens of token type `id` will be minted
     * for `to`.
     * - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
     * will be burned.
     * - `from` and `to` are never both zero.
     * - `ids` and `amounts` have the same, non-zero length.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    
    function _beforeBatchTokenTransfer(
        address operator,
        address from,
        address to,
        uint256[] calldata ids,
        uint256[] calldata amounts,
        bytes memory data
    ) internal virtual {}

    /**
     * @dev Hook that is called after any single token transfer. This includes minting
     * and burning.
     *
     * Calling conditions:
     *
     * - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
     * of token type `id` will be  transferred to `to`.
     * - When `from` is zero, `amount` tokens of token type `id` will be minted
     * for `to`.
     * - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
     * will be burned.
     * - `from` and `to` are never both zero.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    function _afterTokenTransfer(
        address operator,
        address from,
        address to,
        uint256 id,
        uint256 amount,
        bytes memory data
    ) internal virtual {}

    /**
     * @dev Hook that is called after any batch token transfer. This includes minting
     * and burning.
     *
     * Calling conditions (for each `id` and `amount` pair):
     *
     * - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
     * of token type `id` will be  transferred to `to`.
     * - When `from` is zero, `amount` tokens of token type `id` will be minted
     * for `to`.
     * - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
     * will be burned.
     * - `from` and `to` are never both zero.
     * - `ids` and `amounts` have the same, non-zero length.
     *
     * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
     */
    
    function _afterBatchTokenTransfer(
        address operator,
        address from,
        address to,
        uint256[] calldata ids,
        uint256[] calldata amounts,
        bytes memory data
    ) internal virtual {}

    /**
     * @dev Private function to invoke {IERC1155Receiver-onERC155Received} on a target contract.
     *
     * `from` - Previous owner of the given token ID.
     * `to` - Target address that will receive the token.
     * `id` - Token ID to be transferred.
     * `amount` - Balance of token to be transferred
     * `_data` - Optional data to send along with the call.
     *
     * Returns whether the call correctly returned the expected magic value.
     */
    function _checkContractOnERC1155Received(
        address from,
        address to,
        uint256 id,
        uint256 amount,
        bytes memory _data
    ) private returns (bool) {
        try ERC1155P__IERC1155Receiver(to).onERC1155Received(_msgSenderERC1155P(), from, id, amount, _data) returns (
            bytes4 retval
        ) {
            return retval == ERC1155P__IERC1155Receiver(to).onERC1155Received.selector;
        } catch (bytes memory reason) {
            if (reason.length == 0) {
                _revert(TransferToNonERC1155ReceiverImplementer.selector);
            }
            assembly {
                revert(add(32, reason), mload(reason))
            }
        }
    }

    /**
     * @dev Private function to invoke {IERC1155Receiver-onERC155Received} on a target contract.
     *
     * `from` - Previous owner of the given token ID.
     * `to` - Target address that will receive the token.
     * `id` - Token ID to be transferred.
     * `amount` - Balance of token to be transferred
     * `_data` - Optional data to send along with the call.
     *
     * Returns whether the call correctly returned the expected magic value.
     */
    function _checkContractOnERC1155BatchReceived(
        address from,
        address to,
        uint256[] calldata ids,
        uint256[] calldata amounts,
        bytes memory _data
    ) private returns (bool) {
        try ERC1155P__IERC1155Receiver(to).onERC1155BatchReceived(_msgSenderERC1155P(), from, ids, amounts, _data) returns (
            bytes4 retval
        ) {
            return retval == ERC1155P__IERC1155Receiver(to).onERC1155BatchReceived.selector;
        } catch (bytes memory reason) {
            if (reason.length == 0) {
                _revert(TransferToNonERC1155ReceiverImplementer.selector);
            }
            assembly {
                revert(add(32, reason), mload(reason))
            }
        }
    }
    
    /**
     * @dev Returns the message sender (defaults to `msg.sender`).
     *
     * If you are writing GSN compatible contracts, you need to override this function.
     */
    function _msgSenderERC1155P() internal view virtual returns (address) {
        return msg.sender;
    }

    /**
     * @dev Converts a uint256 to its ASCII string decimal representation.
     */
    function _toString(uint256 value) internal pure virtual returns (string memory str) {
        assembly {
            // The maximum value of a uint256 contains 78 digits (1 byte per digit), but
            // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned.
            // We will need 1 word for the trailing zeros padding, 1 word for the length,
            // and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0.
            let m := add(mload(0x40), 0xa0)
            // Update the free memory pointer to allocate.
            mstore(0x40, m)
            // Assign the `str` to the end.
            str := sub(m, 0x20)
            // Zeroize the slot after the string.
            mstore(str, 0)

            // Cache the end of the memory to calculate the length later.
            let end := str

            // We write the string from rightmost digit to leftmost digit.
            // The following is essentially a do-while loop that also handles the zero case.
            // prettier-ignore
            for { let temp := value } 1 {} {
                str := sub(str, 1)
                // Write the character to the pointer.
                // The ASCII index of the '0' character is 48.
                mstore8(str, add(48, mod(temp, 10)))
                // Keep dividing `temp` until zero.
                temp := div(temp, 10)
                // prettier-ignore
                if iszero(temp) { break }
            }

            let length := sub(end, str)
            // Move the pointer 32 bytes leftwards to make room for the length.
            str := sub(str, 0x20)
            // Store the length.
            mstore(str, length)
        }
    }

    /**
     * @dev For more efficient reverts.
     */
    function _revert(bytes4 errorSelector) internal pure {
        assembly {
            mstore(0x00, errorSelector)
            revert(0x00, 0x04)
        }
    }
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;

/// @notice Simple single owner authorization mixin.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/Ownable.sol)
///
/// @dev Note:
/// This implementation does NOT auto-initialize the owner to `msg.sender`.
/// You MUST call the `_initializeOwner` in the constructor / initializer.
///
/// While the ownable portion follows
/// [EIP-173](https://eips.ethereum.org/EIPS/eip-173) for compatibility,
/// the nomenclature for the 2-step ownership handover may be unique to this codebase.
abstract contract Ownable {
    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                       CUSTOM ERRORS                        */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The caller is not authorized to call the function.
    error Unauthorized();

    /// @dev The `newOwner` cannot be the zero address.
    error NewOwnerIsZeroAddress();

    /// @dev The `pendingOwner` does not have a valid handover request.
    error NoHandoverRequest();

    /// @dev Cannot double-initialize.
    error AlreadyInitialized();

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                           EVENTS                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The ownership is transferred from `oldOwner` to `newOwner`.
    /// This event is intentionally kept the same as OpenZeppelin's Ownable to be
    /// compatible with indexers and [EIP-173](https://eips.ethereum.org/EIPS/eip-173),
    /// despite it not being as lightweight as a single argument event.
    event OwnershipTransferred(address indexed oldOwner, address indexed newOwner);

    /// @dev An ownership handover to `pendingOwner` has been requested.
    event OwnershipHandoverRequested(address indexed pendingOwner);

    /// @dev The ownership handover to `pendingOwner` has been canceled.
    event OwnershipHandoverCanceled(address indexed pendingOwner);

    /// @dev `keccak256(bytes("OwnershipTransferred(address,address)"))`.
    uint256 private constant _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE =
        0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0;

    /// @dev `keccak256(bytes("OwnershipHandoverRequested(address)"))`.
    uint256 private constant _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE =
        0xdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d;

    /// @dev `keccak256(bytes("OwnershipHandoverCanceled(address)"))`.
    uint256 private constant _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE =
        0xfa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                          STORAGE                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The owner slot is given by:
    /// `bytes32(~uint256(uint32(bytes4(keccak256("_OWNER_SLOT_NOT")))))`.
    /// It is intentionally chosen to be a high value
    /// to avoid collision with lower slots.
    /// The choice of manual storage layout is to enable compatibility
    /// with both regular and upgradeable contracts.
    bytes32 internal constant _OWNER_SLOT =
        0xffffffffffffffffffffffffffffffffffffffffffffffffffffffff74873927;

    /// The ownership handover slot of `newOwner` is given by:
    /// ```
    ///     mstore(0x00, or(shl(96, user), _HANDOVER_SLOT_SEED))
    ///     let handoverSlot := keccak256(0x00, 0x20)
    /// ```
    /// It stores the expiry timestamp of the two-step ownership handover.
    uint256 private constant _HANDOVER_SLOT_SEED = 0x389a75e1;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                     INTERNAL FUNCTIONS                     */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Override to return true to make `_initializeOwner` prevent double-initialization.
    function _guardInitializeOwner() internal pure virtual returns (bool guard) {}

    /// @dev Initializes the owner directly without authorization guard.
    /// This function must be called upon initialization,
    /// regardless of whether the contract is upgradeable or not.
    /// This is to enable generalization to both regular and upgradeable contracts,
    /// and to save gas in case the initial owner is not the caller.
    /// For performance reasons, this function will not check if there
    /// is an existing owner.
    function _initializeOwner(address newOwner) internal virtual {
        if (_guardInitializeOwner()) {
            /// @solidity memory-safe-assembly
            assembly {
                let ownerSlot := _OWNER_SLOT
                if sload(ownerSlot) {
                    mstore(0x00, 0x0dc149f0) // `AlreadyInitialized()`.
                    revert(0x1c, 0x04)
                }
                // Clean the upper 96 bits.
                newOwner := shr(96, shl(96, newOwner))
                // Store the new value.
                sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner))))
                // Emit the {OwnershipTransferred} event.
                log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner)
            }
        } else {
            /// @solidity memory-safe-assembly
            assembly {
                // Clean the upper 96 bits.
                newOwner := shr(96, shl(96, newOwner))
                // Store the new value.
                sstore(_OWNER_SLOT, newOwner)
                // Emit the {OwnershipTransferred} event.
                log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner)
            }
        }
    }

    /// @dev Sets the owner directly without authorization guard.
    function _setOwner(address newOwner) internal virtual {
        if (_guardInitializeOwner()) {
            /// @solidity memory-safe-assembly
            assembly {
                let ownerSlot := _OWNER_SLOT
                // Clean the upper 96 bits.
                newOwner := shr(96, shl(96, newOwner))
                // Emit the {OwnershipTransferred} event.
                log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner)
                // Store the new value.
                sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner))))
            }
        } else {
            /// @solidity memory-safe-assembly
            assembly {
                let ownerSlot := _OWNER_SLOT
                // Clean the upper 96 bits.
                newOwner := shr(96, shl(96, newOwner))
                // Emit the {OwnershipTransferred} event.
                log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner)
                // Store the new value.
                sstore(ownerSlot, newOwner)
            }
        }
    }

    /// @dev Throws if the sender is not the owner.
    function _checkOwner() internal view virtual {
        /// @solidity memory-safe-assembly
        assembly {
            // If the caller is not the stored owner, revert.
            if iszero(eq(caller(), sload(_OWNER_SLOT))) {
                mstore(0x00, 0x82b42900) // `Unauthorized()`.
                revert(0x1c, 0x04)
            }
        }
    }

    /// @dev Returns how long a two-step ownership handover is valid for in seconds.
    /// Override to return a different value if needed.
    /// Made internal to conserve bytecode. Wrap it in a public function if needed.
    function _ownershipHandoverValidFor() internal view virtual returns (uint64) {
        return 48 * 3600;
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                  PUBLIC UPDATE FUNCTIONS                   */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Allows the owner to transfer the ownership to `newOwner`.
    function transferOwnership(address newOwner) public payable virtual onlyOwner {
        /// @solidity memory-safe-assembly
        assembly {
            if iszero(shl(96, newOwner)) {
                mstore(0x00, 0x7448fbae) // `NewOwnerIsZeroAddress()`.
                revert(0x1c, 0x04)
            }
        }
        _setOwner(newOwner);
    }

    /// @dev Allows the owner to renounce their ownership.
    function renounceOwnership() public payable virtual onlyOwner {
        _setOwner(address(0));
    }

    /// @dev Request a two-step ownership handover to the caller.
    /// The request will automatically expire in 48 hours (172800 seconds) by default.
    function requestOwnershipHandover() public payable virtual {
        unchecked {
            uint256 expires = block.timestamp + _ownershipHandoverValidFor();
            /// @solidity memory-safe-assembly
            assembly {
                // Compute and set the handover slot to `expires`.
                mstore(0x0c, _HANDOVER_SLOT_SEED)
                mstore(0x00, caller())
                sstore(keccak256(0x0c, 0x20), expires)
                // Emit the {OwnershipHandoverRequested} event.
                log2(0, 0, _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE, caller())
            }
        }
    }

    /// @dev Cancels the two-step ownership handover to the caller, if any.
    function cancelOwnershipHandover() public payable virtual {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute and set the handover slot to 0.
            mstore(0x0c, _HANDOVER_SLOT_SEED)
            mstore(0x00, caller())
            sstore(keccak256(0x0c, 0x20), 0)
            // Emit the {OwnershipHandoverCanceled} event.
            log2(0, 0, _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE, caller())
        }
    }

    /// @dev Allows the owner to complete the two-step ownership handover to `pendingOwner`.
    /// Reverts if there is no existing ownership handover requested by `pendingOwner`.
    function completeOwnershipHandover(address pendingOwner) public payable virtual onlyOwner {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute and set the handover slot to 0.
            mstore(0x0c, _HANDOVER_SLOT_SEED)
            mstore(0x00, pendingOwner)
            let handoverSlot := keccak256(0x0c, 0x20)
            // If the handover does not exist, or has expired.
            if gt(timestamp(), sload(handoverSlot)) {
                mstore(0x00, 0x6f5e8818) // `NoHandoverRequest()`.
                revert(0x1c, 0x04)
            }
            // Set the handover slot to 0.
            sstore(handoverSlot, 0)
        }
        _setOwner(pendingOwner);
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                   PUBLIC READ FUNCTIONS                    */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns the owner of the contract.
    function owner() public view virtual returns (address result) {
        /// @solidity memory-safe-assembly
        assembly {
            result := sload(_OWNER_SLOT)
        }
    }

    /// @dev Returns the expiry timestamp for the two-step ownership handover to `pendingOwner`.
    function ownershipHandoverExpiresAt(address pendingOwner)
        public
        view
        virtual
        returns (uint256 result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the handover slot.
            mstore(0x0c, _HANDOVER_SLOT_SEED)
            mstore(0x00, pendingOwner)
            // Load the handover slot.
            result := sload(keccak256(0x0c, 0x20))
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                         MODIFIERS                          */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Marks a function as only callable by the owner.
    modifier onlyOwner() virtual {
        _checkOwner();
        _;
    }
}

// SPDX-License-Identifier: MIT
// ERC721P Contracts v1.0.0

pragma solidity >=0.8.17;

/**
 * @dev Required interface of an ERC1155 compliant contract, as defined in the
 * https://eips.ethereum.org/EIPS/eip-1155[EIP].
 *
 * _Available since v3.1._
 */
interface IERC1155P {

    /**
     * Cannot query the balance for the zero address.
     */
    error BalanceQueryForZeroAddress();

    /**
     * Arrays cannot be different lengths.
     */
    error ArrayLengthMismatch();

    /**
     * Cannot burn from the zero address.
     */
    error BurnFromZeroAddress();

    /**
     * Cannot mint to the zero address.
     */
    error MintToZeroAddress();

    /**
     * The quantity of tokens minted must be more than zero.
     */
    error MintZeroQuantity();

    /**
     * The quantity of tokens being burned is greater than account balance.
     */
    error BurnExceedsBalance();

    /**
     * The quantity of tokens being transferred is greater than account balance.
     */
    error TransferExceedsBalance();

    /**
     * The resulting token balance exceeds the maximum storable by ERC1155P
     */
    error ExceedsMaximumBalance();

    /**
     * The caller must own the token or be an approved operator.
     */
    error TransferCallerNotOwnerNorApproved();

    /**
     * Cannot safely transfer to a contract that does not implement the
     * ERC1155Receiver interface.
     */
    error TransferToNonERC1155ReceiverImplementer();

    /**
     * Cannot transfer to the zero address.
     */
    error TransferToZeroAddress();

    /**
     * Exceeds max token ID
     */
    error ExceedsMaximumTokenId();
    
    // =============================================================
    //                            IERC165
    // =============================================================

    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);

    /**
     * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
     */
    event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);

    /**
     * @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
     * transfers.
     */
    event TransferBatch(
        address indexed operator,
        address indexed from,
        address indexed to,
        uint256[] ids,
        uint256[] values
    );

    /**
     * @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
     * `approved`.
     */
    event ApprovalForAll(address indexed account, address indexed operator, bool approved);

    /**
     * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
     *
     * If an {URI} event was emitted for `id`, the standard
     * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
     * returned by {IERC1155MetadataURI-uri}.
     */
    event URI(string value, uint256 indexed id);

    /**
     * @dev Returns the amount of tokens of token type `id` owned by `account`.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     */
    function balanceOf(address account, uint256 id) external view returns (uint256);

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
     *
     * Requirements:
     *
     * - `accounts` and `ids` must have the same length.
     */
    function balanceOfBatch(
        address[] calldata accounts,
        uint256[] calldata ids
    ) external view returns (uint256[] memory);

    /**
     * @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
     *
     * Emits an {ApprovalForAll} event.
     *
     * Requirements:
     *
     * - `operator` cannot be the caller.
     */
    function setApprovalForAll(address operator, bool approved) external;

    /**
     * @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
     *
     * See {setApprovalForAll}.
     */
    function isApprovedForAll(address account, address operator) external view returns (bool);

    /**
     * @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
     *
     * Emits a {TransferSingle} event.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
     * - `from` must have a balance of tokens of type `id` of at least `amount`.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
     * acceptance magic value.
     */
    function safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes calldata data) external;

    /**
     * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
     *
     * Emits a {TransferBatch} event.
     *
     * Requirements:
     *
     * - `ids` and `amounts` must have the same length.
     * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
     * acceptance magic value.
     */
    function safeBatchTransferFrom(
        address from,
        address to,
        uint256[] calldata ids,
        uint256[] calldata amounts,
        bytes calldata data
    ) external;
}

{
  "remappings": [
    "ds-test/=lib/forge-std/lib/ds-test/src/",
    "erc4626-tests/=lib/openzeppelin-contracts/lib/erc4626-tests/",
    "forge-std/=lib/forge-std/src/",
    "@openzeppelin/=lib/openzeppelin-contracts/",
    "ERC1155P/=lib/ERC11155P/",
    "solady/=lib/solady/",
    "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/",
    "openzeppelin-contracts/=lib/openzeppelin-contracts/"
  ],
  "optimizer": {
    "enabled": true,
    "runs": 1000
  },
  "metadata": {
    "useLiteralContent": false,
    "bytecodeHash": "ipfs",
    "appendCBOR": true
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "evmVersion": "cancun",
  "viaIR": true,
  "libraries": {}
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AlreadyInitialized","type":"error"},{"inputs":[],"name":"ArrayLengthMismatch","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[],"name":"BurnExceedsBalance","type":"error"},{"inputs":[],"name":"BurnFromZeroAddress","type":"error"},{"inputs":[],"name":"ExceedsMaximumBalance","type":"error"},{"inputs":[],"name":"ExceedsMaximumTokenId","type":"error"},{"inputs":[],"name":"InvalidArrayLengths","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"NewOwnerIsZeroAddress","type":"error"},{"inputs":[],"name":"NoHandoverRequest","type":"error"},{"inputs":[],"name":"Soulbound","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferExceedsBalance","type":"error"},{"inputs":[],"name":"TransferToNonERC1155ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[],"name":"ContractURIUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverCanceled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverRequested","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"TransferBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"TransferSingle","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"value","type":"string"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"}],"name":"URI","type":"event"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address[]","name":"recipients","type":"address[]"}],"name":"airdrop","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"}],"name":"balanceOfBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"burnBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"cancelOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"completeOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"contractURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"_approved","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"mintBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"result","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"ownershipHandoverExpiresAt","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"requestOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeBatchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"newURI","type":"string"}],"name":"setContractURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"string","name":"tokenURI","type":"string"}],"name":"setURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"uri","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"}]

6080346102ee576001600160401b039060409080820183811182821017610218578252600f81526020926e456e7341756374696f6e44726f707360881b848301528251938385018581108382111761021857845260068552650454144524f560d41b81860152825190828211610218575f54916001948584811c941680156102e4575b838510146101fa578190601f94858111610296575b508390858311600114610237575f9261022c575b50505f19600383901b1c191690851b175f555b85519283116102185783548481811c9116801561020e575b828210146101fa578281116101b7575b50809183116001146101575750819293945f9261014c575b50505f19600383901b1c191690821b1790555b33638b78c6d81955335f7f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08180a351611fc090816102f38239f35b015190505f806100fe565b90601f19831695845f52825f20925f905b8882106101a05750508385969710610188575b505050811b019055610111565b01515f1960f88460031b161c191690555f808061017b565b808785968294968601518155019501930190610168565b845f52815f208380860160051c8201928487106101f1575b0160051c019085905b8281106101e65750506100e6565b5f81550185906101d8565b925081926101cf565b634e487b7160e01b5f52602260045260245ffd5b90607f16906100d6565b634e487b7160e01b5f52604160045260245ffd5b015190505f806100ab565b90879350601f198316915f8052855f20925f5b878282106102805750508411610268575b505050811b015f556100be565b01515f1960f88460031b161c191690555f808061025b565b8385015186558b9790950194938401930161024a565b9091505f8052835f208580850160051c8201928686106102db575b918991869594930160051c01915b8281106102cd575050610097565b5f81558594508991016102bf565b925081926102b1565b93607f1693610082565b5f80fdfe60806040526004361015610011575f80fd5b5f3560e01c8062fdd58e146101a357806301ffc9a71461019e57806306fdde03146101995780630e89341c14610194578063156e29f61461018f578063256929621461018a5780632eb2c2d6146101855780634e1273f41461018057806354d1f13d1461017b5780636b20c45414610176578063715018a614610171578063862440e21461016c5780638da5cb5b14610167578063938e3d7b1461016257806395d89b411461015d578063a22cb46514610158578063bdf7a8e614610153578063d81d0a151461014e578063e8a3d48514610149578063e985e9c514610144578063f04e283e1461013f578063f242432a1461013a578063f2fde38b14610135578063f5298aca146101305763fee81cf41461012b575f80fd5b6118e5565b6117c6565b611787565b6115bb565b61156a565b61151f565b61147a565b611313565b61118f565b611129565b611085565b610f50565b610f26565b610dcf565b610d5d565b610bf9565b610b5c565b610a4e565b6107a3565b6106c7565b610593565b610532565b610455565b61021a565b6101bd565b6001600160a01b038116036101b957565b5f80fd5b346101b95760403660031901126101b95760206101e86004356101df816101a8565b6024359061191b565b604051908152f35b7fffffffff000000000000000000000000000000000000000000000000000000008116036101b957565b346101b95760203660031901126101b95760207fffffffff0000000000000000000000000000000000000000000000000000000060043561025a816101f0565b167f01ffc9a70000000000000000000000000000000000000000000000000000000081149081156102c2575b8115610298575b506040519015158152f35b7f0e89341c000000000000000000000000000000000000000000000000000000009150145f61028d565b7fd9b67a260000000000000000000000000000000000000000000000000000000081149150610286565b90600182811c9216801561031a575b602083101461030657565b634e487b7160e01b5f52602260045260245ffd5b91607f16916102fb565b634e487b7160e01b5f52604160045260245ffd5b6020810190811067ffffffffffffffff82111761035457604052565b610324565b90601f8019910116810190811067ffffffffffffffff82111761035457604052565b9060405191825f825461038d816102ec565b908184526020946001916001811690815f146103fb57506001146103bd575b5050506103bb92500383610359565b565b5f90815285812095935091905b8183106103e35750506103bb93508201015f80806103ac565b855488840185015294850194879450918301916103ca565b925050506103bb94925060ff191682840152151560051b8201015f80806103ac565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b90602061045292818152019061041d565b90565b346101b9575f3660031901126101b9576040515f8054610474816102ec565b8084529060209060019081811690811561050857506001146104b1575b6104ad856104a181870382610359565b60405191829182610441565b0390f35b5f80805293507f290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e5635b8385106104f5575050505081016020016104a1826104ad610491565b80548686018401529382019381016104d9565b8695506104ad969350602092506104a194915060ff191682840152151560051b8201019293610491565b346101b95760203660031901126101b9576004355f5260036020526104ad61055c60405f2061037b565b60405191829160208352602083019061041d565b60609060031901126101b957600435610588816101a8565b906024359060443590565b346101b9576105a136610570565b6105ac929192611bad565b604051906105b982610338565b5f82526c0fffffffffffffffffffffffff84116106b8576001600160a01b038316156106b35780156106ae578061061185859060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b0161ffff81116106a957610651908585602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b825f6040518681528360208201527fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f6260403392a4823b61068d57005b61069e9361069a93611dff565b1590565b6106a457005b611b0d565b611ae5565b611abd565b611aaf565b63467777f160e11b5f5260045ffd5b5f3660031901126101b95763389a75e1600c52335f526202a30042016020600c2055337fdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d5f80a2005b9181601f840112156101b95782359167ffffffffffffffff83116101b9576020808501948460051b0101116101b957565b67ffffffffffffffff811161035457601f01601f191660200190565b81601f820112156101b95780359061077482610741565b926107826040519485610359565b828452602083830101116101b957815f926020809301838601378301015290565b346101b95760a03660031901126101b9576004356107c0816101a8565b602435906107cd826101a8565b67ffffffffffffffff6044358181116101b9576107ee903690600401610710565b90916064358181116101b957610808903690600401610710565b9290916084359081116101b95761082390369060040161075d565b936001600160a01b03808816908115610a0e57858403610a095787163381036109f1575b6108518989611c4a565b036108cd575b8686604051604081528460051b8060600160208301528560408301528085606084013781018760608201528660808960051b9201377f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb33918860061b60800190a4863b6108c057005b61069e9661069a96611f56565b5f5b8281106108dc5750610857565b6108e78184846119bb565b35906108f48187876119bb565b356c0fffffffffffffffffffffffff83116109ec57610934838a9060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b928382116109e75781610968828d9060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b019061ffff82116106a9576109b06109e19360019603828d602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b8b602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b016108cf565b611b85565b6106b8565b60408051898152336020820152205461084757611b5d565b610b34565b611b35565b60209060206040818301928281528551809452019301915f5b828110610a3a575050505090565b835185529381019392810192600101610a2c565b346101b95760403660031901126101b95767ffffffffffffffff6004358181116101b957610a80903690600401610710565b916024359081116101b957610a99903690600401610710565b9290838203610b3457610aab8261198f565b93610ab96040519586610359565b828552610ac58361198f565b60209390601f190136878601375f5b818110610ae957604051806104ad8982610a13565b610b13610af78284896119bb565b35610b01816101a8565b610b0c8386886119bb565b359061191b565b908751811015610b2f57600191868260051b8a01015201610ad4565b6119a7565b7fa24a13a6000000000000000000000000000000000000000000000000000000005f5260045ffd5b5f3660031901126101b95763389a75e1600c52335f525f6020600c2055337ffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c925f80a2005b9060606003198301126101b957600435610bb9816101a8565b9167ffffffffffffffff916024358381116101b95782610bdb91600401610710565b939093926044359182116101b957610bf591600401610710565b9091565b346101b957610c0736610ba0565b91909392610c13611bad565b6001600160a01b03841615610d5857828203610a0957610c3161197d565b50610c3b84611c02565b5f5b828110610cb25750905f947f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb9260405192604084528060051b9182918260600160208701526040860152606085013782019084606083015260808560051b920137339260061b60800190a4610cb061197d565b005b610cbd8184846119bb565b3590610cca8186896119bb565b35916c0fffffffffffffffffffffffff81116109ec57610d0b81889060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b90818411610d5357600193610d4d92039088602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b01610c3d565b611a87565b6118bd565b5f3660031901126101b957610d70611bad565b5f638b78c6d8198181547f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08280a355005b9181601f840112156101b95782359167ffffffffffffffff83116101b957602083818601950101116101b957565b346101b95760403660031901126101b95767ffffffffffffffff6004356024358281116101b957610e04903690600401610da1565b610e0f939193611bad565b825f52602093600360205260405f2092821161035457610e3982610e3385546102ec565b85611a38565b5f94601f8311600114610ebb5750610e6a92939482915f92610eb0575b50508160011b915f199060031b1c19161790565b90555b7f6bb7ff708619ba0610cba295a58592e0451dee2622938c8755667688daf3529b610eab6104a1610ea6845f52600360205260405f2090565b61037b565b0390a2005b013590505f80610e56565b90601f19831695610ecf855f5260205f2090565b925f905b888210610f0e57505083600195969710610ef5575b505050811b019055610e6d565b01355f19600384901b60f8161c191690555f8080610ee8565b80600184968294958701358155019501920190610ed3565b346101b9575f3660031901126101b9576020638b78c6d819546001600160a01b0360405191168152f35b346101b9576020806003193601126101b95767ffffffffffffffff6004358181116101b957610f83903690600401610da1565b91610f8c611bad565b821161035457610fa682610fa16004546102ec565b6119cb565b5f92601f8311600114610ffd5750610fd3925f9183610eb05750508160011b915f199060031b1c19161790565b6004555b7fa5d4097edda6d87cb9329af83fb3712ef77eeb13738ffe43cc35a4ce305ad9625f80a1005b90601f1983169361102f60045f527f8a35acfbc15ff81a39ae7d344fd709f28e8600b4aa8c65c6b64bfe7fe36bd19b90565b925f905b86821061106d5750508360019510611054575b505050811b01600455610fd7565b01355f19600384901b60f8161c191690555f8080611046565b80600184968294958701358155019501920190611033565b346101b9575f3660031901126101b9576040515f600180546110a6816102ec565b808552916020916001811690811561050857506001146110d0576104ad856104a181870382610359565b60015f90815293507fb10e2d527612073b26eecdfd717e6a320cf44b4afac2b0732d9fcbe2b7fa0cf65b838510611116575050505081016020016104a1826104ad610491565b80548686018401529382019381016110fa565b346101b95760403660031901126101b957600435611146816101a8565b60243580151581036101b9576040519033825282602083015280604083205581527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3160203392a3005b346101b9576040806003193601126101b95760049060043560243567ffffffffffffffff81116101b957906111c984923690600401610710565b9290936111d4611bad565b6c0fffffffffffffffffffffffff8311935f5b8181106111f057005b6111fb8183896119bb565b35611205816101a8565b83519061121182610338565b875f8352611305576001600160a01b038116156112f8576001908161125789839060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b019161ffff83116106a9575f829161129c8b958685602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b88519085825260208201527fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62893392a4803b6112de575b5050506001016111e7565b9161069a916112ec93611d4f565b6106a4578785816112d3565b85622e076360e81b5f525ffd5b8563467777f160e11b5f525ffd5b346101b95761132136610ba0565b9061132d949394611bad565b6040519261133a84610338565b5f84526001600160a01b038516156106b357828103610a09575f5b8181106113d35750845f604051604081528360051b806060016020830152846040830152808a606084013781018660608201528560808860051b9201377f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb33918760061b60800190a4843b6113c657005b61069e9561069a95611f22565b6113de8183896119bb565b35906113eb8186866119bb565b356c0fffffffffffffffffffffffff83116109ec5780156106ae5761143183899060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b019161ffff83116106a9576001926114749189602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b01611355565b346101b9575f3660031901126101b9576040515f60045461149a816102ec565b8084529060209060019081811690811561050857506001146114c6576104ad856104a181870382610359565b60045f90815293507f8a35acfbc15ff81a39ae7d344fd709f28e8600b4aa8c65c6b64bfe7fe36bd19b5b83851061150c575050505081016020016104a1826104ad610491565b80548686018401529382019381016114f0565b346101b95760403660031901126101b9576020611560600435611541816101a8565b6024359061154e826101a8565b60409182519182526020820152205490565b6040519015158152f35b60203660031901126101b957600435611582816101a8565b61158a611bad565b63389a75e1600c52805f526020600c2090815442116115ae575f610cb09255611bc9565b636f5e88185f526004601cfd5b346101b95760a03660031901126101b9576004356115d8816101a8565b602435906115e5826101a8565b60443560643560843567ffffffffffffffff81116101b95761160b90369060040161075d565b916c0fffffffffffffffffffffffff81116109ec576001600160a01b03808616908115610a0e57851633810361176f575b6116468787611c4a565b03611695575b84846040518381528460208201527fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f6260403392a4843b61168857005b61069e9461069a94611e30565b6116c081859060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b8083116109e757826116f383889060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b0161ffff81116106a9576117388461176a93038488602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b8287602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b61164c565b60408051878152336020820152205461163c57611b5d565b60203660031901126101b95760043561179f816101a8565b6117a7611bad565b8060601b156117b957610cb090611bc9565b637448fbae5f526004601cfd5b346101b9576117d436610570565b91906117de611bad565b6c0fffffffffffffffffffffffff81116106b8576001600160a01b038216156118bd575f60405161180e81610338565b5261181882611c02565b61184381839060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b92838111610d5357611884815f95038385602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b60405191825260208201527fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f6260403392a4610cb061197d565b7fb817eee7000000000000000000000000000000000000000000000000000000005f5260045ffd5b346101b95760203660031901126101b957600435611902816101a8565b63389a75e1600c525f52602080600c2054604051908152f35b906001600160a01b0382161561195557610452919060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b7f8f4eb604000000000000000000000000000000000000000000000000000000005f5260045ffd5b6040519061198a82610338565b5f8252565b67ffffffffffffffff81116103545760051b60200190565b634e487b7160e01b5f52603260045260245ffd5b9190811015610b2f5760051b0190565b601f81116119d7575050565b60045f527f8a35acfbc15ff81a39ae7d344fd709f28e8600b4aa8c65c6b64bfe7fe36bd19b906020601f840160051c83019310611a2e575b601f0160051c01905b818110611a23575050565b5f8155600101611a18565b9091508190611a0f565b601f8211611a4557505050565b5f5260205f20906020601f840160051c83019310611a7d575b601f0160051c01905b818110611a72575050565b5f8155600101611a67565b9091508190611a5e565b7f588569f7000000000000000000000000000000000000000000000000000000005f5260045ffd5b622e076360e81b5f5260045ffd5b7fb562e8dd000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fb6cdf5d0000000000000000000000000000000000000000000000000000000005f5260045ffd5b7f9c05499b000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fea553b34000000000000000000000000000000000000000000000000000000005f5260045ffd5b7f59c896be000000000000000000000000000000000000000000000000000000005f5260045ffd5b7f169b037b000000000000000000000000000000000000000000000000000000005f5260045ffd5b638b78c6d819543303611bbc57565b6382b429005f526004601cfd5b6001600160a01b0316638b78c6d8198181547f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e05f80a355565b6001600160a01b0316151580611c43575b611c1957565b60046040517fa4420a95000000000000000000000000000000000000000000000000000000008152fd5b505f611c13565b6001600160a01b0380911615159182611c66575b5050611c1957565b16151590505f80611c5e565b908160209103126101b95751610452816101f0565b61045293926001600160a01b0360a0931682525f6020830152604082015260016060820152816080820152019061041d565b909260a0926001600160a01b0361045296951683525f602084015260408301526060820152816080820152019061041d565b919261045295949160a0946001600160a01b03809216855216602084015260408301526060820152816080820152019061041d565b3d15611d4a573d90611d3182610741565b91611d3f6040519384610359565b82523d5f602084013e565b606090565b611d7f6020916001600160a01b0393945f60405195868095819463f23a6e6160e01b9a8b84523360048501611c87565b0393165af15f9181611dce575b50611da857611d99611d20565b805115611b0d57805190602001fd5b7fffffffff00000000000000000000000000000000000000000000000000000000161490565b611df191925060203d602011611df8575b611de98183610359565b810190611c72565b905f611d8c565b503d611ddf565b9260209193611d7f935f6001600160a01b0360405180978196829563f23a6e6160e01b9b8c85523360048601611cb9565b9390611d7f935f6001600160a01b036020956040519788968795869363f23a6e6160e01b9c8d86523360048701611ceb565b90918281527f07ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff83116101b95760209260051b809284830137010190565b9490610452969492611edf946001600160a01b03611ed1931688525f602089015260a0604089015260a0880191611e62565b918583036060870152611e62565b91608081840391015261041d565b959192611edf94611ed1926104529997956001600160a01b038092168a5216602089015260a0604089015260a0880191611e62565b90949391925f6001600160a01b03602095611d7f6040519889978896879463bc197c8160e01b9d8e87523360048801611e9f565b956001600160a01b03602095949293611d7f5f93604051998a988997889563bc197c8160e01b9e8f88523360048901611eed56fea2646970667358221220d12f3a7fcb170874c477becbd6ae9bb759d30a0b22fbe26cacb2299926dd8f4a64736f6c63430008190033

0x60806040526004361015610011575f80fd5b5f3560e01c8062fdd58e146101a357806301ffc9a71461019e57806306fdde03146101995780630e89341c14610194578063156e29f61461018f578063256929621461018a5780632eb2c2d6146101855780634e1273f41461018057806354d1f13d1461017b5780636b20c45414610176578063715018a614610171578063862440e21461016c5780638da5cb5b14610167578063938e3d7b1461016257806395d89b411461015d578063a22cb46514610158578063bdf7a8e614610153578063d81d0a151461014e578063e8a3d48514610149578063e985e9c514610144578063f04e283e1461013f578063f242432a1461013a578063f2fde38b14610135578063f5298aca146101305763fee81cf41461012b575f80fd5b6118e5565b6117c6565b611787565b6115bb565b61156a565b61151f565b61147a565b611313565b61118f565b611129565b611085565b610f50565b610f26565b610dcf565b610d5d565b610bf9565b610b5c565b610a4e565b6107a3565b6106c7565b610593565b610532565b610455565b61021a565b6101bd565b6001600160a01b038116036101b957565b5f80fd5b346101b95760403660031901126101b95760206101e86004356101df816101a8565b6024359061191b565b604051908152f35b7fffffffff000000000000000000000000000000000000000000000000000000008116036101b957565b346101b95760203660031901126101b95760207fffffffff0000000000000000000000000000000000000000000000000000000060043561025a816101f0565b167f01ffc9a70000000000000000000000000000000000000000000000000000000081149081156102c2575b8115610298575b506040519015158152f35b7f0e89341c000000000000000000000000000000000000000000000000000000009150145f61028d565b7fd9b67a260000000000000000000000000000000000000000000000000000000081149150610286565b90600182811c9216801561031a575b602083101461030657565b634e487b7160e01b5f52602260045260245ffd5b91607f16916102fb565b634e487b7160e01b5f52604160045260245ffd5b6020810190811067ffffffffffffffff82111761035457604052565b610324565b90601f8019910116810190811067ffffffffffffffff82111761035457604052565b9060405191825f825461038d816102ec565b908184526020946001916001811690815f146103fb57506001146103bd575b5050506103bb92500383610359565b565b5f90815285812095935091905b8183106103e35750506103bb93508201015f80806103ac565b855488840185015294850194879450918301916103ca565b925050506103bb94925060ff191682840152151560051b8201015f80806103ac565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b90602061045292818152019061041d565b90565b346101b9575f3660031901126101b9576040515f8054610474816102ec565b8084529060209060019081811690811561050857506001146104b1575b6104ad856104a181870382610359565b60405191829182610441565b0390f35b5f80805293507f290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e5635b8385106104f5575050505081016020016104a1826104ad610491565b80548686018401529382019381016104d9565b8695506104ad969350602092506104a194915060ff191682840152151560051b8201019293610491565b346101b95760203660031901126101b9576004355f5260036020526104ad61055c60405f2061037b565b60405191829160208352602083019061041d565b60609060031901126101b957600435610588816101a8565b906024359060443590565b346101b9576105a136610570565b6105ac929192611bad565b604051906105b982610338565b5f82526c0fffffffffffffffffffffffff84116106b8576001600160a01b038316156106b35780156106ae578061061185859060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b0161ffff81116106a957610651908585602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b825f6040518681528360208201527fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f6260403392a4823b61068d57005b61069e9361069a93611dff565b1590565b6106a457005b611b0d565b611ae5565b611abd565b611aaf565b63467777f160e11b5f5260045ffd5b5f3660031901126101b95763389a75e1600c52335f526202a30042016020600c2055337fdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d5f80a2005b9181601f840112156101b95782359167ffffffffffffffff83116101b9576020808501948460051b0101116101b957565b67ffffffffffffffff811161035457601f01601f191660200190565b81601f820112156101b95780359061077482610741565b926107826040519485610359565b828452602083830101116101b957815f926020809301838601378301015290565b346101b95760a03660031901126101b9576004356107c0816101a8565b602435906107cd826101a8565b67ffffffffffffffff6044358181116101b9576107ee903690600401610710565b90916064358181116101b957610808903690600401610710565b9290916084359081116101b95761082390369060040161075d565b936001600160a01b03808816908115610a0e57858403610a095787163381036109f1575b6108518989611c4a565b036108cd575b8686604051604081528460051b8060600160208301528560408301528085606084013781018760608201528660808960051b9201377f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb33918860061b60800190a4863b6108c057005b61069e9661069a96611f56565b5f5b8281106108dc5750610857565b6108e78184846119bb565b35906108f48187876119bb565b356c0fffffffffffffffffffffffff83116109ec57610934838a9060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b928382116109e75781610968828d9060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b019061ffff82116106a9576109b06109e19360019603828d602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b8b602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b016108cf565b611b85565b6106b8565b60408051898152336020820152205461084757611b5d565b610b34565b611b35565b60209060206040818301928281528551809452019301915f5b828110610a3a575050505090565b835185529381019392810192600101610a2c565b346101b95760403660031901126101b95767ffffffffffffffff6004358181116101b957610a80903690600401610710565b916024359081116101b957610a99903690600401610710565b9290838203610b3457610aab8261198f565b93610ab96040519586610359565b828552610ac58361198f565b60209390601f190136878601375f5b818110610ae957604051806104ad8982610a13565b610b13610af78284896119bb565b35610b01816101a8565b610b0c8386886119bb565b359061191b565b908751811015610b2f57600191868260051b8a01015201610ad4565b6119a7565b7fa24a13a6000000000000000000000000000000000000000000000000000000005f5260045ffd5b5f3660031901126101b95763389a75e1600c52335f525f6020600c2055337ffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c925f80a2005b9060606003198301126101b957600435610bb9816101a8565b9167ffffffffffffffff916024358381116101b95782610bdb91600401610710565b939093926044359182116101b957610bf591600401610710565b9091565b346101b957610c0736610ba0565b91909392610c13611bad565b6001600160a01b03841615610d5857828203610a0957610c3161197d565b50610c3b84611c02565b5f5b828110610cb25750905f947f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb9260405192604084528060051b9182918260600160208701526040860152606085013782019084606083015260808560051b920137339260061b60800190a4610cb061197d565b005b610cbd8184846119bb565b3590610cca8186896119bb565b35916c0fffffffffffffffffffffffff81116109ec57610d0b81889060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b90818411610d5357600193610d4d92039088602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b01610c3d565b611a87565b6118bd565b5f3660031901126101b957610d70611bad565b5f638b78c6d8198181547f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08280a355005b9181601f840112156101b95782359167ffffffffffffffff83116101b957602083818601950101116101b957565b346101b95760403660031901126101b95767ffffffffffffffff6004356024358281116101b957610e04903690600401610da1565b610e0f939193611bad565b825f52602093600360205260405f2092821161035457610e3982610e3385546102ec565b85611a38565b5f94601f8311600114610ebb5750610e6a92939482915f92610eb0575b50508160011b915f199060031b1c19161790565b90555b7f6bb7ff708619ba0610cba295a58592e0451dee2622938c8755667688daf3529b610eab6104a1610ea6845f52600360205260405f2090565b61037b565b0390a2005b013590505f80610e56565b90601f19831695610ecf855f5260205f2090565b925f905b888210610f0e57505083600195969710610ef5575b505050811b019055610e6d565b01355f19600384901b60f8161c191690555f8080610ee8565b80600184968294958701358155019501920190610ed3565b346101b9575f3660031901126101b9576020638b78c6d819546001600160a01b0360405191168152f35b346101b9576020806003193601126101b95767ffffffffffffffff6004358181116101b957610f83903690600401610da1565b91610f8c611bad565b821161035457610fa682610fa16004546102ec565b6119cb565b5f92601f8311600114610ffd5750610fd3925f9183610eb05750508160011b915f199060031b1c19161790565b6004555b7fa5d4097edda6d87cb9329af83fb3712ef77eeb13738ffe43cc35a4ce305ad9625f80a1005b90601f1983169361102f60045f527f8a35acfbc15ff81a39ae7d344fd709f28e8600b4aa8c65c6b64bfe7fe36bd19b90565b925f905b86821061106d5750508360019510611054575b505050811b01600455610fd7565b01355f19600384901b60f8161c191690555f8080611046565b80600184968294958701358155019501920190611033565b346101b9575f3660031901126101b9576040515f600180546110a6816102ec565b808552916020916001811690811561050857506001146110d0576104ad856104a181870382610359565b60015f90815293507fb10e2d527612073b26eecdfd717e6a320cf44b4afac2b0732d9fcbe2b7fa0cf65b838510611116575050505081016020016104a1826104ad610491565b80548686018401529382019381016110fa565b346101b95760403660031901126101b957600435611146816101a8565b60243580151581036101b9576040519033825282602083015280604083205581527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3160203392a3005b346101b9576040806003193601126101b95760049060043560243567ffffffffffffffff81116101b957906111c984923690600401610710565b9290936111d4611bad565b6c0fffffffffffffffffffffffff8311935f5b8181106111f057005b6111fb8183896119bb565b35611205816101a8565b83519061121182610338565b875f8352611305576001600160a01b038116156112f8576001908161125789839060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b019161ffff83116106a9575f829161129c8b958685602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b88519085825260208201527fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62893392a4803b6112de575b5050506001016111e7565b9161069a916112ec93611d4f565b6106a4578785816112d3565b85622e076360e81b5f525ffd5b8563467777f160e11b5f525ffd5b346101b95761132136610ba0565b9061132d949394611bad565b6040519261133a84610338565b5f84526001600160a01b038516156106b357828103610a09575f5b8181106113d35750845f604051604081528360051b806060016020830152846040830152808a606084013781018660608201528560808860051b9201377f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb33918760061b60800190a4843b6113c657005b61069e9561069a95611f22565b6113de8183896119bb565b35906113eb8186866119bb565b356c0fffffffffffffffffffffffff83116109ec5780156106ae5761143183899060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b019161ffff83116106a9576001926114749189602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b01611355565b346101b9575f3660031901126101b9576040515f60045461149a816102ec565b8084529060209060019081811690811561050857506001146114c6576104ad856104a181870382610359565b60045f90815293507f8a35acfbc15ff81a39ae7d344fd709f28e8600b4aa8c65c6b64bfe7fe36bd19b5b83851061150c575050505081016020016104a1826104ad610491565b80548686018401529382019381016114f0565b346101b95760403660031901126101b9576020611560600435611541816101a8565b6024359061154e826101a8565b60409182519182526020820152205490565b6040519015158152f35b60203660031901126101b957600435611582816101a8565b61158a611bad565b63389a75e1600c52805f526020600c2090815442116115ae575f610cb09255611bc9565b636f5e88185f526004601cfd5b346101b95760a03660031901126101b9576004356115d8816101a8565b602435906115e5826101a8565b60443560643560843567ffffffffffffffff81116101b95761160b90369060040161075d565b916c0fffffffffffffffffffffffff81116109ec576001600160a01b03808616908115610a0e57851633810361176f575b6116468787611c4a565b03611695575b84846040518381528460208201527fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f6260403392a4843b61168857005b61069e9461069a94611e30565b6116c081859060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b8083116109e757826116f383889060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b0161ffff81116106a9576117388461176a93038488602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b8287602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b61164c565b60408051878152336020820152205461163c57611b5d565b60203660031901126101b95760043561179f816101a8565b6117a7611bad565b8060601b156117b957610cb090611bc9565b637448fbae5f526004601cfd5b346101b9576117d436610570565b91906117de611bad565b6c0fffffffffffffffffffffffff81116106b8576001600160a01b038216156118bd575f60405161180e81610338565b5261181882611c02565b61184381839060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b92838111610d5357611884815f95038385602092604051918360041c9060601b179283835261ffff60f085549260041b1692831b921b191617928391015255565b60405191825260208201527fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f6260403392a4610cb061197d565b7fb817eee7000000000000000000000000000000000000000000000000000000005f5260045ffd5b346101b95760203660031901126101b957600435611902816101a8565b63389a75e1600c525f52602080600c2054604051908152f35b906001600160a01b0382161561195557610452919060f090604051928160041c9060601b1780935260041b169061ffff821b905416901c90565b7f8f4eb604000000000000000000000000000000000000000000000000000000005f5260045ffd5b6040519061198a82610338565b5f8252565b67ffffffffffffffff81116103545760051b60200190565b634e487b7160e01b5f52603260045260245ffd5b9190811015610b2f5760051b0190565b601f81116119d7575050565b60045f527f8a35acfbc15ff81a39ae7d344fd709f28e8600b4aa8c65c6b64bfe7fe36bd19b906020601f840160051c83019310611a2e575b601f0160051c01905b818110611a23575050565b5f8155600101611a18565b9091508190611a0f565b601f8211611a4557505050565b5f5260205f20906020601f840160051c83019310611a7d575b601f0160051c01905b818110611a72575050565b5f8155600101611a67565b9091508190611a5e565b7f588569f7000000000000000000000000000000000000000000000000000000005f5260045ffd5b622e076360e81b5f5260045ffd5b7fb562e8dd000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fb6cdf5d0000000000000000000000000000000000000000000000000000000005f5260045ffd5b7f9c05499b000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fea553b34000000000000000000000000000000000000000000000000000000005f5260045ffd5b7f59c896be000000000000000000000000000000000000000000000000000000005f5260045ffd5b7f169b037b000000000000000000000000000000000000000000000000000000005f5260045ffd5b638b78c6d819543303611bbc57565b6382b429005f526004601cfd5b6001600160a01b0316638b78c6d8198181547f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e05f80a355565b6001600160a01b0316151580611c43575b611c1957565b60046040517fa4420a95000000000000000000000000000000000000000000000000000000008152fd5b505f611c13565b6001600160a01b0380911615159182611c66575b5050611c1957565b16151590505f80611c5e565b908160209103126101b95751610452816101f0565b61045293926001600160a01b0360a0931682525f6020830152604082015260016060820152816080820152019061041d565b909260a0926001600160a01b0361045296951683525f602084015260408301526060820152816080820152019061041d565b919261045295949160a0946001600160a01b03809216855216602084015260408301526060820152816080820152019061041d565b3d15611d4a573d90611d3182610741565b91611d3f6040519384610359565b82523d5f602084013e565b606090565b611d7f6020916001600160a01b0393945f60405195868095819463f23a6e6160e01b9a8b84523360048501611c87565b0393165af15f9181611dce575b50611da857611d99611d20565b805115611b0d57805190602001fd5b7fffffffff00000000000000000000000000000000000000000000000000000000161490565b611df191925060203d602011611df8575b611de98183610359565b810190611c72565b905f611d8c565b503d611ddf565b9260209193611d7f935f6001600160a01b0360405180978196829563f23a6e6160e01b9b8c85523360048601611cb9565b9390611d7f935f6001600160a01b036020956040519788968795869363f23a6e6160e01b9c8d86523360048701611ceb565b90918281527f07ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff83116101b95760209260051b809284830137010190565b9490610452969492611edf946001600160a01b03611ed1931688525f602089015260a0604089015260a0880191611e62565b918583036060870152611e62565b91608081840391015261041d565b959192611edf94611ed1926104529997956001600160a01b038092168a5216602089015260a0604089015260a0880191611e62565b90949391925f6001600160a01b03602095611d7f6040519889978896879463bc197c8160e01b9d8e87523360048801611e9f565b956001600160a01b03602095949293611d7f5f93604051998a988997889563bc197c8160e01b9e8f88523360048901611eed56fea2646970667358221220d12f3a7fcb170874c477becbd6ae9bb759d30a0b22fbe26cacb2299926dd8f4a64736f6c63430008190033