ETH Price: $2,714.40 (+2.38%)

Contract

0xFc29813Beeb3c7395C7A5f8dfC3352491D5ea0E2
 

Overview

ETH Balance

1.37322 ETH

Eth Value

$3,727.47 (@ $2,714.40/ETH)

Token Holdings

Multichain Info

Transaction Hash
Method
Block
From
To
Burn Redeem218173622025-02-10 16:38:2316 hrs ago1739205503IN
0xFc29813B...91D5ea0E2
0.01099 ETH0.000248741.14581958
Burn Redeem218172802025-02-10 16:21:5917 hrs ago1739204519IN
0xFc29813B...91D5ea0E2
0.01099 ETH0.000451761.9799926
Initialize Burn ...218172592025-02-10 16:17:3517 hrs ago1739204255IN
0xFc29813B...91D5ea0E2
0 ETH0.001001412.08238972
Burn Redeem218100202025-02-09 16:01:2341 hrs ago1739116883IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000245881.42785526
Burn Redeem218092712025-02-09 13:31:1143 hrs ago1739107871IN
0xFc29813B...91D5ea0E2
0.00138 ETH0.000281951.30096831
Initialize Burn ...218085382025-02-09 11:04:3546 hrs ago1739099075IN
0xFc29813B...91D5ea0E2
0 ETH0.00053431.33948739
Update Burn Rede...218047462025-02-08 22:22:232 days ago1739053343IN
0xFc29813B...91D5ea0E2
0 ETH0.000239090.94423975
Initialize Burn ...217895182025-02-06 19:20:594 days ago1738869659IN
0xFc29813B...91D5ea0E2
0 ETH0.001087522.72642087
Burn Redeem217845062025-02-06 2:33:595 days ago1738809239IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000329921.95323289
Burn Redeem217699022025-02-04 1:36:237 days ago1738632983IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000858825.13019543
Burn Redeem217666752025-02-03 14:48:117 days ago1738594091IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.0044304726.28584034
Burn Redeem217535422025-02-01 18:44:359 days ago1738435475IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000410532.45247925
Burn Redeem217535352025-02-01 18:43:119 days ago1738435391IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000464952.7
Burn Redeem217535302025-02-01 18:42:119 days ago1738435331IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000485552.81962269
Burn Redeem217504652025-02-01 8:26:3510 days ago1738398395IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000404342.3937969
Burn Redeem217504492025-02-01 8:23:2310 days ago1738398203IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000354342.10230748
Burn Redeem217492622025-02-01 4:23:5910 days ago1738383839IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000294811.76107045
Airdrop217483132025-02-01 1:13:4710 days ago1738372427IN
0xFc29813B...91D5ea0E2
0 ETH0.000163212.02941331
Burn Redeem217453962025-01-31 15:26:5910 days ago1738337219IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.0023542513.93768792
Burn Redeem217453922025-01-31 15:26:1110 days ago1738337171IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.0022099313.20103502
Burn Redeem217453662025-01-31 15:20:5910 days ago1738336859IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.0020364111.74820866
Burn Redeem217453642025-01-31 15:20:3510 days ago1738336835IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.0020865112.03640828
Burn Redeem217419102025-01-31 3:44:3511 days ago1738295075IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000328531.89531736
Burn Redeem217419022025-01-31 3:42:5911 days ago1738294979IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000340061.96170657
Burn Redeem217418852025-01-31 3:39:3511 days ago1738294775IN
0xFc29813B...91D5ea0E2
0.01069 ETH0.000322291.8553587
View all transactions

Latest 25 internal transactions (View All)

Advanced mode:
Parent Transaction Hash Block
From
To
218173622025-02-10 16:38:2316 hrs ago1739205503
0xFc29813B...91D5ea0E2
0.01 ETH
218172802025-02-10 16:21:5917 hrs ago1739204519
0xFc29813B...91D5ea0E2
0.01 ETH
218100202025-02-09 16:01:2341 hrs ago1739116883
0xFc29813B...91D5ea0E2
0.01 ETH
217845062025-02-06 2:33:595 days ago1738809239
0xFc29813B...91D5ea0E2
0.01 ETH
217699022025-02-04 1:36:237 days ago1738632983
0xFc29813B...91D5ea0E2
0.01 ETH
217666752025-02-03 14:48:117 days ago1738594091
0xFc29813B...91D5ea0E2
0.01 ETH
217535422025-02-01 18:44:359 days ago1738435475
0xFc29813B...91D5ea0E2
0.01 ETH
217535352025-02-01 18:43:119 days ago1738435391
0xFc29813B...91D5ea0E2
0.01 ETH
217535302025-02-01 18:42:119 days ago1738435331
0xFc29813B...91D5ea0E2
0.01 ETH
217504652025-02-01 8:26:3510 days ago1738398395
0xFc29813B...91D5ea0E2
0.01 ETH
217504492025-02-01 8:23:2310 days ago1738398203
0xFc29813B...91D5ea0E2
0.01 ETH
217492622025-02-01 4:23:5910 days ago1738383839
0xFc29813B...91D5ea0E2
0.01 ETH
217453962025-01-31 15:26:5910 days ago1738337219
0xFc29813B...91D5ea0E2
0.01 ETH
217453922025-01-31 15:26:1110 days ago1738337171
0xFc29813B...91D5ea0E2
0.01 ETH
217453662025-01-31 15:20:5910 days ago1738336859
0xFc29813B...91D5ea0E2
0.01 ETH
217453642025-01-31 15:20:3510 days ago1738336835
0xFc29813B...91D5ea0E2
0.01 ETH
217419102025-01-31 3:44:3511 days ago1738295075
0xFc29813B...91D5ea0E2
0.01 ETH
217419022025-01-31 3:42:5911 days ago1738294979
0xFc29813B...91D5ea0E2
0.01 ETH
217418852025-01-31 3:39:3511 days ago1738294775
0xFc29813B...91D5ea0E2
0.01 ETH
217418782025-01-31 3:37:5911 days ago1738294679
0xFc29813B...91D5ea0E2
0.01 ETH
217406212025-01-30 23:25:3511 days ago1738279535
0xFc29813B...91D5ea0E2
0.01 ETH
217401082025-01-30 21:42:2311 days ago1738273343
0xFc29813B...91D5ea0E2
0.01 ETH
217401022025-01-30 21:41:1111 days ago1738273271
0xFc29813B...91D5ea0E2
0.01 ETH
217400962025-01-30 21:39:5911 days ago1738273199
0xFc29813B...91D5ea0E2
0.01 ETH
217350442025-01-30 4:44:3512 days ago1738212275
0xFc29813B...91D5ea0E2
0.01 ETH
View All Internal Transactions
Loading...
Loading

Contract Source Code Verified (Exact Match)

Contract Name:
ERC1155BurnRedeem

Compiler Version
v0.8.17+commit.8df45f5f

Optimization Enabled:
Yes with 150 runs

Other Settings:
default evmVersion
File 1 of 29 : ERC1155BurnRedeem.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

import "@manifoldxyz/creator-core-solidity/contracts/core/IERC1155CreatorCore.sol";

import "./BurnRedeemCore.sol";
import "./BurnRedeemLib.sol";
import "./IERC1155BurnRedeem.sol";

contract ERC1155BurnRedeem is BurnRedeemCore, IERC1155BurnRedeem {
    using Strings for uint256;

    // { creatorContractAddress => { instanceId =>  tokenId } }
    mapping(address => mapping(uint256 => uint256)) private _redeemTokenIds;
    // { creatorContractAddress => { tokenId =>  instanceId } }
    mapping(address => mapping(uint256 => uint256)) private _redeemInstanceIds;

    constructor(address initialOwner) BurnRedeemCore(initialOwner) {}

    function supportsInterface(bytes4 interfaceId) public view virtual override(BurnRedeemCore, IERC165) returns (bool) {
        return interfaceId == type(IERC1155BurnRedeem).interfaceId || super.supportsInterface(interfaceId);
    }

    /**
     * See {IERC1155BurnRedeem-initializeBurnRedeem}.
     */
    function initializeBurnRedeem(
        address creatorContractAddress,
        uint256 instanceId,
        BurnRedeemParameters calldata burnRedeemParameters
    ) external override {
        _validateAdmin(creatorContractAddress);
        _initialize(creatorContractAddress, 0, instanceId, burnRedeemParameters);

        // Mint a new token with amount '0' to the creator
        address[] memory receivers = new address[](1);
        receivers[0] = msg.sender;
        string[] memory uris = new string[](1);
        uint256[] memory amounts = new uint256[](1);
        uint256[] memory newTokenIds = IERC1155CreatorCore(creatorContractAddress).mintExtensionNew(receivers, amounts, uris);
        _redeemTokenIds[creatorContractAddress][instanceId] = newTokenIds[0];
        _redeemInstanceIds[creatorContractAddress][newTokenIds[0]] = instanceId;
    }

    /**
     * See {IERC1155BurnRedeem-updateBurnRedeem}.
     */
    function updateBurnRedeem(
        address creatorContractAddress,
        uint256 instanceId,
        BurnRedeemParameters calldata burnRedeemParameters
    ) external override {
        _validateAdmin(creatorContractAddress);
        _update(creatorContractAddress, instanceId, burnRedeemParameters);
    }

    /**
     * See {IERC1155BurnRedeem-updateURI}.
     */
    function updateURI(
        address creatorContractAddress,
        uint256 instanceId,
        StorageProtocol storageProtocol,
        string calldata location
    ) external override {
        _validateAdmin(creatorContractAddress);
        BurnRedeem storage burnRedeemInstance = _getBurnRedeem(creatorContractAddress, instanceId);
        burnRedeemInstance.storageProtocol = storageProtocol;
        burnRedeemInstance.location = location;
        emit BurnRedeemLib.BurnRedeemUpdated(creatorContractAddress, instanceId);
    }

    /**
     * Helper to mint multiple redeem tokens
     */
    function _redeem(address creatorContractAddress, uint256 instanceId, BurnRedeem storage burnRedeemInstance, address to, uint32 count, bytes memory data) internal override {
        address[] memory addresses = new address[](1);
        addresses[0] = to;
        uint256[] memory tokenIds = new uint256[](1);
        tokenIds[0] = _redeemTokenIds[creatorContractAddress][instanceId];
        uint256[] memory values = new uint256[](1);
        values[0] = burnRedeemInstance.redeemAmount * count;
        
        IERC1155CreatorCore(creatorContractAddress).mintExtensionExisting(addresses, tokenIds, values);
        burnRedeemInstance.redeemedCount += uint32(values[0]);

        emit BurnRedeemLib.BurnRedeemMint(creatorContractAddress, instanceId, tokenIds[0], uint32(values[0]), data);
    }

    /**
     * See {ICreatorExtensionTokenURI-tokenURI}.
     */
    function tokenURI(address creatorContractAddress, uint256 tokenId) external override view returns(string memory uri) {
        uint256 instanceId = _getRedeemInstanceId(creatorContractAddress, tokenId);
        BurnRedeem memory burnRedeem = _burnRedeems[creatorContractAddress][instanceId];

        string memory prefix = "";
        if (burnRedeem.storageProtocol == StorageProtocol.ARWEAVE) {
            prefix = ARWEAVE_PREFIX;
        } else if (burnRedeem.storageProtocol == StorageProtocol.IPFS) {
            prefix = IPFS_PREFIX;
        }
        uri = string(abi.encodePacked(prefix, burnRedeem.location));
    }

    /**
     * See {IBurnRedeemCore-getBurnRedeemForToken}.
     */
    function getBurnRedeemForToken(address creatorContractAddress, uint256 tokenId) external override view returns(uint256 instanceId, BurnRedeem memory burnRedeem) {
        instanceId = _getRedeemInstanceId(creatorContractAddress, tokenId);
        burnRedeem = _burnRedeems[creatorContractAddress][instanceId];
    }

    /**
     * See {IBurnRedeemCore-getBurnRedeemToken}.
     */
    function getBurnRedeemToken(address creatorContractAddress, uint256 instanceId) external override view returns(uint256 tokenId) {
        tokenId = _redeemTokenIds[creatorContractAddress][instanceId];
        if (tokenId == 0) {
            revert BurnRedeemDoesNotExist(instanceId);
        }
    }

    function _getRedeemInstanceId(address creatorContractAddress, uint256 tokenId) internal view returns(uint256 instanceId) {
        instanceId = _redeemInstanceIds[creatorContractAddress][tokenId];
        if (instanceId == 0) {
            revert InvalidToken(tokenId);
        }
    }
}

File 2 of 29 : IERC1155CreatorCore.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "./CreatorCore.sol";

/**
 * @dev Core ERC1155 creator interface
 */
interface IERC1155CreatorCore is ICreatorCore {

    /**
     * @dev mint a token with no extension. Can only be called by an admin.
     *
     * @param to       - Can be a single element array (all tokens go to same address) or multi-element array (single token to many recipients)
     * @param amounts  - Can be a single element array (all recipients get the same amount) or a multi-element array
     * @param uris     - If no elements, all tokens use the default uri.
     *                   If any element is an empty string, the corresponding token uses the default uri.
     *
     *
     * Requirements: If to is a multi-element array, then uris must be empty or single element array
     *               If to is a multi-element array, then amounts must be a single element array or a multi-element array of the same size
     *               If to is a single element array, uris must be empty or the same length as amounts
     *
     * Examples:
     *    mintBaseNew(['0x....1', '0x....2'], [1], [])
     *        Mints a single new token, and gives 1 each to '0x....1' and '0x....2'.  Token uses default uri.
     *    
     *    mintBaseNew(['0x....1', '0x....2'], [1, 2], [])
     *        Mints a single new token, and gives 1 to '0x....1' and 2 to '0x....2'.  Token uses default uri.
     *    
     *    mintBaseNew(['0x....1'], [1, 2], ["", "http://token2.com"])
     *        Mints two new tokens to '0x....1'. 1 of the first token, 2 of the second.  1st token uses default uri, second uses "http://token2.com".
     *    
     * @return Returns list of tokenIds minted
     */
    function mintBaseNew(address[] calldata to, uint256[] calldata amounts, string[] calldata uris) external returns (uint256[] memory);

    /**
     * @dev batch mint existing token with no extension. Can only be called by an admin.
     *
     * @param to        - Can be a single element array (all tokens go to same address) or multi-element array (single token to many recipients)
     * @param tokenIds  - Can be a single element array (all recipients get the same token) or a multi-element array
     * @param amounts   - Can be a single element array (all recipients get the same amount) or a multi-element array
     *
     * Requirements: If any of the parameters are multi-element arrays, they need to be the same length as other multi-element arrays
     *
     * Examples:
     *    mintBaseExisting(['0x....1', '0x....2'], [1], [10])
     *        Mints 10 of tokenId 1 to each of '0x....1' and '0x....2'.
     *    
     *    mintBaseExisting(['0x....1', '0x....2'], [1, 2], [10, 20])
     *        Mints 10 of tokenId 1 to '0x....1' and 20 of tokenId 2 to '0x....2'.
     *    
     *    mintBaseExisting(['0x....1'], [1, 2], [10, 20])
     *        Mints 10 of tokenId 1 and 20 of tokenId 2 to '0x....1'.
     *    
     *    mintBaseExisting(['0x....1', '0x....2'], [1], [10, 20])
     *        Mints 10 of tokenId 1 to '0x....1' and 20 of tokenId 1 to '0x....2'.
     *    
     */
    function mintBaseExisting(address[] calldata to, uint256[] calldata tokenIds, uint256[] calldata amounts) external;

    /**
     * @dev mint a token from an extension. Can only be called by a registered extension.
     *
     * @param to       - Can be a single element array (all tokens go to same address) or multi-element array (single token to many recipients)
     * @param amounts  - Can be a single element array (all recipients get the same amount) or a multi-element array
     * @param uris     - If no elements, all tokens use the default uri.
     *                   If any element is an empty string, the corresponding token uses the default uri.
     *
     *
     * Requirements: If to is a multi-element array, then uris must be empty or single element array
     *               If to is a multi-element array, then amounts must be a single element array or a multi-element array of the same size
     *               If to is a single element array, uris must be empty or the same length as amounts
     *
     * Examples:
     *    mintExtensionNew(['0x....1', '0x....2'], [1], [])
     *        Mints a single new token, and gives 1 each to '0x....1' and '0x....2'.  Token uses default uri.
     *    
     *    mintExtensionNew(['0x....1', '0x....2'], [1, 2], [])
     *        Mints a single new token, and gives 1 to '0x....1' and 2 to '0x....2'.  Token uses default uri.
     *    
     *    mintExtensionNew(['0x....1'], [1, 2], ["", "http://token2.com"])
     *        Mints two new tokens to '0x....1'. 1 of the first token, 2 of the second.  1st token uses default uri, second uses "http://token2.com".
     *    
     * @return Returns list of tokenIds minted
     */
    function mintExtensionNew(address[] calldata to, uint256[] calldata amounts, string[] calldata uris) external returns (uint256[] memory);

    /**
     * @dev batch mint existing token from extension. Can only be called by a registered extension.
     *
     * @param to        - Can be a single element array (all tokens go to same address) or multi-element array (single token to many recipients)
     * @param tokenIds  - Can be a single element array (all recipients get the same token) or a multi-element array
     * @param amounts   - Can be a single element array (all recipients get the same amount) or a multi-element array
     *
     * Requirements: If any of the parameters are multi-element arrays, they need to be the same length as other multi-element arrays
     *
     * Examples:
     *    mintExtensionExisting(['0x....1', '0x....2'], [1], [10])
     *        Mints 10 of tokenId 1 to each of '0x....1' and '0x....2'.
     *    
     *    mintExtensionExisting(['0x....1', '0x....2'], [1, 2], [10, 20])
     *        Mints 10 of tokenId 1 to '0x....1' and 20 of tokenId 2 to '0x....2'.
     *    
     *    mintExtensionExisting(['0x....1'], [1, 2], [10, 20])
     *        Mints 10 of tokenId 1 and 20 of tokenId 2 to '0x....1'.
     *    
     *    mintExtensionExisting(['0x....1', '0x....2'], [1], [10, 20])
     *        Mints 10 of tokenId 1 to '0x....1' and 20 of tokenId 1 to '0x....2'.
     *    
     */
    function mintExtensionExisting(address[] calldata to, uint256[] calldata tokenIds, uint256[] calldata amounts) external;

    /**
     * @dev burn tokens. Can only be called by token owner or approved address.
     * On burn, calls back to the registered extension's onBurn method
     */
    function burn(address account, uint256[] calldata tokenIds, uint256[] calldata amounts) external;

    /**
     * @dev Total amount of tokens in with a given tokenId.
     */
    function totalSupply(uint256 tokenId) external view returns (uint256);
}

File 3 of 29 : BurnRedeemCore.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/////////////////////////////////////////////////////////////////////////////////////
//                                                                                 //
//                                                                                 //
//                                     .%(#.                                       //
//                                      #(((#%,                                    //
//                                      (#(((((#%*                                 //
//                                      /#((((((((##*                              //
//                                      (#((((((((((##%.                           //
//                                     ,##(/*/(////((((#%*                         //
//                                   .###(//****/////(((##%,                       //
//                  (,          ,%#((((((///******/////((##%(                      //
//                *((,         ,##(///////*********////((###%*                     //
//              /((((         ,##(//////************/(((((###%                     //
//             /((((         ,##((////***************/((((###%                     //
//             (((          .###((///*****************((((####                     //
//             .            (##((//*******************((((##%*                     //
//               (#.       .###((/********************((((##%.      %.             //
//             ,%(#.       .###(/********,,,,,,,*****/(((###%#     ((%,            //
//            /%#/(/       /###(//****,,,,,,,,,,,****/((((((##%%%%#((#%.           //
//           /##(//(#.    ,###((/****,,,,,,,,,,,,,***/((/(((((((((#####%           //
//          *%##(/////((###((((/***,,,,,,,,,,,,,,,***//((((((((((####%%%/          //
//          ####(((//////(//////**,,,,,,.....,,,,,,****/(((((//((####%%%%          //
//         .####(((/((((((/////**,,,,,.......,,,,,,,,*****/////(#####%%%%          //
//         .#%###((////(((//***,,,,,,..........,,,,,,,,*****//((#####%%%%          //
//          /%%%###/////*****,,,,,,,..............,,,,,,,****/(((####%%%%          //
//           /%%###(////****,,,,,,.....        ......,,,,,,**(((####%%%%           //
//            ,#%###(///****,,,,,....            .....,,,,,***/(/(##%%(            //
//              (####(//****,,....                 ....,,,,,***/(####              //
//                (###(/***,,,...                    ...,,,,***(##/                //
//             #.   (#((/**,,,,..                    ...,,,,*((#,                  //
//               ,#(##(((//,,,,..                   ...,,,*/(((#((/                //
//                  *#(((///*,,....                ....,*//((((                    //
//                      *(///***,....            ...,***//,                        //
//                           ,//***,...       ..,,*,                               //
//                                                                                 //
//                                                                                 //
/////////////////////////////////////////////////////////////////////////////////////

import "@manifoldxyz/creator-core-solidity/contracts/extensions/ICreatorExtensionTokenURI.sol";
import "@manifoldxyz/libraries-solidity/contracts/access/AdminControl.sol";
import "@manifoldxyz/libraries-solidity/contracts/access/IAdminControl.sol";

import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/security/ReentrancyGuard.sol";
import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
import "@openzeppelin/contracts/token/ERC1155/IERC1155.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "@openzeppelin/contracts/utils/introspection/ERC165.sol";

import ".././libraries/manifold-membership/IManifoldMembership.sol";
import "./BurnRedeemLib.sol";
import "./IBurnRedeemCore.sol";
import "./Interfaces.sol";

/**
 * @title Burn Redeem Core
 * @author manifold.xyz
 * @notice Core logic for Burn Redeem shared extensions.
 */
