Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

• Is this a proxy?
• Similar
• Submit Audit
• Compare

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.10;

import "./MechanicMintManagerClientUpgradeable.sol";
import "../../erc721/interfaces/IEditionCollection.sol";
import "../../erc721/interfaces/IERC721GeneralSupplyMetadata.sol";
import "../../observability/IGengineObservability.sol";
import "./interfaces/IManifold1155Burn.sol";

import { EnumerableSet } from "@openzeppelin/contracts/utils/structs/EnumerableSet.sol";
import "@openzeppelin/contracts/proxy/utils/UUPSUpgradeable.sol";
import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";

/**
 * @notice Ranked auctions
 * @author highlight.xyz
 */
contract RankedAuctionMechanic is MechanicMintManagerClientUpgradeable, UUPSUpgradeable {
    using EnumerableSet for EnumerableSet.UintSet;
    using EnumerableSet for EnumerableSet.Bytes32Set;

    /**
     * @notice Throw when an action is unauthorized
     */
    error Unauthorized();

    /**
     * @notice Throw when signer of signature is invalid
     */
    error InvalidSigner();

    /**
     * @notice Throw when it is invalid to mint on a vector
     */
    error InvalidMint();

    /**
     * @notice Throw when it is invalid to mint a number of tokens
     */
    error InvalidMintAmount();

    /**
     * @notice Throw when it is invalid to bid
     */
    error InvalidBid();

    /**
     * @notice Throw when a vector is already created with a mechanic vector ID
     */
    error VectorAlreadyCreated();

    /**
     * @notice Throw when the vector update is invalid
     */
    error InvalidUpdate();

    /**
     * @notice Throw when code gets into impossible state
     */
    error ImpossibleState();

    /**
     * @notice Throw when an internal transfer of ether fails
     */
    error EtherSendFailed();

    /**
     * @notice Throw when a claim is invalid
     */
    error InvalidClaim();

    /**
     * @notice Throw when a claim signature is invalid
     */
    error InvalidSignature();

    /**
     * @notice Errors to throw when adding / removing bids from user bid ids
     */
    error BidAlreadyAdded();
    error BidAlreadyReclaimed();

    /**
     * @notice On-chain mint vector (stored data)
     * @param startTimestamp When minting opens on vector
     * @param endTimestamp When minting ends on vector
     * @param paymentRecipient Payment recipient
     * @param maxUserClaimableViaVector Max number of tokens that can be minted by user via vector
     * @param maxTotalClaimableViaVector Max number of tokens that can be minted via vector
     * @param latestBidId Total number of bids (valid or invalid, deleted or not)
     * @param currency Currency used for payment. Native gas token, if zero address
     * @param bidFundsClaimed Bid funds claimed
     * @param reserveBid Reserve bid
     * @param maxEndTimestamp Maximium time the auction can go till (given extensions)
     * @param actionId Action ID (create / update bid)
     */
    struct Vector {
        uint48 startTimestamp;
        uint48 endTimestamp;
        address payable paymentRecipient;
        uint32 maxUserClaimableViaVector;
        uint32 maxTotalClaimableViaVector;
        uint32 latestBidId;
        address currency;
        bool bidFundsClaimed;
        uint96 reserveBid;
        uint48 maxEndTimestamp;
        uint96 actionId;
    }

    /**
     * @notice Bid
     * @dev Only handles bids below ~10B ether
     * @param bidAmount Amount of bid
     * @param bidder Bidder
     */
    struct Bid {
        uint96 bidAmount;
        address bidder;
    }

    /**
     * @notice User bids' metadata
     * @param numClaimed Number of valid bids redeemed for a token (after mint ends)
     * @param numBids Number of bids by user
     */
    struct UserBidsMetadata {
        uint32 numClaimed;
        uint32 numBids;
    }

    /**
     * @notice Config used to control updating of fields in Vector
     */
    struct VectorUpdateConfig {
        bool updateStartTimestamp;
        bool updateEndTimestamp;
        bool updateMaxEndTimestamp;
        bool updateMaxUserClaimableViaVector;
        bool updateMaxTotalClaimableViaVector;
        bool updatePaymentRecipient;
        bool updateCurrency;
        bool updateReserveBid;
    }

    /**
     * @notice Used to claim funds from an invalid bid, mint tokens + claim rebate if eligible, claim auction earnings
     */
    struct RankedAuctionsClaim {
        bytes32 mechanicVectorId;
        uint256 rebateAmount;
        address claimer;
        uint32 claimerNumValidBids;
        uint48 claimExpiryTimestamp;
        uint256 cumulativeBidAmount;
        uint32 bidId;
        uint8 claimType;
    }

    /**
     * @notice Constants that help with EIP-712, signature based minting
     */
    bytes32 private constant _DOMAIN_TYPEHASH =
        keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract,bytes32 salt)");

    /* solhint-disable max-line-length */
    bytes32 private constant _CLAIM_TYPEHASH =
        keccak256(
            "RankedAuctionsClaim(bytes32 mechanicVectorId,uint256 rebateAmount,address claimer,uint32 claimerNumValidBids,uint48 claimExpiryTimestamp,uint256 cumulativeBidAmount,uint32 bidId,uint8 claimType)"
        );
    /* solhint-enable max-line-length */

    /**
     * @notice Stores seed based vector, indexed by global mechanic vector id
     */
    mapping(bytes32 => Vector) private vector;

    /**
     * @notice Stores vector's current validity hash
     */
    mapping(bytes32 => bytes32) private vectorValidityHash;

    /**
     * @notice System-wide vector ids to bids by their ids
     */
    mapping(bytes32 => mapping(uint32 => Bid)) public bids;

    /**
     * @notice System-wide vector ids to user's bids metadata
     */
    mapping(bytes32 => mapping(address => UserBidsMetadata)) private _userBidsMetadata;

    /**
     * @notice System-wide vector ids to user's bid ids
     */
    mapping(bytes32 => mapping(address => EnumerableSet.UintSet)) private _userBidIds;

    /**
     * @notice System-wide used claims
     */
    mapping(bytes32 => EnumerableSet.Bytes32Set) private _usedClaims;

    /**
     * @notice Emitted when a mint vector is created
     */
    event RankedAuctionCreated(bytes32 indexed mechanicVectorId);

    /**
     * @notice Emitted when a mint vector is updated
     */
    event RankedAuctionUpdated(bytes32 indexed mechanicVectorId);

    /**
     * @notice Emitted when a bid is created or updated
     */
    event BidCreatedOrUpdated(
        bytes32 indexed mechanicVectorId,
        bytes32 indexed newValidityHash,
        uint96 indexed actionId,
        uint32 bidId,
        address bidder,
        uint96 bidAmount,
        address currency,
        bool created
    );

    /**
     * @notice Emitted when bid funds are reclaimed
     */
    event BidReclaimed(bytes32 indexed mechanicVectorId, uint32 indexed bidId, uint96 amount, address currency);

    /**
     * @notice Emitted when bid funds are claimed
     */
    event AuctionEarningsClaimed(
        bytes32 indexed mechanicVectorId,
        uint256 earnings,
        address paymentRecipient,
        address currency
    );

    /**
     * @notice Emitted when auction is lengthened
     */
    event AuctionLengthened(bytes32 indexed mechanicVectorId, uint48 newEndTimestamp);

    /**
     * @notice Initialize mechanic contract
     * @param _mintManager Mint manager address
     * @param platform Platform owning the contract
     */
    function initialize(address _mintManager, address platform) external initializer {
        __MechanicMintManagerClientUpgradeable_initialize(_mintManager, platform);
    }

    /**
     * @notice Create a seed based vector
     * @param mechanicVectorId Global mechanic vector ID
     * @param vectorData Vector data, to be deserialized into seed based vector data
     */
    function createVector(bytes32 mechanicVectorId, bytes memory vectorData) external onlyMintManager {
        // precaution, although MintManager tightly controls creation and prevents double creation
        if (vector[mechanicVectorId].startTimestamp != 0) {
            _revert(VectorAlreadyCreated.selector);
        }
        (
            uint48 startTimestamp,
            uint48 endTimestamp,
            uint48 maxEndTimestamp,
            address paymentRecipient,
            uint32 maxUserClaimableViaVector,
            uint32 maxTotalClaimableViaVector,
            uint96 reserveBid,
            address currency
        ) = abi.decode(vectorData, (uint48, uint48, uint48, address, uint32, uint32, uint96, address));

        if (maxTotalClaimableViaVector == 0) {
            _revert(InvalidUpdate.selector);
        }

        uint48 st = startTimestamp == 0 ? uint48(block.timestamp) : startTimestamp;
        Vector memory _vector = Vector(
            st,
            endTimestamp == 0 ? uint48(st + 604800) : endTimestamp, // arbitrarily set for a week
            payable(paymentRecipient),
            maxUserClaimableViaVector,
            maxTotalClaimableViaVector,
            0,
            currency,
            false,
            reserveBid,
            maxEndTimestamp,
            0
        );

        vector[mechanicVectorId] = _vector;

        emit RankedAuctionCreated(mechanicVectorId);
    }

    /* solhint-disable code-complexity */
    /**
     * @notice Update a seed based vector
     * @param mechanicVectorId Global mechanic vector ID
     * @param newVector New vector fields
     * @param updateConfig Config denoting what fields on vector to update
     */
    function updateVector(
        bytes32 mechanicVectorId,
        Vector calldata newVector,
        VectorUpdateConfig calldata updateConfig
    ) external {
        MechanicVectorMetadata memory metadata = _getMechanicVectorMetadata(mechanicVectorId);
        if (
            OwnableUpgradeable(metadata.contractAddress).owner() != msg.sender && metadata.contractAddress != msg.sender
        ) {
            _revert(Unauthorized.selector);
        }

        // rather than updating entire vector, update per-field
        if (updateConfig.updateStartTimestamp) {
            vector[mechanicVectorId].startTimestamp = newVector.startTimestamp == 0
                ? uint48(block.timestamp)
                : newVector.startTimestamp;
        }
        if (updateConfig.updateEndTimestamp) {
            if (newVector.endTimestamp == 0) {
                _revert(InvalidUpdate.selector);
            }
            vector[mechanicVectorId].endTimestamp = newVector.endTimestamp;
        }
        if (updateConfig.updateMaxEndTimestamp) {
            if (newVector.maxEndTimestamp == 0) {
                _revert(InvalidUpdate.selector);
            }
            vector[mechanicVectorId].maxEndTimestamp = newVector.maxEndTimestamp;
        }
        if (updateConfig.updateMaxUserClaimableViaVector) {
            vector[mechanicVectorId].maxUserClaimableViaVector = newVector.maxUserClaimableViaVector;
        }
        if (updateConfig.updateMaxTotalClaimableViaVector) {
            if (
                newVector.maxTotalClaimableViaVector == 0 ||
                newVector.maxTotalClaimableViaVector < vector[mechanicVectorId].maxTotalClaimableViaVector
            ) {
                _revert(InvalidUpdate.selector);
            }
            vector[mechanicVectorId].maxTotalClaimableViaVector = newVector.maxTotalClaimableViaVector;
        }
        if (updateConfig.updateCurrency) {
            if (vector[mechanicVectorId].latestBidId > 0) {
                _revert(InvalidUpdate.selector);
            }
            vector[mechanicVectorId].currency = newVector.currency;
        }
        if (updateConfig.updatePaymentRecipient) {
            vector[mechanicVectorId].paymentRecipient = newVector.paymentRecipient;
        }
        if (updateConfig.updateReserveBid) {
            if (vector[mechanicVectorId].latestBidId > 0) {
                _revert(InvalidUpdate.selector);
            }
            vector[mechanicVectorId].reserveBid = newVector.reserveBid;
        }

        emit RankedAuctionUpdated(mechanicVectorId);
    }

    /**
     * @notice Create a new bid
     */
    function bid(bytes32 mechanicVectorId, uint96 bidAmount) external payable {
        Vector memory _vector = vector[mechanicVectorId];
        uint32 newUserNumBids = _userBidsMetadata[mechanicVectorId][msg.sender].numBids + 1;
        if (
            _vector.endTimestamp < uint48(block.timestamp) ||
            _vector.startTimestamp > uint48(block.timestamp) ||
            bidAmount < _vector.reserveBid ||
            bidAmount != msg.value ||
            (_vector.maxUserClaimableViaVector != 0 && newUserNumBids > uint256(_vector.maxUserClaimableViaVector))
        ) {
            _revert(InvalidBid.selector);
        }

        _vector.latestBidId += 1;
        _vector.actionId += 1;

        bids[mechanicVectorId][_vector.latestBidId] = Bid(bidAmount, msg.sender);
        if (!_userBidIds[mechanicVectorId][msg.sender].add(uint256(_vector.latestBidId))) {
            // impossible state
            _revert(BidAlreadyAdded.selector);
        }
        _userBidsMetadata[mechanicVectorId][msg.sender].numBids = newUserNumBids;
        vector[mechanicVectorId].latestBidId = _vector.latestBidId;
        vector[mechanicVectorId].actionId = _vector.actionId;

        if (_vector.endTimestamp - uint48(block.timestamp) <= 300) {
            _vector.endTimestamp = _vector.maxEndTimestamp != 0
                ? (
                    _vector.maxEndTimestamp > uint48(block.timestamp) + 300
                        ? uint48(block.timestamp) + 300
                        : _vector.maxEndTimestamp
                )
                : uint48(block.timestamp) + 300;
            vector[mechanicVectorId].endTimestamp = _vector.endTimestamp;
            emit AuctionLengthened(mechanicVectorId, _vector.endTimestamp);
        }

        bytes32 newValidityHash = _updateValidityHash(mechanicVectorId, _vector.latestBidId, bidAmount);

        emit BidCreatedOrUpdated(
            mechanicVectorId,
            newValidityHash,
            _vector.actionId,
            _vector.latestBidId,
            msg.sender,
            bidAmount,
            _vector.currency,
            true
        );
    }

    /**
     * @notice Update a bid
     */
    function updateBid(bytes32 mechanicVectorId, uint32 bidId, uint96 newBidAmount) external payable {
        Vector memory _vector = vector[mechanicVectorId];
        Bid memory _bid = bids[mechanicVectorId][bidId];
        if (
            newBidAmount <= _bid.bidAmount ||
            _bid.bidder == address(0) ||
            _vector.endTimestamp < uint48(block.timestamp) ||
            _vector.startTimestamp > uint48(block.timestamp) ||
            newBidAmount < _vector.reserveBid ||
            msg.value != newBidAmount - _bid.bidAmount
        ) {
            _revert(InvalidBid.selector);
        }
        if (_bid.bidder != msg.sender) {
            _revert(Unauthorized.selector);
        }

        _vector.actionId += 1;

        bids[mechanicVectorId][bidId].bidAmount = newBidAmount;
        vector[mechanicVectorId].actionId = _vector.actionId;

        if (_vector.endTimestamp - uint48(block.timestamp) <= 300) {
            uint48 newEndTimestamp = _vector.maxEndTimestamp != 0
                ? (
                    _vector.maxEndTimestamp > uint48(block.timestamp) + 300
                        ? uint48(block.timestamp) + 300
                        : _vector.maxEndTimestamp
                )
                : uint48(block.timestamp) + 300;
            vector[mechanicVectorId].endTimestamp = newEndTimestamp;
            emit AuctionLengthened(mechanicVectorId, newEndTimestamp);
        }

        bytes32 newValidityHash = _updateValidityHash(mechanicVectorId, bidId, newBidAmount);

        emit BidCreatedOrUpdated(
            mechanicVectorId,
            newValidityHash,
            _vector.actionId,
            bidId,
            msg.sender,
            newBidAmount,
            _vector.currency,
            false
        );
    }

    /**
     * @notice Claim back funds for a bid that is currently invalid (effectively deleting the bid)
     */
    function reclaimBid(RankedAuctionsClaim calldata claim, bytes calldata claimSignature) external {
        // validate signature
        _validateClaim(claim, msg.sender, 1, claimSignature);

        Bid memory _bid = bids[claim.mechanicVectorId][claim.bidId];
        if (_bid.bidder != claim.claimer) {
            _revert(Unauthorized.selector);
        }

        _sendEther(_bid.bidAmount, payable(_bid.bidder));

        emit BidReclaimed(claim.mechanicVectorId, claim.bidId, _bid.bidAmount, vector[claim.mechanicVectorId].currency);

        // remove bid
        _userBidsMetadata[claim.mechanicVectorId][claim.claimer].numBids -= 1;
        if (!_userBidIds[claim.mechanicVectorId][claim.claimer].remove(claim.bidId)) {
            _revert(BidAlreadyReclaimed.selector);
        }
        delete bids[claim.mechanicVectorId][claim.bidId];
    }

    /**
     * @notice Withdraw auction earnings to payment recipient
     */
    function withdrawAuctionEarnings(RankedAuctionsClaim calldata claim, bytes calldata claimSignature) external {
        _validateClaim(claim, msg.sender, 2, claimSignature);

        Vector memory _vector = vector[claim.mechanicVectorId];
        // currently, only native gas token supported
        if (
            uint48(block.timestamp) <= _vector.endTimestamp || _vector.currency != address(0) || _vector.bidFundsClaimed
        ) {
            _revert(InvalidClaim.selector);
        }

        // 5% to platform
        uint256 platformAmount = (claim.cumulativeBidAmount * 500) / 10000;
        _sendEther(platformAmount, payable(owner()));
        _sendEther(claim.cumulativeBidAmount - platformAmount, _vector.paymentRecipient);

        vector[claim.mechanicVectorId].bidFundsClaimed = true;

        emit AuctionEarningsClaimed(
            claim.mechanicVectorId,
            claim.cumulativeBidAmount,
            _vector.paymentRecipient,
            _vector.currency
        );
    }

    /**
     * @notice See {IMechanic-processNumMint}
     */
    function processNumMint(
        bytes32 mechanicVectorId,
        address recipient,
        uint32 numToMint,
        address minter,
        MechanicVectorMetadata calldata mechanicVectorMetadata,
        bytes calldata data
    ) external payable onlyMintManager {
        _processMint(mechanicVectorId, minter, numToMint, data);
    }

    /**
     * @notice See {IMechanic-processChooseMint}
     */
    function processChooseMint(
        bytes32 mechanicVectorId,
        address recipient,
        uint256[] calldata tokenIds,
        address minter,
        MechanicVectorMetadata calldata mechanicVectorMetadata,
        bytes calldata data
    ) external payable onlyMintManager {
        // currently we don't support "choose token to mint" functionality for seed based mints
        _revert(InvalidMint.selector);
    }

    /**
     * @notice State readers
     */
    function getRawVector(bytes32 mechanicVectorId) external view returns (Vector memory _vector) {
        _vector = vector[mechanicVectorId];
    }

    function getVectorState(
        bytes32 mechanicVectorId
    )
        external
        view
        returns (Vector memory _vector, bytes32 validityHash, uint256 collectionSupply, uint256 collectionSize)
    {
        _vector = vector[mechanicVectorId];
        validityHash = vectorValidityHash[mechanicVectorId];
        (collectionSupply, collectionSize) = _collectionSupplyAndSize(mechanicVectorId);
    }

    function getBids(bytes32 mechanicVectorId, uint32[] calldata bidIds) external view returns (Bid[] memory) {
        uint256 bidIdsLength = bidIds.length;
        Bid[] memory _bids = new Bid[](bidIdsLength);
        for (uint256 i = 0; i < bidIdsLength; i++) {
            Bid memory _tempBid = bids[mechanicVectorId][bidIds[i]];
            _bids[i] = _tempBid;
        }
        return _bids;
    }

    function getUserBids(
        bytes32 mechanicVectorId,
        address user
    ) external view returns (Bid[] memory, uint256[] memory bidIds, uint32 numBids, uint32 numClaimed) {
        UserBidsMetadata memory metadata = _userBidsMetadata[mechanicVectorId][user];

        uint256[] memory _bidIds = _userBidIds[mechanicVectorId][user].values();
        uint256 bidIdsLength = _bidIds.length;
        Bid[] memory _bids = new Bid[](bidIdsLength);

        for (uint256 i = 0; i < bidIdsLength; i++) {
            Bid memory _tempBid = bids[mechanicVectorId][uint32(_bidIds[i])];
            _bids[i] = _tempBid;
        }

        return (_bids, _bidIds, metadata.numBids, metadata.numClaimed);
    }

    /* solhint-disable no-empty-blocks */
    /**
     * @notice Limit upgrades of contract to SeedBasedMintMechanic owner
     * @param // New implementation address
     */
    function _authorizeUpgrade(address) internal override onlyOwner {}

    /**
     * @notice Process sequential mint logic
     * @param mechanicVectorId Mechanic vector ID
     * @param minter Minter
     * @param numToMint Number of tokens to mint
     * @param data Mechanic mint data (signature)
     */
    function _processMint(bytes32 mechanicVectorId, address minter, uint32 numToMint, bytes calldata data) private {
        (RankedAuctionsClaim memory _claim, bytes memory claimSignature) = _unwrapRankedAuctionClaim(
            mechanicVectorId,
            data
        );

        _validateClaim(_claim, minter, 3, claimSignature);

        if (vector[mechanicVectorId].endTimestamp >= uint48(block.timestamp)) {
            _revert(InvalidMint.selector);
        }
        uint32 numClaimed = _userBidsMetadata[mechanicVectorId][minter].numClaimed;
        if (numToMint + numClaimed > _claim.claimerNumValidBids) {
            _revert(InvalidMintAmount.selector);
        }
        _userBidsMetadata[mechanicVectorId][minter].numClaimed = numClaimed + numToMint;

        // handle rebate
        if (_claim.rebateAmount > 0) {
            _sendEther(_claim.rebateAmount, payable(_claim.claimer));
        }
    }

    /**
     * @notice Send ether to a recipient
     */
    function _sendEther(uint256 amount, address payable recipient) private {
        (bool sent, ) = recipient.call{ value: amount }("");
        if (!sent) {
            _revert(EtherSendFailed.selector);
        }
    }

    /**
     * @notice Update vector's validity hash
     */
    function _updateValidityHash(bytes32 mechanicVectorId, uint32 bidId, uint96 bidAmount) private returns (bytes32) {
        bytes32 newValidityHash = keccak256(
            abi.encodePacked(vectorValidityHash[mechanicVectorId], mechanicVectorId, bidId, bidAmount)
        );
        vectorValidityHash[mechanicVectorId] = newValidityHash;
        return newValidityHash;
    }

    /**
     * @notice Validate claim
     * @param claim Claim
     * @param expectedClaimer Expected claimer
     * @param expectedClaimType Expected claim type
     * @param claimSignature Claim signature
     */
    function _validateClaim(
        RankedAuctionsClaim memory claim,
        address expectedClaimer,
        uint8 expectedClaimType,
        bytes memory claimSignature
    ) private {
        if (claim.claimer != expectedClaimer) {
            _revert(Unauthorized.selector);
        }
        if (claim.claimType != expectedClaimType) {
            _revert(InvalidClaim.selector);
        }
        bytes32 claimId = keccak256(
            abi.encode(
                _CLAIM_TYPEHASH,
                claim.mechanicVectorId,
                claim.rebateAmount,
                claim.claimer,
                claim.claimerNumValidBids,
                claim.claimExpiryTimestamp,
                claim.cumulativeBidAmount,
                claim.bidId,
                claim.claimType
            )
        );
        bytes32 digest = keccak256(abi.encodePacked("\x19\x01", _getDomainSeperator(), claimId));

        address signer = ECDSA.recover(digest, claimSignature);
        if (
            signer == address(0) || !_isPlatformExecutor(signer) || uint48(block.timestamp) > claim.claimExpiryTimestamp
        ) {
            _revert(InvalidSignature.selector);
        }
        if (!_usedClaims[claim.mechanicVectorId].add(claimId)) {
            // claim already used
            _revert(InvalidClaim.selector);
        }
    }

    /**
     * @notice Validate mint claim
     * @param mechanicVectorId Mechanic vector id
     * @param data Mint data
     */
    function _unwrapRankedAuctionClaim(
        bytes32 mechanicVectorId,
        bytes calldata data
    ) private returns (RankedAuctionsClaim memory, bytes memory) {
        (
            uint256 rebateAmount,
            address claimer,
            uint32 claimerNumValidBids,
            uint48 claimExpiryTimestamp,
            uint256 cumulativeBidAmount,
            uint32 bidId,
            uint8 claimType,
            bytes memory claimSignature
        ) = abi.decode(data, (uint256, address, uint32, uint48, uint256, uint32, uint8, bytes));

        return (
            RankedAuctionsClaim(
                mechanicVectorId,
                rebateAmount,
                claimer,
                claimerNumValidBids,
                claimExpiryTimestamp,
                cumulativeBidAmount,
                bidId,
                claimType
            ),
            claimSignature
        );
    }

    /**
     * @notice Returns a collection's current supply
     * @param mechanicVectorId Mechanic vector ID
     */
    function _collectionSupplyAndSize(bytes32 mechanicVectorId) private view returns (uint256 supply, uint256 size) {
        MechanicVectorMetadata memory metadata = _getMechanicVectorMetadata(mechanicVectorId);
        if (metadata.contractAddress == address(0)) {
            revert("Vector doesn't exist");
        }
        if (metadata.isEditionBased) {
            IEditionCollection.EditionDetails memory edition = IEditionCollection(metadata.contractAddress)
                .getEditionDetails(metadata.editionId);
            supply = edition.supply;
            size = edition.size;
        } else {
            // supply holds a tighter constraint (no burns), some old contracts don't have it
            try IERC721GeneralSupplyMetadata(metadata.contractAddress).supply() returns (uint256 _supply) {
                supply = _supply;
            } catch {
                supply = IERC721GeneralSupplyMetadata(metadata.contractAddress).totalSupply();
            }
            size = IERC721GeneralSupplyMetadata(metadata.contractAddress).limitSupply();
        }
    }

    /**
     * @notice Return EIP712 domain seperator
     */
    function _getDomainSeperator() private view returns (bytes32) {
        return
            keccak256(
                abi.encode(
                    _DOMAIN_TYPEHASH,
                    keccak256("RankedAuctionMechanic"),
                    keccak256("1"),
                    block.chainid,
                    address(this),
                    0x960bb3ecd14c38754109e5fe3a3b72aa0434091106c0fea200392fd413d44da0 // ranked auction mechanic salt
                )
            );
    }
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.10;

