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.6;

import './abstract/JBControllerUtility.sol';
import './abstract/JBOperatable.sol';
import './interfaces/IJBTokenStore.sol';
import './libraries/JBOperations.sol';
import './JBToken.sol';

/**
  @notice
  Manage token minting, burning, and account balances.

  @dev
  Token balances can be either represented internally or claimed as ERC-20s into wallets.
  This contract manages these two representations and allows claiming.

  @dev
  The total supply of a project's tokens and the balance of each account are calculated in this contract.

  @dev
  Each project can bring their own token if they prefer, and swap between tokens at any time.
  
  @dev
  Adheres to -
  IJBTokenStore: General interface for the methods in this contract that interact with the blockchain's state according to the protocol's rules.

  @dev
  Inherits from -
  JBControllerUtility: Includes convenience functionality for checking if the message sender is the current controller of the project whose data is being manipulated.
  JBOperatable: Includes convenience functionality for checking a message sender's permissions before executing certain transactions.
*/
contract JBTokenStore is IJBTokenStore, JBControllerUtility, JBOperatable {
  //*********************************************************************//
  // --------------------------- custom errors ------------------------- //
  //*********************************************************************//
  error CANT_REMOVE_TOKEN_IF_ITS_REQUIRED();
  error EMPTY_NAME();
  error EMPTY_SYMBOL();
  error INSUFFICIENT_FUNDS();
  error INSUFFICIENT_UNCLAIMED_TOKENS();
  error PROJECT_ALREADY_HAS_TOKEN();
  error RECIPIENT_ZERO_ADDRESS();
  error TOKEN_ALREADY_IN_USE();
  error TOKEN_NOT_FOUND();
  error TOKENS_MUST_HAVE_18_DECIMALS();

  //*********************************************************************//
  // ---------------- public immutable stored properties --------------- //
  //*********************************************************************//

  /**
    @notice
    Mints ERC-721's that represent project ownership and transfers.
  */
  IJBProjects public immutable override projects;

  //*********************************************************************//
  // --------------------- public stored properties -------------------- //
  //*********************************************************************//

  /**
    @notice
    Each project's attached token contract.

    _projectId The ID of the project to which the token belongs.
  */
  mapping(uint256 => IJBToken) public override tokenOf;

  /**
    @notice
    The ID of the project that each token belongs to.

    _token The token to check the project association of.
  */
  mapping(IJBToken => uint256) public override projectOf;

  /**
    @notice
    The total supply of unclaimed tokens for each project.

    _projectId The ID of the project to which the token belongs.
  */
  mapping(uint256 => uint256) public override unclaimedTotalSupplyOf;

  /**
    @notice
    Each holder's balance of unclaimed tokens for each project.

    _holder The holder of balance.
    _projectId The ID of the project to which the token belongs.
  */
  mapping(address => mapping(uint256 => uint256)) public override unclaimedBalanceOf;

  /**
    @notice
    A flag indicating if tokens are required to be issued as claimed for a particular project.

    _projectId The ID of the project to which the requirement applies.
  */
  mapping(uint256 => bool) public override requireClaimFor;

  //*********************************************************************//
  // ------------------------- external views -------------------------- //
  //*********************************************************************//

  /**
    @notice
    The total supply of tokens for each project, including claimed and unclaimed tokens.

    @param _projectId The ID of the project to get the total token supply of.

    @return totalSupply The total supply of the project's tokens.
  */
  function totalSupplyOf(uint256 _projectId) external view override returns (uint256 totalSupply) {
    // Get a reference to the total supply of the project's unclaimed tokens.
    totalSupply = unclaimedTotalSupplyOf[_projectId];

    // Get a reference to the project's current token.
    IJBToken _token = tokenOf[_projectId];

    // If the project has a current token, add it's total supply to the total.
    if (_token != IJBToken(address(0))) totalSupply = totalSupply + _token.totalSupply(_projectId);
  }

  /**
    @notice
    The total balance of tokens a holder has for a specified project, including claimed and unclaimed tokens.

    @param _holder The token holder to get a balance for.
    @param _projectId The project to get the `_holder`s balance of.

    @return balance The project token balance of the `_holder
  */
  function balanceOf(address _holder, uint256 _projectId)
    external
    view
    override
    returns (uint256 balance)
  {
    // Get a reference to the holder's unclaimed balance for the project.
    balance = unclaimedBalanceOf[_holder][_projectId];

    // Get a reference to the project's current token.
    IJBToken _token = tokenOf[_projectId];

    // If the project has a current token, add the holder's balance to the total.
    if (_token != IJBToken(address(0))) balance = balance + _token.balanceOf(_holder, _projectId);
  }

  //*********************************************************************//
  // -------------------------- constructor ---------------------------- //
  //*********************************************************************//

  /**
    @param _operatorStore A contract storing operator assignments.
    @param _projects A contract which mints ERC-721's that represent project ownership and transfers.
    @param _directory A contract storing directories of terminals and controllers for each project.
  */
  constructor(
    IJBOperatorStore _operatorStore,
    IJBProjects _projects,
    IJBDirectory _directory
  ) JBOperatable(_operatorStore) JBControllerUtility(_directory) {
    projects = _projects;
  }

  //*********************************************************************//
  // ---------------------- external transactions ---------------------- //
  //*********************************************************************//

  /**
    @notice
    Issues a project's ERC-20 tokens that'll be used when claiming tokens.

    @dev
    Deploys a project's ERC-20 token contract.

    @dev
    Only a project's current controller can issue its token.

    @param _projectId The ID of the project being issued tokens.
    @param _name The ERC-20's name.
    @param _symbol The ERC-20's symbol.

    @return token The token that was issued.
  */
  function issueFor(
    uint256 _projectId,
    string calldata _name,
    string calldata _symbol
  ) external override onlyController(_projectId) returns (IJBToken token) {
    // There must be a name.
    if (bytes(_name).length == 0) revert EMPTY_NAME();

    // There must be a symbol.
    if (bytes(_symbol).length == 0) revert EMPTY_SYMBOL();

    // The project shouldn't already have a token.
    if (tokenOf[_projectId] != IJBToken(address(0))) revert PROJECT_ALREADY_HAS_TOKEN();

    // Deploy the token contract.
    token = new JBToken(_name, _symbol);

    // Store the token contract.
    tokenOf[_projectId] = token;

    // Store the project for the token.
    projectOf[token] = _projectId;

    emit Issue(_projectId, token, _name, _symbol, msg.sender);
  }

  /**
    @notice
    Swap the current project's token for another, and transfer ownership of the current token to another address if needed.

    @dev
    Only a project's current controller can change its token.

    @dev
    This contract must have access to all of the token's `IJBToken` interface functions.

    @dev
    Can't change to a token that's currently being used by another project.

    @dev
    Changing to the zero address will remove the current token without adding a new one.

    @param _projectId The ID of the project to which the changed token belongs.
    @param _token The new token. Send an empty address to remove the project's current token without adding a new one, if claiming tokens isn't currency required by the project
    @param _newOwner An address to transfer the current token's ownership to. This is optional, but it cannot be done later.

    @return oldToken The token that was removed as the project's token.
  */
  function changeFor(
    uint256 _projectId,
    IJBToken _token,
    address _newOwner
  ) external override onlyController(_projectId) returns (IJBToken oldToken) {
    // Can't remove the project's token if the project requires claiming tokens.
    if (_token == IJBToken(address(0)) && requireClaimFor[_projectId])
      revert CANT_REMOVE_TOKEN_IF_ITS_REQUIRED();

    // Can't change to a token already in use.
    if (projectOf[_token] != 0) revert TOKEN_ALREADY_IN_USE();

    // Can't change to a token that doesn't use 18 decimals.
    if (_token != IJBToken(address(0)) && _token.decimals() != 18)
      revert TOKENS_MUST_HAVE_18_DECIMALS();

    // Get a reference to the current token for the project.
    oldToken = tokenOf[_projectId];

    // Store the new token.
    tokenOf[_projectId] = _token;

    // Store the project for the new token if the new token isn't the zero address.
    if (_token != IJBToken(address(0))) projectOf[_token] = _projectId;

    // Reset the project for the old token if it isn't the zero address.
    if (oldToken != IJBToken(address(0))) projectOf[oldToken] = 0;

    // If there's a current token and a new owner was provided, transfer ownership of the old token to the new owner.
    if (_newOwner != address(0) && oldToken != IJBToken(address(0)))
      oldToken.transferOwnership(_projectId, _newOwner);

    emit Change(_projectId, _token, oldToken, _newOwner, msg.sender);
  }

  /**
    @notice
    Mint new project tokens.

    @dev
    Only a project's current controller can mint its tokens.

    @param _holder The address receiving the new tokens.
    @param _projectId The ID of the project to which the tokens belong.
    @param _amount The amount of tokens to mint.
    @param _preferClaimedTokens A flag indicating whether there's a preference for minted tokens to be claimed automatically into the `_holder`s wallet if the project currently has a token contract attached.
  */
  function mintFor(
    address _holder,
    uint256 _projectId,
    uint256 _amount,
    bool _preferClaimedTokens
  ) external override onlyController(_projectId) {
    // Get a reference to the project's current token.
    IJBToken _token = tokenOf[_projectId];

    // Save a reference to whether there exists a token and the caller prefers these claimed tokens or the project requires it.
    bool _shouldClaimTokens = (requireClaimFor[_projectId] || _preferClaimedTokens) &&
      _token != IJBToken(address(0));

    if (_shouldClaimTokens)
      // If tokens should be claimed, mint tokens into the holder's wallet.
      _token.mint(_projectId, _holder, _amount);
    else {
      // Otherwise, add the tokens to the unclaimed balance and total supply.
      unclaimedBalanceOf[_holder][_projectId] = unclaimedBalanceOf[_holder][_projectId] + _amount;
      unclaimedTotalSupplyOf[_projectId] = unclaimedTotalSupplyOf[_projectId] + _amount;
    }

    emit Mint(_holder, _projectId, _amount, _shouldClaimTokens, _preferClaimedTokens, msg.sender);
  }

  /**
    @notice
    Burns a project's tokens.

    @dev
    Only a project's current controller can burn its tokens.

    @param _holder The address that owns the tokens being burned.
    @param _projectId The ID of the project to which the burned tokens belong.
    @param _amount The amount of tokens to burn.
    @param _preferClaimedTokens A flag indicating whether there's a preference for tokens to burned from the `_holder`s wallet if the project currently has a token contract attached.
  */
  function burnFrom(
    address _holder,
    uint256 _projectId,
    uint256 _amount,
    bool _preferClaimedTokens
  ) external override onlyController(_projectId) {
    // Get a reference to the project's current token.
    IJBToken _token = tokenOf[_projectId];

    // Get a reference to the amount of unclaimed project tokens the holder has.
    uint256 _unclaimedBalance = unclaimedBalanceOf[_holder][_projectId];

    // Get a reference to the amount of the project's current token the holder has in their wallet.
    uint256 _claimedBalance = _token == IJBToken(address(0))
      ? 0
      : _token.balanceOf(_holder, _projectId);

    // There must be adequate tokens to burn across the holder's claimed and unclaimed balance.
    if (_amount > _claimedBalance + _unclaimedBalance) revert INSUFFICIENT_FUNDS();

    // The amount of tokens to burn.
    uint256 _claimedTokensToBurn;

    // If there's no balance, redeem no tokens.
    if (_claimedBalance == 0)
      _claimedTokensToBurn = 0;
      // If prefer converted, redeem tokens before redeeming unclaimed tokens.
    else if (_preferClaimedTokens)
      _claimedTokensToBurn = _claimedBalance < _amount ? _claimedBalance : _amount;
      // Otherwise, redeem unclaimed tokens before claimed tokens.
    else _claimedTokensToBurn = _unclaimedBalance < _amount ? _amount - _unclaimedBalance : 0;

    // The amount of unclaimed tokens to redeem.
    uint256 _unclaimedTokensToBurn = _amount - _claimedTokensToBurn;

    // Subtract the tokens from the unclaimed balance and total supply.
    if (_unclaimedTokensToBurn > 0) {
      // Reduce the holders balance and the total supply.
      unclaimedBalanceOf[_holder][_projectId] =
        unclaimedBalanceOf[_holder][_projectId] -
        _unclaimedTokensToBurn;
      unclaimedTotalSupplyOf[_projectId] =
        unclaimedTotalSupplyOf[_projectId] -
        _unclaimedTokensToBurn;
    }

    // Burn the claimed tokens.
    if (_claimedTokensToBurn > 0) _token.burn(_projectId, _holder, _claimedTokensToBurn);

    emit Burn(
      _holder,
      _projectId,
      _amount,
      _unclaimedBalance,
      _claimedBalance,
      _preferClaimedTokens,
      msg.sender
    );
  }

  /**
    @notice
    Claims internally accounted for tokens into a holder's wallet.

    @dev
    Only a token holder or an operator specified by the token holder can claim its unclaimed tokens.

    @param _holder The owner of the tokens being claimed.
    @param _projectId The ID of the project whose tokens are being claimed.
    @param _amount The amount of tokens to claim.
  */
  function claimFor(
    address _holder,
    uint256 _projectId,
    uint256 _amount
  ) external override requirePermission(_holder, _projectId, JBOperations.CLAIM) {
    // Get a reference to the project's current token.
    IJBToken _token = tokenOf[_projectId];

    // The project must have a token contract attached.
    if (_token == IJBToken(address(0))) revert TOKEN_NOT_FOUND();

    // Get a reference to the amount of unclaimed project tokens the holder has.
    uint256 _unclaimedBalance = unclaimedBalanceOf[_holder][_projectId];

    // There must be enough unclaimed tokens to claim.
    if (_unclaimedBalance < _amount) revert INSUFFICIENT_UNCLAIMED_TOKENS();

    // Subtract the claim amount from the holder's unclaimed project token balance.
    unclaimedBalanceOf[_holder][_projectId] = unclaimedBalanceOf[_holder][_projectId] - _amount;

    // Subtract the claim amount from the project's unclaimed total supply.
    unclaimedTotalSupplyOf[_projectId] = unclaimedTotalSupplyOf[_projectId] - _amount;

    // Mint the equivalent amount of the project's token for the holder.
    _token.mint(_projectId, _holder, _amount);

    emit Claim(_holder, _projectId, _unclaimedBalance, _amount, msg.sender);
  }

  /**
    @notice
    Allows a holder to transfer unclaimed tokens to another account.

    @dev
    Only a token holder or an operator can transfer its unclaimed tokens.

    @param _holder The address to transfer tokens from.
    @param _projectId The ID of the project whose tokens are being transferred.
    @param _recipient The recipient of the tokens.
    @param _amount The amount of tokens to transfer.
  */
  function transferFrom(
    address _holder,
    uint256 _projectId,
    address _recipient,
    uint256 _amount
  ) external override requirePermission(_holder, _projectId, JBOperations.TRANSFER) {
    // Can't transfer to the zero address.
    if (_recipient == address(0)) revert RECIPIENT_ZERO_ADDRESS();

    // Get a reference to the holder's unclaimed project token balance.
    uint256 _unclaimedBalance = unclaimedBalanceOf[_holder][_projectId];

    // The holder must have enough unclaimed tokens to transfer.
    if (_amount > _unclaimedBalance) revert INSUFFICIENT_UNCLAIMED_TOKENS();

    // Subtract from the holder's unclaimed token balance.
    unclaimedBalanceOf[_holder][_projectId] = unclaimedBalanceOf[_holder][_projectId] - _amount;

    // Add the unclaimed project tokens to the recipient's balance.
    unclaimedBalanceOf[_recipient][_projectId] =
      unclaimedBalanceOf[_recipient][_projectId] +
      _amount;

    emit Transfer(_holder, _projectId, _recipient, _amount, msg.sender);
  }

  /**
    @notice
    Allows a project to force all future mints of its tokens to be claimed into the holder's wallet, or revoke the flag if it's already set.

    @dev
    Only a token holder or an operator can require claimed token.

    @param _projectId The ID of the project being affected.
    @param _flag A flag indicating whether or not claiming should be required.
  */
  function shouldRequireClaimingFor(uint256 _projectId, bool _flag)
    external
    override
    requirePermission(projects.ownerOf(_projectId), _projectId, JBOperations.REQUIRE_CLAIM)
  {
    // Get a reference to the project's current token.
    IJBToken _token = tokenOf[_projectId];

    // The project must have a token contract attached.
    if (_token == IJBToken(address(0))) revert TOKEN_NOT_FOUND();

    // Store the flag.
    requireClaimFor[_projectId] = _flag;

    emit ShouldRequireClaim(_projectId, _flag, msg.sender);
  }
}

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