abstract contract BurnRedeemCore is ERC165, AdminControl, ReentrancyGuard, IBurnRedeemCore, ICreatorExtensionTokenURI {
    using Strings for uint256;

    uint256 public constant BURN_FEE = 690000000000000;
    uint256 public constant MULTI_BURN_FEE = 990000000000000;

    string internal constant ARWEAVE_PREFIX = "https://arweave.net/";
    string internal constant IPFS_PREFIX = "ipfs://";

    uint256 internal constant MAX_UINT_16 = 0xffff;
    uint256 internal constant MAX_UINT_24 = 0xffffff;
    uint256 internal constant MAX_UINT_32 = 0xffffffff;
    uint256 internal constant MAX_UINT_56 = 0xffffffffffffff;
    uint256 internal constant MAX_UINT_256 = 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff;

    // { creatorContractAddress => { instanceId => BurnRedeem } }
    mapping(address => mapping(uint256 => BurnRedeem)) internal _burnRedeems;

    address public manifoldMembershipContract;

    constructor(address initialOwner) {
        _transferOwnership(initialOwner);
    }

    function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165, AdminControl) returns (bool) {
        return interfaceId == type(IBurnRedeemCore).interfaceId ||
            interfaceId == type(IERC721Receiver).interfaceId ||
            interfaceId == type(IERC1155Receiver).interfaceId ||
            interfaceId == type(ICreatorExtensionTokenURI).interfaceId ||
            super.supportsInterface(interfaceId);
    }

    /**
     * @notice This extension is shared, not single-creator. So we must ensure
     * that a burn redeems's initializer is an admin on the creator contract
     * @param creatorContractAddress    the address of the creator contract to check the admin against
     */
    function _validateAdmin(address creatorContractAddress) internal view {
        if (!IAdminControl(creatorContractAddress).isAdmin(msg.sender)) {
            revert NotAdmin(creatorContractAddress);
        }
    }

    /**
     * Initialiazes a burn redeem with base parameters
     */
    function _initialize(
        address creatorContractAddress,
        uint8 creatorContractVersion,
        uint256 instanceId,
        BurnRedeemParameters calldata burnRedeemParameters
    ) internal {
        BurnRedeemLib.initialize(creatorContractAddress, creatorContractVersion, instanceId, _burnRedeems[creatorContractAddress][instanceId], burnRedeemParameters);
    }

    /**
     * Updates a burn redeem with base parameters
     */
    function _update(
        address creatorContractAddress,
        uint256 instanceId,
        BurnRedeemParameters calldata burnRedeemParameters
    ) internal {
        BurnRedeemLib.update(creatorContractAddress, instanceId, _getBurnRedeem(creatorContractAddress, instanceId), burnRedeemParameters);
    }

    /**
     * See {IBurnRedeemCore-getBurnRedeem}.
     */
    function getBurnRedeem(address creatorContractAddress, uint256 instanceId) external override view returns(BurnRedeem memory) {
        return _getBurnRedeem(creatorContractAddress, instanceId);
    }

    /**
     * Helper to get burn redeem instance
     */
    function _getBurnRedeem(address creatorContractAddress, uint256 instanceId) internal view returns(BurnRedeem storage burnRedeemInstance) {
        burnRedeemInstance = _burnRedeems[creatorContractAddress][instanceId];
        if (burnRedeemInstance.storageProtocol == StorageProtocol.INVALID) {
            revert BurnRedeemDoesNotExist(instanceId);
        }
    }

    /**
     * Helper to get active burn redeem instance
     */
    function _getActiveBurnRedeem(address creatorContractAddress, uint256 instanceId) private view returns(BurnRedeem storage burnRedeemInstance) {
        burnRedeemInstance = _getBurnRedeem(creatorContractAddress, instanceId);
        if (burnRedeemInstance.startDate > block.timestamp || (block.timestamp >= burnRedeemInstance.endDate && burnRedeemInstance.endDate != 0)) {
            revert BurnRedeemInactive(instanceId);
        }
    }

    /**
     * See {IBurnRedeemCore-burnRedeem}.
     */
    function burnRedeem(address creatorContractAddress, uint256 instanceId, uint32 burnRedeemCount, BurnToken[] calldata burnTokens) external payable override nonReentrant {
        uint256 payableCost = _burnRedeem(msg.value, creatorContractAddress, instanceId, burnRedeemCount, burnTokens, _isActiveMember(msg.sender), true, "");
        if (msg.value > payableCost) {
            _forwardValue(payable(msg.sender), msg.value - payableCost);
        }
    }

    /**
     * (Batch overload) see {IBurnRedeemCore-burnRedeem}.
     */
    function burnRedeem(address[] calldata creatorContractAddresses, uint256[] calldata instanceIds, uint32[] calldata burnRedeemCounts, BurnToken[][] calldata burnTokens) external payable override nonReentrant {
        if (creatorContractAddresses.length != instanceIds.length ||
            creatorContractAddresses.length != burnRedeemCounts.length ||
            creatorContractAddresses.length != burnTokens.length) {
            revert InvalidInput();
        }

        bool isActiveMember = _isActiveMember(msg.sender);
        uint256 msgValueRemaining = msg.value;
        for (uint256 i; i < creatorContractAddresses.length;) {
            msgValueRemaining -= _burnRedeem(msgValueRemaining, creatorContractAddresses[i], instanceIds[i], burnRedeemCounts[i], burnTokens[i], isActiveMember, false, "");
            unchecked { ++i; }
        }

        if (msgValueRemaining != 0) {
            _forwardValue(payable(msg.sender), msgValueRemaining);
        }
    }

    /**
     * See {IBurnRedeemCore-burnRedeemWithData}.
     */
    function burnRedeemWithData(address creatorContractAddress, uint256 instanceId, uint32 burnRedeemCount, BurnToken[] calldata burnTokens, bytes calldata data) external payable override nonReentrant {
        uint256 payableCost = _burnRedeem(msg.value, creatorContractAddress, instanceId, burnRedeemCount, burnTokens, _isActiveMember(msg.sender), true, data);
        if (msg.value > payableCost) {
            _forwardValue(payable(msg.sender), msg.value - payableCost);
        }
    }

    /**
     * See {IBurnRedeemCore-airdrop}.
     */
    function airdrop(address creatorContractAddress, uint256 instanceId, address[] calldata recipients, uint32[] calldata amounts) external override {
        _validateAdmin(creatorContractAddress);
        if (recipients.length != amounts.length) {
            revert InvalidInput();
        }
        BurnRedeem storage burnRedeemInstance = _getBurnRedeem(creatorContractAddress, instanceId);

        uint256 totalAmount;
        for (uint256 i; i < amounts.length;) {
            totalAmount += amounts[i] * burnRedeemInstance.redeemAmount;
            unchecked{ ++i; }
        }
        if (totalAmount + burnRedeemInstance.redeemedCount > MAX_UINT_32) {
            revert InvalidRedeemAmount();
        }

        // Airdrop the tokens
        for (uint256 i; i < recipients.length;) {
            _redeem(creatorContractAddress, instanceId, burnRedeemInstance, recipients[i], amounts[i], "");
            unchecked{ ++i; }
        }

        BurnRedeemLib.syncTotalSupply(burnRedeemInstance);
    }

    function _burnRedeem(uint256 msgValue, address creatorContractAddress, uint256 instanceId, uint32 burnRedeemCount, BurnToken[] calldata burnTokens, bool isActiveMember, bool revertNoneRemaining, bytes memory data) private returns (uint256) {
        BurnRedeem storage burnRedeemInstance = _getActiveBurnRedeem(creatorContractAddress, instanceId);

        // Get the amount that can be burned
        burnRedeemCount = _getAvailableBurnRedeemCount(burnRedeemInstance.totalSupply, burnRedeemInstance.redeemedCount, burnRedeemInstance.redeemAmount, burnRedeemCount, revertNoneRemaining);
        if (burnRedeemCount == 0) {
            return 0;
        }

        uint256 payableCost = burnRedeemInstance.cost;
        uint256 cost = burnRedeemInstance.cost;
        if (!isActiveMember) {
            payableCost += burnTokens.length <= 1 ? BURN_FEE : MULTI_BURN_FEE;
        }
        if (burnRedeemCount > 1) {
            payableCost *= burnRedeemCount;
            cost *= burnRedeemCount;
        }
        if (payableCost > msgValue) {
            revert InvalidPaymentAmount();
        }
        if (cost > 0) {
            _forwardValue(burnRedeemInstance.paymentReceiver, cost);
        }

        // Do burn redeem
        _burnTokens(burnRedeemInstance, burnTokens, burnRedeemCount, msg.sender, data);
        _redeem(creatorContractAddress, instanceId, burnRedeemInstance, msg.sender, burnRedeemCount, data);

        return payableCost;
    }

    /**
     * @dev See {IBurnRedeemCore-recoverERC721}.
     */
    function recoverERC721(address tokenAddress, uint256 tokenId, address destination) external override adminRequired {
        IERC721(tokenAddress).transferFrom(address(this), destination, tokenId);
    }

    /**
     * @dev See {IBurnRedeemCore-withdraw}.
     */
    function withdraw(address payable recipient, uint256 amount) external override adminRequired {
        _forwardValue(recipient, amount);
    }

    /**
     * @dev See {IBurnRedeemCore-setManifoldMembership}.
     */
    function setMembershipAddress(address addr) external override adminRequired {
        manifoldMembershipContract = addr;
    }

    /**
     * @dev See {IERC721Receiver-onERC721Received}.
     */
    function onERC721Received(
        address,
        address from,
        uint256 id,
        bytes calldata data
    ) external override nonReentrant returns(bytes4) {
        _onERC721Received(from, id, data);
        return this.onERC721Received.selector;
    }

    /**
     * @dev See {IERC1155Receiver-onERC1155Received}.
     */
    function onERC1155Received(
        address,
        address from,
        uint256 id,
        uint256 value,
        bytes calldata data
    ) external override nonReentrant returns(bytes4) {
        // Check calldata is valid
        if (data.length % 32 != 0) {
            revert InvalidData();
        }

        address creatorContractAddress;
        uint256 instanceId;
        uint32 burnRedeemCount;
        uint256 burnItemIndex;
        bytes32[] memory merkleProof;
        (creatorContractAddress, instanceId, burnRedeemCount, burnItemIndex, merkleProof) = abi.decode(data, (address, uint256, uint32, uint256, bytes32[]));

        // Do burn redeem
        _onERC1155Received(from, id, value, creatorContractAddress, instanceId, burnRedeemCount, burnItemIndex, merkleProof);

        return this.onERC1155Received.selector;
    }

    /**
     * @dev See {IERC1155Receiver-onERC1155BatchReceived}.
     */
    function onERC1155BatchReceived(
        address,
        address from,
        uint256[] calldata ids,
        uint256[] calldata values,
        bytes calldata data
    ) external override nonReentrant returns(bytes4) {
        // Check calldata is valid
        if (data.length % 32 != 0) {
            revert InvalidData();
        }

        address creatorContractAddress;
        uint256 instanceId;
        uint32 burnRedeemCount;
        BurnToken[] memory burnTokens;
        (creatorContractAddress, instanceId, burnRedeemCount, burnTokens) = abi.decode(data, (address, uint256, uint32, BurnToken[]));

        // Do burn redeem
        _onERC1155BatchReceived(from, ids, values, creatorContractAddress, instanceId, burnRedeemCount, burnTokens);

        return this.onERC1155BatchReceived.selector;
    }

    /**
     * @notice ERC721 token transfer callback
     * @param from      the person sending the tokens
     * @param id        the token id of the burn token
     * @param data      bytes indicating the target burnRedeem and, optionally, a merkle proof that the token is valid
     */
    function _onERC721Received(
        address from,
        uint256 id,
        bytes calldata data
    ) private {
        // Check calldata is valid
        if (data.length % 32 != 0) {
            revert InvalidData();
        }

        address creatorContractAddress;
        uint256 instanceId;
        uint256 burnItemIndex;
        bytes32[] memory merkleProof;
        (creatorContractAddress, instanceId, burnItemIndex, merkleProof) = abi.decode(data, (address, uint256, uint256, bytes32[]));

        BurnRedeem storage burnRedeemInstance = _getActiveBurnRedeem(creatorContractAddress, instanceId);

        // A single ERC721 can only be sent in directly for a burn if:
        // 1. There is no cost to the burn (because no payment can be sent with a transfer)
        // 2. The burn only requires one NFT (one burnSet element and one count)
        // 3. They are an active member (because no fee payment can be sent with a transfer)
        _validateReceivedInput(burnRedeemInstance.cost, burnRedeemInstance.burnSet.length, burnRedeemInstance.burnSet[0].requiredCount, from);

        _getAvailableBurnRedeemCount(burnRedeemInstance.totalSupply, burnRedeemInstance.redeemedCount, burnRedeemInstance.redeemAmount, 1, true);

        // Check that the burn token is valid
        BurnItem memory burnItem = burnRedeemInstance.burnSet[0].items[burnItemIndex];

        // Can only take in one burn item
        if (burnItem.tokenSpec != TokenSpec.ERC721) {
            revert InvalidInput();
        }
        BurnRedeemLib.validateBurnItem(burnItem, msg.sender, id, merkleProof);

        // Do burn and redeem
        _burn(burnItem, address(this), msg.sender, id, 1, "");
        _redeem(creatorContractAddress, instanceId, burnRedeemInstance, from, 1, "");
    }

    /**
     * Execute onERC1155Received burn/redeem
     */
    function _onERC1155Received(address from, uint256 tokenId, uint256 value, address creatorContractAddress, uint256 instanceId, uint32 burnRedeemCount, uint256 burnItemIndex, bytes32[] memory merkleProof) private {
        BurnRedeem storage burnRedeemInstance = _getActiveBurnRedeem(creatorContractAddress, instanceId);

        // A single 1155 can only be sent in directly for a burn if:
        // 1. There is no cost to the burn (because no payment can be sent with a transfer)
        // 2. The burn only requires one NFT (one burn set element and one required count in the set)
        // 3. They are an active member (because no fee payment can be sent with a transfer)
        _validateReceivedInput(burnRedeemInstance.cost, burnRedeemInstance.burnSet.length, burnRedeemInstance.burnSet[0].requiredCount, from);

        uint32 availableBurnRedeemCount = _getAvailableBurnRedeemCount(burnRedeemInstance.totalSupply, burnRedeemInstance.redeemedCount, burnRedeemInstance.redeemAmount, burnRedeemCount, true);

        // Check that the burn token is valid
        BurnItem memory burnItem = burnRedeemInstance.burnSet[0].items[burnItemIndex];
        if (value != burnItem.amount * burnRedeemCount) {
            revert InvalidBurnAmount();
        }
        BurnRedeemLib.validateBurnItem(burnItem, msg.sender, tokenId, merkleProof);

        _burn(burnItem, address(this), msg.sender, tokenId, availableBurnRedeemCount, "");
        _redeem(creatorContractAddress, instanceId, burnRedeemInstance, from, availableBurnRedeemCount, "");

        // Return excess amount
        if (availableBurnRedeemCount != burnRedeemCount) {
            IERC1155(msg.sender).safeTransferFrom(address(this), from, tokenId, (burnRedeemCount - availableBurnRedeemCount) * burnItem.amount, "");
        }
    }

    /**
     * Execute onERC1155BatchReceived burn/redeem
     */
    function _onERC1155BatchReceived(address from, uint256[] calldata tokenIds, uint256[] calldata values, address creatorContractAddress, uint256 instanceId, uint32 burnRedeemCount, BurnToken[] memory burnTokens) private {
        BurnRedeem storage burnRedeemInstance = _getActiveBurnRedeem(creatorContractAddress, instanceId);

        // A single 1155 can only be sent in directly for a burn if:
        // 1. There is no cost to the burn (because no payment can be sent with a transfer)
        // 2. We have the right data length
        // 3. They are an active member (because no fee payment can be sent with a transfer)
        if (burnRedeemInstance.cost != 0 || burnTokens.length != tokenIds.length || !_isActiveMember(from)) {
            revert InvalidInput();
        }
        uint32 availableBurnRedeemCount = _getAvailableBurnRedeemCount(burnRedeemInstance.totalSupply, burnRedeemInstance.redeemedCount, burnRedeemInstance.redeemAmount, burnRedeemCount, true);

        // Verify the values match what is needed
        uint256[] memory returnValues = new uint256[](tokenIds.length);
        for (uint256 i; i < burnTokens.length;) {
            BurnToken memory burnToken = burnTokens[i];
            BurnItem memory burnItem = burnRedeemInstance.burnSet[burnToken.groupIndex].items[burnToken.itemIndex];
            if (burnToken.id != tokenIds[i]) {
                revert InvalidToken(tokenIds[i]);
            }
            if (burnItem.amount * burnRedeemCount != values[i]) {
                revert InvalidRedeemAmount();
            }
            if (availableBurnRedeemCount != burnRedeemCount) {
                returnValues[i] = values[i] - burnItem.amount * availableBurnRedeemCount;
            }
            unchecked { ++i; }
        }

        // Do burn redeem
        _burnTokens(burnRedeemInstance, burnTokens, availableBurnRedeemCount, address(this), "");
        _redeem(creatorContractAddress, instanceId, burnRedeemInstance, from, availableBurnRedeemCount, "");

        // Return excess amount
        if (availableBurnRedeemCount != burnRedeemCount) {
            IERC1155(msg.sender).safeBatchTransferFrom(address(this), from, tokenIds, returnValues, "");
        }
    }

    function _validateReceivedInput(uint256 cost, uint256 length, uint256 requiredCount, address from) private view {
        if (cost != 0 || length != 1 || requiredCount != 1 || !_isActiveMember(from)) {
            revert InvalidInput();
        }
    }

    /**
     * Send funds to receiver
     */
    function _forwardValue(address payable receiver, uint256 amount) private {
        (bool sent, ) = receiver.call{value: amount}("");
        if (!sent) {
            revert TransferFailure();
        }
    }

    /**
     * Burn all listed tokens and check that the burn set is satisfied
     */
    function _burnTokens(BurnRedeem storage burnRedeemInstance, BurnToken[] memory burnTokens, uint256 burnRedeemCount, address owner, bytes memory data) private {
        // Check that each group in the burn set is satisfied
        uint256[] memory groupCounts = new uint256[](burnRedeemInstance.burnSet.length);

        for (uint256 i; i < burnTokens.length;) {
            BurnToken memory burnToken = burnTokens[i];
            BurnItem memory burnItem = burnRedeemInstance.burnSet[burnToken.groupIndex].items[burnToken.itemIndex];

            BurnRedeemLib.validateBurnItem(burnItem, burnToken.contractAddress, burnToken.id, burnToken.merkleProof);

            _burn(burnItem, owner, burnToken.contractAddress, burnToken.id, burnRedeemCount, data);
            groupCounts[burnToken.groupIndex] += burnRedeemCount;

            unchecked { ++i; }
        }

        for (uint256 i; i < groupCounts.length;) {
            if (groupCounts[i] != burnRedeemInstance.burnSet[i].requiredCount * burnRedeemCount) {
                revert InvalidBurnAmount();
            }
            unchecked { ++i; }
        }
    }

    /**
     * Helper to check if the sender holds an active Manifold membership
     */
    function _isActiveMember(address sender) private view returns(bool) {
        return manifoldMembershipContract != address(0) &&
            IManifoldMembership(manifoldMembershipContract).isActiveMember(sender);
    }

    /**
     * Helper to get the number of burn redeems the person can accomplish
     */
    function _getAvailableBurnRedeemCount(uint32 totalSupply, uint32 redeemedCount, uint32 redeemAmount, uint32 desiredCount, bool revertNoneRemaining) internal pure returns(uint32 burnRedeemCount) {
        if (totalSupply == 0) {
            burnRedeemCount = desiredCount;
        } else {
            uint32 remainingCount = (totalSupply - redeemedCount) / redeemAmount;
            if (remainingCount > desiredCount) {
                burnRedeemCount = desiredCount;
            } else {
                burnRedeemCount = remainingCount;
            }
        }

        if (revertNoneRemaining && burnRedeemCount == 0) {
            revert InvalidRedeemAmount();
        }
    }

    /** 
     * Abstract helper to mint multiple redeem tokens. To be implemented by inheriting contracts.
     */
    function _redeem(address creatorContractAddress, uint256 instanceId, BurnRedeem storage burnRedeemInstance, address to, uint32 count, bytes memory data) internal virtual;

    /**
     * Helper to burn token
     */
    function _burn(BurnItem memory burnItem, address from, address contractAddress, uint256 tokenId, uint256 burnRedeemCount, bytes memory data) private {
        if (burnItem.tokenSpec == TokenSpec.ERC1155) {
            uint256 amount = burnItem.amount * burnRedeemCount;

            if (burnItem.burnSpec == BurnSpec.NONE) {
                // Send to 0xdEaD to burn if contract doesn't have burn function
                IERC1155(contractAddress).safeTransferFrom(from, address(0xdEaD), tokenId, amount, data);

            } else if (burnItem.burnSpec == BurnSpec.MANIFOLD) {
                // Burn using the creator core's burn function
                uint256[] memory tokenIds = new uint256[](1);
                tokenIds[0] = tokenId;
                uint256[] memory amounts = new uint256[](1);
                amounts[0] = amount;
                Manifold1155(contractAddress).burn(from, tokenIds, amounts);

            } else if (burnItem.burnSpec == BurnSpec.OPENZEPPELIN) {
                // Burn using OpenZeppelin's burn function
                OZBurnable1155(contractAddress).burn(from, tokenId, amount);

            } else {
                revert InvalidBurnSpec();
            }
        } else if (burnItem.tokenSpec == TokenSpec.ERC721) {
            if (burnRedeemCount != 1) {
                revert InvalidBurnAmount();
            } 
            if (burnItem.burnSpec == BurnSpec.NONE) {
                // Send to 0xdEaD to burn if contract doesn't have burn function
                IERC721(contractAddress).safeTransferFrom(from, address(0xdEaD), tokenId, data);

            } else if (burnItem.burnSpec == BurnSpec.MANIFOLD || burnItem.burnSpec == BurnSpec.OPENZEPPELIN) {
                if (from != address(this)) {
                    // 721 `burn` functions do not have a `from` parameter, so we must verify the owner
                    if (IERC721(contractAddress).ownerOf(tokenId) != from) {
                        revert TransferFailure();
                    }
                }
                // Burn using the contract's burn function
                Burnable721(contractAddress).burn(tokenId);

            } else {
                revert InvalidBurnSpec();
            }
        } else {
            revert InvalidTokenSpec();
        }
    }
}

File 4 of 29 : BurnRedeemLib.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/////////////////////////////////////////////////////////////////////////////////////
//                                                                                 //
//                                                                                 //
//                                     .%(#.                                       //
//                                      #(((#%,                                    //
//                                      (#(((((#%*                                 //
//                                      /#((((((((##*                              //
//                                      (#((((((((((##%.                           //
//                                     ,##(/*/(////((((#%*                         //
//                                   .###(//****/////(((##%,                       //
//                  (,          ,%#((((((///******/////((##%(                      //
//                *((,         ,##(///////*********////((###%*                     //
//              /((((         ,##(//////************/(((((###%                     //
//             /((((         ,##((////***************/((((###%                     //
//             (((          .###((///*****************((((####                     //
//             .            (##((//*******************((((##%*                     //
//               (#.       .###((/********************((((##%.      %.             //
//             ,%(#.       .###(/********,,,,,,,*****/(((###%#     ((%,            //
//            /%#/(/       /###(//****,,,,,,,,,,,****/((((((##%%%%#((#%.           //
//           /##(//(#.    ,###((/****,,,,,,,,,,,,,***/((/(((((((((#####%           //
//          *%##(/////((###((((/***,,,,,,,,,,,,,,,***//((((((((((####%%%/          //
//          ####(((//////(//////**,,,,,,.....,,,,,,****/(((((//((####%%%%          //
//         .####(((/((((((/////**,,,,,.......,,,,,,,,*****/////(#####%%%%          //
//         .#%###((////(((//***,,,,,,..........,,,,,,,,*****//((#####%%%%          //
//          /%%%###/////*****,,,,,,,..............,,,,,,,****/(((####%%%%          //
//           /%%###(////****,,,,,,.....        ......,,,,,,**(((####%%%%           //
//            ,#%###(///****,,,,,....            .....,,,,,***/(/(##%%(            //
//              (####(//****,,....                 ....,,,,,***/(####              //
//                (###(/***,,,...                    ...,,,,***(##/                //
//             #.   (#((/**,,,,..                    ...,,,,*((#,                  //
//               ,#(##(((//,,,,..                   ...,,,*/(((#((/                //
//                  *#(((///*,,....                ....,*//((((                    //
//                      *(///***,....            ...,***//,                        //
//                           ,//***,...       ..,,*,                               //
//                                                                                 //
//                                                                                 //
/////////////////////////////////////////////////////////////////////////////////////

import "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
import "./IBurnRedeemCore.sol";

/**
 * @title Burn Redeem Lib
 * @author manifold.xyz
 * @notice Library for Burn Redeem shared extensions.
 */
library BurnRedeemLib {

    event BurnRedeemInitialized(address indexed creatorContract, uint256 indexed instanceId, address initializer);
    event BurnRedeemUpdated(address indexed creatorContract, uint256 indexed instanceId);
    event BurnRedeemMint(address indexed creatorContract, uint256 indexed instanceId, uint256 indexed tokenId, uint32 redeemedCount, bytes data);

    error BurnRedeemAlreadyInitialized();
    error InvalidBurnItem();
    error InvalidBurnToken();
    error InvalidMerkleProof();
    error InvalidStorageProtocol();
    error InvalidPaymentReceiver();
    error InvalidDates();
    error InvalidInput();

    /**
     * Initialiazes a burn redeem with base parameters
     */
    function initialize(
        address creatorContractAddress,
        uint8 creatorContractVersion,
        uint256 instanceId,
        IBurnRedeemCore.BurnRedeem storage burnRedeemInstance,
        IBurnRedeemCore.BurnRedeemParameters calldata burnRedeemParameters
    ) public {
        // Sanity checks
        if (burnRedeemInstance.storageProtocol != IBurnRedeemCore.StorageProtocol.INVALID) {
            revert BurnRedeemAlreadyInitialized();
        }
        _validateParameters(burnRedeemParameters);

        // Create the burn redeem
        burnRedeemInstance.contractVersion = creatorContractVersion;
        _setParameters(burnRedeemInstance, burnRedeemParameters);
        _setBurnGroups(burnRedeemInstance, burnRedeemParameters.burnSet);

        emit BurnRedeemInitialized(creatorContractAddress, instanceId, msg.sender);
    }

    /**
     * Updates a burn redeem with base parameters
     */
    function update(
        address creatorContractAddress,
        uint256 instanceId,
        IBurnRedeemCore.BurnRedeem storage burnRedeemInstance,
        IBurnRedeemCore.BurnRedeemParameters calldata burnRedeemParameters
    ) public {
        // Sanity checks
        if (burnRedeemInstance.storageProtocol == IBurnRedeemCore.StorageProtocol.INVALID) {
            revert IBurnRedeemCore.BurnRedeemDoesNotExist(instanceId);
        }
        _validateParameters(burnRedeemParameters);
        // The current redeemedCount must be divisible by redeemAmount
        if (burnRedeemInstance.redeemedCount % burnRedeemParameters.redeemAmount != 0) {
            revert IBurnRedeemCore.InvalidRedeemAmount();
        }

        // Overwrite the existing burnRedeem
        _setParameters(burnRedeemInstance, burnRedeemParameters);
        _setBurnGroups(burnRedeemInstance, burnRedeemParameters.burnSet);
        syncTotalSupply(burnRedeemInstance);
        emit BurnRedeemUpdated(creatorContractAddress, instanceId);
    }

    /**
     * Helper to update total supply if redeemedCount exceeds totalSupply after airdrop or instance update.
     */
    function syncTotalSupply(IBurnRedeemCore.BurnRedeem storage burnRedeemInstance) public {
        if (
            burnRedeemInstance.totalSupply != 0 &&
            burnRedeemInstance.redeemedCount > burnRedeemInstance.totalSupply
        ) {
            burnRedeemInstance.totalSupply = burnRedeemInstance.redeemedCount;
        }
    }

    /*
     * Helper to validate burn item
     */
    function validateBurnItem(IBurnRedeemCore.BurnItem memory burnItem, address contractAddress, uint256 tokenId, bytes32[] memory merkleProof) public pure {
        if (burnItem.validationType == IBurnRedeemCore.ValidationType.ANY) {
            return;
        }
        if (contractAddress != burnItem.contractAddress) {
            revert InvalidBurnToken();
        }
        if (burnItem.validationType == IBurnRedeemCore.ValidationType.CONTRACT) {
            return;
        } else if (burnItem.validationType == IBurnRedeemCore.ValidationType.RANGE) {
            if (tokenId < burnItem.minTokenId || tokenId > burnItem.maxTokenId) {
                revert IBurnRedeemCore.InvalidToken(tokenId);
            }
            return;
        } else if (burnItem.validationType == IBurnRedeemCore.ValidationType.MERKLE_TREE) {
            bytes32 leaf = keccak256(abi.encodePacked(tokenId));
            if (!MerkleProof.verify(merkleProof, burnItem.merkleRoot, leaf)) {
                revert InvalidMerkleProof();
            }
            return;
        }
        revert InvalidBurnItem();
    }

        /**
     * Helper to validate the parameters for a burn redeem
     */
    function _validateParameters(IBurnRedeemCore.BurnRedeemParameters calldata burnRedeemParameters) internal pure {
        if (burnRedeemParameters.storageProtocol == IBurnRedeemCore.StorageProtocol.INVALID) {
            revert InvalidStorageProtocol();
        }
        if (burnRedeemParameters.paymentReceiver == address(0)) {
            revert InvalidPaymentReceiver();
        }
        if (burnRedeemParameters.endDate != 0 && burnRedeemParameters.startDate >= burnRedeemParameters.endDate) {
            revert InvalidDates();
        }
        if (burnRedeemParameters.totalSupply % burnRedeemParameters.redeemAmount != 0) {
            revert IBurnRedeemCore.InvalidRedeemAmount();
        }
    }

    /**
     * Helper to set top level properties for a burn redeem
     */
    function _setParameters(IBurnRedeemCore.BurnRedeem storage burnRedeemInstance, IBurnRedeemCore.BurnRedeemParameters calldata burnRedeemParameters) private {
        burnRedeemInstance.startDate = burnRedeemParameters.startDate;
        burnRedeemInstance.endDate = burnRedeemParameters.endDate;
        burnRedeemInstance.redeemAmount = burnRedeemParameters.redeemAmount;
        burnRedeemInstance.totalSupply = burnRedeemParameters.totalSupply;
        burnRedeemInstance.storageProtocol = burnRedeemParameters.storageProtocol;
        burnRedeemInstance.location = burnRedeemParameters.location;
        burnRedeemInstance.cost = burnRedeemParameters.cost;
        burnRedeemInstance.paymentReceiver = burnRedeemParameters.paymentReceiver;
    }

    /**
     * Helper to set the burn groups for a burn redeem
     */
    function _setBurnGroups(IBurnRedeemCore.BurnRedeem storage burnRedeemInstance, IBurnRedeemCore.BurnGroup[] calldata burnGroups) private {
        delete burnRedeemInstance.burnSet;
        for (uint256 i; i < burnGroups.length;) {
            burnRedeemInstance.burnSet.push();
            IBurnRedeemCore.BurnGroup storage burnGroup = burnRedeemInstance.burnSet[i];
            if (burnGroups[i].requiredCount == 0 || burnGroups[i].requiredCount > burnGroups[i].items.length) {
                revert InvalidInput();
            }
            burnGroup.requiredCount = burnGroups[i].requiredCount;
            for (uint256 j; j < burnGroups[i].items.length;) {
                IBurnRedeemCore.BurnItem memory burnItem = burnGroups[i].items[j];
                IBurnRedeemCore.TokenSpec tokenSpec = burnItem.tokenSpec;
                uint256 amount = burnItem.amount;
                if (
                    !(
                        (tokenSpec == IBurnRedeemCore.TokenSpec.ERC1155 && amount > 0) ||
                        (tokenSpec == IBurnRedeemCore.TokenSpec.ERC721 && amount == 0)
                    ) || 
                    burnItem.validationType == IBurnRedeemCore.ValidationType.INVALID
                ) {
                    revert InvalidInput();
                }
                burnGroup.items.push(burnGroups[i].items[j]);
                unchecked { ++j; }
            }
            unchecked { ++i; }
        }
    }

}

