Contract

Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// SPDX-License-Identifier: MIT 
pragma solidity 0.8.24;

import {IERC721} from "./../lib/openzeppelin-contracts/contracts/token/ERC721/IERC721.sol";

import {SafeERC20, IERC20} from "./../lib/openzeppelin-contracts/contracts/token/ERC20/utils/SafeERC20.sol";
import {Ownable2Step, Ownable} from "openzeppelin-contracts/contracts/access/Ownable2Step.sol";
import {Pausable} from "openzeppelin-contracts/contracts/utils/Pausable.sol";

import {IModule} from "./IModule.sol";
import {IDelegateRegistry} from "./IDelegateRegistry.sol";

import "./Events.sol";
import "./Errors.sol";

/**
 * @title NftStreaming
 * @custom:version 1.0
 * @custom:author Calnix(@cal_nix)
 * @notice Contract to stream token rewards to NFT holders 
 */

contract NftStreaming is Pausable, Ownable2Step {
    using SafeERC20 for IERC20;

    // assets
    IERC721 public immutable NFT;
    IERC20 public immutable TOKEN;

    // external 
    address public immutable DELEGATE_REGISTRY;  // https://docs.delegate.xyz/technical-documentation/delegate-registry/contract-addresses

    // total supply of NFTs
    uint256 public constant totalSupply = 8_888;
    
    // stream period
    uint256 public immutable startTime;
    uint256 public immutable endTime;
    
    // allocation
    uint256 public immutable allocationPerNft;    // expressed together with appropriate decimal precision [1 ether -> 1e18]
    uint256 public immutable emissionPerSecond;   // per NFT
    uint256 public immutable totalAllocation;

    // financing
    address public depositor;
    uint256 public totalClaimed;
    uint256 public totalDeposited;
    
    // optional: Users can claim until this timestamp
    uint256 public deadline;    

    // operator role: can pause, cannot unpause
    address public operator;            

    // emergency state: 1 is Frozed. 0 is not.
    uint256 public isFrozen;

    /**
     * @notice Struct encapsulating the claimed and refunded amounts, all denoted in units of the asset's decimals.
     * @dev Because the claimed amount and lastTimestamp are often read together, declaring them in the same slot saves gas.
     * @param claimed The cumulative amount withdrawn from the stream.
     * @param lastClaimedTimestamp Last claim time
     * @param isPaused Is the stream paused 
     */
    struct Stream {
        // slot0
        uint128 claimed;
        uint128 lastClaimedTimestamp;
        // slot 1
        bool isPaused;
    }

    // Streams 
    mapping(uint256 tokenId => Stream stream) public streams;
    
    // Trusted contracts to call
    mapping(address module => bool isRegistered) public modules;    

    // note: uint128(allocationPerNft) is used to ensure downstream calculations involving claimable do not overflow
    constructor(
        address nft, address token, address owner, address depositor_, address operator_, address delegateRegistry,
        uint128 allocationPerNft_, uint256 startTime_, uint256 endTime_) Ownable(owner) {
             
        // check inputs 
        if(startTime_ <= block.timestamp) revert InvalidStartime();
        if(endTime_ <= startTime_) revert InvalidEndTime(); 
        if(allocationPerNft_ == 0) revert InvalidAllocation();

        // calculate emissionPerSecond
        uint256 period = endTime_ - startTime_;       
        uint256 emissionPerSecond_ = allocationPerNft_ / period; 
        if(emissionPerSecond_ == 0) revert InvalidEmission();

        /**
            Note:
                Solidity rounds down on division, 
                so there could be disregarded remainder on calc. emissionPerSecond

                Therefore, the remainder is distributed on the last tick,
                as seen in the if statement in _calculateClaimable()
         */

        // update storage
        NFT = IERC721(nft);
        TOKEN = IERC20(token);
        DELEGATE_REGISTRY = delegateRegistry;

        depositor = depositor_;
        operator = operator_;

        startTime = startTime_;
        endTime = endTime_;
        emissionPerSecond = emissionPerSecond_;

        allocationPerNft = uint256(allocationPerNft_);        
        totalAllocation = allocationPerNft_ * totalSupply;

        deadline = 1791709200;
    }

    /*//////////////////////////////////////////////////////////////
                                 USERS
    //////////////////////////////////////////////////////////////*/

    /**
     * @notice Users to claim for a single Nft
     * @dev msg.sender must be owner of Nft
     * @param tokenId Nft's tokenId
     */
    function claimSingle(uint256 tokenId) external whenStartedAndBeforeDeadline whenNotPaused {

        // validate ownership
        address ownerOf = NFT.ownerOf(tokenId);
        if(msg.sender != ownerOf) revert InvalidOwner();  
        
        uint256 claimable = _updateLastClaimed(tokenId);

        // update totalClaimed
        totalClaimed += claimable;

        emit ClaimedSingle(msg.sender, tokenId, claimable);
 
        //transfer 
        TOKEN.safeTransfer(msg.sender, claimable);        
    }

    /**
     * @notice Users to claim for multiple Nfts
     * @dev msg.sender must be owner of all Nfts
     * @param tokenIds Nfts' tokenId
     */    
    function claim(uint256[] calldata tokenIds) external whenStartedAndBeforeDeadline whenNotPaused {
        
        // array validation
        uint256 tokenIdsLength = tokenIds.length;
        if(tokenIdsLength == 0) revert EmptyArray(); 


        uint256 totalAmount;
        uint256[] memory amounts = new uint256[](tokenIdsLength);
        for (uint256 i = 0; i < tokenIdsLength; ++i) {

            uint256 tokenId = tokenIds[i];

            // validate ownership: msg.sender == ownerOf
            address ownerOf = NFT.ownerOf(tokenId);
            if(msg.sender != ownerOf) revert InvalidOwner();  

            // update claims
            uint256 claimable = _updateLastClaimed(tokenId);
            
            amounts[i] = claimable;
            totalAmount += claimable;
        }
        
        // update totalClaimed
        totalClaimed += totalAmount;

        // claimed per tokenId
        emit Claimed(msg.sender, tokenIds, amounts);
 
        // transfer all
        TOKEN.safeTransfer(msg.sender, totalAmount);      
    }

    /**
     * @notice Users to claim via delegated hot wallets
     * @dev Expects tokenIds to be ordered based on common ownership: [ownerA, ownerA, ownerB]
     * @param tokenIds Nfts' tokenId
     */  
    function claimDelegated(uint256[] calldata tokenIds) external whenStartedAndBeforeDeadline whenNotPaused {
        
        // array validation
        uint256 tokenIdsLength = tokenIds.length;
        if(tokenIdsLength == 0) revert EmptyArray(); 

        // check delegation on msg.sender
        bytes[] memory data = new bytes[](tokenIdsLength);
        address[] memory owners = new address[](tokenIdsLength);
        for (uint256 i = 0; i < tokenIdsLength; ++i) {
            
            uint256 tokenId = tokenIds[i];

            // get and store nft Owner
            address nftOwner = NFT.ownerOf(tokenId);          
            owners[i] = nftOwner;

            // data for multicall
            data[i] = abi.encodeCall(IDelegateRegistry(DELEGATE_REGISTRY).checkDelegateForERC721, 
                        (msg.sender, nftOwner, address(NFT), tokenId, ""));
        }
        
        // data for staticCall
        bytes memory staticData = abi.encodeCall(IDelegateRegistry(DELEGATE_REGISTRY).multicall, data); 
        
        // staticCall
        (bool success, bytes memory result) = DELEGATE_REGISTRY.staticcall(staticData); 
        if (!success) revert StaticCallFailed();

        // if a tokenId is not delegated will return false; as a bool
        bytes[] memory results = abi.decode(result, (bytes[]));

        uint256 totalAmount;
        uint256[] memory amounts = new uint256[](tokenIdsLength);

        address addressCache; 
        uint256 amountCache;

        for (uint256 i = 0; i < tokenIdsLength; ++i) {
            
            // multiCall uses delegateCall: decode return data
            bool isDelegated = abi.decode(results[i], (bool));
            if(!isDelegated) revert InvalidDelegate();

            // update tokenId: storage is updated
            uint256 tokenId = tokenIds[i];
            uint256 claimable = _updateLastClaimed(tokenId);
            
            totalAmount += claimable;
            amounts[i] = claimable;

            // initial reference
            if (i == 0) {

                addressCache = owners[i];
                amountCache = claimable;

            } else { 

                // check owner matches previous tokenid's owner
                if (addressCache == owners[i]) {
                    // increment amountCache
                    amountCache += claimable; 

                } else {  // if different owner from previous token id

                    // transfer current amountCache
                    TOKEN.safeTransfer(addressCache, amountCache); 

                    // update cache to current token id info
                    addressCache = owners[i];
                    amountCache = claimable;
                } 
            }
        }
       

        if (amountCache != 0) {
            TOKEN.safeTransfer(addressCache, amountCache); 
        }

        // update totalClaimed
        totalClaimed += totalAmount;

        // claimed per tokenId
        emit ClaimedByDelegate(msg.sender, owners, tokenIds, amounts);
    }
    

    /**
     * @notice Users to claim, if nft is locked on some contract (e.g. staking pro)
     * @dev Owner must have enabled module address
     * @param module Nfts' tokenId
     * @param tokenIds Nfts' tokenId
     */  
    function claimViaModule(address module, uint256[] calldata tokenIds) external whenStartedAndBeforeDeadline whenNotPaused {
        if(module == address(0)) revert ZeroAddress();      // in-case someone fat-fingers and allows zero address in modules mapping

        // array validation
        uint256 tokenIdsLength = tokenIds.length;
        if(tokenIdsLength == 0) revert EmptyArray(); 

        // ensure valid module
        if(!modules[module]) revert UnregisteredModule(); 

        // check ownership via moduleCall
        // if not msg.sender is not owner, execution expected to revert within module;
        IModule(module).streamingOwnerCheck(msg.sender, tokenIds);

        uint256 totalAmount;
        uint256[] memory amounts = new uint256[](tokenIdsLength);
        
        for (uint256 i = 0; i < tokenIdsLength; ++i) {

                uint256 tokenId = tokenIds[i];
                uint256 claimable = _updateLastClaimed(tokenId);
                
                totalAmount += claimable;
                amounts[i] = claimable;
        }

        // update totalClaimed
        totalClaimed += totalAmount;

        // claimed per tokenId
        emit ClaimedByModule(module, msg.sender, tokenIds, amounts);

        // transfer 
        TOKEN.safeTransfer(msg.sender, totalAmount);    
    }


    /*//////////////////////////////////////////////////////////////
                                INTERNAL
    //////////////////////////////////////////////////////////////*/

    //note: safeCast not used in downcasting, since overflowing uint128 is not expected
    function _updateLastClaimed(uint256 tokenId) internal returns(uint256) {
        
        // get data
        Stream memory stream = streams[tokenId];

        // stream previously updated: return
        if(stream.lastClaimedTimestamp == block.timestamp) return(0);

        // stream ended: return
        if(stream.lastClaimedTimestamp == endTime) return(0);

        // stream paused: revert
        if(stream.isPaused) revert StreamPaused();

        // calc claimable
        (uint256 claimable, uint256 currentTimestamp) = _calculateClaimable(stream.lastClaimedTimestamp, stream.claimed);

        /** Note: 
            uint128 max value: 340,282,366,920,938,463,463,374,607,431,768,211,455 [340 undecillion]
            If token supply is >= 340 undecillion, SafeCast should be used
         */

        // update timestamp + claimed        
        stream.lastClaimedTimestamp = uint128(currentTimestamp);
        stream.claimed += uint128(claimable);

        // sanity check: ensure does not exceed max
        if(stream.claimed > allocationPerNft) revert IncorrectClaimable();

        // update storage
        streams[tokenId] = stream;

        return claimable;
    }

    function _calculateClaimable(uint128 lastClaimedTimestamp, uint128 claimed) internal view returns(uint256, uint256) {
        
        // currentTimestamp <= endTime
        uint256 currentTimestamp = block.timestamp > endTime ? endTime : block.timestamp;

        // last tick distributes any remainder, above the usual emissionPerSecond
        if (currentTimestamp == endTime) {

            return (allocationPerNft - claimed, currentTimestamp);

        } else {

            // lastClaimedTimestamp >= startTime
            uint256 lastClaimedTimestamp = lastClaimedTimestamp < startTime ? startTime : lastClaimedTimestamp;

            uint256 timeDelta = currentTimestamp - lastClaimedTimestamp;
            uint256 claimable = emissionPerSecond * timeDelta;

            return (claimable, currentTimestamp);
        }
    }

    /*//////////////////////////////////////////////////////////////
                                 OWNER
    //////////////////////////////////////////////////////////////*/

    /**
     * @notice Owner to update deadline variable
     * @dev By default deadline = 0 
     * @param newDeadline must be after last claim round + 14 days
     */
    function updateDeadline(uint256 newDeadline) external onlyOwner {

        // allow for 14 days buffer: prevent malicious premature ending
        // if the newDeadline is in the past: can insta-withdraw w/o informing users
        uint256 latestTime = block.timestamp > endTime ? block.timestamp : endTime;
        if (newDeadline < (latestTime + 14 days)) revert InvalidNewDeadline();

        deadline = newDeadline;
        emit DeadlineUpdated(newDeadline);
    }

    /**
     * @notice Owner to update depositor address
     * @dev Depositor role allows calling of deposit and withdraw fns
     * @param newDepositor new address
     */
    function updateDepositor(address newDepositor) external onlyOwner {
        
        address oldDepositor = depositor;
        depositor = newDepositor;

        emit DepositorUpdated(oldDepositor, newDepositor);
    }

    /**
     * @notice Enable or disable a module. Only Owner.
     * @dev Module is expected to implement fn 'streamingOwnerCheck(address,uint256[])'
     * @param module Address of contract
     * @param set True - enable | False - disable
     */ 
    function updateModule(address module, bool set) external onlyOwner {
        
        modules[module] = set;

        emit ModuleUpdated(module, set);
    }

    /**
     * @notice Owner to update operator role
     * @dev Can be set to address(0) to eliminiate the role
     * @param newOperator new operator address
     */ 
    function updateOperator(address newOperator) external onlyOwner {
        
        address oldOperator = operator;
        operator = newOperator;

        emit OperatorUpdated(oldOperator, newOperator);
    }

    /**
     * @notice Owner or operator can pause streams
     * @param tokenIds Nfts' tokenId
     */ 
    function pauseStreams(uint256[] calldata tokenIds) external {
        
        // if not operator, check if owner; else revert
        if(msg.sender != operator) {
            _checkOwner();
        }


        // array validation
        uint256 tokenIdsLength = tokenIds.length;
        if(tokenIdsLength == 0) revert EmptyArray(); 

        // pause streams
        for (uint256 i = 0; i < tokenIdsLength; ++i) {

            uint256 tokenId = tokenIds[i];

            streams[tokenId].isPaused = true;
        }

        emit StreamsPaused(tokenIds);
    }

    /**
     * @notice Only owner can unpause streams
     */ 
    function unpauseStreams(uint256[] calldata tokenIds) external onlyOwner {

        // array validation
        uint256 tokenIdsLength = tokenIds.length;
        if(tokenIdsLength == 0) revert EmptyArray(); 

        // unpause streams
        for (uint256 i = 0; i < tokenIdsLength; ++i) {

            uint256 tokenId = tokenIds[i];

            delete streams[tokenId].isPaused;
        }        

        emit StreamsUnpaused(tokenIds);

    }

    /*//////////////////////////////////////////////////////////////
                               DEPOSITOR
    //////////////////////////////////////////////////////////////*/

    /**
     * @notice Depositor to deposit the tokens required for streaming
     * @dev Depositor can fund in totality at once or incrementally, 
            to avoid having to commit a large initial sum
     * @param amount Amount to deposit
     */
    function deposit(uint256 amount) external whenNotPaused {
        if(msg.sender != depositor) revert OnlyDepositor(); 

        // surplus check
        if((totalDeposited + amount) > totalAllocation) revert ExcessDeposit(); 

        totalDeposited += amount;

        emit Deposited(msg.sender, amount);

        TOKEN.safeTransferFrom(msg.sender, address(this), amount);
    }


    /**
     * @notice Depositor to withdraw all unclaimed tokens past the specified deadline
     * @dev Only possible if deadline is non-zero and exceeded
     */
    function withdraw() external whenNotPaused {
        if(msg.sender != depositor) revert OnlyDepositor(); 

        // if deadline is not defined; cannot withdraw
        if(deadline == 0) revert WithdrawDisabled();
        
        // can only withdraw after deadline
        if(block.timestamp <= deadline) revert PrematureWithdrawal();

        // only can withdraw what was deposited. disregards random transfers
        uint256 available = totalDeposited - totalClaimed;

        emit Withdrawn(msg.sender, available);

        TOKEN.safeTransfer(msg.sender, available);       

    }


    /*//////////////////////////////////////////////////////////////
                                PAUSABLE
    //////////////////////////////////////////////////////////////*/

    /**
     * @notice Pause claiming, deposit and withdraw
     * @dev Either the operator or owner can call; no one else
     */
    function pause() external whenNotPaused {
        
        // if not operator, check if owner; else revert
        if(msg.sender != operator) {
            _checkOwner();
        }

        _pause();
    }

    /**
     * @notice Unpause claim. Cannot unpause once frozen
     * @dev Only owner can unpause
     */
    function unpause() external onlyOwner whenPaused {
        if(isFrozen == 1) revert IsFrozen(); 

        _unpause();
    }

    /*//////////////////////////////////////////////////////////////
                                RECOVERY
    //////////////////////////////////////////////////////////////*/

    /**
     * @notice Freeze the contract in the event of something untoward occuring
     * @dev Only callable from a paused state, affirming that distribution should not resume
     *      Nothing to be updated. Freeze as is.
            Enables emergencyExit() to be called.
     */
    function freeze() external whenPaused onlyOwner {
        if(isFrozen == 1) revert IsFrozen(); 
        
        isFrozen = 1;

        emit Frozen(block.timestamp);
    }  


    /**
     * @notice Recover assets in a black swan event. 
               Assumed that this contract will no longer be used. 
     * @dev Transfers all tokens to specified address 
     * @param receiver Address of beneficiary of transfer
     */
    function emergencyExit(address receiver) external whenPaused onlyOwner {
        if(isFrozen == 0) revert NotFrozen();

        uint256 balance = TOKEN.balanceOf(address(this));

        emit EmergencyExit(receiver, balance);

        TOKEN.safeTransfer(receiver, balance);
    }


    /*//////////////////////////////////////////////////////////////
                               MODIFIERS
    //////////////////////////////////////////////////////////////*/


    modifier whenStartedAndBeforeDeadline() {

        if(block.timestamp <= startTime) revert NotStarted();

        // check that deadline as not been exceeded; if deadline has been defined
        if(deadline > 0) {
            if (block.timestamp > deadline) {
                revert DeadlineExceeded();
            }
        }

        _;
    }
  


    /*//////////////////////////////////////////////////////////////
                                  VIEW
    //////////////////////////////////////////////////////////////*/

    /**
     * @notice Returns claimable amount for specified tokenId
     * @param tokenId Nft's tokenId
     */ 
    function claimable(uint256 tokenId) external view returns(uint256) {
        
        // get data
        Stream memory stream = streams[tokenId];

        // nothing to claim
        if(stream.lastClaimedTimestamp == block.timestamp) return(0);

        // calc. claimable
        (uint256 claimable, /*uint256 currentTimestamp*/) = _calculateClaimable(stream.lastClaimedTimestamp, stream.claimed);

        return claimable;
    }

}

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

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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

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

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/utils/SafeERC20.sol)

