ETH Price: $3,150.29 (-4.06%)

Contract

0x53B59fb7906367c8D44b694a2f82feDD4911458C
 

Overview

ETH Balance

0.00207 ETH

Eth Value

$6.52 (@ $3,150.29/ETH)

Token Holdings

Multichain Info

1 address found via
Transaction Hash
Method
Block
From
To
Burn Redeem210872002024-10-31 17:45:1112 days ago1730396711IN
0x53B59fb7...D4911458C
0.0048969 ETH0.0040321419.39761733
Burn Redeem210453732024-10-25 21:38:5918 days ago1729892339IN
0x53B59fb7...D4911458C
0.0048969 ETH0.000910954.26631167
Burn Redeem209581742024-10-13 17:34:4730 days ago1728840887IN
0x53B59fb7...D4911458C
0.0048969 ETH0.0024754911.33867829
Burn Redeem209105502024-10-07 1:59:3537 days ago1728266375IN
0x53B59fb7...D4911458C
0.0048969 ETH0.0024835311.28019276
Burn Redeem208962952024-10-05 2:18:3539 days ago1728094715IN
0x53B59fb7...D4911458C
0.01599 ETH0.00100253.90563779
Initialize Burn ...208939222024-10-04 18:21:4739 days ago1728066107IN
0x53B59fb7...D4911458C
0 ETH0.002774667.97541198
Burn Redeem208926182024-10-04 14:00:2339 days ago1728050423IN
0x53B59fb7...D4911458C
0.0048969 ETH0.0026045512.94361827
Burn Redeem208885522024-10-04 0:25:3540 days ago1728001535IN
0x53B59fb7...D4911458C
0.0048969 ETH0.000964774.79455418
Burn Redeem208882672024-10-03 23:28:2340 days ago1727998103IN
0x53B59fb7...D4911458C
0.0103938 ETH0.001181963.62327138
Burn Redeem208875772024-10-03 21:10:1140 days ago1727989811IN
0x53B59fb7...D4911458C
0.0048969 ETH0.001284595.88393221
Burn Redeem208866042024-10-03 17:54:2340 days ago1727978063IN
0x53B59fb7...D4911458C
0.0048969 ETH0.001838268.44525973
Initialize Burn ...208865782024-10-03 17:49:1140 days ago1727977751IN
0x53B59fb7...D4911458C
0 ETH0.00250988.77126225
Update Burn Rede...208860492024-10-03 16:02:3540 days ago1727971355IN
0x53B59fb7...D4911458C
0 ETH0.0011816413.75280576
Initialize Burn ...208858242024-10-03 15:16:4740 days ago1727968607IN
0x53B59fb7...D4911458C
0 ETH0.002357129.58373739
Burn Redeem208692632024-10-01 7:50:4743 days ago1727769047IN
0x53B59fb7...D4911458C
0.00069 ETH0.0022414714.11304162
Burn Redeem208069772024-09-22 15:20:4751 days ago1727018447IN
0x53B59fb7...D4911458C
0.00138 ETH0.0025788111.91170892
Initialize Burn ...208069662024-09-22 15:18:3551 days ago1727018315IN
0x53B59fb7...D4911458C
0 ETH0.0094598813.86857787
Update Burn Rede...208035642024-09-22 3:55:4752 days ago1726977347IN
0x53B59fb7...D4911458C
0 ETH0.000565766.48385736
Update Burn Rede...208035562024-09-22 3:54:1152 days ago1726977251IN
0x53B59fb7...D4911458C
0 ETH0.000537385.96713753
Burn Redeem207247292024-09-11 3:37:1163 days ago1726025831IN
0x53B59fb7...D4911458C
0.00069 ETH0.000435042.73918687
Burn Redeem206605452024-09-02 4:38:2372 days ago1725251903IN
0x53B59fb7...D4911458C
0.42099 ETH0.000333611.05761944
Burn Redeem206605132024-09-02 4:31:5972 days ago1725251519IN
0x53B59fb7...D4911458C
0.42099 ETH0.000317461.02108336
Burn Redeem206595232024-09-02 1:13:2372 days ago1725239603IN
0x53B59fb7...D4911458C
0.42099 ETH0.000310420.99844566
Burn Redeem206592472024-09-02 0:17:5972 days ago1725236279IN
0x53B59fb7...D4911458C
0.42099 ETH0.000337011.0839526
Burn Redeem206592402024-09-02 0:16:3572 days ago1725236195IN
0x53B59fb7...D4911458C
0.42099 ETH0.000333521.07272774
View all transactions

Latest 25 internal transactions (View All)

Advanced mode:
Parent Transaction Hash Block From To
210872002024-10-31 17:45:1112 days ago1730396711
0x53B59fb7...D4911458C
0.0042069 ETH
210453732024-10-25 21:38:5918 days ago1729892339
0x53B59fb7...D4911458C
0.0042069 ETH
209581742024-10-13 17:34:4730 days ago1728840887
0x53B59fb7...D4911458C
0.0042069 ETH
209244042024-10-09 0:20:2335 days ago1728433223
0x53B59fb7...D4911458C
0.24726 ETH
209105502024-10-07 1:59:3537 days ago1728266375
0x53B59fb7...D4911458C
0.0042069 ETH
208962952024-10-05 2:18:3539 days ago1728094715
0x53B59fb7...D4911458C
0.015 ETH
208926182024-10-04 14:00:2339 days ago1728050423
0x53B59fb7...D4911458C
0.0042069 ETH
208885522024-10-04 0:25:3540 days ago1728001535
0x53B59fb7...D4911458C
0.0042069 ETH
208882672024-10-03 23:28:2340 days ago1727998103
0x53B59fb7...D4911458C
0.0006 ETH
208882672024-10-03 23:28:2340 days ago1727998103
0x53B59fb7...D4911458C
0.0042069 ETH
208882672024-10-03 23:28:2340 days ago1727998103
0x53B59fb7...D4911458C
0.0042069 ETH
208875772024-10-03 21:10:1140 days ago1727989811
0x53B59fb7...D4911458C
0.0042069 ETH
208866042024-10-03 17:54:2340 days ago1727978063
0x53B59fb7...D4911458C
0.0042069 ETH
208069772024-09-22 15:20:4751 days ago1727018447
0x53B59fb7...D4911458C
0.00069 ETH
206605452024-09-02 4:38:2372 days ago1725251903
0x53B59fb7...D4911458C
0.42 ETH
206605132024-09-02 4:31:5972 days ago1725251519
0x53B59fb7...D4911458C
0.42 ETH
206595232024-09-02 1:13:2372 days ago1725239603
0x53B59fb7...D4911458C
0.42 ETH
206592472024-09-02 0:17:5972 days ago1725236279
0x53B59fb7...D4911458C
0.42 ETH
206592402024-09-02 0:16:3572 days ago1725236195
0x53B59fb7...D4911458C
0.42 ETH
206574722024-09-01 18:20:1172 days ago1725214811
0x53B59fb7...D4911458C
0.42 ETH
206351022024-08-29 15:21:5975 days ago1724944919
0x53B59fb7...D4911458C
0.42 ETH
204043462024-07-28 10:07:35108 days ago1722161255
0x53B59fb7...D4911458C
0.0006 ETH
202664332024-07-09 4:04:11127 days ago1720497851
0x53B59fb7...D4911458C
0.0006 ETH
200367772024-06-07 1:50:59159 days ago1717725059
0x53B59fb7...D4911458C
0.0006 ETH
200352682024-06-06 20:47:47159 days ago1717706867
0x53B59fb7...D4911458C
0.0009 ETH
View All Internal Transactions
Loading...
Loading

Contract Source Code Verified (Exact Match)

Contract Name:
ERC721BurnRedeem

Compiler Version
v0.8.17+commit.8df45f5f

Optimization Enabled:
Yes with 150 runs

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

pragma solidity ^0.8.0;

/// @author: manifold.xyz

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

import "./BurnRedeemCore.sol";
import "./BurnRedeemLib.sol";
import "./IERC721BurnRedeem.sol";
import "../libraries/IERC721CreatorCoreVersion.sol";

contract ERC721BurnRedeem is BurnRedeemCore, IERC721BurnRedeem {
    using Strings for uint256;

    // NOTE: Only used for creatorContract versions < 3
    // { contractAddress => { tokenId => { RedeemToken } }
    mapping(address => mapping(uint256 => RedeemToken)) internal _redeemTokens;

    // { creatorContractAddress => { instanceId =>  bool } }
    mapping(address => mapping(uint256 => bool)) private _identicalTokenURI;

    constructor(address initialOwner) BurnRedeemCore(initialOwner) {}

    function supportsInterface(bytes4 interfaceId) public view virtual override(BurnRedeemCore, IERC165) returns (bool) {
        return interfaceId == type(IERC721BurnRedeem).interfaceId || super.supportsInterface(interfaceId);
    }
    
    /**
     * @dev See {IERC721BurnRedeem-initializeBurnRedeem}.
     */
    function initializeBurnRedeem(
        address creatorContractAddress,
        uint256 instanceId,
        BurnRedeemParameters calldata burnRedeemParameters,
        bool identicalTokenURI
    ) external  {
        _validateAdmin(creatorContractAddress);
        // Max uint56 for instanceId
        if (instanceId == 0 || instanceId > MAX_UINT_56) {
            revert InvalidInput();
        }

        uint8 creatorContractVersion;
        try IERC721CreatorCoreVersion(creatorContractAddress).VERSION() returns(uint256 version) {
            if (version > 255) {
                revert UnsupportedContractVersion();
            }
            creatorContractVersion = uint8(version);
        } catch {}
        _initialize(creatorContractAddress, creatorContractVersion, instanceId, burnRedeemParameters);
        _identicalTokenURI[creatorContractAddress][instanceId] = identicalTokenURI;
    }

    /**
     * @dev See {IERC721BurnRedeem-updateBurnRedeem}.
     */
    function updateBurnRedeem(
        address creatorContractAddress,
        uint256 instanceId,
        BurnRedeemParameters calldata burnRedeemParameters,
        bool identicalTokenURI
    ) external {
        _validateAdmin(creatorContractAddress);
        _update(creatorContractAddress, instanceId, burnRedeemParameters);
        _identicalTokenURI[creatorContractAddress][instanceId] = identicalTokenURI;
    }

    /**
     * See {IERC721BurnRedeem-updateTokenURI}.
     */
    function updateTokenURI(
        address creatorContractAddress,
        uint256 instanceId,
        StorageProtocol storageProtocol,
        string calldata location,
        bool identicalTokenURI
    ) external override  {
        _validateAdmin(creatorContractAddress);
        BurnRedeem storage burnRedeemInstance = _getBurnRedeem(creatorContractAddress, instanceId);
        burnRedeemInstance.storageProtocol = storageProtocol;
        burnRedeemInstance.location = location;
        _identicalTokenURI[creatorContractAddress][instanceId] = identicalTokenURI;
        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 {
        if (burnRedeemInstance.redeemAmount == 1 && count == 1) {
            ++burnRedeemInstance.redeemedCount;
            uint256 newTokenId;
            if (burnRedeemInstance.contractVersion >= 3) {
                uint80 tokenData = uint56(instanceId) << 24 | burnRedeemInstance.redeemedCount;
                newTokenId = IERC721CreatorCore(creatorContractAddress).mintExtension(to, tokenData);
            } else {
                newTokenId = IERC721CreatorCore(creatorContractAddress).mintExtension(to);
                _redeemTokens[creatorContractAddress][newTokenId] = RedeemToken(uint224(instanceId), burnRedeemInstance.redeemedCount);
            }
            emit BurnRedeemLib.BurnRedeemMint(creatorContractAddress, instanceId, newTokenId, 1, data);
        } else {
            uint256 totalCount = burnRedeemInstance.redeemAmount * count;
            if (totalCount > MAX_UINT_16) {
                revert InvalidInput();
            }
            uint256 startingCount = burnRedeemInstance.redeemedCount + 1;
            burnRedeemInstance.redeemedCount += uint32(totalCount);
            if (burnRedeemInstance.contractVersion >= 3) {
                uint80[] memory tokenDatas = new uint80[](totalCount);
                for (uint256 i; i < totalCount;) {
                    tokenDatas[i] = uint56(instanceId) << 24 | uint24(startingCount+i);
                    unchecked { ++i; }
                }
                uint256[] memory newTokenIds = IERC721CreatorCore(creatorContractAddress).mintExtensionBatch(to, tokenDatas);
                for (uint256 i; i < totalCount;) {
                    emit BurnRedeemLib.BurnRedeemMint(creatorContractAddress, instanceId, newTokenIds[i], 1, data);
                    unchecked { i++; }
                }
            } else {
                uint256[] memory newTokenIds = IERC721CreatorCore(creatorContractAddress).mintExtensionBatch(to, uint16(totalCount));
                for (uint256 i; i < totalCount;) {
                    _redeemTokens[creatorContractAddress][newTokenIds[i]] = RedeemToken(uint224(instanceId), uint32(startingCount + i));
                    emit BurnRedeemLib.BurnRedeemMint(creatorContractAddress, instanceId, newTokenIds[i], 1, data);
                    unchecked { i++; }
                }
            }
        }
    }

    /**
     * See {ICreatorExtensionTokenURI-tokenURI}.
     */
    function tokenURI(address creatorContractAddress, uint256 tokenId) external override view returns(string memory uri) {
        (uint256 instanceId, uint256 mintNumber) = _getInstanceIdAndMintNumber(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));

        if (!_identicalTokenURI[creatorContractAddress][instanceId]) {
            uri = string(abi.encodePacked(uri, "/", uint256(mintNumber).toString()));
        }
    }

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

    function _getInstanceIdAndMintNumber(address creatorContractAddress, uint256 tokenId) internal view returns(uint256 instanceId, uint256 mintNumber) {
        RedeemToken memory token = _redeemTokens[creatorContractAddress][tokenId];
        if (token.instanceId == 0) {
            // No claim, try to retrieve from tokenData
            uint80 tokenData = IERC721CreatorCore(creatorContractAddress).tokenData(tokenId);
            instanceId = uint56(tokenData >> 24);
            if (instanceId == 0) {
                revert InvalidToken(tokenId);
            }
            mintNumber = uint24(tokenData & MAX_UINT_24);
        } else {
            instanceId = token.instanceId;
            mintNumber = token.mintNumber;
        }
    }
}