File 5 of 29 : IERC1155BurnRedeem.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "./IBurnRedeemCore.sol";

interface IERC1155BurnRedeem is IBurnRedeemCore {
    struct ExtendedConfig {
        uint256 redeemTokenId;
    }

    /**
     * @notice initialize a new burn redeem, emit initialize event
     * @param creatorContractAddress    the creator contract the burn will mint redeem tokens for
     * @param instanceId                the instanceId of the burnRedeem for the creator contract
     * @param burnRedeemParameters      the parameters which will affect the minting behavior of the burn redeem
     */
    function initializeBurnRedeem(address creatorContractAddress, uint256 instanceId, BurnRedeemParameters calldata burnRedeemParameters) external;

    /**
     * @notice update an existing burn redeem
     * @param creatorContractAddress    the creator contract corresponding to the burn redeem
     * @param instanceId                the instanceId of the burnRedeem for the creator contract
     * @param burnRedeemParameters      the parameters which will affect the minting behavior of the burn redeem
     */
    function updateBurnRedeem(address creatorContractAddress, uint256 instanceId, BurnRedeemParameters calldata burnRedeemParameters) external;

    /**
     * @notice update an existing burn redeem
     * @param creatorContractAddress    the creator contract corresponding to the burn redeem
     * @param instanceId                the instanceId of the burnRedeem for the creator contract
     * @param storageProtocol           the storage protocol for the metadata
     * @param location                  the location of the metadata
     */
    function updateURI(address creatorContractAddress, uint256 instanceId, StorageProtocol storageProtocol, string calldata location) external;

    /**
     * @notice get the redeem token ID for a burn redeem
     */
    function getBurnRedeemToken(address creatorContractAddress, uint256 instanceId) external view returns (uint256);
}

File 6 of 29 : CreatorCore.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "@openzeppelin/contracts/security/ReentrancyGuard.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "@openzeppelin/contracts/utils/introspection/ERC165.sol";
import "@openzeppelin/contracts/utils/introspection/ERC165Checker.sol";
import "@openzeppelin/contracts/utils/structs/EnumerableSet.sol";
import "@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol";

import "../extensions/ICreatorExtensionTokenURI.sol";
import "../extensions/ICreatorExtensionRoyalties.sol";

import "./ICreatorCore.sol";

/**
 * @dev Core creator implementation
 */
abstract contract CreatorCore is ReentrancyGuard, ICreatorCore, ERC165 {
    using Strings for uint256;
    using EnumerableSet for EnumerableSet.AddressSet;
    using AddressUpgradeable for address;

    uint256 internal _tokenCount = 0;

    // Base approve transfers address location
    address internal _approveTransferBase;

    // Track registered extensions data
    EnumerableSet.AddressSet internal _extensions;
    EnumerableSet.AddressSet internal _blacklistedExtensions;

    // The baseURI for a given extension
    mapping (address => string) private _extensionBaseURI;
    mapping (address => bool) private _extensionBaseURIIdentical;

    // The prefix for any tokens with a uri configured
    mapping (address => string) private _extensionURIPrefix;

    // Mapping for individual token URIs
    mapping (uint256 => string) internal _tokenURIs;

    // Royalty configurations
    struct RoyaltyConfig {
        address payable receiver;
        uint16 bps;
    }
    mapping (address => RoyaltyConfig[]) internal _extensionRoyalty;
    mapping (uint256 => RoyaltyConfig[]) internal _tokenRoyalty;

    bytes4 private constant _CREATOR_CORE_V1 = 0x28f10a21;

    /**
     * External interface identifiers for royalties
     */

    /**
     *  @dev CreatorCore
     *
     *  bytes4(keccak256('getRoyalties(uint256)')) == 0xbb3bafd6
     *
     *  => 0xbb3bafd6 = 0xbb3bafd6
     */
    bytes4 private constant _INTERFACE_ID_ROYALTIES_CREATORCORE = 0xbb3bafd6;

    /**
     *  @dev Rarible: RoyaltiesV1
     *
     *  bytes4(keccak256('getFeeRecipients(uint256)')) == 0xb9c4d9fb
     *  bytes4(keccak256('getFeeBps(uint256)')) == 0x0ebd4c7f
     *
     *  => 0xb9c4d9fb ^ 0x0ebd4c7f = 0xb7799584
     */
    bytes4 private constant _INTERFACE_ID_ROYALTIES_RARIBLE = 0xb7799584;

    /**
     *  @dev Foundation
     *
     *  bytes4(keccak256('getFees(uint256)')) == 0xd5a06d4c
     *
     *  => 0xd5a06d4c = 0xd5a06d4c
     */
    bytes4 private constant _INTERFACE_ID_ROYALTIES_FOUNDATION = 0xd5a06d4c;

    /**
     *  @dev EIP-2981
     *
     * bytes4(keccak256("royaltyInfo(uint256,uint256)")) == 0x2a55205a
     *
     * => 0x2a55205a = 0x2a55205a
     */
    bytes4 private constant _INTERFACE_ID_ROYALTIES_EIP2981 = 0x2a55205a;

    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
        return interfaceId == type(ICreatorCore).interfaceId || interfaceId == _CREATOR_CORE_V1 || super.supportsInterface(interfaceId)
            || interfaceId == _INTERFACE_ID_ROYALTIES_CREATORCORE || interfaceId == _INTERFACE_ID_ROYALTIES_RARIBLE
            || interfaceId == _INTERFACE_ID_ROYALTIES_FOUNDATION || interfaceId == _INTERFACE_ID_ROYALTIES_EIP2981;
    }

    /**
     * @dev Only allows registered extensions to call the specified function
     */
    function requireExtension() internal view {
        require(_extensions.contains(msg.sender), "Must be registered extension");
    }

    /**
     * @dev Only allows non-blacklisted extensions
     */
    function requireNonBlacklist(address extension) internal view {
        require(!_blacklistedExtensions.contains(extension), "Extension blacklisted");
    }   

    /**
     * @dev See {ICreatorCore-getExtensions}.
     */
    function getExtensions() external view override returns (address[] memory extensions) {
        extensions = new address[](_extensions.length());
        for (uint i; i < _extensions.length();) {
            extensions[i] = _extensions.at(i);
            unchecked { ++i; }
        }
        return extensions;
    }

    /**
     * @dev Register an extension
     */
    function _registerExtension(address extension, string calldata baseURI, bool baseURIIdentical) internal virtual {
        require(extension != address(this) && extension.isContract(), "Invalid");
        emit ExtensionRegistered(extension, msg.sender);
        _extensionBaseURI[extension] = baseURI;
        _extensionBaseURIIdentical[extension] = baseURIIdentical;
        _extensions.add(extension);
        _setApproveTransferExtension(extension, true);
    }

    /**
     * @dev See {ICreatorCore-setApproveTransferExtension}.
     */
    function setApproveTransferExtension(bool enabled) external override {
        requireExtension();
        _setApproveTransferExtension(msg.sender, enabled);
    }

    /**
     * @dev Set whether or not tokens minted by the extension defers transfer approvals to the extension
     */
    function _setApproveTransferExtension(address extension, bool enabled) internal virtual;

    /**
     * @dev Unregister an extension
     */
    function _unregisterExtension(address extension) internal {
        emit ExtensionUnregistered(extension, msg.sender);
        _extensions.remove(extension);
    }

    /**
     * @dev Blacklist an extension
     */
    function _blacklistExtension(address extension) internal {
       require(extension != address(0) && extension != address(this), "Cannot blacklist yourself");
       if (_extensions.contains(extension)) {
           emit ExtensionUnregistered(extension, msg.sender);
           _extensions.remove(extension);
       }
       if (!_blacklistedExtensions.contains(extension)) {
           emit ExtensionBlacklisted(extension, msg.sender);
           _blacklistedExtensions.add(extension);
       }
    }

    /**
     * @dev Set base token uri for an extension
     */
    function _setBaseTokenURIExtension(string calldata uri, bool identical) internal {
        _extensionBaseURI[msg.sender] = uri;
        _extensionBaseURIIdentical[msg.sender] = identical;
    }

    /**
     * @dev Set token uri prefix for an extension
     */
    function _setTokenURIPrefixExtension(string calldata prefix) internal {
        _extensionURIPrefix[msg.sender] = prefix;
    }

    /**
     * @dev Set token uri for a token of an extension
     */
    function _setTokenURIExtension(uint256 tokenId, string calldata uri) internal {
        require(_tokenExtension(tokenId) == msg.sender, "Invalid token");
        _tokenURIs[tokenId] = uri;
    }

    /**
     * @dev Set base token uri for tokens with no extension
     */
    function _setBaseTokenURI(string calldata uri) internal {
        _extensionBaseURI[address(0)] = uri;
    }

    /**
     * @dev Set token uri prefix for tokens with no extension
     */
    function _setTokenURIPrefix(string calldata prefix) internal {
        _extensionURIPrefix[address(0)] = prefix;
    }


    /**
     * @dev Set token uri for a token with no extension
     */
    function _setTokenURI(uint256 tokenId, string calldata uri) internal {
        require(tokenId > 0 && tokenId <= _tokenCount && _tokenExtension(tokenId) == address(0), "Invalid token");
        _tokenURIs[tokenId] = uri;
    }

    /**
     * @dev Retrieve a token's URI
     */
    function _tokenURI(uint256 tokenId) internal view returns (string memory) {
        require(tokenId > 0 && tokenId <= _tokenCount, "Invalid token");

        address extension = _tokenExtension(tokenId);
        require(!_blacklistedExtensions.contains(extension), "Extension blacklisted");

        if (bytes(_tokenURIs[tokenId]).length != 0) {
            if (bytes(_extensionURIPrefix[extension]).length != 0) {
                return string(abi.encodePacked(_extensionURIPrefix[extension], _tokenURIs[tokenId]));
            }
            return _tokenURIs[tokenId];
        }

        if (ERC165Checker.supportsInterface(extension, type(ICreatorExtensionTokenURI).interfaceId)) {
            return ICreatorExtensionTokenURI(extension).tokenURI(address(this), tokenId);
        }

        if (!_extensionBaseURIIdentical[extension]) {
            return string(abi.encodePacked(_extensionBaseURI[extension], tokenId.toString()));
        } else {
            return _extensionBaseURI[extension];
        }
    }

    /**
     * Helper to get royalties for a token
     */
    function _getRoyalties(uint256 tokenId) view internal returns (address payable[] memory receivers, uint256[] memory bps) {

        // Get token level royalties
        RoyaltyConfig[] memory royalties = _tokenRoyalty[tokenId];
        if (royalties.length == 0) {
            // Get extension specific royalties
            address extension = _tokenExtension(tokenId);
            if (extension != address(0)) {
                if (ERC165Checker.supportsInterface(extension, type(ICreatorExtensionRoyalties).interfaceId)) {
                    (receivers, bps) = ICreatorExtensionRoyalties(extension).getRoyalties(address(this), tokenId);
                    // Extension override exists, just return that
                    if (receivers.length > 0) return (receivers, bps);
                }
                royalties = _extensionRoyalty[extension];
            }
        }
        if (royalties.length == 0) {
            // Get the default royalty
            royalties = _extensionRoyalty[address(0)];
        }
        
        if (royalties.length > 0) {
            receivers = new address payable[](royalties.length);
            bps = new uint256[](royalties.length);
            for (uint i; i < royalties.length;) {
                receivers[i] = royalties[i].receiver;
                bps[i] = royalties[i].bps;
                unchecked { ++i; }
            }
        }
    }

    /**
     * Helper to get royalty receivers for a token
     */
    function _getRoyaltyReceivers(uint256 tokenId) view internal returns (address payable[] memory recievers) {
        (recievers, ) = _getRoyalties(tokenId);
    }

    /**
     * Helper to get royalty basis points for a token
     */
    function _getRoyaltyBPS(uint256 tokenId) view internal returns (uint256[] memory bps) {
        (, bps) = _getRoyalties(tokenId);
    }

    function _getRoyaltyInfo(uint256 tokenId, uint256 value) view internal returns (address receiver, uint256 amount){
        (address payable[] memory receivers, uint256[] memory bps) = _getRoyalties(tokenId);
        require(receivers.length <= 1, "More than 1 royalty receiver");
        
        if (receivers.length == 0) {
            return (address(this), 0);
        }
        return (receivers[0], bps[0]*value/10000);
    }

    /**
     * Set royalties for a token
     */
    function _setRoyalties(uint256 tokenId, address payable[] calldata receivers, uint256[] calldata basisPoints) internal {
       _checkRoyalties(receivers, basisPoints);
        delete _tokenRoyalty[tokenId];
        _setRoyalties(receivers, basisPoints, _tokenRoyalty[tokenId]);
        emit RoyaltiesUpdated(tokenId, receivers, basisPoints);
    }

    /**
     * Set royalties for all tokens of an extension
     */
    function _setRoyaltiesExtension(address extension, address payable[] calldata receivers, uint256[] calldata basisPoints) internal {
        _checkRoyalties(receivers, basisPoints);
        delete _extensionRoyalty[extension];
        _setRoyalties(receivers, basisPoints, _extensionRoyalty[extension]);
        if (extension == address(0)) {
            emit DefaultRoyaltiesUpdated(receivers, basisPoints);
        } else {
            emit ExtensionRoyaltiesUpdated(extension, receivers, basisPoints);
        }
    }

    /**
     * Helper function to check that royalties provided are valid
     */
    function _checkRoyalties(address payable[] calldata receivers, uint256[] calldata basisPoints) private pure {
        require(receivers.length == basisPoints.length, "Invalid input");
        uint256 totalBasisPoints;
        for (uint i; i < basisPoints.length;) {
            totalBasisPoints += basisPoints[i];
            unchecked { ++i; }
        }
        require(totalBasisPoints < 10000, "Invalid total royalties");
    }

    /**
     * Helper function to set royalties
     */
    function _setRoyalties(address payable[] calldata receivers, uint256[] calldata basisPoints, RoyaltyConfig[] storage royalties) private {
        for (uint i; i < basisPoints.length;) {
            royalties.push(
                RoyaltyConfig(
                    {
                        receiver: receivers[i],
                        bps: uint16(basisPoints[i])
                    }
                )
            );
            unchecked { ++i; }
        }
    }

    /**
     * @dev Set the base contract's approve transfer contract location
     */
    function _setApproveTransferBase(address extension) internal {
        _approveTransferBase = extension;
        emit ApproveTransferUpdated(extension);
    }

    /**
     * @dev See {ICreatorCore-getApproveTransfer}.
     */
    function getApproveTransfer() external view override returns (address) {
        return _approveTransferBase;
    }

    /**
     * @dev Get the extension for the given token
     */
    function _tokenExtension(uint256 tokenId) internal virtual view returns(address);
}

File 7 of 29 : ICreatorExtensionTokenURI.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "@openzeppelin/contracts/utils/introspection/IERC165.sol";

/**
 * @dev Implement this if you want your extension to have overloadable URI's
 */
interface ICreatorExtensionTokenURI is IERC165 {

    /**
     * Get the uri for a given creator/tokenId
     */
    function tokenURI(address creator, uint256 tokenId) external view returns (string memory);
}

File 8 of 29 : AdminControl.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "@openzeppelin/contracts/utils/introspection/ERC165.sol";
import "@openzeppelin/contracts/utils/structs/EnumerableSet.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "./IAdminControl.sol";

abstract contract AdminControl is Ownable, IAdminControl, ERC165 {
    using EnumerableSet for EnumerableSet.AddressSet;

    // Track registered admins
    EnumerableSet.AddressSet private _admins;

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

    /**
     * @dev Only allows approved admins to call the specified function
     */
    modifier adminRequired() {
        require(owner() == msg.sender || _admins.contains(msg.sender), "AdminControl: Must be owner or admin");
        _;
    }   

    /**
     * @dev See {IAdminControl-getAdmins}.
     */
    function getAdmins() external view override returns (address[] memory admins) {
        admins = new address[](_admins.length());
        for (uint i = 0; i < _admins.length(); i++) {
            admins[i] = _admins.at(i);
        }
        return admins;
    }

    /**
     * @dev See {IAdminControl-approveAdmin}.
     */
    function approveAdmin(address admin) external override onlyOwner {
        if (!_admins.contains(admin)) {
            emit AdminApproved(admin, msg.sender);
            _admins.add(admin);
        }
    }

    /**
     * @dev See {IAdminControl-revokeAdmin}.
     */
    function revokeAdmin(address admin) external override onlyOwner {
        if (_admins.contains(admin)) {
            emit AdminRevoked(admin, msg.sender);
            _admins.remove(admin);
        }
    }

    /**
     * @dev See {IAdminControl-isAdmin}.
     */
    function isAdmin(address admin) public override view returns (bool) {
        return (owner() == admin || _admins.contains(admin));
    }

}

File 9 of 29 : IAdminControl.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "@openzeppelin/contracts/utils/introspection/IERC165.sol";

/**
 * @dev Interface for admin control
 */
interface IAdminControl is IERC165 {

    event AdminApproved(address indexed account, address indexed sender);
    event AdminRevoked(address indexed account, address indexed sender);

    /**
     * @dev gets address of all admins
     */
    function getAdmins() external view returns (address[] memory);

    /**
     * @dev add an admin.  Can only be called by contract owner.
     */
    function approveAdmin(address admin) external;

    /**
     * @dev remove an admin.  Can only be called by contract owner.
     */
    function revokeAdmin(address admin) external;

    /**
     * @dev checks whether or not given address is an admin
     * Returns True if they are
     */
    function isAdmin(address admin) external view returns (bool);

}

File 10 of 29 : Ownable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol)

pragma solidity ^0.8.0;

import "../utils/Context.sol";

/**
 * @dev Contract module which provides a basic access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * By default, the owner account will be the one that deploys the contract. This
 * can later be changed with {transferOwnership}.
 *
 * This module is used through inheritance. It will make available the modifier
 * `onlyOwner`, which can be applied to your functions to restrict their use to
 * the owner.
 */
abstract contract Ownable is Context {
    address private _owner;

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

    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    constructor() {
        _transferOwnership(_msgSender());
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        _checkOwner();
        _;
    }

    /**
     * @dev Returns the address of the current owner.
     */
    function owner() public view virtual returns (address) {
        return _owner;
    }

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        require(owner() == _msgSender(), "Ownable: caller is not the owner");
    }

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

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        require(newOwner != address(0), "Ownable: new owner is the zero address");
        _transferOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual {
        address oldOwner = _owner;
        _owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}

File 11 of 29 : ReentrancyGuard.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (security/ReentrancyGuard.sol)

pragma solidity ^0.8.0;

/**
 * @dev Contract module that helps prevent reentrant calls to a function.
 *
 * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
 * available, which can be applied to functions to make sure there are no nested
 * (reentrant) calls to them.
 *
 * Note that because there is a single `nonReentrant` guard, functions marked as
 * `nonReentrant` may not call one another. This can be worked around by making
 * those functions `private`, and then adding `external` `nonReentrant` entry
 * points to them.
 *
 * TIP: If you would like to learn more about reentrancy and alternative ways
 * to protect against it, check out our blog post
 * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
 */
abstract contract ReentrancyGuard {
    // Booleans are more expensive than uint256 or any type that takes up a full
    // word because each write operation emits an extra SLOAD to first read the
    // slot's contents, replace the bits taken up by the boolean, and then write
    // back. This is the compiler's defense against contract upgrades and
    // pointer aliasing, and it cannot be disabled.

    // The values being non-zero value makes deployment a bit more expensive,
    // but in exchange the refund on every call to nonReentrant will be lower in
    // amount. Since refunds are capped to a percentage of the total
    // transaction's gas, it is best to keep them low in cases like this one, to
    // increase the likelihood of the full refund coming into effect.
    uint256 private constant _NOT_ENTERED = 1;
    uint256 private constant _ENTERED = 2;

    uint256 private _status;

    constructor() {
        _status = _NOT_ENTERED;
    }

    /**
     * @dev Prevents a contract from calling itself, directly or indirectly.
     * Calling a `nonReentrant` function from another `nonReentrant`
     * function is not supported. It is possible to prevent this from happening
     * by making the `nonReentrant` function external, and making it call a
     * `private` function that does the actual work.
     */
    modifier nonReentrant() {
        _nonReentrantBefore();
        _;
        _nonReentrantAfter();
    }

    function _nonReentrantBefore() private {
        // On the first call to nonReentrant, _status will be _NOT_ENTERED
        require(_status != _ENTERED, "ReentrancyGuard: reentrant call");

        // Any calls to nonReentrant after this point will fail
        _status = _ENTERED;
    }

    function _nonReentrantAfter() private {
        // By storing the original value once again, a refund is triggered (see
        // https://eips.ethereum.org/EIPS/eip-2200)
        _status = _NOT_ENTERED;
    }
}

File 12 of 29 : IERC721.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/IERC721.sol)

pragma solidity ^0.8.0;

import "../../utils/introspection/IERC165.sol";

/**
 * @dev Required interface of an ERC721 compliant contract.
 */
interface IERC721 is IERC165 {
    /**
     * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
     */
    event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);

    /**
     * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
     */
    event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);

    /**
     * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
     */
    event ApprovalForAll(address indexed owner, address indexed operator, bool approved);

    /**
     * @dev Returns the number of tokens in ``owner``'s account.
     */
    function balanceOf(address owner) external view returns (uint256 balance);

    /**
     * @dev Returns the owner of the `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function ownerOf(uint256 tokenId) external view returns (address owner);

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must exist and be owned by `from`.
     * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
     *
     * Emits a {Transfer} event.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId,
        bytes calldata data
    ) external;

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
     * are aware of the ERC721 protocol to prevent tokens from being forever locked.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must exist and be owned by `from`.
     * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
     * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
     *
     * Emits a {Transfer} event.
     */
    function safeTransferFrom(
        address from,
        address to,
        uint256 tokenId
    ) external;

    /**
     * @dev Transfers `tokenId` token from `from` to `to`.
     *
     * WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
     * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
     * understand this adds an external call which potentially creates a reentrancy vulnerability.
     *
     * Requirements:
     *
     * - `from` cannot be the zero address.
     * - `to` cannot be the zero address.
     * - `tokenId` token must be owned by `from`.
     * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(
        address from,
        address to,
        uint256 tokenId
    ) external;

    /**
     * @dev Gives permission to `to` to transfer `tokenId` token to another account.
     * The approval is cleared when the token is transferred.
     *
     * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
     *
     * Requirements:
     *
     * - The caller must own the token or be an approved operator.
     * - `tokenId` must exist.
     *
     * Emits an {Approval} event.
     */
    function approve(address to, uint256 tokenId) external;

    /**
     * @dev Approve or remove `operator` as an operator for the caller.
     * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
     *
     * Requirements:
     *
     * - The `operator` cannot be the caller.
     *
     * Emits an {ApprovalForAll} event.
     */
    function setApprovalForAll(address operator, bool _approved) external;

    /**
     * @dev Returns the account approved for `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function getApproved(uint256 tokenId) external view returns (address operator);

    /**
     * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
     *
     * See {setApprovalForAll}
     */
    function isApprovedForAll(address owner, address operator) external view returns (bool);
}

File 13 of 29 : IERC1155.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (token/ERC1155/IERC1155.sol)

pragma solidity ^0.8.0;

import "../../utils/introspection/IERC165.sol";

/**
 * @dev Required interface of an ERC1155 compliant contract, as defined in the
 * https://eips.ethereum.org/EIPS/eip-1155[EIP].
 *
 * _Available since v3.1._
 */
interface IERC1155 is IERC165 {
    /**
     * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
     */
    event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);

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

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

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

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

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

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

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

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

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

File 14 of 29 : Strings.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/Math.sol";

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

    /**
     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
     */
    function toString(uint256 value) internal pure returns (string memory) {
        unchecked {
            uint256 length = Math.log10(value) + 1;
            string memory buffer = new string(length);
            uint256 ptr;
            /// @solidity memory-safe-assembly
            assembly {
                ptr := add(buffer, add(32, length))
            }
            while (true) {
                ptr--;
                /// @solidity memory-safe-assembly
                assembly {
                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
                }
                value /= 10;
                if (value == 0) break;
            }
            return buffer;
        }
    }

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

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
     */
    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
        bytes memory buffer = new bytes(2 * length + 2);
        buffer[0] = "0";
        buffer[1] = "x";
        for (uint256 i = 2 * length + 1; i > 1; --i) {
            buffer[i] = _SYMBOLS[value & 0xf];
            value >>= 4;
        }
        require(value == 0, "Strings: hex length insufficient");
        return string(buffer);
    }

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

File 15 of 29 : ERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)

pragma solidity ^0.8.0;

import "./IERC165.sol";

/**
 * @dev Implementation of the {IERC165} interface.
 *
 * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
 * for the additional interface id that will be supported. For example:
 *
 * ```solidity
 * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
 *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
 * }
 * ```
 *
 * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
 */
abstract contract ERC165 is IERC165 {
    /**
     * @dev See {IERC165-supportsInterface}.
     */
    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
        return interfaceId == type(IERC165).interfaceId;
    }
}

File 16 of 29 : IManifoldMembership.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

/**
 * Manifold Membership interface
 */
interface IManifoldMembership {
   function isActiveMember(address sender) external view returns (bool);
}

File 17 of 29 : IBurnRedeemCore.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol";
import "@openzeppelin/contracts/token/ERC1155/IERC1155Receiver.sol";
import "@openzeppelin/contracts/utils/introspection/IERC165.sol";

/**
 * Burn Redeem Core interface
 */
interface IBurnRedeemCore is IERC165, IERC721Receiver, IERC1155Receiver  {
    error NotAdmin(address);
    error UnsupportedContractVersion();
    error InvalidToken(uint256);
    error InvalidInput();
    error InvalidTokenSpec();
    error InvalidBurnSpec();
    error InvalidData();
    error TransferFailure();
    
    error BurnRedeemDoesNotExist(uint256);
    error BurnRedeemInactive(uint256);

    error InvalidBurnAmount();
    error InvalidRedeemAmount();
    error InvalidPaymentAmount();


    enum StorageProtocol { INVALID, NONE, ARWEAVE, IPFS }

    /**
     * @notice the validation type used for a `BurnItem`
     * CONTRACT                 any token from a specific contract is valid
     * RANGE                    token IDs within a range (inclusive) are valid
     * MERKLE_TREE              various individual token IDs included in a merkle tree are valid
     * ANY                      any token from any contract
     */
    enum ValidationType { INVALID, CONTRACT, RANGE, MERKLE_TREE, ANY }

    enum TokenSpec { INVALID, ERC721, ERC1155 }
    enum BurnSpec { NONE, MANIFOLD, OPENZEPPELIN }