/**
 * @title IGengineObservability
 * @author highlight.xyz
 * @notice Interface to interact with the Highlight Gengine observability singleton
 * @dev Singleton to coalesce select Highlight Gengine protocol events
 */
interface IGengineObservability {
    /**
     * @notice Emitted when contract metadata is set
     * @param contractAddress Initial contract that emitted event
     * @param name New name
     * @param symbol New symbol
     * @param contractURI New contract uri
     */
    event ContractMetadataSet(address indexed contractAddress, string name, string symbol, string contractURI);

    /**
     * @notice Emitted when limit supply is set
     * @param contractAddress Initial contract that emitted event
     * @param newLimitSupply Limit supply to set
     */
    event LimitSupplySet(address indexed contractAddress, uint256 indexed newLimitSupply);

    /**
     * @notice Emits when a series collection has its base uri set
     * @param contractAddress Contract with updated base uri
     * @param newBaseUri New base uri
     */
    event BaseUriSet(address indexed contractAddress, string newBaseUri);

    /**************************
      Deployment events
     **************************/

    /**
     * @notice Emitted when Generative Series contract is deployed
     * @param deployer Contract deployer
     * @param contractAddress Address of contract that was deployed
     */
    event GenerativeSeriesDeployed(address indexed deployer, address indexed contractAddress);

    /**
     * @notice Emitted when Series contract is deployed
     * @param deployer Contract deployer
     * @param contractAddress Address of contract that was deployed
     */
    event SeriesDeployed(address indexed deployer, address indexed contractAddress);

    /**************************
      ERC721 events
     **************************/

    /**
     * @notice Emitted on a mint where a number of tokens are minted
     * @param contractAddress Address of contract being minted on
     * @param numMinted Number of tokens minted
     */
    event TokenMint(address indexed contractAddress, address indexed to, uint256 indexed numMinted);

    /**
     * @notice Emitted whenever the metadata for the token is updated
     * @param contractAddress NFT contract token resides on
     * @param tokenId Token being updated
     */
    event TokenUpdated(address indexed contractAddress, uint256 indexed tokenId);

    /**
     * @notice Emitted when `tokenId` token is transferred from `from` to `to` on contractAddress
     * @param contractAddress NFT contract token resides on
     * @param from Token sender
     * @param to Token receiver
     * @param tokenId Token being sent
     */
    event Transfer(address indexed contractAddress, address indexed from, address to, uint256 indexed tokenId);

    /**
     * @notice Emitted for the seed based data on mint
     * @param sender contract emitting the event
     * @param contractAddress NFT contract token resides on
     * @param data custom mint data
     */
    event CustomMintData(address indexed sender, address indexed contractAddress, bytes data);

    /**
     * @notice Emitted to regenerate the generative art for a token
     * @param sender contract emitting the event
     * @param collection NFT contract token resides on
     * @param tokenId Token ID
     */
    event HighlightRegenerate(address indexed sender, address indexed collection, uint256 indexed tokenId);

    /**
     * @notice Emit ContractMetadataSet
     */
    function emitContractMetadataSet(
        string calldata name,
        string calldata symbol,
        string calldata contractURI
    ) external;

    /**
     * @notice Emit LimitSupplySet
     */
    function emitLimitSupplySet(uint256 newLimitSupply) external;

    /**
     * @notice Emit BaseUriSet
     */
    function emitBaseUriSet(string calldata newBaseUri) external;

    /**
     * @notice Emit GenerativeSeriesDeployed
     */
    function emitGenerativeSeriesDeployed(address contractAddress) external;

    /**
     * @notice Emit SeriesDeployed
     */
    function emitSeriesDeployed(address contractAddress) external;

    /**
     * @notice Emit Token Mint
     */
    function emitTokenMint(address to, uint256 numMinted) external;

    /**
     * @notice Emit Token Updated
     */
    function emitTokenUpdated(address contractAddress, uint256 tokenId) external;

    /**
     * @notice Emit Transfer
     */
    function emitTransfer(address from, address to, uint256 tokenId) external;

    /**
     * @notice Emit Custom Mint Data
     */
    function emitCustomMintData(address contractAddress, bytes calldata data) external;

    /**
     * @notice Emit HighlightRegenerate
     */
    function emitHighlightRegenerate(address collection, uint256 tokenId) external;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.10;

import { OwnableUpgradeable } from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
import "./interfaces/IMechanic.sol";
import "./interfaces/IMechanicMintManagerView.sol";

/**
 * @notice MintManager client, to be used by mechanic contracts
 * @author highlight.xyz
 */
abstract contract MechanicMintManagerClientUpgradeable is OwnableUpgradeable, IMechanic {
    /**
     * @notice Throw when caller is not MintManager
     */
    error NotMintManager();

    /**
     * @notice Throw when input mint manager is invalid
     */
    error InvalidMintManager();

    /**
     * @notice Mint manager
     */
    address public mintManager;

    /**
     * @notice Enforce caller to be mint manager
     */
    modifier onlyMintManager() {
        if (msg.sender != mintManager) {
            _revert(NotMintManager.selector);
        }
        _;
    }

    /**
     * @notice Update the mint manager
     * @param _mintManager New mint manager
     */
    function updateMintManager(address _mintManager) external onlyOwner {
        if (_mintManager == address(0)) {
            _revert(InvalidMintManager.selector);
        }

        mintManager = _mintManager;
    }

    /**
     * @notice Initialize mechanic mint manager client
     * @param _mintManager Mint manager address
     * @param platform Platform owning the contract
     */
    function __MechanicMintManagerClientUpgradeable_initialize(
        address _mintManager,
        address platform
    ) internal onlyInitializing {
        __Ownable_init();
        mintManager = _mintManager;
        _transferOwnership(platform);
    }

    /**
     * @notice Get a mechanic mint vector's metadata
     * @param mechanicVectorId Mechanic vector ID
     */
    function _getMechanicVectorMetadata(
        bytes32 mechanicVectorId
    ) internal view returns (MechanicVectorMetadata memory) {
        return IMechanicMintManagerView(mintManager).mechanicVectorMetadata(mechanicVectorId);
    }

    function _isPlatformExecutor(address _executor) internal view returns (bool) {
        return IMechanicMintManagerView(mintManager).isPlatformExecutor(_executor);
    }

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

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.10;

/**
 * @notice Interface to burn tokens on a Manifold 1155 Creator contract
 */
interface IManifold1155Burn {
    function burn(address account, uint256[] memory tokenIds, uint256[] memory amounts) external;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.10;

/**
 * @notice Get a Series based collection's supply metadata
 * @author highlight.xyz
 */
interface IERC721GeneralSupplyMetadata {
    /**
     * @notice Get a series based collection's supply, burned tokens notwithstanding
     */
    function supply() external view returns (uint256);

    /**
     * @notice Get a series based collection's total supply
     */
    function totalSupply() external view returns (uint256);

    /**
     * @notice Get a series based collection's supply cap
     */
    function limitSupply() external view returns (uint256);
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.10;

/**
 * @notice Interfaces with the details of editions on collections
 * @author highlight.xyz
 */
interface IEditionCollection {
    /**
     * @notice Edition details
     * @param name Edition name
     * @param size Edition size
     * @param supply Total number of tokens minted on edition
     * @param initialTokenId Token id of first token minted in edition
     */
    struct EditionDetails {
        string name;
        uint256 size;
        uint256 supply;
        uint256 initialTokenId;
    }

    /**
     * @notice Get the edition a token belongs to
     * @param tokenId The token id of the token
     */
    function getEditionId(uint256 tokenId) external view returns (uint256);

    /**
     * @notice Get an edition's details
     * @param editionId Edition id
     */
    function getEditionDetails(uint256 editionId) external view returns (EditionDetails memory);

    /**
     * @notice Get the details and uris of a number of editions
     * @param editionIds List of editions to get info for
     */
    function getEditionsDetailsAndUri(
        uint256[] calldata editionIds
    ) external view returns (EditionDetails[] memory, string[] memory uris);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)

pragma solidity ^0.8.0;

import "../Strings.sol";

/**
 * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
 *
 * These functions can be used to verify that a message was signed by the holder
 * of the private keys of a given address.
 */
library ECDSA {
    enum RecoverError {
        NoError,
        InvalidSignature,
        InvalidSignatureLength,
        InvalidSignatureS,
        InvalidSignatureV // Deprecated in v4.8
    }

    function _throwError(RecoverError error) private pure {
        if (error == RecoverError.NoError) {
            return; // no error: do nothing
        } else if (error == RecoverError.InvalidSignature) {
            revert("ECDSA: invalid signature");
        } else if (error == RecoverError.InvalidSignatureLength) {
            revert("ECDSA: invalid signature length");
        } else if (error == RecoverError.InvalidSignatureS) {
            revert("ECDSA: invalid signature 's' value");
        }
    }

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with
     * `signature` or error string. This address can then be used for verification purposes.
     *
     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
     * this function rejects them by requiring the `s` value to be in the lower
     * half order, and the `v` value to be either 27 or 28.
     *
     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
     * verification to be secure: it is possible to craft signatures that
     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
     * this is by receiving a hash of the original message (which may otherwise
     * be too long), and then calling {toEthSignedMessageHash} on it.
     *
     * Documentation for signature generation:
     * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
     * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
        if (signature.length == 65) {
            bytes32 r;
            bytes32 s;
            uint8 v;
            // ecrecover takes the signature parameters, and the only way to get them
            // currently is to use assembly.
            /// @solidity memory-safe-assembly
            assembly {
                r := mload(add(signature, 0x20))
                s := mload(add(signature, 0x40))
                v := byte(0, mload(add(signature, 0x60)))
            }
            return tryRecover(hash, v, r, s);
        } else {
            return (address(0), RecoverError.InvalidSignatureLength);
        }
    }

    /**
     * @dev Returns the address that signed a hashed message (`hash`) with
     * `signature`. This address can then be used for verification purposes.
     *
     * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
     * this function rejects them by requiring the `s` value to be in the lower
     * half order, and the `v` value to be either 27 or 28.
     *
     * IMPORTANT: `hash` _must_ be the result of a hash operation for the
     * verification to be secure: it is possible to craft signatures that
     * recover to arbitrary addresses for non-hashed data. A safe way to ensure
     * this is by receiving a hash of the original message (which may otherwise
     * be too long), and then calling {toEthSignedMessageHash} on it.
     */
    function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, signature);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
     *
     * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {
        bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
        uint8 v = uint8((uint256(vs) >> 255) + 27);
        return tryRecover(hash, v, r, s);
    }

    /**
     * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
     *
     * _Available since v4.2._
     */
    function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, r, vs);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Overload of {ECDSA-tryRecover} that receives the `v`,
     * `r` and `s` signature fields separately.
     *
     * _Available since v4.3._
     */
    function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {
        // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
        // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
        // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
        // signatures from current libraries generate a unique signature with an s-value in the lower half order.
        //
        // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
        // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
        // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
        // these malleable signatures as well.
        if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
            return (address(0), RecoverError.InvalidSignatureS);
        }

        // If the signature is valid (and not malleable), return the signer address
        address signer = ecrecover(hash, v, r, s);
        if (signer == address(0)) {
            return (address(0), RecoverError.InvalidSignature);
        }

        return (signer, RecoverError.NoError);
    }