File 2 of 26 : IERC721CreatorCore.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "./ICreatorCore.sol";

/**
 * @dev Core ERC721 creator interface
 */
interface IERC721CreatorCore is ICreatorCore {

    /**
     * @dev mint a token with no extension. Can only be called by an admin.
     * Returns tokenId minted
     */
    function mintBase(address to) external returns (uint256);

    /**
     * @dev mint a token with no extension. Can only be called by an admin.
     * Returns tokenId minted
     */
    function mintBase(address to, string calldata uri) external returns (uint256);

    /**
     * @dev batch mint a token with no extension. Can only be called by an admin.
     * Returns tokenId minted
     */
    function mintBaseBatch(address to, uint16 count) external returns (uint256[] memory);

    /**
     * @dev batch mint a token with no extension. Can only be called by an admin.
     * Returns tokenId minted
     */
    function mintBaseBatch(address to, string[] calldata uris) external returns (uint256[] memory);

    /**
     * @dev mint a token. Can only be called by a registered extension.
     * Returns tokenId minted
     */
    function mintExtension(address to) external returns (uint256);

    /**
     * @dev mint a token. Can only be called by a registered extension.
     * Returns tokenId minted
     */
    function mintExtension(address to, string calldata uri) external returns (uint256);

    /**
     * @dev mint a token. Can only be called by a registered extension.
     * Returns tokenId minted
     */
    function mintExtension(address to, uint80 data) external returns (uint256);

    /**
     * @dev batch mint a token. Can only be called by a registered extension.
     * Returns tokenIds minted
     */
    function mintExtensionBatch(address to, uint16 count) external returns (uint256[] memory);

    /**
     * @dev batch mint a token. Can only be called by a registered extension.
     * Returns tokenId minted
     */
    function mintExtensionBatch(address to, string[] calldata uris) external returns (uint256[] memory);

    /**
     * @dev batch mint a token. Can only be called by a registered extension.
     * Returns tokenId minted
     */
    function mintExtensionBatch(address to, uint80[] calldata data) external returns (uint256[] memory);

    /**
     * @dev burn a token. Can only be called by token owner or approved address.
     * On burn, calls back to the registered extension's onBurn method
     */
    function burn(uint256 tokenId) external;

    /**
     * @dev get token data
     */
    function tokenData(uint256 tokenId) external view returns (uint80);

}

File 3 of 26 : 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 26 : 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 26 : IERC721BurnRedeem.sol
// SPDX-License-Identifier: MIT

pragma solidity ^0.8.0;

/// @author: manifold.xyz

import "./IBurnRedeemCore.sol";

interface IERC721BurnRedeem is IBurnRedeemCore {
    struct RedeemToken {
        uint224 instanceId;
        uint32 mintNumber;
    }

    /**
     * @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
     * @param identicalTokenURI         whether or not the tokenURI is identical
     */
    function initializeBurnRedeem(address creatorContractAddress, uint256 instanceId, BurnRedeemParameters calldata burnRedeemParameters, bool identicalTokenURI) 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
     * @param identicalTokenURI         whether or not the tokenURI is identical
     */
    function updateBurnRedeem(address creatorContractAddress, uint256 instanceId, BurnRedeemParameters calldata burnRedeemParameters, bool identicalTokenURI) 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
     * @param identicalTokenURI         whether or not the URI's are supposed to be identical
     */
    function updateTokenURI(address creatorContractAddress, uint256 instanceId, StorageProtocol storageProtocol, string calldata location, bool identicalTokenURI) external;
}

File 6 of 26 : IERC721CreatorCoreVersion.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

interface IERC721CreatorCoreVersion {
    function VERSION() external view returns(uint256);
}

File 7 of 26 : 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 8 of 26 : 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 9 of 26 : 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 10 of 26 : 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 11 of 26 : 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 12 of 26 : 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 13 of 26 : 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 14 of 26 : 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 15 of 26 : 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 16 of 26 : 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 17 of 26 : 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 18 of 26 : 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 19 of 26 : 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 20 of 26 : 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 21 of 26 : 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 22 of 26 : 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 23 of 26 : 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 24 of 26 : 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 25 of 26 : 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 26 of 26 : 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"},{"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"},{"internalType":"bool","name":"identicalTokenURI","type":"bool"}],"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"},{"internalType":"bool","name":"identicalTokenURI","type":"bool"}],"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"},{"internalType":"bool","name":"identicalTokenURI","type":"bool"}],"name":"updateTokenURI","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"}]