    /**
     * @notice a `BurnItem` indicates which tokens are eligible to be burned
     * @param validationType    which type of validation used to check that the burn item is 
     *                          satisfied
     * @param tokenSpec         whether the token is an ERC721 or ERC1155
     * @param burnSpec          whether the contract for a token has a `burn` function and, if so,
     *                          what interface
     * @param amount            (only for ERC1155 tokens) the amount (value) required to burn
     * @param minTokenId        (only for RANGE validation) the minimum valid token ID
     * @param maxTokenId        (only for RANGE validation) the maximum valid token ID
     * @param merkleRoot        (only for MERKLE_TREE validation) the root of the merkle tree of
     *                          valid token IDs
     */
    struct BurnItem {
        ValidationType validationType;
        address contractAddress;
        TokenSpec tokenSpec;
        BurnSpec burnSpec;
        uint72 amount;
        uint256 minTokenId;
        uint256 maxTokenId;
        bytes32 merkleRoot;
    }

    /**
     * @notice a `BurnGroup` is a group of valid `BurnItem`s
     * @param requiredCount     the number of `BurnItem`s (0 < requiredCount <= items.length) that 
     *                          need to be included in a burn
     * @param items             the list of `BurnItem`s
     */
    struct BurnGroup {
        uint256 requiredCount;
        BurnItem[] items;
    }

    /**
     * @notice parameters for burn redeem intialization/updates
     * @param paymentReceiver   the address to forward proceeds from paid burn redeems
     * @param storageProtocol   the type of storage used for the redeem token URIs
     * @param redeemAmount      the number of redeem tokens to mint for each burn redeem
     * @param totalSupply       the maximum number of redeem tokens to mint (0 for unlimited)
     * @param startDate         the starting time for the burn redeem (0 for immediately)
     * @param endDate           the end time for the burn redeem (0 for never)
     * @param cost              the cost for each burn redeem
     * @param location          used to construct the token URI (Arweave hash, full URI, etc.)
     * @param burnSet           a list of `BurnGroup`s that must each be satisfied for a burn redeem
     */
    struct BurnRedeemParameters {
        address payable paymentReceiver;
        StorageProtocol storageProtocol;
        uint16 redeemAmount;
        uint32 totalSupply;
        uint48 startDate;
        uint48 endDate;
        uint160 cost;
        string location;
        BurnGroup[] burnSet;
    }

    struct BurnRedeem {
        address payable paymentReceiver;
        StorageProtocol storageProtocol;
        uint32 redeemedCount;
        uint16 redeemAmount;
        uint32 totalSupply;
        uint8 contractVersion;
        uint48 startDate;
        uint48 endDate;
        uint160 cost;
        string location;
        BurnGroup[] burnSet;
    }

    /**
     * @notice a pointer to a `BurnItem` in a `BurnGroup` used in calls to `burnRedeem`
     * @param groupIndex        the index of the `BurnGroup` in `BurnRedeem.burnSet`
     * @param itemIndex         the index of the `BurnItem` in `BurnGroup.items`
     * @param contractAddress   the address of the contract for the token
     * @param id                the token ID
     * @param merkleProof       the merkle proof for the token ID (only for MERKLE_TREE validation)
     */
    struct BurnToken {
        uint48 groupIndex;
        uint48 itemIndex;
        address contractAddress;
        uint256 id;
        bytes32[] merkleProof;
    }

    /**
     * @notice get a burn redeem corresponding to a creator contract and instanceId
     * @param creatorContractAddress    the address of the creator contract
     * @param instanceId                the instanceId of the burn redeem for the creator contract
     * @return BurnRedeem               the burn redeem object
     */
    function getBurnRedeem(address creatorContractAddress, uint256 instanceId) external view returns(BurnRedeem memory);
    
    /**
     * @notice get a burn redeem corresponding to a creator contract and tokenId
     * @param creatorContractAddress    the address of the creator contract
     * @param tokenId                   the token to retrieve the burn redeem for
     * @return                          the burn redeem instanceId and burn redeem object
     */
    function getBurnRedeemForToken(address creatorContractAddress, uint256 tokenId) external view returns(uint256, BurnRedeem memory);

    /**
     * @notice burn tokens and mint a redeem token
     * @param creatorContractAddress    the address of the creator contract
     * @param instanceId                the instanceId of the burn redeem for the creator contract
     * @param burnRedeemCount           the number of burn redeems we want to do
     * @param burnTokens                the tokens to burn with pointers to the corresponding BurnItem requirement
     */
    function burnRedeem(address creatorContractAddress, uint256 instanceId, uint32 burnRedeemCount, BurnToken[] calldata burnTokens) external payable;

    /**
     * @notice burn tokens and mint redeem tokens multiple times in a single transaction
     * @param creatorContractAddresses  the addresses of the creator contracts
     * @param instanceIds               the instanceIds of the burn redeems for the corresponding creator contract
     * @param burnRedeemCounts          the burn redeem counts for each burn
     * @param burnTokens                the tokens to burn for each burn redeem with pointers to the corresponding BurnItem requirement
     */
    function burnRedeem(address[] calldata creatorContractAddresses, uint256[] calldata instanceIds, uint32[] calldata burnRedeemCounts, BurnToken[][] calldata burnTokens) external payable;

    /**
     * @notice burn tokens and mint a redeem token
     * @param creatorContractAddress    the address of the creator contract
     * @param instanceId                the instanceId of the burn redeem for the creator contract
     * @param burnRedeemCount           the number of burn redeems we want to do
     * @param burnTokens                the tokens to burn with pointers to the corresponding BurnItem requirement
     * @param data                      the data to emit with the BurnRedeemMint event
     */
    function burnRedeemWithData(address creatorContractAddress, uint256 instanceId, uint32 burnRedeemCount, BurnToken[] calldata burnTokens, bytes calldata data) external payable;

    /**
     * @notice allow admin to airdrop arbitrary tokens 
     * @param creatorContractAddress    the creator contract to mint tokens for
     * @param instanceId                the instanceId of the burn redeem for the creator contract
     * @param recipients                addresses to airdrop to
     * @param amounts                   number of redeems to perform for each address in recipients
     */
    function airdrop(address creatorContractAddress, uint256 instanceId, address[] calldata recipients, uint32[] calldata amounts) external;

    /**
     * @notice recover a token that was sent to the contract without safeTransferFrom
     * @param tokenAddress              the address of the token contract
     * @param tokenId                   the id of the token
     * @param destination               the address to send the token to
     */
    function recoverERC721(address tokenAddress, uint256 tokenId, address destination) external;

    /**
     * @notice withdraw Manifold fee proceeds from the contract
     * @param recipient                 recepient of the funds
     * @param amount                    amount to withdraw in Wei
     */
    function withdraw(address payable recipient, uint256 amount) external;

    /**
     * @notice set the Manifold Membership contract address
     * @param addr                      the address of the Manifold Membership contract 
     */
    function setMembershipAddress(address addr) external;
}

File 18 of 29 : Interfaces.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

interface Burnable721 {
    function burn(uint256 tokenId) external;
}

interface OZBurnable1155 {
    function burn(address account, uint256 id, uint256 value) external;
}

interface Manifold1155 {
    function burn(address account, uint256[] memory tokenIds, uint256[] memory amounts) external;
}

File 19 of 29 : MerkleProof.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/cryptography/MerkleProof.sol)

pragma solidity ^0.8.0;

/**
 * @dev These functions deal with verification of Merkle Tree proofs.
 *
 * The tree and the proofs can be generated using our
 * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
 * You will find a quickstart guide in the readme.
 *
 * WARNING: You should avoid using leaf values that are 64 bytes long prior to
 * hashing, or use a hash function other than keccak256 for hashing leaves.
 * This is because the concatenation of a sorted pair of internal nodes in
 * the merkle tree could be reinterpreted as a leaf value.
 * OpenZeppelin's JavaScript library generates merkle trees that are safe
 * against this attack out of the box.
 */
library MerkleProof {
    /**
     * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
     * defined by `root`. For this, a `proof` must be provided, containing
     * sibling hashes on the branch from the leaf to the root of the tree. Each
     * pair of leaves and each pair of pre-images are assumed to be sorted.
     */
    function verify(
        bytes32[] memory proof,
        bytes32 root,
        bytes32 leaf
    ) internal pure returns (bool) {
        return processProof(proof, leaf) == root;
    }

    /**
     * @dev Calldata version of {verify}
     *
     * _Available since v4.7._
     */
    function verifyCalldata(
        bytes32[] calldata proof,
        bytes32 root,
        bytes32 leaf
    ) internal pure returns (bool) {
        return processProofCalldata(proof, leaf) == root;
    }

    /**
     * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
     * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
     * hash matches the root of the tree. When processing the proof, the pairs
     * of leafs & pre-images are assumed to be sorted.
     *
     * _Available since v4.4._
     */
    function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) {
        bytes32 computedHash = leaf;
        for (uint256 i = 0; i < proof.length; i++) {
            computedHash = _hashPair(computedHash, proof[i]);
        }
        return computedHash;
    }

    /**
     * @dev Calldata version of {processProof}
     *
     * _Available since v4.7._
     */
    function processProofCalldata(bytes32[] calldata proof, bytes32 leaf) internal pure returns (bytes32) {
        bytes32 computedHash = leaf;
        for (uint256 i = 0; i < proof.length; i++) {
            computedHash = _hashPair(computedHash, proof[i]);
        }
        return computedHash;
    }

    /**
     * @dev Returns true if the `leaves` can be simultaneously proven to be a part of a merkle tree defined by
     * `root`, according to `proof` and `proofFlags` as described in {processMultiProof}.
     *
     * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.
     *
     * _Available since v4.7._
     */
    function multiProofVerify(
        bytes32[] memory proof,
        bool[] memory proofFlags,
        bytes32 root,
        bytes32[] memory leaves
    ) internal pure returns (bool) {
        return processMultiProof(proof, proofFlags, leaves) == root;
    }

    /**
     * @dev Calldata version of {multiProofVerify}
     *
     * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.
     *
     * _Available since v4.7._
     */
    function multiProofVerifyCalldata(
        bytes32[] calldata proof,
        bool[] calldata proofFlags,
        bytes32 root,
        bytes32[] memory leaves
    ) internal pure returns (bool) {
        return processMultiProofCalldata(proof, proofFlags, leaves) == root;
    }

    /**
     * @dev Returns the root of a tree reconstructed from `leaves` and sibling nodes in `proof`. The reconstruction
     * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
     * leaf/inner node or a proof sibling node, depending on whether each `proofFlags` item is true or false
     * respectively.
     *
     * CAUTION: Not all merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
     * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
     * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
     *
     * _Available since v4.7._
     */
    function processMultiProof(
        bytes32[] memory proof,
        bool[] memory proofFlags,
        bytes32[] memory leaves
    ) internal pure returns (bytes32 merkleRoot) {
        // This function rebuild the root hash by traversing the tree up from the leaves. The root is rebuilt by
        // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
        // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
        // the merkle tree.
        uint256 leavesLen = leaves.length;
        uint256 totalHashes = proofFlags.length;

        // Check proof validity.
        require(leavesLen + proof.length - 1 == totalHashes, "MerkleProof: invalid multiproof");

        // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
        // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
        bytes32[] memory hashes = new bytes32[](totalHashes);
        uint256 leafPos = 0;
        uint256 hashPos = 0;
        uint256 proofPos = 0;
        // At each step, we compute the next hash using two values:
        // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
        //   get the next hash.
        // - depending on the flag, either another value for the "main queue" (merging branches) or an element from the
        //   `proof` array.
        for (uint256 i = 0; i < totalHashes; i++) {
            bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
            bytes32 b = proofFlags[i] ? leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++] : proof[proofPos++];
            hashes[i] = _hashPair(a, b);
        }

        if (totalHashes > 0) {
            return hashes[totalHashes - 1];
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

    /**
     * @dev Calldata version of {processMultiProof}.
     *
     * CAUTION: Not all merkle trees admit multiproofs. See {processMultiProof} for details.
     *
     * _Available since v4.7._
     */
    function processMultiProofCalldata(
        bytes32[] calldata proof,
        bool[] calldata proofFlags,
        bytes32[] memory leaves
    ) internal pure returns (bytes32 merkleRoot) {
        // This function rebuild the root hash by traversing the tree up from the leaves. The root is rebuilt by
        // consuming and producing values on a queue. The queue starts with the `leaves` array, then goes onto the
        // `hashes` array. At the end of the process, the last hash in the `hashes` array should contain the root of
        // the merkle tree.
        uint256 leavesLen = leaves.length;
        uint256 totalHashes = proofFlags.length;

        // Check proof validity.
        require(leavesLen + proof.length - 1 == totalHashes, "MerkleProof: invalid multiproof");

        // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
        // `xxx[xxxPos++]`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
        bytes32[] memory hashes = new bytes32[](totalHashes);
        uint256 leafPos = 0;
        uint256 hashPos = 0;
        uint256 proofPos = 0;
        // At each step, we compute the next hash using two values:
        // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
        //   get the next hash.
        // - depending on the flag, either another value for the "main queue" (merging branches) or an element from the
        //   `proof` array.
        for (uint256 i = 0; i < totalHashes; i++) {
            bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
            bytes32 b = proofFlags[i] ? leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++] : proof[proofPos++];
            hashes[i] = _hashPair(a, b);
        }

        if (totalHashes > 0) {
            return hashes[totalHashes - 1];
        } else if (leavesLen > 0) {
            return leaves[0];
        } else {
            return proof[0];
        }
    }

    function _hashPair(bytes32 a, bytes32 b) private pure returns (bytes32) {
        return a < b ? _efficientHash(a, b) : _efficientHash(b, a);
    }

    function _efficientHash(bytes32 a, bytes32 b) private pure returns (bytes32 value) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, a)
            mstore(0x20, b)
            value := keccak256(0x00, 0x40)
        }
    }
}

File 20 of 29 : ERC165Checker.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/introspection/ERC165Checker.sol)

pragma solidity ^0.8.0;

import "./IERC165.sol";

/**
 * @dev Library used to query support of an interface declared via {IERC165}.
 *
 * Note that these functions return the actual result of the query: they do not
 * `revert` if an interface is not supported. It is up to the caller to decide
 * what to do in these cases.
 */
library ERC165Checker {
    // As per the EIP-165 spec, no interface should ever match 0xffffffff
    bytes4 private constant _INTERFACE_ID_INVALID = 0xffffffff;

    /**
     * @dev Returns true if `account` supports the {IERC165} interface.
     */
    function supportsERC165(address account) internal view returns (bool) {
        // Any contract that implements ERC165 must explicitly indicate support of
        // InterfaceId_ERC165 and explicitly indicate non-support of InterfaceId_Invalid
        return
            supportsERC165InterfaceUnchecked(account, type(IERC165).interfaceId) &&
            !supportsERC165InterfaceUnchecked(account, _INTERFACE_ID_INVALID);
    }

    /**
     * @dev Returns true if `account` supports the interface defined by
     * `interfaceId`. Support for {IERC165} itself is queried automatically.
     *
     * See {IERC165-supportsInterface}.
     */
    function supportsInterface(address account, bytes4 interfaceId) internal view returns (bool) {
        // query support of both ERC165 as per the spec and support of _interfaceId
        return supportsERC165(account) && supportsERC165InterfaceUnchecked(account, interfaceId);
    }

    /**
     * @dev Returns a boolean array where each value corresponds to the
     * interfaces passed in and whether they're supported or not. This allows
     * you to batch check interfaces for a contract where your expectation
     * is that some interfaces may not be supported.
     *
     * See {IERC165-supportsInterface}.
     *
     * _Available since v3.4._
     */
    function getSupportedInterfaces(address account, bytes4[] memory interfaceIds)
        internal
        view
        returns (bool[] memory)
    {
        // an array of booleans corresponding to interfaceIds and whether they're supported or not
        bool[] memory interfaceIdsSupported = new bool[](interfaceIds.length);

        // query support of ERC165 itself
        if (supportsERC165(account)) {
            // query support of each interface in interfaceIds
            for (uint256 i = 0; i < interfaceIds.length; i++) {
                interfaceIdsSupported[i] = supportsERC165InterfaceUnchecked(account, interfaceIds[i]);
            }
        }

        return interfaceIdsSupported;
    }

    /**
     * @dev Returns true if `account` supports all the interfaces defined in
     * `interfaceIds`. Support for {IERC165} itself is queried automatically.
     *
     * Batch-querying can lead to gas savings by skipping repeated checks for
     * {IERC165} support.
     *
     * See {IERC165-supportsInterface}.
     */
    function supportsAllInterfaces(address account, bytes4[] memory interfaceIds) internal view returns (bool) {
        // query support of ERC165 itself
        if (!supportsERC165(account)) {
            return false;
        }

        // query support of each interface in interfaceIds
        for (uint256 i = 0; i < interfaceIds.length; i++) {
            if (!supportsERC165InterfaceUnchecked(account, interfaceIds[i])) {
                return false;
            }
        }

        // all interfaces supported
        return true;
    }

    /**
     * @notice Query if a contract implements an interface, does not check ERC165 support
     * @param account The address of the contract to query for support of an interface
     * @param interfaceId The interface identifier, as specified in ERC-165
     * @return true if the contract at account indicates support of the interface with
     * identifier interfaceId, false otherwise
     * @dev Assumes that account contains a contract that supports ERC165, otherwise
     * the behavior of this method is undefined. This precondition can be checked
     * with {supportsERC165}.
     * Interface identification is specified in ERC-165.
     */
    function supportsERC165InterfaceUnchecked(address account, bytes4 interfaceId) internal view returns (bool) {
        // prepare call
        bytes memory encodedParams = abi.encodeWithSelector(IERC165.supportsInterface.selector, interfaceId);

        // perform static call
        bool success;
        uint256 returnSize;
        uint256 returnValue;
        assembly {
            success := staticcall(30000, account, add(encodedParams, 0x20), mload(encodedParams), 0x00, 0x20)
            returnSize := returndatasize()
            returnValue := mload(0x00)
        }

        return success && returnSize >= 0x20 && returnValue > 0;
    }
}

File 21 of 29 : EnumerableSet.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/structs/EnumerableSet.sol)
// This file was procedurally generated from scripts/generate/templates/EnumerableSet.js.

pragma solidity ^0.8.0;

/**
 * @dev Library for managing
 * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
 * types.
 *
 * Sets have the following properties:
 *
 * - Elements are added, removed, and checked for existence in constant time
 * (O(1)).
 * - Elements are enumerated in O(n). No guarantees are made on the ordering.
 *
 * ```
 * contract Example {
 *     // Add the library methods
 *     using EnumerableSet for EnumerableSet.AddressSet;
 *
 *     // Declare a set state variable
 *     EnumerableSet.AddressSet private mySet;
 * }
 * ```
 *
 * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
 * and `uint256` (`UintSet`) are supported.
 *
 * [WARNING]
 * ====
 * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure
 * unusable.
 * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
 *
 * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an
 * array of EnumerableSet.
 * ====
 */