    /**
     * @dev Overload of {ECDSA-recover} that receives the `v`,
     * `r` and `s` signature fields separately.
     */
    function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {
        (address recovered, RecoverError error) = tryRecover(hash, v, r, s);
        _throwError(error);
        return recovered;
    }

    /**
     * @dev Returns an Ethereum Signed Message, created from a `hash`. This
     * produces hash corresponding to the one signed with the
     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
     * JSON-RPC method as part of EIP-191.
     *
     * See {recover}.
     */
    function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {
        // 32 is the length in bytes of hash,
        // enforced by the type signature above
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, "\x19Ethereum Signed Message:\n32")
            mstore(0x1c, hash)
            message := keccak256(0x00, 0x3c)
        }
    }

    /**
     * @dev Returns an Ethereum Signed Message, created from `s`. This
     * produces hash corresponding to the one signed with the
     * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
     * JSON-RPC method as part of EIP-191.
     *
     * See {recover}.
     */
    function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
        return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", Strings.toString(s.length), s));
    }

    /**
     * @dev Returns an Ethereum Signed Typed Data, created from a
     * `domainSeparator` and a `structHash`. This produces hash corresponding
     * to the one signed with the
     * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
     * JSON-RPC method as part of EIP-712.
     *
     * See {recover}.
     */
    function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {
        /// @solidity memory-safe-assembly
        assembly {
            let ptr := mload(0x40)
            mstore(ptr, "\x19\x01")
            mstore(add(ptr, 0x02), domainSeparator)
            mstore(add(ptr, 0x22), structHash)
            data := keccak256(ptr, 0x42)
        }
    }

    /**
     * @dev Returns an Ethereum Signed Data with intended validator, created from a
     * `validator` and `data` according to the version 0 of EIP-191.
     *
     * See {recover}.
     */
    function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {
        return keccak256(abi.encodePacked("\x19\x00", validator, data));
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.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.
 *
 * ```solidity
 * 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;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/UUPSUpgradeable.sol)

pragma solidity ^0.8.0;

import "../../interfaces/draft-IERC1822.sol";
import "../ERC1967/ERC1967Upgrade.sol";

/**
 * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an
 * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.
 *
 * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is
 * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing
 * `UUPSUpgradeable` with a custom implementation of upgrades.
 *
 * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.
 *
 * _Available since v4.1._
 */
abstract contract UUPSUpgradeable is IERC1822Proxiable, ERC1967Upgrade {
    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment
    address private immutable __self = address(this);

    /**
     * @dev Check that the execution is being performed through a delegatecall call and that the execution context is
     * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case
     * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a
     * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to
     * fail.
     */
    modifier onlyProxy() {
        require(address(this) != __self, "Function must be called through delegatecall");
        require(_getImplementation() == __self, "Function must be called through active proxy");
        _;
    }

    /**
     * @dev Check that the execution is not being performed through a delegate call. This allows a function to be
     * callable on the implementing contract but not through proxies.
     */
    modifier notDelegated() {
        require(address(this) == __self, "UUPSUpgradeable: must not be called through delegatecall");
        _;
    }

    /**
     * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the
     * implementation. It is used to validate the implementation's compatibility when performing an upgrade.
     *
     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
     * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.
     */
    function proxiableUUID() external view virtual override notDelegated returns (bytes32) {
        return _IMPLEMENTATION_SLOT;
    }

    /**
     * @dev Upgrade the implementation of the proxy to `newImplementation`.
     *
     * Calls {_authorizeUpgrade}.
     *
     * Emits an {Upgraded} event.
     *
     * @custom:oz-upgrades-unsafe-allow-reachable delegatecall
     */
    function upgradeTo(address newImplementation) public virtual onlyProxy {
        _authorizeUpgrade(newImplementation);
        _upgradeToAndCallUUPS(newImplementation, new bytes(0), false);
    }

    /**
     * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
     * encoded in `data`.
     *
     * Calls {_authorizeUpgrade}.
     *
     * Emits an {Upgraded} event.
     *
     * @custom:oz-upgrades-unsafe-allow-reachable delegatecall
     */
    function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {
        _authorizeUpgrade(newImplementation);
        _upgradeToAndCallUUPS(newImplementation, data, true);
    }

    /**
     * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
     * {upgradeTo} and {upgradeToAndCall}.
     *
     * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
     *
     * ```solidity
     * function _authorizeUpgrade(address) internal override onlyOwner {}
     * ```
     */
    function _authorizeUpgrade(address newImplementation) internal virtual;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.10;

import "./IMechanicData.sol";

/**
 * @notice Interface that mint mechanics are forced to adhere to,
 *         provided they support both collector's choice and sequential minting
 */
interface IMechanic is IMechanicData {
    /**
     * @notice Create a mechanic vector on the mechanic
     * @param mechanicVectorId Global mechanic vector ID
     * @param vectorData Mechanic vector data
     */
    function createVector(bytes32 mechanicVectorId, bytes calldata vectorData) external;

    /**
     * @notice Process a sequential mint
     * @param mechanicVectorId Global ID identifying mint vector, using this mechanic
     * @param recipient Mint recipient
     * @param numToMint Number of tokens to mint
     * @param minter Account that called mint on the MintManager
     * @param mechanicVectorMetadata Mechanic vector metadata
     * @param data Custom data that can be deserialized and processed according to implementation
     */
    function processNumMint(
        bytes32 mechanicVectorId,
        address recipient,
        uint32 numToMint,
        address minter,
        MechanicVectorMetadata calldata mechanicVectorMetadata,
        bytes calldata data
    ) external payable;

    /**
     * @notice Process a collector's choice mint
     * @param mechanicVectorId Global ID identifying mint vector, using this mechanic
     * @param recipient Mint recipient
     * @param tokenIds IDs of tokens to mint
     * @param minter Account that called mint on the MintManager
     * @param mechanicVectorMetadata Mechanic vector metadata
     * @param data Custom data that can be deserialized and processed according to implementation
     */
    function processChooseMint(
        bytes32 mechanicVectorId,
        address recipient,
        uint256[] calldata tokenIds,
        address minter,
        MechanicVectorMetadata calldata mechanicVectorMetadata,
        bytes calldata data
    ) external payable;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.10;

import "./IMechanicData.sol";

interface IMechanicMintManagerView is IMechanicData {
    /**
     * @notice Get a mechanic vector's metadata
     * @param mechanicVectorId Global mechanic vector ID
     */
    function mechanicVectorMetadata(bytes32 mechanicVectorId) external view returns (MechanicVectorMetadata memory);

    /**
     * @notice Returns whether an address is a valid platform executor
     * @param _executor Address to be checked
     */
    function isPlatformExecutor(address _executor) external view returns (bool);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)

pragma solidity ^0.8.0;

import "../utils/ContextUpgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.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 OwnableUpgradeable is Initializable, ContextUpgradeable {
    address private _owner;

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

    /**
     * @dev Initializes the contract setting the deployer as the initial owner.
     */
    function __Ownable_init() internal onlyInitializing {
        __Ownable_init_unchained();
    }

    function __Ownable_init_unchained() internal onlyInitializing {
        _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. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby disabling any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

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

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     */
    uint256[49] private __gap;
}

// SPDX-License-Identifier: UNLICENSED
pragma solidity 0.8.10;

/**
 * @notice Defines a mechanic's metadata on the MintManager
 */
interface IMechanicData {
    /**
     * @notice A mechanic's metadata
     * @param contractAddress Collection contract address
     * @param editionId Edition ID if the collection is edition based
     * @param mechanic Address of mint mechanic contract
     * @param isEditionBased True if collection is edition based
     * @param isChoose True if collection uses a collector's choice mint paradigm
     * @param paused True if mechanic vector is paused
     */
    struct MechanicVectorMetadata {
        address contractAddress;
        uint96 editionId;
        address mechanic;
        bool isEditionBased;
        bool isChoose;
        bool paused;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)

pragma solidity ^0.8.0;

import "./math/Math.sol";
import "./math/SignedMath.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 `int256` to its ASCII `string` decimal representation.
     */
    function toString(int256 value) internal pure returns (string memory) {
        return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMath.abs(value))));
    }

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

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
     */
    function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
        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);
    }

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)

pragma solidity ^0.8.0;

/**
 * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
 * proxy whose upgrades are fully controlled by the current implementation.
 */
interface IERC1822Proxiable {
    /**
     * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
     * address.
     *
     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
     * function revert if invoked through a proxy.
     */
    function proxiableUUID() external view returns (bytes32);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)

pragma solidity ^0.8.2;

import "../beacon/IBeacon.sol";
import "../../interfaces/IERC1967.sol";
import "../../interfaces/draft-IERC1822.sol";
import "../../utils/Address.sol";
import "../../utils/StorageSlot.sol";

/**
 * @dev This abstract contract provides getters and event emitting update functions for
 * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
 *
 * _Available since v4.1._
 */
abstract contract ERC1967Upgrade is IERC1967 {
    // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
    bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;

    /**
     * @dev Storage slot with the address of the current implementation.
     * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
     * validated in the constructor.
     */
    bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;

    /**
     * @dev Returns the current implementation address.
     */
    function _getImplementation() internal view returns (address) {
        return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
    }

    /**
     * @dev Stores a new address in the EIP1967 implementation slot.
     */
    function _setImplementation(address newImplementation) private {
        require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
        StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
    }

    /**
     * @dev Perform implementation upgrade
     *
     * Emits an {Upgraded} event.
     */
    function _upgradeTo(address newImplementation) internal {
        _setImplementation(newImplementation);
        emit Upgraded(newImplementation);
    }

    /**
     * @dev Perform implementation upgrade with additional setup call.
     *
     * Emits an {Upgraded} event.
     */
    function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
        _upgradeTo(newImplementation);
        if (data.length > 0 || forceCall) {
            Address.functionDelegateCall(newImplementation, data);
        }
    }

    /**
     * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
     *
     * Emits an {Upgraded} event.
     */
    function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {
        // Upgrades from old implementations will perform a rollback test. This test requires the new
        // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
        // this special case will break upgrade paths from old UUPS implementation to new ones.
        if (StorageSlot.getBooleanSlot(_ROLLBACK_SLOT).value) {
            _setImplementation(newImplementation);
        } else {
            try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
                require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
            } catch {
                revert("ERC1967Upgrade: new implementation is not UUPS");
            }
            _upgradeToAndCall(newImplementation, data, forceCall);
        }
    }

    /**
     * @dev Storage slot with the admin of the contract.
     * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
     * validated in the constructor.
     */
    bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;

    /**
     * @dev Returns the current admin.
     */
    function _getAdmin() internal view returns (address) {
        return StorageSlot.getAddressSlot(_ADMIN_SLOT).value;
    }

    /**
     * @dev Stores a new address in the EIP1967 admin slot.
     */
    function _setAdmin(address newAdmin) private {
        require(newAdmin != address(0), "ERC1967: new admin is the zero address");
        StorageSlot.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
    }

    /**
     * @dev Changes the admin of the proxy.
     *
     * Emits an {AdminChanged} event.
     */
    function _changeAdmin(address newAdmin) internal {
        emit AdminChanged(_getAdmin(), newAdmin);
        _setAdmin(newAdmin);
    }

    /**
     * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
     * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
     */
    bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;

    /**
     * @dev Returns the current beacon.
     */
    function _getBeacon() internal view returns (address) {
        return StorageSlot.getAddressSlot(_BEACON_SLOT).value;
    }

    /**
     * @dev Stores a new beacon in the EIP1967 beacon slot.
     */
    function _setBeacon(address newBeacon) private {
        require(Address.isContract(newBeacon), "ERC1967: new beacon is not a contract");
        require(
            Address.isContract(IBeacon(newBeacon).implementation()),
            "ERC1967: beacon implementation is not a contract"
        );
        StorageSlot.getAddressSlot(_BEACON_SLOT).value = newBeacon;
    }

    /**
     * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
     * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
     *
     * Emits a {BeaconUpgraded} event.
     */
    function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
        _setBeacon(newBeacon);
        emit BeaconUpgraded(newBeacon);
        if (data.length > 0 || forceCall) {
            Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.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) {
                // Solidity will revert if denominator == 0, unlike the div opcode on its own.
                // The surrounding unchecked block does not change this fact.
                // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
                return prod0 / denominator;
            }

            // Make sure the result is less than 2^256. Also prevents denominator == 0.
            require(denominator > prod1, "Math: mulDiv overflow");

            ///////////////////////////////////////////////
            // 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 256, following the selected rounding direction, of a positive value.
     * Returns 0 if given 0.
     */
    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
        unchecked {
            uint256 result = log256(value);
            return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)

pragma solidity ^0.8.0;
import {Initializable} from "../proxy/utils/Initializable.sol";

/**
 * @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 ContextUpgradeable is Initializable {
    function __Context_init() internal onlyInitializing {
    }

    function __Context_init_unchained() internal onlyInitializing {
    }
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

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

    function _contextSuffixLength() internal view virtual returns (uint256) {
        return 0;
    }

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     */
    uint256[50] private __gap;
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)

pragma solidity ^0.8.0;

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)

pragma solidity ^0.8.2;

import "../../utils/AddressUpgradeable.sol";

/**
 * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
 * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
 * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
 * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
 *
 * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
 * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
 * case an upgrade adds a module that needs to be initialized.
 *
 * For example:
 *
 * [.hljs-theme-light.nopadding]
 * ```solidity
 * contract MyToken is ERC20Upgradeable {
 *     function initialize() initializer public {
 *         __ERC20_init("MyToken", "MTK");
 *     }
 * }
 *
 * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
 *     function initializeV2() reinitializer(2) public {
 *         __ERC20Permit_init("MyToken");
 *     }
 * }
 * ```
 *
 * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
 * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
 *
 * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
 * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
 *
 * [CAUTION]
 * ====
 * Avoid leaving a contract uninitialized.
 *
 * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
 * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
 * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
 *
 * [.hljs-theme-light.nopadding]
 * ```
 * /// @custom:oz-upgrades-unsafe-allow constructor
 * constructor() {
 *     _disableInitializers();
 * }
 * ```
 * ====
 */
abstract contract Initializable {
    /**
     * @dev Indicates that the contract has been initialized.
     * @custom:oz-retyped-from bool
     */
    uint8 private _initialized;

    /**
     * @dev Indicates that the contract is in the process of being initialized.
     */
    bool private _initializing;

    /**
     * @dev Triggered when the contract has been initialized or reinitialized.
     */
    event Initialized(uint8 version);

    /**
     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
     * `onlyInitializing` functions can be used to initialize parent contracts.
     *
     * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
     * constructor.
     *
     * Emits an {Initialized} event.
     */
    modifier initializer() {
        bool isTopLevelCall = !_initializing;
        require(
            (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
            "Initializable: contract is already initialized"
        );
        _initialized = 1;
        if (isTopLevelCall) {
            _initializing = true;
        }
        _;
        if (isTopLevelCall) {
            _initializing = false;
            emit Initialized(1);
        }
    }

    /**
     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
     * used to initialize parent contracts.
     *
     * A reinitializer may be used after the original initialization step. This is essential to configure modules that
     * are added through upgrades and that require initialization.
     *
     * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
     * cannot be nested. If one is invoked in the context of another, execution will revert.
     *
     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
     * a contract, executing them in the right order is up to the developer or operator.
     *
     * WARNING: setting the version to 255 will prevent any future reinitialization.
     *
     * Emits an {Initialized} event.
     */
    modifier reinitializer(uint8 version) {
        require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
        _initialized = version;
        _initializing = true;
        _;
        _initializing = false;
        emit Initialized(version);
    }

    /**
     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
     * {initializer} and {reinitializer} modifiers, directly or indirectly.
     */
    modifier onlyInitializing() {
        require(_initializing, "Initializable: contract is not initializing");
        _;
    }

    /**
     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
     * through proxies.
     *
     * Emits an {Initialized} event the first time it is successfully executed.
     */
    function _disableInitializers() internal virtual {
        require(!_initializing, "Initializable: contract is initializing");
        if (_initialized != type(uint8).max) {
            _initialized = type(uint8).max;
            emit Initialized(type(uint8).max);
        }
    }

    /**
     * @dev Returns the highest version that has been initialized. See {reinitializer}.
     */
    function _getInitializedVersion() internal view returns (uint8) {
        return _initialized;
    }

    /**
     * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
     */
    function _isInitializing() internal view returns (bool) {
        return _initializing;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)

pragma solidity ^0.8.1;

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

        return account.code.length > 0;
    }

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

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

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

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

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

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

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

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

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

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)
// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.

pragma solidity ^0.8.0;

/**
 * @dev Library for reading and writing primitive types to specific storage slots.
 *
 * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
 * This library helps with reading and writing to such slots without the need for inline assembly.
 *
 * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
 *
 * Example usage to set ERC1967 implementation slot:
 * ```solidity
 * contract ERC1967 {
 *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
 *
 *     function _getImplementation() internal view returns (address) {
 *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
 *     }
 *
 *     function _setImplementation(address newImplementation) internal {
 *         require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
 *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
 *     }
 * }
 * ```
 *
 * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._
 * _Available since v4.9 for `string`, `bytes`._
 */
library StorageSlot {
    struct AddressSlot {
        address value;
    }

    struct BooleanSlot {
        bool value;
    }

    struct Bytes32Slot {
        bytes32 value;
    }

    struct Uint256Slot {
        uint256 value;
    }

    struct StringSlot {
        string value;
    }

    struct BytesSlot {
        bytes value;
    }

    /**
     * @dev Returns an `AddressSlot` with member `value` located at `slot`.
     */
    function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `BooleanSlot` with member `value` located at `slot`.
     */
    function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
     */
    function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `Uint256Slot` with member `value` located at `slot`.
     */
    function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `StringSlot` with member `value` located at `slot`.
     */
    function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `StringSlot` representation of the string storage pointer `store`.
     */
    function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := store.slot
        }
    }

    /**
     * @dev Returns an `BytesSlot` with member `value` located at `slot`.
     */
    function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := slot
        }
    }

    /**
     * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
     */
    function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
        /// @solidity memory-safe-assembly
        assembly {
            r.slot := store.slot
        }
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)

pragma solidity ^0.8.0;

/**
 * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.
 *
 * _Available since v4.8.3._
 */
interface IERC1967 {
    /**
     * @dev Emitted when the implementation is upgraded.
     */
    event Upgraded(address indexed implementation);

    /**
     * @dev Emitted when the admin account has changed.
     */
    event AdminChanged(address previousAdmin, address newAdmin);

    /**
     * @dev Emitted when the beacon is changed.
     */
    event BeaconUpgraded(address indexed beacon);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)

pragma solidity ^0.8.0;

/**
 * @dev This is the interface that {BeaconProxy} expects of its beacon.
 */
interface IBeacon {
    /**
     * @dev Must return an address that can be used as a delegate call target.
     *
     * {BeaconProxy} will check that this address is a contract.
     */
    function implementation() external view returns (address);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)

pragma solidity ^0.8.1;

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

        return account.code.length > 0;
    }

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "optimizer": {
    "enabled": true,
    "mode": "z"
  },
  "outputSelection": {
    "*": {
      "*": [
        "abi"
      ]
    }
  },
  "detectMissingLibraries": false,
  "forceEVMLA": false,
  "enableEraVMExtensions": false,
  "libraries": {}
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"name":"BidAlreadyAdded","type":"error"},{"inputs":[],"name":"BidAlreadyReclaimed","type":"error"},{"inputs":[],"name":"EtherSendFailed","type":"error"},{"inputs":[],"name":"ImpossibleState","type":"error"},{"inputs":[],"name":"InvalidBid","type":"error"},{"inputs":[],"name":"InvalidClaim","type":"error"},{"inputs":[],"name":"InvalidMint","type":"error"},{"inputs":[],"name":"InvalidMintAmount","type":"error"},{"inputs":[],"name":"InvalidMintManager","type":"error"},{"inputs":[],"name":"InvalidSignature","type":"error"},{"inputs":[],"name":"InvalidSigner","type":"error"},{"inputs":[],"name":"InvalidUpdate","type":"error"},{"inputs":[],"name":"NotMintManager","type":"error"},{"inputs":[],"name":"Unauthorized","type":"error"},{"inputs":[],"name":"VectorAlreadyCreated","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"previousAdmin","type":"address"},{"indexed":false,"internalType":"address","name":"newAdmin","type":"address"}],"name":"AdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"indexed":false,"internalType":"uint256","name":"earnings","type":"uint256"},{"indexed":false,"internalType":"address","name":"paymentRecipient","type":"address"},{"indexed":false,"internalType":"address","name":"currency","type":"address"}],"name":"AuctionEarningsClaimed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"indexed":false,"internalType":"uint48","name":"newEndTimestamp","type":"uint48"}],"name":"AuctionLengthened","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"beacon","type":"address"}],"name":"BeaconUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newValidityHash","type":"bytes32"},{"indexed":true,"internalType":"uint96","name":"actionId","type":"uint96"},{"indexed":false,"internalType":"uint32","name":"bidId","type":"uint32"},{"indexed":false,"internalType":"address","name":"bidder","type":"address"},{"indexed":false,"internalType":"uint96","name":"bidAmount","type":"uint96"},{"indexed":false,"internalType":"address","name":"currency","type":"address"},{"indexed":false,"internalType":"bool","name":"created","type":"bool"}],"name":"BidCreatedOrUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"indexed":true,"internalType":"uint32","name":"bidId","type":"uint32"},{"indexed":false,"internalType":"uint96","name":"amount","type":"uint96"},{"indexed":false,"internalType":"address","name":"currency","type":"address"}],"name":"BidReclaimed","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"}],"name":"RankedAuctionCreated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"}],"name":"RankedAuctionUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"internalType":"uint96","name":"bidAmount","type":"uint96"}],"name":"bid","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"},{"internalType":"uint32","name":"","type":"uint32"}],"name":"bids","outputs":[{"internalType":"uint96","name":"bidAmount","type":"uint96"},{"internalType":"address","name":"bidder","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"internalType":"bytes","name":"vectorData","type":"bytes"}],"name":"createVector","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"internalType":"uint32[]","name":"bidIds","type":"uint32[]"}],"name":"getBids","outputs":[{"components":[{"internalType":"uint96","name":"bidAmount","type":"uint96"},{"internalType":"address","name":"bidder","type":"address"}],"internalType":"struct RankedAuctionMechanic.Bid[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"}],"name":"getRawVector","outputs":[{"components":[{"internalType":"uint48","name":"startTimestamp","type":"uint48"},{"internalType":"uint48","name":"endTimestamp","type":"uint48"},{"internalType":"address payable","name":"paymentRecipient","type":"address"},{"internalType":"uint32","name":"maxUserClaimableViaVector","type":"uint32"},{"internalType":"uint32","name":"maxTotalClaimableViaVector","type":"uint32"},{"internalType":"uint32","name":"latestBidId","type":"uint32"},{"internalType":"address","name":"currency","type":"address"},{"internalType":"bool","name":"bidFundsClaimed","type":"bool"},{"internalType":"uint96","name":"reserveBid","type":"uint96"},{"internalType":"uint48","name":"maxEndTimestamp","type":"uint48"},{"internalType":"uint96","name":"actionId","type":"uint96"}],"internalType":"struct RankedAuctionMechanic.Vector","name":"_vector","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"internalType":"address","name":"user","type":"address"}],"name":"getUserBids","outputs":[{"components":[{"internalType":"uint96","name":"bidAmount","type":"uint96"},{"internalType":"address","name":"bidder","type":"address"}],"internalType":"struct RankedAuctionMechanic.Bid[]","name":"","type":"tuple[]"},{"internalType":"uint256[]","name":"bidIds","type":"uint256[]"},{"internalType":"uint32","name":"numBids","type":"uint32"},{"internalType":"uint32","name":"numClaimed","type":"uint32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"}],"name":"getVectorState","outputs":[{"components":[{"internalType":"uint48","name":"startTimestamp","type":"uint48"},{"internalType":"uint48","name":"endTimestamp","type":"uint48"},{"internalType":"address payable","name":"paymentRecipient","type":"address"},{"internalType":"uint32","name":"maxUserClaimableViaVector","type":"uint32"},{"internalType":"uint32","name":"maxTotalClaimableViaVector","type":"uint32"},{"internalType":"uint32","name":"latestBidId","type":"uint32"},{"internalType":"address","name":"currency","type":"address"},{"internalType":"bool","name":"bidFundsClaimed","type":"bool"},{"internalType":"uint96","name":"reserveBid","type":"uint96"},{"internalType":"uint48","name":"maxEndTimestamp","type":"uint48"},{"internalType":"uint96","name":"actionId","type":"uint96"}],"internalType":"struct RankedAuctionMechanic.Vector","name":"_vector","type":"tuple"},{"internalType":"bytes32","name":"validityHash","type":"bytes32"},{"internalType":"uint256","name":"collectionSupply","type":"uint256"},{"internalType":"uint256","name":"collectionSize","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_mintManager","type":"address"},{"internalType":"address","name":"platform","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"mintManager","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"internalType":"address","name":"recipient","type":"address"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"address","name":"minter","type":"address"},{"components":[{"internalType":"address","name":"contractAddress","type":"address"},{"internalType":"uint96","name":"editionId","type":"uint96"},{"internalType":"address","name":"mechanic","type":"address"},{"internalType":"bool","name":"isEditionBased","type":"bool"},{"internalType":"bool","name":"isChoose","type":"bool"},{"internalType":"bool","name":"paused","type":"bool"}],"internalType":"struct IMechanicData.MechanicVectorMetadata","name":"mechanicVectorMetadata","type":"tuple"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"processChooseMint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"internalType":"address","name":"recipient","type":"address"},{"internalType":"uint32","name":"numToMint","type":"uint32"},{"internalType":"address","name":"minter","type":"address"},{"components":[{"internalType":"address","name":"contractAddress","type":"address"},{"internalType":"uint96","name":"editionId","type":"uint96"},{"internalType":"address","name":"mechanic","type":"address"},{"internalType":"bool","name":"isEditionBased","type":"bool"},{"internalType":"bool","name":"isChoose","type":"bool"},{"internalType":"bool","name":"paused","type":"bool"}],"internalType":"struct IMechanicData.MechanicVectorMetadata","name":"mechanicVectorMetadata","type":"tuple"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"processNumMint","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"proxiableUUID","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"internalType":"uint256","name":"rebateAmount","type":"uint256"},{"internalType":"address","name":"claimer","type":"address"},{"internalType":"uint32","name":"claimerNumValidBids","type":"uint32"},{"internalType":"uint48","name":"claimExpiryTimestamp","type":"uint48"},{"internalType":"uint256","name":"cumulativeBidAmount","type":"uint256"},{"internalType":"uint32","name":"bidId","type":"uint32"},{"internalType":"uint8","name":"claimType","type":"uint8"}],"internalType":"struct RankedAuctionMechanic.RankedAuctionsClaim","name":"claim","type":"tuple"},{"internalType":"bytes","name":"claimSignature","type":"bytes"}],"name":"reclaimBid","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"internalType":"uint32","name":"bidId","type":"uint32"},{"internalType":"uint96","name":"newBidAmount","type":"uint96"}],"name":"updateBid","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"_mintManager","type":"address"}],"name":"updateMintManager","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"components":[{"internalType":"uint48","name":"startTimestamp","type":"uint48"},{"internalType":"uint48","name":"endTimestamp","type":"uint48"},{"internalType":"address payable","name":"paymentRecipient","type":"address"},{"internalType":"uint32","name":"maxUserClaimableViaVector","type":"uint32"},{"internalType":"uint32","name":"maxTotalClaimableViaVector","type":"uint32"},{"internalType":"uint32","name":"latestBidId","type":"uint32"},{"internalType":"address","name":"currency","type":"address"},{"internalType":"bool","name":"bidFundsClaimed","type":"bool"},{"internalType":"uint96","name":"reserveBid","type":"uint96"},{"internalType":"uint48","name":"maxEndTimestamp","type":"uint48"},{"internalType":"uint96","name":"actionId","type":"uint96"}],"internalType":"struct RankedAuctionMechanic.Vector","name":"newVector","type":"tuple"},{"components":[{"internalType":"bool","name":"updateStartTimestamp","type":"bool"},{"internalType":"bool","name":"updateEndTimestamp","type":"bool"},{"internalType":"bool","name":"updateMaxEndTimestamp","type":"bool"},{"internalType":"bool","name":"updateMaxUserClaimableViaVector","type":"bool"},{"internalType":"bool","name":"updateMaxTotalClaimableViaVector","type":"bool"},{"internalType":"bool","name":"updatePaymentRecipient","type":"bool"},{"internalType":"bool","name":"updateCurrency","type":"bool"},{"internalType":"bool","name":"updateReserveBid","type":"bool"}],"internalType":"struct RankedAuctionMechanic.VectorUpdateConfig","name":"updateConfig","type":"tuple"}],"name":"updateVector","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"}],"name":"upgradeTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"upgradeToAndCall","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32","name":"mechanicVectorId","type":"bytes32"},{"internalType":"uint256","name":"rebateAmount","type":"uint256"},{"internalType":"address","name":"claimer","type":"address"},{"internalType":"uint32","name":"claimerNumValidBids","type":"uint32"},{"internalType":"uint48","name":"claimExpiryTimestamp","type":"uint48"},{"internalType":"uint256","name":"cumulativeBidAmount","type":"uint256"},{"internalType":"uint32","name":"bidId","type":"uint32"},{"internalType":"uint8","name":"claimType","type":"uint8"}],"internalType":"struct RankedAuctionMechanic.RankedAuctionsClaim","name":"claim","type":"tuple"},{"internalType":"bytes","name":"claimSignature","type":"bytes"}],"name":"withdrawAuctionEarnings","outputs":[],"stateMutability":"nonpayable","type":"function"}]

9c4d535b000000000000000000000000000000000000000000000000000000000000000001000501e68ed752dee5a0b9616df827bfabeda0f86a9c229a3c85a22cf0028700000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000

0x0004000000000002001400000000000200000060031002700000046c04300197000300000041035500020000000103550000046c0030019d0000000100200190000000000a000416000000770000c13d0000008002000039000000400020043f000000040040008c000009810000413d000000000201043b000000e0052002700000046e0050009c000000240210037000000004031003700000000009000411000006020000613d0000046f0050009c000003e90000613d000004700050009c000000650b000039000004400000613d000004710050009c000006250000613d000004720050009c0000058d0000613d000004730050009c0000039f0000613d000004740050009c000000850000613d000004750050009c000001b20000613d000004760050009c000000d20000613d000004770050009c0000054b0000613d000004780050009c000001770000613d000004790050009c000000de0000613d0000047a0050009c000005ce0000613d0000047b0050009c000001910000613d0000047c0050009c000005d60000613d0000047d0050009c000000440810037000000064071003700000014406100370000002a90000613d0000047e0050009c000005600000613d0000047f0050009c000005190000613d000004800050009c000001690000613d000004810050009c000002210000613d000004820050009c000001960000613d000004830050009c000009810000c13d000000240040008c000009810000413d00000000000a004b000009810000c13d000000000103043b001100000001001d11ad0eb10000040f00000011010000290001004d0000003d000010830000013d0000000002010019000000400100043d000004db0010009c000007230000813d000100530000003d0000118b0000013d0000048703300197000000200510003900000000003504350000048703400197000100590000003d000011830000013d0000046c05300197000000000054043500000040043002700000046c04400197000000a005100039000000000045043500000020033002700000046c03300197000000800410003900000000003404350000000202200039000000000202041a0000009803200270000004840330019700000140041000390000000000340435000000680320027000000487033001970000012004100039000000000034043500000008032002700000048403300197000100710000003d000011740000013d000000400200043d001100000002001d11ad0bec0000040f00000160020000390000001101000029000008510000013d000000a001000039000000400010043f00000000000a004b000009810000c13d0000000001000410000000800010043f0000014000000443000001600010044300000020010000390000010000100443000000010100003900000120001004430000046d01000041000011ae0001042e000000440040008c000009810000413d00000000000a004b000009810000c13d000000000303043b000f00000003001d000000000202043b000004a20020009c000009810000213d0000002303200039000000000043004b000009810000813d0000000403200039000000000131034f000000000101043b000e00000001001d000004a20010009c000009810000213d000d00240020003d0000000e0100002900000005011002100000000d01100029000000000041004b000009810000213d0000000e0100002911ad0ed20000040f000c00020000036b0000000003010019000a00200010003d00000040020000390000000004000019000b00000003001d0000000e0040006c000008f20000813d0000000f01000029000000000010043f0000006801000039000000200010043f0000000001000019001100000004001d11ad10420000040f00000011020000290000000503200210001000000003001d0000000d023000290000000c0220035f000000000202043b0000046c0020009c000009810000213d000100b80000003d000010be0000013d000000400500043d000004880050009c000007230000213d0000004003500039000000400030043f000000000101041a000000200350003900000060041002700000000000430435000004840110019700000000001504350000000b0300002900000000010304330000001106000029000000000061004b0000004002000039000007a10000a13d00000010040000290000000a01400029000000000051043500000001016000390000000004030433000000000064004b0000000004010019000000a50000213d000007a10000013d00000000000a004b000009810000c13d000100d60000003d000011000000013d000004b50200004111ad10560000040f00000485011001970000000002000410000000000012004b000007120000c13d000004b801000041000005d20000013d00000000000a004b000009810000c13d000100e20000003d000010de0000013d0000048504100197000000400160003900000000010104330000048501100197000000000041004b000009ff0000c13d000000e0016000390000000001010433000000ff0110018f000000020010008c000008fe0000c13d000100ef0000003d000010ce0000013d0000046c0550019700000487066001970000046c0810019700000020019000390000000209000039000100f60000003d000011100000013d000004a20010009c000007230000213d0000000100200190000007230000c13d000100fc0000003d0000116d0000013d000004a404000041000100ff0000003d0000113a0000013d000004a50020009c000007230000213d000101030000003d000011650000013d00000485001001980000065b0000613d11ad0fbf0000040f000000000001004b0000065b0000613d0000000c010000290000000001010433000f00000001001d0001010d0000003d0000109c0000013d000004860200004111ad10560000040f00000487021001970000000f010000290000048701100197000f00000002001d000000000012004b0000065b0000213d000101170000003d000011260000013d000008fe0000613d0000000e010000290000000201100367000000000101043b001000000001001d0001011e0000003d0000111e0000013d001100000001001d0000002001100039000000000101043300000487011001970000000f0010006b000008fe0000a13d0000001101000029000000c001100039000f00000001001d00000000010104330000048500100198000008fe0000c13d0000001101000029000000e0011000390000000001010433000000000001004b000008fe0000c13d0000000e01000029000000a0011000390000000201100367000000000101043b000004b10010009c000006210000213d00000000030100190000003301000039000000000101041a0000048502100197000e00000003001d000000140130011a000d00000001001d11ad0ef90000040f0000000d020000290000000e0120006900000011020000290000004002200039001100000002001d0000000002020433000004850220019711ad0ef90000040f0000001001000029000101480000003d000010830000013d0000000201100039000001000200008a000000000301041a000000000223016f00000001022001bf000000000021041b0000000f010000290000000001010433000000110200002900000000020204330000048502200197000000400300043d000000200430003900000000002404350000048501100197000000400230003900000000001204350000000e0100002900000000001304350000046c0030009c0000046c03008041000000400130021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f000004b2011001c70000800d020000390000000203000039000004b30400004100000010050000290000018d0000013d000000240040008c000009810000413d00000000000a004b000009810000c13d000000000103043b001100000001001d000004850010009c000009810000213d11ad0c840000040f0000001103000029000000000003004b0000072b0000c13d000004a00100004100000a000000013d00000000000a004b000009810000c13d11ad0c840000040f0000003301000039000000000201041a0000049f03200197000000000031041b000000400100043d0000046c0010009c0000046c01008041000000400110021000000000030004140000046c0030009c0000046c03008041000000c003300210000000000113019f0000048505200197000004af011001c70000800d020000390000000303000039000004b404000041000000000600001911ad10740000040f00000001002001900000084f0000c13d000009810000013d00000000000a004b000009810000c13d0000003301000039000000000101041a000005d10000013d000000240040008c000009810000413d00000000000a004b000009810000c13d000000000103043b001100000001001d000004850010009c000009810000213d11ad0c840000040f0000001101000029000000000001004b000007310000c13d000000400100043d00000064021000390000049903000041000000000032043500000044021000390000049a0300004100000000003204350000002402100039000000260300003900000000003204350000049b0200004100000000002104350000000402100039000000200300003900000000003204350000071d0000013d000000440040008c000009810000413d000000000303043b001100000003001d000004850030009c000009810000213d000000000302043b000004a20030009c000009810000213d0000002302300039000000000042004b000009810000813d0000000402300039000000000121034f000000000201043b0000002401300039000000000304001911ad0c220000040f000f00000001001d000101c70000003d000011000000013d000004b50200004111ad10560000040f001004850010019b0000000001000410000000100010006c0000000001000039000000010100c03911ad0cb20000040f000004b801000041000000000101041a0000048501100197000000100010006c0000000001000039000000010100603911ad0cc10000040f11ad0c840000040f000004b901000041000000000101041a000000ff00100190000007690000c13d000000400500043d000004ba01000041000000000015043500000000010004140000001102000029000000040020008c000001eb0000613d000000040400003900000020060000390000000003050019001000000005001d000000100500002911ad0bab0000040f0000001005000029000000000001004b000005c50000613d000101ed0000003d000011560000013d000004a20020009c000007230000213d0000000100300190000007230000c13d000000400020043f000004a90010009c000009810000213d000000200010008c000009810000413d0000000001050433000004b80010009c000101fa0000003d0000117c0000013d0000046c0010009c001000000001001d0000046c01008041000000400110021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f000004af011001c70000800d020000390000000203000039000004bb04000041000000110500002911ad10740000040f0000000100200190000009810000613d0000001001000029000004bc0010009c0000001103000029000007230000213d00000010040000290000006001400039000000400010043f0000004001400039000004bd0200004100000000002104350000002001400039000004be020000410000000000210435000000270100003900000000001404350000000f0100002900000000040104330000000001000414000000040030008c000009820000c13d0000000101000039000009860000013d000000640040008c000009810000413d000000000103043b001100000001001d000000000102043b001000000001001d0000046c0010009c000009810000213d000000000108043b000f00000001001d000004840010009c000009810000213d0000001101000029000102300000003d0000111e0000013d0000001102000029000000000020043f0000006802000039000000200020043f000e00000001001d0000000001000019000000400200003911ad10420000040f00000010020000290001023b0000003d000011a10000013d000004880020009c000007230000213d0000004003200039000000400030043f000000000401041a00000020012000390000006003400270000c00000003001d000000000031043500000484014001970000000000120435000d00000004001d0000049c0040009c000007c80000413d0000000f0010006b000007c80000a13d0000000e010000290000002001100039000a00000001001d0000000001010433000b00000001001d000102520000003d0000109c0000013d000004860200004111ad10560000040f000000000401001900000487031001970000000b010000290000048701100197000000000031004b000007c80000413d0000000e0100002900000000010104330000048701100197000000000031004b000007c80000213d0000000e010000290000010001100039000000000101043300000484011001970000000f0010006b000007c80000413d0000000d020000290000000f0120006900000484011001970000000002000416000000000012004b000007c80000c13d000b00000004001d000d00000003001d00000000010004110000000c0010006b000009ff0000c13d0000000e010000290000014001100039000c00000001001d00000000010104330000048401100197000004840010009c000006210000613d00000001011000390000000c0200002900000000001204350000001101000029000000000010043f00000068010000390001027f0000003d000011a80000013d0000001002000029000102820000003d000011090000013d0000049d022001970000000f022001af000000000021041b0000000c010000290000000001010433000900000001001d0000001101000029000000000010043f00000066010000390001028d0000003d000010ee0000013d000000090200002900000098022002100000048e022001970000000201100039000000000301041a0000048f03300197000000000223019f000000000021041b0000000a01000029000000000101043300000487021001970000000d0020006c000006210000413d0000000b0110006a00000487011001970000012c0010008c00000a8b0000213d0000000e0100002900000120011000390000000001010433000b04870010019c00000a670000c13d0000000d01000029000004900010009c000006210000213d0000000d010000290000012c0110003900000a6e0000013d000001640040008c000009810000413d000000000303043b001100000003001d000000000202043b000004850020009c000009810000213d000000000208043b001000000002001d0000046c0020009c000009810000213d000000000207043b000f00000002001d000004850020009c000009810000213d000000000206043b000004a20020009c000009810000213d0000002303200039000000000043004b000009810000813d0000000405200039000000000351034f000000000603043b000004a20060009c000009810000213d00000024022000390000000003260019000000000043004b000009810000213d00000000040b041a0000048504400197000000000049004b000007290000c13d0000018004000039000000400040043f000000800000043f000000a00000043f000000c00000043f000000e00000043f000001000000043f000001200000043f000001400000043f000001600000043f000001000060008c000009810000413d0000002004500039000000000641034f0000004004500039000000000541034f000000000606043b000e00000006001d000000000505043b000d00000005001d000004850050009c000009810000213d0000002004400039000000000541034f000000000505043b000c00000005001d0000046c0050009c000009810000213d0000002004400039000000000541034f000000000505043b000b00000005001d000004870050009c000009810000213d0000002005400039000000000551034f0000004004400039000000000641034f000000000505043b000a00000005001d000000000506043b000900000005001d0000046c0050009c000009810000213d0000002004400039000000000541034f000000000505043b000800000005001d000000ff0050008c000009810000213d0000002004400039000000000441034f000000000404043b000004a20040009c000009810000213d00000000042400190000001f02400039000000000032004b000009810000813d000000000141034f000000000201043b000000200140003911ad0c220000040f000600000001001d000000400100043d000700000001001d000004a30010009c000007230000213d00000007020000290000010001200039000000400010043f000000e00120003900000008030000290000000000310435000000c00120003900000009030000290000000000310435000000a0012000390000000a0300002900000000003104350000008001200039000500000001001d0000000b0300002900000000003104350000006001200039000400000001001d0000000c0300002900000000003104350000002001200039000300000001001d0000000e030000290000000000310435000000110100002900000000001204350000004001200039000200000001001d0000000d0200002900000000002104350000000f0020006c000009ff0000c13d0000000801000029000000030010008c000008fe0000c13d000000400100043d000d00000001001d00000020011000390000000309000039000800000001001d00000011020000290000000e030000290000000f040000290000000c050000290000000b060000290000000a07000029000000090800002911ad0f500000040f0000000d040000290000000001410049000000200210008a00000000002404350000001f01100039000000200200008a000000000221016f0000000001420019000000000021004b00000000020000390000000102004039000004a20010009c000007230000213d0000000100200190000007230000c13d000000400010043f0000000002040433000000080100002911ad10420000040f000e00000001001d11ad10030000040f000004a404000041000000400200043d00000020032000390000000000430435000000220420003900000000001404350000004201000039000000000012043500000042012000390000000e040000290000000000410435000004a50020009c000007230000213d0000008001200039000000400010043f0000000002020433000000000103001911ad10420000040f000000060200002911ad0f690000040f00000485001001980000065b0000613d11ad0fbf0000040f000000000001004b0000065b0000613d00000005010000290000000001010433000d00000001001d000103720000003d0000109c0000013d000004860200004111ad10560000040f00000487021001970000000d010000290000048701100197000d00000002001d000000000012004b0000065b0000213d00000007010000290000000001010433000000000010043f0000006b01000039000103800000003d000010b80000013d11ad0e3c0000040f000000000001004b000008fe0000613d0000001101000029000000000010043f0000006601000039000103880000003d000010f30000013d000000300110027000000487011001970000000d0010006c0000058b0000813d00000069010000390001038f0000003d000011a80000013d0000000f02000029000103920000003d000011090000013d0000046c012001970000046c03100167000000100030006b000006210000213d0000001002200029000e046c0020019b000000040200002900000000020204330000046c022001970000000e0020006b00000b880000a13d000004a70100004100000a000000013d000000440040008c000009810000413d00000000000a004b000009810000c13d000000000103043b001100000001001d000004850010009c000009810000213d000000000102043b001000000001001d000004850010009c000009810000213d0000000001000415000f00000001001d000000000300041a0000ffff00300190000003c00000613d0000000001000410001200000001001d0000800201000039000e00000003001d00000024030000390000000004000415000000120440008a0000000504400210000004c10200004111ad10560000040f0000000e03000029000000ff0230018f000000010020008c000008c10000c13d000000000001004b000008c10000c13d0000ff0000300190000001000100008a000000000113016f00000001011001bf000000000010041b0000083b0000c13d0000ffff0200008a000000000121016f00000100011001bf000000000010041b000000000100041111ad0c980000040f0000006502000039000000000102041a0000049f0110019700000011011001af000000000012041b000000100100002911ad0c980000040f0000ff010100008a000000000200041a000000000112016f000000000010041b0000000103000039000000400100043d00000000003104350000046c0010009c0000046c01008041000000400110021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f00000493011001c70000800d02000039000004c40400004111ad10740000040f00000001002001900000084c0000c13d000009810000013d000000240040008c000009810000413d00000000000a004b000009810000c13d000000000103043b001100000001001d11ad0eb10000040f0000001101000029000103f30000003d000010830000013d000000400500043d000004d10050009c000007230000213d0000016002500039000000400020043f0000004002500039000000000301041a000000600430027000000000004204350000003002300270000004870220019700000020045000390000000000240435000004870230019700000000002504350000000102100039000000000202041a000000c0035000390000006004200270000000000043043500000060035000390000046c04200197000000000043043500000040032002700000046c03300197000000a004500039000000000034043500000020022002700000046c02200197000000800350003900000000002304350000000201100039000000000101041a000000980210027000000484022001970000014003500039000000000023043500000068021002700000048702200197000001200350003900000000002304350000000802100270000004840220019700000100035000390000000000230435001000000005001d000000e002500039000000ff001001900000000001000039000000010100c03900000000001204350000001101000029000000000010043f00000067010000390001042b0000003d000010f30000013d000f00000001001d000000110100002911ad0d8e0000040f000000400a00043d000000003201043400000485022001980000000405a00039000007330000c13d0000004402a00039000004da0300004100000000003204350000002402a00039000000140300003900000000003204350000049b0200004100000000002a043500000020020000390000000000250435000000640200003900000000010a001911ad10300000040f000000440040008c000009810000413d00000000000a004b000009810000c13d000000000502043b000004a20050009c000009810000213d0000002302500039000000000042004b000009810000813d0000000402500039000000000121034f000000000201043b000000000103043b001100000001001d0000002401500039000000000304001911ad0c220000040f0000006502000039000000000202041a00000485032001970000000002000411000000000032004b000007290000c13d001000000001001d0000001101000029000000000010043f00000066010000390001045e0000003d000010f30000013d0000048700100198000008390000c13d00000010010000290000000001010433000004a90010009c000009810000213d000001000010008c000009810000413d000000100100002900000020011000390000000001010433000004870010009c000009810000213d000000100200002900000040022000390000000002020433000f00000002001d000004870020009c000009810000213d000000100200002900000060022000390000000002020433000e00000002001d000004870020009c000009810000213d000000100200002900000080022000390000000002020433000d00000002001d000004850020009c000009810000213d0000001002000029000000a0022000390000000002020433000c00000002001d0000046c0020009c000009810000213d0000001002000029000000c0022000390000000002020433000b00000002001d0000046c0020009c000009810000213d0000001002000029000000e0022000390000000002020433000a00000002001d000004840020009c000009810000213d000000100200002900000100022000390000000002020433001000000002001d000004850020009c000009810000213d0000000b0000006b000009700000613d000000000001004b0000049e0000c13d0001049b0000003d0000109c0000013d000004860200004111ad10560000040f00000487011001970000000f0000006b000004a30000c13d000004cf0010009c000006210000813d000f04d0001000a2000000400300043d000004d10030009c000007230000213d00000000020300190000000004030019000600000002001d0000016002200039000000400020043f0000012003300039000900000003001d0000000e0200002900000000002304350000010003400039000e00000003001d0000000a020000290000000000230435000000c003400039000a00000003001d000000100200002900000000002304350000008003400039000800000003001d0000000b0200002900000000002304350000006003400039000b00000003001d0000000c0200002900000000002304350000004003400039000c00000003001d0000000d0200002900000000002304350000002003400039000700000003001d0000000f02000029000000000023043500000000001404350000014001400039001000000001001d0000000000010435000000e001400039000f00000001001d0000000000010435000000a001400039000d00000001001d00000000000104350000001101000029000104d40000003d000010830000013d0000000c02000029000000000202043300000060022002100000000703000029000000000303043300000030033002100000049103300197000000000232019f000000060300002900000000030304330000048703300197000000000232019f000000000021041b0000000b0200002900000000020204330000046c022001970000000803000029000000000303043300000020033002100000048a03300197000000000223019f0000000d03000029000000000303043300000040033002100000048c03300197000000000232019f0000000a0300002900000000030304330000006003300210000000000232019f0000000103100039000000000023041b00000002011000390000000f020000290000000002020433000000000002004b000000000201041a000004d202200197000000010220c1bf0000000e0300002900000000030304330000000803300210000004ad03300197000000000232019f000000090300002900000000030304330000006803300210000004ab03300197000000000232019f0000001003000029000000000303043300000098033002100000048e03300197000000000232019f000000000021041b000000400100043d0000046c0010009c0000046c01008041000000400110021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f000004af011001c70000800d020000390000000203000039000004d30400004100000ab00000013d000000440040008c000009810000413d00000000000a004b000009810000c13d000000000102043b001100000001001d000004850010009c000009810000213d000000000103043b000e00000001001d000000000010043f0000006901000039000105270000003d000010ad0000013d000000c002000039000000400020043f000000000101041a0000046c02100197000000800020043f00000020011002700000046c01100197000000a00010043f0000000e01000029000000000010043f0000006a01000039000000200010043f0000000001000019000000400200003911ad10420000040f0000001102000029000105390000003d000011090000013d001100000002001d000000c00020043f000000000010043f0000002002000039000000000100001911ad10420000040f0000001106000029000000c0050000390000000002000019000000200400008a000000000062004b0000071f0000813d0000002005500039000000000301041a000000000035043500000001022000390000000101100039000005430000013d000000440040008c000009810000413d00000000000a004b000009810000c13d000000000102043b001100000001001d0000046c0010009c000009810000213d000000000103043b000000000010043f0000006801000039000105580000003d000010ad0000013d000000000101041a0000048402100197000000800020043f0000006001100270000000a00010043f00000080010000390000004002000039000008510000013d000001640040008c000009810000413d000000000202043b000004850020009c000009810000213d000000000208043b000004a20020009c000009810000213d0000002303200039000000000043004b000009810000813d0000000403200039000000000331034f000000000303043b000004a20030009c000009810000213d000000050330021000000000023200190000002402200039000000000042004b000009810000213d000000000207043b000004850020009c000009810000213d000000000206043b000004a20020009c000009810000213d0000002303200039000000000043004b000009810000813d0000000403200039000000000131034f000000000101043b000004a20010009c000009810000213d00000000011200190000002401100039000000000041004b000009810000213d00000000010b041a0000048501100197000000000019004b000007290000c13d000004a60100004100000a000000013d000000240040008c000009810000413d00000000000a004b000009810000c13d000000000103043b001100000001001d000004850010009c000009810000213d000105970000003d000011000000013d000004b50200004111ad10560000040f001004850010019b0000000001000410000000100010006c0000000001000039000000010100c03911ad0cb20000040f000004b801000041000000000101041a0000048501100197000000100010006c0000000001000039000000010100603911ad0cc10000040f11ad0c840000040f000000400400043d000004c50040009c000007230000213d0000002002400039000000400020043f0000000000040435000004b901000041000000000101041a000000ff00100190000007690000c13d000e00000002001d000000400500043d000004ba01000041000000000015043500000000010004140000001102000029000000040020008c000008530000613d001000000004001d0000000404000039000000200600003900000011020000290000000003050019000f00000005001d0000000f0500002911ad0bab0000040f0000000f050000290000001004000029000000000001004b000008530000c13d000000400200043d001100000002001d0000049b010000410000000000120435000000040120003911ad0cdf0000040f000000110210006a000000110100002911ad10300000040f00000000000a004b000009810000c13d00000000010b041a0000048501100197000000800010043f00000080010000390000002002000039000008510000013d000002840040008c000009810000413d00000000000a004b000009810000c13d000000000103043b000f00000001001d11ad0d8e0000040f000000400500043d000004a803000041001000000001001d0000000002010433000000000035043500000000010004140000048502200197000000040020008c0000065d0000613d000000040400003900000020060000390000000003050019001100000005001d000000110500002911ad0bab0000040f0000001105000029000000000001004b0000065d0000c13d00000003040003670000000102000031000000200100008a00000000051201700000001f0620018f000000400100043d0000000003510019000005fd0000613d000000000704034f0000000008010019000000007907043c0000000008980436000000000038004b000005f90000c13d000000000006004b000006010000613d000106010000003d0000108a0000013d11ad10300000040f000000440040008c000009810000413d000000000102043b001100000001001d000004840010009c000009810000213d000000000103043b001000000001001d0001060c0000003d0000111e0000013d0000001002000029000000000020043f0000006902000039000000200020043f000f00000001001d0000000001000019000000400200003911ad10420000040f00000000020004110000048502200197000e00000002001d000000000020043f000000200010043f0000000001000019000000400200003911ad10420000040f000000000101041a00000020011002700000046c011001970000046c0010009c000007a50000c13d000004bf01000041000000000010043f0000001101000039000007260000013d00000000000a004b000009810000c13d000106290000003d000010de0000013d0000048504100197000000400160003900000000010104330000048501100197000000000041004b000009ff0000c13d000000e0016000390000000001010433000000ff0110018f000000010010008c000008fe0000c13d000106360000003d000010ce0000013d0000046c0550019700000487066001970000046c08100197000000200190003900000001090000390001063d0000003d000011100000013d000004a20010009c000007230000213d0000000100200190000007230000c13d000106430000003d0000116d0000013d000004a404000041000106460000003d0000113a0000013d000004a50020009c000007230000213d0001064a0000003d000011650000013d00000485001001980000065b0000613d11ad0fbf0000040f000000000001004b0000065b0000613d0000000c010000290000000001010433000f00000001001d000106540000003d0000109c0000013d000004860200004111ad10560000040f0000000f0200002900000487022001970000048701100197000000000021004b000008fb0000a13d000004cc0100004100000a000000013d00000001010000310000001f02100039000000200300008a000000000232016f0000000003520019000000000023004b00000000020000390000000102004039000004a20030009c000007230000213d0000000100200190000007230000c13d001100000003001d000000400030043f000004a90010009c000009810000213d000000200010008c000009810000413d0000000001050433000004850010009c000009810000213d0000000002000411000000000021004b0000067a0000613d000000100100002900000000010104330000048501100197000000000021004b000009ff0000c13d0000000201000367001000000001035300000184011003700001067f0000003d000010960000013d000009810000c13d000000000001004b000006960000613d000000100100035f0000002401100370000000000101043b000e00000001001d000004870010009c000009810000213d0000000e0000006b0000068f0000c13d0001068c0000003d0000109c0000013d000004860200004111ad10560000040f000e04870010019b0000000f01000029000106920000003d000010830000013d000000000201041a000004aa022001970000000e022001af000000000021041b000000100100035f000001a4011003700001069a0000003d000010960000013d000009810000c13d000000000001004b000009680000c13d000000100100035f000001c401100370000106a10000003d000010960000013d000009810000c13d000000000001004b000006b80000613d000000100100035f0000014401100370000000000101043b000e00000001001d000004870010009c000009810000213d0000000e0000006b000009700000613d0000000f01000029000000000010043f0000006601000039000106b10000003d000010b80000013d0000006802200210000004ab022001970000000201100039000000000301041a000004ac03300197000000000223019f000000000021041b000000100100035f000001e401100370000106bc0000003d000010960000013d000009810000c13d000000000001004b000006ca0000613d000000100100035f0000008401100370000000000101043b000e00000001001d0000046c0010009c000009810000213d000106c70000003d000010c40000013d00000489022001970000000e022001af000000000021041b000000100100035f0000020401100370000106ce0000003d000010960000013d000009810000c13d000000000001004b00000a520000c13d000000100100035f0000024401100370000106d50000003d000010960000013d000009810000c13d000000000001004b000006e50000613d000106da0000003d000010c40000013d0000048c00200198000009700000c13d000000100300035f000000e403300370000000000303043b000004850030009c000009810000213d00000484022001970000006003300210000000000223019f000000000021041b000000100100035f0000022401100370000106e90000003d000010960000013d000009810000c13d000000000001004b000006fc0000613d000000100100035f0000006401100370000000000101043b000e00000001001d000004850010009c000009810000213d0000000f01000029000000000010043f0000006601000039000106f70000003d000010b80000013d0000006002200210000000000301041a0000048403300197000000000223019f000000000021041b000000100100035f0000026401100370000107000000003d000010960000013d000009810000c13d000000000001004b00000b1a0000c13d00000011010000290000046c0010009c0000046c01008041000000400110021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f000004af011001c70000800d020000390000000203000039000004b0040000410000000f05000029000001680000013d0000049b01000041000000800010043f0000002001000039000000840010043f0000003801000039000000a40010043f000004b601000041000000c40010043f000004b701000041000000e40010043f0000008001000039000000840200003911ad10300000040f000000810150008a000000000141016f000004a10010009c0000076c0000a13d000004bf01000041000000000010043f0000004101000039000000040010043f000004c001000041000011af00010430000004cd0100004100000a000000013d0000006502000039000000000102041a0000049f01100197000000000131019f000000000012041b0000084f0000013d11ad0c980000040f0000084f0000013d00000060041000390000000004040433000000000004004b000007ca0000c13d000e00000001001d000004d70100004100000000001a04350000000001000414000000040020008c0000088e0000613d0000000404000039000000200600003900000000030a001900000000050a001900110000000a001d11ad0bab0000040f000000110a000029000000000001004b0000088e0000c13d0000000e010000290000000002010433000000400500043d000004d801000041000000000015043500000000010004140000048502200197000000040020008c000007570000613d000000040400003900000020060000390000000003050019001100000005001d11ad0bab0000040f0000001105000029000000000001004b000005ef0000613d00000001020000310000001f01200039000000200300008a000000000131016f0000000003510019000000000013004b00000000010000390000000101004039000004a20030009c000007230000213d0000000100100190000007230000c13d001100000003001d000000400030043f000004a90020009c000009810000213d000000000a0500190000089e0000013d000000110100002911ad0cec0000040f0000084f0000013d000000c001100039000000400010043f000000c00100043d000d00000001001d11ad0ed20000040f001000000001001d000c00200010003d00000000030000190000000d0030006c000008cb0000813d0000000e01000029000000000010043f0000006801000039000000200010043f00000000010000190000004002000039001100000003001d11ad10420000040f0000001103000029000000c00200043d000000000032004b000007a10000a13d0000000502300210000f00000002001d000000e00220003900000000020204330000046c02200197000107890000003d000011a10000013d000004880020009c000007230000213d0000004003200039000000400030043f000000000101041a00000020032000390000006004100270000000000043043500000484011001970000000000120435000000100100002900000000010104330000001103000029000000000031004b000007a10000a13d0000000f040000290000000c014000290000000000210435000000010130003900000010020000290000000002020433000000000032004b0000000003010019000007740000213d000004bf01000041000000000010043f0000003201000039000007260000013d000c00000001001d0000000f010000290000002001100039000b00000001001d0000000001010433000d00000001001d000107ad0000003d0000109c0000013d000004860200004111ad10560000040f000000000401001900000487031001970000000d010000290000048701100197000000000031004b0000000f02000029000007c80000413d00000000010204330000048701100197000000000031004b000007c80000213d000001000120003900000000010104330000048401100197000000110010006b000007c80000413d0000000001000416000000110010006b000007c80000c13d000000600120003900000000010104330000046c01100197000000010110008a0000000c0010006c000009000000813d0000049e0100004100000a000000013d0000000003030433000004d50400004100000000004a0435000004840330019700000000003504350000000001000414000000040020008c000007db0000613d000000240400003900000000030a001900000000050a0019000000000600001900110000000a001d11ad0bab0000040f000000110a000029000000000001004b000005ef0000613d00000003030003670000000102000031000000200900008a00000000049201700000001f0520018f00000000014a0019000007e80000613d000000000603034f00000000070a0019000000006806043c0000000007870436000000000017004b000007e40000c13d000000000005004b000007f00000613d000000000343034f00000003045002100000000005010433000107ef0000003d000011990000013d00000000003104350000001f01200039000000000391016f0000000001a30019000000000031004b00000000030000390000000103004039000004a20010009c000007230000213d0000000100300190000007230000c13d000000400010043f000004a90020009c000009810000213d000000200020008c000009810000413d00000000030a0433000004a20030009c000009810000213d0000000005a200190000000002a300190000000003250049000004a90030009c000009810000213d000000800030008c000009810000413d000004a50010009c000007230000213d0000008003100039000000400030043f0000000046020434000004a20060009c000009810000213d00000000062600190000001f07600039000000000057004b0000000008000019000004d608008041000004d607700197000004d609500197000000000a97013f000000000097004b0000000007000019000004d607004041000004d600a0009c000000000708c019000000000007004b000009810000c13d0000000076060434000004a20060009c000007230000213d0000001f08600039000000200900008a000000000898016f0000003f08800039000000000898016f0000000008380019000004a20080009c000007230000213d000000400080043f00000000006304350000000008760019000000000058004b000009810000213d000000a0051000390000000008000019000000000068004b00000ab20000813d0000000009580019000000000a780019000000000a0a04330000000000a904350000002008800039000008310000013d000004ce0100004100000a000000013d0000000801300270000000ff0110018f000e00000001001d11ad0d7f0000040f0000000e0100002911ad0d7f0000040f0000000e0100002911ad0d7f0000040f000000000100041111ad0c980000040f0000006502000039000000000102041a0000049f0110019700000011011001af000000000012041b000000100100002911ad0c980000040f00000000010004150000000f011000690000000001000002000000400100043d0000000002000019000000000300001911ad10380000040f000108550000003d000011560000013d000004a20020009c000007230000213d0000000100300190000007230000c13d001000000004001d000000400020043f000004a90010009c000009810000213d000000200010008c000009810000413d0000000001050433000004b80010009c000108630000003d0000117c0000013d0000046c0010009c000f00000001001d0000046c01008041000000400110021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f000004af011001c70000800d020000390000000203000039000004bb04000041000000110500002911ad10740000040f0000000100200190000009810000613d00000010010000290000000001010433000000000001004b0000084f0000613d0000000f01000029000004bc0010009c0000001003000029000007230000213d0000000f040000290000006001400039000000400010043f0000004001400039000004bd0200004100000000002104350000002001400039000004be02000041000000000021043500000027010000390000000000140435000000000403043300000000010004140000001102000029000000040020008c00000a0f0000c13d000000010100003900000a120000013d00000001020000310000001f01200039000000200300008a000000000131016f0000000003a10019000000000013004b00000000010000390000000101004039000004a20030009c000007230000213d0000000100100190000007230000c13d001100000003001d000000400030043f000004a90020009c000009810000213d000000200020008c000009810000413d00000000010a0433000d00000001001d0000000e010000290000000003010433000004d9010000410000001105000029000000000015043500000000010004140000048503300197000000040030008c000009430000613d000000040400003900000020060000390000000002030019000000000305001911ad0bab0000040f0000000102000031000000000001004b000009420000c13d0000000304000367000000200100008a00000000051201700000001f0620018f000000400100043d0000000003510019000005fd0000613d000000000704034f0000000008010019000000007907043c0000000008980436000000000038004b000008bc0000c13d000005fd0000013d000000400100043d0000006402100039000004c20300004100000000003204350000004402100039000004c303000041000000000032043500000024021000390000002e03000039000001ab0000013d000000800100043d000f00000001001d000000a00100043d001100000001001d000000400200043d000d00000002001d00000080010000390000000001120436000e00000001001d0000008002200039000000100100002911ad0c720000040f0000000d0600002900000000026100490000000e030000290000000000230435000000c002000039000000c00300043d000000000031043500000000040000190000002001100039000000000034004b000008e70000813d0000002002200039000000000502043300000000005104350000000104400039000008df0000013d0000000f020000290000046c022001970000006003600039000000000023043500000011020000290000046c022001970000004003600039000000000023043500000000026100490000000001060019000008510000013d000000400200043d001100000002001d00000020010000390000000002120436000000000103001911ad0c720000040f000000110210006a0000001101000029000008510000013d000108fd0000003d000011260000013d000009720000c13d000004cb0100004100000a000000013d000a00000004001d000d00000003001d000000a001200039001100000001001d00000000010104330000046c011001970000046c0010009c000006210000613d0000000101100039000000110300002900000000001304350000014001200039000900000001001d00000000010104330000048401100197000004840010009c000006210000613d000000010110003900000009020000290000000000120435000000400200043d000004880020009c000007230000213d0000000001020019000700000001001d0000004001100039000000400010043f00000000010004160000000003120436000800000003001d0000000e0100002900000000001304350000001001000029000000000010043f0000006801000039000109250000003d000011a80000013d000000110200002900000000020204330000046c022001970001092a0000003d000010be0000013d000000070200002900000000020204330000048402200197000000080300002900000000030304330000006003300210000000000223019f000000000021041b0000001001000029000000000010043f0000006a01000039000109370000003d000010ee0000013d0000000e020000290001093a0000003d000010be0000013d000000110200002900000000020204330000046c0220019711ad0e3c0000040f000000000001004b00000a1a0000c13d000004970100004100000a000000013d00000011050000290000001f01200039000000200300008a000000000131016f0000000004510019000000000014004b00000000010000390000000101004039000004a20040009c000007230000213d0000000100100190000007230000c13d000000400040043f000004a90020009c000009810000213d000000200020008c000009810000413d000000000304001900000011010000290000000001010433001100000001001d00000010010000290000000002030019000e00000003001d11ad0bec0000040f0000000e03000029000001a0013000390000001102000029000000000021043500000180013000390000000d020000290000000000210435000001600430003900000000010300190000000f020000290000000000240435000001c002000039000008510000013d000000100100035f0000004401100370000000000101043b000e00000001001d000004870010009c000009810000213d0000000e0000006b00000a030000c13d000004d40100004100000a000000013d001100020000036b0000000e020000290000000201200367000000000101043b000f00000001001d000000000010043f00000068010000390001097b0000003d000010b80000013d000000c002200039001000000002001d000000110220035f000000000202043b0000046c0020009c0000098d0000a13d000011930000013d0000000f020000290000002003200039000000110200002911ad0bdb0000040f000f00000001001d11ad0d0c0000040f000000000301001900000011010000290000000f02000029000000100400002900000a180000013d000000000020043f000109900000003d000010a80000013d000000400200043d000e00000002001d000004880020009c000007230000213d0000000e040000290000004002400039000000400020043f000000000101041a000000200340003900000060021002700000000000230435000004840110019700000000001404350000001003000029000000800330008a000d00000003001d000000110330035f000000000303043b000004850030009c000009810000213d000000000032004b000009ff0000c13d11ad0ef90000040f00000010010000290000000201100367000000000101043b001100000001001d0000046c0010009c000009810000213d0000000e010000290000000001010433000e00000001001d0000000f01000029000000000010043f0000006601000039000109b50000003d000011a80000013d0000000101100039000000000101041a0000006001100270000000400200043d000000200320003900000000001304350000000e01000029000004840110019700000000001204350000046c0020009c0000046c02008041000000400120021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f000004c7011001c70000800d020000390000000303000039000004c8040000410000000f05000029000000110600002911ad10740000040f0000000100200190000009810000613d0000000f01000029000109d20000003d000010f90000013d0000000d02000029000e00020000036b0000000202200367000000000202043b001100000002001d000004850020009c000009810000213d0000001102000029000000000020043f000109dd0000003d000011a80000013d000000000201041a00000020032002700000046c03300198000006210000613d0000048b022001970000002003300210000004c90330009a0000048a03300197000000000223019f000000000021041b0000000f01000029000000000010043f0000006a01000039000109ec0000003d000010ad0000013d0000000e0300035f0000001002300360001100000001001d000000000102043b000e00000001001d0000046c0010009c000009810000213d0000000e01000029000000000010043f00000011010000290000000101100039000c00000001001d000109fa0000003d000010f30000013d000d00000001001d000000000001004b00000b2e0000c13d000004ca0100004100000a000000013d000004c601000041000000000010043f0000049801000041000011af000104300000000f01000029000000000010043f000000660100003900010a080000003d000010b80000013d00000030022002100000049102200197000000000301041a0000049203300197000000000223019f000000000021041b0000069d0000013d00000011020000290000000e0300002911ad0bdb0000040f001000000001001d11ad0d0c0000040f0000000003010019000000110100002900000010020000290000000f0400002911ad0d3b0000040f0000084f0000013d0000001001000029000000000010043f000000690100003900010a1f0000003d000010b80000013d00010a210000003d000010be0000013d0000000c020000290000002002200210000004890220009a0000048a02200197000000000301041a0000048b03300197000000000223019f000000000021041b000000110100002900010a2c0000003d000011450000013d00000040022002100000048c022001970000000101100039000000000301041a0000048d03300197000000000223019f000000000021041b000000090100002900010a360000003d000011450000013d00000098022002100000048e022001970000000201100039000000000301041a0000048f03300197000000000223019f000000000021041b0000000b01000029000000000101043300000487021001970000000d0020006c000006210000413d0000000a0110006a00000487011001970000012c0010008c000000000300041600000aef0000213d0000000f0100002900000120011000390000000001010433000004870210019800000ac40000c13d0000000d01000029000004900010009c000006210000213d0000000d010000290000012c0210003900000acc0000013d000000100100035f000000a401100370000000000101043b000e00000001001d0000046c0010009c000009810000213d0000000e0000006b000009700000613d00010a5c0000003d000010c40000013d00000020032002700000046c033001970000000e0030006b000009700000413d0000048b022001970000000e0300002900000020033002100000048a03300197000000000232019f000000000021041b000006d10000013d0000000d01000029000004900010009c000006210000213d0000000d010000290000012c011000390000000b0010006b00000a6f0000a13d000b00000001001d000000110100002900010a720000003d000010830000013d0000000b0400002900000030024002100000049102200197000000000301041a0000049203300197000000000223019f000000000021041b000000400100043d00000000004104350000046c0010009c0000046c01008041000000400110021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f00000493011001c70000800d0200003900000002030000390000049404000041000000110500002911ad10740000040f0000000100200190000009810000613d000000110100002900000010020000290000000f0300002911ad0f200000040f0000000c0200002900000000020204330000000e03000029000000c0033000390000000003030433000000400400043d00000020054000390000000006000411000000000065043500000040054000390000000f06000029000000000065043500000485033001970000006005400039000000000035043500000010030000290000000000340435000000800340003900000000000304350000046c0040009c0000046c040080410000004003400210000000000601001900000000010004140000046c0010009c0000046c01008041000000c001100210000000000131019f00000495011001c700000484072001970000800d020000390000000403000039000004960400004100000011050000290000018d0000013d00000ab50000a13d0000000005560019000000000005043500000000033104360000000004040433001100000004001d0000000000430435000000400320003900000000040304330000004003100039000d00000004001d00000000004304350000006001100039000000600220003900000000020204330000000000210435000000400300043d000009570000013d0000000d01000029000004900010009c000006210000213d0000000d010000290000012c01100039000000000012004b00000acc0000a13d00000000020100190000000b01000029000d00000002001d0000000000210435000000100100002900010ad20000003d000010830000013d0000000d0200002900000030022002100000049102200197000000000301041a0000049203300197000000000223019f000000000021041b0000000b0100002900000000010104330000048701100197000000400200043d00000000001204350000046c0020009c0000046c02008041000000400120021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f00000493011001c70000800d0200003900000002030000390000049404000041000000100500002911ad10740000040f00000001002001900000000003000416000009810000613d000000110100002900000000010104330000046c02100197000000100100002911ad0f200000040f00000009020000290000000002020433000000110300002900000000030304330000000f04000029000000c0044000390000000004040433000000400500043d00000080065000390000000107000039000000000076043500000485044001970000006006500039000000000046043500000040045000390000000006000416000000000064043500000020045000390000000e0600002900000000006404350000046c0330019700000000003504350000046c0050009c0000046c050080410000004003500210000000000601001900000000010004140000046c0010009c0000046c01008041000000c001100210000000000131019f00000495011001c700000484072001970000800d020000390000000403000039000004960400004100000010050000290000018d0000013d0000000f0100002900010b1d0000003d000010830000013d0000000102100039000000000202041a0000048c00200198000009700000c13d000000100200035f0000012402200370000000000202043b000004840020009c000009810000213d0000000802200210000004ad022001970000000201100039000000000301041a000004ae03300197000000000223019f000000000021041b000007030000013d0000001101000029000000000101041a000000000001004b000006210000613d0000000d02000029000b000100200092000000000021004b00000b600000613d000000010210008a000000110100002911ad0e2a0000040f000a00000002001d000000000101041a000900000001001d00000011010000290000000b0200002911ad0e2a0000040f0000000a030000290000000303300210000000090430024f000000ff0030008c00000000040020190000000302200210000000010500008a00000000032501cf000000ff0020008c000000000300201900000000022401cf0000000002002019000000000232016f000000000353013f000000000501041a000000000335016f000000000223019f000000000021041b000000000040043f0000000c0100002900010b550000003d000011a80000013d0000000d02000029000000000021041b0000001101000029000000000101041a000000000001004b00000b5f0000c13d000004bf01000041000000000010043f0000003101000039000007260000013d000b00010010009200000011010000290000000b02000029000b00000002001d11ad0e2a0000040f0000000302200210000000010400008a00000000032401cf000000ff0020008c000000000443a13f000000000201041a000000000224016f000000000021041b00000011010000290000000b02000029000000000021041b0000000e01000029000000000010043f0000000c01000029000000200010043f0000004002000039000000000100001911ad10420000040f000000000001041b0000000f01000029000000000010043f000000680100003900010b7c0000003d000010ee0000013d00000010020000290000000202200367000000000202043b0000046c0020009c000009810000213d000000000020043f000000200010043f0000004002000039000000000100001911ad10420000040f000000000001041b0000084f0000013d00000010020000290000046c02200167000000000021004b000006210000213d000000110100002900010b8f0000003d000010f90000013d0000000f0200002900010b920000003d000011090000013d00000489022001970000000e022001af000000000021041b00000003010000290000000001010433000000000001004b0000084f0000613d00000002020000290000000002020433000004850220019711ad0ef90000040f0000084f0000013d0000046c0010009c0000046c01008041000000c0011002100000046c0030009c0000046c030080410000004003300210000000000113019f11ad10740000040f00000060031002700001046c0030019d0003000000010355000000010120018f000000000001042d0002000000000002000200000006001d000100000005001d0000046c0030009c0000046c0300804100000040033002100000046c0040009c0000046c040080410000006004400210000000000334019f0000046c0010009c0000046c01008041000000c001100210000000000113019f11ad10790000040f000000010900002900000060031002700000046c03300197000000020030006c000000020400002900000000040340190000001f0540018f000004dc06400198000000000469001900000bc90000613d000000000701034f000000007807043c0000000009890436000000000049004b00000bc50000c13d000000010220018f000000000005004b00000bd70000613d000000000661034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000001020019000000000001042d0000046c0030009c0000046c0300804100000040033002100000046c0040009c0000046c040080410000006004400210000000000334019f0000046c0010009c0000046c01008041000000c001100210000000000113019f11ad107e0000040f00000060031002700001046c0030019d0003000000010355000000010120018f000000000001042d00000000430104340000048703300197000000000332043600000000040404330000048704400197000000000043043500000040031000390000000003030433000004850330019700000040042000390000000000340435000000600310003900000000030304330000046c0330019700000060042000390000000000340435000000800310003900000000030304330000046c0330019700000080042000390000000000340435000000a00310003900000000030304330000046c03300197000000a0042000390000000000340435000000c00310003900000000030304330000048503300197000000c0042000390000000000340435000000e0031000390000000003030433000000000003004b0000000003000039000000010300c039000000e0042000390000000000340435000001000310003900000000030304330000048403300197000001000420003900000000003404350000012003100039000000000303043300000487033001970000012004200039000000000034043500000140022000390000014001100039000000000101043300000484011001970000000000120435000000000001042d0001000000000002000004dd0020009c00000c540000813d00000000040100190000001f01200039000000200600008a000000000161016f0000003f01100039000000000561016f000000400100043d0000000005510019000000000015004b00000000070000390000000107004039000004a20050009c00000c540000213d000000010070019000000c540000c13d000000400050043f00000000052104360000000007420019000000000037004b00000c590000213d00000000066201700000001f0720018f0000000204400367000000000365001900000c440000613d000000000804034f0000000009050019000000008a08043c0000000009a90436000000000039004b00000c400000c13d000000000007004b00000c510000613d000000000464034f0000000306700210000000000703043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f000000000043043500000000022500190000000000020435000000000001042d000004bf0100004100010c570000003d000011950000013d000004c001000041000011af00010430000011930000013d000004a90010009c00000c710000213d000001230010008c00000c710000a13d00000002030003670000010402300370000000000202043b000004a20020009c00000c710000213d0000002304200039000000000014004b00000c710000813d0000000404200039000000000343034f000000000303043b000004a20030009c00000c710000213d00000024022000390000000004230019000000000014004b00000c710000213d0000000401000039000000000001042d000011930000013d000000000301043300000000023204360000000004000019000000000034004b00000c820000813d000000200110003900000000050104330000000065050434000004840550019700000000055204360000000006060433000004850660019700000000006504350000000104400039000000400220003900000c750000013d0000000001020019000000000001042d0000003301000039000000000101041a00000485011001970000000002000411000000000021004b00000c8b0000c13d000000000001042d000000400100043d0000004402100039000004de0300004100000000003204350000049b02000041000000000021043500000024021000390000002003000039000000000032043500000004021000390000000000320435000000640200003911ad10300000040f000000000601001900000485011001970000003302000039000000000302041a0000049f04300197000000000114019f000000000012041b000000400100043d0000046c0010009c0000046c01008041000000400110021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f0000048505300197000004af011001c70000800d020000390000000303000039000004b40400004111ad10740000040f000000010020019000000cb10000613d000000000001042d000011930000013d000000000001004b00000cb50000613d000000000001042d000000400100043d0000006402100039000004df0300004100000000003204350000004402100039000004e003000041000000000032043500000024021000390000002c0300003900000000003204350000049b02000041000010a20000013d000000000001004b00000cc40000613d000000000001042d000000400100043d0000006402100039000004e10300004100000000003204350000004402100039000004e003000041000000000032043500000024021000390000002c0300003900000000003204350000049b02000041000010a20000013d000000000001004b00000cd30000613d000000000001042d000000400100043d0000006402100039000004e20300004100000000003204350000004402100039000004e30300004100000000003204350000002402100039000000290300003900000000003204350000049b02000041000010a20000013d0000006002100039000004e40300004100000000003204350000004002100039000004e503000041000000000032043500000020021000390000002e030000390000000000320435000000200200003900000000002104350000008001100039000000000001042d0002000000000002000100000001001d000200000001001d000080020100003900000024030000390000000004000415000000020440008a0000000504400210000004c10200004111ad10560000040f000000000001004b00000d000000613d00000001010000290000048501100197000004b802000041000000000302041a0000049f03300197000000000113019f000000000012041b000000000001042d000000400100043d0000006402100039000004e60300004100000000003204350000004402100039000004e703000041000000000032043500000024021000390000002d0300003900000000003204350000049b02000041000010a20000013d0001000000000002000000010200003200000d340000613d000004dd0020009c00000d360000813d0000001f01200039000000200300008a000000000131016f0000003f01100039000000000431016f000000400100043d0000000004410019000000000014004b00000000050000390000000105004039000004a20040009c00000d360000213d000000010050019000000d360000c13d000000400040043f000000000621043600000000033201700000001f0420018f0000000002360019000000030500036700000d2b0000613d000000000705034f000000007807043c0000000006860436000000000026004b00000d270000c13d000000000004004b00000d350000613d000000000335034f0000000304400210000000000502043300010d320000003d000011990000013d0000000000320435000000000001042d0000006001000039000000000001042d000004bf0100004100010d390000003d000011950000013d000004c001000041000011af000104300003000000000002000000000603001900000000050200190000000032030434000000000005004b00000d510000613d000000000002004b00000d4f0000c13d000300000001001d000080020100003900000024030000390000000004000415000000030440008a0000000504400210000004c102000041000200000006001d11ad10560000040f0000000206000029000000000001004b00000d690000613d0000000001060019000000000001042d000000000002004b00000d670000c13d000000400500043d000200000005001d0000049b01000041000000000015043500000004015000390000002002000039000000000021043500000024025000390000000013040434000100000003001d0000000000320435000000440250003911ad0d720000040f00000001010000290000001f01100039000000200200008a000000000121016f0000004402100039000000020100002911ad10300000040f000000000103001911ad10300000040f000000400100043d0000004402100039000004e803000041000000000032043500000024021000390000001d0300003900000000003204350000049b020000410000115f0000013d0000000004000019000000000034004b00000d7b0000813d0000000005240019000000000614001900000000060604330000000000650435000000200440003900000d730000013d00000d7e0000a13d00000000012300190000000000010435000000000001042d000000000001004b00000d820000613d000000000001042d000000400100043d0000006402100039000004e90300004100000000003204350000004402100039000004ea03000041000000000032043500000024021000390000002b0300003900000000003204350000049b02000041000010a20000013d0003000000000002000000400200043d000004eb0020009c00000dec0000813d000000c003200039000000400030043f000000a00320003900000000000304350000008003200039000000000003043500000060032000390000000000030435000000400320003900000000000304350000002003200039000000000003043500000000000204350000006502000039000000000202041a000000400500043d000004ec0300004100000000043504360000000403500039000000000013043500000000010004140000048502200197000000040020008c00000db50000613d000200000004001d0000002404000039000000c0060000390000000003050019000300000005001d000000030500002911ad0bab0000040f00000002040000290000000305000029000000000001004b00000df10000613d00000001020000310000001f01200039000000200300008a000000000331016f0000000001530019000000000031004b00000000030000390000000103004039000004a20010009c00000dec0000213d000000010030019000000dec0000c13d000000400010043f000004a90020009c00000deb0000213d000000c00020008c00000deb0000413d000004a10010009c00000dec0000213d000000c002100039000000400020043f0000000002050433000004850020009c00000deb0000213d00000000022104360000000003040433000004840030009c00000deb0000213d000000000032043500000040025000390000000002020433000004850020009c00000deb0000213d00000040031000390000000000230435000000600250003900010ddb0000003d000011500000013d00000deb0000c13d00000060031000390000000000230435000000800250003900010de10000003d000011500000013d00000deb0000c13d00000080031000390000000000230435000000a00250003900010de70000003d000011500000013d00000deb0000c13d000000a0031000390000000000230435000000000001042d000011930000013d000004bf0100004100010def0000003d000011950000013d000004c001000041000011af0001043000010df30000003d000011320000013d00000dfa0000613d000000000704034f0000000008010019000000007907043c0000000008980436000000000038004b00000df60000c13d000000000006004b00000dfe0000613d00010dfe0000003d0000108a0000013d11ad10300000040f00010000000000020000000002010019000000400100043d000004db0010009c00000e250000813d00010e060000003d0000118b0000013d000004870330019700000020051000390000000000350435000004870340019700010e0c0000003d000011830000013d0000046c05300197000000000054043500000040043002700000046c04400197000000a005100039000000000045043500000020033002700000046c03300197000000800410003900000000003404350000000202200039000000000202041a000000980320027000000484033001970000014004100039000000000034043500000068032002700000048703300197000001200410003900000000003404350000000803200270000004840330019700010e240000003d000011740000013d000000000001042d000004bf0100004100010e280000003d000011950000013d000004c001000041000011af000104300001000000000002000000000301041a000100000002001d000000000023004b00000e360000a13d000000000010043f0000002002000039000000000100001911ad10420000040f00000001011000290000000002000019000000000001042d000004bf01000041000000000010043f0000003201000039000000040010043f000004c001000041000011af000104300004000000000002000300000002001d000000000020043f000400000001001d0000000101100039000200000001001d00010e440000003d000010f30000013d000000000001004b000000000100001900000e480000613d000000000001042d0000000401000029000000000201041a000004dd0020009c00000e690000813d00000001032000390000000401000029000000000031041b11ad0e2a0000040f0000000302200210000000010300008a00000000042301cf000000ff0020008c0000000004002019000000030500002900000000022501cf0000000002002019000000000242016f000000000334013f000000000401041a000000000334016f000000000223019f000000000021041b0000000401000029000000000101041a000400000001001d000000000050043f000000020100002900010e650000003d000010a80000013d0000000402000029000000000021041b0000000101000039000000000001042d000004bf0100004100010e6c0000003d000011950000013d000004c001000041000011af00010430000100000000000200000000030100190000000001120049000004a90010009c00000eab0000213d000000ff0010008c00000eab0000a13d000000400100043d000004ed0010009c00000eac0000813d0000010002100039000000400020043f0000000202000367000000000432034f000000000404043b00000000044104360000002005300039000000000552034f000000000505043b00000000005404350000004003300039000000000432034f000000000404043b000004850040009c00000eab0000213d000000400510003900000000004504350000002003300039000000000432034f000000000404043b0000046c0040009c00000eab0000213d000000600510003900000000004504350000002003300039000000000432034f000000000404043b000004870040009c00000eab0000213d000000800510003900000000004504350000002004300039000000000442034f000000000404043b000000a00510003900000000004504350000004003300039000000000432034f000000000404043b0000046c0040009c00000eab0000213d000000c00510003900000000004504350000002003300039000000000232034f000000000202043b000000ff0020008c00000eab0000213d000000e0031000390000000000230435000000000001042d000011930000013d000004bf0100004100010eaf0000003d000011950000013d000004c001000041000011af000104300001000000000002000000400100043d000004db0010009c00000ecd0000813d0000016002100039000000400020043f000001400210003900000000000204350000012002100039000000000002043500000100021000390000000000020435000000e0021000390000000000020435000000c0021000390000000000020435000000a0021000390000000000020435000000800210003900000000000204350000006002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000001042d000004bf0100004100010ed00000003d000011950000013d000004c001000041000011af000104300001000000000002000004dd0010009c00000ef40000813d000000000201001900000005031002100000003f01300039000004ee04100197000000400100043d0000000004410019000000000014004b00000000050000390000000105004039000004a20040009c00000ef40000213d000000010050019000000ef40000c13d000000400040043f00000000022104360000000004000019000000000034004b00000ef30000813d000000400500043d000004880050009c00000ef40000213d0000004006500039000000400060043f00000020065000390000000000060435000000000005043500000000064200190000000000560435000000200440003900000ee50000013d000000000001042d000004bf0100004100010ef70000003d000011950000013d000004c001000041000011af0001043000010000000000020000000005010019000000400300043d00000000010004140000048504200197000000040040008c00000f020000c13d000000010100003900000f170000013d000000000005004b00000f150000613d0000046c0030009c0000046c0300804100000040023002100000046c0010009c0000046c01008041000000c001100210000000000121019f000004af011001c700008009020000390000000003050019000000000500001911ad10740000040f00000060031002700001046c0030019d0003000000010355000000010120018f00000f170000013d000000000204001911ad0b9e0000040f000100000001001d11ad0d0c0000040f000000010000006b00000f1c0000613d000000000001042d000004ef01000041000000000010043f0000049801000041000011af000104300004000000000002000300000003001d000200000002001d000400000001001d000000000010043f000000670100003900010f280000003d000010a80000013d000000000301041a0000000201000029000000e001100210000000400200043d000000600420003900000000001404350000004001200039000000040400002900000000004104350000000301000029000000a001100210000000640420003900000000001404350000002001200039000000000031043500000050030000390000000000320435000004f00020009c00000f4b0000813d0000008003200039000000400030043f000000000202043311ad10420000040f0000000402000029000000000020043f0000006702000039000000200020043f000400000001001d0000004002000039000000000100001911ad10420000040f0000000402000029000000000021041b0000000001020019000000000001042d000004bf0100004100010f4e0000003d000011950000013d000004c001000041000011af00010430000000ff0990018f000001000a10003900000000009a04350000046c08800197000000e0091000390000000000890435000000c00810003900000000007804350000048706600197000000a00710003900000000006704350000046c05500197000000800610003900000000005604350000048504400197000000600510003900000000004504350000004004100039000000000034043500000020031000390000000000230435000004f10200004100000000002104350000012001100039000000000001042d0001000000000002000000400300043d0000000045020434000000410050008c00000f8a0000c13d00000040052000390000000005050433000004f30050009c00000f970000213d0000006002200039000000000202043300000000040404330000006006300039000000000056043500000040053000390000000000450435000000f802200270000000200430003900000000002404350000000000130435000000000000043f0000000001000414000000010200003900000080040000390000002006000039000000000500001911ad0bab0000040f000000000001004b00000fa80000613d000000000100043d000004850010019800000fb60000613d000000000001042d0000004401300039000004f202000041000000000021043500000024013000390000001f0200003900000000002104350000049b010000410000000000130435000000040130003900000020020000390000000000210435000000640200003900000fa60000013d0000006401300039000004f50200004100000000002104350000004401300039000004f60200004100000000002104350000002401300039000000220200003900000000002104350000049b0100004100000000001304350000000401300039000000200200003900000000002104350000008402000039000000000103001911ad10300000040f00010faa0000003d000011320000013d00000fb10000613d000000000704034f0000000008010019000000007907043c0000000008980436000000000038004b00000fad0000c13d000000000006004b00000fb50000613d00010fb50000003d0000108a0000013d11ad10300000040f000000400100043d0000004402100039000004f40300004100000000003204350000002402100039000000180300003900000000003204350000049b020000410000115f0000013d00020000000000020000006502000039000000000202041a000000400300043d000004f704000041000000000043043500000485011001970000000404300039000000000014043500000000010004140000048502200197000000040020008c00000fd40000613d00000024040000390000002006000039000200000003001d000000020500002911ad0bab0000040f0000000203000029000000000001004b00000ff50000613d00000001010000310000001f02100039000000200400008a000000000442016f0000000002340019000000000042004b00000000040000390000000104004039000004a20020009c00000fec0000213d000000010040019000000fec0000c13d000000400020043f000004a90010009c00000ff10000213d000000200010008c00000ff10000413d0000000001030433000000000001004b0000000002000039000000010200c039000000000021004b00000ff40000c13d000000000001042d000004bf0100004100010fef0000003d000011950000013d000004c001000041000011af000104300000000001000019000000000200001911ad10300000040f000011930000013d00010ff70000003d000011320000013d00000ffe0000613d000000000704034f0000000008010019000000007907043c0000000008980436000000000038004b00000ffa0000c13d000000000006004b000010020000613d000110020000003d0000108a0000013d11ad10300000040f0004000000000002000000400300043d000300000003001d0000006001300039000004f80200004100000000002104350000004001300039000004f90200004100000000002104350000002002300039000004fa01000041000200000002001d00000000001204350000800b0100003900000004030000390000000004000415000000040440008a0000000504400210000004fb0200004111ad10560000040f0000000304000029000000c002400039000004fc030000410000000000320435000000a0024000390000000003000410000000000032043500000080024000390000000000120435000000c0010000390000000000140435000004fd0040009c0000102a0000813d000000e001400039000000400010043f0000000002040433000000020100002911ad10420000040f000000000001042d000004bf010000410001102d0000003d000011950000013d000004c001000041000011af00010430000000000001042f0000046c0010009c0000046c0100804100000040011002100000046c0020009c0000046c020080410000006002200210000000000112019f000011af000104300000046c0010009c0000046c0100804100000040011002100000046c0020009c0000046c020080410000006002200210000000000112019f000000e002300210000000000121019f000011ae0001042e0000046c0010009c0000046c0100804100000040011002100000046c0020009c0000046c020080410000006002200210000000000112019f00000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f000004af011001c7000080100200003911ad10790000040f0000000100200190000010550000613d000000000101043b000000000001042d000011930000013d00000000050100190000000000200443000000050030008c000010640000413d000000040100003900000000020000190000000506200210000000000664001900000005066002700000000006060031000000000161043a0000000102200039000000000031004b0000105c0000413d0000046c0030009c0000046c03008041000000600130021000000000020004140000046c0020009c0000046c02008041000000c002200210000000000112019f000004fe011001c7000000000205001911ad10790000040f0000000100200190000010730000613d000000000101043b000000000001042d000000000001042f00001077002104210000000102000039000000000001042d0000000002000019000000000001042d0000107c002104230000000102000039000000000001042d0000000002000019000000000001042d00001081002104250000000102000039000000000001042d0000000002000019000000000001042d000000000010043f0000006601000039000000200010043f0000004002000039000000000100001911ad10420000040f000000010000013b000000000454034f0000000305600210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f0000000000430435000000010000013b000000000101043b000000000001004b0000000002000039000000010200c039000000000021004b000000010000013b0000800b0100003900000004030000390000000004000415000000140440008a0000000504400210000000010000013b0000000000210435000000040210003900000020030000390000000000320435000000840200003911ad10300000040f000000200010043f0000004002000039000000000100001911ad10420000040f000000010000013b000000200010043f0000004002000039000000000100001911ad10420000040f0000001102000029000000000020043f000000200010043f0000000001000019000000400200003911ad10420000040f000000010000013b000000200010043f0000004002000039000000000100001911ad10420000040f0000000e02000029000000010000013b000000000020043f000000200010043f0000000001000019000000400200003911ad10420000040f000000010000013b0000000f01000029000000000010043f0000006601000039000000200010043f0000004002000039000000000100001911ad10420000040f0000000101100039000000000201041a000000010000013b000d00000002001d000000a001600039000000000701043300000020016000390000000003010433000000c00160003900000000010104330000006002600039000000000502043300000000020604330000008006600039000c00000006001d0000000006060433000000400900043d001000000009001d000000010000013b000000000104001911ad0c5a0000040f001000000002001d000f00000003001d0000000002000031000e00000001001d11ad0e6e0000040f001100000001001d000000000300003100000010010000290000000f0200002911ad0c220000040f000000110600002900000000020100190000000001000411000000010000013b000000200010043f0000000001000019000000400200003911ad10420000040f000000010000013b000000200010043f0000004002000039000000000100001911ad10420000040f000000000101041a000000010000013b000000000010043f0000006901000039000000200010043f0000004002000039000000000100001911ad10420000040f000000010000013b0000000001000412001400000001001d001300000000003d000080050100003900000044030000390000000004000415000000140440008a0000000504400210000000010000013b000000000020043f000000200010043f0000000001000019000000400200003911ad10420000040f000000000201041a000000010000013b000f00000001001d11ad0f500000040f00000010030000290000000001310049000000200210008a00000000002304350000001f01100039000000200200008a000000000221016f0000000001320019000000000021004b00000000020000390000000102004039000000010000013b000000000010043f0000006601000039000000200010043f0000004002000039000000000100001911ad10420000040f11ad0dff0000040f000000010000013b00000011010000290000000001010433000000000010043f0000006b01000039000000200010043f0000004002000039000000000100001911ad10420000040f000000100200002911ad0e3c0000040f000000000001004b000000010000013b0000000304000367000000200100008a000000010200003100000000051201700000001f0620018f000000400100043d0000000003510019000000010000013b000000400200043d000000200320003900000000004304350000002204200039000000000014043500000042010000390000000000120435000000420120003900000010040000290000000000410435000000010000013b0000000001010433000c00000001001d0000001001000029000000000010043f0000006601000039000000200010043f0000000001000019000000400200003911ad10420000040f0000000c02000029000000010000013b0000000002020433000000000002004b0000000003000039000000010300c039000000000032004b000000010000013b00000001010000310000001f02100039000000200300008a000000000332016f0000000002530019000000000032004b00000000030000390000000103004039000000010000013b0000000000210435000000040210003900000020030000390000000000320435000000640200003911ad10300000040f0000008001200039000000400010043f0000000002020433000000000103001911ad10420000040f0000000d0200002911ad0f690000040f000000010000013b000000400010043f00000000020304330000000f0100002911ad10420000040f001000000001001d11ad10030000040f000000010000013b00000100041000390000000000340435000000ff002001900000000002000039000000010200c039000000e0031000390000000000230435000000010000013b0000000001000039000000010100603911ad0cd00000040f000000110100002911ad0cec0000040f000000400100043d000000010000013b00000000003104350000000103200039000000000303041a000000c004100039000000600530027000000000005404350000006004100039000000010000013b0000016003100039000000400030043f0000004003100039000000000402041a000000600540027000000000005304350000003003400270000000010000013b0000000001000019000011af00010430000000000010043f0000004101000039000000040010043f000000010000013b00000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f000000010000013b000000000020043f000000200010043f0000000001000019000000400200003911ad10420000040f000000400200043d000000010000013b000000200010043f0000004002000039000000000100001911ad10420000040f000000010000013b000011ad00000432000011ae0001042e000011af0001043000000000000000000000000000000000000000000000000000000000ffffffff000000020000000000000000000000000000008000000100000000000000000000000000000000000000000000000000000000000000000000000000fae4e4880000000000000000000000000000000000000000000000000000000013b5d9e6000000000000000000000000000000000000000000000000000000001a8d3792000000000000000000000000000000000000000000000000000000003012a1d0000000000000000000000000000000000000000000000000000000003659cfe600000000000000000000000000000000000000000000000000000000485cc95500000000000000000000000000000000000000000000000000000000494a76d9000000000000000000000000000000000000000000000000000000004f1ef2860000000000000000000000000000000000000000000000000000000052d1902d000000000000000000000000000000000000000000000000000000005da320b400000000000000000000000000000000000000000000000000000000715018a60000000000000000000000000000000000000000000000000000000077c14320000000000000000000000000000000000000000000000000000000007e4edf70000000000000000000000000000000000000000000000000000000008da5cb5b000000000000000000000000000000000000000000000000000000008dd91864000000000000000000000000000000000000000000000000000000009cc163e500000000000000000000000000000000000000000000000000000000c4804ce200000000000000000000000000000000000000000000000000000000c617bfa600000000000000000000000000000000000000000000000000000000ceab8e1900000000000000000000000000000000000000000000000000000000dd48aaaf00000000000000000000000000000000000000000000000000000000f2fde38b000000000000000000000000000000000000000000000000000000000ae941030000000000000000000000000000000000000000ffffffffffffffffffffffff000000000000000000000000ffffffffffffffffffffffffffffffffffffffff796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d955391320000000000000000000000000000000000000000000000000000ffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffbfffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000ffffffff00000000ffffffffffffffffffffffffffffffffffffffffffffffff00000000ffffffff0000000000000000000000000000000000000000ffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff00000000ffffffffffffffff00ffffffffffffffffffffffff00000000000000000000000000000000000000ff000000000000000000000000ffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000fffffffffed30000000000000000000000000000000000000000ffffffffffff000000000000ffffffffffffffffffffffffffffffffffffffff000000000000ffffffffffff0200000000000000000000000000000000000020000000000000000000000000bae677f66fd8fbcf032e7230df264d3a20efb007eca7bc6793304e0be8f7205a02000000000000000000000000000000000000a0000000000000000000000000c0ba1da4c626584ae8d7891d28901f7f37729646868d75af81d3bd99c2c1a3963517da0400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000000000064647265737300000000000000000000000000000000000000000000000000004f776e61626c653a206e6577206f776e657220697320746865207a65726f206108c379a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000ffffffffffffffffffffffffffffffffffffffff000000000000000000000000c6388ef700000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff00000000000000000000000000000000000000002059de7800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff3f000000000000000000000000000000000000000000000000ffffffffffffffff000000000000000000000000000000000000000000000000fffffffffffffeff1901000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff7f201dc6f500000000000000000000000000000000000000000000000000000000ccfad018000000000000000000000000000000000000000000000000000000008da5cb5b000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000ffffffffffff00000000000000000000000000ffffffffffffffffffffffffff000000000000ffffffffffffffffffffffffff00000000000000000000000000000000000000ffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffff000000000000000000000000ff02000000000000000000000000000000000000000000000000000000000000005b6bcbd593bccf88b5035e118227608b2364ff5ab65aa173c15e29ed0f8388110083126e978d4fdf3b645a1cac083126e978d4fdf3b645a1cac083126e978d4f020000000000000000000000000000000000006000000000000000000000000053c2a8252078e2d170ed485279f20e9fbc9a31edc453ea98250fa5cbfb6432d68be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0310ab089e4439a4c15d089f94afb7896ff553aecb10793d0ab882de59d99a32e555550535570677261646561626c653a206d757374206e6f742062652063616c6c6564207468726f7567682064656c656761746563616c6c0000000000000000360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd914352d1902d00000000000000000000000000000000000000000000000000000000bc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b000000000000000000000000000000000000000000000000ffffffffffffff9f206661696c656400000000000000000000000000000000000000000000000000416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c4e487b710000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b83647920696e697469616c697a6564000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e747261637420697320616c7265617f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb3847402498000000000000000000000000000000000000000000000000ffffffffffffffdf82b42900000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000040000000000000000000000000ba85505a71c5b1789e1357fee7e9e22da158b6c570e1b711a6efe27b61be645dffffffffffffffffffffffffffffffffffffffffffffffff0000000100000000a88a48e300000000000000000000000000000000000000000000000000000000ed3c247c000000000000000000000000000000000000000000000000000000008baa579f000000000000000000000000000000000000000000000000000000009a04794d00000000000000000000000000000000000000000000000000000000cdf4ceca000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffff6c580fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff6c580000000000000000000000000000000000000000000000000fffffffffffffe9fff000000000000000000000000000000000000000000000000000000000000002a64ac2f583e4882d53a07723d8ba198e44c455bd84a12959f10f2dd220b67a77d5ba07f00000000000000000000000000000000000000000000000000000000ddf990f9000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000047fc9aa0000000000000000000000000000000000000000000000000000000018160ddd000000000000000000000000000000000000000000000000000000002ddcb21f00000000000000000000000000000000000000000000000000000000566563746f7220646f65736e2774206578697374000000000000000000000000000000000000000000000000000000000000000000000000fffffffffffffea000000000000000000000000000000000000000000000000000000000ffffffe000000000000000000000000000000000000000000000000100000000000000004f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657264656c656761746563616c6c000000000000000000000000000000000000000046756e6374696f6e206d7573742062652063616c6c6564207468726f756768206163746976652070726f787900000000000000000000000000000000000000006961626c6555554944000000000000000000000000000000000000000000000045524331393637557067726164653a20756e737570706f727465642070726f786f6e206973206e6f74205555505300000000000000000000000000000000000045524331393637557067726164653a206e657720696d706c656d656e746174696f74206120636f6e747261637400000000000000000000000000000000000000455243313936373a206e657720696d706c656d656e746174696f6e206973206e416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006e697469616c697a696e67000000000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e7472616374206973206e6f742069000000000000000000000000000000000000000000000000ffffffffffffff400410501800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0f9ad387200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff80a9accd45695a721aca33e1224254ff563220e1765ba1b89c350834a6ad4c54fd45434453413a20696e76616c6964207369676e6174757265206c656e677468007fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a045434453413a20696e76616c6964207369676e61747572650000000000000000756500000000000000000000000000000000000000000000000000000000000045434453413a20696e76616c6964207369676e6174757265202773272076616ce2f66b1e00000000000000000000000000000000000000000000000000000000c89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc642ef9e7ac4a9ac8ff505b5257b63e7b5f2271ba58e5fb6c9ef7bcfa02040957ad87cd6ef79d4e2b95e15ce8abf732db51ec771f1ca2edccf22a46c729ac564729a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b960bb3ecd14c38754109e5fe3a3b72aa0434091106c0fea200392fd413d44da0000000000000000000000000000000000000000000000000ffffffffffffff2002000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000b11892a185906e0d5fcb82d99185acb7eb49873b2f41611b7e462dabd9e921df