pragma solidity ^0.8.0;

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

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

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

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

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

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        require(owner() == _msgSender(), "Ownable: caller is not the owner");
        _;
    }

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

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0-rc.0) (token/ERC20/ERC20.sol)

pragma solidity ^0.8.0;

import "./IERC20.sol";
import "./extensions/IERC20Metadata.sol";
import "../../utils/Context.sol";

/**
 * @dev Implementation of the {IERC20} interface.
 *
 * This implementation is agnostic to the way tokens are created. This means
 * that a supply mechanism has to be added in a derived contract using {_mint}.
 * For a generic mechanism see {ERC20PresetMinterPauser}.
 *
 * TIP: For a detailed writeup see our guide
 * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
 * to implement supply mechanisms].
 *
 * We have followed general OpenZeppelin Contracts guidelines: functions revert
 * instead returning `false` on failure. This behavior is nonetheless
 * conventional and does not conflict with the expectations of ERC20
 * applications.
 *
 * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
 * This allows applications to reconstruct the allowance for all accounts just
 * by listening to said events. Other implementations of the EIP may not emit
 * these events, as it isn't required by the specification.
 *
 * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
 * functions have been added to mitigate the well-known issues around setting
 * allowances. See {IERC20-approve}.
 */
contract ERC20 is Context, IERC20, IERC20Metadata {
    mapping(address => uint256) private _balances;

    mapping(address => mapping(address => uint256)) private _allowances;

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

    /**
     * @dev Sets the values for {name} and {symbol}.
     *
     * The default value of {decimals} is 18. To select a different value for
     * {decimals} you should overload it.
     *
     * All two of these values are immutable: they can only be set once during
     * construction.
     */
    constructor(string memory name_, string memory symbol_) {
        _name = name_;
        _symbol = symbol_;
    }

    /**
     * @dev Returns the name of the token.
     */
    function name() public view virtual override returns (string memory) {
        return _name;
    }

    /**
     * @dev Returns the symbol of the token, usually a shorter version of the
     * name.
     */
    function symbol() public view virtual override returns (string memory) {
        return _symbol;
    }

    /**
     * @dev Returns the number of decimals used to get its user representation.
     * For example, if `decimals` equals `2`, a balance of `505` tokens should
     * be displayed to a user as `5.05` (`505 / 10 ** 2`).
     *
     * Tokens usually opt for a value of 18, imitating the relationship between
     * Ether and Wei. This is the value {ERC20} uses, unless this function is
     * overridden;
     *
     * NOTE: This information is only used for _display_ purposes: it in
     * no way affects any of the arithmetic of the contract, including
     * {IERC20-balanceOf} and {IERC20-transfer}.
     */
    function decimals() public view virtual override returns (uint8) {
        return 18;
    }

    /**
     * @dev See {IERC20-totalSupply}.
     */
    function totalSupply() public view virtual override returns (uint256) {
        return _totalSupply;
    }

    /**
     * @dev See {IERC20-balanceOf}.
     */
    function balanceOf(address account) public view virtual override returns (uint256) {
        return _balances[account];
    }

    /**
     * @dev See {IERC20-transfer}.
     *
     * Requirements:
     *
     * - `recipient` cannot be the zero address.
     * - the caller must have a balance of at least `amount`.
     */
    function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
        _transfer(_msgSender(), recipient, amount);
        return true;
    }

    /**
     * @dev See {IERC20-allowance}.
     */
    function allowance(address owner, address spender) public view virtual override returns (uint256) {
        return _allowances[owner][spender];
    }

    /**
     * @dev See {IERC20-approve}.
     *
     * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on
     * `transferFrom`. This is semantically equivalent to an infinite approval.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function approve(address spender, uint256 amount) public virtual override returns (bool) {
        _approve(_msgSender(), spender, amount);
        return true;
    }

    /**
     * @dev See {IERC20-transferFrom}.
     *
     * Emits an {Approval} event indicating the updated allowance. This is not
     * required by the EIP. See the note at the beginning of {ERC20}.
     *
     * NOTE: Does not update the allowance if the current allowance
     * is the maximum `uint256`.
     *
     * Requirements:
     *
     * - `sender` and `recipient` cannot be the zero address.
     * - `sender` must have a balance of at least `amount`.
     * - the caller must have allowance for ``sender``'s tokens of at least
     * `amount`.
     */
    function transferFrom(
        address sender,
        address recipient,
        uint256 amount
    ) public virtual override returns (bool) {
        uint256 currentAllowance = _allowances[sender][_msgSender()];
        if (currentAllowance != type(uint256).max) {
            require(currentAllowance >= amount, "ERC20: transfer amount exceeds allowance");
            unchecked {
                _approve(sender, _msgSender(), currentAllowance - amount);
            }
        }

        _transfer(sender, recipient, amount);

        return true;
    }

    /**
     * @dev Atomically increases the allowance granted to `spender` by the caller.
     *
     * This is an alternative to {approve} that can be used as a mitigation for
     * problems described in {IERC20-approve}.
     *
     * Emits an {Approval} event indicating the updated allowance.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
        _approve(_msgSender(), spender, _allowances[_msgSender()][spender] + addedValue);
        return true;
    }

    /**
     * @dev Atomically decreases the allowance granted to `spender` by the caller.
     *
     * This is an alternative to {approve} that can be used as a mitigation for
     * problems described in {IERC20-approve}.
     *
     * Emits an {Approval} event indicating the updated allowance.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     * - `spender` must have allowance for the caller of at least
     * `subtractedValue`.
     */
    function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
        uint256 currentAllowance = _allowances[_msgSender()][spender];
        require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
        unchecked {
            _approve(_msgSender(), spender, currentAllowance - subtractedValue);
        }

        return true;
    }

    /**
     * @dev Moves `amount` of tokens from `sender` to `recipient`.
     *
     * This internal function is equivalent to {transfer}, and can be used to
     * e.g. implement automatic token fees, slashing mechanisms, etc.
     *
     * Emits a {Transfer} event.
     *
     * Requirements:
     *
     * - `sender` cannot be the zero address.
     * - `recipient` cannot be the zero address.
     * - `sender` must have a balance of at least `amount`.
     */
    function _transfer(
        address sender,
        address recipient,
        uint256 amount
    ) internal virtual {
        require(sender != address(0), "ERC20: transfer from the zero address");
        require(recipient != address(0), "ERC20: transfer to the zero address");

        _beforeTokenTransfer(sender, recipient, amount);

        uint256 senderBalance = _balances[sender];
        require(senderBalance >= amount, "ERC20: transfer amount exceeds balance");
        unchecked {
            _balances[sender] = senderBalance - amount;
        }
        _balances[recipient] += amount;

        emit Transfer(sender, recipient, amount);

        _afterTokenTransfer(sender, recipient, amount);
    }

    /** @dev Creates `amount` tokens and assigns them to `account`, increasing
     * the total supply.
     *
     * Emits a {Transfer} event with `from` set to the zero address.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     */
    function _mint(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: mint to the zero address");

        _beforeTokenTransfer(address(0), account, amount);

        _totalSupply += amount;
        _balances[account] += amount;
        emit Transfer(address(0), account, amount);

        _afterTokenTransfer(address(0), account, amount);
    }

    /**
     * @dev Destroys `amount` tokens from `account`, reducing the
     * total supply.
     *
     * Emits a {Transfer} event with `to` set to the zero address.
     *
     * Requirements:
     *
     * - `account` cannot be the zero address.
     * - `account` must have at least `amount` tokens.
     */
    function _burn(address account, uint256 amount) internal virtual {
        require(account != address(0), "ERC20: burn from the zero address");

        _beforeTokenTransfer(account, address(0), amount);

        uint256 accountBalance = _balances[account];
        require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
        unchecked {
            _balances[account] = accountBalance - amount;
        }
        _totalSupply -= amount;

        emit Transfer(account, address(0), amount);

        _afterTokenTransfer(account, address(0), amount);
    }

    /**
     * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
     *
     * This internal function is equivalent to `approve`, and can be used to
     * e.g. set automatic allowances for certain subsystems, etc.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `owner` cannot be the zero address.
     * - `spender` cannot be the zero address.
     */
    function _approve(
        address owner,
        address spender,
        uint256 amount
    ) internal virtual {
        require(owner != address(0), "ERC20: approve from the zero address");
        require(spender != address(0), "ERC20: approve to the zero address");

        _allowances[owner][spender] = amount;
        emit Approval(owner, spender, amount);
    }

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol)

pragma solidity ^0.8.0;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
interface IERC20 {
    /**
     * @dev Returns the amount of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

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

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

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

    /**
     * @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);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity ^0.8.0;

import "../IERC20.sol";

/**
 * @dev Interface for the optional metadata functions from the ERC20 standard.
 *
 * _Available since v4.1._
 */
interface IERC20Metadata is IERC20 {
    /**
     * @dev Returns the name of the token.
     */
    function name() external view returns (string memory);

    /**
     * @dev Returns the symbol of the token.
     */
    function symbol() external view returns (string memory);

    /**
     * @dev Returns the decimals places of the token.
     */
    function decimals() external view returns (uint8);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-ERC20Permit.sol)

pragma solidity ^0.8.0;

import "./draft-IERC20Permit.sol";
import "../ERC20.sol";
import "../../../utils/cryptography/draft-EIP712.sol";
import "../../../utils/cryptography/ECDSA.sol";
import "../../../utils/Counters.sol";

/**
 * @dev Implementation 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.
 *
 * _Available since v3.4._
 */
abstract contract ERC20Permit is ERC20, IERC20Permit, EIP712 {
    using Counters for Counters.Counter;

    mapping(address => Counters.Counter) private _nonces;

    // solhint-disable-next-line var-name-mixedcase
    bytes32 private immutable _PERMIT_TYPEHASH =
        keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)");

    /**
     * @dev Initializes the {EIP712} domain separator using the `name` parameter, and setting `version` to `"1"`.
     *
     * It's a good idea to use the same `name` that is defined as the ERC20 token name.
     */
    constructor(string memory name) EIP712(name, "1") {}

    /**
     * @dev See {IERC20Permit-permit}.
     */
    function permit(
        address owner,
        address spender,
        uint256 value,
        uint256 deadline,
        uint8 v,
        bytes32 r,
        bytes32 s
    ) public virtual override {
        require(block.timestamp <= deadline, "ERC20Permit: expired deadline");

        bytes32 structHash = keccak256(abi.encode(_PERMIT_TYPEHASH, owner, spender, value, _useNonce(owner), deadline));

        bytes32 hash = _hashTypedDataV4(structHash);

        address signer = ECDSA.recover(hash, v, r, s);
        require(signer == owner, "ERC20Permit: invalid signature");

        _approve(owner, spender, value);
    }

    /**
     * @dev See {IERC20Permit-nonces}.
     */
    function nonces(address owner) public view virtual override returns (uint256) {
        return _nonces[owner].current();
    }

    /**
     * @dev See {IERC20Permit-DOMAIN_SEPARATOR}.
     */
    // solhint-disable-next-line func-name-mixedcase
    function DOMAIN_SEPARATOR() external view override returns (bytes32) {
        return _domainSeparatorV4();
    }

    /**
     * @dev "Consume a nonce": return the current value and increment.
     *
     * _Available since v4.1._
     */
    function _useNonce(address owner) internal virtual returns (uint256 current) {
        Counters.Counter storage nonce = _nonces[owner];
        current = nonce.current();
        nonce.increment();
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-IERC20Permit.sol)

pragma solidity ^0.8.0;

/**
 * @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.
 */
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].
     */
    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 v4.4.1 (token/ERC721/IERC721.sol)

pragma solidity ^0.8.0;

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

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

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

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

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

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

    /**
     * @dev Safely transfers `tokenId` token from `from` to `to`, 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 be 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: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
     *
     * 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 Returns the account approved for `tokenId` token.
     *
     * Requirements:
     *
     * - `tokenId` must exist.
     */
    function getApproved(uint256 tokenId) external view returns (address operator);

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

    /**
     * @dev Returns 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);

    /**
     * @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;
}

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

pragma solidity ^0.8.0;

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

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

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Counters.sol)

pragma solidity ^0.8.0;

/**
 * @title Counters
 * @author Matt Condon (@shrugs)
 * @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
 * of elements in a mapping, issuing ERC721 ids, or counting request ids.
 *
 * Include with `using Counters for Counters.Counter;`
 */