library EnumerableSet {
    // To implement this library for multiple types with as little code
    // repetition as possible, we write it in terms of a generic Set type with
    // bytes32 values.
    // The Set implementation uses private functions, and user-facing
    // implementations (such as AddressSet) are just wrappers around the
    // underlying Set.
    // This means that we can only create new EnumerableSets for types that fit
    // in bytes32.

    struct Set {
        // Storage of set values
        bytes32[] _values;
        // Position of the value in the `values` array, plus 1 because index 0
        // means a value is not in the set.
        mapping(bytes32 => uint256) _indexes;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function _add(Set storage set, bytes32 value) private returns (bool) {
        if (!_contains(set, value)) {
            set._values.push(value);
            // The value is stored at length-1, but we add 1 to all indexes
            // and use 0 as a sentinel value
            set._indexes[value] = set._values.length;
            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function _remove(Set storage set, bytes32 value) private returns (bool) {
        // We read and store the value's index to prevent multiple reads from the same storage slot
        uint256 valueIndex = set._indexes[value];

        if (valueIndex != 0) {
            // Equivalent to contains(set, value)
            // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
            // the array, and then remove the last element (sometimes called as 'swap and pop').
            // This modifies the order of the array, as noted in {at}.

            uint256 toDeleteIndex = valueIndex - 1;
            uint256 lastIndex = set._values.length - 1;

            if (lastIndex != toDeleteIndex) {
                bytes32 lastValue = set._values[lastIndex];

                // Move the last value to the index where the value to delete is
                set._values[toDeleteIndex] = lastValue;
                // Update the index for the moved value
                set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex
            }

            // Delete the slot where the moved value was stored
            set._values.pop();

            // Delete the index for the deleted slot
            delete set._indexes[value];

            return true;
        } else {
            return false;
        }
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function _contains(Set storage set, bytes32 value) private view returns (bool) {
        return set._indexes[value] != 0;
    }

    /**
     * @dev Returns the number of values on the set. O(1).
     */
    function _length(Set storage set) private view returns (uint256) {
        return set._values.length;
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function _at(Set storage set, uint256 index) private view returns (bytes32) {
        return set._values[index];
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function _values(Set storage set) private view returns (bytes32[] memory) {
        return set._values;
    }

    // Bytes32Set

    struct Bytes32Set {
        Set _inner;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
        return _add(set._inner, value);
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
        return _remove(set._inner, value);
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
        return _contains(set._inner, value);
    }

    /**
     * @dev Returns the number of values in the set. O(1).
     */
    function length(Bytes32Set storage set) internal view returns (uint256) {
        return _length(set._inner);
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
        return _at(set._inner, index);
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
        bytes32[] memory store = _values(set._inner);
        bytes32[] memory result;

        /// @solidity memory-safe-assembly
        assembly {
            result := store
        }

        return result;
    }

    // AddressSet

    struct AddressSet {
        Set _inner;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function add(AddressSet storage set, address value) internal returns (bool) {
        return _add(set._inner, bytes32(uint256(uint160(value))));
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function remove(AddressSet storage set, address value) internal returns (bool) {
        return _remove(set._inner, bytes32(uint256(uint160(value))));
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function contains(AddressSet storage set, address value) internal view returns (bool) {
        return _contains(set._inner, bytes32(uint256(uint160(value))));
    }

    /**
     * @dev Returns the number of values in the set. O(1).
     */
    function length(AddressSet storage set) internal view returns (uint256) {
        return _length(set._inner);
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function at(AddressSet storage set, uint256 index) internal view returns (address) {
        return address(uint160(uint256(_at(set._inner, index))));
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function values(AddressSet storage set) internal view returns (address[] memory) {
        bytes32[] memory store = _values(set._inner);
        address[] memory result;

        /// @solidity memory-safe-assembly
        assembly {
            result := store
        }

        return result;
    }

    // UintSet

    struct UintSet {
        Set _inner;
    }

    /**
     * @dev Add a value to a set. O(1).
     *
     * Returns true if the value was added to the set, that is if it was not
     * already present.
     */
    function add(UintSet storage set, uint256 value) internal returns (bool) {
        return _add(set._inner, bytes32(value));
    }

    /**
     * @dev Removes a value from a set. O(1).
     *
     * Returns true if the value was removed from the set, that is if it was
     * present.
     */
    function remove(UintSet storage set, uint256 value) internal returns (bool) {
        return _remove(set._inner, bytes32(value));
    }

    /**
     * @dev Returns true if the value is in the set. O(1).
     */
    function contains(UintSet storage set, uint256 value) internal view returns (bool) {
        return _contains(set._inner, bytes32(value));
    }

    /**
     * @dev Returns the number of values in the set. O(1).
     */
    function length(UintSet storage set) internal view returns (uint256) {
        return _length(set._inner);
    }

    /**
     * @dev Returns the value stored at position `index` in the set. O(1).
     *
     * Note that there are no guarantees on the ordering of values inside the
     * array, and it may change when more values are added or removed.
     *
     * Requirements:
     *
     * - `index` must be strictly less than {length}.
     */
    function at(UintSet storage set, uint256 index) internal view returns (uint256) {
        return uint256(_at(set._inner, index));
    }

    /**
     * @dev Return the entire set in an array
     *
     * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
     * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
     * this function has an unbounded cost, and using it as part of a state-changing function may render the function
     * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
     */
    function values(UintSet storage set) internal view returns (uint256[] memory) {
        bytes32[] memory store = _values(set._inner);
        uint256[] memory result;

        /// @solidity memory-safe-assembly
        assembly {
            result := store
        }

        return result;
    }
}

File 22 of 29 : AddressUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)

pragma solidity ^0.8.1;

/**
 * @dev Collection of functions related to the address type
 */
library AddressUpgradeable {
    /**
     * @dev Returns true if `account` is a contract.
     *
     * [IMPORTANT]
     * ====
     * It is unsafe to assume that an address for which this function returns
     * false is an externally-owned account (EOA) and not a contract.
     *
     * Among others, `isContract` will return false for the following
     * types of addresses:
     *
     *  - an externally-owned account
     *  - a contract in construction
     *  - an address where a contract will be created
     *  - an address where a contract lived, but was destroyed
     *
     * Furthermore, `isContract` will also return true if the target contract within
     * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
     * which only has an effect at the end of a transaction.
     * ====
     *
     * [IMPORTANT]
     * ====
     * You shouldn't rely on `isContract` to protect against flash loan attacks!
     *
     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
     * constructor.
     * ====
     */
    function isContract(address account) internal view returns (bool) {
        // This method relies on extcodesize/address.code.length, which returns 0
        // for contracts in construction, since the code is only stored at the end
        // of the constructor execution.

        return account.code.length > 0;
    }

    /**
     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
     * `recipient`, forwarding all available gas and reverting on errors.
     *
     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
     * of certain opcodes, possibly making contracts go over the 2300 gas limit
     * imposed by `transfer`, making them unable to receive funds via
     * `transfer`. {sendValue} removes this limitation.
     *
     * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
     *
     * IMPORTANT: because control is transferred to `recipient`, care must be
     * taken to not create reentrancy vulnerabilities. Consider using
     * {ReentrancyGuard} or the
     * https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
     */
    function sendValue(address payable recipient, uint256 amount) internal {
        require(address(this).balance >= amount, "Address: insufficient balance");

        (bool success, ) = recipient.call{value: amount}("");
        require(success, "Address: unable to send value, recipient may have reverted");
    }

    /**
     * @dev Performs a Solidity function call using a low level `call`. A
     * plain `call` is an unsafe replacement for a function call: use this
     * function instead.
     *
     * If `target` reverts with a revert reason, it is bubbled up by this
     * function (like regular Solidity function calls).
     *
     * Returns the raw returned data. To convert to the expected return value,
     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
     *
     * Requirements:
     *
     * - `target` must be a contract.
     * - calling `target` with `data` must not revert.
     *
     * _Available since v3.1._
     */
    function functionCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, "Address: low-level call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
     * `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but also transferring `value` wei to `target`.
     *
     * Requirements:
     *
     * - the calling contract must have an ETH balance of at least `value`.
     * - the called Solidity function must be `payable`.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
        return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
    }

    /**
     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
     * with `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value,
        string memory errorMessage
    ) internal returns (bytes memory) {
        require(address(this).balance >= value, "Address: insufficient balance for call");
        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
        return functionStaticCall(target, data, "Address: low-level static call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionDelegateCall(target, data, "Address: low-level delegate call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a delegate call.
     *
     * _Available since v3.4._
     */
    function functionDelegateCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        (bool success, bytes memory returndata) = target.delegatecall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
     *
     * _Available since v4.8._
     */
    function verifyCallResultFromTarget(
        address target,
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        if (success) {
            if (returndata.length == 0) {
                // only check isContract if the call was successful and the return data is empty
                // otherwise we already know that it was a contract
                require(isContract(target), "Address: call to non-contract");
            }
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    /**
     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason or using the provided one.
     *
     * _Available since v4.3._
     */
    function verifyCallResult(
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal pure returns (bytes memory) {
        if (success) {
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    function _revert(bytes memory returndata, string memory errorMessage) private pure {
        // Look for revert reason and bubble it up if present
        if (returndata.length > 0) {
            // The easiest way to bubble the revert reason is using memory via assembly
            /// @solidity memory-safe-assembly
            assembly {
                let returndata_size := mload(returndata)
                revert(add(32, returndata), returndata_size)
            }
        } else {
            revert(errorMessage);
        }
    }
}

File 23 of 29 : ICreatorExtensionRoyalties.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "@openzeppelin/contracts/utils/introspection/IERC165.sol";

/**
 * @dev Implement this if you want your extension to have overloadable royalties
 */
interface ICreatorExtensionRoyalties is IERC165 {

    /**
     * Get the royalties for a given creator/tokenId
     */
    function getRoyalties(address creator, uint256 tokenId) external view returns (address payable[] memory, uint256[] memory);
}

File 24 of 29 : ICreatorCore.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "@openzeppelin/contracts/utils/introspection/IERC165.sol";

/**
 * @dev Core creator interface
 */
interface ICreatorCore is IERC165 {

    event ExtensionRegistered(address indexed extension, address indexed sender);
    event ExtensionUnregistered(address indexed extension, address indexed sender);
    event ExtensionBlacklisted(address indexed extension, address indexed sender);
    event MintPermissionsUpdated(address indexed extension, address indexed permissions, address indexed sender);
    event RoyaltiesUpdated(uint256 indexed tokenId, address payable[] receivers, uint256[] basisPoints);
    event DefaultRoyaltiesUpdated(address payable[] receivers, uint256[] basisPoints);
    event ApproveTransferUpdated(address extension);
    event ExtensionRoyaltiesUpdated(address indexed extension, address payable[] receivers, uint256[] basisPoints);
    event ExtensionApproveTransferUpdated(address indexed extension, bool enabled);

    /**
     * @dev gets address of all extensions
     */
    function getExtensions() external view returns (address[] memory);

    /**
     * @dev add an extension.  Can only be called by contract owner or admin.
     * extension address must point to a contract implementing ICreatorExtension.
     * Returns True if newly added, False if already added.
     */
    function registerExtension(address extension, string calldata baseURI) external;

    /**
     * @dev add an extension.  Can only be called by contract owner or admin.
     * extension address must point to a contract implementing ICreatorExtension.
     * Returns True if newly added, False if already added.
     */
    function registerExtension(address extension, string calldata baseURI, bool baseURIIdentical) external;

    /**
     * @dev add an extension.  Can only be called by contract owner or admin.
     * Returns True if removed, False if already removed.
     */
    function unregisterExtension(address extension) external;

    /**
     * @dev blacklist an extension.  Can only be called by contract owner or admin.
     * This function will destroy all ability to reference the metadata of any tokens created
     * by the specified extension. It will also unregister the extension if needed.
     * Returns True if removed, False if already removed.
     */
    function blacklistExtension(address extension) external;

    /**
     * @dev set the baseTokenURI of an extension.  Can only be called by extension.
     */
    function setBaseTokenURIExtension(string calldata uri) external;

    /**
     * @dev set the baseTokenURI of an extension.  Can only be called by extension.
     * For tokens with no uri configured, tokenURI will return "uri+tokenId"
     */
    function setBaseTokenURIExtension(string calldata uri, bool identical) external;

    /**
     * @dev set the common prefix of an extension.  Can only be called by extension.
     * If configured, and a token has a uri set, tokenURI will return "prefixURI+tokenURI"
     * Useful if you want to use ipfs/arweave
     */
    function setTokenURIPrefixExtension(string calldata prefix) external;

    /**
     * @dev set the tokenURI of a token extension.  Can only be called by extension that minted token.
     */
    function setTokenURIExtension(uint256 tokenId, string calldata uri) external;

    /**
     * @dev set the tokenURI of a token extension for multiple tokens.  Can only be called by extension that minted token.
     */
    function setTokenURIExtension(uint256[] memory tokenId, string[] calldata uri) external;

    /**
     * @dev set the baseTokenURI for tokens with no extension.  Can only be called by owner/admin.
     * For tokens with no uri configured, tokenURI will return "uri+tokenId"
     */
    function setBaseTokenURI(string calldata uri) external;

    /**
     * @dev set the common prefix for tokens with no extension.  Can only be called by owner/admin.
     * If configured, and a token has a uri set, tokenURI will return "prefixURI+tokenURI"
     * Useful if you want to use ipfs/arweave
     */
    function setTokenURIPrefix(string calldata prefix) external;

    /**
     * @dev set the tokenURI of a token with no extension.  Can only be called by owner/admin.
     */
    function setTokenURI(uint256 tokenId, string calldata uri) external;

    /**
     * @dev set the tokenURI of multiple tokens with no extension.  Can only be called by owner/admin.
     */
    function setTokenURI(uint256[] memory tokenIds, string[] calldata uris) external;

    /**
     * @dev set a permissions contract for an extension.  Used to control minting.
     */
    function setMintPermissions(address extension, address permissions) external;

    /**
     * @dev Configure so transfers of tokens created by the caller (must be extension) gets approval
     * from the extension before transferring
     */
    function setApproveTransferExtension(bool enabled) external;

    /**
     * @dev get the extension of a given token
     */
    function tokenExtension(uint256 tokenId) external view returns (address);

    /**
     * @dev Set default royalties
     */
    function setRoyalties(address payable[] calldata receivers, uint256[] calldata basisPoints) external;

    /**
     * @dev Set royalties of a token
     */
    function setRoyalties(uint256 tokenId, address payable[] calldata receivers, uint256[] calldata basisPoints) external;

    /**
     * @dev Set royalties of an extension
     */
    function setRoyaltiesExtension(address extension, address payable[] calldata receivers, uint256[] calldata basisPoints) external;

    /**
     * @dev Get royalites of a token.  Returns list of receivers and basisPoints
     */
    function getRoyalties(uint256 tokenId) external view returns (address payable[] memory, uint256[] memory);
    
    // Royalty support for various other standards
    function getFeeRecipients(uint256 tokenId) external view returns (address payable[] memory);
    function getFeeBps(uint256 tokenId) external view returns (uint[] memory);
    function getFees(uint256 tokenId) external view returns (address payable[] memory, uint256[] memory);
    function royaltyInfo(uint256 tokenId, uint256 value) external view returns (address, uint256);

    /**
     * @dev Set the default approve transfer contract location.
     */
    function setApproveTransfer(address extension) external; 

    /**
     * @dev Get the default approve transfer contract location.
     */
    function getApproveTransfer() external view returns (address);
}

File 25 of 29 : IERC165.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC165 standard, as defined in the
 * https://eips.ethereum.org/EIPS/eip-165[EIP].
 *
 * Implementers can declare support of contract interfaces, which can then be
 * queried by others ({ERC165Checker}).
 *
 * For an implementation, see {ERC165}.
 */
interface IERC165 {
    /**
     * @dev Returns true if this contract implements the interface defined by
     * `interfaceId`. See the corresponding
     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
     * to learn more about how these ids are created.
     *
     * This function call must use less than 30 000 gas.
     */
    function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

File 26 of 29 : Context.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)

pragma solidity ^0.8.0;

/**
 * @dev Provides information about the current execution context, including the
 * sender of the transaction and its data. While these are generally available
 * via msg.sender and msg.data, they should not be accessed in such a direct
 * manner, since when dealing with meta-transactions the account sending and
 * paying for execution may not be the actual sender (as far as an application
 * is concerned).
 *
 * This contract is only required for intermediate, library-like contracts.
 */
abstract contract Context {
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

    function _msgData() internal view virtual returns (bytes calldata) {
        return msg.data;
    }
}

File 27 of 29 : Math.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol)

pragma solidity ^0.8.0;

/**
 * @dev Standard math utilities missing in the Solidity language.
 */
library Math {
    enum Rounding {
        Down, // Toward negative infinity
        Up, // Toward infinity
        Zero // Toward zero
    }

    /**
     * @dev Returns the largest of two numbers.
     */
    function max(uint256 a, uint256 b) internal pure returns (uint256) {
        return a > b ? a : b;
    }

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

    /**
     * @dev Returns the average of two numbers. The result is rounded towards
     * zero.
     */
    function average(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b) / 2 can overflow.
        return (a & b) + (a ^ b) / 2;
    }

    /**
     * @dev Returns the ceiling of the division of two numbers.
     *
     * This differs from standard division with `/` in that it rounds up instead
     * of rounding down.
     */
    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
        // (a + b - 1) / b can overflow on addition, so we distribute.
        return a == 0 ? 0 : (a - 1) / b + 1;
    }

    /**
     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
     * with further edits by Uniswap Labs also under MIT license.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator
    ) internal pure returns (uint256 result) {
        unchecked {
            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
            // variables such that product = prod1 * 2^256 + prod0.
            uint256 prod0; // Least significant 256 bits of the product
            uint256 prod1; // Most significant 256 bits of the product
            assembly {
                let mm := mulmod(x, y, not(0))
                prod0 := mul(x, y)
                prod1 := sub(sub(mm, prod0), lt(mm, prod0))
            }

            // Handle non-overflow cases, 256 by 256 division.
            if (prod1 == 0) {
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            require(denominator > prod1);

            ///////////////////////////////////////////////
            // 512 by 256 division.
            ///////////////////////////////////////////////

            // Make division exact by subtracting the remainder from [prod1 prod0].
            uint256 remainder;
            assembly {
                // Compute remainder using mulmod.
                remainder := mulmod(x, y, denominator)

                // Subtract 256 bit number from 512 bit number.
                prod1 := sub(prod1, gt(remainder, prod0))
                prod0 := sub(prod0, remainder)
            }

            // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
            // See https://cs.stackexchange.com/q/138556/92363.

            // Does not overflow because the denominator cannot be zero at this stage in the function.
            uint256 twos = denominator & (~denominator + 1);
            assembly {
                // Divide denominator by twos.
                denominator := div(denominator, twos)

                // Divide [prod1 prod0] by twos.
                prod0 := div(prod0, twos)

                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
                twos := add(div(sub(0, twos), twos), 1)
            }

            // Shift in bits from prod1 into prod0.
            prod0 |= prod1 * twos;

            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
            // four bits. That is, denominator * inv = 1 mod 2^4.
            uint256 inverse = (3 * denominator) ^ 2;

            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
            // in modular arithmetic, doubling the correct bits in each step.
            inverse *= 2 - denominator * inverse; // inverse mod 2^8
            inverse *= 2 - denominator * inverse; // inverse mod 2^16
            inverse *= 2 - denominator * inverse; // inverse mod 2^32
            inverse *= 2 - denominator * inverse; // inverse mod 2^64
            inverse *= 2 - denominator * inverse; // inverse mod 2^128
            inverse *= 2 - denominator * inverse; // inverse mod 2^256

            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
            // is no longer required.
            result = prod0 * inverse;
            return result;
        }
    }

    /**
     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
     */
    function mulDiv(
        uint256 x,
        uint256 y,
        uint256 denominator,
        Rounding rounding
    ) internal pure returns (uint256) {
        uint256 result = mulDiv(x, y, denominator);
        if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
            result += 1;
        }
        return result;
    }

    /**
     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
     *
     * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
     */
    function sqrt(uint256 a) internal pure returns (uint256) {
        if (a == 0) {
            return 0;
        }

        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
        //
        // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
        //
        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
        //
        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
        uint256 result = 1 << (log2(a) >> 1);

        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
        // into the expected uint128 result.
        unchecked {
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            result = (result + a / result) >> 1;
            return min(result, a / result);
        }
    }

    /**
     * @notice Calculates sqrt(a), following the selected rounding direction.
     */
    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = sqrt(a);
            return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
        }
    }

    /**
     * @dev Return the log in base 2, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log2(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >> 128 > 0) {
                value >>= 128;
                result += 128;
            }
            if (value >> 64 > 0) {
                value >>= 64;
                result += 64;
            }
            if (value >> 32 > 0) {
                value >>= 32;
                result += 32;
            }
            if (value >> 16 > 0) {
                value >>= 16;
                result += 16;
            }
            if (value >> 8 > 0) {
                value >>= 8;
                result += 8;
            }
            if (value >> 4 > 0) {
                value >>= 4;
                result += 4;
            }
            if (value >> 2 > 0) {
                value >>= 2;
                result += 2;
            }
            if (value >> 1 > 0) {
                result += 1;
            }
        }
        return result;
    }

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

    /**
     * @dev Return the log in base 10, rounded down, of a positive value.
     * Returns 0 if given 0.
     */
    function log10(uint256 value) internal pure returns (uint256) {
        uint256 result = 0;
        unchecked {
            if (value >= 10**64) {
                value /= 10**64;
                result += 64;
            }
            if (value >= 10**32) {
                value /= 10**32;
                result += 32;
            }
            if (value >= 10**16) {
                value /= 10**16;
                result += 16;
            }
            if (value >= 10**8) {
                value /= 10**8;
                result += 8;
            }
            if (value >= 10**4) {
                value /= 10**4;
                result += 4;
            }
            if (value >= 10**2) {
                value /= 10**2;
                result += 2;
            }
            if (value >= 10**1) {
                result += 1;
            }
        }
        return result;
    }

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

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

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

File 28 of 29 : IERC721Receiver.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)

pragma solidity ^0.8.0;

/**
 * @title ERC721 token receiver interface
 * @dev Interface for any contract that wants to support safeTransfers
 * from ERC721 asset contracts.
 */
interface IERC721Receiver {
    /**
     * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
     * by `operator` from `from`, this function is called.
     *
     * It must return its Solidity selector to confirm the token transfer.
     * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
     *
     * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
     */
    function onERC721Received(
        address operator,
        address from,
        uint256 tokenId,
        bytes calldata data
    ) external returns (bytes4);
}

File 29 of 29 : IERC1155Receiver.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (token/ERC1155/IERC1155Receiver.sol)

pragma solidity ^0.8.0;

import "../../utils/introspection/IERC165.sol";

/**
 * @dev _Available since v3.1._
 */
interface IERC1155Receiver is IERC165 {
    /**
     * @dev Handles the receipt of a single ERC1155 token type. This function is
     * called at the end of a `safeTransferFrom` after the balance has been updated.
     *
     * NOTE: To accept the transfer, this must return
     * `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
     * (i.e. 0xf23a6e61, or its own function selector).
     *
     * @param operator The address which initiated the transfer (i.e. msg.sender)
     * @param from The address which previously owned the token
     * @param id The ID of the token being transferred
     * @param value The amount of tokens being transferred
     * @param data Additional data with no specified format
     * @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
     */
    function onERC1155Received(
        address operator,
        address from,
        uint256 id,
        uint256 value,
        bytes calldata data
    ) external returns (bytes4);

    /**
     * @dev Handles the receipt of a multiple ERC1155 token types. This function
     * is called at the end of a `safeBatchTransferFrom` after the balances have
     * been updated.
     *
     * NOTE: To accept the transfer(s), this must return
     * `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
     * (i.e. 0xbc197c81, or its own function selector).
     *
     * @param operator The address which initiated the batch transfer (i.e. msg.sender)
     * @param from The address which previously owned the token
     * @param ids An array containing ids of each token being transferred (order and length must match values array)
     * @param values An array containing amounts of each token being transferred (order and length must match ids array)
     * @param data Additional data with no specified format
     * @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
     */
    function onERC1155BatchReceived(
        address operator,
        address from,
        uint256[] calldata ids,
        uint256[] calldata values,
        bytes calldata data
    ) external returns (bytes4);
}

Settings
{
  "remappings": [
    "@ensdomains/=node_modules/@ensdomains/",
    "@manifoldxyz/=node_modules/@manifoldxyz/",
    "@openzeppelin/=node_modules/@openzeppelin/",
    "create2-helpers/=lib/create2-helpers/src/",
    "create2-scripts/=lib/create2-helpers/script/",
    "creator-core-solidity/=lib/creator-core-solidity/contracts/",
    "ds-test/=lib/forge-std/lib/ds-test/src/",
    "erc4626-tests/=lib/openzeppelin-contracts-upgradeable/lib/erc4626-tests/",
    "eth-gas-reporter/=node_modules/eth-gas-reporter/",
    "forge-std/=lib/forge-std/src/",
    "hardhat/=node_modules/hardhat/",
    "libraries-solidity/=lib/libraries-solidity/contracts/",
    "murky/=lib/murky/src/",
    "openzeppelin-contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/",
    "openzeppelin-contracts/=lib/openzeppelin-contracts/",
    "operator-filter-registry/=node_modules/operator-filter-registry/",
    "truffle/=node_modules/truffle/",
    "lib/forge-std:ds-test/=lib/forge-std/lib/ds-test/src/",
    "lib/murky:ds-test/=lib/murky/lib/forge-std/lib/ds-test/src/",
    "lib/murky:forge-std/=lib/murky/lib/forge-std/src/",
    "lib/murky:openzeppelin-contracts/=lib/murky/lib/openzeppelin-contracts/",
    "lib/openzeppelin-contracts:ds-test/=lib/openzeppelin-contracts/lib/forge-std/lib/ds-test/src/",
    "lib/openzeppelin-contracts:erc4626-tests/=lib/openzeppelin-contracts/lib/erc4626-tests/",
    "lib/openzeppelin-contracts:forge-std/=lib/openzeppelin-contracts/lib/forge-std/src/",
    "lib/openzeppelin-contracts:openzeppelin/=lib/openzeppelin-contracts/contracts/",
    "lib/openzeppelin-contracts-upgradeable:ds-test/=lib/openzeppelin-contracts-upgradeable/lib/forge-std/lib/ds-test/src/",
    "lib/openzeppelin-contracts-upgradeable:erc4626-tests/=lib/openzeppelin-contracts-upgradeable/lib/erc4626-tests/",
    "lib/openzeppelin-contracts-upgradeable:forge-std/=lib/openzeppelin-contracts-upgradeable/lib/forge-std/src/",
    "lib/openzeppelin-contracts-upgradeable:openzeppelin/=lib/openzeppelin-contracts-upgradeable/contracts/",
    "lib/operator-filter-registry:ds-test/=lib/operator-filter-registry/lib/ds-test/src/",
    "lib/operator-filter-registry:erc4626-tests/=lib/operator-filter-registry/lib/openzeppelin-contracts/lib/erc4626-tests/",
    "lib/operator-filter-registry:forge-std/=lib/operator-filter-registry/lib/forge-std/src/",
    "lib/operator-filter-registry:openzeppelin-contracts-upgradeable/=lib/operator-filter-registry/lib/openzeppelin-contracts-upgradeable/contracts/",
    "lib/operator-filter-registry:openzeppelin-contracts/=lib/operator-filter-registry/lib/openzeppelin-contracts/contracts/"
  ],
  "optimizer": {
    "enabled": true,
    "runs": 150
  },
  "metadata": {
    "useLiteralContent": false,
    "bytecodeHash": "ipfs"
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  },
  "evmVersion": "london",
  "libraries": {
    "contracts/burnredeem/BurnRedeemLib.sol": {
      "BurnRedeemLib": "0x70b4070953cdf0cf33d69322495df78a83b734e9"
    }
  }
}

Contract Security Audit

Contract ABI

[{"inputs":[{"internalType":"address","name":"initialOwner","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"BurnRedeemDoesNotExist","type":"error"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"BurnRedeemInactive","type":"error"},{"inputs":[],"name":"InvalidBurnAmount","type":"error"},{"inputs":[],"name":"InvalidBurnSpec","type":"error"},{"inputs":[],"name":"InvalidData","type":"error"},{"inputs":[],"name":"InvalidInput","type":"error"},{"inputs":[],"name":"InvalidPaymentAmount","type":"error"},{"inputs":[],"name":"InvalidRedeemAmount","type":"error"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"InvalidToken","type":"error"},{"inputs":[],"name":"InvalidTokenSpec","type":"error"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"NotAdmin","type":"error"},{"inputs":[],"name":"TransferFailure","type":"error"},{"inputs":[],"name":"UnsupportedContractVersion","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"AdminApproved","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"AdminRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"inputs":[],"name":"BURN_FEE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MULTI_BURN_FEE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"instanceId","type":"uint256"},{"internalType":"address[]","name":"recipients","type":"address[]"},{"internalType":"uint32[]","name":"amounts","type":"uint32[]"}],"name":"airdrop","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"admin","type":"address"}],"name":"approveAdmin","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"creatorContractAddresses","type":"address[]"},{"internalType":"uint256[]","name":"instanceIds","type":"uint256[]"},{"internalType":"uint32[]","name":"burnRedeemCounts","type":"uint32[]"},{"components":[{"internalType":"uint48","name":"groupIndex","type":"uint48"},{"internalType":"uint48","name":"itemIndex","type":"uint48"},{"internalType":"address","name":"contractAddress","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"bytes32[]","name":"merkleProof","type":"bytes32[]"}],"internalType":"struct IBurnRedeemCore.BurnToken[][]","name":"burnTokens","type":"tuple[][]"}],"name":"burnRedeem","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"instanceId","type":"uint256"},{"internalType":"uint32","name":"burnRedeemCount","type":"uint32"},{"components":[{"internalType":"uint48","name":"groupIndex","type":"uint48"},{"internalType":"uint48","name":"itemIndex","type":"uint48"},{"internalType":"address","name":"contractAddress","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"bytes32[]","name":"merkleProof","type":"bytes32[]"}],"internalType":"struct IBurnRedeemCore.BurnToken[]","name":"burnTokens","type":"tuple[]"}],"name":"burnRedeem","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"instanceId","type":"uint256"},{"internalType":"uint32","name":"burnRedeemCount","type":"uint32"},{"components":[{"internalType":"uint48","name":"groupIndex","type":"uint48"},{"internalType":"uint48","name":"itemIndex","type":"uint48"},{"internalType":"address","name":"contractAddress","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"bytes32[]","name":"merkleProof","type":"bytes32[]"}],"internalType":"struct IBurnRedeemCore.BurnToken[]","name":"burnTokens","type":"tuple[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"burnRedeemWithData","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"getAdmins","outputs":[{"internalType":"address[]","name":"admins","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"instanceId","type":"uint256"}],"name":"getBurnRedeem","outputs":[{"components":[{"internalType":"address payable","name":"paymentReceiver","type":"address"},{"internalType":"enum IBurnRedeemCore.StorageProtocol","name":"storageProtocol","type":"uint8"},{"internalType":"uint32","name":"redeemedCount","type":"uint32"},{"internalType":"uint16","name":"redeemAmount","type":"uint16"},{"internalType":"uint32","name":"totalSupply","type":"uint32"},{"internalType":"uint8","name":"contractVersion","type":"uint8"},{"internalType":"uint48","name":"startDate","type":"uint48"},{"internalType":"uint48","name":"endDate","type":"uint48"},{"internalType":"uint160","name":"cost","type":"uint160"},{"internalType":"string","name":"location","type":"string"},{"components":[{"internalType":"uint256","name":"requiredCount","type":"uint256"},{"components":[{"internalType":"enum IBurnRedeemCore.ValidationType","name":"validationType","type":"uint8"},{"internalType":"address","name":"contractAddress","type":"address"},{"internalType":"enum IBurnRedeemCore.TokenSpec","name":"tokenSpec","type":"uint8"},{"internalType":"enum IBurnRedeemCore.BurnSpec","name":"burnSpec","type":"uint8"},{"internalType":"uint72","name":"amount","type":"uint72"},{"internalType":"uint256","name":"minTokenId","type":"uint256"},{"internalType":"uint256","name":"maxTokenId","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"internalType":"struct IBurnRedeemCore.BurnItem[]","name":"items","type":"tuple[]"}],"internalType":"struct IBurnRedeemCore.BurnGroup[]","name":"burnSet","type":"tuple[]"}],"internalType":"struct IBurnRedeemCore.BurnRedeem","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getBurnRedeemForToken","outputs":[{"internalType":"uint256","name":"instanceId","type":"uint256"},{"components":[{"internalType":"address payable","name":"paymentReceiver","type":"address"},{"internalType":"enum IBurnRedeemCore.StorageProtocol","name":"storageProtocol","type":"uint8"},{"internalType":"uint32","name":"redeemedCount","type":"uint32"},{"internalType":"uint16","name":"redeemAmount","type":"uint16"},{"internalType":"uint32","name":"totalSupply","type":"uint32"},{"internalType":"uint8","name":"contractVersion","type":"uint8"},{"internalType":"uint48","name":"startDate","type":"uint48"},{"internalType":"uint48","name":"endDate","type":"uint48"},{"internalType":"uint160","name":"cost","type":"uint160"},{"internalType":"string","name":"location","type":"string"},{"components":[{"internalType":"uint256","name":"requiredCount","type":"uint256"},{"components":[{"internalType":"enum IBurnRedeemCore.ValidationType","name":"validationType","type":"uint8"},{"internalType":"address","name":"contractAddress","type":"address"},{"internalType":"enum IBurnRedeemCore.TokenSpec","name":"tokenSpec","type":"uint8"},{"internalType":"enum IBurnRedeemCore.BurnSpec","name":"burnSpec","type":"uint8"},{"internalType":"uint72","name":"amount","type":"uint72"},{"internalType":"uint256","name":"minTokenId","type":"uint256"},{"internalType":"uint256","name":"maxTokenId","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"internalType":"struct IBurnRedeemCore.BurnItem[]","name":"items","type":"tuple[]"}],"internalType":"struct IBurnRedeemCore.BurnGroup[]","name":"burnSet","type":"tuple[]"}],"internalType":"struct IBurnRedeemCore.BurnRedeem","name":"burnRedeem","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"instanceId","type":"uint256"}],"name":"getBurnRedeemToken","outputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"instanceId","type":"uint256"},{"components":[{"internalType":"address payable","name":"paymentReceiver","type":"address"},{"internalType":"enum IBurnRedeemCore.StorageProtocol","name":"storageProtocol","type":"uint8"},{"internalType":"uint16","name":"redeemAmount","type":"uint16"},{"internalType":"uint32","name":"totalSupply","type":"uint32"},{"internalType":"uint48","name":"startDate","type":"uint48"},{"internalType":"uint48","name":"endDate","type":"uint48"},{"internalType":"uint160","name":"cost","type":"uint160"},{"internalType":"string","name":"location","type":"string"},{"components":[{"internalType":"uint256","name":"requiredCount","type":"uint256"},{"components":[{"internalType":"enum IBurnRedeemCore.ValidationType","name":"validationType","type":"uint8"},{"internalType":"address","name":"contractAddress","type":"address"},{"internalType":"enum IBurnRedeemCore.TokenSpec","name":"tokenSpec","type":"uint8"},{"internalType":"enum IBurnRedeemCore.BurnSpec","name":"burnSpec","type":"uint8"},{"internalType":"uint72","name":"amount","type":"uint72"},{"internalType":"uint256","name":"minTokenId","type":"uint256"},{"internalType":"uint256","name":"maxTokenId","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"internalType":"struct IBurnRedeemCore.BurnItem[]","name":"items","type":"tuple[]"}],"internalType":"struct IBurnRedeemCore.BurnGroup[]","name":"burnSet","type":"tuple[]"}],"internalType":"struct IBurnRedeemCore.BurnRedeemParameters","name":"burnRedeemParameters","type":"tuple"}],"name":"initializeBurnRedeem","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"admin","type":"address"}],"name":"isAdmin","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"manifoldMembershipContract","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"from","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"values","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onERC1155BatchReceived","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"from","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onERC1155Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"from","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onERC721Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"tokenAddress","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"destination","type":"address"}],"name":"recoverERC721","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"admin","type":"address"}],"name":"revokeAdmin","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"setMembershipAddress","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":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"uri","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"instanceId","type":"uint256"},{"components":[{"internalType":"address payable","name":"paymentReceiver","type":"address"},{"internalType":"enum IBurnRedeemCore.StorageProtocol","name":"storageProtocol","type":"uint8"},{"internalType":"uint16","name":"redeemAmount","type":"uint16"},{"internalType":"uint32","name":"totalSupply","type":"uint32"},{"internalType":"uint48","name":"startDate","type":"uint48"},{"internalType":"uint48","name":"endDate","type":"uint48"},{"internalType":"uint160","name":"cost","type":"uint160"},{"internalType":"string","name":"location","type":"string"},{"components":[{"internalType":"uint256","name":"requiredCount","type":"uint256"},{"components":[{"internalType":"enum IBurnRedeemCore.ValidationType","name":"validationType","type":"uint8"},{"internalType":"address","name":"contractAddress","type":"address"},{"internalType":"enum IBurnRedeemCore.TokenSpec","name":"tokenSpec","type":"uint8"},{"internalType":"enum IBurnRedeemCore.BurnSpec","name":"burnSpec","type":"uint8"},{"internalType":"uint72","name":"amount","type":"uint72"},{"internalType":"uint256","name":"minTokenId","type":"uint256"},{"internalType":"uint256","name":"maxTokenId","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"}],"internalType":"struct IBurnRedeemCore.BurnItem[]","name":"items","type":"tuple[]"}],"internalType":"struct IBurnRedeemCore.BurnGroup[]","name":"burnSet","type":"tuple[]"}],"internalType":"struct IBurnRedeemCore.BurnRedeemParameters","name":"burnRedeemParameters","type":"tuple"}],"name":"updateBurnRedeem","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"creatorContractAddress","type":"address"},{"internalType":"uint256","name":"instanceId","type":"uint256"},{"internalType":"enum IBurnRedeemCore.StorageProtocol","name":"storageProtocol","type":"uint8"},{"internalType":"string","name":"location","type":"string"}],"name":"updateURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address payable","name":"recipient","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"}]