pragma solidity ^0.8.20;

import {IERC20} from "../IERC20.sol";
import {IERC20Permit} from "../extensions/IERC20Permit.sol";
import {Address} from "../../../utils/Address.sol";

/**
 * @title SafeERC20
 * @dev Wrappers around ERC20 operations that throw on failure (when the token
 * contract returns false). Tokens that return no value (and instead revert or
 * throw on failure) are also supported, non-reverting calls are assumed to be
 * successful.
 * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
 * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
 */
library SafeERC20 {
    using Address for address;

    /**
     * @dev An operation with an ERC20 token failed.
     */
    error SafeERC20FailedOperation(address token);

    /**
     * @dev Indicates a failed `decreaseAllowance` request.
     */
    error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease);

    /**
     * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,
     * non-reverting calls are assumed to be successful.
     */
    function safeTransfer(IERC20 token, address to, uint256 value) internal {
        _callOptionalReturn(token, abi.encodeCall(token.transfer, (to, value)));
    }

    /**
     * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the
     * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.
     */
    function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
        _callOptionalReturn(token, abi.encodeCall(token.transferFrom, (from, to, value)));
    }

    /**
     * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
     * non-reverting calls are assumed to be successful.
     */
    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
        uint256 oldAllowance = token.allowance(address(this), spender);
        forceApprove(token, spender, oldAllowance + value);
    }

    /**
     * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no
     * value, non-reverting calls are assumed to be successful.
     */
    function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal {
        unchecked {
            uint256 currentAllowance = token.allowance(address(this), spender);
            if (currentAllowance < requestedDecrease) {
                revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease);
            }
            forceApprove(token, spender, currentAllowance - requestedDecrease);
        }
    }

    /**
     * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,
     * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval
     * to be set to zero before setting it to a non-zero value, such as USDT.
     */
    function forceApprove(IERC20 token, address spender, uint256 value) internal {
        bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value));

        if (!_callOptionalReturnBool(token, approvalCall)) {
            _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0)));
            _callOptionalReturn(token, approvalCall);
        }
    }

    /**
     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
     * on the return value: the return value is optional (but if data is returned, it must not be false).
     * @param token The token targeted by the call.
     * @param data The call data (encoded using abi.encode or one of its variants).
     */
    function _callOptionalReturn(IERC20 token, bytes memory data) private {
        // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
        // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
        // the target address contains contract code and also asserts for success in the low-level call.

        bytes memory returndata = address(token).functionCall(data);
        if (returndata.length != 0 && !abi.decode(returndata, (bool))) {
            revert SafeERC20FailedOperation(address(token));
        }
    }

    /**
     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
     * on the return value: the return value is optional (but if data is returned, it must not be false).
     * @param token The token targeted by the call.
     * @param data The call data (encoded using abi.encode or one of its variants).
     *
     * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.
     */
    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {
        // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
        // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false
        // and not revert is the subcall reverts.

        (bool success, bytes memory returndata) = address(token).call(data);
        return success && (returndata.length == 0 || abi.decode(returndata, (bool))) && address(token).code.length > 0;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable2Step.sol)