library Counters {
    struct Counter {
        // This variable should never be directly accessed by users of the library: interactions must be restricted to
        // the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
        // this feature: see https://github.com/ethereum/solidity/issues/4637
        uint256 _value; // default: 0
    }

    function current(Counter storage counter) internal view returns (uint256) {
        return counter._value;
    }

    function increment(Counter storage counter) internal {
        unchecked {
            counter._value += 1;
        }
    }

    function decrement(Counter storage counter) internal {
        uint256 value = counter._value;
        require(value > 0, "Counter: decrement overflow");
        unchecked {
            counter._value = value - 1;
        }
    }

    function reset(Counter storage counter) internal {
        counter._value = 0;
    }
}

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

pragma solidity ^0.8.0;

/**
 * @dev String operations.
 */
library Strings {
    bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";

    /**
     * @dev Converts a `uint256` to its ASCII `string` decimal representation.
     */
    function toString(uint256 value) internal pure returns (string memory) {
        // Inspired by OraclizeAPI's implementation - MIT licence
        // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol

        if (value == 0) {
            return "0";
        }
        uint256 temp = value;
        uint256 digits;
        while (temp != 0) {
            digits++;
            temp /= 10;
        }
        bytes memory buffer = new bytes(digits);
        while (value != 0) {
            digits -= 1;
            buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
            value /= 10;
        }
        return string(buffer);
    }

    /**
     * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
     */
    function toHexString(uint256 value) internal pure returns (string memory) {
        if (value == 0) {
            return "0x00";
        }
        uint256 temp = value;
        uint256 length = 0;
        while (temp != 0) {
            length++;
            temp >>= 8;
        }
        return toHexString(value, length);
    }

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

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

pragma solidity ^0.8.0;

import "../Strings.sol";

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

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

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

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

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

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

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

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

        return (signer, RecoverError.NoError);
    }

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

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

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

    /**
     * @dev Returns an Ethereum Signed Typed Data, created from a
     * `domainSeparator` and a `structHash`. This produces hash corresponding
     * to the one signed with the
     * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
     * JSON-RPC method as part of EIP-712.
     *
     * See {recover}.
     */
    function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
        return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash));
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/cryptography/draft-EIP712.sol)

pragma solidity ^0.8.0;

import "./ECDSA.sol";

/**
 * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.
 *
 * The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,
 * thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding
 * they need in their contracts using a combination of `abi.encode` and `keccak256`.
 *
 * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding
 * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA
 * ({_hashTypedDataV4}).
 *
 * The implementation of the domain separator was designed to be as efficient as possible while still properly updating
 * the chain id to protect against replay attacks on an eventual fork of the chain.
 *
 * NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method
 * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].
 *
 * _Available since v3.4._
 */
abstract contract EIP712 {
    /* solhint-disable var-name-mixedcase */
    // Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to
    // invalidate the cached domain separator if the chain id changes.
    bytes32 private immutable _CACHED_DOMAIN_SEPARATOR;
    uint256 private immutable _CACHED_CHAIN_ID;
    address private immutable _CACHED_THIS;

    bytes32 private immutable _HASHED_NAME;
    bytes32 private immutable _HASHED_VERSION;
    bytes32 private immutable _TYPE_HASH;

    /* solhint-enable var-name-mixedcase */

    /**
     * @dev Initializes the domain separator and parameter caches.
     *
     * The meaning of `name` and `version` is specified in
     * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:
     *
     * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.
     * - `version`: the current major version of the signing domain.
     *
     * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart
     * contract upgrade].
     */
    constructor(string memory name, string memory version) {
        bytes32 hashedName = keccak256(bytes(name));
        bytes32 hashedVersion = keccak256(bytes(version));
        bytes32 typeHash = keccak256(
            "EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)"
        );
        _HASHED_NAME = hashedName;
        _HASHED_VERSION = hashedVersion;
        _CACHED_CHAIN_ID = block.chainid;
        _CACHED_DOMAIN_SEPARATOR = _buildDomainSeparator(typeHash, hashedName, hashedVersion);
        _CACHED_THIS = address(this);
        _TYPE_HASH = typeHash;
    }

    /**
     * @dev Returns the domain separator for the current chain.
     */
    function _domainSeparatorV4() internal view returns (bytes32) {
        if (address(this) == _CACHED_THIS && block.chainid == _CACHED_CHAIN_ID) {
            return _CACHED_DOMAIN_SEPARATOR;
        } else {
            return _buildDomainSeparator(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION);
        }
    }

    function _buildDomainSeparator(
        bytes32 typeHash,
        bytes32 nameHash,
        bytes32 versionHash
    ) private view returns (bytes32) {
        return keccak256(abi.encode(typeHash, nameHash, versionHash, block.chainid, address(this)));
    }

    /**
     * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
     * function returns the hash of the fully encoded EIP712 message for this domain.
     *
     * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
     *
     * ```solidity
     * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
     *     keccak256("Mail(address to,string contents)"),
     *     mailTo,
     *     keccak256(bytes(mailContents))
     * )));
     * address signer = ECDSA.recover(digest, signature);
     * ```
     */
    function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {
        return ECDSA.toTypedDataHash(_domainSeparatorV4(), structHash);
    }
}

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

pragma solidity ^0.8.0;

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

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

import '@openzeppelin/contracts/token/ERC20/extensions/draft-ERC20Permit.sol';
import '@openzeppelin/contracts/access/Ownable.sol';
import './interfaces/IJBToken.sol';

/** 
  @notice
  An ERC-20 token that can be used by a project in the `JBTokenStore`.

  @dev
  Adheres to -
  IJBToken: Allows this contract to be used by projects in the JBTokenStore.

  @dev
  Inherits from -
  ERC20Permit: General token standard for fungible accounting. 
  Ownable: Includes convenience functionality for checking a message sender's permissions before executing certain transactions.
*/
contract JBToken is IJBToken, ERC20Permit, Ownable {
  //*********************************************************************//
  // ------------------------- external views -------------------------- //
  //*********************************************************************//

  /** 
    @notice
    The total supply of this ERC20.

    @param _projectId the ID of the project to which the token belongs. This is ignored.

    @return The total supply of this ERC20, as a fixed point number.
  */
  function totalSupply(uint256 _projectId) external view override returns (uint256) {
    _projectId; // Prevents unused var compiler and natspec complaints.

    return super.totalSupply();
  }

  /** 
    @notice
    An account's balance of this ERC20.

    @param _account The account to get a balance of.
    @param _projectId is the ID of the project to which the token belongs. This is ignored.

    @return The balance of the `_account` of this ERC20, as a fixed point number with 18 decimals.
  */
  function balanceOf(address _account, uint256 _projectId)
    external
    view
    override
    returns (uint256)
  {
    _account; // Prevents unused var compiler and natspec complaints.
    _projectId; // Prevents unused var compiler and natspec complaints.

    return super.balanceOf(_account);
  }

  //*********************************************************************//
  // -------------------------- public views --------------------------- //
  //*********************************************************************//

  /** 
    @notice
    The number of decimals included in the fixed point accounting of this token.

    @return The number of decimals.
  */
  function decimals() public view override(ERC20, IJBToken) returns (uint8) {
    return super.decimals();
  }

  //*********************************************************************//
  // -------------------------- constructor ---------------------------- //
  //*********************************************************************//

  /** 
    @param _name The name of the token.
    @param _symbol The symbol that the token should be represented by.
  */
  constructor(string memory _name, string memory _symbol)
    ERC20(_name, _symbol)
    ERC20Permit(_name)
  // solhint-disable-next-line no-empty-blocks
  {

  }

  //*********************************************************************//
  // ---------------------- external transactions ---------------------- //
  //*********************************************************************//

  /** 
    @notice
    Mints more of the token.

    @dev
    Only the owner of this contract cant mint more of it.

    @param _projectId The ID of the project to which the token belongs. This is ignored.
    @param _account The account to mint the tokens for.
    @param _amount The amount of tokens to mint, as a fixed point number with 18 decimals.
  */
  function mint(
    uint256 _projectId,
    address _account,
    uint256 _amount
  ) external override onlyOwner {
    _projectId; // Prevents unused var compiler and natspec complaints.

    return _mint(_account, _amount);
  }

  /** 
    @notice
    Burn some outstanding tokens.

    @dev
    Only the owner of this contract cant burn some of its supply.

    @param _projectId The ID of the project to which the token belongs. This is ignored.
    @param _account The account to burn tokens from.
    @param _amount The amount of tokens to burn, as a fixed point number with 18 decimals.
  */
  function burn(
    uint256 _projectId,
    address _account,
    uint256 _amount
  ) external override onlyOwner {
    _projectId; // Prevents unused var compiler and natspec complaints.

    return _burn(_account, _amount);
  }

  /** 
    @notice
    Approves an account to spend tokens on the `msg.sender`s behalf.

    @param _projectId the ID of the project to which the token belongs. This is ignored.
    @param _spender The address that will be spending tokens on the `msg.sender`s behalf.
    @param _amount The amount the `_spender` is allowed to spend.
  */
  function approve(
    uint256 _projectId,
    address _spender,
    uint256 _amount
  ) external override {
    _projectId; // Prevents unused var compiler and natspec complaints.

    approve(_spender, _amount);
  }

  /** 
    @notice
    Transfer tokens to an account.
    
    @param _projectId The ID of the project to which the token belongs. This is ignored.
    @param _to The destination address.
    @param _amount The amount of the transfer, as a fixed point number with 18 decimals.
  */
  function transfer(
    uint256 _projectId,
    address _to,
    uint256 _amount
  ) external override {
    _projectId; // Prevents unused var compiler and natspec complaints.

    transfer(_to, _amount);
  }

  /** 
    @notice
    Transfer tokens between accounts.

    @param _projectId The ID of the project to which the token belongs. This is ignored.
    @param _from The originating address.
    @param _to The destination address.
    @param _amount The amount of the transfer, as a fixed point number with 18 decimals.
  */
  function transferFrom(
    uint256 _projectId,
    address _from,
    address _to,
    uint256 _amount
  ) external override {
    _projectId; // Prevents unused var compiler and natspec complaints.

    transferFrom(_from, _to, _amount);
  }

  //*********************************************************************//
  // ------------------------ public transactions ---------------------- //
  //*********************************************************************//

  /** 
    @notice
    Transfer ownership of this contract to another address.

    @dev
    Only the owner of this contract can transfer it.

    @param _projectId The ID of the project to which the token belongs. This is ignored.
    @param _newOwner The new owner.
  */
  function transferOwnership(uint256 _projectId, address _newOwner)
    public
    virtual
    override
    onlyOwner
  {
    _projectId; // Prevents unused var compiler and natspec complaints.

    return super.transferOwnership(_newOwner);
  }
}

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

import './../interfaces/IJBControllerUtility.sol';

/** 
  @notice
  Provides tools for contracts with functionality that can only be accessed by a project's controller.

  @dev
  Adheres to -
  IJBControllerUtility: General interface for the methods in this contract that interact with the blockchain's state according to the protocol's rules.
*/
abstract contract JBControllerUtility is IJBControllerUtility {
  //*********************************************************************//
  // --------------------------- custom errors -------------------------- //
  //*********************************************************************//
  error CONTROLLER_UNAUTHORIZED();

  //*********************************************************************//
  // ---------------------------- modifiers ---------------------------- //
  //*********************************************************************//

  /** 
    @notice
    Only allows the controller of the specified project to proceed. 

    @param _projectId The ID of the project. 
  */
  modifier onlyController(uint256 _projectId) {
    if (address(directory.controllerOf(_projectId)) != msg.sender) revert CONTROLLER_UNAUTHORIZED();
    _;
  }

  //*********************************************************************//
  // ---------------- public immutable stored properties --------------- //
  //*********************************************************************//

  /** 
    @notice 
    The directory of terminals and controllers for projects.
  */
  IJBDirectory public immutable override directory;

  //*********************************************************************//
  // -------------------------- constructor ---------------------------- //
  //*********************************************************************//

  /** 
    @param _directory A contract storing directories of terminals and controllers for each project.
  */
  constructor(IJBDirectory _directory) {
    directory = _directory;
  }
}

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

import './../interfaces/IJBOperatable.sol';

/** 
  @notice
  Modifiers to allow access to functions based on the message sender's operator status.

  @dev
  Adheres to -
  IJBOperatable: General interface for the methods in this contract that interact with the blockchain's state according to the protocol's rules.
*/
abstract contract JBOperatable is IJBOperatable {
  //*********************************************************************//
  // --------------------------- custom errors -------------------------- //
  //*********************************************************************//
  error UNAUTHORIZED();

  //*********************************************************************//
  // ---------------------------- modifiers ---------------------------- //
  //*********************************************************************//

  /** 
    @notice
    Only allows the speficied account or an operator of the account to proceed. 

    @param _account The account to check for.
    @param _domain The domain namespace to look for an operator within. 
    @param _permissionIndex The index of the permission to check for. 
  */
  modifier requirePermission(
    address _account,
    uint256 _domain,
    uint256 _permissionIndex
  ) {
    _requirePermission(_account, _domain, _permissionIndex);
    _;
  }

  /** 
    @notice
    Only allows the speficied account, an operator of the account to proceed, or a truthy override flag. 

    @param _account The account to check for.
    @param _domain The domain namespace to look for an operator within. 
    @param _permissionIndex The index of the permission to check for. 
    @param _override A condition to force allowance for.
  */
  modifier requirePermissionAllowingOverride(
    address _account,
    uint256 _domain,
    uint256 _permissionIndex,
    bool _override
  ) {
    _requirePermissionAllowingOverride(_account, _domain, _permissionIndex, _override);
    _;
  }

  //*********************************************************************//
  // ---------------- public immutable stored properties --------------- //
  //*********************************************************************//

  /** 
    @notice 
    A contract storing operator assignments.
  */
  IJBOperatorStore public immutable override operatorStore;

  //*********************************************************************//
  // -------------------------- constructor ---------------------------- //
  //*********************************************************************//

  /** 
    @param _operatorStore A contract storing operator assignments.
  */
  constructor(IJBOperatorStore _operatorStore) {
    operatorStore = _operatorStore;
  }

  //*********************************************************************//
  // -------------------------- internal views ------------------------- //
  //*********************************************************************//

  /** 
    @notice
    Require the message sender is either the account or has the specified permission.

    @param _account The account to allow.
    @param _domain The domain namespace within which the permission index will be checked.
    @param _permissionIndex The permission index that an operator must have within the specified domain to be allowed.
  */
  function _requirePermission(
    address _account,
    uint256 _domain,
    uint256 _permissionIndex
  ) internal view {
    if (
      msg.sender != _account &&
      !operatorStore.hasPermission(msg.sender, _account, _domain, _permissionIndex) &&
      !operatorStore.hasPermission(msg.sender, _account, 0, _permissionIndex)
    ) revert UNAUTHORIZED();
  }

  /** 
    @notice
    Require the message sender is either the account, has the specified permission, or the override condition is true.

    @param _account The account to allow.
    @param _domain The domain namespace within which the permission index will be checked.
    @param _domain The permission index that an operator must have within the specified domain to be allowed.
    @param _override The override condition to allow.
  */
  function _requirePermissionAllowingOverride(
    address _account,
    uint256 _domain,
    uint256 _permissionIndex,
    bool _override
  ) internal view {
    if (
      !_override &&
      msg.sender != _account &&
      !operatorStore.hasPermission(msg.sender, _account, _domain, _permissionIndex) &&
      !operatorStore.hasPermission(msg.sender, _account, 0, _permissionIndex)
    ) revert UNAUTHORIZED();
  }
}

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