60806040523480156200001157600080fd5b506040516200525f3803806200525f8339810160408190526200003491620000a8565b80620000403362000058565b6001600355620000508162000058565b5050620000da565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b600060208284031215620000bb57600080fd5b81516001600160a01b0381168114620000d357600080fd5b9392505050565b61517580620000ea6000396000f3fe6080604052600436106101775760003560e01c8063715018a6116100cc578063c2065c101161007a578063c2065c101461045e578063c9dad6961461047e578063e9dc637514610491578063f0e9fcd1146104be578063f23a6e61146104de578063f2fde38b146104fe578063f3fef3a31461051e57600080fd5b8063715018a6146103835780637ab393921461039857806384f05f24146103b85780638da5cb5b146103d857806395bc312b146103f6578063b058d2f814610411578063bc197c811461043e57600080fd5b806341d29f071161012957806341d29f071461028e57806342b54fee146102bc578063480df058146102cf57806350d10839146102f85780635a7373df14610330578063625888da146103435780636d73e6691461036357600080fd5b806301ffc9a71461017c57806304ea1e90146101b1578063150b7a02146101d357806324d7806c1461020c5780632d3456701461022c57806331ae450b1461024c57806338ec89951461026e575b600080fd5b34801561018857600080fd5b5061019c6101973660046139f2565b61053e565b60405190151581526020015b60405180910390f35b3480156101bd57600080fd5b506101d16101cc366004613a8d565b610569565b005b3480156101df57600080fd5b506101f36101ee366004613afd565b6105f8565b6040516001600160e01b031990911681526020016101a8565b34801561021857600080fd5b5061019c610227366004613b52565b61062a565b34801561023857600080fd5b506101d1610247366004613b52565b610663565b34801561025857600080fd5b506102616106c1565b6040516101a89190613bb3565b34801561027a57600080fd5b506101d1610289366004613bc6565b61076f565b34801561029a57600080fd5b506102ae6102a9366004613c26565b610926565b6040516101a8929190613f09565b6101d16102ca366004613f6e565b610c8f565b3480156102db57600080fd5b506102ea6602738d24e5200081565b6040519081526020016101a8565b34801561030457600080fd5b50600554610318906001600160a01b031681565b6040516001600160a01b0390911681526020016101a8565b6101d161033e366004614045565b610dca565b34801561034f57600080fd5b506101d161035e366004613bc6565b610e55565b34801561036f57600080fd5b506101d161037e366004613b52565b610e6e565b34801561038f57600080fd5b506101d1610ec6565b3480156103a457600080fd5b506101d16103b3366004613b52565b610eda565b3480156103c457600080fd5b506102ea6103d3366004613c26565b610f4f565b3480156103e457600080fd5b506000546001600160a01b0316610318565b34801561040257600080fd5b506102ea660384665653e00081565b34801561041d57600080fd5b5061043161042c366004613c26565b610f97565b6040516101a891906140e1565b34801561044a57600080fd5b506101f36104593660046140f4565b6112de565b34801561046a57600080fd5b506101d161047936600461419e565b611362565b6101d161048c366004614229565b611522565b34801561049d57600080fd5b506104b16104ac366004613c26565b61157f565b6040516101a89190614288565b3480156104ca57600080fd5b506101d16104d936600461429b565b6119a6565b3480156104ea57600080fd5b506101f36104f93660046142d2565b611a54565b34801561050a57600080fd5b506101d1610519366004613b52565b611ad9565b34801561052a57600080fd5b506101d1610539366004613c26565b611b4f565b60006001600160e01b0319821663daae40fb60e01b1480610563575061056382611ba3565b92915050565b61057285611c19565b600061057e8686611ca9565b80549091508490829060ff60a01b1916600160a01b8360038111156105a5576105a5613c52565b0217905550600281016105b98385836143dc565b5060405185906001600160a01b038816907fc4487c68aeaaea10bc0e1e6408497e8b1eedeb6aeece8711fdb0da6b6c288dab90600090a3505050505050565b6000610602611d0b565b61060e85858585611d64565b50630a85bd0160e11b6106216001600355565b95945050505050565b6000816001600160a01b03166106486000546001600160a01b031690565b6001600160a01b031614806105635750610563600183612064565b61066b612089565b610676600182612064565b156106be5760405133906001600160a01b038316907f7c0c3c84c67c85fcac635147348bfe374c24a1a93d0366d1cfe9d8853cbf89d590600090a36106bc6001826120e3565b505b50565b60606106cd60016120f8565b6001600160401b038111156106e4576106e4614346565b60405190808252806020026020018201604052801561070d578160200160208202803683370190505b50905060005b61071d60016120f8565b81101561076b5761072f600182612102565b8282815181106107415761074161449b565b6001600160a01b039092166020928302919091019091015280610763816144c7565b915050610713565b5090565b61077883611c19565b610785836000848461210e565b6040805160018082528183019092526000916020808301908036833701905050905033816000815181106107bb576107bb61449b565b6001600160a01b039290921660209283029190910190910152604080516001808252818301909252600091816020015b60608152602001906001900390816107eb57505060408051600180825281830190925291925060009190602080830190803683375050604051634637423960e11b81529192506000916001600160a01b0389169150638c6e84729061085890879086908890600401614510565b6000604051808303816000875af1158015610877573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261089f9190810190614612565b9050806000815181106108b4576108b461449b565b6020908102919091018101516001600160a01b03891660008181526006845260408082208b8352855280822093909355908152600790925281208251889290849082906109035761090361449b565b602002602001015181526020019081526020016000208190555050505050505050565b6000610930613993565b61093a8484612199565b6001600160a01b038581166000908152600460209081526040808320858452825291829020825161016081019093528054938416835293955090929190830190600160a01b900460ff16600381111561099557610995613c52565b60038111156109a6576109a6613c52565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e082015260028201805461010090920191610a369061435c565b80601f0160208091040260200160405190810160405280929190818152602001828054610a629061435c565b8015610aaf5780601f10610a8457610100808354040283529160200191610aaf565b820191906000526020600020905b815481529060010190602001808311610a9257829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b82821015610c7e57838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b82821015610c675783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115610b7757610b77613c52565b6004811115610b8857610b88613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115610bc057610bc0613c52565b6002811115610bd157610bd1613c52565b81528154602090910190600160b01b900460ff166002811115610bf657610bf6613c52565b6002811115610c0757610c07613c52565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505081526020019060010190610b2f565b505050508152505081526020019060010190610add565b505050508152505090509250929050565b610c97611d0b565b8685141580610ca65750868314155b80610cb15750868114155b15610ccf5760405163b4fa3fb360e01b815260040160405180910390fd5b6000610cda336121e1565b90503460005b89811015610da357610d8f828c8c84818110610cfe57610cfe61449b565b9050602002016020810190610d139190613b52565b8b8b85818110610d2557610d2561449b565b905060200201358a8a86818110610d3e57610d3e61449b565b9050602002016020810190610d5391906146a7565b898987818110610d6557610d6561449b565b9050602002810190610d7791906146c2565b89600060405180602001604052806000815250612267565b610d99908361470b565b9150600101610ce0565b508015610db457610db433826123b7565b5050610dc06001600355565b5050505050505050565b610dd2611d0b565b6000610e24348989898989610de6336121e1565b60018b8b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061226792505050565b905080341115610e4157610e4133610e3c833461470b565b6123b7565b50610e4c6001600355565b50505050505050565b610e5e83611c19565b610e6983838361242b565b505050565b610e76612089565b610e81600182612064565b6106be5760405133906001600160a01b038316907f7e1a1a08d52e4ba0e21554733d66165fd5151f99460116223d9e3a608eec5cb190600090a36106bc60018261249d565b610ece612089565b610ed860006124b2565b565b33610eed6000546001600160a01b031690565b6001600160a01b03161480610f085750610f08600133612064565b610f2d5760405162461bcd60e51b8152600401610f249061471e565b60405180910390fd5b600580546001600160a01b0319166001600160a01b0392909216919091179055565b6001600160a01b03821660009081526006602090815260408083208484529091528120549081900361056357604051630e50afef60e21b815260048101839052602401610f24565b610f9f613993565b610fa98383611ca9565b60408051610160810190915281546001600160a01b03811682529091906020830190600160a01b900460ff166003811115610fe657610fe6613c52565b6003811115610ff757610ff7613c52565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e0820152600282018054610100909201916110879061435c565b80601f01602080910402602001604051908101604052809291908181526020018280546110b39061435c565b80156111005780601f106110d557610100808354040283529160200191611100565b820191906000526020600020905b8154815290600101906020018083116110e357829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b828210156112cf57838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b828210156112b85783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156111c8576111c8613c52565b60048111156111d9576111d9613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561121157611211613c52565b600281111561122257611222613c52565b81528154602090910190600160b01b900460ff16600281111561124757611247613c52565b600281111561125857611258613c52565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505081526020019060010190611180565b50505050815250508152602001906001019061112e565b50505091525090949350505050565b60006112e8611d0b565b6112f3602083614778565b1561131157604051635cb045db60e01b815260040160405180910390fd5b600080806060611323868801886148ed565b9296509094509250905061133e8c8c8c8c8c89898989612502565b5063bc197c8160e01b93505050506113566001600355565b98975050505050505050565b61136b86611c19565b82811461138b5760405163b4fa3fb360e01b815260040160405180910390fd5b60006113978787611ca9565b90506000805b838110156113fd578254600160c81b900461ffff168585838181106113c4576113c461449b565b90506020020160208101906113d991906146a7565b6113e3919061496a565b6113f39063ffffffff1683614992565b915060010161139d565b50815463ffffffff9061141990600160a81b9004821683614992565b11156114385760405163918e94c560e01b815260040160405180910390fd5b60005b858110156114b4576114ac8989858a8a8681811061145b5761145b61449b565b90506020020160208101906114709190613b52565b8989878181106114825761148261449b565b905060200201602081019061149791906146a7565b60405180602001604052806000815250612959565b60010161143b565b5060405163e5c986cd60e01b8152600481018390527370b4070953cdf0cf33d69322495df78a83b734e99063e5c986cd9060240160006040518083038186803b15801561150057600080fd5b505af4158015611514573d6000803e3d6000fd5b505050505050505050505050565b61152a611d0b565b600061155534878787878761153e336121e1565b600160405180602001604052806000815250612267565b90508034111561156d5761156d33610e3c833461470b565b506115786001600355565b5050505050565b6060600061158d8484612199565b6001600160a01b038581166000908152600460209081526040808320858452825280832081516101608101909252805494851682529495509193919290830190600160a01b900460ff1660038111156115e8576115e8613c52565b60038111156115f9576115f9613c52565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e0820152600282018054610100909201916116899061435c565b80601f01602080910402602001604051908101604052809291908181526020018280546116b59061435c565b80156117025780601f106116d757610100808354040283529160200191611702565b820191906000526020600020905b8154815290600101906020018083116116e557829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b828210156118d157838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b828210156118ba5783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156117ca576117ca613c52565b60048111156117db576117db613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561181357611813613c52565b600281111561182457611824613c52565b81528154602090910190600160b01b900460ff16600281111561184957611849613c52565b600281111561185a5761185a613c52565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505081526020019060010190611782565b505050508152505081526020019060010190611730565b5050509152505060408051602081019091526000815290915060028260200151600381111561190257611902613c52565b03611938575060408051808201909152601481527368747470733a2f2f617277656176652e6e65742f60601b6020820152611975565b60038260200151600381111561195057611950613c52565b036119755750604080518082019091526007815266697066733a2f2f60c81b60208201525b61012082015160405161198c9183916020016149a5565b604051602081830303815290604052935050505092915050565b336119b96000546001600160a01b031690565b6001600160a01b031614806119d457506119d4600133612064565b6119f05760405162461bcd60e51b8152600401610f249061471e565b6040516323b872dd60e01b81523060048201526001600160a01b038281166024830152604482018490528416906323b872dd90606401600060405180830381600087803b158015611a4057600080fd5b505af1158015610e4c573d6000803e3d6000fd5b6000611a5e611d0b565b611a69602083614778565b15611a8757604051635cb045db60e01b815260040160405180910390fd5b60008080806060611a9a878901896149d4565b939850919650945092509050611ab68b8b8b8888888888612baf565b5063f23a6e6160e01b945050505050611acf6001600355565b9695505050505050565b611ae1612089565b6001600160a01b038116611b465760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610f24565b6106be816124b2565b33611b626000546001600160a01b031690565b6001600160a01b03161480611b7d5750611b7d600133612064565b611b995760405162461bcd60e51b8152600401610f249061471e565b6106bc82826123b7565b60006001600160e01b031982166313668cf560e31b1480611bd457506001600160e01b03198216630a85bd0160e11b145b80611bef57506001600160e01b03198216630271189760e51b145b80611c0a57506001600160e01b0319821663e9dc637560e01b145b80610563575061056382612f2c565b604051630935e01b60e21b81523360048201526001600160a01b038216906324d7806c90602401602060405180830381865afa158015611c5d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c819190614a47565b6106be57604051630bd4212160e11b81526001600160a01b0382166004820152602401610f24565b6001600160a01b03821660009081526004602090815260408083208484529091528120908154600160a01b900460ff166003811115611cea57611cea613c52565b0361056357604051630e50afef60e21b815260048101839052602401610f24565b600260035403611d5d5760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606401610f24565b6002600355565b611d6f602082614778565b15611d8d57604051635cb045db60e01b815260040160405180910390fd5b600080806060611d9f85870187614a69565b929650909450925090506000611db58585612f61565b6001810154600382018054929350611e0192600160601b9092046001600160a01b03169190600082611de957611de961449b565b9060005260206000209060020201600001548c612fdd565b8054611e359063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b9091041660018061302d565b50600081600301600081548110611e4e57611e4e61449b565b90600052602060002090600202016001018481548110611e7057611e7061449b565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115611eae57611eae613c52565b6004811115611ebf57611ebf613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115611ef757611ef7613c52565b6002811115611f0857611f08613c52565b81528154602090910190600160b01b900460ff166002811115611f2d57611f2d613c52565b6002811115611f3e57611f3e613c52565b81528154600160b81b90046001600160481b0316602082015260018083015460408301526002830154606083015260039092015460809091015290915081604001516002811115611f9157611f91613c52565b14611faf5760405163b4fa3fb360e01b815260040160405180910390fd5b604051630e5597a560e31b81527370b4070953cdf0cf33d69322495df78a83b734e9906372acbd2890611fec90849033908e908990600401614abf565b60006040518083038186803b15801561200457600080fd5b505af4158015612018573d6000803e3d6000fd5b5050505061203a8130338c6001604051806020016040528060008152506130ae565b6120588686848d600160405180602001604052806000815250612959565b50505050505050505050565b6001600160a01b038116600090815260018301602052604081205415155b9392505050565b6000546001600160a01b03163314610ed85760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610f24565b6000612082836001600160a01b0384166134eb565b6000610563825490565b600061208283836135e5565b6001600160a01b03841660009081526004602081815260408084208685529091529182902091516314765c6b60e01b81527370b4070953cdf0cf33d69322495df78a83b734e9926314765c6b9261216d92899289928992899101614e8e565b60006040518083038186803b15801561218557600080fd5b505af4158015610dc0573d6000803e3d6000fd5b6001600160a01b0382166000908152600760209081526040808320848452909152812054908190036105635760405163124bad6360e31b815260048101839052602401610f24565b6005546000906001600160a01b03161580159061056357506005546040516345ecd02f60e01b81526001600160a01b038481166004830152909116906345ecd02f90602401602060405180830381865afa158015612243573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105639190614a47565b6000806122748a8a612f61565b80549091506122aa9063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b909104168b8861302d565b97508763ffffffff166000036122c45760009150506123aa565b6001810154600160601b90046001600160a01b0316808661230b5760018811156122f557660384665653e0006122fe565b6602738d24e520005b6123089083614992565b91505b60018a63ffffffff16111561233f5761232a63ffffffff8b1683614ec4565b915061233c63ffffffff8b1682614ec4565b90505b8c82111561236057604051637e2897ef60e11b815260040160405180910390fd5b801561237b57825461237b906001600160a01b0316826123b7565b612397836123898a8c614edb565b8c63ffffffff16338961360f565b6123a58c8c85338e8a612959565b509150505b9998505050505050505050565b6000826001600160a01b03168260405160006040518083038185875af1925050503d8060008114612404576040519150601f19603f3d011682016040523d82523d6000602084013e612409565b606091505b5050905080610e6957604051637bf340bd60e11b815260040160405180910390fd5b7370b4070953cdf0cf33d69322495df78a83b734e963b40609bf84846124518787611ca9565b856040518563ffffffff1660e01b81526004016124719493929190614ee8565b60006040518083038186803b15801561248957600080fd5b505af4158015610e4c573d6000803e3d6000fd5b6000612082836001600160a01b038416613944565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b600061250e8585612f61565b6001810154909150600160601b90046001600160a01b0316151580612534575081518814155b8061254557506125438a6121e1565b155b156125635760405163b4fa3fb360e01b815260040160405180910390fd5b805460009061259a9063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b9091041687600161302d565b90506000896001600160401b038111156125b6576125b6614346565b6040519080825280602002602001820160405280156125df578160200160208202803683370190505b50905060005b84518110156128925760008582815181106126025761260261449b565b60200260200101519050600085600301826000015165ffffffffffff168154811061262f5761262f61449b565b9060005260206000209060020201600101826020015165ffffffffffff168154811061265d5761265d61449b565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff16600481111561269b5761269b613c52565b60048111156126ac576126ac613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff1660028111156126e4576126e4613c52565b60028111156126f5576126f5613c52565b81528154602090910190600160b01b900460ff16600281111561271a5761271a613c52565b600281111561272b5761272b613c52565b81528154600160b81b90046001600160481b03166020820152600182015460408201526002820154606082015260039091015460809091015290508d8d848181106127785761277861449b565b905060200201358260600151146127be578d8d8481811061279b5761279b61449b565b9050602002013560405163124bad6360e31b8152600401610f2491815260200190565b8b8b848181106127d0576127d061449b565b905060200201358863ffffffff1682608001516127ed9190614f15565b6001600160481b0316146128145760405163918e94c560e01b815260040160405180910390fd5b8763ffffffff168563ffffffff1614612888578463ffffffff16816080015161283d9190614f15565b6001600160481b03168c8c858181106128585761285861449b565b90506020020135612869919061470b565b84848151811061287b5761287b61449b565b6020026020010181815250505b50506001016125e5565b506128b583858463ffffffff16306040518060200160405280600081525061360f565b6128d28787858f8660405180602001604052806000815250612959565b8463ffffffff168263ffffffff161461151457336001600160a01b0316632eb2c2d6308e8e8e866040518663ffffffff1660e01b8152600401612919959493929190614f38565b600060405180830381600087803b15801561293357600080fd5b505af1158015612947573d6000803e3d6000fd5b50505050505050505050505050505050565b60408051600180825281830190925260009160208083019080368337019050509050838160008151811061298f5761298f61449b565b6001600160a01b0392909216602092830291909101909101526040805160018082528183019092526000918160200160208202803683375050506001600160a01b03891660009081526006602090815260408083208b8452909152812054825192935091839190612a0257612a0261449b565b6020908102919091010152604080516001808252818301909252600091816020016020820280368337019050508754909150612a4a908690600160c81b900461ffff1661496a565b63ffffffff1681600081518110612a6357612a6361449b565b60209081029190910101526040516339b2213760e21b81526001600160a01b038a169063e6c884dc90612a9e90869086908690600401614fb4565b600060405180830381600087803b158015612ab857600080fd5b505af1158015612acc573d6000803e3d6000fd5b5050505080600081518110612ae357612ae361449b565b60200260200101518760000160158282829054906101000a900463ffffffff16612b0d9190614fed565b92506101000a81548163ffffffff021916908363ffffffff16021790555081600081518110612b3e57612b3e61449b565b6020026020010151888a6001600160a01b03167fa383afa3c54602b421e1ca976c247507e6cc6460855d62f8f8e632b2a38a33f484600081518110612b8557612b8561449b565b602002602001015188604051612b9c92919061500a565b60405180910390a4505050505050505050565b6000612bbb8686612f61565b6001810154600382018054929350612bef92600160601b9092046001600160a01b03169190600082611de957611de961449b565b8054600090612c269063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b9091041688600161302d565b9050600082600301600081548110612c4057612c4061449b565b90600052602060002090600202016001018581548110612c6257612c6261449b565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115612ca057612ca0613c52565b6004811115612cb157612cb1613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115612ce957612ce9613c52565b6002811115612cfa57612cfa613c52565b81528154602090910190600160b01b900460ff166002811115612d1f57612d1f613c52565b6002811115612d3057612d30613c52565b81528154600160b81b90046001600160481b031660208201526001820154604082015260028201546060820152600390910154608091820152810151909150612d809063ffffffff881690614f15565b6001600160481b03168914612da8576040516302075cc160e41b815260040160405180910390fd5b604051630e5597a560e31b81527370b4070953cdf0cf33d69322495df78a83b734e9906372acbd2890612de590849033908f908a90600401614abf565b60006040518083038186803b158015612dfd57600080fd5b505af4158015612e11573d6000803e3d6000fd5b50505050612e388130338d8663ffffffff16604051806020016040528060008152506130ae565b612e558888858e8660405180602001604052806000815250612959565b8563ffffffff168263ffffffff1614612f1f57336001600160a01b031663f242432a308d8d8560800151878c612e8b9190615029565b63ffffffff16612e9b9190614f15565b6040516001600160e01b031960e087901b1681526001600160a01b03948516600482015293909216602484015260448301526001600160481b0316606482015260a06084820152600060a482015260c401600060405180830381600087803b158015612f0657600080fd5b505af1158015612f1a573d6000803e3d6000fd5b505050505b5050505050505050505050565b60006001600160e01b03198216632a9f3abf60e11b148061056357506301ffc9a760e01b6001600160e01b0319831614610563565b6000612f6d8383611ca9565b60018101549091504265ffffffffffff9091161180612fbc57506001810154600160301b900465ffffffffffff164210801590612fbc57506001810154600160301b900465ffffffffffff1615155b156105635760405163cbd1635360e01b815260048101839052602401610f24565b83151580612fec575082600114155b80612ff8575081600114155b806130095750613007816121e1565b155b156130275760405163b4fa3fb360e01b815260040160405180910390fd5b50505050565b60008563ffffffff1660000361304457508161307f565b6000846130518789615029565b61305b9190615046565b90508363ffffffff168163ffffffff1611156130795783915061307d565b8091505b505b818015613090575063ffffffff8116155b156106215760405163918e94c560e01b815260040160405180910390fd5b6002866040015160028111156130c6576130c6613c52565b036132f45760008287608001516001600160481b03166130e69190614ec4565b905060008760600151600281111561310057613100613c52565b0361317257604051637921219560e11b81526001600160a01b0386169063f242432a9061313b90899061dead90899087908990600401615069565b600060405180830381600087803b15801561315557600080fd5b505af1158015613169573d6000803e3d6000fd5b505050506132ee565b60018760600151600281111561318a5761318a613c52565b0361327c576040805160018082528183019092526000916020808301908036833701905050905084816000815181106131c5576131c561449b565b602090810291909101015260408051600180825281830190925260009181602001602082028036833701905050905082816000815181106132085761320861449b565b6020908102919091010152604051633db0f8ab60e01b81526001600160a01b03881690633db0f8ab90613243908b90869086906004016150a3565b600060405180830381600087803b15801561325d57600080fd5b505af1158015613271573d6000803e3d6000fd5b5050505050506132ee565b60028760600151600281111561329457613294613c52565b036132d557604051637a94c56560e11b81526001600160a01b038781166004830152602482018690526044820183905286169063f5298aca9060640161313b565b60405163cbdea8bd60e01b815260040160405180910390fd5b506134e3565b60018660400151600281111561330c5761330c613c52565b036134ca5781600114613332576040516302075cc160e41b815260040160405180910390fd5b60008660600151600281111561334a5761334a613c52565b036133ba57604051635c46a7ef60e11b81526001600160a01b0385169063b88d4fde9061338390889061dead90889087906004016150d9565b600060405180830381600087803b15801561339d57600080fd5b505af11580156133b1573d6000803e3d6000fd5b505050506134e3565b6001866060015160028111156133d2576133d2613c52565b14806133f357506002866060015160028111156133f1576133f1613c52565b145b156132d5576001600160a01b038516301461349d576040516331a9108f60e11b8152600481018490526001600160a01b038087169190861690636352211e90602401602060405180830381865afa158015613452573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613476919061510c565b6001600160a01b03161461349d57604051637bf340bd60e11b815260040160405180910390fd5b604051630852cd8d60e31b8152600481018490526001600160a01b038516906342966c6890602401613383565b60405163c163a89360e01b815260040160405180910390fd5b505050505050565b600081815260018301602052604081205480156135d457600061350f60018361470b565b85549091506000906135239060019061470b565b90508181146135885760008660000182815481106135435761354361449b565b90600052602060002001549050808760000184815481106135665761356661449b565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061359957613599615129565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610563565b6000915050610563565b5092915050565b60008260000182815481106135fc576135fc61449b565b9060005260206000200154905092915050565b60038501546000906001600160401b0381111561362e5761362e614346565b604051908082528060200260200182016040528015613657578160200160208202803683370190505b50905060005b85518110156138c557600086828151811061367a5761367a61449b565b60200260200101519050600088600301826000015165ffffffffffff16815481106136a7576136a761449b565b9060005260206000209060020201600101826020015165ffffffffffff16815481106136d5576136d561449b565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff16600481111561371357613713613c52565b600481111561372457613724613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561375c5761375c613c52565b600281111561376d5761376d613c52565b81528154602090910190600160b01b900460ff16600281111561379257613792613c52565b60028111156137a3576137a3613c52565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505090507370b4070953cdf0cf33d69322495df78a83b734e96372acbd28828460400151856060015186608001516040518563ffffffff1660e01b815260040161383f9493929190614abf565b60006040518083038186803b15801561385757600080fd5b505af415801561386b573d6000803e3d6000fd5b505050506138858187846040015185606001518b8a6130ae565b8684836000015165ffffffffffff16815181106138a4576138a461449b565b602002602001018181516138b89190614992565b905250505060010161365d565b5060005b8151811015610e4c57848760030182815481106138e8576138e861449b565b9060005260206000209060020201600001546139049190614ec4565b8282815181106139165761391661449b565b60200260200101511461393c576040516302075cc160e41b815260040160405180910390fd5b6001016138c9565b600081815260018301602052604081205461398b57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610563565b506000610563565b6040805161016081019091526000808252602082019081526000602082018190526040820181905260608083018290526080830182905260a0830182905260c0830182905260e083019190915261010082018190526101209091015290565b600060208284031215613a0457600080fd5b81356001600160e01b03198116811461208257600080fd5b6001600160a01b03811681146106be57600080fd5b803560048110613a4057600080fd5b919050565b60008083601f840112613a5757600080fd5b5081356001600160401b03811115613a6e57600080fd5b602083019150836020828501011115613a8657600080fd5b9250929050565b600080600080600060808688031215613aa557600080fd5b8535613ab081613a1c565b945060208601359350613ac560408701613a31565b925060608601356001600160401b03811115613ae057600080fd5b613aec88828901613a45565b969995985093965092949392505050565b600080600080600060808688031215613b1557600080fd5b8535613b2081613a1c565b94506020860135613b3081613a1c565b93506040860135925060608601356001600160401b03811115613ae057600080fd5b600060208284031215613b6457600080fd5b813561208281613a1c565b600081518084526020808501945080840160005b83811015613ba85781516001600160a01b031687529582019590820190600101613b83565b509495945050505050565b6020815260006120826020830184613b6f565b600080600060608486031215613bdb57600080fd5b8335613be681613a1c565b92506020840135915060408401356001600160401b03811115613c0857600080fd5b84016101208187031215613c1b57600080fd5b809150509250925092565b60008060408385031215613c3957600080fd5b8235613c4481613a1c565b946020939093013593505050565b634e487b7160e01b600052602160045260246000fd5b60048110613c7857613c78613c52565b9052565b60005b83811015613c97578181015183820152602001613c7f565b50506000910152565b60008151808452613cb8816020860160208601613c7c565b601f01601f19169290920160200192915050565b60058110613c7857613c78613c52565b600381106106be576106be613c52565b613c7881613cdc565b613d00828251613ccc565b6020818101516001600160a01b0316908301526040810151613d2181613cdc565b60408301526060810151613d3481613cdc565b60608301526080818101516001600160481b03169083015260a0808201519083015260c0808201519083015260e090810151910152565b600082825180855260208086019550808260051b8401018186016000805b85811015613dfe57868403601f19018a528251805185528501516040868601819052815190860181905290860190606086019084905b80821015613de957613dd2838551613cf5565b610100830192508884019350600182019150613dbf565b50509a86019a94505091840191600101613d89565b509198975050505050505050565b80516001600160a01b0316825260006101606020830151613e306020860182613c68565b506040830151613e48604086018263ffffffff169052565b506060830151613e5e606086018261ffff169052565b506080830151613e76608086018263ffffffff169052565b5060a0830151613e8b60a086018260ff169052565b5060c0830151613ea560c086018265ffffffffffff169052565b5060e0830151613ebf60e086018265ffffffffffff169052565b50610100838101516001600160a01b03169085015261012080840151818601839052613eed83870182613ca0565b925050506101408084015185830382870152611acf8382613d6b565b828152604060208201526000613f226040830184613e0c565b949350505050565b60008083601f840112613f3c57600080fd5b5081356001600160401b03811115613f5357600080fd5b6020830191508360208260051b8501011115613a8657600080fd5b6000806000806000806000806080898b031215613f8a57600080fd5b88356001600160401b0380821115613fa157600080fd5b613fad8c838d01613f2a565b909a50985060208b0135915080821115613fc657600080fd5b613fd28c838d01613f2a565b909850965060408b0135915080821115613feb57600080fd5b613ff78c838d01613f2a565b909650945060608b013591508082111561401057600080fd5b5061401d8b828c01613f2a565b999c989b5096995094979396929594505050565b803563ffffffff81168114613a4057600080fd5b600080600080600080600060a0888a03121561406057600080fd5b873561406b81613a1c565b96506020880135955061408060408901614031565b945060608801356001600160401b038082111561409c57600080fd5b6140a88b838c01613f2a565b909650945060808a01359150808211156140c157600080fd5b506140ce8a828b01613a45565b989b979a50959850939692959293505050565b6020815260006120826020830184613e0c565b60008060008060008060008060a0898b03121561411057600080fd5b883561411b81613a1c565b9750602089013561412b81613a1c565b965060408901356001600160401b038082111561414757600080fd5b6141538c838d01613f2a565b909850965060608b013591508082111561416c57600080fd5b6141788c838d01613f2a565b909650945060808b013591508082111561419157600080fd5b5061401d8b828c01613a45565b600080600080600080608087890312156141b757600080fd5b86356141c281613a1c565b95506020870135945060408701356001600160401b03808211156141e557600080fd5b6141f18a838b01613f2a565b9096509450606089013591508082111561420a57600080fd5b5061421789828a01613f2a565b979a9699509497509295939492505050565b60008060008060006080868803121561424157600080fd5b853561424c81613a1c565b94506020860135935061426160408701614031565b925060608601356001600160401b0381111561427c57600080fd5b613aec88828901613f2a565b6020815260006120826020830184613ca0565b6000806000606084860312156142b057600080fd5b83356142bb81613a1c565b9250602084013591506040840135613c1b81613a1c565b60008060008060008060a087890312156142eb57600080fd5b86356142f681613a1c565b9550602087013561430681613a1c565b9450604087013593506060870135925060808701356001600160401b0381111561432f57600080fd5b61421789828a01613a45565b8035613a4081613a1c565b634e487b7160e01b600052604160045260246000fd5b600181811c9082168061437057607f821691505b60208210810361439057634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115610e6957600081815260208120601f850160051c810160208610156143bd5750805b601f850160051c820191505b818110156134e3578281556001016143c9565b6001600160401b038311156143f3576143f3614346565b61440783614401835461435c565b83614396565b6000601f84116001811461443b57600085156144235750838201355b600019600387901b1c1916600186901b178355611578565b600083815260209020601f19861690835b8281101561446c578685013582556020948501946001909201910161444c565b50868210156144895760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b6000600182016144d9576144d96144b1565b5060010190565b600081518084526020808501945080840160005b83811015613ba8578151875295820195908201906001016144f4565b6060815260006145236060830186613b6f565b60208382038185015261453682876144e0565b915083820360408501528185518084528284019150828160051b85010183880160005b8381101561458757601f19878403018552614575838351613ca0565b94860194925090850190600101614559565b50909a9950505050505050505050565b60405160a081016001600160401b03811182821017156145b9576145b9614346565b60405290565b604051601f8201601f191681016001600160401b03811182821017156145e7576145e7614346565b604052919050565b60006001600160401b0382111561460857614608614346565b5060051b60200190565b6000602080838503121561462557600080fd5b82516001600160401b0381111561463b57600080fd5b8301601f8101851361464c57600080fd5b805161465f61465a826145ef565b6145bf565b81815260059190911b8201830190838101908783111561467e57600080fd5b928401925b8284101561469c57835182529284019290840190614683565b979650505050505050565b6000602082840312156146b957600080fd5b61208282614031565b6000808335601e198436030181126146d957600080fd5b8301803591506001600160401b038211156146f357600080fd5b6020019150600581901b3603821315613a8657600080fd5b81810381811115610563576105636144b1565b60208082526024908201527f41646d696e436f6e74726f6c3a204d757374206265206f776e6572206f7220616040820152633236b4b760e11b606082015260800190565b634e487b7160e01b600052601260045260246000fd5b60008261478757614787614762565b500690565b803565ffffffffffff81168114613a4057600080fd5b600082601f8301126147b357600080fd5b813560206147c361465a836145ef565b82815260059290921b840181019181810190868411156147e257600080fd5b8286015b848110156147fd57803583529183019183016147e6565b509695505050505050565b600061481661465a846145ef565b8381529050602080820190600585901b84018681111561483557600080fd5b845b818110156148e25780356001600160401b03808211156148575760008081fd5b9087019060a0828b03121561486c5760008081fd5b614874614597565b61487d8361478c565b815261488a86840161478c565b8682015260408084013561489d81613a1c565b9082015260608381013590820152608080840135838111156148bf5760008081fd5b6148cb8d8287016147a2565b918301919091525086525050928201928201614837565b505050509392505050565b6000806000806080858703121561490357600080fd5b843561490e81613a1c565b93506020850135925061492360408601614031565b915060608501356001600160401b0381111561493e57600080fd5b8501601f8101871361494f57600080fd5b61495e87823560208401614808565b91505092959194509250565b63ffffffff81811683821602808216919082811461498a5761498a6144b1565b505092915050565b80820180821115610563576105636144b1565b600083516149b7818460208801613c7c565b8351908301906149cb818360208801613c7c565b01949350505050565b600080600080600060a086880312156149ec57600080fd5b85356149f781613a1c565b945060208601359350614a0c60408701614031565b92506060860135915060808601356001600160401b03811115614a2e57600080fd5b614a3a888289016147a2565b9150509295509295909350565b600060208284031215614a5957600080fd5b8151801515811461208257600080fd5b60008060008060808587031215614a7f57600080fd5b8435614a8a81613a1c565b9350602085013592506040850135915060608501356001600160401b03811115614ab357600080fd5b61495e878288016147a2565b6000610160808301614ad18489613cf5565b6001600160a01b038716610100850152610120840186905261014084019190915283519081905261018083019060209081860160005b82811015614b2357815185529383019390830190600101614b07565b50929998505050505050505050565b803561ffff81168114613a4057600080fd5b6000808335601e19843603018112614b5b57600080fd5b83016020810192503590506001600160401b03811115614b7a57600080fd5b803603821315613a8657600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b6000808335601e19843603018112614bc957600080fd5b83016020810192503590506001600160401b03811115614be857600080fd5b8060051b3603821315613a8657600080fd5b803560038110613a4057600080fd5b80356001600160481b0381168114613a4057600080fd5b81835260006020808501945084600585811b87018560005b88811015614d8a578483038a528135603e19893603018112614c5957600080fd5b88018035845260408481018883013536849003601e19018112614c7b57600080fd5b9092018881019290356001600160401b03811115614c9857600080fd5b8060081b3603841315614caa57600080fd5b868a018390529081905260609081870160005b82811015614d735785358a8110614cd357600080fd5b614cdd8382613ccc565b508b860135614ceb81613a1c565b6001600160a01b03168c830152614d03868601614bfa565b614d0f86840182613cec565b50614d1b848701614bfa565b614d2785840182613cec565b506080614d35818801614c09565b6001600160481b03169083015260a0868101359083015260c0808701359083015260e080870135908301526101009586019590910190600101614cbd565b509d8a019d96505050928701925050600101614c38565b509098975050505050505050565b6000610120614db784614daa8561433b565b6001600160a01b03169052565b614dc360208401613a31565b614dd06020860182613c68565b50614ddd60408401614b32565b61ffff166040850152614df260608401614031565b63ffffffff166060850152614e096080840161478c565b65ffffffffffff166080850152614e2260a0840161478c565b65ffffffffffff1660a0850152614e3b60c0840161433b565b6001600160a01b031660c0850152614e5660e0840184614b44565b8260e0870152614e698387018284614b89565b92505050610100614e7c81850185614bb2565b8684038388015261469c848284614c20565b60018060a01b038616815260ff8516602082015283604082015282606082015260a06080820152600061469c60a0830184614d98565b8082028115828204841417610563576105636144b1565b6000612082368484614808565b60018060a01b0385168152836020820152826040820152608060608201526000611acf6080830184614d98565b6001600160481b0381811683821602808216919082811461498a5761498a6144b1565b6001600160a01b0386811682528516602082015260a060408201819052810183905260006001600160fb1b03841115614f7057600080fd5b8360051b808660c0850137820182810360c09081016060850152614f96908201856144e0565b83810360809094019390935250506000815260200195945050505050565b606081526000614fc76060830186613b6f565b8281036020840152614fd981866144e0565b90508281036040840152611acf81856144e0565b63ffffffff8181168382160190808211156135de576135de6144b1565b63ffffffff83168152604060208201526000613f226040830184613ca0565b63ffffffff8281168282160390808211156135de576135de6144b1565b600063ffffffff8084168061505d5761505d614762565b92169190910492915050565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061469c90830184613ca0565b6001600160a01b03841681526060602082018190526000906150c7908301856144e0565b8281036040840152611acf81856144e0565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090611acf90830184613ca0565b60006020828403121561511e57600080fd5b815161208281613a1c565b634e487b7160e01b600052603160045260246000fdfea26469706673582212202cdc6a97cc399495e886245a4044d85523da9a6360b7431d768fc434016a4da164736f6c63430008110033000000000000000000000000a8863bf1c8933f649e7b03eb72109e5e187505ea