pragma solidity ^0.8.20;

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

/**
 * @dev Contract module which provides access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * The initial owner is specified at deployment time in the constructor for `Ownable`. This
 * can later be changed with {transferOwnership} and {acceptOwnership}.
 *
 * This module is used through inheritance. It will make available all functions
 * from parent (Ownable).
 */
abstract contract Ownable2Step is Ownable {
    address private _pendingOwner;

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

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

    /**
     * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual override onlyOwner {
        _pendingOwner = newOwner;
        emit OwnershipTransferStarted(owner(), newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual override {
        delete _pendingOwner;
        super._transferOwnership(newOwner);
    }

    /**
     * @dev The new owner accepts the ownership transfer.
     */
    function acceptOwnership() public virtual {
        address sender = _msgSender();
        if (pendingOwner() != sender) {
            revert OwnableUnauthorizedAccount(sender);
        }
        _transferOwnership(sender);
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (utils/Pausable.sol)

pragma solidity ^0.8.20;

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

/**
 * @dev Contract module which allows children to implement an emergency stop
 * mechanism that can be triggered by an authorized account.
 *
 * This module is used through inheritance. It will make available the
 * modifiers `whenNotPaused` and `whenPaused`, which can be applied to
 * the functions of your contract. Note that they will not be pausable by
 * simply including this module, only once the modifiers are put in place.
 */
abstract contract Pausable is Context {
    bool private _paused;

    /**
     * @dev Emitted when the pause is triggered by `account`.
     */
    event Paused(address account);

    /**
     * @dev Emitted when the pause is lifted by `account`.
     */
    event Unpaused(address account);

    /**
     * @dev The operation failed because the contract is paused.
     */
    error EnforcedPause();

    /**
     * @dev The operation failed because the contract is not paused.
     */
    error ExpectedPause();

    /**
     * @dev Initializes the contract in unpaused state.
     */
    constructor() {
        _paused = false;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is not paused.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    modifier whenNotPaused() {
        _requireNotPaused();
        _;
    }

    /**
     * @dev Modifier to make a function callable only when the contract is paused.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    modifier whenPaused() {
        _requirePaused();
        _;
    }

    /**
     * @dev Returns true if the contract is paused, and false otherwise.
     */
    function paused() public view virtual returns (bool) {
        return _paused;
    }

    /**
     * @dev Throws if the contract is paused.
     */
    function _requireNotPaused() internal view virtual {
        if (paused()) {
            revert EnforcedPause();
        }
    }

    /**
     * @dev Throws if the contract is not paused.
     */
    function _requirePaused() internal view virtual {
        if (!paused()) {
            revert ExpectedPause();
        }
    }

    /**
     * @dev Triggers stopped state.
     *
     * Requirements:
     *
     * - The contract must not be paused.
     */
    function _pause() internal virtual whenNotPaused {
        _paused = true;
        emit Paused(_msgSender());
    }

    /**
     * @dev Returns to normal state.
     *
     * Requirements:
     *
     * - The contract must be paused.
     */
    function _unpause() internal virtual whenPaused {
        _paused = false;
        emit Unpaused(_msgSender());
    }
}

// SPDX-License-Identifier: MIT 
pragma solidity 0.8.24;

interface IModule {
   
    /**
     * @notice Check if tokenIds owner matches supplied address
     * @dev If user is owner of all tokenIds, fn expected to revert
     * @param user Address to check against 
     * @param tokenIds TokenIds to check
     */
    function streamingOwnerCheck(address user, uint256[] calldata tokenIds) external view;
}

// SPDX-License-Identifier: CC0-1.0
pragma solidity >=0.8.13;

/**
 * @title IDelegateRegistry
 * @custom:version 2.0
 * @custom:author foobar (0xfoobar)
 * @notice A standalone immutable registry storing delegated permissions from one address to another
 */
interface IDelegateRegistry {
    /// @notice Delegation type, NONE is used when a delegation does not exist or is revoked
    enum DelegationType {
        NONE,
        ALL,
        CONTRACT,
        ERC721,
        ERC20,
        ERC1155
    }

    /// @notice Struct for returning delegations
    struct Delegation {
        DelegationType type_;
        address to;
        address from;
        bytes32 rights;
        address contract_;
        uint256 tokenId;
        uint256 amount;
    }

    /// @notice Emitted when an address delegates or revokes rights for their entire wallet
    event DelegateAll(address indexed from, address indexed to, bytes32 rights, bool enable);

    /// @notice Emitted when an address delegates or revokes rights for a contract address
    event DelegateContract(address indexed from, address indexed to, address indexed contract_, bytes32 rights, bool enable);

    /// @notice Emitted when an address delegates or revokes rights for an ERC721 tokenId
    event DelegateERC721(address indexed from, address indexed to, address indexed contract_, uint256 tokenId, bytes32 rights, bool enable);

    /// @notice Emitted when an address delegates or revokes rights for an amount of ERC20 tokens
    event DelegateERC20(address indexed from, address indexed to, address indexed contract_, bytes32 rights, uint256 amount);

    /// @notice Emitted when an address delegates or revokes rights for an amount of an ERC1155 tokenId
    event DelegateERC1155(address indexed from, address indexed to, address indexed contract_, uint256 tokenId, bytes32 rights, uint256 amount);

    /// @notice Thrown if multicall calldata is malformed
    error MulticallFailed();

    /**
     * -----------  WRITE -----------
     */

    /**
     * @notice Call multiple functions in the current contract and return the data from all of them if they all succeed
     * @param data The encoded function data for each of the calls to make to this contract
     * @return results The results from each of the calls passed in via data
     */
    function multicall(bytes[] calldata data) external payable returns (bytes[] memory results);

    /**
     * @notice Allow the delegate to act on behalf of `msg.sender` for all contracts
     * @param to The address to act as delegate
     * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights
     * @param enable Whether to enable or disable this delegation, true delegates and false revokes
     * @return delegationHash The unique identifier of the delegation
     */
    function delegateAll(address to, bytes32 rights, bool enable) external payable returns (bytes32 delegationHash);

    /**
     * @notice Allow the delegate to act on behalf of `msg.sender` for a specific contract
     * @param to The address to act as delegate
     * @param contract_ The contract whose rights are being delegated
     * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights
     * @param enable Whether to enable or disable this delegation, true delegates and false revokes
     * @return delegationHash The unique identifier of the delegation
     */
    function delegateContract(address to, address contract_, bytes32 rights, bool enable) external payable returns (bytes32 delegationHash);

    /**
     * @notice Allow the delegate to act on behalf of `msg.sender` for a specific ERC721 token
     * @param to The address to act as delegate
     * @param contract_ The contract whose rights are being delegated
     * @param tokenId The token id to delegate
     * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights
     * @param enable Whether to enable or disable this delegation, true delegates and false revokes
     * @return delegationHash The unique identifier of the delegation
     */
    function delegateERC721(address to, address contract_, uint256 tokenId, bytes32 rights, bool enable) external payable returns (bytes32 delegationHash);

    /**
     * @notice Allow the delegate to act on behalf of `msg.sender` for a specific amount of ERC20 tokens
     * @dev The actual amount is not encoded in the hash, just the existence of a amount (since it is an upper bound)
     * @param to The address to act as delegate
     * @param contract_ The address for the fungible token contract
     * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights
     * @param amount The amount to delegate, > 0 delegates and 0 revokes
     * @return delegationHash The unique identifier of the delegation
     */
    function delegateERC20(address to, address contract_, bytes32 rights, uint256 amount) external payable returns (bytes32 delegationHash);

    /**
     * @notice Allow the delegate to act on behalf of `msg.sender` for a specific amount of ERC1155 tokens
     * @dev The actual amount is not encoded in the hash, just the existence of a amount (since it is an upper bound)
     * @param to The address to act as delegate
     * @param contract_ The address of the contract that holds the token
     * @param tokenId The token id to delegate
     * @param rights Specific subdelegation rights granted to the delegate, pass an empty bytestring to encompass all rights
     * @param amount The amount of that token id to delegate, > 0 delegates and 0 revokes
     * @return delegationHash The unique identifier of the delegation
     */
    function delegateERC1155(address to, address contract_, uint256 tokenId, bytes32 rights, uint256 amount) external payable returns (bytes32 delegationHash);

    /**
     * ----------- CHECKS -----------
     */

    /**
     * @notice Check if `to` is a delegate of `from` for the entire wallet
     * @param to The potential delegate address
     * @param from The potential address who delegated rights
     * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only
     * @return valid Whether delegate is granted to act on the from's behalf
     */
    function checkDelegateForAll(address to, address from, bytes32 rights) external view returns (bool);

    /**
     * @notice Check if `to` is a delegate of `from` for the specified `contract_` or the entire wallet
     * @param to The delegated address to check
     * @param contract_ The specific contract address being checked
     * @param from The cold wallet who issued the delegation
     * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only
     * @return valid Whether delegate is granted to act on from's behalf for entire wallet or that specific contract
     */
    function checkDelegateForContract(address to, address from, address contract_, bytes32 rights) external view returns (bool);

    /**
     * @notice Check if `to` is a delegate of `from` for the specific `contract` and `tokenId`, the entire `contract_`, or the entire wallet
     * @param to The delegated address to check
     * @param contract_ The specific contract address being checked
     * @param tokenId The token id for the token to delegating
     * @param from The wallet that issued the delegation
     * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only
     * @return valid Whether delegate is granted to act on from's behalf for entire wallet, that contract, or that specific tokenId
     */
    function checkDelegateForERC721(address to, address from, address contract_, uint256 tokenId, bytes32 rights) external view returns (bool);

    /**
     * @notice Returns the amount of ERC20 tokens the delegate is granted rights to act on the behalf of
     * @param to The delegated address to check
     * @param contract_ The address of the token contract
     * @param from The cold wallet who issued the delegation
     * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only
     * @return balance The delegated balance, which will be 0 if the delegation does not exist
     */
    function checkDelegateForERC20(address to, address from, address contract_, bytes32 rights) external view returns (uint256);

    /**
     * @notice Returns the amount of a ERC1155 tokens the delegate is granted rights to act on the behalf of
     * @param to The delegated address to check
     * @param contract_ The address of the token contract
     * @param tokenId The token id to check the delegated amount of
     * @param from The cold wallet who issued the delegation
     * @param rights Specific rights to check for, pass the zero value to ignore subdelegations and check full delegations only
     * @return balance The delegated balance, which will be 0 if the delegation does not exist
     */
    function checkDelegateForERC1155(address to, address from, address contract_, uint256 tokenId, bytes32 rights) external view returns (uint256);

    /**
     * ----------- ENUMERATIONS -----------
     */

    /**
     * @notice Returns all enabled delegations a given delegate has received
     * @param to The address to retrieve delegations for
     * @return delegations Array of Delegation structs
     */
    function getIncomingDelegations(address to) external view returns (Delegation[] memory delegations);

    /**
     * @notice Returns all enabled delegations an address has given out
     * @param from The address to retrieve delegations for
     * @return delegations Array of Delegation structs
     */
    function getOutgoingDelegations(address from) external view returns (Delegation[] memory delegations);

    /**
     * @notice Returns all hashes associated with enabled delegations an address has received
     * @param to The address to retrieve incoming delegation hashes for
     * @return delegationHashes Array of delegation hashes
     */
    function getIncomingDelegationHashes(address to) external view returns (bytes32[] memory delegationHashes);

    /**
     * @notice Returns all hashes associated with enabled delegations an address has given out
     * @param from The address to retrieve outgoing delegation hashes for
     * @return delegationHashes Array of delegation hashes
     */
    function getOutgoingDelegationHashes(address from) external view returns (bytes32[] memory delegationHashes);

    /**
     * @notice Returns the delegations for a given array of delegation hashes
     * @param delegationHashes is an array of hashes that correspond to delegations
     * @return delegations Array of Delegation structs, return empty structs for nonexistent or revoked delegations
     */
    function getDelegationsFromHashes(bytes32[] calldata delegationHashes) external view returns (Delegation[] memory delegations);

    /**
     * ----------- STORAGE ACCESS -----------
     */

    /**
     * @notice Allows external contracts to read arbitrary storage slots
     */
    function readSlot(bytes32 location) external view returns (bytes32);

    /**
     * @notice Allows external contracts to read an arbitrary array of storage slots
     */
    function readSlots(bytes32[] calldata locations) external view returns (bytes32[] memory);
}

// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;


event ClaimedSingle(address indexed user, uint256 tokenId, uint256 amount);
event Claimed(address indexed user, uint256[] tokenIds, uint256[] amounts);
event ClaimedByDelegate(address indexed delegate, address[] owners, uint256[] tokenIds, uint256[] amounts);
event ClaimedByModule(address indexed module, address indexed msgSender, uint256[] tokenIds, uint256[] amounts);

event Deposited(address indexed operator, uint256 amount);
event Withdrawn(address indexed operator, uint256 amount);

event ModuleUpdated(address indexed module, bool set);
event DeadlineUpdated(uint256 indexed newDeadline);
event DepositorUpdated(address indexed oldDepositor, address indexed newDepositor);
event OperatorUpdated(address indexed oldOperator, address indexed newOperator);

event StreamsPaused(uint256[] indexed tokenIds);
event StreamsUnpaused(uint256[] indexed tokenIds);

event Frozen(uint256 indexed timestamp);
event EmergencyExit(address receiver, uint256 balance);

// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;

error InvalidStartime();
error InvalidEndTime();
error InvalidAllocation();
error InvalidEmission();

error NotStarted();
error DeadlineExceeded();

error InvalidOwner();
error IncorrectClaimable();
error EmptyArray();
error StreamPaused();
error InvalidDelegate();

error OnlyDepositor();
error ExcessDeposit();
error WithdrawDisabled();
error PrematureWithdrawal();
error InvalidNewDeadline();

error ZeroAddress();
error StaticCallFailed();
error UnregisteredModule();

error IsFrozen();
error NotFrozen();

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

pragma solidity ^0.8.20;

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

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

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Permit.sol)

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
 * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
 *
 * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
 * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
 * need to send a transaction, and thus is not required to hold Ether at all.
 *
 * ==== Security Considerations
 *
 * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature
 * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be
 * considered as an intention to spend the allowance in any specific way. The second is that because permits have
 * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should
 * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be
 * generally recommended is:
 *
 * ```solidity
 * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {
 *     try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}
 *     doThing(..., value);
 * }
 *
 * function doThing(..., uint256 value) public {
 *     token.safeTransferFrom(msg.sender, address(this), value);
 *     ...
 * }
 * ```
 *
 * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of
 * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also
 * {SafeERC20-safeTransferFrom}).
 *
 * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so
 * contracts should have entry points that don't rely on permit.
 */
interface IERC20Permit {
    /**
     * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
     * given ``owner``'s signed approval.
     *
     * IMPORTANT: The same issues {IERC20-approve} has related to transaction
     * ordering also apply here.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     * - `deadline` must be a timestamp in the future.
     * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
     * over the EIP712-formatted function arguments.
     * - the signature must use ``owner``'s current nonce (see {nonces}).
     *
     * For more information on the signature format, see the
     * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
     * section].
     *
     * CAUTION: See Security Considerations above.
     */
    function permit(
        address owner,
        address spender,
        uint256 value,
        uint256 deadline,
        uint8 v,
        bytes32 r,
        bytes32 s
    ) external;

    /**
     * @dev Returns the current nonce for `owner`. This value must be
     * included whenever a signature is generated for {permit}.
     *
     * Every successful call to {permit} increases ``owner``'s nonce by one. This
     * prevents a signature from being used multiple times.
     */
    function nonces(address owner) external view returns (uint256);

    /**
     * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
     */
    // solhint-disable-next-line func-name-mixedcase
    function DOMAIN_SEPARATOR() external view returns (bytes32);
}

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

pragma solidity ^0.8.20;

/**
 * @dev Collection of functions related to the address type
 */
library Address {
    /**
     * @dev The ETH balance of the account is not enough to perform the operation.
     */
    error AddressInsufficientBalance(address account);

    /**
     * @dev There's no code at `target` (it is not a contract).
     */
    error AddressEmptyCode(address target);

    /**
     * @dev A call to an address target failed. The target may have reverted.
     */
    error FailedInnerCall();

    /**
     * @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.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
     */
    function sendValue(address payable recipient, uint256 amount) internal {
        if (address(this).balance < amount) {
            revert AddressInsufficientBalance(address(this));
        }

        (bool success, ) = recipient.call{value: amount}("");
        if (!success) {
            revert FailedInnerCall();
        }
    }

    /**
     * @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 or custom error, it is bubbled
     * up by this function (like regular Solidity function calls). However, if
     * the call reverted with no returned reason, this function reverts with a
     * {FailedInnerCall} error.
     *
     * 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.
     */
    function functionCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0);
    }

    /**
     * @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`.
     */
    function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
        if (address(this).balance < value) {
            revert AddressInsufficientBalance(address(this));
        }
        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResultFromTarget(target, success, returndata);
    }

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

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

    /**
     * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target
     * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an
     * unsuccessful call.
     */
    function verifyCallResultFromTarget(
        address target,
        bool success,
        bytes memory returndata
    ) internal view returns (bytes memory) {
        if (!success) {
            _revert(returndata);
        } else {
            // only check if target is a contract if the call was successful and the return data is empty
            // otherwise we already know that it was a contract
            if (returndata.length == 0 && target.code.length == 0) {
                revert AddressEmptyCode(target);
            }
            return returndata;
        }
    }

    /**
     * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the
     * revert reason or with a default {FailedInnerCall} error.
     */
    function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {
        if (!success) {
            _revert(returndata);
        } else {
            return returndata;
        }
    }

    /**
     * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}.
     */
    function _revert(bytes memory returndata) 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 FailedInnerCall();
        }
    }
}

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