60806040523480156200001157600080fd5b50604051620058b3380380620058b38339810160408190526200003491620000a8565b80620000403362000058565b6001600355620000508162000058565b5050620000da565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b600060208284031215620000bb57600080fd5b81516001600160a01b0381168114620000d357600080fd5b9392505050565b6157c980620000ea6000396000f3fe60806040526004361061016c5760003560e01c8063715018a6116100cc578063c9dad6961161007a578063c9dad69614610433578063cc7ac3f714610446578063e9dc637514610466578063f0e9fcd114610493578063f23a6e61146104b3578063f2fde38b146104d3578063f3fef3a3146104f357600080fd5b8063715018a6146103585780637ab393921461036d5780638da5cb5b1461038d57806395bc312b146103ab578063b058d2f8146103c6578063bc197c81146103f3578063c2065c101461041357600080fd5b80633f25c996116101295780633f25c9961461026357806341d29f071461028357806342b54fee146102b1578063480df058146102c457806350d10839146102ed5780635a7373df146103255780636d73e6691461033857600080fd5b806301ffc9a714610171578063150b7a02146101a657806324d7806c146101df57806327a99a14146101ff5780632d3456701461022157806331ae450b14610241575b600080fd5b34801561017d57600080fd5b5061019161018c366004613fab565b610513565b60405190151581526020015b60405180910390f35b3480156101b257600080fd5b506101c66101c1366004614032565b61053e565b6040516001600160e01b0319909116815260200161019d565b3480156101eb57600080fd5b506101916101fa3660046140a4565b610570565b34801561020b57600080fd5b5061021f61021a3660046140cf565b6105a9565b005b34801561022d57600080fd5b5061021f61023c3660046140a4565b6105f7565b34801561024d57600080fd5b50610256610655565b60405161019d9190614140565b34801561026f57600080fd5b5061021f61027e3660046141a1565b610703565b34801561028f57600080fd5b506102a361029e366004614223565b6107b4565b60405161019d929190614503565b61021f6102bf366004614568565b610b1e565b3480156102d057600080fd5b506102df6602738d24e5200081565b60405190815260200161019d565b3480156102f957600080fd5b5060055461030d906001600160a01b031681565b6040516001600160a01b03909116815260200161019d565b61021f61033336600461463f565b610c59565b34801561034457600080fd5b5061021f6103533660046140a4565b610ce4565b34801561036457600080fd5b5061021f610d3c565b34801561037957600080fd5b5061021f6103883660046140a4565b610d50565b34801561039957600080fd5b506000546001600160a01b031661030d565b3480156103b757600080fd5b506102df660384665653e00081565b3480156103d257600080fd5b506103e66103e1366004614223565b610dc5565b60405161019d91906146db565b3480156103ff57600080fd5b506101c661040e3660046146ee565b61110c565b34801561041f57600080fd5b5061021f61042e366004614798565b611190565b61021f610441366004614823565b611350565b34801561045257600080fd5b5061021f6104613660046140cf565b6113ad565b34801561047257600080fd5b50610486610481366004614223565b6114b4565b60405161019d9190614882565b34801561049f57600080fd5b5061021f6104ae366004614895565b611935565b3480156104bf57600080fd5b506101c66104ce3660046148d7565b6119e3565b3480156104df57600080fd5b5061021f6104ee3660046140a4565b611a68565b3480156104ff57600080fd5b5061021f61050e366004614223565b611ade565b60006001600160e01b0319821663d4f6907560e01b1480610538575061053882611b32565b92915050565b6000610548611ba8565b61055485858585611c01565b50630a85bd0160e11b6105676001600355565b95945050505050565b6000816001600160a01b031661058e6000546001600160a01b031690565b6001600160a01b031614806105385750610538600183611f01565b6105b284611f26565b6105bd848484611fb6565b6001600160a01b0393909316600090815260076020908152604080832094835293905291909120805460ff19169215159290921790915550565b6105ff612028565b61060a600182611f01565b156106525760405133906001600160a01b038316907f7c0c3c84c67c85fcac635147348bfe374c24a1a93d0366d1cfe9d8853cbf89d590600090a3610650600182612082565b505b50565b60606106616001612097565b6001600160401b038111156106785761067861494b565b6040519080825280602002602001820160405280156106a1578160200160208202803683370190505b50905060005b6106b16001612097565b8110156106ff576106c36001826120a1565b8282815181106106d5576106d5614961565b6001600160a01b0390921660209283029190910190910152806106f78161498d565b9150506106a7565b5090565b61070c86611f26565b600061071887876120ad565b80549091508590829060ff60a01b1916600160a01b83600381111561073f5761073f61424f565b021790555060028101610753848683614a26565b506001600160a01b03871660008181526007602090815260408083208a8452909152808220805460ff1916861515179055518892917fc4487c68aeaaea10bc0e1e6408497e8b1eedeb6aeece8711fdb0da6b6c288dab91a350505050505050565b60006107be613f4c565b6107c8848461210f565b506001600160a01b038581166000908152600460209081526040808320858452825291829020825161016081019093528054938416835293955090929190830190600160a01b900460ff1660038111156108245761082461424f565b60038111156108355761083561424f565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e0820152600282018054610100909201916108c5906149a6565b80601f01602080910402602001604051908101604052809291908181526020018280546108f1906149a6565b801561093e5780601f106109135761010080835404028352916020019161093e565b820191906000526020600020905b81548152906001019060200180831161092157829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b82821015610b0d57838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b82821015610af65783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115610a0657610a0661424f565b6004811115610a1757610a1761424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115610a4f57610a4f61424f565b6002811115610a6057610a6061424f565b81528154602090910190600160b01b900460ff166002811115610a8557610a8561424f565b6002811115610a9657610a9661424f565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b031681526020016001820154815260200160028201548152602001600382015481525050815260200190600101906109be565b50505050815250508152602001906001019061096c565b505050508152505090509250929050565b610b26611ba8565b8685141580610b355750868314155b80610b405750868114155b15610b5e5760405163b4fa3fb360e01b815260040160405180910390fd5b6000610b693361223a565b90503460005b89811015610c3257610c1e828c8c84818110610b8d57610b8d614961565b9050602002016020810190610ba291906140a4565b8b8b85818110610bb457610bb4614961565b905060200201358a8a86818110610bcd57610bcd614961565b9050602002016020810190610be29190614ae5565b898987818110610bf457610bf4614961565b9050602002810190610c069190614b00565b896000604051806020016040528060008152506122c0565b610c289083614b49565b9150600101610b6f565b508015610c4357610c433382612410565b5050610c4f6001600355565b5050505050505050565b610c61611ba8565b6000610cb3348989898989610c753361223a565b60018b8b8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152506122c092505050565b905080341115610cd057610cd033610ccb8334614b49565b612410565b50610cdb6001600355565b50505050505050565b610cec612028565b610cf7600182611f01565b6106525760405133906001600160a01b038316907f7e1a1a08d52e4ba0e21554733d66165fd5151f99460116223d9e3a608eec5cb190600090a3610650600182612489565b610d44612028565b610d4e600061249e565b565b33610d636000546001600160a01b031690565b6001600160a01b03161480610d7e5750610d7e600133611f01565b610da35760405162461bcd60e51b8152600401610d9a90614b5c565b60405180910390fd5b600580546001600160a01b0319166001600160a01b0392909216919091179055565b610dcd613f4c565b610dd783836120ad565b60408051610160810190915281546001600160a01b03811682529091906020830190600160a01b900460ff166003811115610e1457610e1461424f565b6003811115610e2557610e2561424f565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e082015260028201805461010090920191610eb5906149a6565b80601f0160208091040260200160405190810160405280929190818152602001828054610ee1906149a6565b8015610f2e5780601f10610f0357610100808354040283529160200191610f2e565b820191906000526020600020905b815481529060010190602001808311610f1157829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b828210156110fd57838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b828210156110e65783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115610ff657610ff661424f565b60048111156110075761100761424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561103f5761103f61424f565b60028111156110505761105061424f565b81528154602090910190600160b01b900460ff1660028111156110755761107561424f565b60028111156110865761108661424f565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505081526020019060010190610fae565b505050508152505081526020019060010190610f5c565b50505091525090949350505050565b6000611116611ba8565b611121602083614bb6565b1561113f57604051635cb045db60e01b815260040160405180910390fd5b60008080606061115186880188614dab565b9296509094509250905061116c8c8c8c8c8c898989896124ee565b5063bc197c8160e01b93505050506111846001600355565b98975050505050505050565b61119986611f26565b8281146111b95760405163b4fa3fb360e01b815260040160405180910390fd5b60006111c587876120ad565b90506000805b8381101561122b578254600160c81b900461ffff168585838181106111f2576111f2614961565b90506020020160208101906112079190614ae5565b6112119190614e28565b6112219063ffffffff1683614e50565b91506001016111cb565b50815463ffffffff9061124790600160a81b9004821683614e50565b11156112665760405163918e94c560e01b815260040160405180910390fd5b60005b858110156112e2576112da8989858a8a8681811061128957611289614961565b905060200201602081019061129e91906140a4565b8989878181106112b0576112b0614961565b90506020020160208101906112c59190614ae5565b60405180602001604052806000815250612945565b600101611269565b5060405163e5c986cd60e01b8152600481018390527370b4070953cdf0cf33d69322495df78a83b734e99063e5c986cd9060240160006040518083038186803b15801561132e57600080fd5b505af4158015611342573d6000803e3d6000fd5b505050505050505050505050565b611358611ba8565b600061138334878787878761136c3361223a565b6001604051806020016040528060008152506122c0565b90508034111561139b5761139b33610ccb8334614b49565b506113a66001600355565b5050505050565b6113b684611f26565b8215806113c9575066ffffffffffffff83115b156113e75760405163b4fa3fb360e01b815260040160405180910390fd5b6000846001600160a01b031663ffa1ad746040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015611443575060408051601f3d908101601f1916820190925261144091810190614e63565b60015b1561146d5760ff81111561146a57604051634d73d22360e11b815260040160405180910390fd5b90505b61147985828686612f7b565b506001600160a01b0393909316600090815260076020908152604080832094835293905291909120805460ff19169215159290921790915550565b60606000806114c3858561210f565b6001600160a01b0387811660009081526004602090815260408083208684528252808320815161016081019092528054948516825295975093955090939190830190600160a01b900460ff1660038111156115205761152061424f565b60038111156115315761153161424f565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e0820152600282018054610100909201916115c1906149a6565b80601f01602080910402602001604051908101604052809291908181526020018280546115ed906149a6565b801561163a5780601f1061160f5761010080835404028352916020019161163a565b820191906000526020600020905b81548152906001019060200180831161161d57829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b8282101561180957838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b828210156117f25783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156117025761170261424f565b60048111156117135761171361424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561174b5761174b61424f565b600281111561175c5761175c61424f565b81528154602090910190600160b01b900460ff1660028111156117815761178161424f565b60028111156117925761179261424f565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b031681526020016001820154815260200160028201548152602001600382015481525050815260200190600101906116ba565b505050508152505081526020019060010190611668565b5050509152505060408051602081019091526000815290915060028260200151600381111561183a5761183a61424f565b03611870575060408051808201909152601481527368747470733a2f2f617277656176652e6e65742f60601b60208201526118ad565b6003826020015160038111156118885761188861424f565b036118ad5750604080518082019091526007815266697066733a2f2f60c81b60208201525b6101208201516040516118c4918391602001614e7c565b60408051601f198184030181529181526001600160a01b0389166000908152600760209081528282208883529052205490955060ff1661192b578461190884613006565b604051602001611919929190614eab565b60405160208183030381529060405294505b5050505092915050565b336119486000546001600160a01b031690565b6001600160a01b031614806119635750611963600133611f01565b61197f5760405162461bcd60e51b8152600401610d9a90614b5c565b6040516323b872dd60e01b81523060048201526001600160a01b038281166024830152604482018490528416906323b872dd90606401600060405180830381600087803b1580156119cf57600080fd5b505af1158015610cdb573d6000803e3d6000fd5b60006119ed611ba8565b6119f8602083614bb6565b15611a1657604051635cb045db60e01b815260040160405180910390fd5b60008080806060611a2987890189614ee7565b939850919650945092509050611a458b8b8b8888888888613098565b5063f23a6e6160e01b945050505050611a5e6001600355565b9695505050505050565b611a70612028565b6001600160a01b038116611ad55760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610d9a565b6106528161249e565b33611af16000546001600160a01b031690565b6001600160a01b03161480611b0c5750611b0c600133611f01565b611b285760405162461bcd60e51b8152600401610d9a90614b5c565b6106508282612410565b60006001600160e01b031982166313668cf560e31b1480611b6357506001600160e01b03198216630a85bd0160e11b145b80611b7e57506001600160e01b03198216630271189760e51b145b80611b9957506001600160e01b0319821663e9dc637560e01b145b80610538575061053882613415565b600260035403611bfa5760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606401610d9a565b6002600355565b611c0c602082614bb6565b15611c2a57604051635cb045db60e01b815260040160405180910390fd5b600080806060611c3c85870187614f5a565b929650909450925090506000611c52858561344a565b6001810154600382018054929350611c9e92600160601b9092046001600160a01b03169190600082611c8657611c86614961565b9060005260206000209060020201600001548c6134c6565b8054611cd29063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b90910416600180613516565b50600081600301600081548110611ceb57611ceb614961565b90600052602060002090600202016001018481548110611d0d57611d0d614961565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115611d4b57611d4b61424f565b6004811115611d5c57611d5c61424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115611d9457611d9461424f565b6002811115611da557611da561424f565b81528154602090910190600160b01b900460ff166002811115611dca57611dca61424f565b6002811115611ddb57611ddb61424f565b81528154600160b81b90046001600160481b0316602082015260018083015460408301526002830154606083015260039092015460809091015290915081604001516002811115611e2e57611e2e61424f565b14611e4c5760405163b4fa3fb360e01b815260040160405180910390fd5b604051630e5597a560e31b81527370b4070953cdf0cf33d69322495df78a83b734e9906372acbd2890611e8990849033908e908990600401614fb0565b60006040518083038186803b158015611ea157600080fd5b505af4158015611eb5573d6000803e3d6000fd5b50505050611ed78130338c600160405180602001604052806000815250613597565b611ef58686848d600160405180602001604052806000815250612945565b50505050505050505050565b6001600160a01b038116600090815260018301602052604081205415155b9392505050565b604051630935e01b60e21b81523360048201526001600160a01b038216906324d7806c90602401602060405180830381865afa158015611f6a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f8e9190615023565b61065257604051630bd4212160e11b81526001600160a01b0382166004820152602401610d9a565b7370b4070953cdf0cf33d69322495df78a83b734e963b40609bf8484611fdc87876120ad565b856040518563ffffffff1660e01b8152600401611ffc94939291906153aa565b60006040518083038186803b15801561201457600080fd5b505af4158015610cdb573d6000803e3d6000fd5b6000546001600160a01b03163314610d4e5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610d9a565b6000611f1f836001600160a01b0384166139cc565b6000610538825490565b6000611f1f8383613ac6565b6001600160a01b03821660009081526004602090815260408083208484529091528120908154600160a01b900460ff1660038111156120ee576120ee61424f565b0361053857604051630e50afef60e21b815260048101839052602401610d9a565b6001600160a01b038216600090815260066020908152604080832084845282528083208151808301909252546001600160e01b038116808352600160e01b90910463ffffffff1692820192909252829182036122145760405163b4b5b48f60e01b8152600481018590526000906001600160a01b0387169063b4b5b48f90602401602060405180830381865afa1580156121ad573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906121d191906153d7565b66ffffffffffffff601882901c169450905060008490036122085760405163124bad6360e31b815260048101869052602401610d9a565b62ffffff169150612232565b80600001516001600160e01b03169250806020015163ffffffff1691505b509250929050565b6005546000906001600160a01b03161580159061053857506005546040516345ecd02f60e01b81526001600160a01b038481166004830152909116906345ecd02f90602401602060405180830381865afa15801561229c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105389190615023565b6000806122cd8a8a61344a565b80549091506123039063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b909104168b88613516565b97508763ffffffff1660000361231d576000915050612403565b6001810154600160601b90046001600160a01b0316808661236457600188111561234e57660384665653e000612357565b6602738d24e520005b6123619083614e50565b91505b60018a63ffffffff1611156123985761238363ffffffff8b1683615403565b915061239563ffffffff8b1682615403565b90505b8c8211156123b957604051637e2897ef60e11b815260040160405180910390fd5b80156123d45782546123d4906001600160a01b031682612410565b6123f0836123e28a8c61541a565b8c63ffffffff163389613af0565b6123fe8c8c85338e8a612945565b509150505b9998505050505050505050565b6000826001600160a01b03168260405160006040518083038185875af1925050503d806000811461245d576040519150601f19603f3d011682016040523d82523d6000602084013e612462565b606091505b505090508061248457604051637bf340bd60e11b815260040160405180910390fd5b505050565b6000611f1f836001600160a01b038416613e25565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b60006124fa858561344a565b6001810154909150600160601b90046001600160a01b0316151580612520575081518814155b80612531575061252f8a61223a565b155b1561254f5760405163b4fa3fb360e01b815260040160405180910390fd5b80546000906125869063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b90910416876001613516565b90506000896001600160401b038111156125a2576125a261494b565b6040519080825280602002602001820160405280156125cb578160200160208202803683370190505b50905060005b845181101561287e5760008582815181106125ee576125ee614961565b60200260200101519050600085600301826000015165ffffffffffff168154811061261b5761261b614961565b9060005260206000209060020201600101826020015165ffffffffffff168154811061264957612649614961565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156126875761268761424f565b60048111156126985761269861424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff1660028111156126d0576126d061424f565b60028111156126e1576126e161424f565b81528154602090910190600160b01b900460ff1660028111156127065761270661424f565b60028111156127175761271761424f565b81528154600160b81b90046001600160481b03166020820152600182015460408201526002820154606082015260039091015460809091015290508d8d8481811061276457612764614961565b905060200201358260600151146127aa578d8d8481811061278757612787614961565b9050602002013560405163124bad6360e31b8152600401610d9a91815260200190565b8b8b848181106127bc576127bc614961565b905060200201358863ffffffff1682608001516127d99190615427565b6001600160481b0316146128005760405163918e94c560e01b815260040160405180910390fd5b8763ffffffff168563ffffffff1614612874578463ffffffff1681608001516128299190615427565b6001600160481b03168c8c8581811061284457612844614961565b905060200201356128559190614b49565b84848151811061286757612867614961565b6020026020010181815250505b50506001016125d1565b506128a183858463ffffffff163060405180602001604052806000815250613af0565b6128be8787858f8660405180602001604052806000815250612945565b8463ffffffff168263ffffffff161461134257336001600160a01b0316632eb2c2d6308e8e8e866040518663ffffffff1660e01b8152600401612905959493929190615485565b600060405180830381600087803b15801561291f57600080fd5b505af1158015612933573d6000803e3d6000fd5b50505050505050505050505050505050565b8354600160c81b900461ffff16600114801561296757508163ffffffff166001145b15612b7d578354849060159061298990600160a81b900463ffffffff16615501565b91906101000a81548163ffffffff021916908363ffffffff1602179055506000600385600001601f9054906101000a900460ff1660ff1610612a6057845460405163d397371960e01b81526001600160a01b038681166004830152600160a81b90920463ffffffff16601889901b66ffffffff0000001617602482018190529189169063d3973719906044016020604051808303816000875af1158015612a34573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612a589190614e63565b915050612b31565b604051630525194b60e31b81526001600160a01b038581166004830152881690632928ca58906024016020604051808303816000875af1158015612aa8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612acc9190614e63565b6040805180820182526001600160e01b03808a168252885463ffffffff600160a81b909104811660208085019182526001600160a01b038e16600090815260068252868120888252909152949094209251935116600160e01b02921691909117905590505b8086886001600160a01b03167fa383afa3c54602b421e1ca976c247507e6cc6460855d62f8f8e632b2a38a33f4600186604051612b6f929190615524565b60405180910390a450612f73565b8354600090612b98908490600160c81b900461ffff16614e28565b63ffffffff16905061ffff811115612bc35760405163b4fa3fb360e01b815260040160405180910390fd5b8454600090612be090600160a81b900463ffffffff166001615543565b865463ffffffff918216925083918891601591612c07918591600160a81b90910416615543565b92506101000a81548163ffffffff021916908363ffffffff160217905550600386600001601f9054906101000a900460ff1660ff1610612de3576000826001600160401b03811115612c5b57612c5b61494b565b604051908082528060200260200182016040528015612c84578160200160208202803683370190505b50905060005b83811015612cee57612c9c8184614e50565b62ffffff1660188a66ffffffffffffff16901b1766ffffffffffffff16828281518110612ccb57612ccb614961565b69ffffffffffffffffffff90921660209283029190910190910152600101612c8a565b5060405163213c198760e11b81526000906001600160a01b038b1690634278330e90612d20908a908690600401615560565b6000604051808303816000875af1158015612d3f573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052612d6791908101906155c2565b905060005b84811015612ddb57818181518110612d8657612d86614961565b60200260200101518a8c6001600160a01b03167fa383afa3c54602b421e1ca976c247507e6cc6460855d62f8f8e632b2a38a33f460018a604051612dcb929190615524565b60405180910390a4600101612d6c565b505050610c4f565b60405163e00aab4b60e01b81526001600160a01b03868116600483015261ffff84166024830152600091908a169063e00aab4b906044016000604051808303816000875af1158015612e39573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052612e6191908101906155c2565b905060005b83811015611ef55760405180604001604052808a6001600160e01b031681526020018285612e949190614e50565b63ffffffff1690526001600160a01b038b1660009081526006602052604081208451909190859085908110612ecb57612ecb614961565b6020908102919091018101518252818101929092526040016000208251929091015163ffffffff16600160e01b026001600160e01b039092169190911790558151829082908110612f1e57612f1e614961565b6020026020010151898b6001600160a01b03167fa383afa3c54602b421e1ca976c247507e6cc6460855d62f8f8e632b2a38a33f4600189604051612f63929190615524565b60405180910390a4600101612e66565b505050505050565b6001600160a01b03841660009081526004602081815260408084208685529091529182902091516314765c6b60e01b81527370b4070953cdf0cf33d69322495df78a83b734e9926314765c6b92612fda92899289928992899101615647565b60006040518083038186803b158015612ff257600080fd5b505af4158015610c4f573d6000803e3d6000fd5b6060600061301383613e74565b60010190506000816001600160401b038111156130325761303261494b565b6040519080825280601f01601f19166020018201604052801561305c576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461306657509392505050565b60006130a4868661344a565b60018101546003820180549293506130d892600160601b9092046001600160a01b03169190600082611c8657611c86614961565b805460009061310f9063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b90910416886001613516565b905060008260030160008154811061312957613129614961565b9060005260206000209060020201600101858154811061314b5761314b614961565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156131895761318961424f565b600481111561319a5761319a61424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff1660028111156131d2576131d261424f565b60028111156131e3576131e361424f565b81528154602090910190600160b01b900460ff1660028111156132085761320861424f565b60028111156132195761321961424f565b81528154600160b81b90046001600160481b0316602082015260018201546040820152600282015460608201526003909101546080918201528101519091506132699063ffffffff881690615427565b6001600160481b03168914613291576040516302075cc160e41b815260040160405180910390fd5b604051630e5597a560e31b81527370b4070953cdf0cf33d69322495df78a83b734e9906372acbd28906132ce90849033908f908a90600401614fb0565b60006040518083038186803b1580156132e657600080fd5b505af41580156132fa573d6000803e3d6000fd5b505050506133218130338d8663ffffffff1660405180602001604052806000815250613597565b61333e8888858e8660405180602001604052806000815250612945565b8563ffffffff168263ffffffff161461340857336001600160a01b031663f242432a308d8d8560800151878c613374919061567d565b63ffffffff166133849190615427565b6040516001600160e01b031960e087901b1681526001600160a01b03948516600482015293909216602484015260448301526001600160481b0316606482015260a06084820152600060a482015260c401600060405180830381600087803b1580156133ef57600080fd5b505af1158015613403573d6000803e3d6000fd5b505050505b5050505050505050505050565b60006001600160e01b03198216632a9f3abf60e11b148061053857506301ffc9a760e01b6001600160e01b0319831614610538565b600061345683836120ad565b60018101549091504265ffffffffffff90911611806134a557506001810154600160301b900465ffffffffffff1642108015906134a557506001810154600160301b900465ffffffffffff1615155b156105385760405163cbd1635360e01b815260048101839052602401610d9a565b831515806134d5575082600114155b806134e1575081600114155b806134f257506134f08161223a565b155b156135105760405163b4fa3fb360e01b815260040160405180910390fd5b50505050565b60008563ffffffff1660000361352d575081613568565b60008461353a878961567d565b613544919061569a565b90508363ffffffff168163ffffffff16111561356257839150613566565b8091505b505b818015613579575063ffffffff8116155b156105675760405163918e94c560e01b815260040160405180910390fd5b6002866040015160028111156135af576135af61424f565b036137dd5760008287608001516001600160481b03166135cf9190615403565b90506000876060015160028111156135e9576135e961424f565b0361365b57604051637921219560e11b81526001600160a01b0386169063f242432a9061362490899061dead908990879089906004016156bd565b600060405180830381600087803b15801561363e57600080fd5b505af1158015613652573d6000803e3d6000fd5b505050506137d7565b6001876060015160028111156136735761367361424f565b03613765576040805160018082528183019092526000916020808301908036833701905050905084816000815181106136ae576136ae614961565b602090810291909101015260408051600180825281830190925260009181602001602082028036833701905050905082816000815181106136f1576136f1614961565b6020908102919091010152604051633db0f8ab60e01b81526001600160a01b03881690633db0f8ab9061372c908b90869086906004016156f7565b600060405180830381600087803b15801561374657600080fd5b505af115801561375a573d6000803e3d6000fd5b5050505050506137d7565b60028760600151600281111561377d5761377d61424f565b036137be57604051637a94c56560e11b81526001600160a01b038781166004830152602482018690526044820183905286169063f5298aca90606401613624565b60405163cbdea8bd60e01b815260040160405180910390fd5b50612f73565b6001866040015160028111156137f5576137f561424f565b036139b3578160011461381b576040516302075cc160e41b815260040160405180910390fd5b6000866060015160028111156138335761383361424f565b036138a357604051635c46a7ef60e11b81526001600160a01b0385169063b88d4fde9061386c90889061dead908890879060040161572d565b600060405180830381600087803b15801561388657600080fd5b505af115801561389a573d6000803e3d6000fd5b50505050612f73565b6001866060015160028111156138bb576138bb61424f565b14806138dc57506002866060015160028111156138da576138da61424f565b145b156137be576001600160a01b0385163014613986576040516331a9108f60e11b8152600481018490526001600160a01b038087169190861690636352211e90602401602060405180830381865afa15801561393b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061395f9190615760565b6001600160a01b03161461398657604051637bf340bd60e11b815260040160405180910390fd5b604051630852cd8d60e31b8152600481018490526001600160a01b038516906342966c689060240161386c565b60405163c163a89360e01b815260040160405180910390fd5b60008181526001830160205260408120548015613ab55760006139f0600183614b49565b8554909150600090613a0490600190614b49565b9050818114613a69576000866000018281548110613a2457613a24614961565b9060005260206000200154905080876000018481548110613a4757613a47614961565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080613a7a57613a7a61577d565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610538565b6000915050610538565b5092915050565b6000826000018281548110613add57613add614961565b9060005260206000200154905092915050565b60038501546000906001600160401b03811115613b0f57613b0f61494b565b604051908082528060200260200182016040528015613b38578160200160208202803683370190505b50905060005b8551811015613da6576000868281518110613b5b57613b5b614961565b60200260200101519050600088600301826000015165ffffffffffff1681548110613b8857613b88614961565b9060005260206000209060020201600101826020015165ffffffffffff1681548110613bb657613bb6614961565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115613bf457613bf461424f565b6004811115613c0557613c0561424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115613c3d57613c3d61424f565b6002811115613c4e57613c4e61424f565b81528154602090910190600160b01b900460ff166002811115613c7357613c7361424f565b6002811115613c8457613c8461424f565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505090507370b4070953cdf0cf33d69322495df78a83b734e96372acbd28828460400151856060015186608001516040518563ffffffff1660e01b8152600401613d209493929190614fb0565b60006040518083038186803b158015613d3857600080fd5b505af4158015613d4c573d6000803e3d6000fd5b50505050613d668187846040015185606001518b8a613597565b8684836000015165ffffffffffff1681518110613d8557613d85614961565b60200260200101818151613d999190614e50565b9052505050600101613b3e565b5060005b8151811015610cdb5784876003018281548110613dc957613dc9614961565b906000526020600020906002020160000154613de59190615403565b828281518110613df757613df7614961565b602002602001015114613e1d576040516302075cc160e41b815260040160405180910390fd5b600101613daa565b6000818152600183016020526040812054613e6c57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610538565b506000610538565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b8310613eb35772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310613edf576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc100008310613efd57662386f26fc10000830492506010015b6305f5e1008310613f15576305f5e100830492506008015b6127108310613f2957612710830492506004015b60648310613f3b576064830492506002015b600a83106105385760010192915050565b6040805161016081019091526000808252602082019081526000602082018190526040820181905260608083018290526080830182905260a0830182905260c0830182905260e083019190915261010082018190526101209091015290565b600060208284031215613fbd57600080fd5b81356001600160e01b031981168114611f1f57600080fd5b6001600160a01b038116811461065257600080fd5b60008083601f840112613ffc57600080fd5b5081356001600160401b0381111561401357600080fd5b60208301915083602082850101111561402b57600080fd5b9250929050565b60008060008060006080868803121561404a57600080fd5b853561405581613fd5565b9450602086013561406581613fd5565b93506040860135925060608601356001600160401b0381111561408757600080fd5b61409388828901613fea565b969995985093965092949392505050565b6000602082840312156140b657600080fd5b8135611f1f81613fd5565b801515811461065257600080fd5b600080600080608085870312156140e557600080fd5b84356140f081613fd5565b93506020850135925060408501356001600160401b0381111561411257600080fd5b8501610120818803121561412557600080fd5b91506060850135614135816140c1565b939692955090935050565b6020808252825182820181905260009190848201906040850190845b818110156141815783516001600160a01b03168352928401929184019160010161415c565b50909695505050505050565b80356004811061419c57600080fd5b919050565b60008060008060008060a087890312156141ba57600080fd5b86356141c581613fd5565b9550602087013594506141da6040880161418d565b935060608701356001600160401b038111156141f557600080fd5b61420189828a01613fea565b9094509250506080870135614215816140c1565b809150509295509295509295565b6000806040838503121561423657600080fd5b823561424181613fd5565b946020939093013593505050565b634e487b7160e01b600052602160045260246000fd5b600481106142755761427561424f565b9052565b60005b8381101561429457818101518382015260200161427c565b50506000910152565b600081518084526142b5816020860160208601614279565b601f01601f19169290920160200192915050565b600581106142755761427561424f565b600381106106525761065261424f565b614275816142d9565b6142fd8282516142c9565b6020818101516001600160a01b031690830152604081015161431e816142d9565b60408301526060810151614331816142d9565b60608301526080818101516001600160481b03169083015260a0808201519083015260c0808201519083015260e090810151910152565b600081518084526020808501808196508360051b810191508286016000805b868110156143f8578385038a528251805186528601516040878701819052815190870181905290870190606087019084905b808210156143e3576143cc8385516142f2565b6101008301925089840193506001820191506143b9565b50509a87019a95505091850191600101614387565b509298975050505050505050565b80516001600160a01b031682526000610160602083015161442a6020860182614265565b506040830151614442604086018263ffffffff169052565b506060830151614458606086018261ffff169052565b506080830151614470608086018263ffffffff169052565b5060a083015161448560a086018260ff169052565b5060c083015161449f60c086018265ffffffffffff169052565b5060e08301516144b960e086018265ffffffffffff169052565b50610100838101516001600160a01b031690850152610120808401518186018390526144e78387018261429d565b925050506101408084015185830382870152611a5e8382614368565b82815260406020820152600061451c6040830184614406565b949350505050565b60008083601f84011261453657600080fd5b5081356001600160401b0381111561454d57600080fd5b6020830191508360208260051b850101111561402b57600080fd5b6000806000806000806000806080898b03121561458457600080fd5b88356001600160401b038082111561459b57600080fd5b6145a78c838d01614524565b909a50985060208b01359150808211156145c057600080fd5b6145cc8c838d01614524565b909850965060408b01359150808211156145e557600080fd5b6145f18c838d01614524565b909650945060608b013591508082111561460a57600080fd5b506146178b828c01614524565b999c989b5096995094979396929594505050565b803563ffffffff8116811461419c57600080fd5b600080600080600080600060a0888a03121561465a57600080fd5b873561466581613fd5565b96506020880135955061467a6040890161462b565b945060608801356001600160401b038082111561469657600080fd5b6146a28b838c01614524565b909650945060808a01359150808211156146bb57600080fd5b506146c88a828b01613fea565b989b979a50959850939692959293505050565b602081526000611f1f6020830184614406565b60008060008060008060008060a0898b03121561470a57600080fd5b883561471581613fd5565b9750602089013561472581613fd5565b965060408901356001600160401b038082111561474157600080fd5b61474d8c838d01614524565b909850965060608b013591508082111561476657600080fd5b6147728c838d01614524565b909650945060808b013591508082111561478b57600080fd5b506146178b828c01613fea565b600080600080600080608087890312156147b157600080fd5b86356147bc81613fd5565b95506020870135945060408701356001600160401b03808211156147df57600080fd5b6147eb8a838b01614524565b9096509450606089013591508082111561480457600080fd5b5061481189828a01614524565b979a9699509497509295939492505050565b60008060008060006080868803121561483b57600080fd5b853561484681613fd5565b94506020860135935061485b6040870161462b565b925060608601356001600160401b0381111561487657600080fd5b61409388828901614524565b602081526000611f1f602083018461429d565b6000806000606084860312156148aa57600080fd5b83356148b581613fd5565b92506020840135915060408401356148cc81613fd5565b809150509250925092565b60008060008060008060a087890312156148f057600080fd5b86356148fb81613fd5565b9550602087013561490b81613fd5565b9450604087013593506060870135925060808701356001600160401b0381111561493457600080fd5b61481189828a01613fea565b803561419c81613fd5565b634e487b7160e01b600052604160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60006001820161499f5761499f614977565b5060010190565b600181811c908216806149ba57607f821691505b6020821081036149da57634e487b7160e01b600052602260045260246000fd5b50919050565b601f82111561248457600081815260208120601f850160051c81016020861015614a075750805b601f850160051c820191505b81811015612f7357828155600101614a13565b6001600160401b03831115614a3d57614a3d61494b565b614a5183614a4b83546149a6565b836149e0565b6000601f841160018114614a855760008515614a6d5750838201355b600019600387901b1c1916600186901b1783556113a6565b600083815260209020601f19861690835b82811015614ab65786850135825560209485019460019092019101614a96565b5086821015614ad35760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b600060208284031215614af757600080fd5b611f1f8261462b565b6000808335601e19843603018112614b1757600080fd5b8301803591506001600160401b03821115614b3157600080fd5b6020019150600581901b360382131561402b57600080fd5b8181038181111561053857610538614977565b60208082526024908201527f41646d696e436f6e74726f6c3a204d757374206265206f776e6572206f7220616040820152633236b4b760e11b606082015260800190565b634e487b7160e01b600052601260045260246000fd5b600082614bc557614bc5614ba0565b500690565b60405160a081016001600160401b0381118282101715614bec57614bec61494b565b60405290565b604051601f8201601f191681016001600160401b0381118282101715614c1a57614c1a61494b565b604052919050565b60006001600160401b03821115614c3b57614c3b61494b565b5060051b60200190565b803565ffffffffffff8116811461419c57600080fd5b600082601f830112614c6c57600080fd5b81356020614c81614c7c83614c22565b614bf2565b82815260059290921b84018101918181019086841115614ca057600080fd5b8286015b84811015614cbb5780358352918301918301614ca4565b509695505050505050565b6000614cd4614c7c84614c22565b8381529050602080820190600585901b840186811115614cf357600080fd5b845b81811015614da05780356001600160401b0380821115614d155760008081fd5b9087019060a0828b031215614d2a5760008081fd5b614d32614bca565b614d3b83614c45565b8152614d48868401614c45565b86820152604080840135614d5b81613fd5565b908201526060838101359082015260808084013583811115614d7d5760008081fd5b614d898d828701614c5b565b918301919091525086525050928201928201614cf5565b505050509392505050565b60008060008060808587031215614dc157600080fd5b8435614dcc81613fd5565b935060208501359250614de16040860161462b565b915060608501356001600160401b03811115614dfc57600080fd5b8501601f81018713614e0d57600080fd5b614e1c87823560208401614cc6565b91505092959194509250565b63ffffffff818116838216028082169190828114614e4857614e48614977565b505092915050565b8082018082111561053857610538614977565b600060208284031215614e7557600080fd5b5051919050565b60008351614e8e818460208801614279565b835190830190614ea2818360208801614279565b01949350505050565b60008351614ebd818460208801614279565b602f60f81b9083019081528351614edb816001840160208801614279565b01600101949350505050565b600080600080600060a08688031215614eff57600080fd5b8535614f0a81613fd5565b945060208601359350614f1f6040870161462b565b92506060860135915060808601356001600160401b03811115614f4157600080fd5b614f4d88828901614c5b565b9150509295509295909350565b60008060008060808587031215614f7057600080fd5b8435614f7b81613fd5565b9350602085013592506040850135915060608501356001600160401b03811115614fa457600080fd5b614e1c87828801614c5b565b6000610160808301614fc284896142f2565b6001600160a01b038716610100850152610120840186905261014084019190915283519081905261018083019060209081860160005b8281101561501457815185529383019390830190600101614ff8565b50929998505050505050505050565b60006020828403121561503557600080fd5b8151611f1f816140c1565b803561ffff8116811461419c57600080fd5b6000808335601e1984360301811261506957600080fd5b83016020810192503590506001600160401b0381111561508857600080fd5b80360382131561402b57600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b6000808335601e198436030181126150d757600080fd5b83016020810192503590506001600160401b038111156150f657600080fd5b8060051b360382131561402b57600080fd5b80356003811061419c57600080fd5b80356001600160481b038116811461419c57600080fd5b81835260006020808501808196506005915085821b81018560005b8881101561529b578383038a528135603e1989360301811261516a57600080fd5b88018035845260408481018883013536849003601e1901811261518c57600080fd5b9092018881019290356001600160401b038111156151a957600080fd5b8060081b36038413156151bb57600080fd5b868a018390529081905260609081870160005b828110156152845785358b81106151e457600080fd5b6151ee83826142c9565b508b8601356151fc81613fd5565b6001600160a01b03168c830152615214868601615108565b615220868401826142e9565b5061522c848701615108565b615238858401826142e9565b506080615246818801615117565b6001600160481b03169083015260a0868101359083015260c0808701359083015260e0808701359083015261010095860195909101906001016151ce565b509d8a019d96505050928701925050600101615149565b509098975050505050505050565b60006101206152c8846152bb85614940565b6001600160a01b03169052565b6152d46020840161418d565b6152e16020860182614265565b506152ee60408401615040565b61ffff1660408501526153036060840161462b565b63ffffffff16606085015261531a60808401614c45565b65ffffffffffff16608085015261533360a08401614c45565b65ffffffffffff1660a085015261534c60c08401614940565b6001600160a01b031660c085015261536760e0840184615052565b8260e087015261537a8387018284615097565b9250505061010061538d818501856150c0565b8684038388015261539f84828461512e565b979650505050505050565b60018060a01b0385168152836020820152826040820152608060608201526000611a5e60808301846152a9565b6000602082840312156153e957600080fd5b815169ffffffffffffffffffff81168114611f1f57600080fd5b808202811582820484141761053857610538614977565b6000611f1f368484614cc6565b6001600160481b03818116838216028082169190828114614e4857614e48614977565b600081518084526020808501945080840160005b8381101561547a5781518752958201959082019060010161545e565b509495945050505050565b6001600160a01b0386811682528516602082015260a060408201819052810183905260006001600160fb1b038411156154bd57600080fd5b8360051b808660c0850137820182810360c090810160608501526154e39082018561544a565b83810360809094019390935250506000815260200195945050505050565b600063ffffffff80831681810361551a5761551a614977565b6001019392505050565b63ffffffff8316815260406020820152600061451c604083018461429d565b63ffffffff818116838216019080821115613abf57613abf614977565b6001600160a01b038316815260406020808301829052835191830182905260009184820191906060850190845b818110156155b557845169ffffffffffffffffffff168352938301939183019160010161558d565b5090979650505050505050565b600060208083850312156155d557600080fd5b82516001600160401b038111156155eb57600080fd5b8301601f810185136155fc57600080fd5b805161560a614c7c82614c22565b81815260059190911b8201830190838101908783111561562957600080fd5b928401925b8284101561539f5783518252928401929084019061562e565b60018060a01b038616815260ff8516602082015283604082015282606082015260a06080820152600061539f60a08301846152a9565b63ffffffff828116828216039080821115613abf57613abf614977565b600063ffffffff808416806156b1576156b1614ba0565b92169190910492915050565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061539f9083018461429d565b6001600160a01b038416815260606020820181905260009061571b9083018561544a565b8281036040840152611a5e818561544a565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090611a5e9083018461429d565b60006020828403121561577257600080fd5b8151611f1f81613fd5565b634e487b7160e01b600052603160045260246000fdfea2646970667358221220320f4da70366daeeadda7e2832204c849c554699074ffc851fd0e1e2a2a734bd64736f6c634300081100330000000000000000000000007ef0d682280193fb1fb8dc6174f8a0c5bc4f02b0