Deployed Bytecode

0x6080604052600436106101775760003560e01c8063715018a6116100cc578063c2065c101161007a578063c2065c101461045e578063c9dad6961461047e578063e9dc637514610491578063f0e9fcd1146104be578063f23a6e61146104de578063f2fde38b146104fe578063f3fef3a31461051e57600080fd5b8063715018a6146103835780637ab393921461039857806384f05f24146103b85780638da5cb5b146103d857806395bc312b146103f6578063b058d2f814610411578063bc197c811461043e57600080fd5b806341d29f071161012957806341d29f071461028e57806342b54fee146102bc578063480df058146102cf57806350d10839146102f85780635a7373df14610330578063625888da146103435780636d73e6691461036357600080fd5b806301ffc9a71461017c57806304ea1e90146101b1578063150b7a02146101d357806324d7806c1461020c5780632d3456701461022c57806331ae450b1461024c57806338ec89951461026e575b600080fd5b34801561018857600080fd5b5061019c6101973660046139f2565b61053e565b60405190151581526020015b60405180910390f35b3480156101bd57600080fd5b506101d16101cc366004613a8d565b610569565b005b3480156101df57600080fd5b506101f36101ee366004613afd565b6105f8565b6040516001600160e01b031990911681526020016101a8565b34801561021857600080fd5b5061019c610227366004613b52565b61062a565b34801561023857600080fd5b506101d1610247366004613b52565b610663565b34801561025857600080fd5b506102616106c1565b6040516101a89190613bb3565b34801561027a57600080fd5b506101d1610289366004613bc6565b61076f565b34801561029a57600080fd5b506102ae6102a9366004613c26565b610926565b6040516101a8929190613f09565b6101d16102ca366004613f6e565b610c8f565b3480156102db57600080fd5b506102ea6602738d24e5200081565b6040519081526020016101a8565b34801561030457600080fd5b50600554610318906001600160a01b031681565b6040516001600160a01b0390911681526020016101a8565b6101d161033e366004614045565b610dca565b34801561034f57600080fd5b506101d161035e366004613bc6565b610e55565b34801561036f57600080fd5b506101d161037e366004613b52565b610e6e565b34801561038f57600080fd5b506101d1610ec6565b3480156103a457600080fd5b506101d16103b3366004613b52565b610eda565b3480156103c457600080fd5b506102ea6103d3366004613c26565b610f4f565b3480156103e457600080fd5b506000546001600160a01b0316610318565b34801561040257600080fd5b506102ea660384665653e00081565b34801561041d57600080fd5b5061043161042c366004613c26565b610f97565b6040516101a891906140e1565b34801561044a57600080fd5b506101f36104593660046140f4565b6112de565b34801561046a57600080fd5b506101d161047936600461419e565b611362565b6101d161048c366004614229565b611522565b34801561049d57600080fd5b506104b16104ac366004613c26565b61157f565b6040516101a89190614288565b3480156104ca57600080fd5b506101d16104d936600461429b565b6119a6565b3480156104ea57600080fd5b506101f36104f93660046142d2565b611a54565b34801561050a57600080fd5b506101d1610519366004613b52565b611ad9565b34801561052a57600080fd5b506101d1610539366004613c26565b611b4f565b60006001600160e01b0319821663daae40fb60e01b1480610563575061056382611ba3565b92915050565b61057285611c19565b600061057e8686611ca9565b80549091508490829060ff60a01b1916600160a01b8360038111156105a5576105a5613c52565b0217905550600281016105b98385836143dc565b5060405185906001600160a01b038816907fc4487c68aeaaea10bc0e1e6408497e8b1eedeb6aeece8711fdb0da6b6c288dab90600090a3505050505050565b6000610602611d0b565b61060e85858585611d64565b50630a85bd0160e11b6106216001600355565b95945050505050565b6000816001600160a01b03166106486000546001600160a01b031690565b6001600160a01b031614806105635750610563600183612064565b61066b612089565b610676600182612064565b156106be5760405133906001600160a01b038316907f7c0c3c84c67c85fcac635147348bfe374c24a1a93d0366d1cfe9d8853cbf89d590600090a36106bc6001826120e3565b505b50565b60606106cd60016120f8565b6001600160401b038111156106e4576106e4614346565b60405190808252806020026020018201604052801561070d578160200160208202803683370190505b50905060005b61071d60016120f8565b81101561076b5761072f600182612102565b8282815181106107415761074161449b565b6001600160a01b039092166020928302919091019091015280610763816144c7565b915050610713565b5090565b61077883611c19565b610785836000848461210e565b6040805160018082528183019092526000916020808301908036833701905050905033816000815181106107bb576107bb61449b565b6001600160a01b039290921660209283029190910190910152604080516001808252818301909252600091816020015b60608152602001906001900390816107eb57505060408051600180825281830190925291925060009190602080830190803683375050604051634637423960e11b81529192506000916001600160a01b0389169150638c6e84729061085890879086908890600401614510565b6000604051808303816000875af1158015610877573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261089f9190810190614612565b9050806000815181106108b4576108b461449b565b6020908102919091018101516001600160a01b03891660008181526006845260408082208b8352855280822093909355908152600790925281208251889290849082906109035761090361449b565b602002602001015181526020019081526020016000208190555050505050505050565b6000610930613993565b61093a8484612199565b6001600160a01b038581166000908152600460209081526040808320858452825291829020825161016081019093528054938416835293955090929190830190600160a01b900460ff16600381111561099557610995613c52565b60038111156109a6576109a6613c52565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e082015260028201805461010090920191610a369061435c565b80601f0160208091040260200160405190810160405280929190818152602001828054610a629061435c565b8015610aaf5780601f10610a8457610100808354040283529160200191610aaf565b820191906000526020600020905b815481529060010190602001808311610a9257829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b82821015610c7e57838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b82821015610c675783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115610b7757610b77613c52565b6004811115610b8857610b88613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115610bc057610bc0613c52565b6002811115610bd157610bd1613c52565b81528154602090910190600160b01b900460ff166002811115610bf657610bf6613c52565b6002811115610c0757610c07613c52565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505081526020019060010190610b2f565b505050508152505081526020019060010190610add565b505050508152505090509250929050565b610c97611d0b565b8685141580610ca65750868314155b80610cb15750868114155b15610ccf5760405163b4fa3fb360e01b815260040160405180910390fd5b6000610cda336121e1565b90503460005b89811015610da357610d8f828c8c84818110610cfe57610cfe61449b565b9050602002016020810190610d139190613b52565b8b8b85818110610d2557610d2561449b565b905060200201358a8a86818110610d3e57610d3e61449b565b9050602002016020810190610d5391906146a7565b898987818110610d6557610d6561449b565b9050602002810190610d7791906146c2565b89600060405180602001604052806000815250612267565b610d99908361470b565b9150600101610ce0565b508015610db457610db433826123b7565b5050610dc06001600355565b5050505050505050565b610dd2611d0b565b6000610e24348989898989610de6336121e1565b60018b8b8080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061226792505050565b905080341115610e4157610e4133610e3c833461470b565b6123b7565b50610e4c6001600355565b50505050505050565b610e5e83611c19565b610e6983838361242b565b505050565b610e76612089565b610e81600182612064565b6106be5760405133906001600160a01b038316907f7e1a1a08d52e4ba0e21554733d66165fd5151f99460116223d9e3a608eec5cb190600090a36106bc60018261249d565b610ece612089565b610ed860006124b2565b565b33610eed6000546001600160a01b031690565b6001600160a01b03161480610f085750610f08600133612064565b610f2d5760405162461bcd60e51b8152600401610f249061471e565b60405180910390fd5b600580546001600160a01b0319166001600160a01b0392909216919091179055565b6001600160a01b03821660009081526006602090815260408083208484529091528120549081900361056357604051630e50afef60e21b815260048101839052602401610f24565b610f9f613993565b610fa98383611ca9565b60408051610160810190915281546001600160a01b03811682529091906020830190600160a01b900460ff166003811115610fe657610fe6613c52565b6003811115610ff757610ff7613c52565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e0820152600282018054610100909201916110879061435c565b80601f01602080910402602001604051908101604052809291908181526020018280546110b39061435c565b80156111005780601f106110d557610100808354040283529160200191611100565b820191906000526020600020905b8154815290600101906020018083116110e357829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b828210156112cf57838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b828210156112b85783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156111c8576111c8613c52565b60048111156111d9576111d9613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561121157611211613c52565b600281111561122257611222613c52565b81528154602090910190600160b01b900460ff16600281111561124757611247613c52565b600281111561125857611258613c52565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505081526020019060010190611180565b50505050815250508152602001906001019061112e565b50505091525090949350505050565b60006112e8611d0b565b6112f3602083614778565b1561131157604051635cb045db60e01b815260040160405180910390fd5b600080806060611323868801886148ed565b9296509094509250905061133e8c8c8c8c8c89898989612502565b5063bc197c8160e01b93505050506113566001600355565b98975050505050505050565b61136b86611c19565b82811461138b5760405163b4fa3fb360e01b815260040160405180910390fd5b60006113978787611ca9565b90506000805b838110156113fd578254600160c81b900461ffff168585838181106113c4576113c461449b565b90506020020160208101906113d991906146a7565b6113e3919061496a565b6113f39063ffffffff1683614992565b915060010161139d565b50815463ffffffff9061141990600160a81b9004821683614992565b11156114385760405163918e94c560e01b815260040160405180910390fd5b60005b858110156114b4576114ac8989858a8a8681811061145b5761145b61449b565b90506020020160208101906114709190613b52565b8989878181106114825761148261449b565b905060200201602081019061149791906146a7565b60405180602001604052806000815250612959565b60010161143b565b5060405163e5c986cd60e01b8152600481018390527370b4070953cdf0cf33d69322495df78a83b734e99063e5c986cd9060240160006040518083038186803b15801561150057600080fd5b505af4158015611514573d6000803e3d6000fd5b505050505050505050505050565b61152a611d0b565b600061155534878787878761153e336121e1565b600160405180602001604052806000815250612267565b90508034111561156d5761156d33610e3c833461470b565b506115786001600355565b5050505050565b6060600061158d8484612199565b6001600160a01b038581166000908152600460209081526040808320858452825280832081516101608101909252805494851682529495509193919290830190600160a01b900460ff1660038111156115e8576115e8613c52565b60038111156115f9576115f9613c52565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e0820152600282018054610100909201916116899061435c565b80601f01602080910402602001604051908101604052809291908181526020018280546116b59061435c565b80156117025780601f106116d757610100808354040283529160200191611702565b820191906000526020600020905b8154815290600101906020018083116116e557829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b828210156118d157838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b828210156118ba5783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156117ca576117ca613c52565b60048111156117db576117db613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561181357611813613c52565b600281111561182457611824613c52565b81528154602090910190600160b01b900460ff16600281111561184957611849613c52565b600281111561185a5761185a613c52565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505081526020019060010190611782565b505050508152505081526020019060010190611730565b5050509152505060408051602081019091526000815290915060028260200151600381111561190257611902613c52565b03611938575060408051808201909152601481527368747470733a2f2f617277656176652e6e65742f60601b6020820152611975565b60038260200151600381111561195057611950613c52565b036119755750604080518082019091526007815266697066733a2f2f60c81b60208201525b61012082015160405161198c9183916020016149a5565b604051602081830303815290604052935050505092915050565b336119b96000546001600160a01b031690565b6001600160a01b031614806119d457506119d4600133612064565b6119f05760405162461bcd60e51b8152600401610f249061471e565b6040516323b872dd60e01b81523060048201526001600160a01b038281166024830152604482018490528416906323b872dd90606401600060405180830381600087803b158015611a4057600080fd5b505af1158015610e4c573d6000803e3d6000fd5b6000611a5e611d0b565b611a69602083614778565b15611a8757604051635cb045db60e01b815260040160405180910390fd5b60008080806060611a9a878901896149d4565b939850919650945092509050611ab68b8b8b8888888888612baf565b5063f23a6e6160e01b945050505050611acf6001600355565b9695505050505050565b611ae1612089565b6001600160a01b038116611b465760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610f24565b6106be816124b2565b33611b626000546001600160a01b031690565b6001600160a01b03161480611b7d5750611b7d600133612064565b611b995760405162461bcd60e51b8152600401610f249061471e565b6106bc82826123b7565b60006001600160e01b031982166313668cf560e31b1480611bd457506001600160e01b03198216630a85bd0160e11b145b80611bef57506001600160e01b03198216630271189760e51b145b80611c0a57506001600160e01b0319821663e9dc637560e01b145b80610563575061056382612f2c565b604051630935e01b60e21b81523360048201526001600160a01b038216906324d7806c90602401602060405180830381865afa158015611c5d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c819190614a47565b6106be57604051630bd4212160e11b81526001600160a01b0382166004820152602401610f24565b6001600160a01b03821660009081526004602090815260408083208484529091528120908154600160a01b900460ff166003811115611cea57611cea613c52565b0361056357604051630e50afef60e21b815260048101839052602401610f24565b600260035403611d5d5760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606401610f24565b6002600355565b611d6f602082614778565b15611d8d57604051635cb045db60e01b815260040160405180910390fd5b600080806060611d9f85870187614a69565b929650909450925090506000611db58585612f61565b6001810154600382018054929350611e0192600160601b9092046001600160a01b03169190600082611de957611de961449b565b9060005260206000209060020201600001548c612fdd565b8054611e359063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b9091041660018061302d565b50600081600301600081548110611e4e57611e4e61449b565b90600052602060002090600202016001018481548110611e7057611e7061449b565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115611eae57611eae613c52565b6004811115611ebf57611ebf613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115611ef757611ef7613c52565b6002811115611f0857611f08613c52565b81528154602090910190600160b01b900460ff166002811115611f2d57611f2d613c52565b6002811115611f3e57611f3e613c52565b81528154600160b81b90046001600160481b0316602082015260018083015460408301526002830154606083015260039092015460809091015290915081604001516002811115611f9157611f91613c52565b14611faf5760405163b4fa3fb360e01b815260040160405180910390fd5b604051630e5597a560e31b81527370b4070953cdf0cf33d69322495df78a83b734e9906372acbd2890611fec90849033908e908990600401614abf565b60006040518083038186803b15801561200457600080fd5b505af4158015612018573d6000803e3d6000fd5b5050505061203a8130338c6001604051806020016040528060008152506130ae565b6120588686848d600160405180602001604052806000815250612959565b50505050505050505050565b6001600160a01b038116600090815260018301602052604081205415155b9392505050565b6000546001600160a01b03163314610ed85760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610f24565b6000612082836001600160a01b0384166134eb565b6000610563825490565b600061208283836135e5565b6001600160a01b03841660009081526004602081815260408084208685529091529182902091516314765c6b60e01b81527370b4070953cdf0cf33d69322495df78a83b734e9926314765c6b9261216d92899289928992899101614e8e565b60006040518083038186803b15801561218557600080fd5b505af4158015610dc0573d6000803e3d6000fd5b6001600160a01b0382166000908152600760209081526040808320848452909152812054908190036105635760405163124bad6360e31b815260048101839052602401610f24565b6005546000906001600160a01b03161580159061056357506005546040516345ecd02f60e01b81526001600160a01b038481166004830152909116906345ecd02f90602401602060405180830381865afa158015612243573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105639190614a47565b6000806122748a8a612f61565b80549091506122aa9063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b909104168b8861302d565b97508763ffffffff166000036122c45760009150506123aa565b6001810154600160601b90046001600160a01b0316808661230b5760018811156122f557660384665653e0006122fe565b6602738d24e520005b6123089083614992565b91505b60018a63ffffffff16111561233f5761232a63ffffffff8b1683614ec4565b915061233c63ffffffff8b1682614ec4565b90505b8c82111561236057604051637e2897ef60e11b815260040160405180910390fd5b801561237b57825461237b906001600160a01b0316826123b7565b612397836123898a8c614edb565b8c63ffffffff16338961360f565b6123a58c8c85338e8a612959565b509150505b9998505050505050505050565b6000826001600160a01b03168260405160006040518083038185875af1925050503d8060008114612404576040519150601f19603f3d011682016040523d82523d6000602084013e612409565b606091505b5050905080610e6957604051637bf340bd60e11b815260040160405180910390fd5b7370b4070953cdf0cf33d69322495df78a83b734e963b40609bf84846124518787611ca9565b856040518563ffffffff1660e01b81526004016124719493929190614ee8565b60006040518083038186803b15801561248957600080fd5b505af4158015610e4c573d6000803e3d6000fd5b6000612082836001600160a01b038416613944565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b600061250e8585612f61565b6001810154909150600160601b90046001600160a01b0316151580612534575081518814155b8061254557506125438a6121e1565b155b156125635760405163b4fa3fb360e01b815260040160405180910390fd5b805460009061259a9063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b9091041687600161302d565b90506000896001600160401b038111156125b6576125b6614346565b6040519080825280602002602001820160405280156125df578160200160208202803683370190505b50905060005b84518110156128925760008582815181106126025761260261449b565b60200260200101519050600085600301826000015165ffffffffffff168154811061262f5761262f61449b565b9060005260206000209060020201600101826020015165ffffffffffff168154811061265d5761265d61449b565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff16600481111561269b5761269b613c52565b60048111156126ac576126ac613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff1660028111156126e4576126e4613c52565b60028111156126f5576126f5613c52565b81528154602090910190600160b01b900460ff16600281111561271a5761271a613c52565b600281111561272b5761272b613c52565b81528154600160b81b90046001600160481b03166020820152600182015460408201526002820154606082015260039091015460809091015290508d8d848181106127785761277861449b565b905060200201358260600151146127be578d8d8481811061279b5761279b61449b565b9050602002013560405163124bad6360e31b8152600401610f2491815260200190565b8b8b848181106127d0576127d061449b565b905060200201358863ffffffff1682608001516127ed9190614f15565b6001600160481b0316146128145760405163918e94c560e01b815260040160405180910390fd5b8763ffffffff168563ffffffff1614612888578463ffffffff16816080015161283d9190614f15565b6001600160481b03168c8c858181106128585761285861449b565b90506020020135612869919061470b565b84848151811061287b5761287b61449b565b6020026020010181815250505b50506001016125e5565b506128b583858463ffffffff16306040518060200160405280600081525061360f565b6128d28787858f8660405180602001604052806000815250612959565b8463ffffffff168263ffffffff161461151457336001600160a01b0316632eb2c2d6308e8e8e866040518663ffffffff1660e01b8152600401612919959493929190614f38565b600060405180830381600087803b15801561293357600080fd5b505af1158015612947573d6000803e3d6000fd5b50505050505050505050505050505050565b60408051600180825281830190925260009160208083019080368337019050509050838160008151811061298f5761298f61449b565b6001600160a01b0392909216602092830291909101909101526040805160018082528183019092526000918160200160208202803683375050506001600160a01b03891660009081526006602090815260408083208b8452909152812054825192935091839190612a0257612a0261449b565b6020908102919091010152604080516001808252818301909252600091816020016020820280368337019050508754909150612a4a908690600160c81b900461ffff1661496a565b63ffffffff1681600081518110612a6357612a6361449b565b60209081029190910101526040516339b2213760e21b81526001600160a01b038a169063e6c884dc90612a9e90869086908690600401614fb4565b600060405180830381600087803b158015612ab857600080fd5b505af1158015612acc573d6000803e3d6000fd5b5050505080600081518110612ae357612ae361449b565b60200260200101518760000160158282829054906101000a900463ffffffff16612b0d9190614fed565b92506101000a81548163ffffffff021916908363ffffffff16021790555081600081518110612b3e57612b3e61449b565b6020026020010151888a6001600160a01b03167fa383afa3c54602b421e1ca976c247507e6cc6460855d62f8f8e632b2a38a33f484600081518110612b8557612b8561449b565b602002602001015188604051612b9c92919061500a565b60405180910390a4505050505050505050565b6000612bbb8686612f61565b6001810154600382018054929350612bef92600160601b9092046001600160a01b03169190600082611de957611de961449b565b8054600090612c269063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b9091041688600161302d565b9050600082600301600081548110612c4057612c4061449b565b90600052602060002090600202016001018581548110612c6257612c6261449b565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115612ca057612ca0613c52565b6004811115612cb157612cb1613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115612ce957612ce9613c52565b6002811115612cfa57612cfa613c52565b81528154602090910190600160b01b900460ff166002811115612d1f57612d1f613c52565b6002811115612d3057612d30613c52565b81528154600160b81b90046001600160481b031660208201526001820154604082015260028201546060820152600390910154608091820152810151909150612d809063ffffffff881690614f15565b6001600160481b03168914612da8576040516302075cc160e41b815260040160405180910390fd5b604051630e5597a560e31b81527370b4070953cdf0cf33d69322495df78a83b734e9906372acbd2890612de590849033908f908a90600401614abf565b60006040518083038186803b158015612dfd57600080fd5b505af4158015612e11573d6000803e3d6000fd5b50505050612e388130338d8663ffffffff16604051806020016040528060008152506130ae565b612e558888858e8660405180602001604052806000815250612959565b8563ffffffff168263ffffffff1614612f1f57336001600160a01b031663f242432a308d8d8560800151878c612e8b9190615029565b63ffffffff16612e9b9190614f15565b6040516001600160e01b031960e087901b1681526001600160a01b03948516600482015293909216602484015260448301526001600160481b0316606482015260a06084820152600060a482015260c401600060405180830381600087803b158015612f0657600080fd5b505af1158015612f1a573d6000803e3d6000fd5b505050505b5050505050505050505050565b60006001600160e01b03198216632a9f3abf60e11b148061056357506301ffc9a760e01b6001600160e01b0319831614610563565b6000612f6d8383611ca9565b60018101549091504265ffffffffffff9091161180612fbc57506001810154600160301b900465ffffffffffff164210801590612fbc57506001810154600160301b900465ffffffffffff1615155b156105635760405163cbd1635360e01b815260048101839052602401610f24565b83151580612fec575082600114155b80612ff8575081600114155b806130095750613007816121e1565b155b156130275760405163b4fa3fb360e01b815260040160405180910390fd5b50505050565b60008563ffffffff1660000361304457508161307f565b6000846130518789615029565b61305b9190615046565b90508363ffffffff168163ffffffff1611156130795783915061307d565b8091505b505b818015613090575063ffffffff8116155b156106215760405163918e94c560e01b815260040160405180910390fd5b6002866040015160028111156130c6576130c6613c52565b036132f45760008287608001516001600160481b03166130e69190614ec4565b905060008760600151600281111561310057613100613c52565b0361317257604051637921219560e11b81526001600160a01b0386169063f242432a9061313b90899061dead90899087908990600401615069565b600060405180830381600087803b15801561315557600080fd5b505af1158015613169573d6000803e3d6000fd5b505050506132ee565b60018760600151600281111561318a5761318a613c52565b0361327c576040805160018082528183019092526000916020808301908036833701905050905084816000815181106131c5576131c561449b565b602090810291909101015260408051600180825281830190925260009181602001602082028036833701905050905082816000815181106132085761320861449b565b6020908102919091010152604051633db0f8ab60e01b81526001600160a01b03881690633db0f8ab90613243908b90869086906004016150a3565b600060405180830381600087803b15801561325d57600080fd5b505af1158015613271573d6000803e3d6000fd5b5050505050506132ee565b60028760600151600281111561329457613294613c52565b036132d557604051637a94c56560e11b81526001600160a01b038781166004830152602482018690526044820183905286169063f5298aca9060640161313b565b60405163cbdea8bd60e01b815260040160405180910390fd5b506134e3565b60018660400151600281111561330c5761330c613c52565b036134ca5781600114613332576040516302075cc160e41b815260040160405180910390fd5b60008660600151600281111561334a5761334a613c52565b036133ba57604051635c46a7ef60e11b81526001600160a01b0385169063b88d4fde9061338390889061dead90889087906004016150d9565b600060405180830381600087803b15801561339d57600080fd5b505af11580156133b1573d6000803e3d6000fd5b505050506134e3565b6001866060015160028111156133d2576133d2613c52565b14806133f357506002866060015160028111156133f1576133f1613c52565b145b156132d5576001600160a01b038516301461349d576040516331a9108f60e11b8152600481018490526001600160a01b038087169190861690636352211e90602401602060405180830381865afa158015613452573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613476919061510c565b6001600160a01b03161461349d57604051637bf340bd60e11b815260040160405180910390fd5b604051630852cd8d60e31b8152600481018490526001600160a01b038516906342966c6890602401613383565b60405163c163a89360e01b815260040160405180910390fd5b505050505050565b600081815260018301602052604081205480156135d457600061350f60018361470b565b85549091506000906135239060019061470b565b90508181146135885760008660000182815481106135435761354361449b565b90600052602060002001549050808760000184815481106135665761356661449b565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061359957613599615129565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610563565b6000915050610563565b5092915050565b60008260000182815481106135fc576135fc61449b565b9060005260206000200154905092915050565b60038501546000906001600160401b0381111561362e5761362e614346565b604051908082528060200260200182016040528015613657578160200160208202803683370190505b50905060005b85518110156138c557600086828151811061367a5761367a61449b565b60200260200101519050600088600301826000015165ffffffffffff16815481106136a7576136a761449b565b9060005260206000209060020201600101826020015165ffffffffffff16815481106136d5576136d561449b565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff16600481111561371357613713613c52565b600481111561372457613724613c52565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561375c5761375c613c52565b600281111561376d5761376d613c52565b81528154602090910190600160b01b900460ff16600281111561379257613792613c52565b60028111156137a3576137a3613c52565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505090507370b4070953cdf0cf33d69322495df78a83b734e96372acbd28828460400151856060015186608001516040518563ffffffff1660e01b815260040161383f9493929190614abf565b60006040518083038186803b15801561385757600080fd5b505af415801561386b573d6000803e3d6000fd5b505050506138858187846040015185606001518b8a6130ae565b8684836000015165ffffffffffff16815181106138a4576138a461449b565b602002602001018181516138b89190614992565b905250505060010161365d565b5060005b8151811015610e4c57848760030182815481106138e8576138e861449b565b9060005260206000209060020201600001546139049190614ec4565b8282815181106139165761391661449b565b60200260200101511461393c576040516302075cc160e41b815260040160405180910390fd5b6001016138c9565b600081815260018301602052604081205461398b57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610563565b506000610563565b6040805161016081019091526000808252602082019081526000602082018190526040820181905260608083018290526080830182905260a0830182905260c0830182905260e083019190915261010082018190526101209091015290565b600060208284031215613a0457600080fd5b81356001600160e01b03198116811461208257600080fd5b6001600160a01b03811681146106be57600080fd5b803560048110613a4057600080fd5b919050565b60008083601f840112613a5757600080fd5b5081356001600160401b03811115613a6e57600080fd5b602083019150836020828501011115613a8657600080fd5b9250929050565b600080600080600060808688031215613aa557600080fd5b8535613ab081613a1c565b945060208601359350613ac560408701613a31565b925060608601356001600160401b03811115613ae057600080fd5b613aec88828901613a45565b969995985093965092949392505050565b600080600080600060808688031215613b1557600080fd5b8535613b2081613a1c565b94506020860135613b3081613a1c565b93506040860135925060608601356001600160401b03811115613ae057600080fd5b600060208284031215613b6457600080fd5b813561208281613a1c565b600081518084526020808501945080840160005b83811015613ba85781516001600160a01b031687529582019590820190600101613b83565b509495945050505050565b6020815260006120826020830184613b6f565b600080600060608486031215613bdb57600080fd5b8335613be681613a1c565b92506020840135915060408401356001600160401b03811115613c0857600080fd5b84016101208187031215613c1b57600080fd5b809150509250925092565b60008060408385031215613c3957600080fd5b8235613c4481613a1c565b946020939093013593505050565b634e487b7160e01b600052602160045260246000fd5b60048110613c7857613c78613c52565b9052565b60005b83811015613c97578181015183820152602001613c7f565b50506000910152565b60008151808452613cb8816020860160208601613c7c565b601f01601f19169290920160200192915050565b60058110613c7857613c78613c52565b600381106106be576106be613c52565b613c7881613cdc565b613d00828251613ccc565b6020818101516001600160a01b0316908301526040810151613d2181613cdc565b60408301526060810151613d3481613cdc565b60608301526080818101516001600160481b03169083015260a0808201519083015260c0808201519083015260e090810151910152565b600082825180855260208086019550808260051b8401018186016000805b85811015613dfe57868403601f19018a528251805185528501516040868601819052815190860181905290860190606086019084905b80821015613de957613dd2838551613cf5565b610100830192508884019350600182019150613dbf565b50509a86019a94505091840191600101613d89565b509198975050505050505050565b80516001600160a01b0316825260006101606020830151613e306020860182613c68565b506040830151613e48604086018263ffffffff169052565b506060830151613e5e606086018261ffff169052565b506080830151613e76608086018263ffffffff169052565b5060a0830151613e8b60a086018260ff169052565b5060c0830151613ea560c086018265ffffffffffff169052565b5060e0830151613ebf60e086018265ffffffffffff169052565b50610100838101516001600160a01b03169085015261012080840151818601839052613eed83870182613ca0565b925050506101408084015185830382870152611acf8382613d6b565b828152604060208201526000613f226040830184613e0c565b949350505050565b60008083601f840112613f3c57600080fd5b5081356001600160401b03811115613f5357600080fd5b6020830191508360208260051b8501011115613a8657600080fd5b6000806000806000806000806080898b031215613f8a57600080fd5b88356001600160401b0380821115613fa157600080fd5b613fad8c838d01613f2a565b909a50985060208b0135915080821115613fc657600080fd5b613fd28c838d01613f2a565b909850965060408b0135915080821115613feb57600080fd5b613ff78c838d01613f2a565b909650945060608b013591508082111561401057600080fd5b5061401d8b828c01613f2a565b999c989b5096995094979396929594505050565b803563ffffffff81168114613a4057600080fd5b600080600080600080600060a0888a03121561406057600080fd5b873561406b81613a1c565b96506020880135955061408060408901614031565b945060608801356001600160401b038082111561409c57600080fd5b6140a88b838c01613f2a565b909650945060808a01359150808211156140c157600080fd5b506140ce8a828b01613a45565b989b979a50959850939692959293505050565b6020815260006120826020830184613e0c565b60008060008060008060008060a0898b03121561411057600080fd5b883561411b81613a1c565b9750602089013561412b81613a1c565b965060408901356001600160401b038082111561414757600080fd5b6141538c838d01613f2a565b909850965060608b013591508082111561416c57600080fd5b6141788c838d01613f2a565b909650945060808b013591508082111561419157600080fd5b5061401d8b828c01613a45565b600080600080600080608087890312156141b757600080fd5b86356141c281613a1c565b95506020870135945060408701356001600160401b03808211156141e557600080fd5b6141f18a838b01613f2a565b9096509450606089013591508082111561420a57600080fd5b5061421789828a01613f2a565b979a9699509497509295939492505050565b60008060008060006080868803121561424157600080fd5b853561424c81613a1c565b94506020860135935061426160408701614031565b925060608601356001600160401b0381111561427c57600080fd5b613aec88828901613f2a565b6020815260006120826020830184613ca0565b6000806000606084860312156142b057600080fd5b83356142bb81613a1c565b9250602084013591506040840135613c1b81613a1c565b60008060008060008060a087890312156142eb57600080fd5b86356142f681613a1c565b9550602087013561430681613a1c565b9450604087013593506060870135925060808701356001600160401b0381111561432f57600080fd5b61421789828a01613a45565b8035613a4081613a1c565b634e487b7160e01b600052604160045260246000fd5b600181811c9082168061437057607f821691505b60208210810361439057634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115610e6957600081815260208120601f850160051c810160208610156143bd5750805b601f850160051c820191505b818110156134e3578281556001016143c9565b6001600160401b038311156143f3576143f3614346565b61440783614401835461435c565b83614396565b6000601f84116001811461443b57600085156144235750838201355b600019600387901b1c1916600186901b178355611578565b600083815260209020601f19861690835b8281101561446c578685013582556020948501946001909201910161444c565b50868210156144895760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b6000600182016144d9576144d96144b1565b5060010190565b600081518084526020808501945080840160005b83811015613ba8578151875295820195908201906001016144f4565b6060815260006145236060830186613b6f565b60208382038185015261453682876144e0565b915083820360408501528185518084528284019150828160051b85010183880160005b8381101561458757601f19878403018552614575838351613ca0565b94860194925090850190600101614559565b50909a9950505050505050505050565b60405160a081016001600160401b03811182821017156145b9576145b9614346565b60405290565b604051601f8201601f191681016001600160401b03811182821017156145e7576145e7614346565b604052919050565b60006001600160401b0382111561460857614608614346565b5060051b60200190565b6000602080838503121561462557600080fd5b82516001600160401b0381111561463b57600080fd5b8301601f8101851361464c57600080fd5b805161465f61465a826145ef565b6145bf565b81815260059190911b8201830190838101908783111561467e57600080fd5b928401925b8284101561469c57835182529284019290840190614683565b979650505050505050565b6000602082840312156146b957600080fd5b61208282614031565b6000808335601e198436030181126146d957600080fd5b8301803591506001600160401b038211156146f357600080fd5b6020019150600581901b3603821315613a8657600080fd5b81810381811115610563576105636144b1565b60208082526024908201527f41646d696e436f6e74726f6c3a204d757374206265206f776e6572206f7220616040820152633236b4b760e11b606082015260800190565b634e487b7160e01b600052601260045260246000fd5b60008261478757614787614762565b500690565b803565ffffffffffff81168114613a4057600080fd5b600082601f8301126147b357600080fd5b813560206147c361465a836145ef565b82815260059290921b840181019181810190868411156147e257600080fd5b8286015b848110156147fd57803583529183019183016147e6565b509695505050505050565b600061481661465a846145ef565b8381529050602080820190600585901b84018681111561483557600080fd5b845b818110156148e25780356001600160401b03808211156148575760008081fd5b9087019060a0828b03121561486c5760008081fd5b614874614597565b61487d8361478c565b815261488a86840161478c565b8682015260408084013561489d81613a1c565b9082015260608381013590820152608080840135838111156148bf5760008081fd5b6148cb8d8287016147a2565b918301919091525086525050928201928201614837565b505050509392505050565b6000806000806080858703121561490357600080fd5b843561490e81613a1c565b93506020850135925061492360408601614031565b915060608501356001600160401b0381111561493e57600080fd5b8501601f8101871361494f57600080fd5b61495e87823560208401614808565b91505092959194509250565b63ffffffff81811683821602808216919082811461498a5761498a6144b1565b505092915050565b80820180821115610563576105636144b1565b600083516149b7818460208801613c7c565b8351908301906149cb818360208801613c7c565b01949350505050565b600080600080600060a086880312156149ec57600080fd5b85356149f781613a1c565b945060208601359350614a0c60408701614031565b92506060860135915060808601356001600160401b03811115614a2e57600080fd5b614a3a888289016147a2565b9150509295509295909350565b600060208284031215614a5957600080fd5b8151801515811461208257600080fd5b60008060008060808587031215614a7f57600080fd5b8435614a8a81613a1c565b9350602085013592506040850135915060608501356001600160401b03811115614ab357600080fd5b61495e878288016147a2565b6000610160808301614ad18489613cf5565b6001600160a01b038716610100850152610120840186905261014084019190915283519081905261018083019060209081860160005b82811015614b2357815185529383019390830190600101614b07565b50929998505050505050505050565b803561ffff81168114613a4057600080fd5b6000808335601e19843603018112614b5b57600080fd5b83016020810192503590506001600160401b03811115614b7a57600080fd5b803603821315613a8657600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b6000808335601e19843603018112614bc957600080fd5b83016020810192503590506001600160401b03811115614be857600080fd5b8060051b3603821315613a8657600080fd5b803560038110613a4057600080fd5b80356001600160481b0381168114613a4057600080fd5b81835260006020808501945084600585811b87018560005b88811015614d8a578483038a528135603e19893603018112614c5957600080fd5b88018035845260408481018883013536849003601e19018112614c7b57600080fd5b9092018881019290356001600160401b03811115614c9857600080fd5b8060081b3603841315614caa57600080fd5b868a018390529081905260609081870160005b82811015614d735785358a8110614cd357600080fd5b614cdd8382613ccc565b508b860135614ceb81613a1c565b6001600160a01b03168c830152614d03868601614bfa565b614d0f86840182613cec565b50614d1b848701614bfa565b614d2785840182613cec565b506080614d35818801614c09565b6001600160481b03169083015260a0868101359083015260c0808701359083015260e080870135908301526101009586019590910190600101614cbd565b509d8a019d96505050928701925050600101614c38565b509098975050505050505050565b6000610120614db784614daa8561433b565b6001600160a01b03169052565b614dc360208401613a31565b614dd06020860182613c68565b50614ddd60408401614b32565b61ffff166040850152614df260608401614031565b63ffffffff166060850152614e096080840161478c565b65ffffffffffff166080850152614e2260a0840161478c565b65ffffffffffff1660a0850152614e3b60c0840161433b565b6001600160a01b031660c0850152614e5660e0840184614b44565b8260e0870152614e698387018284614b89565b92505050610100614e7c81850185614bb2565b8684038388015261469c848284614c20565b60018060a01b038616815260ff8516602082015283604082015282606082015260a06080820152600061469c60a0830184614d98565b8082028115828204841417610563576105636144b1565b6000612082368484614808565b60018060a01b0385168152836020820152826040820152608060608201526000611acf6080830184614d98565b6001600160481b0381811683821602808216919082811461498a5761498a6144b1565b6001600160a01b0386811682528516602082015260a060408201819052810183905260006001600160fb1b03841115614f7057600080fd5b8360051b808660c0850137820182810360c09081016060850152614f96908201856144e0565b83810360809094019390935250506000815260200195945050505050565b606081526000614fc76060830186613b6f565b8281036020840152614fd981866144e0565b90508281036040840152611acf81856144e0565b63ffffffff8181168382160190808211156135de576135de6144b1565b63ffffffff83168152604060208201526000613f226040830184613ca0565b63ffffffff8281168282160390808211156135de576135de6144b1565b600063ffffffff8084168061505d5761505d614762565b92169190910492915050565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061469c90830184613ca0565b6001600160a01b03841681526060602082018190526000906150c7908301856144e0565b8281036040840152611acf81856144e0565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090611acf90830184613ca0565b60006020828403121561511e57600080fd5b815161208281613a1c565b634e487b7160e01b600052603160045260246000fdfea26469706673582212202cdc6a97cc399495e886245a4044d85523da9a6360b7431d768fc434016a4da164736f6c63430008110033

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

000000000000000000000000a8863bf1c8933f649e7b03eb72109e5e187505ea

-----Decoded View---------------
Arg [0] : initialOwner (address): 0xa8863bf1c8933f649e7b03Eb72109E5E187505Ea

-----Encoded View---------------
1 Constructor Arguments found :
Arg [0] : 000000000000000000000000a8863bf1c8933f649e7b03eb72109e5e187505ea


Block Transaction Difficulty Gas Used Reward
View All Blocks Produced

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

Validator Index Block Amount
View All Withdrawals

Transaction Hash Block Value Eth2 PubKey Valid
View All Deposits
Loading...
Loading
[ Download: CSV Export  ]
[ Download: CSV Export  ]

A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.