pragma solidity ^0.8.20;

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

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

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

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

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

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

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

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

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        if (owner() != _msgSender()) {
            revert OwnableUnauthorizedAccount(_msgSender());
        }
    }

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

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        if (newOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(newOwner);
    }

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

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

pragma solidity ^0.8.20;

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

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

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

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

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"nft","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"depositor_","type":"address"},{"internalType":"address","name":"operator_","type":"address"},{"internalType":"address","name":"delegateRegistry","type":"address"},{"internalType":"uint128","name":"allocationPerNft_","type":"uint128"},{"internalType":"uint256","name":"startTime_","type":"uint256"},{"internalType":"uint256","name":"endTime_","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"target","type":"address"}],"name":"AddressEmptyCode","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"AddressInsufficientBalance","type":"error"},{"inputs":[],"name":"DeadlineExceeded","type":"error"},{"inputs":[],"name":"EmptyArray","type":"error"},{"inputs":[],"name":"EnforcedPause","type":"error"},{"inputs":[],"name":"ExcessDeposit","type":"error"},{"inputs":[],"name":"ExpectedPause","type":"error"},{"inputs":[],"name":"FailedInnerCall","type":"error"},{"inputs":[],"name":"IncorrectClaimable","type":"error"},{"inputs":[],"name":"InvalidAllocation","type":"error"},{"inputs":[],"name":"InvalidDelegate","type":"error"},{"inputs":[],"name":"InvalidEmission","type":"error"},{"inputs":[],"name":"InvalidEndTime","type":"error"},{"inputs":[],"name":"InvalidNewDeadline","type":"error"},{"inputs":[],"name":"InvalidOwner","type":"error"},{"inputs":[],"name":"InvalidStartime","type":"error"},{"inputs":[],"name":"IsFrozen","type":"error"},{"inputs":[],"name":"NotFrozen","type":"error"},{"inputs":[],"name":"NotStarted","type":"error"},{"inputs":[],"name":"OnlyDepositor","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[],"name":"PrematureWithdrawal","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"SafeERC20FailedOperation","type":"error"},{"inputs":[],"name":"StaticCallFailed","type":"error"},{"inputs":[],"name":"StreamPaused","type":"error"},{"inputs":[],"name":"UnregisteredModule","type":"error"},{"inputs":[],"name":"WithdrawDisabled","type":"error"},{"inputs":[],"name":"ZeroAddress","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"Claimed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"delegate","type":"address"},{"indexed":false,"internalType":"address[]","name":"owners","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"ClaimedByDelegate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"module","type":"address"},{"indexed":true,"internalType":"address","name":"msgSender","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"ClaimedByModule","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"ClaimedSingle","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"newDeadline","type":"uint256"}],"name":"DeadlineUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Deposited","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldDepositor","type":"address"},{"indexed":true,"internalType":"address","name":"newDepositor","type":"address"}],"name":"DepositorUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"balance","type":"uint256"}],"name":"EmergencyExit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"timestamp","type":"uint256"}],"name":"Frozen","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"module","type":"address"},{"indexed":false,"internalType":"bool","name":"set","type":"bool"}],"name":"ModuleUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldOperator","type":"address"},{"indexed":true,"internalType":"address","name":"newOperator","type":"address"}],"name":"OperatorUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","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":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"StreamsPaused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"StreamsUnpaused","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Withdrawn","type":"event"},{"inputs":[],"name":"DELEGATE_REGISTRY","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NFT","outputs":[{"internalType":"contract IERC721","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"TOKEN","outputs":[{"internalType":"contract IERC20","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"allocationPerNft","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"claim","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"claimDelegated","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"claimSingle","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"module","type":"address"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"claimViaModule","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"claimable","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"deadline","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"depositor","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"emergencyExit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"emissionPerSecond","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"endTime","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"freeze","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"isFrozen","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"module","type":"address"}],"name":"modules","outputs":[{"internalType":"bool","name":"isRegistered","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"operator","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"pauseStreams","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"startTime","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"streams","outputs":[{"internalType":"uint128","name":"claimed","type":"uint128"},{"internalType":"uint128","name":"lastClaimedTimestamp","type":"uint128"},{"internalType":"bool","name":"isPaused","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalAllocation","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalClaimed","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalDeposited","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"unpauseStreams","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newDeadline","type":"uint256"}],"name":"updateDeadline","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newDepositor","type":"address"}],"name":"updateDepositor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"module","type":"address"},{"internalType":"bool","name":"set","type":"bool"}],"name":"updateModule","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOperator","type":"address"}],"name":"updateOperator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"}]