enum JBBallotState {
  Active,
  Approved,
  Failed
}

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

import './IJBDirectory.sol';

interface IJBControllerUtility {
  function directory() external view returns (IJBDirectory);
}

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

import './IJBFundingCycleStore.sol';
import './IJBPaymentTerminal.sol';
import './IJBProjects.sol';

interface IJBDirectory {
  event SetController(uint256 indexed projectId, address indexed controller, address caller);

  event AddTerminal(uint256 indexed projectId, IJBPaymentTerminal indexed terminal, address caller);

  event SetTerminals(uint256 indexed projectId, IJBPaymentTerminal[] terminals, address caller);

  event SetPrimaryTerminal(
    uint256 indexed projectId,
    address indexed token,
    IJBPaymentTerminal indexed terminal,
    address caller
  );

  event SetIsAllowedToSetFirstController(address indexed addr, bool indexed flag, address caller);

  function projects() external view returns (IJBProjects);

  function fundingCycleStore() external view returns (IJBFundingCycleStore);

  function controllerOf(uint256 _projectId) external view returns (address);

  function isAllowedToSetFirstController(address _address) external view returns (bool);

  function terminalsOf(uint256 _projectId) external view returns (IJBPaymentTerminal[] memory);

  function isTerminalOf(uint256 _projectId, IJBPaymentTerminal _terminal)
    external
    view
    returns (bool);

  function primaryTerminalOf(uint256 _projectId, address _token)
    external
    view
    returns (IJBPaymentTerminal);

  function setControllerOf(uint256 _projectId, address _controller) external;

  function setTerminalsOf(uint256 _projectId, IJBPaymentTerminal[] calldata _terminals) external;

  function setPrimaryTerminalOf(
    uint256 _projectId,
    address _token,
    IJBPaymentTerminal _terminal
  ) external;

  function setIsAllowedToSetFirstController(address _address, bool _flag) external;
}

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

import '@openzeppelin/contracts/utils/introspection/IERC165.sol';
import './../enums/JBBallotState.sol';
import './IJBFundingCycleStore.sol';

interface IJBFundingCycleBallot is IERC165 {
  function duration() external view returns (uint256);

  function stateOf(
    uint256 _projectId,
    uint256 _configuration,
    uint256 _start
  ) external view returns (JBBallotState);
}

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

import './../enums/JBBallotState.sol';
import './../structs/JBFundingCycle.sol';
import './../structs/JBFundingCycleData.sol';

interface IJBFundingCycleStore {
  event Configure(
    uint256 indexed configuration,
    uint256 indexed projectId,
    JBFundingCycleData data,
    uint256 metadata,
    uint256 mustStartAtOrAfter,
    address caller
  );

  event Init(uint256 indexed configuration, uint256 indexed projectId, uint256 indexed basedOn);

  function latestConfigurationOf(uint256 _projectId) external view returns (uint256);

  function get(uint256 _projectId, uint256 _configuration)
    external
    view
    returns (JBFundingCycle memory);

  function latestConfiguredOf(uint256 _projectId)
    external
    view
    returns (JBFundingCycle memory fundingCycle, JBBallotState ballotState);

  function queuedOf(uint256 _projectId) external view returns (JBFundingCycle memory fundingCycle);

  function currentOf(uint256 _projectId) external view returns (JBFundingCycle memory fundingCycle);

  function currentBallotStateOf(uint256 _projectId) external view returns (JBBallotState);

  function configureFor(
    uint256 _projectId,
    JBFundingCycleData calldata _data,
    uint256 _metadata,
    uint256 _mustStartAtOrAfter
  ) external returns (JBFundingCycle memory fundingCycle);
}

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

import './IJBOperatorStore.sol';

interface IJBOperatable {
  function operatorStore() external view returns (IJBOperatorStore);
}

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

import './../structs/JBOperatorData.sol';

interface IJBOperatorStore {
  event SetOperator(
    address indexed operator,
    address indexed account,
    uint256 indexed domain,
    uint256[] permissionIndexes,
    uint256 packed
  );

  function permissionsOf(
    address _operator,
    address _account,
    uint256 _domain
  ) external view returns (uint256);

  function hasPermission(
    address _operator,
    address _account,
    uint256 _domain,
    uint256 _permissionIndex
  ) external view returns (bool);

  function hasPermissions(
    address _operator,
    address _account,
    uint256 _domain,
    uint256[] calldata _permissionIndexes
  ) external view returns (bool);

  function setOperator(JBOperatorData calldata _operatorData) external;

  function setOperators(JBOperatorData[] calldata _operatorData) external;
}

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

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

interface IJBPaymentTerminal is IERC165 {
  function acceptsToken(address _token, uint256 _projectId) external view returns (bool);

  function currencyForToken(address _token) external view returns (uint256);

  function decimalsForToken(address _token) external view returns (uint256);

  // Return value must be a fixed point number with 18 decimals.
  function currentEthOverflowOf(uint256 _projectId) external view returns (uint256);

  function pay(
    uint256 _projectId,
    uint256 _amount,
    address _token,
    address _beneficiary,
    uint256 _minReturnedTokens,
    bool _preferClaimedTokens,
    string calldata _memo,
    bytes calldata _metadata
  ) external payable returns (uint256 beneficiaryTokenCount);

  function addToBalanceOf(
    uint256 _projectId,
    uint256 _amount,
    address _token,
    string calldata _memo,
    bytes calldata _metadata
  ) external payable;
}

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

import '@openzeppelin/contracts/token/ERC721/IERC721.sol';
import './../structs/JBProjectMetadata.sol';
import './IJBTokenUriResolver.sol';

interface IJBProjects is IERC721 {
  event Create(
    uint256 indexed projectId,
    address indexed owner,
    JBProjectMetadata metadata,
    address caller
  );

  event SetMetadata(uint256 indexed projectId, JBProjectMetadata metadata, address caller);

  event SetTokenUriResolver(IJBTokenUriResolver indexed resolver, address caller);

  function count() external view returns (uint256);

  function metadataContentOf(uint256 _projectId, uint256 _domain)
    external
    view
    returns (string memory);

  function tokenUriResolver() external view returns (IJBTokenUriResolver);

  function createFor(address _owner, JBProjectMetadata calldata _metadata)
    external
    returns (uint256 projectId);

  function setMetadataOf(uint256 _projectId, JBProjectMetadata calldata _metadata) external;

  function setTokenUriResolver(IJBTokenUriResolver _newResolver) external;
}

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

interface IJBToken {
  function decimals() external view returns (uint8);

  function totalSupply(uint256 _projectId) external view returns (uint256);

  function balanceOf(address _account, uint256 _projectId) external view returns (uint256);

  function mint(
    uint256 _projectId,
    address _account,
    uint256 _amount
  ) external;

  function burn(
    uint256 _projectId,
    address _account,
    uint256 _amount
  ) external;

  function approve(
    uint256,
    address _spender,
    uint256 _amount
  ) external;

  function transfer(
    uint256 _projectId,
    address _to,
    uint256 _amount
  ) external;

  function transferFrom(
    uint256 _projectId,
    address _from,
    address _to,
    uint256 _amount
  ) external;

  function transferOwnership(uint256 _projectId, address _newOwner) external;
}

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

import './IJBProjects.sol';
import './IJBToken.sol';

interface IJBTokenStore {
  event Issue(
    uint256 indexed projectId,
    IJBToken indexed token,
    string name,
    string symbol,
    address caller
  );

  event Mint(
    address indexed holder,
    uint256 indexed projectId,
    uint256 amount,
    bool tokensWereClaimed,
    bool preferClaimedTokens,
    address caller
  );

  event Burn(
    address indexed holder,
    uint256 indexed projectId,
    uint256 amount,
    uint256 initialUnclaimedBalance,
    uint256 initialClaimedBalance,
    bool preferClaimedTokens,
    address caller
  );

  event Claim(
    address indexed holder,
    uint256 indexed projectId,
    uint256 initialUnclaimedBalance,
    uint256 amount,
    address caller
  );

  event ShouldRequireClaim(uint256 indexed projectId, bool indexed flag, address caller);

  event Change(
    uint256 indexed projectId,
    IJBToken indexed newToken,
    IJBToken indexed oldToken,
    address owner,
    address caller
  );

  event Transfer(
    address indexed holder,
    uint256 indexed projectId,
    address indexed recipient,
    uint256 amount,
    address caller
  );

  function tokenOf(uint256 _projectId) external view returns (IJBToken);

  function projectOf(IJBToken _token) external view returns (uint256);

  function projects() external view returns (IJBProjects);

  function unclaimedBalanceOf(address _holder, uint256 _projectId) external view returns (uint256);

  function unclaimedTotalSupplyOf(uint256 _projectId) external view returns (uint256);

  function totalSupplyOf(uint256 _projectId) external view returns (uint256);

  function balanceOf(address _holder, uint256 _projectId) external view returns (uint256 _result);

  function requireClaimFor(uint256 _projectId) external view returns (bool);

  function issueFor(
    uint256 _projectId,
    string calldata _name,
    string calldata _symbol
  ) external returns (IJBToken token);

  function changeFor(
    uint256 _projectId,
    IJBToken _token,
    address _newOwner
  ) external returns (IJBToken oldToken);

  function burnFrom(
    address _holder,
    uint256 _projectId,
    uint256 _amount,
    bool _preferClaimedTokens
  ) external;

  function mintFor(
    address _holder,
    uint256 _projectId,
    uint256 _amount,
    bool _preferClaimedTokens
  ) external;

  function shouldRequireClaimingFor(uint256 _projectId, bool _flag) external;

  function claimFor(
    address _holder,
    uint256 _projectId,
    uint256 _amount
  ) external;

  function transferFrom(
    address _holder,
    uint256 _projectId,
    address _recipient,
    uint256 _amount
  ) external;
}

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

interface IJBTokenUriResolver {
  function getUri(uint256 _projectId) external view returns (string memory tokenUri);
}

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

library JBOperations {
  uint256 public constant RECONFIGURE = 1;
  uint256 public constant REDEEM = 2;
  uint256 public constant MIGRATE_CONTROLLER = 3;
  uint256 public constant MIGRATE_TERMINAL = 4;
  uint256 public constant PROCESS_FEES = 5;
  uint256 public constant SET_METADATA = 6;
  uint256 public constant ISSUE = 7;
  uint256 public constant CHANGE_TOKEN = 8;
  uint256 public constant MINT = 9;
  uint256 public constant BURN = 10;
  uint256 public constant CLAIM = 11;
  uint256 public constant TRANSFER = 12;
  uint256 public constant REQUIRE_CLAIM = 13;
  uint256 public constant SET_CONTROLLER = 14;
  uint256 public constant SET_TERMINALS = 15;
  uint256 public constant SET_PRIMARY_TERMINAL = 16;
  uint256 public constant USE_ALLOWANCE = 17;
  uint256 public constant SET_SPLITS = 18;
}

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

import './../interfaces/IJBFundingCycleBallot.sol';

/** 
  @member number The funding cycle number for the cycle's project. Each funding cycle has a number that is an increment of the cycle that directly preceded it. Each project's first funding cycle has a number of 1.
  @member configuration The timestamp when the parameters for this funding cycle were configured. This value will stay the same for subsequent funding cycles that roll over from an originally configured cycle.
  @member basedOn The `configuration` of the funding cycle that was active when this cycle was created.
  @member start The timestamp marking the moment from which the funding cycle is considered active. It is a unix timestamp measured in seconds.
  @member duration The number of seconds the funding cycle lasts for, after which a new funding cycle will start. A duration of 0 means that the funding cycle will stay active until the project owner explicitly issues a reconfiguration, at which point a new funding cycle will immediately start with the updated properties. If the duration is greater than 0, a project owner cannot make changes to a funding cycle's parameters while it is active – any proposed changes will apply to the subsequent cycle. If no changes are proposed, a funding cycle rolls over to another one with the same properties but new `start` timestamp and a discounted `weight`.
  @member weight A fixed point number with 18 decimals that contracts can use to base arbitrary calculations on. For example, payment terminals can use this to determine how many tokens should be minted when a payment is received.
  @member discountRate A percent by how much the `weight` of the subsequent funding cycle should be reduced, if the project owner hasn't configured the subsequent funding cycle with an explicit `weight`. If it's 0, each funding cycle will have equal weight. If the number is 90%, the next funding cycle will have a 10% smaller weight. This weight is out of `JBConstants.MAX_DISCOUNT_RATE`.
  @member ballot An address of a contract that says whether a proposed reconfiguration should be accepted or rejected. It can be used to create rules around how a project owner can change funding cycle parameters over time.
  @member metadata Extra data that can be associated with a funding cycle.
*/
struct JBFundingCycle {
  uint256 number;
  uint256 configuration;
  uint256 basedOn;
  uint256 start;
  uint256 duration;
  uint256 weight;
  uint256 discountRate;
  IJBFundingCycleBallot ballot;
  uint256 metadata;
}

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

import './../interfaces/IJBFundingCycleBallot.sol';

/** 
  @member duration The number of seconds the funding cycle lasts for, after which a new funding cycle will start. A duration of 0 means that the funding cycle will stay active until the project owner explicitly issues a reconfiguration, at which point a new funding cycle will immediately start with the updated properties. If the duration is greater than 0, a project owner cannot make changes to a funding cycle's parameters while it is active – any proposed changes will apply to the subsequent cycle. If no changes are proposed, a funding cycle rolls over to another one with the same properties but new `start` timestamp and a discounted `weight`.
  @member weight A fixed point number with 18 decimals that contracts can use to base arbitrary calculations on. For example, payment terminals can use this to determine how many tokens should be minted when a payment is received.
  @member discountRate A percent by how much the `weight` of the subsequent funding cycle should be reduced, if the project owner hasn't configured the subsequent funding cycle with an explicit `weight`. If it's 0, each funding cycle will have equal weight. If the number is 90%, the next funding cycle will have a 10% smaller weight. This weight is out of `JBConstants.MAX_DISCOUNT_RATE`.
  @member ballot An address of a contract that says whether a proposed reconfiguration should be accepted or rejected. It can be used to create rules around how a project owner can change funding cycle parameters over time.
*/
struct JBFundingCycleData {
  uint256 duration;
  uint256 weight;
  uint256 discountRate;
  IJBFundingCycleBallot ballot;
}

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