Deployed Bytecode

0x60806040526004361061016c5760003560e01c8063715018a6116100cc578063c9dad6961161007a578063c9dad69614610433578063cc7ac3f714610446578063e9dc637514610466578063f0e9fcd114610493578063f23a6e61146104b3578063f2fde38b146104d3578063f3fef3a3146104f357600080fd5b8063715018a6146103585780637ab393921461036d5780638da5cb5b1461038d57806395bc312b146103ab578063b058d2f8146103c6578063bc197c81146103f3578063c2065c101461041357600080fd5b80633f25c996116101295780633f25c9961461026357806341d29f071461028357806342b54fee146102b1578063480df058146102c457806350d10839146102ed5780635a7373df146103255780636d73e6691461033857600080fd5b806301ffc9a714610171578063150b7a02146101a657806324d7806c146101df57806327a99a14146101ff5780632d3456701461022157806331ae450b14610241575b600080fd5b34801561017d57600080fd5b5061019161018c366004613fab565b610513565b60405190151581526020015b60405180910390f35b3480156101b257600080fd5b506101c66101c1366004614032565b61053e565b6040516001600160e01b0319909116815260200161019d565b3480156101eb57600080fd5b506101916101fa3660046140a4565b610570565b34801561020b57600080fd5b5061021f61021a3660046140cf565b6105a9565b005b34801561022d57600080fd5b5061021f61023c3660046140a4565b6105f7565b34801561024d57600080fd5b50610256610655565b60405161019d9190614140565b34801561026f57600080fd5b5061021f61027e3660046141a1565b610703565b34801561028f57600080fd5b506102a361029e366004614223565b6107b4565b60405161019d929190614503565b61021f6102bf366004614568565b610b1e565b3480156102d057600080fd5b506102df6602738d24e5200081565b60405190815260200161019d565b3480156102f957600080fd5b5060055461030d906001600160a01b031681565b6040516001600160a01b03909116815260200161019d565b61021f61033336600461463f565b610c59565b34801561034457600080fd5b5061021f6103533660046140a4565b610ce4565b34801561036457600080fd5b5061021f610d3c565b34801561037957600080fd5b5061021f6103883660046140a4565b610d50565b34801561039957600080fd5b506000546001600160a01b031661030d565b3480156103b757600080fd5b506102df660384665653e00081565b3480156103d257600080fd5b506103e66103e1366004614223565b610dc5565b60405161019d91906146db565b3480156103ff57600080fd5b506101c661040e3660046146ee565b61110c565b34801561041f57600080fd5b5061021f61042e366004614798565b611190565b61021f610441366004614823565b611350565b34801561045257600080fd5b5061021f6104613660046140cf565b6113ad565b34801561047257600080fd5b50610486610481366004614223565b6114b4565b60405161019d9190614882565b34801561049f57600080fd5b5061021f6104ae366004614895565b611935565b3480156104bf57600080fd5b506101c66104ce3660046148d7565b6119e3565b3480156104df57600080fd5b5061021f6104ee3660046140a4565b611a68565b3480156104ff57600080fd5b5061021f61050e366004614223565b611ade565b60006001600160e01b0319821663d4f6907560e01b1480610538575061053882611b32565b92915050565b6000610548611ba8565b61055485858585611c01565b50630a85bd0160e11b6105676001600355565b95945050505050565b6000816001600160a01b031661058e6000546001600160a01b031690565b6001600160a01b031614806105385750610538600183611f01565b6105b284611f26565b6105bd848484611fb6565b6001600160a01b0393909316600090815260076020908152604080832094835293905291909120805460ff19169215159290921790915550565b6105ff612028565b61060a600182611f01565b156106525760405133906001600160a01b038316907f7c0c3c84c67c85fcac635147348bfe374c24a1a93d0366d1cfe9d8853cbf89d590600090a3610650600182612082565b505b50565b60606106616001612097565b6001600160401b038111156106785761067861494b565b6040519080825280602002602001820160405280156106a1578160200160208202803683370190505b50905060005b6106b16001612097565b8110156106ff576106c36001826120a1565b8282815181106106d5576106d5614961565b6001600160a01b0390921660209283029190910190910152806106f78161498d565b9150506106a7565b5090565b61070c86611f26565b600061071887876120ad565b80549091508590829060ff60a01b1916600160a01b83600381111561073f5761073f61424f565b021790555060028101610753848683614a26565b506001600160a01b03871660008181526007602090815260408083208a8452909152808220805460ff1916861515179055518892917fc4487c68aeaaea10bc0e1e6408497e8b1eedeb6aeece8711fdb0da6b6c288dab91a350505050505050565b60006107be613f4c565b6107c8848461210f565b506001600160a01b038581166000908152600460209081526040808320858452825291829020825161016081019093528054938416835293955090929190830190600160a01b900460ff1660038111156108245761082461424f565b60038111156108355761083561424f565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e0820152600282018054610100909201916108c5906149a6565b80601f01602080910402602001604051908101604052809291908181526020018280546108f1906149a6565b801561093e5780601f106109135761010080835404028352916020019161093e565b820191906000526020600020905b81548152906001019060200180831161092157829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b82821015610b0d57838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b82821015610af65783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115610a0657610a0661424f565b6004811115610a1757610a1761424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115610a4f57610a4f61424f565b6002811115610a6057610a6061424f565b81528154602090910190600160b01b900460ff166002811115610a8557610a8561424f565b6002811115610a9657610a9661424f565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b031681526020016001820154815260200160028201548152602001600382015481525050815260200190600101906109be565b50505050815250508152602001906001019061096c565b505050508152505090509250929050565b610b26611ba8565b8685141580610b355750868314155b80610b405750868114155b15610b5e5760405163b4fa3fb360e01b815260040160405180910390fd5b6000610b693361223a565b90503460005b89811015610c3257610c1e828c8c84818110610b8d57610b8d614961565b9050602002016020810190610ba291906140a4565b8b8b85818110610bb457610bb4614961565b905060200201358a8a86818110610bcd57610bcd614961565b9050602002016020810190610be29190614ae5565b898987818110610bf457610bf4614961565b9050602002810190610c069190614b00565b896000604051806020016040528060008152506122c0565b610c289083614b49565b9150600101610b6f565b508015610c4357610c433382612410565b5050610c4f6001600355565b5050505050505050565b610c61611ba8565b6000610cb3348989898989610c753361223a565b60018b8b8080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152506122c092505050565b905080341115610cd057610cd033610ccb8334614b49565b612410565b50610cdb6001600355565b50505050505050565b610cec612028565b610cf7600182611f01565b6106525760405133906001600160a01b038316907f7e1a1a08d52e4ba0e21554733d66165fd5151f99460116223d9e3a608eec5cb190600090a3610650600182612489565b610d44612028565b610d4e600061249e565b565b33610d636000546001600160a01b031690565b6001600160a01b03161480610d7e5750610d7e600133611f01565b610da35760405162461bcd60e51b8152600401610d9a90614b5c565b60405180910390fd5b600580546001600160a01b0319166001600160a01b0392909216919091179055565b610dcd613f4c565b610dd783836120ad565b60408051610160810190915281546001600160a01b03811682529091906020830190600160a01b900460ff166003811115610e1457610e1461424f565b6003811115610e2557610e2561424f565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e082015260028201805461010090920191610eb5906149a6565b80601f0160208091040260200160405190810160405280929190818152602001828054610ee1906149a6565b8015610f2e5780601f10610f0357610100808354040283529160200191610f2e565b820191906000526020600020905b815481529060010190602001808311610f1157829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b828210156110fd57838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b828210156110e65783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115610ff657610ff661424f565b60048111156110075761100761424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561103f5761103f61424f565b60028111156110505761105061424f565b81528154602090910190600160b01b900460ff1660028111156110755761107561424f565b60028111156110865761108661424f565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505081526020019060010190610fae565b505050508152505081526020019060010190610f5c565b50505091525090949350505050565b6000611116611ba8565b611121602083614bb6565b1561113f57604051635cb045db60e01b815260040160405180910390fd5b60008080606061115186880188614dab565b9296509094509250905061116c8c8c8c8c8c898989896124ee565b5063bc197c8160e01b93505050506111846001600355565b98975050505050505050565b61119986611f26565b8281146111b95760405163b4fa3fb360e01b815260040160405180910390fd5b60006111c587876120ad565b90506000805b8381101561122b578254600160c81b900461ffff168585838181106111f2576111f2614961565b90506020020160208101906112079190614ae5565b6112119190614e28565b6112219063ffffffff1683614e50565b91506001016111cb565b50815463ffffffff9061124790600160a81b9004821683614e50565b11156112665760405163918e94c560e01b815260040160405180910390fd5b60005b858110156112e2576112da8989858a8a8681811061128957611289614961565b905060200201602081019061129e91906140a4565b8989878181106112b0576112b0614961565b90506020020160208101906112c59190614ae5565b60405180602001604052806000815250612945565b600101611269565b5060405163e5c986cd60e01b8152600481018390527370b4070953cdf0cf33d69322495df78a83b734e99063e5c986cd9060240160006040518083038186803b15801561132e57600080fd5b505af4158015611342573d6000803e3d6000fd5b505050505050505050505050565b611358611ba8565b600061138334878787878761136c3361223a565b6001604051806020016040528060008152506122c0565b90508034111561139b5761139b33610ccb8334614b49565b506113a66001600355565b5050505050565b6113b684611f26565b8215806113c9575066ffffffffffffff83115b156113e75760405163b4fa3fb360e01b815260040160405180910390fd5b6000846001600160a01b031663ffa1ad746040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015611443575060408051601f3d908101601f1916820190925261144091810190614e63565b60015b1561146d5760ff81111561146a57604051634d73d22360e11b815260040160405180910390fd5b90505b61147985828686612f7b565b506001600160a01b0393909316600090815260076020908152604080832094835293905291909120805460ff19169215159290921790915550565b60606000806114c3858561210f565b6001600160a01b0387811660009081526004602090815260408083208684528252808320815161016081019092528054948516825295975093955090939190830190600160a01b900460ff1660038111156115205761152061424f565b60038111156115315761153161424f565b81528154600160a81b810463ffffffff9081166020840152600160c81b820461ffff166040840152600160d81b8204166060830152600160f81b900460ff166080820152600182015465ffffffffffff80821660a0840152600160301b82041660c0830152600160601b90046001600160a01b031660e0820152600282018054610100909201916115c1906149a6565b80601f01602080910402602001604051908101604052809291908181526020018280546115ed906149a6565b801561163a5780601f1061160f5761010080835404028352916020019161163a565b820191906000526020600020905b81548152906001019060200180831161161d57829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020016000905b8282101561180957838290600052602060002090600202016040518060400160405290816000820154815260200160018201805480602002602001604051908101604052809291908181526020016000905b828210156117f25783829060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156117025761170261424f565b60048111156117135761171361424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff16600281111561174b5761174b61424f565b600281111561175c5761175c61424f565b81528154602090910190600160b01b900460ff1660028111156117815761178161424f565b60028111156117925761179261424f565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b031681526020016001820154815260200160028201548152602001600382015481525050815260200190600101906116ba565b505050508152505081526020019060010190611668565b5050509152505060408051602081019091526000815290915060028260200151600381111561183a5761183a61424f565b03611870575060408051808201909152601481527368747470733a2f2f617277656176652e6e65742f60601b60208201526118ad565b6003826020015160038111156118885761188861424f565b036118ad5750604080518082019091526007815266697066733a2f2f60c81b60208201525b6101208201516040516118c4918391602001614e7c565b60408051601f198184030181529181526001600160a01b0389166000908152600760209081528282208883529052205490955060ff1661192b578461190884613006565b604051602001611919929190614eab565b60405160208183030381529060405294505b5050505092915050565b336119486000546001600160a01b031690565b6001600160a01b031614806119635750611963600133611f01565b61197f5760405162461bcd60e51b8152600401610d9a90614b5c565b6040516323b872dd60e01b81523060048201526001600160a01b038281166024830152604482018490528416906323b872dd90606401600060405180830381600087803b1580156119cf57600080fd5b505af1158015610cdb573d6000803e3d6000fd5b60006119ed611ba8565b6119f8602083614bb6565b15611a1657604051635cb045db60e01b815260040160405180910390fd5b60008080806060611a2987890189614ee7565b939850919650945092509050611a458b8b8b8888888888613098565b5063f23a6e6160e01b945050505050611a5e6001600355565b9695505050505050565b611a70612028565b6001600160a01b038116611ad55760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152608401610d9a565b6106528161249e565b33611af16000546001600160a01b031690565b6001600160a01b03161480611b0c5750611b0c600133611f01565b611b285760405162461bcd60e51b8152600401610d9a90614b5c565b6106508282612410565b60006001600160e01b031982166313668cf560e31b1480611b6357506001600160e01b03198216630a85bd0160e11b145b80611b7e57506001600160e01b03198216630271189760e51b145b80611b9957506001600160e01b0319821663e9dc637560e01b145b80610538575061053882613415565b600260035403611bfa5760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606401610d9a565b6002600355565b611c0c602082614bb6565b15611c2a57604051635cb045db60e01b815260040160405180910390fd5b600080806060611c3c85870187614f5a565b929650909450925090506000611c52858561344a565b6001810154600382018054929350611c9e92600160601b9092046001600160a01b03169190600082611c8657611c86614961565b9060005260206000209060020201600001548c6134c6565b8054611cd29063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b90910416600180613516565b50600081600301600081548110611ceb57611ceb614961565b90600052602060002090600202016001018481548110611d0d57611d0d614961565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115611d4b57611d4b61424f565b6004811115611d5c57611d5c61424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115611d9457611d9461424f565b6002811115611da557611da561424f565b81528154602090910190600160b01b900460ff166002811115611dca57611dca61424f565b6002811115611ddb57611ddb61424f565b81528154600160b81b90046001600160481b0316602082015260018083015460408301526002830154606083015260039092015460809091015290915081604001516002811115611e2e57611e2e61424f565b14611e4c5760405163b4fa3fb360e01b815260040160405180910390fd5b604051630e5597a560e31b81527370b4070953cdf0cf33d69322495df78a83b734e9906372acbd2890611e8990849033908e908990600401614fb0565b60006040518083038186803b158015611ea157600080fd5b505af4158015611eb5573d6000803e3d6000fd5b50505050611ed78130338c600160405180602001604052806000815250613597565b611ef58686848d600160405180602001604052806000815250612945565b50505050505050505050565b6001600160a01b038116600090815260018301602052604081205415155b9392505050565b604051630935e01b60e21b81523360048201526001600160a01b038216906324d7806c90602401602060405180830381865afa158015611f6a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f8e9190615023565b61065257604051630bd4212160e11b81526001600160a01b0382166004820152602401610d9a565b7370b4070953cdf0cf33d69322495df78a83b734e963b40609bf8484611fdc87876120ad565b856040518563ffffffff1660e01b8152600401611ffc94939291906153aa565b60006040518083038186803b15801561201457600080fd5b505af4158015610cdb573d6000803e3d6000fd5b6000546001600160a01b03163314610d4e5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610d9a565b6000611f1f836001600160a01b0384166139cc565b6000610538825490565b6000611f1f8383613ac6565b6001600160a01b03821660009081526004602090815260408083208484529091528120908154600160a01b900460ff1660038111156120ee576120ee61424f565b0361053857604051630e50afef60e21b815260048101839052602401610d9a565b6001600160a01b038216600090815260066020908152604080832084845282528083208151808301909252546001600160e01b038116808352600160e01b90910463ffffffff1692820192909252829182036122145760405163b4b5b48f60e01b8152600481018590526000906001600160a01b0387169063b4b5b48f90602401602060405180830381865afa1580156121ad573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906121d191906153d7565b66ffffffffffffff601882901c169450905060008490036122085760405163124bad6360e31b815260048101869052602401610d9a565b62ffffff169150612232565b80600001516001600160e01b03169250806020015163ffffffff1691505b509250929050565b6005546000906001600160a01b03161580159061053857506005546040516345ecd02f60e01b81526001600160a01b038481166004830152909116906345ecd02f90602401602060405180830381865afa15801561229c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105389190615023565b6000806122cd8a8a61344a565b80549091506123039063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b909104168b88613516565b97508763ffffffff1660000361231d576000915050612403565b6001810154600160601b90046001600160a01b0316808661236457600188111561234e57660384665653e000612357565b6602738d24e520005b6123619083614e50565b91505b60018a63ffffffff1611156123985761238363ffffffff8b1683615403565b915061239563ffffffff8b1682615403565b90505b8c8211156123b957604051637e2897ef60e11b815260040160405180910390fd5b80156123d45782546123d4906001600160a01b031682612410565b6123f0836123e28a8c61541a565b8c63ffffffff163389613af0565b6123fe8c8c85338e8a612945565b509150505b9998505050505050505050565b6000826001600160a01b03168260405160006040518083038185875af1925050503d806000811461245d576040519150601f19603f3d011682016040523d82523d6000602084013e612462565b606091505b505090508061248457604051637bf340bd60e11b815260040160405180910390fd5b505050565b6000611f1f836001600160a01b038416613e25565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b60006124fa858561344a565b6001810154909150600160601b90046001600160a01b0316151580612520575081518814155b80612531575061252f8a61223a565b155b1561254f5760405163b4fa3fb360e01b815260040160405180910390fd5b80546000906125869063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b90910416876001613516565b90506000896001600160401b038111156125a2576125a261494b565b6040519080825280602002602001820160405280156125cb578160200160208202803683370190505b50905060005b845181101561287e5760008582815181106125ee576125ee614961565b60200260200101519050600085600301826000015165ffffffffffff168154811061261b5761261b614961565b9060005260206000209060020201600101826020015165ffffffffffff168154811061264957612649614961565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156126875761268761424f565b60048111156126985761269861424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff1660028111156126d0576126d061424f565b60028111156126e1576126e161424f565b81528154602090910190600160b01b900460ff1660028111156127065761270661424f565b60028111156127175761271761424f565b81528154600160b81b90046001600160481b03166020820152600182015460408201526002820154606082015260039091015460809091015290508d8d8481811061276457612764614961565b905060200201358260600151146127aa578d8d8481811061278757612787614961565b9050602002013560405163124bad6360e31b8152600401610d9a91815260200190565b8b8b848181106127bc576127bc614961565b905060200201358863ffffffff1682608001516127d99190615427565b6001600160481b0316146128005760405163918e94c560e01b815260040160405180910390fd5b8763ffffffff168563ffffffff1614612874578463ffffffff1681608001516128299190615427565b6001600160481b03168c8c8581811061284457612844614961565b905060200201356128559190614b49565b84848151811061286757612867614961565b6020026020010181815250505b50506001016125d1565b506128a183858463ffffffff163060405180602001604052806000815250613af0565b6128be8787858f8660405180602001604052806000815250612945565b8463ffffffff168263ffffffff161461134257336001600160a01b0316632eb2c2d6308e8e8e866040518663ffffffff1660e01b8152600401612905959493929190615485565b600060405180830381600087803b15801561291f57600080fd5b505af1158015612933573d6000803e3d6000fd5b50505050505050505050505050505050565b8354600160c81b900461ffff16600114801561296757508163ffffffff166001145b15612b7d578354849060159061298990600160a81b900463ffffffff16615501565b91906101000a81548163ffffffff021916908363ffffffff1602179055506000600385600001601f9054906101000a900460ff1660ff1610612a6057845460405163d397371960e01b81526001600160a01b038681166004830152600160a81b90920463ffffffff16601889901b66ffffffff0000001617602482018190529189169063d3973719906044016020604051808303816000875af1158015612a34573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612a589190614e63565b915050612b31565b604051630525194b60e31b81526001600160a01b038581166004830152881690632928ca58906024016020604051808303816000875af1158015612aa8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612acc9190614e63565b6040805180820182526001600160e01b03808a168252885463ffffffff600160a81b909104811660208085019182526001600160a01b038e16600090815260068252868120888252909152949094209251935116600160e01b02921691909117905590505b8086886001600160a01b03167fa383afa3c54602b421e1ca976c247507e6cc6460855d62f8f8e632b2a38a33f4600186604051612b6f929190615524565b60405180910390a450612f73565b8354600090612b98908490600160c81b900461ffff16614e28565b63ffffffff16905061ffff811115612bc35760405163b4fa3fb360e01b815260040160405180910390fd5b8454600090612be090600160a81b900463ffffffff166001615543565b865463ffffffff918216925083918891601591612c07918591600160a81b90910416615543565b92506101000a81548163ffffffff021916908363ffffffff160217905550600386600001601f9054906101000a900460ff1660ff1610612de3576000826001600160401b03811115612c5b57612c5b61494b565b604051908082528060200260200182016040528015612c84578160200160208202803683370190505b50905060005b83811015612cee57612c9c8184614e50565b62ffffff1660188a66ffffffffffffff16901b1766ffffffffffffff16828281518110612ccb57612ccb614961565b69ffffffffffffffffffff90921660209283029190910190910152600101612c8a565b5060405163213c198760e11b81526000906001600160a01b038b1690634278330e90612d20908a908690600401615560565b6000604051808303816000875af1158015612d3f573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052612d6791908101906155c2565b905060005b84811015612ddb57818181518110612d8657612d86614961565b60200260200101518a8c6001600160a01b03167fa383afa3c54602b421e1ca976c247507e6cc6460855d62f8f8e632b2a38a33f460018a604051612dcb929190615524565b60405180910390a4600101612d6c565b505050610c4f565b60405163e00aab4b60e01b81526001600160a01b03868116600483015261ffff84166024830152600091908a169063e00aab4b906044016000604051808303816000875af1158015612e39573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052612e6191908101906155c2565b905060005b83811015611ef55760405180604001604052808a6001600160e01b031681526020018285612e949190614e50565b63ffffffff1690526001600160a01b038b1660009081526006602052604081208451909190859085908110612ecb57612ecb614961565b6020908102919091018101518252818101929092526040016000208251929091015163ffffffff16600160e01b026001600160e01b039092169190911790558151829082908110612f1e57612f1e614961565b6020026020010151898b6001600160a01b03167fa383afa3c54602b421e1ca976c247507e6cc6460855d62f8f8e632b2a38a33f4600189604051612f63929190615524565b60405180910390a4600101612e66565b505050505050565b6001600160a01b03841660009081526004602081815260408084208685529091529182902091516314765c6b60e01b81527370b4070953cdf0cf33d69322495df78a83b734e9926314765c6b92612fda92899289928992899101615647565b60006040518083038186803b158015612ff257600080fd5b505af4158015610c4f573d6000803e3d6000fd5b6060600061301383613e74565b60010190506000816001600160401b038111156130325761303261494b565b6040519080825280601f01601f19166020018201604052801561305c576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461306657509392505050565b60006130a4868661344a565b60018101546003820180549293506130d892600160601b9092046001600160a01b03169190600082611c8657611c86614961565b805460009061310f9063ffffffff600160d81b8204811691600160a81b81049091169061ffff600160c81b90910416886001613516565b905060008260030160008154811061312957613129614961565b9060005260206000209060020201600101858154811061314b5761314b614961565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff1660048111156131895761318961424f565b600481111561319a5761319a61424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff1660028111156131d2576131d261424f565b60028111156131e3576131e361424f565b81528154602090910190600160b01b900460ff1660028111156132085761320861424f565b60028111156132195761321961424f565b81528154600160b81b90046001600160481b0316602082015260018201546040820152600282015460608201526003909101546080918201528101519091506132699063ffffffff881690615427565b6001600160481b03168914613291576040516302075cc160e41b815260040160405180910390fd5b604051630e5597a560e31b81527370b4070953cdf0cf33d69322495df78a83b734e9906372acbd28906132ce90849033908f908a90600401614fb0565b60006040518083038186803b1580156132e657600080fd5b505af41580156132fa573d6000803e3d6000fd5b505050506133218130338d8663ffffffff1660405180602001604052806000815250613597565b61333e8888858e8660405180602001604052806000815250612945565b8563ffffffff168263ffffffff161461340857336001600160a01b031663f242432a308d8d8560800151878c613374919061567d565b63ffffffff166133849190615427565b6040516001600160e01b031960e087901b1681526001600160a01b03948516600482015293909216602484015260448301526001600160481b0316606482015260a06084820152600060a482015260c401600060405180830381600087803b1580156133ef57600080fd5b505af1158015613403573d6000803e3d6000fd5b505050505b5050505050505050505050565b60006001600160e01b03198216632a9f3abf60e11b148061053857506301ffc9a760e01b6001600160e01b0319831614610538565b600061345683836120ad565b60018101549091504265ffffffffffff90911611806134a557506001810154600160301b900465ffffffffffff1642108015906134a557506001810154600160301b900465ffffffffffff1615155b156105385760405163cbd1635360e01b815260048101839052602401610d9a565b831515806134d5575082600114155b806134e1575081600114155b806134f257506134f08161223a565b155b156135105760405163b4fa3fb360e01b815260040160405180910390fd5b50505050565b60008563ffffffff1660000361352d575081613568565b60008461353a878961567d565b613544919061569a565b90508363ffffffff168163ffffffff16111561356257839150613566565b8091505b505b818015613579575063ffffffff8116155b156105675760405163918e94c560e01b815260040160405180910390fd5b6002866040015160028111156135af576135af61424f565b036137dd5760008287608001516001600160481b03166135cf9190615403565b90506000876060015160028111156135e9576135e961424f565b0361365b57604051637921219560e11b81526001600160a01b0386169063f242432a9061362490899061dead908990879089906004016156bd565b600060405180830381600087803b15801561363e57600080fd5b505af1158015613652573d6000803e3d6000fd5b505050506137d7565b6001876060015160028111156136735761367361424f565b03613765576040805160018082528183019092526000916020808301908036833701905050905084816000815181106136ae576136ae614961565b602090810291909101015260408051600180825281830190925260009181602001602082028036833701905050905082816000815181106136f1576136f1614961565b6020908102919091010152604051633db0f8ab60e01b81526001600160a01b03881690633db0f8ab9061372c908b90869086906004016156f7565b600060405180830381600087803b15801561374657600080fd5b505af115801561375a573d6000803e3d6000fd5b5050505050506137d7565b60028760600151600281111561377d5761377d61424f565b036137be57604051637a94c56560e11b81526001600160a01b038781166004830152602482018690526044820183905286169063f5298aca90606401613624565b60405163cbdea8bd60e01b815260040160405180910390fd5b50612f73565b6001866040015160028111156137f5576137f561424f565b036139b3578160011461381b576040516302075cc160e41b815260040160405180910390fd5b6000866060015160028111156138335761383361424f565b036138a357604051635c46a7ef60e11b81526001600160a01b0385169063b88d4fde9061386c90889061dead908890879060040161572d565b600060405180830381600087803b15801561388657600080fd5b505af115801561389a573d6000803e3d6000fd5b50505050612f73565b6001866060015160028111156138bb576138bb61424f565b14806138dc57506002866060015160028111156138da576138da61424f565b145b156137be576001600160a01b0385163014613986576040516331a9108f60e11b8152600481018490526001600160a01b038087169190861690636352211e90602401602060405180830381865afa15801561393b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061395f9190615760565b6001600160a01b03161461398657604051637bf340bd60e11b815260040160405180910390fd5b604051630852cd8d60e31b8152600481018490526001600160a01b038516906342966c689060240161386c565b60405163c163a89360e01b815260040160405180910390fd5b60008181526001830160205260408120548015613ab55760006139f0600183614b49565b8554909150600090613a0490600190614b49565b9050818114613a69576000866000018281548110613a2457613a24614961565b9060005260206000200154905080876000018481548110613a4757613a47614961565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080613a7a57613a7a61577d565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610538565b6000915050610538565b5092915050565b6000826000018281548110613add57613add614961565b9060005260206000200154905092915050565b60038501546000906001600160401b03811115613b0f57613b0f61494b565b604051908082528060200260200182016040528015613b38578160200160208202803683370190505b50905060005b8551811015613da6576000868281518110613b5b57613b5b614961565b60200260200101519050600088600301826000015165ffffffffffff1681548110613b8857613b88614961565b9060005260206000209060020201600101826020015165ffffffffffff1681548110613bb657613bb6614961565b9060005260206000209060040201604051806101000160405290816000820160009054906101000a900460ff166004811115613bf457613bf461424f565b6004811115613c0557613c0561424f565b8152815461010081046001600160a01b03166020830152604090910190600160a81b900460ff166002811115613c3d57613c3d61424f565b6002811115613c4e57613c4e61424f565b81528154602090910190600160b01b900460ff166002811115613c7357613c7361424f565b6002811115613c8457613c8461424f565b81526020016000820160179054906101000a90046001600160481b03166001600160481b03166001600160481b03168152602001600182015481526020016002820154815260200160038201548152505090507370b4070953cdf0cf33d69322495df78a83b734e96372acbd28828460400151856060015186608001516040518563ffffffff1660e01b8152600401613d209493929190614fb0565b60006040518083038186803b158015613d3857600080fd5b505af4158015613d4c573d6000803e3d6000fd5b50505050613d668187846040015185606001518b8a613597565b8684836000015165ffffffffffff1681518110613d8557613d85614961565b60200260200101818151613d999190614e50565b9052505050600101613b3e565b5060005b8151811015610cdb5784876003018281548110613dc957613dc9614961565b906000526020600020906002020160000154613de59190615403565b828281518110613df757613df7614961565b602002602001015114613e1d576040516302075cc160e41b815260040160405180910390fd5b600101613daa565b6000818152600183016020526040812054613e6c57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610538565b506000610538565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b8310613eb35772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310613edf576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc100008310613efd57662386f26fc10000830492506010015b6305f5e1008310613f15576305f5e100830492506008015b6127108310613f2957612710830492506004015b60648310613f3b576064830492506002015b600a83106105385760010192915050565b6040805161016081019091526000808252602082019081526000602082018190526040820181905260608083018290526080830182905260a0830182905260c0830182905260e083019190915261010082018190526101209091015290565b600060208284031215613fbd57600080fd5b81356001600160e01b031981168114611f1f57600080fd5b6001600160a01b038116811461065257600080fd5b60008083601f840112613ffc57600080fd5b5081356001600160401b0381111561401357600080fd5b60208301915083602082850101111561402b57600080fd5b9250929050565b60008060008060006080868803121561404a57600080fd5b853561405581613fd5565b9450602086013561406581613fd5565b93506040860135925060608601356001600160401b0381111561408757600080fd5b61409388828901613fea565b969995985093965092949392505050565b6000602082840312156140b657600080fd5b8135611f1f81613fd5565b801515811461065257600080fd5b600080600080608085870312156140e557600080fd5b84356140f081613fd5565b93506020850135925060408501356001600160401b0381111561411257600080fd5b8501610120818803121561412557600080fd5b91506060850135614135816140c1565b939692955090935050565b6020808252825182820181905260009190848201906040850190845b818110156141815783516001600160a01b03168352928401929184019160010161415c565b50909695505050505050565b80356004811061419c57600080fd5b919050565b60008060008060008060a087890312156141ba57600080fd5b86356141c581613fd5565b9550602087013594506141da6040880161418d565b935060608701356001600160401b038111156141f557600080fd5b61420189828a01613fea565b9094509250506080870135614215816140c1565b809150509295509295509295565b6000806040838503121561423657600080fd5b823561424181613fd5565b946020939093013593505050565b634e487b7160e01b600052602160045260246000fd5b600481106142755761427561424f565b9052565b60005b8381101561429457818101518382015260200161427c565b50506000910152565b600081518084526142b5816020860160208601614279565b601f01601f19169290920160200192915050565b600581106142755761427561424f565b600381106106525761065261424f565b614275816142d9565b6142fd8282516142c9565b6020818101516001600160a01b031690830152604081015161431e816142d9565b60408301526060810151614331816142d9565b60608301526080818101516001600160481b03169083015260a0808201519083015260c0808201519083015260e090810151910152565b600081518084526020808501808196508360051b810191508286016000805b868110156143f8578385038a528251805186528601516040878701819052815190870181905290870190606087019084905b808210156143e3576143cc8385516142f2565b6101008301925089840193506001820191506143b9565b50509a87019a95505091850191600101614387565b509298975050505050505050565b80516001600160a01b031682526000610160602083015161442a6020860182614265565b506040830151614442604086018263ffffffff169052565b506060830151614458606086018261ffff169052565b506080830151614470608086018263ffffffff169052565b5060a083015161448560a086018260ff169052565b5060c083015161449f60c086018265ffffffffffff169052565b5060e08301516144b960e086018265ffffffffffff169052565b50610100838101516001600160a01b031690850152610120808401518186018390526144e78387018261429d565b925050506101408084015185830382870152611a5e8382614368565b82815260406020820152600061451c6040830184614406565b949350505050565b60008083601f84011261453657600080fd5b5081356001600160401b0381111561454d57600080fd5b6020830191508360208260051b850101111561402b57600080fd5b6000806000806000806000806080898b03121561458457600080fd5b88356001600160401b038082111561459b57600080fd5b6145a78c838d01614524565b909a50985060208b01359150808211156145c057600080fd5b6145cc8c838d01614524565b909850965060408b01359150808211156145e557600080fd5b6145f18c838d01614524565b909650945060608b013591508082111561460a57600080fd5b506146178b828c01614524565b999c989b5096995094979396929594505050565b803563ffffffff8116811461419c57600080fd5b600080600080600080600060a0888a03121561465a57600080fd5b873561466581613fd5565b96506020880135955061467a6040890161462b565b945060608801356001600160401b038082111561469657600080fd5b6146a28b838c01614524565b909650945060808a01359150808211156146bb57600080fd5b506146c88a828b01613fea565b989b979a50959850939692959293505050565b602081526000611f1f6020830184614406565b60008060008060008060008060a0898b03121561470a57600080fd5b883561471581613fd5565b9750602089013561472581613fd5565b965060408901356001600160401b038082111561474157600080fd5b61474d8c838d01614524565b909850965060608b013591508082111561476657600080fd5b6147728c838d01614524565b909650945060808b013591508082111561478b57600080fd5b506146178b828c01613fea565b600080600080600080608087890312156147b157600080fd5b86356147bc81613fd5565b95506020870135945060408701356001600160401b03808211156147df57600080fd5b6147eb8a838b01614524565b9096509450606089013591508082111561480457600080fd5b5061481189828a01614524565b979a9699509497509295939492505050565b60008060008060006080868803121561483b57600080fd5b853561484681613fd5565b94506020860135935061485b6040870161462b565b925060608601356001600160401b0381111561487657600080fd5b61409388828901614524565b602081526000611f1f602083018461429d565b6000806000606084860312156148aa57600080fd5b83356148b581613fd5565b92506020840135915060408401356148cc81613fd5565b809150509250925092565b60008060008060008060a087890312156148f057600080fd5b86356148fb81613fd5565b9550602087013561490b81613fd5565b9450604087013593506060870135925060808701356001600160401b0381111561493457600080fd5b61481189828a01613fea565b803561419c81613fd5565b634e487b7160e01b600052604160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60006001820161499f5761499f614977565b5060010190565b600181811c908216806149ba57607f821691505b6020821081036149da57634e487b7160e01b600052602260045260246000fd5b50919050565b601f82111561248457600081815260208120601f850160051c81016020861015614a075750805b601f850160051c820191505b81811015612f7357828155600101614a13565b6001600160401b03831115614a3d57614a3d61494b565b614a5183614a4b83546149a6565b836149e0565b6000601f841160018114614a855760008515614a6d5750838201355b600019600387901b1c1916600186901b1783556113a6565b600083815260209020601f19861690835b82811015614ab65786850135825560209485019460019092019101614a96565b5086821015614ad35760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b600060208284031215614af757600080fd5b611f1f8261462b565b6000808335601e19843603018112614b1757600080fd5b8301803591506001600160401b03821115614b3157600080fd5b6020019150600581901b360382131561402b57600080fd5b8181038181111561053857610538614977565b60208082526024908201527f41646d696e436f6e74726f6c3a204d757374206265206f776e6572206f7220616040820152633236b4b760e11b606082015260800190565b634e487b7160e01b600052601260045260246000fd5b600082614bc557614bc5614ba0565b500690565b60405160a081016001600160401b0381118282101715614bec57614bec61494b565b60405290565b604051601f8201601f191681016001600160401b0381118282101715614c1a57614c1a61494b565b604052919050565b60006001600160401b03821115614c3b57614c3b61494b565b5060051b60200190565b803565ffffffffffff8116811461419c57600080fd5b600082601f830112614c6c57600080fd5b81356020614c81614c7c83614c22565b614bf2565b82815260059290921b84018101918181019086841115614ca057600080fd5b8286015b84811015614cbb5780358352918301918301614ca4565b509695505050505050565b6000614cd4614c7c84614c22565b8381529050602080820190600585901b840186811115614cf357600080fd5b845b81811015614da05780356001600160401b0380821115614d155760008081fd5b9087019060a0828b031215614d2a5760008081fd5b614d32614bca565b614d3b83614c45565b8152614d48868401614c45565b86820152604080840135614d5b81613fd5565b908201526060838101359082015260808084013583811115614d7d5760008081fd5b614d898d828701614c5b565b918301919091525086525050928201928201614cf5565b505050509392505050565b60008060008060808587031215614dc157600080fd5b8435614dcc81613fd5565b935060208501359250614de16040860161462b565b915060608501356001600160401b03811115614dfc57600080fd5b8501601f81018713614e0d57600080fd5b614e1c87823560208401614cc6565b91505092959194509250565b63ffffffff818116838216028082169190828114614e4857614e48614977565b505092915050565b8082018082111561053857610538614977565b600060208284031215614e7557600080fd5b5051919050565b60008351614e8e818460208801614279565b835190830190614ea2818360208801614279565b01949350505050565b60008351614ebd818460208801614279565b602f60f81b9083019081528351614edb816001840160208801614279565b01600101949350505050565b600080600080600060a08688031215614eff57600080fd5b8535614f0a81613fd5565b945060208601359350614f1f6040870161462b565b92506060860135915060808601356001600160401b03811115614f4157600080fd5b614f4d88828901614c5b565b9150509295509295909350565b60008060008060808587031215614f7057600080fd5b8435614f7b81613fd5565b9350602085013592506040850135915060608501356001600160401b03811115614fa457600080fd5b614e1c87828801614c5b565b6000610160808301614fc284896142f2565b6001600160a01b038716610100850152610120840186905261014084019190915283519081905261018083019060209081860160005b8281101561501457815185529383019390830190600101614ff8565b50929998505050505050505050565b60006020828403121561503557600080fd5b8151611f1f816140c1565b803561ffff8116811461419c57600080fd5b6000808335601e1984360301811261506957600080fd5b83016020810192503590506001600160401b0381111561508857600080fd5b80360382131561402b57600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b6000808335601e198436030181126150d757600080fd5b83016020810192503590506001600160401b038111156150f657600080fd5b8060051b360382131561402b57600080fd5b80356003811061419c57600080fd5b80356001600160481b038116811461419c57600080fd5b81835260006020808501808196506005915085821b81018560005b8881101561529b578383038a528135603e1989360301811261516a57600080fd5b88018035845260408481018883013536849003601e1901811261518c57600080fd5b9092018881019290356001600160401b038111156151a957600080fd5b8060081b36038413156151bb57600080fd5b868a018390529081905260609081870160005b828110156152845785358b81106151e457600080fd5b6151ee83826142c9565b508b8601356151fc81613fd5565b6001600160a01b03168c830152615214868601615108565b615220868401826142e9565b5061522c848701615108565b615238858401826142e9565b506080615246818801615117565b6001600160481b03169083015260a0868101359083015260c0808701359083015260e0808701359083015261010095860195909101906001016151ce565b509d8a019d96505050928701925050600101615149565b509098975050505050505050565b60006101206152c8846152bb85614940565b6001600160a01b03169052565b6152d46020840161418d565b6152e16020860182614265565b506152ee60408401615040565b61ffff1660408501526153036060840161462b565b63ffffffff16606085015261531a60808401614c45565b65ffffffffffff16608085015261533360a08401614c45565b65ffffffffffff1660a085015261534c60c08401614940565b6001600160a01b031660c085015261536760e0840184615052565b8260e087015261537a8387018284615097565b9250505061010061538d818501856150c0565b8684038388015261539f84828461512e565b979650505050505050565b60018060a01b0385168152836020820152826040820152608060608201526000611a5e60808301846152a9565b6000602082840312156153e957600080fd5b815169ffffffffffffffffffff81168114611f1f57600080fd5b808202811582820484141761053857610538614977565b6000611f1f368484614cc6565b6001600160481b03818116838216028082169190828114614e4857614e48614977565b600081518084526020808501945080840160005b8381101561547a5781518752958201959082019060010161545e565b509495945050505050565b6001600160a01b0386811682528516602082015260a060408201819052810183905260006001600160fb1b038411156154bd57600080fd5b8360051b808660c0850137820182810360c090810160608501526154e39082018561544a565b83810360809094019390935250506000815260200195945050505050565b600063ffffffff80831681810361551a5761551a614977565b6001019392505050565b63ffffffff8316815260406020820152600061451c604083018461429d565b63ffffffff818116838216019080821115613abf57613abf614977565b6001600160a01b038316815260406020808301829052835191830182905260009184820191906060850190845b818110156155b557845169ffffffffffffffffffff168352938301939183019160010161558d565b5090979650505050505050565b600060208083850312156155d557600080fd5b82516001600160401b038111156155eb57600080fd5b8301601f810185136155fc57600080fd5b805161560a614c7c82614c22565b81815260059190911b8201830190838101908783111561562957600080fd5b928401925b8284101561539f5783518252928401929084019061562e565b60018060a01b038616815260ff8516602082015283604082015282606082015260a06080820152600061539f60a08301846152a9565b63ffffffff828116828216039080821115613abf57613abf614977565b600063ffffffff808416806156b1576156b1614ba0565b92169190910492915050565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061539f9083018461429d565b6001600160a01b038416815260606020820181905260009061571b9083018561544a565b8281036040840152611a5e818561544a565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090611a5e9083018461429d565b60006020828403121561577257600080fd5b8151611f1f81613fd5565b634e487b7160e01b600052603160045260246000fdfea2646970667358221220320f4da70366daeeadda7e2832204c849c554699074ffc851fd0e1e2a2a734bd64736f6c63430008110033

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

0000000000000000000000007ef0d682280193fb1fb8dc6174f8a0c5bc4f02b0

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

-----Encoded View---------------
1 Constructor Arguments found :
Arg [0] : 0000000000000000000000007ef0d682280193fb1fb8dc6174f8a0c5bc4f02b0


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.