0x608060405234801561001057600080fd5b50600436106102485760003560e01c806379ba50971161013b578063c7c4ff46116100b8578063e106a54c1161007c578063e106a54c146105b4578063e30c3978146105c7578063ee0ccf2d146105d8578063f2fde38b146105eb578063ff50abdc146105fe57600080fd5b8063c7c4ff461461054b578063d0ff02161461055e578063d116440014610571578063d1d58b2514610598578063d54ad2a1146105ab57600080fd5b80638da5cb5b116100ff5780638da5cb5b146104d9578063a441d067146104ef578063a8ee49fe14610502578063ac7475ed14610525578063b6b55f251461053857600080fd5b806379ba5097146104545780637c0b8de21461045c5780638286eee21461048357806382bfefc8146104aa5780638456cb59146104d157600080fd5b80634b1f9be1116101c957806364d60d911161018d57806364d60d91146103845780636ba4c138146103eb578063715018a6146103fe57806378e979251461040657806379203dc41461042d57600080fd5b80634b1f9be114610300578063508928fc14610327578063570ca7351461033a5780635c975abb1461036557806362a5af3b1461037c57600080fd5b806333eeb1471161021057806333eeb147146102c157806336222ac4146102ca5780633ccfd60b146102dd5780633f4ba83a146102e557806342af1884146102ed57600080fd5b806310f9a6771461024d57806318160ddd14610262578063213bdd2b1461027e57806329dcb0cf146102915780633197cbb61461029a575b600080fd5b61026061025b3660046122df565b610607565b005b61026b6122b881565b6040519081526020015b60405180910390f35b61026061028c366004612341565b610661565b61026b60055481565b61026b7f0000000000000000000000000000000000000000000000000000000068ea1c9081565b61026b60075481565b6102606102d8366004612383565b610cb3565b610260610f57565b610260611050565b6102606102fb3660046123d8565b61108d565b61026b7f000000000000000000000000000000000000000000000a11ef89b15ad0fc000081565b6102606103353660046123ff565b611149565b60065461034d906001600160a01b031681565b6040516001600160a01b039091168152602001610275565b60005460ff165b6040519015158152602001610275565b6102606111b0565b6103c36103923660046123d8565b600860205260009081526040902080546001909101546001600160801b0380831692600160801b9004169060ff1683565b604080516001600160801b039485168152939092166020840152151590820152606001610275565b6102606103f9366004612341565b611215565b6102606114ad565b61026b7f000000000000000000000000000000000000000000000000000000006708e91081565b61026b7f0000000000000000000000000000000000000000015d9eb474858907ad20000081565b6102606114bf565b61034d7f00000000000000000000000059325733eb952a92e069c87f0a6168b29e80627f81565b61034d7f00000000000000000000000000000000000000447e69651d841bd8d104bed49381565b61034d7f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c581565b610260611505565b60005461010090046001600160a01b031661034d565b6102606104fd3660046122df565b61152f565b61036c6105103660046122df565b60096020526000908152604090205460ff1681565b6102606105333660046122df565b61166a565b6102606105463660046123d8565b6116c4565b60025461034d906001600160a01b031681565b61026061056c3660046123d8565b6117c6565b61026b7f00000000000000000000000000000000000000000000000000055b778eb6191c81565b61026b6105a63660046123d8565b611988565b61026b60035481565b6102606105c2366004612341565b6119ff565b6001546001600160a01b031661034d565b6102606105e6366004612341565b611ac0565b6102606105f93660046122df565b611b95565b61026b60045481565b61060f611c0c565b600280546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f830becdc16911bd35301d7e36682bb0bf344b313f5406e9eb6d8632a3497634490600090a35050565b7f000000000000000000000000000000000000000000000000000000006708e91042116106a157604051636f312cbd60e01b815260040160405180910390fd5b600554156106cc576005544211156106cc5760405163559895a360e01b815260040160405180910390fd5b6106d4611c3f565b8060008190036106f75760405163521299a960e01b815260040160405180910390fd5b60008167ffffffffffffffff81111561071257610712612438565b60405190808252806020026020018201604052801561074557816020015b60608152602001906001900390816107305790505b50905060008267ffffffffffffffff81111561076357610763612438565b60405190808252806020026020018201604052801561078c578160200160208202803683370190505b50905060005b838110156109165760008686838181106107ae576107ae61244e565b90506020020135905060007f00000000000000000000000059325733eb952a92e069c87f0a6168b29e80627f6001600160a01b0316636352211e836040518263ffffffff1660e01b815260040161080791815260200190565b602060405180830381865afa158015610824573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906108489190612464565b90508084848151811061085d5761085d61244e565b6001600160a01b039283166020918202929092018101919091526040805133602482015284841660448201527f00000000000000000000000059325733eb952a92e069c87f0a6168b29e80627f909316606484015260848301859052600060a4808501919091528151808503909101815260c49093019052810180516001600160e01b0316632e7cda1d60e21b17905285518690859081106109015761090161244e565b60209081029190910101525050600101610792565b5060007f00000000000000000000000000000000000000447e69651d841bd8d104bed4936001600160a01b031663ac9650d88460405160240161095991906124a5565b604051602081830303815290604052915060e01b6020820180516001600160e01b03838183161783525050505090506000807f00000000000000000000000000000000000000447e69651d841bd8d104bed4936001600160a01b0316836040516109c3919061251f565b600060405180830381855afa9150503d80600081146109fe576040519150601f19603f3d011682016040523d82523d6000602084013e610a03565b606091505b509150915081610a2657604051633842fc7360e21b815260040160405180910390fd5b600081806020019051810190610a3c919061256c565b90506000808867ffffffffffffffff811115610a5a57610a5a612438565b604051908082528060200260200182016040528015610a83578160200160208202803683370190505b50905060008060005b8b811015610c09576000868281518110610aa857610aa861244e565b6020026020010151806020019051810190610ac39190612683565b905080610ae357604051632d618d8160e21b815260040160405180910390fd5b60008f8f84818110610af757610af761244e565b9050602002013590506000610b0b82611c63565b9050610b1781896126b6565b975080878581518110610b2c57610b2c61244e565b60200260200101818152505083600003610b64578c8481518110610b5257610b5261244e565b60200260200101519550809450610bfb565b8c8481518110610b7657610b7661244e565b60200260200101516001600160a01b0316866001600160a01b031603610ba757610ba081866126b6565b9450610bfb565b610bdb6001600160a01b037f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c5168787611dfd565b8c8481518110610bed57610bed61244e565b602002602001015195508094505b505050806001019050610a8c565b508015610c4457610c446001600160a01b037f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c5168383611dfd565b8360036000828254610c5691906126b6565b92505081905550336001600160a01b03167f510bb1435d0e928875be075b55ed27d047c1847bdb990620040f336b9d74ac318a8f8f87604051610c9c9493929190612737565b60405180910390a250505050505050505050505050565b7f000000000000000000000000000000000000000000000000000000006708e9104211610cf357604051636f312cbd60e01b815260040160405180910390fd5b60055415610d1e57600554421115610d1e5760405163559895a360e01b815260040160405180910390fd5b610d26611c3f565b6001600160a01b038316610d4d5760405163d92e233d60e01b815260040160405180910390fd5b806000819003610d705760405163521299a960e01b815260040160405180910390fd5b6001600160a01b03841660009081526009602052604090205460ff16610da95760405163a65d26ef60e01b815260040160405180910390fd5b6040516311fcdc7960e11b81526001600160a01b038516906323f9b8f290610dd9903390879087906004016127af565b60006040518083038186803b158015610df157600080fd5b505afa158015610e05573d6000803e3d6000fd5b505050506000808267ffffffffffffffff811115610e2557610e25612438565b604051908082528060200260200182016040528015610e4e578160200160208202803683370190505b50905060005b83811015610eba576000868683818110610e7057610e7061244e565b9050602002013590506000610e8482611c63565b9050610e9081866126b6565b945080848481518110610ea557610ea561244e565b60209081029190910101525050600101610e54565b508160036000828254610ecd91906126b6565b909155505060405133906001600160a01b038816907f2ca6b08dc2f513626250717ad2ef0837e6544add3632f998a9645b5daae42f5b90610f13908990899087906127dd565b60405180910390a3610f4f6001600160a01b037f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c5163384611dfd565b505050505050565b610f5f611c3f565b6002546001600160a01b03163314610f8a576040516319d1820960e31b815260040160405180910390fd5b600554600003610fad576040516337ae717b60e01b815260040160405180910390fd5b6005544211610fcf57604051635a77435760e01b815260040160405180910390fd5b6000600354600454610fe1919061280d565b60405181815290915033907f7084f5476618d8e60b11ef0d7d3f06914655adb8793e28ff7f018d4c76d505d59060200160405180910390a261104d6001600160a01b037f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c5163383611dfd565b50565b611058611c0c565b611060611e5c565b600754600103611083576040516320edda8f60e11b815260040160405180910390fd5b61108b611e7f565b565b611095611c0c565b60007f0000000000000000000000000000000000000000000000000000000068ea1c9042116110e4577f0000000000000000000000000000000000000000000000000000000068ea1c906110e6565b425b90506110f581621275006126b6565b82101561111557604051631140c59160e11b815260040160405180910390fd5b600582905560405182907fdb00f0341e024be397e058a193a27b85cc3e7f921640be77ddf155c9f8d37c5a90600090a25050565b611151611c0c565b6001600160a01b038216600081815260096020908152604091829020805460ff191685151590811790915591519182527f4beb3ed14661fd96a1404a092f72bf7fdc84d85a67a65e535af86d310f6242d6910160405180910390a25050565b6111b8611e5c565b6111c0611c0c565b6007546001036111e3576040516320edda8f60e11b815260040160405180910390fd5b600160075560405142907f4d69b51fee53c28bd8b61fe008151577ca65160b5248f6225e74d64fd4cf732890600090a2565b7f000000000000000000000000000000000000000000000000000000006708e910421161125557604051636f312cbd60e01b815260040160405180910390fd5b60055415611280576005544211156112805760405163559895a360e01b815260040160405180910390fd5b611288611c3f565b8060008190036112ab5760405163521299a960e01b815260040160405180910390fd5b6000808267ffffffffffffffff8111156112c7576112c7612438565b6040519080825280602002602001820160405280156112f0578160200160208202803683370190505b50905060005b8381101561141c5760008686838181106113125761131261244e565b90506020020135905060007f00000000000000000000000059325733eb952a92e069c87f0a6168b29e80627f6001600160a01b0316636352211e836040518263ffffffff1660e01b815260040161136b91815260200190565b602060405180830381865afa158015611388573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113ac9190612464565b9050336001600160a01b038216146113d7576040516349e27cff60e01b815260040160405180910390fd5b60006113e283611c63565b9050808585815181106113f7576113f761244e565b602090810291909101015261140c81876126b6565b95505050508060010190506112f6565b50816003600082825461142f91906126b6565b909155505060405133907fd73c90b96be004539b2f5667505922b63df42d52d7592edc562d37ce1f03e3429061146a908890889086906127dd565b60405180910390a26114a66001600160a01b037f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c5163384611dfd565b5050505050565b6114b5611c0c565b61108b6000611ed1565b60015433906001600160a01b031681146114fc5760405163118cdaa760e01b81526001600160a01b03821660048201526024015b60405180910390fd5b61104d81611ed1565b61150d611c3f565b6006546001600160a01b0316331461152757611527611c0c565b61108b611eea565b611537611e5c565b61153f611c0c565b60075460000361156257604051638208cbe560e01b815260040160405180910390fd5b6040516370a0823160e01b81523060048201526000907f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c56001600160a01b0316906370a0823190602401602060405180830381865afa1580156115c9573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906115ed9190612820565b604080516001600160a01b0385168152602081018390529192507ff779df072f94d207563b1ba8c286814086f1e6bb436a2652e307dccc56ed79e8910160405180910390a16116666001600160a01b037f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c5168383611dfd565b5050565b611672611c0c565b600680546001600160a01b038381166001600160a01b0319831681179093556040519116919082907ffbe5b6cbafb274f445d7fed869dc77a838d8243a22c460de156560e8857cad0390600090a35050565b6116cc611c3f565b6002546001600160a01b031633146116f7576040516319d1820960e31b815260040160405180910390fd5b7f0000000000000000000000000000000000000000015d9eb474858907ad2000008160045461172691906126b6565b111561174557604051631b7c56cf60e21b815260040160405180910390fd5b806004600082825461175791906126b6565b909155505060405181815233907f2da466a7b24304f47e87fa2e1e5a81b9831ce54fec19055ce277ca2f39ba42c49060200160405180910390a261104d6001600160a01b037f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c516333084611f27565b7f000000000000000000000000000000000000000000000000000000006708e910421161180657604051636f312cbd60e01b815260040160405180910390fd5b60055415611831576005544211156118315760405163559895a360e01b815260040160405180910390fd5b611839611c3f565b6040516331a9108f60e11b8152600481018290526000907f00000000000000000000000059325733eb952a92e069c87f0a6168b29e80627f6001600160a01b031690636352211e90602401602060405180830381865afa1580156118a1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906118c59190612464565b9050336001600160a01b038216146118f0576040516349e27cff60e01b815260040160405180910390fd5b60006118fb83611c63565b9050806003600082825461190f91906126b6565b9091555050604080518481526020810183905233917f9143c8f8453d2d31bd877a6d7f4c5d595c84e117afc9f590dbca541e251c30a5910160405180910390a26119836001600160a01b037f000000000000000000000000f944e35f95e819e752f3ccb5faf40957d311e8c5163383611dfd565b505050565b6000818152600860209081526040808320815160608101835281546001600160801b038082168352600160801b9091041693810184905260019091015460ff16151591810191909152904290036119e25750600092915050565b60006119f682602001518360000151611f66565b50949350505050565b611a07611c0c565b806000819003611a2a5760405163521299a960e01b815260040160405180910390fd5b60005b81811015611a7a576000848483818110611a4957611a4961244e565b602090810292909201356000908152600890925250604090206001908101805460ff19169055919091019050611a2d565b508282604051611a8b929190612839565b604051908190038120907fefa87b9b6b81cbc490343a24365a848e01a49e16c59fd194ff46202c20333ea090600090a2505050565b6006546001600160a01b03163314611ada57611ada611c0c565b806000819003611afd5760405163521299a960e01b815260040160405180910390fd5b60005b81811015611b4f576000848483818110611b1c57611b1c61244e565b602090810292909201356000908152600890925250604090206001908101805460ff191682179055919091019050611b00565b508282604051611b60929190612839565b604051908190038120907f248d6ea6bf78603089e09addef6beffdbecab0d062aca2fb8f9e261931005c0590600090a2505050565b611b9d611c0c565b600180546001600160a01b0383166001600160a01b03199091168117909155611bd46000546001600160a01b036101009091041690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6000546001600160a01b0361010090910416331461108b5760405163118cdaa760e01b81523360048201526024016114f3565b60005460ff161561108b5760405163d93c066560e01b815260040160405180910390fd5b6000818152600860209081526040808320815160608101835281546001600160801b038082168352600160801b9091041693810184905260019091015460ff1615159181019190915290429003611cbd5750600092915050565b7f0000000000000000000000000000000000000000000000000000000068ea1c9081602001516001600160801b031603611cfa5750600092915050565b806040015115611d1d57604051638b7fc21160e01b815260040160405180910390fd5b600080611d3283602001518460000151611f66565b6001600160801b03811660208601528451919350915082908490611d57908390612862565b6001600160801b0390811690915284517f000000000000000000000000000000000000000000000a11ef89b15ad0fc0000911611159050611dab5760405163f794148f60e01b815260040160405180910390fd5b506000938452600860209081526040948590208351918401516001600160801b03908116600160801b02921691909117815593909101516001909301805493151560ff19909416939093179092555090565b6040516001600160a01b0383811660248301526044820183905261198391859182169063a9059cbb906064015b604051602081830303815290604052915060e01b6020820180516001600160e01b0383818316178352505050506120d3565b60005460ff1661108b57604051638dfc202b60e01b815260040160405180910390fd5b611e87611e5c565b6000805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600180546001600160a01b031916905561104d81612136565b611ef2611c3f565b6000805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258611eb43390565b6040516001600160a01b038481166024830152838116604483015260648201839052611f609186918216906323b872dd90608401611e2a565b50505050565b60008060007f0000000000000000000000000000000000000000000000000000000068ea1c904211611f985742611fba565b7f0000000000000000000000000000000000000000000000000000000068ea1c905b90507f0000000000000000000000000000000000000000000000000000000068ea1c90810361201f576120166001600160801b0385167f000000000000000000000000000000000000000000000a11ef89b15ad0fc000061280d565b925090506120cc565b60007f000000000000000000000000000000000000000000000000000000006708e910866001600160801b03161061206057856001600160801b0316612082565b7f000000000000000000000000000000000000000000000000000000006708e9105b90506000612090828461280d565b905060006120be827f00000000000000000000000000000000000000000000000000055b778eb6191c612889565b95509293506120cc92505050565b9250929050565b60006120e86001600160a01b0384168361218f565b9050805160001415801561210d57508080602001905181019061210b9190612683565b155b1561198357604051635274afe760e01b81526001600160a01b03841660048201526024016114f3565b600080546001600160a01b03838116610100818102610100600160a81b0319851617855560405193049190911692909183917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e091a35050565b606061219d838360006121a6565b90505b92915050565b6060814710156121cb5760405163cd78605960e01b81523060048201526024016114f3565b600080856001600160a01b031684866040516121e7919061251f565b60006040518083038185875af1925050503d8060008114612224576040519150601f19603f3d011682016040523d82523d6000602084013e612229565b606091505b5091509150612239868383612245565b925050505b9392505050565b60608261225a57612255826122a1565b61223e565b815115801561227157506001600160a01b0384163b155b1561229a57604051639996b31560e01b81526001600160a01b03851660048201526024016114f3565b508061223e565b8051156122b15780518082602001fd5b604051630a12f52160e11b815260040160405180910390fd5b6001600160a01b038116811461104d57600080fd5b6000602082840312156122f157600080fd5b813561223e816122ca565b60008083601f84011261230e57600080fd5b50813567ffffffffffffffff81111561232657600080fd5b6020830191508360208260051b85010111156120cc57600080fd5b6000806020838503121561235457600080fd5b823567ffffffffffffffff81111561236b57600080fd5b612377858286016122fc565b90969095509350505050565b60008060006040848603121561239857600080fd5b83356123a3816122ca565b9250602084013567ffffffffffffffff8111156123bf57600080fd5b6123cb868287016122fc565b9497909650939450505050565b6000602082840312156123ea57600080fd5b5035919050565b801515811461104d57600080fd5b6000806040838503121561241257600080fd5b823561241d816122ca565b9150602083013561242d816123f1565b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b60006020828403121561247657600080fd5b815161223e816122ca565b60005b8381101561249c578181015183820152602001612484565b50506000910152565b6000602080830181845280855180835260408601915060408160051b870101925083870160005b8281101561251257878503603f19018452815180518087526124f3818989018a8501612481565b601f01601f1916959095018601945092850192908501906001016124cc565b5092979650505050505050565b60008251612531818460208701612481565b9190910192915050565b604051601f8201601f1916810167ffffffffffffffff8111828210171561256457612564612438565b604052919050565b6000602080838503121561257f57600080fd5b825167ffffffffffffffff8082111561259757600080fd5b8185019150601f86601f8401126125ad57600080fd5b8251828111156125bf576125bf612438565b8060051b6125ce86820161253b565b918252848101860191868101908a8411156125e857600080fd5b87870192505b83831015612675578251868111156126065760008081fd5b8701603f81018c136126185760008081fd5b8881015160408882111561262e5761262e612438565b61263f828901601f19168c0161253b565b8281528e828486010111156126545760008081fd5b612663838d8301848701612481565b855250505091870191908701906125ee565b9a9950505050505050505050565b60006020828403121561269557600080fd5b815161223e816123f1565b634e487b7160e01b600052601160045260246000fd5b808201808211156121a0576121a06126a0565b81835260006001600160fb1b038311156126e257600080fd5b8260051b80836020870137939093016020019392505050565b60008151808452602080850194506020840160005b8381101561272c57815187529582019590820190600101612710565b509495945050505050565b606080825285519082018190526000906020906080840190828901845b828110156127795781516001600160a01b031684529284019290840190600101612754565b505050838103602085015261278f8187896126c9565b91505082810360408401526127a481856126fb565b979650505050505050565b6001600160a01b03841681526040602082018190526000906127d490830184866126c9565b95945050505050565b6040815260006127f16040830185876126c9565b828103602084015261280381856126fb565b9695505050505050565b818103818111156121a0576121a06126a0565b60006020828403121561283257600080fd5b5051919050565b60006001600160fb1b0383111561284f57600080fd5b8260051b80858437919091019392505050565b6001600160801b03818116838216019080821115612882576128826126a0565b5092915050565b80820281158282048414176121a0576121a06126a056fea2646970667358221220eeceb2adcaad88850bd6ad46789f95c245c5e923fdea479b68c03609e03e519e64736f6c63430008180033