/** 
  @member operator The address of the operator.
  @member domain The domain within which the operator is being given permissions. A domain of 0 is a wildcard domain, which gives an operator access to all domains.
  @member permissionIndexes The indexes of the permissions the operator is being given.
*/
struct JBOperatorData {
  address operator;
  uint256 domain;
  uint256[] permissionIndexes;
}

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

/** 
  @member content The metadata content.
  @member domain The domain within which the metadata applies.
*/
struct JBProjectMetadata {
  string content;
  uint256 domain;
}

{
  "evmVersion": "berlin",
  "libraries": {},
  "metadata": {
    "bytecodeHash": "ipfs",
    "useLiteralContent": true
  },
  "optimizer": {
    "enabled": true,
    "runs": 10000
  },
  "remappings": [],
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "devdoc",
        "userdoc",
        "metadata",
        "abi"
      ]
    }
  }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"contract IJBOperatorStore","name":"_operatorStore","type":"address"},{"internalType":"contract IJBProjects","name":"_projects","type":"address"},{"internalType":"contract IJBDirectory","name":"_directory","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"CANT_REMOVE_TOKEN_IF_ITS_REQUIRED","type":"error"},{"inputs":[],"name":"CONTROLLER_UNAUTHORIZED","type":"error"},{"inputs":[],"name":"EMPTY_NAME","type":"error"},{"inputs":[],"name":"EMPTY_SYMBOL","type":"error"},{"inputs":[],"name":"INSUFFICIENT_FUNDS","type":"error"},{"inputs":[],"name":"INSUFFICIENT_UNCLAIMED_TOKENS","type":"error"},{"inputs":[],"name":"PROJECT_ALREADY_HAS_TOKEN","type":"error"},{"inputs":[],"name":"RECIPIENT_ZERO_ADDRESS","type":"error"},{"inputs":[],"name":"TOKENS_MUST_HAVE_18_DECIMALS","type":"error"},{"inputs":[],"name":"TOKEN_ALREADY_IN_USE","type":"error"},{"inputs":[],"name":"TOKEN_NOT_FOUND","type":"error"},{"inputs":[],"name":"UNAUTHORIZED","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"holder","type":"address"},{"indexed":true,"internalType":"uint256","name":"projectId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"initialUnclaimedBalance","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"initialClaimedBalance","type":"uint256"},{"indexed":false,"internalType":"bool","name":"preferClaimedTokens","type":"bool"},{"indexed":false,"internalType":"address","name":"caller","type":"address"}],"name":"Burn","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"projectId","type":"uint256"},{"indexed":true,"internalType":"contract IJBToken","name":"newToken","type":"address"},{"indexed":true,"internalType":"contract IJBToken","name":"oldToken","type":"address"},{"indexed":false,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"address","name":"caller","type":"address"}],"name":"Change","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"holder","type":"address"},{"indexed":true,"internalType":"uint256","name":"projectId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"initialUnclaimedBalance","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"address","name":"caller","type":"address"}],"name":"Claim","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"projectId","type":"uint256"},{"indexed":true,"internalType":"contract IJBToken","name":"token","type":"address"},{"indexed":false,"internalType":"string","name":"name","type":"string"},{"indexed":false,"internalType":"string","name":"symbol","type":"string"},{"indexed":false,"internalType":"address","name":"caller","type":"address"}],"name":"Issue","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"holder","type":"address"},{"indexed":true,"internalType":"uint256","name":"projectId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"bool","name":"tokensWereClaimed","type":"bool"},{"indexed":false,"internalType":"bool","name":"preferClaimedTokens","type":"bool"},{"indexed":false,"internalType":"address","name":"caller","type":"address"}],"name":"Mint","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"projectId","type":"uint256"},{"indexed":true,"internalType":"bool","name":"flag","type":"bool"},{"indexed":false,"internalType":"address","name":"caller","type":"address"}],"name":"ShouldRequireClaim","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"holder","type":"address"},{"indexed":true,"internalType":"uint256","name":"projectId","type":"uint256"},{"indexed":true,"internalType":"address","name":"recipient","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"address","name":"caller","type":"address"}],"name":"Transfer","type":"event"},{"inputs":[{"internalType":"address","name":"_holder","type":"address"},{"internalType":"uint256","name":"_projectId","type":"uint256"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"balance","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_holder","type":"address"},{"internalType":"uint256","name":"_projectId","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"bool","name":"_preferClaimedTokens","type":"bool"}],"name":"burnFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_projectId","type":"uint256"},{"internalType":"contract IJBToken","name":"_token","type":"address"},{"internalType":"address","name":"_newOwner","type":"address"}],"name":"changeFor","outputs":[{"internalType":"contract IJBToken","name":"oldToken","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_holder","type":"address"},{"internalType":"uint256","name":"_projectId","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"claimFor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"directory","outputs":[{"internalType":"contract IJBDirectory","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_projectId","type":"uint256"},{"internalType":"string","name":"_name","type":"string"},{"internalType":"string","name":"_symbol","type":"string"}],"name":"issueFor","outputs":[{"internalType":"contract IJBToken","name":"token","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_holder","type":"address"},{"internalType":"uint256","name":"_projectId","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"bool","name":"_preferClaimedTokens","type":"bool"}],"name":"mintFor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"operatorStore","outputs":[{"internalType":"contract IJBOperatorStore","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IJBToken","name":"","type":"address"}],"name":"projectOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"projects","outputs":[{"internalType":"contract IJBProjects","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"requireClaimFor","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_projectId","type":"uint256"},{"internalType":"bool","name":"_flag","type":"bool"}],"name":"shouldRequireClaimingFor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"tokenOf","outputs":[{"internalType":"contract IJBToken","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_projectId","type":"uint256"}],"name":"totalSupplyOf","outputs":[{"internalType":"uint256","name":"totalSupply","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_holder","type":"address"},{"internalType":"uint256","name":"_projectId","type":"uint256"},{"internalType":"address","name":"_recipient","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"}],"name":"unclaimedBalanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"unclaimedTotalSupplyOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"}]

60e06040523480156200001157600080fd5b5060405162003edc38038062003edc83398101604081905262000034916200005a565b6001600160601b0319606091821b811660805292811b831660a0521b1660c052620000c7565b6000806000606084860312156200007057600080fd5b83516200007d81620000ae565b60208501519093506200009081620000ae565b6040850151909250620000a381620000ae565b809150509250925092565b6001600160a01b0381168114620000c457600080fd5b50565b60805160601c60a05160601c60c05160601c613dab6200013160003960008181610271015261165e0152600081816102de0152818161181e01526118f2015260008181610306015281816104a801528181610b9001528181610f8701526113be0152613dab6000f3fe60806040523480156200001157600080fd5b5060043610620001315760003560e01c80638b79543c11620000c0578063ad007d63116200008b578063ceddd3e4116200006e578063ceddd3e41462000328578063ea78803f146200033f578063ff0186c5146200036b57600080fd5b8063ad007d6314620002d8578063c41c2f24146200030057600080fd5b80638b79543c146200026b578063906ebd0f1462000293578063a7f2a70b14620002aa578063ac689bcd14620002c157600080fd5b806357e4c778116200010157806357e4c77814620001d45780636607955d146200020457806375b0d9cd146200021d5780637b4d8e2c146200023457600080fd5b8062fdd58e14620001365780631412884f1462000160578063176309b714620001835780635287af3714620001a6575b600080fd5b6200014d6200014736600462001a30565b62000382565b6040519081526020015b60405180910390f35b6200014d6200017136600462001b73565b60026020526000908152604090205481565b6200014d6200019436600462001b53565b60016020526000908152604090205481565b6200014d620001b736600462001a30565b600360209081526000928352604080842090915290825290205481565b620001eb620001e536600462001bda565b6200046a565b6040516001600160a01b03909116815260200162000157565b6200021b6200021536600462001aac565b6200086a565b005b6200014d6200022e36600462001b73565b62000a81565b6200025a6200024536600462001b73565b60046020526000908152604090205460ff1681565b604051901515815260200162000157565b620001eb7f000000000000000000000000000000000000000000000000000000000000000081565b6200021b620002a436600462001ae4565b62000b55565b620001eb620002bb36600462001c21565b62000f49565b6200021b620002d236600462001a5f565b620011e8565b620001eb7f000000000000000000000000000000000000000000000000000000000000000081565b620001eb7f000000000000000000000000000000000000000000000000000000000000000081565b6200021b6200033936600462001ae4565b62001383565b620001eb6200035036600462001b73565b6000602081905290815260409020546001600160a01b031681565b6200021b6200037c36600462001ba7565b6200162f565b6001600160a01b0380831660009081526003602090815260408083208584528252808320549183905290912054909116801562000463576040517efdd58e0000000000000000000000000000000000000000000000000000000081526001600160a01b0385811660048301526024820185905282169062fdd58e9060440160206040518083038186803b1580156200041957600080fd5b505afa1580156200042e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000454919062001b8d565b62000460908362001d8d565b91505b5092915050565b6040517f5dd8f6aa00000000000000000000000000000000000000000000000000000000815260048101849052600090849033906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690635dd8f6aa9060240160206040518083038186803b158015620004eb57600080fd5b505afa15801562000500573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000526919062001a09565b6001600160a01b03161462000567576040517fab7f741400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0384161580156200058d575060008581526004602052604090205460ff165b15620005c5576040517fd4ae123800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0384166000908152600160205260409020541562000616576040517f1379a84600000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b03841615801590620006a75750836001600160a01b031663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b1580156200066457600080fd5b505afa15801562000679573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200069f919062001ca2565b60ff16601214155b15620006df576040517fadc38c9400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600085815260208190526040902080546001600160a01b038681167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681179093551692501562000747576001600160a01b03841660009081526001602052604090208590555b6001600160a01b0382161562000771576001600160a01b0382166000908152600160205260408120555b6001600160a01b038316158015906200079257506001600160a01b03821615155b1562000816576040517f29507f73000000000000000000000000000000000000000000000000000000008152600481018690526001600160a01b0384811660248301528316906329507f7390604401600060405180830381600087803b158015620007fc57600080fd5b505af115801562000811573d6000803e3d6000fd5b505050505b604080516001600160a01b038581168252336020830152808516929087169188917f53b937570201bb723ab1530f41c21f62fba8df64afef862cb0a6f4eccc3094dc910160405180910390a4509392505050565b8282600b6200087b838383620017bd565b6000858152602081905260409020546001600160a01b031680620008cb576040517f73c463ce00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0387166000908152600360209081526040808320898452909152902054858110156200092a576040517f83fc8b2d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b03881660009081526003602090815260408083208a84529091529020546200095b90879062001da8565b6001600160a01b03891660009081526003602090815260408083208b84528252808320939093556002905220546200099590879062001da8565b6000888152600260205260409081902091909155517f836a1040000000000000000000000000000000000000000000000000000000008152600481018890526001600160a01b0389811660248301526044820188905283169063836a104090606401600060405180830381600087803b15801562000a1257600080fd5b505af115801562000a27573d6000803e3d6000fd5b505060408051848152602081018a9052338183015290518a93506001600160a01b038c1692507fe718784128df3c3d45fbd6519133fee450494f7cdb2b53830a5087cd47f980829181900360600190a35050505050505050565b60008181526002602090815260408083205491839052909120546001600160a01b0316801562000b4f576040517fbd85b039000000000000000000000000000000000000000000000000000000008152600481018490526001600160a01b0382169063bd85b0399060240160206040518083038186803b15801562000b0557600080fd5b505afa15801562000b1a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000b40919062001b8d565b62000b4c908362001d8d565b91505b50919050565b6040517f5dd8f6aa00000000000000000000000000000000000000000000000000000000815260048101849052839033906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690635dd8f6aa9060240160206040518083038186803b15801562000bd357600080fd5b505afa15801562000be8573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000c0e919062001a09565b6001600160a01b03161462000c4f576040517fab7f741400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600084815260208181526040808320546001600160a01b0389811685526003845282852089865290935290832054911691821562000d28576040517efdd58e0000000000000000000000000000000000000000000000000000000081526001600160a01b0389811660048301526024820189905284169062fdd58e9060440160206040518083038186803b15801562000ce757600080fd5b505afa15801562000cfc573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000d22919062001b8d565b62000d2b565b60005b905062000d39828262001d8d565b86111562000d73576040517fe793143800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008162000d845750600062000dc3565b851562000da45786821062000d9a578662000d9c565b815b905062000dc3565b86831062000db457600062000dc0565b62000dc0838862001da8565b90505b600062000dd1828962001da8565b9050801562000e55576001600160a01b038a1660009081526003602090815260408083208c845290915290205462000e0b90829062001da8565b6001600160a01b038b1660009081526003602090815260408083208d845282528083209390935560029052205462000e4590829062001da8565b60008a8152600260205260409020555b811562000ee1576040517f9eea5f66000000000000000000000000000000000000000000000000000000008152600481018a90526001600160a01b038b8116602483015260448201849052861690639eea5f6690606401600060405180830381600087803b15801562000ec757600080fd5b505af115801562000edc573d6000803e3d6000fd5b505050505b6040805189815260208101869052908101849052871515606082015233608082015289906001600160a01b038c16907fbe100da6adaa492f7ba1b0de916ae2606126ec7b044d7aa8ec74971a607ceecd9060a00160405180910390a350505050505050505050565b6040517f5dd8f6aa00000000000000000000000000000000000000000000000000000000815260048101869052600090869033906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690635dd8f6aa9060240160206040518083038186803b15801562000fca57600080fd5b505afa15801562000fdf573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001005919062001a09565b6001600160a01b03161462001046576040517fab7f741400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b846200107e576040517f92bf449d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b82620010b6576040517f571431a700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6000878152602081905260409020546001600160a01b03161562001106576040517fa54630ac00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b858585856040516200111890620019af565b62001127949392919062001d10565b604051809103906000f08015801562001144573d6000803e3d6000fd5b5060008881526020818152604080832080547fffffffffffffffffffffffff0000000000000000000000000000000000000000166001600160a01b0386169081179091558084526001909252918290208a905590519193509088907f1b1705bef26552c8f314c5eb80e9c84f02876c2f7f30a7f9ad5cafd17d5fa6da90620011d6908a908a908a908a90339062001d46565b60405180910390a35095945050505050565b8383600c620011f9838383620017bd565b6001600160a01b0385166200123a576040517fc6587bab00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b03871660009081526003602090815260408083208984529091529020548085111562001299576040517f83fc8b2d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b03881660009081526003602090815260408083208a8452909152902054620012ca90869062001da8565b6001600160a01b03808a1660009081526003602081815260408084208d8552825280842095909555928a16825282528281208a825290915220546200131190869062001d8d565b6001600160a01b0387811660008181526003602090815260408083208d8452825291829020949094558051898152339481019490945290928a928c16917fae47e55abe3902569528abe4272b889079230a248aec0659a2939a90354982c6910160405180910390a45050505050505050565b6040517f5dd8f6aa00000000000000000000000000000000000000000000000000000000815260048101849052839033906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690635dd8f6aa9060240160206040518083038186803b1580156200140157600080fd5b505afa15801562001416573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200143c919062001a09565b6001600160a01b0316146200147d576040517fab7f741400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6000848152602081815260408083205460049092528220546001600160a01b03909116919060ff1680620014ae5750835b8015620014c357506001600160a01b03821615155b9050801562001556576040517f836a1040000000000000000000000000000000000000000000000000000000008152600481018790526001600160a01b0388811660248301526044820187905283169063836a104090606401600060405180830381600087803b1580156200153757600080fd5b505af11580156200154c573d6000803e3d6000fd5b50505050620015d1565b6001600160a01b03871660009081526003602090815260408083208984529091529020546200158790869062001d8d565b6001600160a01b03881660009081526003602090815260408083208a8452825280832093909355600290522054620015c190869062001d8d565b6000878152600260205260409020555b60408051868152821515602082015285151581830152336060820152905187916001600160a01b038a16917f5dd3ead325af435e56bc762b40de54c96de6071938d18a26414245807591d86f9181900360800190a350505050505050565b6040517f6352211e000000000000000000000000000000000000000000000000000000008152600481018390527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031690636352211e9060240160206040518083038186803b158015620016a957600080fd5b505afa158015620016be573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620016e4919062001a09565b82600d620016f4838383620017bd565b6000858152602081905260409020546001600160a01b03168062001744576040517f73c463ce00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008681526004602090815260409182902080547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0016881515908117909155915133815288917f91c234a3a3ebdc00c9bbd80f24661ca100d784b6d9f53923b3a693344719e08c910160405180910390a3505050505050565b336001600160a01b038416148015906200189e57506040517fc161c93f0000000000000000000000000000000000000000000000000000000081523360048201526001600160a01b03848116602483015260448201849052606482018390527f0000000000000000000000000000000000000000000000000000000000000000169063c161c93f9060840160206040518083038186803b1580156200186157600080fd5b505afa15801562001876573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200189c919062001b33565b155b80156200197257506040517fc161c93f0000000000000000000000000000000000000000000000000000000081523360048201526001600160a01b03848116602483015260006044830152606482018390527f0000000000000000000000000000000000000000000000000000000000000000169063c161c93f9060840160206040518083038186803b1580156200193557600080fd5b505afa1580156200194a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001970919062001b33565b155b15620019aa576040517f075fd2b100000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b505050565b611f5c8062001e1a83390190565b60008083601f840112620019d057600080fd5b50813567ffffffffffffffff811115620019e957600080fd5b60208301915083602082850101111562001a0257600080fd5b9250929050565b60006020828403121562001a1c57600080fd5b815162001a298162001df1565b9392505050565b6000806040838503121562001a4457600080fd5b823562001a518162001df1565b946020939093013593505050565b6000806000806080858703121562001a7657600080fd5b843562001a838162001df1565b935060208501359250604085013562001a9c8162001df1565b9396929550929360600135925050565b60008060006060848603121562001ac257600080fd5b833562001acf8162001df1565b95602085013595506040909401359392505050565b6000806000806080858703121562001afb57600080fd5b843562001b088162001df1565b93506020850135925060408501359150606085013562001b288162001e0a565b939692955090935050565b60006020828403121562001b4657600080fd5b815162001a298162001e0a565b60006020828403121562001b6657600080fd5b813562001a298162001df1565b60006020828403121562001b8657600080fd5b5035919050565b60006020828403121562001ba057600080fd5b5051919050565b6000806040838503121562001bbb57600080fd5b82359150602083013562001bcf8162001e0a565b809150509250929050565b60008060006060848603121562001bf057600080fd5b83359250602084013562001c048162001df1565b9150604084013562001c168162001df1565b809150509250925092565b60008060008060006060868803121562001c3a57600080fd5b85359450602086013567ffffffffffffffff8082111562001c5a57600080fd5b62001c6889838a01620019bd565b9096509450604088013591508082111562001c8257600080fd5b5062001c9188828901620019bd565b969995985093965092949392505050565b60006020828403121562001cb557600080fd5b815160ff8116811462001a2957600080fd5b8183528181602085013750600060208284010152600060207fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f840116840101905092915050565b60408152600062001d2660408301868862001cc7565b828103602084015262001d3b81858762001cc7565b979650505050505050565b60608152600062001d5c60608301878962001cc7565b828103602084015262001d7181868862001cc7565b9150506001600160a01b03831660408301529695505050505050565b6000821982111562001da35762001da362001dc2565b500190565b60008282101562001dbd5762001dbd62001dc2565b500390565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b6001600160a01b038116811462001e0757600080fd5b50565b801515811462001e0757600080fdfe6101606040527f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9610140523480156200003757600080fd5b5060405162001f5c38038062001f5c8339810160408190526200005a9162000310565b8180604051806040016040528060018152602001603160f81b8152508484816003908051906020019062000090929190620001b3565b508051620000a6906004906020840190620001b3565b5050825160208085019190912083518483012060e08290526101008190524660a0818152604080517f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f81880181905281830187905260608201869052608082019490945230818401528151808203909301835260c0019052805194019390932091935091906080523060601b60c05261012052506200015593506200014f9250506200015d9050565b62000161565b5050620003cd565b3390565b600680546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b828054620001c1906200037a565b90600052602060002090601f016020900481019282620001e5576000855562000230565b82601f106200020057805160ff191683800117855562000230565b8280016001018555821562000230579182015b828111156200023057825182559160200191906001019062000213565b506200023e92915062000242565b5090565b5b808211156200023e576000815560010162000243565b600082601f8301126200026b57600080fd5b81516001600160401b0380821115620002885762000288620003b7565b604051601f8301601f19908116603f01168101908282118183101715620002b357620002b3620003b7565b81604052838152602092508683858801011115620002d057600080fd5b600091505b83821015620002f45785820183015181830184015290820190620002d5565b83821115620003065760008385830101525b9695505050505050565b600080604083850312156200032457600080fd5b82516001600160401b03808211156200033c57600080fd5b6200034a8683870162000259565b935060208501519150808211156200036157600080fd5b50620003708582860162000259565b9150509250929050565b600181811c908216806200038f57607f821691505b60208210811415620003b157634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052604160045260246000fd5b60805160a05160c05160601c60e051610100516101205161014051611b316200042b600039600061095e01526000611016015260006110650152600061104001526000610f9901526000610fc301526000610fed0152611b316000f3fe608060405234801561001057600080fd5b50600436106101a25760003560e01c80637ecebe00116100ee578063a457c2d711610097578063d505accf11610071578063d505accf14610365578063dd62ed3e14610378578063f2fde38b146103be578063f8548e36146103d157600080fd5b8063a457c2d71461032c578063a9059cbb1461033f578063bd85b0391461035257600080fd5b80638da5cb5b116100c85780638da5cb5b146102e957806395d89b41146103115780639eea5f661461031957600080fd5b80637ecebe00146102b0578063836a1040146102c35780638cb0a511146102d657600080fd5b806329507f7311610150578063395093511161012a578063395093511461025f57806370a0823114610272578063715018a6146102a857600080fd5b806329507f7314610235578063313ce567146102485780633644e5151461025757600080fd5b806318160ddd1161018157806318160ddd146102055780631c0f12b61461020d57806323b872dd1461022257600080fd5b8062fdd58e146101a757806306fdde03146101cd578063095ea7b3146101e2575b600080fd5b6101ba6101b53660046118de565b6103e4565b6040519081526020015b60405180910390f35b6101d5610412565b6040516101c491906119ad565b6101f56101f03660046118de565b6104a4565b60405190151581526020016101c4565b6002546101ba565b61022061021b366004611944565b6104ba565b005b6101f561023036600461182f565b6104cc565b610220610243366004611921565b6105c2565b604051601281526020016101c4565b6101ba61063b565b6101f561026d3660046118de565b610645565b6101ba6102803660046117e1565b73ffffffffffffffffffffffffffffffffffffffff1660009081526020819052604090205490565b61022061068e565b6101ba6102be3660046117e1565b610701565b6102206102d1366004611988565b61072e565b6102206102e4366004611988565b6107a4565b60065460405173ffffffffffffffffffffffffffffffffffffffff90911681526020016101c4565b6101d56107b4565b610220610327366004611988565b6107c3565b6101f561033a3660046118de565b610834565b6101f561034d3660046118de565b6108f2565b6101ba610360366004611908565b6108ff565b61022061037336600461186b565b61090a565b6101ba6103863660046117fc565b73ffffffffffffffffffffffffffffffffffffffff918216600090815260016020908152604080832093909416825291909152205490565b6102206103cc3660046117e1565b610a95565b6102206103df366004611988565b610b91565b73ffffffffffffffffffffffffffffffffffffffff82166000908152602081905260408120545b9392505050565b60606003805461042190611a4f565b80601f016020809104026020016040519081016040528092919081815260200182805461044d90611a4f565b801561049a5780601f1061046f5761010080835404028352916020019161049a565b820191906000526020600020905b81548152906001019060200180831161047d57829003601f168201915b5050505050905090565b60006104b1338484610b9b565b50600192915050565b6104c58383836104cc565b5050505050565b73ffffffffffffffffffffffffffffffffffffffff831660009081526001602090815260408083203384529091528120547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff81146105ac578281101561059f5760405162461bcd60e51b815260206004820152602860248201527f45524332303a207472616e7366657220616d6f756e742065786365656473206160448201527f6c6c6f77616e636500000000000000000000000000000000000000000000000060648201526084015b60405180910390fd5b6105ac8533858403610b9b565b6105b7858585610d1a565b506001949350505050565b60065473ffffffffffffffffffffffffffffffffffffffff1633146106295760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b61063281610a95565b5050565b905090565b6000610636610f7f565b33600081815260016020908152604080832073ffffffffffffffffffffffffffffffffffffffff8716845290915281205490916104b1918590610689908690611a20565b610b9b565b60065473ffffffffffffffffffffffffffffffffffffffff1633146106f55760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b6106ff60006110b3565b565b73ffffffffffffffffffffffffffffffffffffffff81166000908152600560205260408120545b92915050565b60065473ffffffffffffffffffffffffffffffffffffffff1633146107955760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b61079f828261112a565b505050565b6107ae82826104a4565b50505050565b60606004805461042190611a4f565b60065473ffffffffffffffffffffffffffffffffffffffff16331461082a5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b61079f8282611230565b33600090815260016020908152604080832073ffffffffffffffffffffffffffffffffffffffff86168452909152812054828110156108db5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f7760448201527f207a65726f0000000000000000000000000000000000000000000000000000006064820152608401610596565b6108e83385858403610b9b565b5060019392505050565b60006104b1338484610d1a565b600061072860025490565b8342111561095a5760405162461bcd60e51b815260206004820152601d60248201527f45524332305065726d69743a206578706972656420646561646c696e650000006044820152606401610596565b60007f00000000000000000000000000000000000000000000000000000000000000008888886109898c6113e9565b60408051602081019690965273ffffffffffffffffffffffffffffffffffffffff94851690860152929091166060840152608083015260a082015260c0810186905260e00160405160208183030381529060405280519060200120905060006109f18261141e565b90506000610a0182878787611487565b90508973ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614610a7e5760405162461bcd60e51b815260206004820152601e60248201527f45524332305065726d69743a20696e76616c6964207369676e617475726500006044820152606401610596565b610a898a8a8a610b9b565b50505050505050505050565b60065473ffffffffffffffffffffffffffffffffffffffff163314610afc5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b73ffffffffffffffffffffffffffffffffffffffff8116610b855760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201527f64647265737300000000000000000000000000000000000000000000000000006064820152608401610596565b610b8e816110b3565b50565b6107ae82826108f2565b73ffffffffffffffffffffffffffffffffffffffff8316610c235760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f2061646460448201527f72657373000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff8216610cac5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f20616464726560448201527f73730000000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff83811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b73ffffffffffffffffffffffffffffffffffffffff8316610da35760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f20616460448201527f64726573730000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff8216610e2c5760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201527f65737300000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff831660009081526020819052604090205481811015610ec85760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e742065786365656473206260448201527f616c616e636500000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff808516600090815260208190526040808220858503905591851681529081208054849290610f0c908490611a20565b925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef84604051610f7291815260200190565b60405180910390a36107ae565b60003073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016148015610fe557507f000000000000000000000000000000000000000000000000000000000000000046145b1561100f57507f000000000000000000000000000000000000000000000000000000000000000090565b50604080517f00000000000000000000000000000000000000000000000000000000000000006020808301919091527f0000000000000000000000000000000000000000000000000000000000000000828401527f000000000000000000000000000000000000000000000000000000000000000060608301524660808301523060a0808401919091528351808403909101815260c0909201909252805191012090565b6006805473ffffffffffffffffffffffffffffffffffffffff8381167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b73ffffffffffffffffffffffffffffffffffffffff821661118d5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610596565b806002600082825461119f9190611a20565b909155505073ffffffffffffffffffffffffffffffffffffffff8216600090815260208190526040812080548392906111d9908490611a20565b909155505060405181815273ffffffffffffffffffffffffffffffffffffffff8316906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a35050565b73ffffffffffffffffffffffffffffffffffffffff82166112b95760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f2061646472657360448201527f73000000000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff8216600090815260208190526040902054818110156113555760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e60448201527f63650000000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff83166000908152602081905260408120838303905560028054849290611391908490611a38565b909155505060405182815260009073ffffffffffffffffffffffffffffffffffffffff8516907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a3505050565b73ffffffffffffffffffffffffffffffffffffffff811660009081526005602052604090208054600181018255905b50919050565b600061072861142b610f7f565b836040517f19010000000000000000000000000000000000000000000000000000000000006020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b6000806000611498878787876114af565b915091506114a5816115c7565b5095945050505050565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08311156114e657506000905060036115be565b8460ff16601b141580156114fe57508460ff16601c14155b1561150f57506000905060046115be565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa158015611563573d6000803e3d6000fd5b50506040517fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0015191505073ffffffffffffffffffffffffffffffffffffffff81166115b7576000600192509250506115be565b9150600090505b94509492505050565b60008160048111156115db576115db611acc565b14156115e45750565b60018160048111156115f8576115f8611acc565b14156116465760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e617475726500000000000000006044820152606401610596565b600281600481111561165a5761165a611acc565b14156116a85760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e677468006044820152606401610596565b60038160048111156116bc576116bc611acc565b14156117305760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c60448201527f75650000000000000000000000000000000000000000000000000000000000006064820152608401610596565b600481600481111561174457611744611acc565b1415610b8e5760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202776272076616c60448201527f75650000000000000000000000000000000000000000000000000000000000006064820152608401610596565b803573ffffffffffffffffffffffffffffffffffffffff811681146117dc57600080fd5b919050565b6000602082840312156117f357600080fd5b61040b826117b8565b6000806040838503121561180f57600080fd5b611818836117b8565b9150611826602084016117b8565b90509250929050565b60008060006060848603121561184457600080fd5b61184d846117b8565b925061185b602085016117b8565b9150604084013590509250925092565b600080600080600080600060e0888a03121561188657600080fd5b61188f886117b8565b965061189d602089016117b8565b95506040880135945060608801359350608088013560ff811681146118c157600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156118f157600080fd5b6118fa836117b8565b946020939093013593505050565b60006020828403121561191a57600080fd5b5035919050565b6000806040838503121561193457600080fd5b82359150611826602084016117b8565b6000806000806080858703121561195a57600080fd5b8435935061196a602086016117b8565b9250611978604086016117b8565b9396929550929360600135925050565b60008060006060848603121561199d57600080fd5b8335925061185b602085016117b8565b600060208083528351808285015260005b818110156119da578581018301518582016040015282016119be565b818111156119ec576000604083870101525b50601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016929092016040019392505050565b60008219821115611a3357611a33611a9d565b500190565b600082821015611a4a57611a4a611a9d565b500390565b600181811c90821680611a6357607f821691505b60208210811415611418577f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602160045260246000fdfea2646970667358221220586a7a11e0cbfbbd87a10728794d4dc92939154620539c3d548c9e1e576c2e8e64736f6c63430008060033a2646970667358221220935a83258ebd3b82280b36df498749c4dc91d1f076f97de9e451d596373e341d64736f6c634300080600330000000000000000000000006f3c5afca0c9edf3926ef2ddf17c8ae6391afefb000000000000000000000000d8b4359143eda5b2d763e127ed27c77addbc47d3000000000000000000000000cc8f7a89d89c2ab3559f484e0c656423e979ac9c

0x60806040523480156200001157600080fd5b5060043610620001315760003560e01c80638b79543c11620000c0578063ad007d63116200008b578063ceddd3e4116200006e578063ceddd3e41462000328578063ea78803f146200033f578063ff0186c5146200036b57600080fd5b8063ad007d6314620002d8578063c41c2f24146200030057600080fd5b80638b79543c146200026b578063906ebd0f1462000293578063a7f2a70b14620002aa578063ac689bcd14620002c157600080fd5b806357e4c778116200010157806357e4c77814620001d45780636607955d146200020457806375b0d9cd146200021d5780637b4d8e2c146200023457600080fd5b8062fdd58e14620001365780631412884f1462000160578063176309b714620001835780635287af3714620001a6575b600080fd5b6200014d6200014736600462001a30565b62000382565b6040519081526020015b60405180910390f35b6200014d6200017136600462001b73565b60026020526000908152604090205481565b6200014d6200019436600462001b53565b60016020526000908152604090205481565b6200014d620001b736600462001a30565b600360209081526000928352604080842090915290825290205481565b620001eb620001e536600462001bda565b6200046a565b6040516001600160a01b03909116815260200162000157565b6200021b6200021536600462001aac565b6200086a565b005b6200014d6200022e36600462001b73565b62000a81565b6200025a6200024536600462001b73565b60046020526000908152604090205460ff1681565b604051901515815260200162000157565b620001eb7f000000000000000000000000d8b4359143eda5b2d763e127ed27c77addbc47d381565b6200021b620002a436600462001ae4565b62000b55565b620001eb620002bb36600462001c21565b62000f49565b6200021b620002d236600462001a5f565b620011e8565b620001eb7f0000000000000000000000006f3c5afca0c9edf3926ef2ddf17c8ae6391afefb81565b620001eb7f000000000000000000000000cc8f7a89d89c2ab3559f484e0c656423e979ac9c81565b6200021b6200033936600462001ae4565b62001383565b620001eb6200035036600462001b73565b6000602081905290815260409020546001600160a01b031681565b6200021b6200037c36600462001ba7565b6200162f565b6001600160a01b0380831660009081526003602090815260408083208584528252808320549183905290912054909116801562000463576040517efdd58e0000000000000000000000000000000000000000000000000000000081526001600160a01b0385811660048301526024820185905282169062fdd58e9060440160206040518083038186803b1580156200041957600080fd5b505afa1580156200042e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000454919062001b8d565b62000460908362001d8d565b91505b5092915050565b6040517f5dd8f6aa00000000000000000000000000000000000000000000000000000000815260048101849052600090849033906001600160a01b037f000000000000000000000000cc8f7a89d89c2ab3559f484e0c656423e979ac9c1690635dd8f6aa9060240160206040518083038186803b158015620004eb57600080fd5b505afa15801562000500573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000526919062001a09565b6001600160a01b03161462000567576040517fab7f741400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0384161580156200058d575060008581526004602052604090205460ff165b15620005c5576040517fd4ae123800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0384166000908152600160205260409020541562000616576040517f1379a84600000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b03841615801590620006a75750836001600160a01b031663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b1580156200066457600080fd5b505afa15801562000679573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200069f919062001ca2565b60ff16601214155b15620006df576040517fadc38c9400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600085815260208190526040902080546001600160a01b038681167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681179093551692501562000747576001600160a01b03841660009081526001602052604090208590555b6001600160a01b0382161562000771576001600160a01b0382166000908152600160205260408120555b6001600160a01b038316158015906200079257506001600160a01b03821615155b1562000816576040517f29507f73000000000000000000000000000000000000000000000000000000008152600481018690526001600160a01b0384811660248301528316906329507f7390604401600060405180830381600087803b158015620007fc57600080fd5b505af115801562000811573d6000803e3d6000fd5b505050505b604080516001600160a01b038581168252336020830152808516929087169188917f53b937570201bb723ab1530f41c21f62fba8df64afef862cb0a6f4eccc3094dc910160405180910390a4509392505050565b8282600b6200087b838383620017bd565b6000858152602081905260409020546001600160a01b031680620008cb576040517f73c463ce00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b0387166000908152600360209081526040808320898452909152902054858110156200092a576040517f83fc8b2d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b03881660009081526003602090815260408083208a84529091529020546200095b90879062001da8565b6001600160a01b03891660009081526003602090815260408083208b84528252808320939093556002905220546200099590879062001da8565b6000888152600260205260409081902091909155517f836a1040000000000000000000000000000000000000000000000000000000008152600481018890526001600160a01b0389811660248301526044820188905283169063836a104090606401600060405180830381600087803b15801562000a1257600080fd5b505af115801562000a27573d6000803e3d6000fd5b505060408051848152602081018a9052338183015290518a93506001600160a01b038c1692507fe718784128df3c3d45fbd6519133fee450494f7cdb2b53830a5087cd47f980829181900360600190a35050505050505050565b60008181526002602090815260408083205491839052909120546001600160a01b0316801562000b4f576040517fbd85b039000000000000000000000000000000000000000000000000000000008152600481018490526001600160a01b0382169063bd85b0399060240160206040518083038186803b15801562000b0557600080fd5b505afa15801562000b1a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000b40919062001b8d565b62000b4c908362001d8d565b91505b50919050565b6040517f5dd8f6aa00000000000000000000000000000000000000000000000000000000815260048101849052839033906001600160a01b037f000000000000000000000000cc8f7a89d89c2ab3559f484e0c656423e979ac9c1690635dd8f6aa9060240160206040518083038186803b15801562000bd357600080fd5b505afa15801562000be8573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000c0e919062001a09565b6001600160a01b03161462000c4f576040517fab7f741400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600084815260208181526040808320546001600160a01b0389811685526003845282852089865290935290832054911691821562000d28576040517efdd58e0000000000000000000000000000000000000000000000000000000081526001600160a01b0389811660048301526024820189905284169062fdd58e9060440160206040518083038186803b15801562000ce757600080fd5b505afa15801562000cfc573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062000d22919062001b8d565b62000d2b565b60005b905062000d39828262001d8d565b86111562000d73576040517fe793143800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008162000d845750600062000dc3565b851562000da45786821062000d9a578662000d9c565b815b905062000dc3565b86831062000db457600062000dc0565b62000dc0838862001da8565b90505b600062000dd1828962001da8565b9050801562000e55576001600160a01b038a1660009081526003602090815260408083208c845290915290205462000e0b90829062001da8565b6001600160a01b038b1660009081526003602090815260408083208d845282528083209390935560029052205462000e4590829062001da8565b60008a8152600260205260409020555b811562000ee1576040517f9eea5f66000000000000000000000000000000000000000000000000000000008152600481018a90526001600160a01b038b8116602483015260448201849052861690639eea5f6690606401600060405180830381600087803b15801562000ec757600080fd5b505af115801562000edc573d6000803e3d6000fd5b505050505b6040805189815260208101869052908101849052871515606082015233608082015289906001600160a01b038c16907fbe100da6adaa492f7ba1b0de916ae2606126ec7b044d7aa8ec74971a607ceecd9060a00160405180910390a350505050505050505050565b6040517f5dd8f6aa00000000000000000000000000000000000000000000000000000000815260048101869052600090869033906001600160a01b037f000000000000000000000000cc8f7a89d89c2ab3559f484e0c656423e979ac9c1690635dd8f6aa9060240160206040518083038186803b15801562000fca57600080fd5b505afa15801562000fdf573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001005919062001a09565b6001600160a01b03161462001046576040517fab7f741400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b846200107e576040517f92bf449d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b82620010b6576040517f571431a700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6000878152602081905260409020546001600160a01b03161562001106576040517fa54630ac00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b858585856040516200111890620019af565b62001127949392919062001d10565b604051809103906000f08015801562001144573d6000803e3d6000fd5b5060008881526020818152604080832080547fffffffffffffffffffffffff0000000000000000000000000000000000000000166001600160a01b0386169081179091558084526001909252918290208a905590519193509088907f1b1705bef26552c8f314c5eb80e9c84f02876c2f7f30a7f9ad5cafd17d5fa6da90620011d6908a908a908a908a90339062001d46565b60405180910390a35095945050505050565b8383600c620011f9838383620017bd565b6001600160a01b0385166200123a576040517fc6587bab00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b03871660009081526003602090815260408083208984529091529020548085111562001299576040517f83fc8b2d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001600160a01b03881660009081526003602090815260408083208a8452909152902054620012ca90869062001da8565b6001600160a01b03808a1660009081526003602081815260408084208d8552825280842095909555928a16825282528281208a825290915220546200131190869062001d8d565b6001600160a01b0387811660008181526003602090815260408083208d8452825291829020949094558051898152339481019490945290928a928c16917fae47e55abe3902569528abe4272b889079230a248aec0659a2939a90354982c6910160405180910390a45050505050505050565b6040517f5dd8f6aa00000000000000000000000000000000000000000000000000000000815260048101849052839033906001600160a01b037f000000000000000000000000cc8f7a89d89c2ab3559f484e0c656423e979ac9c1690635dd8f6aa9060240160206040518083038186803b1580156200140157600080fd5b505afa15801562001416573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200143c919062001a09565b6001600160a01b0316146200147d576040517fab7f741400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6000848152602081815260408083205460049092528220546001600160a01b03909116919060ff1680620014ae5750835b8015620014c357506001600160a01b03821615155b9050801562001556576040517f836a1040000000000000000000000000000000000000000000000000000000008152600481018790526001600160a01b0388811660248301526044820187905283169063836a104090606401600060405180830381600087803b1580156200153757600080fd5b505af11580156200154c573d6000803e3d6000fd5b50505050620015d1565b6001600160a01b03871660009081526003602090815260408083208984529091529020546200158790869062001d8d565b6001600160a01b03881660009081526003602090815260408083208a8452825280832093909355600290522054620015c190869062001d8d565b6000878152600260205260409020555b60408051868152821515602082015285151581830152336060820152905187916001600160a01b038a16917f5dd3ead325af435e56bc762b40de54c96de6071938d18a26414245807591d86f9181900360800190a350505050505050565b6040517f6352211e000000000000000000000000000000000000000000000000000000008152600481018390527f000000000000000000000000d8b4359143eda5b2d763e127ed27c77addbc47d36001600160a01b031690636352211e9060240160206040518083038186803b158015620016a957600080fd5b505afa158015620016be573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190620016e4919062001a09565b82600d620016f4838383620017bd565b6000858152602081905260409020546001600160a01b03168062001744576040517f73c463ce00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60008681526004602090815260409182902080547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0016881515908117909155915133815288917f91c234a3a3ebdc00c9bbd80f24661ca100d784b6d9f53923b3a693344719e08c910160405180910390a3505050505050565b336001600160a01b038416148015906200189e57506040517fc161c93f0000000000000000000000000000000000000000000000000000000081523360048201526001600160a01b03848116602483015260448201849052606482018390527f0000000000000000000000006f3c5afca0c9edf3926ef2ddf17c8ae6391afefb169063c161c93f9060840160206040518083038186803b1580156200186157600080fd5b505afa15801562001876573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200189c919062001b33565b155b80156200197257506040517fc161c93f0000000000000000000000000000000000000000000000000000000081523360048201526001600160a01b03848116602483015260006044830152606482018390527f0000000000000000000000006f3c5afca0c9edf3926ef2ddf17c8ae6391afefb169063c161c93f9060840160206040518083038186803b1580156200193557600080fd5b505afa1580156200194a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019062001970919062001b33565b155b15620019aa576040517f075fd2b100000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b505050565b611f5c8062001e1a83390190565b60008083601f840112620019d057600080fd5b50813567ffffffffffffffff811115620019e957600080fd5b60208301915083602082850101111562001a0257600080fd5b9250929050565b60006020828403121562001a1c57600080fd5b815162001a298162001df1565b9392505050565b6000806040838503121562001a4457600080fd5b823562001a518162001df1565b946020939093013593505050565b6000806000806080858703121562001a7657600080fd5b843562001a838162001df1565b935060208501359250604085013562001a9c8162001df1565b9396929550929360600135925050565b60008060006060848603121562001ac257600080fd5b833562001acf8162001df1565b95602085013595506040909401359392505050565b6000806000806080858703121562001afb57600080fd5b843562001b088162001df1565b93506020850135925060408501359150606085013562001b288162001e0a565b939692955090935050565b60006020828403121562001b4657600080fd5b815162001a298162001e0a565b60006020828403121562001b6657600080fd5b813562001a298162001df1565b60006020828403121562001b8657600080fd5b5035919050565b60006020828403121562001ba057600080fd5b5051919050565b6000806040838503121562001bbb57600080fd5b82359150602083013562001bcf8162001e0a565b809150509250929050565b60008060006060848603121562001bf057600080fd5b83359250602084013562001c048162001df1565b9150604084013562001c168162001df1565b809150509250925092565b60008060008060006060868803121562001c3a57600080fd5b85359450602086013567ffffffffffffffff8082111562001c5a57600080fd5b62001c6889838a01620019bd565b9096509450604088013591508082111562001c8257600080fd5b5062001c9188828901620019bd565b969995985093965092949392505050565b60006020828403121562001cb557600080fd5b815160ff8116811462001a2957600080fd5b8183528181602085013750600060208284010152600060207fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f840116840101905092915050565b60408152600062001d2660408301868862001cc7565b828103602084015262001d3b81858762001cc7565b979650505050505050565b60608152600062001d5c60608301878962001cc7565b828103602084015262001d7181868862001cc7565b9150506001600160a01b03831660408301529695505050505050565b6000821982111562001da35762001da362001dc2565b500190565b60008282101562001dbd5762001dbd62001dc2565b500390565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b6001600160a01b038116811462001e0757600080fd5b50565b801515811462001e0757600080fdfe6101606040527f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9610140523480156200003757600080fd5b5060405162001f5c38038062001f5c8339810160408190526200005a9162000310565b8180604051806040016040528060018152602001603160f81b8152508484816003908051906020019062000090929190620001b3565b508051620000a6906004906020840190620001b3565b5050825160208085019190912083518483012060e08290526101008190524660a0818152604080517f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f81880181905281830187905260608201869052608082019490945230818401528151808203909301835260c0019052805194019390932091935091906080523060601b60c05261012052506200015593506200014f9250506200015d9050565b62000161565b5050620003cd565b3390565b600680546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b828054620001c1906200037a565b90600052602060002090601f016020900481019282620001e5576000855562000230565b82601f106200020057805160ff191683800117855562000230565b8280016001018555821562000230579182015b828111156200023057825182559160200191906001019062000213565b506200023e92915062000242565b5090565b5b808211156200023e576000815560010162000243565b600082601f8301126200026b57600080fd5b81516001600160401b0380821115620002885762000288620003b7565b604051601f8301601f19908116603f01168101908282118183101715620002b357620002b3620003b7565b81604052838152602092508683858801011115620002d057600080fd5b600091505b83821015620002f45785820183015181830184015290820190620002d5565b83821115620003065760008385830101525b9695505050505050565b600080604083850312156200032457600080fd5b82516001600160401b03808211156200033c57600080fd5b6200034a8683870162000259565b935060208501519150808211156200036157600080fd5b50620003708582860162000259565b9150509250929050565b600181811c908216806200038f57607f821691505b60208210811415620003b157634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052604160045260246000fd5b60805160a05160c05160601c60e051610100516101205161014051611b316200042b600039600061095e01526000611016015260006110650152600061104001526000610f9901526000610fc301526000610fed0152611b316000f3fe608060405234801561001057600080fd5b50600436106101a25760003560e01c80637ecebe00116100ee578063a457c2d711610097578063d505accf11610071578063d505accf14610365578063dd62ed3e14610378578063f2fde38b146103be578063f8548e36146103d157600080fd5b8063a457c2d71461032c578063a9059cbb1461033f578063bd85b0391461035257600080fd5b80638da5cb5b116100c85780638da5cb5b146102e957806395d89b41146103115780639eea5f661461031957600080fd5b80637ecebe00146102b0578063836a1040146102c35780638cb0a511146102d657600080fd5b806329507f7311610150578063395093511161012a578063395093511461025f57806370a0823114610272578063715018a6146102a857600080fd5b806329507f7314610235578063313ce567146102485780633644e5151461025757600080fd5b806318160ddd1161018157806318160ddd146102055780631c0f12b61461020d57806323b872dd1461022257600080fd5b8062fdd58e146101a757806306fdde03146101cd578063095ea7b3146101e2575b600080fd5b6101ba6101b53660046118de565b6103e4565b6040519081526020015b60405180910390f35b6101d5610412565b6040516101c491906119ad565b6101f56101f03660046118de565b6104a4565b60405190151581526020016101c4565b6002546101ba565b61022061021b366004611944565b6104ba565b005b6101f561023036600461182f565b6104cc565b610220610243366004611921565b6105c2565b604051601281526020016101c4565b6101ba61063b565b6101f561026d3660046118de565b610645565b6101ba6102803660046117e1565b73ffffffffffffffffffffffffffffffffffffffff1660009081526020819052604090205490565b61022061068e565b6101ba6102be3660046117e1565b610701565b6102206102d1366004611988565b61072e565b6102206102e4366004611988565b6107a4565b60065460405173ffffffffffffffffffffffffffffffffffffffff90911681526020016101c4565b6101d56107b4565b610220610327366004611988565b6107c3565b6101f561033a3660046118de565b610834565b6101f561034d3660046118de565b6108f2565b6101ba610360366004611908565b6108ff565b61022061037336600461186b565b61090a565b6101ba6103863660046117fc565b73ffffffffffffffffffffffffffffffffffffffff918216600090815260016020908152604080832093909416825291909152205490565b6102206103cc3660046117e1565b610a95565b6102206103df366004611988565b610b91565b73ffffffffffffffffffffffffffffffffffffffff82166000908152602081905260408120545b9392505050565b60606003805461042190611a4f565b80601f016020809104026020016040519081016040528092919081815260200182805461044d90611a4f565b801561049a5780601f1061046f5761010080835404028352916020019161049a565b820191906000526020600020905b81548152906001019060200180831161047d57829003601f168201915b5050505050905090565b60006104b1338484610b9b565b50600192915050565b6104c58383836104cc565b5050505050565b73ffffffffffffffffffffffffffffffffffffffff831660009081526001602090815260408083203384529091528120547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff81146105ac578281101561059f5760405162461bcd60e51b815260206004820152602860248201527f45524332303a207472616e7366657220616d6f756e742065786365656473206160448201527f6c6c6f77616e636500000000000000000000000000000000000000000000000060648201526084015b60405180910390fd5b6105ac8533858403610b9b565b6105b7858585610d1a565b506001949350505050565b60065473ffffffffffffffffffffffffffffffffffffffff1633146106295760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b61063281610a95565b5050565b905090565b6000610636610f7f565b33600081815260016020908152604080832073ffffffffffffffffffffffffffffffffffffffff8716845290915281205490916104b1918590610689908690611a20565b610b9b565b60065473ffffffffffffffffffffffffffffffffffffffff1633146106f55760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b6106ff60006110b3565b565b73ffffffffffffffffffffffffffffffffffffffff81166000908152600560205260408120545b92915050565b60065473ffffffffffffffffffffffffffffffffffffffff1633146107955760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b61079f828261112a565b505050565b6107ae82826104a4565b50505050565b60606004805461042190611a4f565b60065473ffffffffffffffffffffffffffffffffffffffff16331461082a5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b61079f8282611230565b33600090815260016020908152604080832073ffffffffffffffffffffffffffffffffffffffff86168452909152812054828110156108db5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f7760448201527f207a65726f0000000000000000000000000000000000000000000000000000006064820152608401610596565b6108e83385858403610b9b565b5060019392505050565b60006104b1338484610d1a565b600061072860025490565b8342111561095a5760405162461bcd60e51b815260206004820152601d60248201527f45524332305065726d69743a206578706972656420646561646c696e650000006044820152606401610596565b60007f00000000000000000000000000000000000000000000000000000000000000008888886109898c6113e9565b60408051602081019690965273ffffffffffffffffffffffffffffffffffffffff94851690860152929091166060840152608083015260a082015260c0810186905260e00160405160208183030381529060405280519060200120905060006109f18261141e565b90506000610a0182878787611487565b90508973ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614610a7e5760405162461bcd60e51b815260206004820152601e60248201527f45524332305065726d69743a20696e76616c6964207369676e617475726500006044820152606401610596565b610a898a8a8a610b9b565b50505050505050505050565b60065473ffffffffffffffffffffffffffffffffffffffff163314610afc5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610596565b73ffffffffffffffffffffffffffffffffffffffff8116610b855760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201527f64647265737300000000000000000000000000000000000000000000000000006064820152608401610596565b610b8e816110b3565b50565b6107ae82826108f2565b73ffffffffffffffffffffffffffffffffffffffff8316610c235760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f2061646460448201527f72657373000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff8216610cac5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f20616464726560448201527f73730000000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff83811660008181526001602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b73ffffffffffffffffffffffffffffffffffffffff8316610da35760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f20616460448201527f64726573730000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff8216610e2c5760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201527f65737300000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff831660009081526020819052604090205481811015610ec85760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e742065786365656473206260448201527f616c616e636500000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff808516600090815260208190526040808220858503905591851681529081208054849290610f0c908490611a20565b925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef84604051610f7291815260200190565b60405180910390a36107ae565b60003073ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016148015610fe557507f000000000000000000000000000000000000000000000000000000000000000046145b1561100f57507f000000000000000000000000000000000000000000000000000000000000000090565b50604080517f00000000000000000000000000000000000000000000000000000000000000006020808301919091527f0000000000000000000000000000000000000000000000000000000000000000828401527f000000000000000000000000000000000000000000000000000000000000000060608301524660808301523060a0808401919091528351808403909101815260c0909201909252805191012090565b6006805473ffffffffffffffffffffffffffffffffffffffff8381167fffffffffffffffffffffffff0000000000000000000000000000000000000000831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b73ffffffffffffffffffffffffffffffffffffffff821661118d5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610596565b806002600082825461119f9190611a20565b909155505073ffffffffffffffffffffffffffffffffffffffff8216600090815260208190526040812080548392906111d9908490611a20565b909155505060405181815273ffffffffffffffffffffffffffffffffffffffff8316906000907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a35050565b73ffffffffffffffffffffffffffffffffffffffff82166112b95760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f2061646472657360448201527f73000000000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff8216600090815260208190526040902054818110156113555760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e60448201527f63650000000000000000000000000000000000000000000000000000000000006064820152608401610596565b73ffffffffffffffffffffffffffffffffffffffff83166000908152602081905260408120838303905560028054849290611391908490611a38565b909155505060405182815260009073ffffffffffffffffffffffffffffffffffffffff8516907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a3505050565b73ffffffffffffffffffffffffffffffffffffffff811660009081526005602052604090208054600181018255905b50919050565b600061072861142b610f7f565b836040517f19010000000000000000000000000000000000000000000000000000000000006020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b6000806000611498878787876114af565b915091506114a5816115c7565b5095945050505050565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08311156114e657506000905060036115be565b8460ff16601b141580156114fe57508460ff16601c14155b1561150f57506000905060046115be565b6040805160008082526020820180845289905260ff881692820192909252606081018690526080810185905260019060a0016020604051602081039080840390855afa158015611563573d6000803e3d6000fd5b50506040517fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0015191505073ffffffffffffffffffffffffffffffffffffffff81166115b7576000600192509250506115be565b9150600090505b94509492505050565b60008160048111156115db576115db611acc565b14156115e45750565b60018160048111156115f8576115f8611acc565b14156116465760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e617475726500000000000000006044820152606401610596565b600281600481111561165a5761165a611acc565b14156116a85760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e677468006044820152606401610596565b60038160048111156116bc576116bc611acc565b14156117305760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c60448201527f75650000000000000000000000000000000000000000000000000000000000006064820152608401610596565b600481600481111561174457611744611acc565b1415610b8e5760405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202776272076616c60448201527f75650000000000000000000000000000000000000000000000000000000000006064820152608401610596565b803573ffffffffffffffffffffffffffffffffffffffff811681146117dc57600080fd5b919050565b6000602082840312156117f357600080fd5b61040b826117b8565b6000806040838503121561180f57600080fd5b611818836117b8565b9150611826602084016117b8565b90509250929050565b60008060006060848603121561184457600080fd5b61184d846117b8565b925061185b602085016117b8565b9150604084013590509250925092565b600080600080600080600060e0888a03121561188657600080fd5b61188f886117b8565b965061189d602089016117b8565b95506040880135945060608801359350608088013560ff811681146118c157600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156118f157600080fd5b6118fa836117b8565b946020939093013593505050565b60006020828403121561191a57600080fd5b5035919050565b6000806040838503121561193457600080fd5b82359150611826602084016117b8565b6000806000806080858703121561195a57600080fd5b8435935061196a602086016117b8565b9250611978604086016117b8565b9396929550929360600135925050565b60008060006060848603121561199d57600080fd5b8335925061185b602085016117b8565b600060208083528351808285015260005b818110156119da578581018301518582016040015282016119be565b818111156119ec576000604083870101525b50601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016929092016040019392505050565b60008219821115611a3357611a33611a9d565b500190565b600082821015611a4a57611a4a611a9d565b500390565b600181811c90821680611a6357607f821691505b60208210811415611418577f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602160045260246000fdfea2646970667358221220586a7a11e0cbfbbd87a10728794d4dc92939154620539c3d548c9e1e576c2e8e64736f6c63430008060033a2646970667358221220935a83258ebd3b82280b36df498749c4dc91d1f076f97de9e451d596373e341d64736f6c63430008060033

0000000000000000000000006f3c5afca0c9edf3926ef2ddf17c8ae6391afefb000000000000000000000000d8b4359143eda5b2d763e127ed27c77addbc47d3000000000000000000000000cc8f7a89d89c2ab3559f484e0c656423e979ac9c

-----Decoded View---------------
Arg [0] : _operatorStore (address): 0x6F3C5afCa0c9eDf3926eF2dDF17c8ae6391afEfb
Arg [1] : _projects (address): 0xD8B4359143eda5B2d763E127Ed27c77addBc47d3
Arg [2] : _directory (address): 0xCc8f7a89d89c2AB3559f484E0C656423E979ac9C

-----Encoded View---------------
3 Constructor Arguments found :
Arg [0] : 0000000000000000000000006f3c5afca0c9edf3926ef2ddf17c8ae6391afefb
Arg [1] : 000000000000000000000000d8b4359143eda5b2d763e127ed27c77addbc47d3
Arg [2] : 000000000000000000000000cc8f7a89d89c2ab3559f484e0c656423e979ac9c